2.0 KiB
2.0 KiB
Phase 0 领域契约索引
基线版本：2026-07-26 适用范围：
/chat、/set_info、/get_info规则来源优先级：V1.0.9 接口文档 > 2026-07-26 workflow/Prompt > 当前服务代码 > 历史 workflow/Prompt
本目录冻结 LangGraph 迁移前的外部契约和业务规则。JSON 文件是后续代码生成、参数化测试和 Graph validator 的机器可读输入；Markdown 文件解释兼容行为及来源。
交付物
| 文件 | 用途 |
|---|---|
api-contract.md |
三个接口的当前兼容行为和已知偏差 |
stage-codes.json |
状态码、内部/外部映射和产生方式 |
stage-transitions.json |
权威迁移矩阵和拍照顺序 |
field-registry.json |
字段、分组、类型、敏感性和写权限 |
business-rules.md |
从 workflow、Prompt 和 endpoint 提取的规则 |
event-mapping.md |
历史魔法字符串到结构化事件的映射 |
../baselines/fastgpt-baseline-20260726.md |
迁移前可复现测试/性能基线 |
../../test/fixtures/golden/accident-scenarios.json |
脱敏黄金场景 |
已冻结的关键决定
- 对外继续使用 camelCase、字符串业务码和 JSON 编码的
/get_info.value。 3001、3002为内部信息确认状态，对外仍返回1002。2006、2017、2020仅作为历史别名接收，不作为新图的合法目标状态。0004纳入正式状态表；当前 endpoint 状态名称映射缺失是待修复偏差，不代表删除该状态。- 拍照完成、连续拍照失败、无回复和外部字段更新在新图中必须是结构化确定性事件。
sfzmwh1/2、sjwh1/2是只读兼容字段，不允许/set_info写入。phase、stage_code、计数器、版本和图路由字段禁止外部修改。
变更规则
Phase 0 冻结后，修改这里的状态、字段或外部契约必须同时：
- 说明业务原因和兼容影响；
- 更新机器可读 JSON；
- 更新黄金场景；
- 更新对应契约/领域测试；
- 获得接口调用方或产品确认。