仓库地址:repo
0. 什么是这次升级的核心
MVP 0.4 的关键升级是:在 JSON PRD 与树分解之间增加一层全局接口层。目标很明确:统一全局状态操作口径,切断叶子节点无约束直接改状态的路径。
1. 原问题:状态操作语义分裂
在 MVP 0.3.x 中,叶子节点虽然声明了状态操作,但运行时仍出现两类严重问题:
- 不同节点对同一数据源结构理解不一致
- 节点通过
global直接修改状态,入口分散且不可治理
这会在代码拼接后触发运行时冲突,破坏树结构边界。
2. 方案:全局接口层前置治理
全局接口层在树分解前完成三件事:
- 全局数据源技术选型与结构定型
- 统一读写接口定义与固化
- 将授权接口按需下发给叶子节点
同时在验证阶段增加规则:出现 global 直接拒绝,强制重生成为接口调用式实现。

3. 三个关键收益
3.1 状态治理口径统一
所有叶子节点只能走统一接口,避免同源多义和硬编码分叉。
3.2 外部 API 治理纳入同一抽象
外部 API 可以等价抽象为“远程数据源”,同样纳入统一接口与授权治理。

3.3 类与领域模型开始落地
引入接口层后,状态承载可以更自然地和类模型结合,领域概念不再只能停留在函数拼装层。

4. 仍待解决的问题
- 当前接口类型偏基础,复杂业务能力不足
- 分解中后期新发现需求可能冲击前置定型结构
后续方向是:在统一治理前提下,让接口能力从分解过程自然生长,而不是一次性静态写死。