IDX-03 · 系统依赖关系图 · SKYLINE CHRONICLE

1. 本册用途#

这一册管什么：系统之间的依赖方向、数据流向、以及「谁不许调用谁」的硬规则。

这一册不管什么：
· 每个系统内部的机制 → 去该系统分册
· 代码里的包结构与模块划分 → 去 TECH-01
· 跨系统共享的容器结构 → 去 TECH-03

2. 数据流依赖主干#

依赖方向：上游 → 下游；权威状态只在运行时数据层提交

  Content Source（Markdown / JSON / 资源元数据）
      ↓
  Content Compiler（Schema 校验、稳定 ID、依赖、哈希）
      ↓
  Content Pack + Manifest（版本、能力、语言和 MOD 清单）
      ↓
  Runtime Data Store（Definition、Runtime Entity、Chunk、存档快照）
      ↓
  Simulation（SYS / TRANS 领域系统，按 Tick 与 dirty 集合结算）
      ├── Command：UI、MOD 或平台请求改变状态
      ├── Event：已提交事实通知其他域
      └── QueryService：只读、分页、带 revision 的查询结果
            ↓
        Godot UI / 2D 表现层

  PlatformService（Steam、Cloud、成就、Workshop、本地替身）
            ↕ 只通过适配器与命令/事件交互

3. 完整依赖矩阵#

系统	依赖谁	为什么
SYS-01 地基与结构	`SET-03`	核心张力的规格来源，决定的正是地基与加高的关系
SYS-02 建造与空间布局	`SYS-01 · SYS-10`	建造必须校验结构；施工队列挂在时间系统上
SYS-03 垂直交通	`SYS-02 · SYS-10`	电梯井占用建造网格；调度依赖时刻推进
SYS-04 租户与租约	`SYS-02 · SYS-03 · SYS-10`	房间与运力决定可租空间；租约按日结算
SYS-05 需求与服务	`SYS-04`	需求由租户构成产生
SYS-06 财务与资产估值	`SYS-01 · SYS-04 · SYS-05 · SYS-07 · SYS-10`	汇聚点：读取人员工资、事件后果等已结算事实，不反向依赖人员与事件域
SYS-07 机电与能耗	`SYS-01 · SYS-02 · TRANS-07`	设备占用结构空间；天气改动能耗
SYS-08 人员与组织	`SYS-04 · SYS-10`	维护人员、岗位与能力事实；财务消费其结算输入
SYS-09 事件、风险与危机	`SYS-01 · SYS-04 · SYS-07 · SYS-10`	产出事件、风险状态与后果；财务读取事件结算输入
SYS-10 时间与进程	`——`	最底层：不依赖任何系统，全库依赖它
SYS-11 界面与操作	`SYS-10 · 各系统`	呈现层，读所有系统、不被任何系统依赖
SYS-12 难度与硬核开关	`——`	只改初始条件，不介入运行期
SYS-13 明星租户与员工	`SYS-04 · SYS-08`	名人附着在租户与人员之上
SYS-14 蓝图与编辑工具	`SYS-02 · SYS-15`	蓝图依附于建造系统与格坐标系；只做片段的存取与投影，不产生新的建造规则
SYS-15 网格与坐标系	`——`	地理层：只定义格与坐标系本身，不依赖任何系统；全库的空间度量都以它为准
CITY-02 城市差异与法规组	`SET-01`	法规组是城市属性的收敛形式
TRANS-05 跨城时间与线路产出	`SYS-10 · TRANS-01~04`	在时间系统之上叠加城市独立时钟
AXP-02 工业与供应链	`SYS-06 · TRANS-06 · IDX-05`	产能变现走财务；原料来自农田与作物池

4. 三条硬规则#

规则一 · 依赖单向，禁止回指如果 A 依赖 B，则 B 永远不得依赖 A。需要反向传递信息时，用事件而非直接调用。违反此规则会立刻产生循环依赖。

规则二 · 财务是唯一汇聚点所有系统产生的经济后果都必须经由 SYS-06 入账。任何系统不得自行定义币种、单位或估值公式——那属于 SYS-06 的真值源。

规则三 · 查询与平台不能取得可变实体引用 UI、诊断、Steam、Cloud 和 Workshop 只能通过 QueryService、Command、Event 以及 PlatformService 适配器访问运行时。测试工具可以读取快照和注入命令，但不成为游戏运行时依赖，也不能直接写入权威状态。

5. 边界与不做的#

不画运行期时序图——本册只声明静态依赖方向。运行期的调用顺序属于各系统自己的实现细节。
不登记函数级依赖——那属于 TECH-08 接口签名。
不设双向依赖的例外——包括「只是读一下而已」的情况。需要读就用事件或快照。

6. 相邻系统接口#

对象	关系
`TECH-01` 架构总纲	本册的数据流、模块边界、Command/Event/Query 和 PlatformService 在此对齐
`IDX-01` 主文档	主文档 Ⅲ 板块的「分册与代码模块对应」是本册的压缩版
各系统分册	各册第 7 节的接口声明必须与本册一致；冲突时以本册为准

7. 待办与风险#

待办与风险 ① 本册覆盖核心系统与跨系列边界；MOD / AST / CITY / TRANS / 资料片内部机制仍由各自分册负责，本图只登记它们与运行时数据、查询和平台边界的关系。
② TRANS-07 天气被标为「全局系统」，它同时被 SYS-07、TRANS-01~04 依赖。如果未来出现第二个全局系统，需重画主干。
③ 自由模式（MOD-02）引入了公司层级，AST-01 与 SYS-06 的关系需要一次专门梳理。