Start LangGraph backend migration foundation

docs/langgraph-backend-migration-plan.md

@@ -1,7 +1,8 @@
 # ZNJJ LangGraph 后端改造计划
 
-> 状态：Draft  
-> 日期：2026-07-25  
+> 状态：Phase 0 已冻结，LangGraph 最小开发纵切已启动
+> 日期：2026-07-25
+> Phase 0 收口日期：2026-07-26
 > 目标项目：`ZNJJ-api-server`  
 > 参考项目：`fastapi-langgraph-agent-production-ready-template`
 
@@ -1113,6 +1114,17 @@ secret 扫描
 
 ### Phase 0：基线与契约冻结
 
+#### 完成记录（2026-07-26）
+
+- 已冻结三个接口的兼容行为：`docs/domain/api-contract.md`。
+- 已建立机器可读状态码表、字段注册表和状态迁移矩阵：`docs/domain/*.json`。
+- 已从 V1.0.9 接口文档、2026 workflow、Prompt 和 endpoint 提取业务规则及事件映射。
+- 已建立 15 个脱敏黄金场景：`test/fixtures/golden/accident-scenarios.json`。
+- 全量测试由 32 个增加到 48 个，全部通过。
+- 已记录可复现的本地 API 适配层延迟基线和生产指标采集口径。
+- 已清理 HTTP/环境样例中的明文 FastGPT Token；本地 secret 改由被忽略的 `.env.local` 保存。
+- 生产延迟、错误率和转人工比例依赖部署环境数据，当前不得用估算值替代，最迟在 Phase 9 shadow 前补录。
+
 #### 工作项
 
 - 梳理现有三个接口的真实请求/响应行为。
@@ -1138,6 +1150,18 @@ secret 扫描
 
 ### Phase 1：工程骨架与配置
 
+#### 最小纵切记录（2026-07-27）
+
+- 已引入 Pydantic Settings 的最小字段：环境、backend、FastGPT、LLM、checkpointer。
+- 已实现 `AGENT_BACKEND=fastgpt|langgraph` 后端工厂，默认保持 FastGPT。
+- 已实现 `StateGraph + InMemorySaver + OpenAI-compatible LLM` 的可运行开发骨架。
+- 已验证同一 `sessionId` 的 thread 状态延续和不同 session 隔离。
+- 已固定 `langgraph==1.2.9`、`pydantic-settings==2.14.2`。
+- 全量测试 58 个通过。
+- 完整配置拆分、健康检查、request ID 和结构化日志按用户决定后补。
+
+开发说明见 `docs/langgraph-minimal-slice.md`。
+
 #### 工作项
 
 - 建立 `pyproject.toml` 和 lockfile。
@@ -1395,4 +1419,3 @@ AGENT_BACKEND=fastgpt
 11. LLM provider、模型白名单、超时、配额和容灾策略。
 12. Shadow 和灰度的业务验收指标。
 13. FastGPT 下线前需要保留的历史会话和迁移方式。
-