Start LangGraph backend migration foundation

docs/langgraph-minimal-slice.md

@@ -0,0 +1,82 @@
+# LangGraph 最小开发纵切
+
+> 状态：仅用于本地开发和测试
+> 日期：2026-07-27
+
+## 启用
+
+在被 Git 忽略的 `.env.local` 中配置：
+
+```text
+ZNJJ_ENVIRONMENT=development
+AGENT_BACKEND=langgraph
+LANGGRAPH_CHECKPOINTER=memory
+
+LLM_API_KEY=...
+LLM_BASE_URL=https://api.openai.com/v1
+LLM_MODEL=...
+LLM_TIMEOUT_SECONDS=60
+LLM_MAX_RETRIES=2
+```
+
+不设置 `AGENT_BACKEND` 时默认使用 FastGPT。
+
+## 当前调用链
+
+```text
+/chat
+  -> ChatBackend
+  -> LangGraphBackend
+  -> StateGraph
+  -> generate_response
+  -> OpenAI-compatible LLM
+  -> ChatResult
+  -> 现有非流式/SSE API Adapter
+```
+
+`InMemorySaver` 使用 `sessionId` 作为 `thread_id`，同一进程内同一 session
+可以恢复 `turn_count` 等图状态；不同 session 相互隔离。
+
+## 当前已有能力
+
+- FastGPT/LangGraph 后端配置切换。
+- 最小 Pydantic Settings 和条件化启动校验。
+- 实际使用 LangGraph `StateGraph`。
+- 开发/测试使用 `InMemorySaver`。
+- OpenAI-compatible LLM 节点。
+- 非流式 `/chat` 适配。
+- 通过完整结果桥接现有 SSE；`formUpdate` 先于文本发送。
+- Fake LLM 下的多轮 thread 隔离测试。
+
+## 明确限制
+
+当前图只有一个模型节点，目的是尽早建立可执行骨架。以下尚未实现：
+
+- 领域状态、输入事件和确定性路由节点；
+- 状态码枚举及迁移合法性校验；
+- 单车/双车拍照状态机；
+- 字段提取、验证和真实 `formUpdate`；
+- 模型 token 级流式输出；
+- PostgreSQL checkpointer；
+- session 并发、版本和幂等；
+- `/set_info`、`/get_info` 的业务状态迁移。
+
+因此：
+
+- `LANGGRAPH_CHECKPOINTER=postgres` 当前会启动失败；
+- staging/production 禁止使用 memory checkpointer；
+- `/set_info`、`/get_info`、`/delete_session` 暂时仍需要 FastGPT 配置；
+- 不得把当前 LangGraph backend 接入生产流量。
+
+## 下一步
+
+直接在现有图中加入 Phase 5 的纯确定性骨架：
+
+1. `AccidentState`、输入事件和状态枚举；
+2. state prefix parser 与迁移 validator；
+3. `normalize_input`、`route_phase`；
+4. 单车/双车拍照事件推进；
+5. 无回复和澄清计数；
+6. 对应参数化 Graph 测试。
+
+这些节点完成后再接 PostgreSQL 和业务状态 repository。