添加弟子管理UI界面

doc/主世界与建筑.md

@@ -0,0 +1,88 @@
+# 主世界与建筑模块设计
+
+本文档定义主世界（hex 地块）、建筑与弟子派工的关系。背景见 `doc/WorldDesign.md`、`doc/P1模块拆分.md`。
+
+## 1. 主世界方案（已定）
+
+**正六边形单元格地图**，玩家在单元格上建设建筑/灵田（类似文明的领地经营 + 模拟经营的指派产出）。
+
+### 1.1 设计咬合点（为什么用 hex）
+
+- **灵石矿是地块资源**：哪块地有灵脉 → 占矿/买矿成为位置决策
+- **秘境"在后山"是空间概念**：勘探发掘做成地图行为
+- **后期地盘争夺需要地图**：从 P1 引入空间维度，后期不返工
+- **成长可视化**："从小宗门到大宗门"= 地图从一小块山头扩大的过程
+
+### 1.2 落地节奏（已定：坐标预留，渲染后置）
+
+| 阶段 | 数据层 | UI 层 |
+| --- | --- | --- |
+| P1 | 建筑数据带 hex 坐标（axial） | 卡片/列表渲染，不做地图 |
+| P2/P3 | 不变（存档天然带位置） | hex 主世界渲染（tile 美术 + 放置交互） |
+
+前端后端分离下，UI 切换只影响显示层，后端零返工。
+
+### 1.3 hex 成立的前提
+
+1. **格子有位置价值**——灵脉格/水源格/肥沃地/岩石地，不同地块加成不同（纯装饰的格子不做）。
+2. **地图随机生成**——每局资源分布不同，防止最优布局模板一劳永逸，保证复玩性。
+3. **面积跟随成长**——开局只有山头几格，扩张需买地/开荒，地图与宗门成长绑定。
+
+### 1.4 弟子与建筑的绑定深度（已定：派工单式）
+
+- 弟子**指派**给建筑，月底结算产出，弟子不在地图上行走。
+- 位置只影响加成（如灵田靠近水源产量+）。
+- 明确不做实体行走式（寻路/队列/行程），与月回合结算节奏冲突，成本高。
+
+## 2. 建筑实体模型
+
+建筑（含灵田）是 hex 上的实体，**必须有弟子指派才有产出**：
+
+```gdscript
+## BuildingData.gd（RefCounted，纯数据）
+var id: int
+var cell: Vector2i          # hex axial 坐标（q, r）
+var building_type: int      # 建筑类型枚举
+var assigned_disciple_id: int = -1   # 指派弟子，-1 = 无
+var progress: float = 0.0   # 生产/生长进度
+var level: int = 1          # 建筑等级（预留）
+```
+
+## 3. 建筑类型
+
+| 建筑 | 产出 | 指派要求 | 备注 |
+| --- | --- | --- | --- |
+| 外田（凡粮） | 灵稻 | 种植技艺 | 口粮来源 |
+| 内田（灵药） | 聚气草/凝神花 | 种植技艺 | 炼丹原料 |
+| 丹房 | 聚气丹/凝神丹 | 炼丹技艺 | 消耗灵药原料 |
+| 仓库（预留） | — | — | 存粮/存料上限，后期 |
+| 洞府/居所（预留） | — | — | 弟子数量上限，后期 |
+
+P1 只做前三种（对应原 FieldManager + AlchemyManager 的职责，统一进建筑框架）。
+
+## 4. 数据模型演进
+
+原 `FieldData`（灵田）泛化为 `BuildingData`（建筑），灵田是建筑类型之一：
+
+- 原 FieldManager → 建筑管理：地块放置、指派弟子、月度结算（生长/产出入库存）
+- 种植类建筑带"作物"字段（作物类型/生长月数/品质），收获式产出
+- 丹房是"即时加工"类建筑：有原料时弟子炼制入库存（也可保留 AlchemyManager 独立接口，两者皆可）
+
+## 5. 月度结算信号流（不变）
+
+```
+settle_month()
+  → 每个有弟子指派的建筑结算产出
+    → 收获/成品入 InventoryManager
+    → inventory_changed
+```
+
+## 6. 简化决策
+
+| 完整愿景 | P1 取舍 | 后续 |
+| --- | --- | --- |
+| hex 地图渲染 | 不做，卡片/列表 | P2/P3 |
+| 地图随机生成 | 固定初始地图（几块田+一丹房） | P3 |
+| 地块地形差异 | 初始全默认，无加成 | P3 引入水源/灵脉 |
+| 建筑多类型 | 只做外田/内田/丹房 | 逐里程碑加 |
+| 弟子行走 | 不做（派工单式） | 不评估升级 |