📄 本页由源文件
skills/dev-flow/references/integration-flow.md自动投影生成（单一权威源）。请勿直接编辑本页。
6C 前后端联调详细流程
本文件由 flow.md 步骤 6C 按需加载。选择「🔗 进行联调」时加载联调执行流程；选择「📝 生成 Commit Message 并暂存」或「⏸️ 直接暂存」时加载暂存等待状态。
联调执行流程
- 环境确认：确认后端接口已就绪、dev server 已启动、测试数据已准备
- 恢复真实逻辑：如有灰度强制开启等调试代码，评估是否需要临时恢复真实逻辑进行联调（或保留调试代码辅助排查）
- 功能验证：按需求逐项验证前后端交互是否正常
- 接口请求/响应数据格式是否匹配
- 业务逻辑是否符合预期（增删改查、状态流转等）
- 异常场景处理（接口超时、错误码、空数据等）
- 问题记录：联调中发现的问题分类记录
- 前端问题 → 回退步骤 5 修复 → 重走 5.5 → 6A → 继续联调
- 后端问题 → 记录并反馈给后端，等待修复后重新验证
- 协议问题 → 前后端协商确认，更新工作上下文
## 约束与决策
暂存等待状态
- 更新工作上下文进度为「等待联调」，恢复指令中记录联调前置条件
- 恢复指令中标注暂存前置处理的执行情况（是否已生成 commit）
- 后端就绪后，用户通过迭代修复信号（如「后端接口好了」「可以联调了」「继续上次的需求」）恢复流程
- 恢复后从联调执行流程的第 1 步开始
v3 字段写入指引（联调场景，2026-05-12 新增）
本章节定义联调场景下
.flow文件 v3 字段的写入规则，与references/active-flows.md的 v3 schema 联动。
进入联调时（步骤 6C 触发）
.flow 字段 | 写入值 | 说明 |
|---|---|---|
phase | integration | 与 current_step=6 正交，标记当前处于联调阶段 |
status | active | 用户主动联调推进时 |
recovery.yesterday | "联调已开始，前端已恢复真实逻辑（或保留调试代码）" 等 | 与工作上下文 ### 恢复指令 同步 |
recovery.next_action | "验证 X 接口的 Y 场景" / "等待后端修复 Z 问题" | 联调中的下一步具体动作 |
recovery.pending | 联调发现的待确认问题（前后端协议不一致 / 异常场景未覆盖等） | 0-3 条 |
暂存等待后端时（暂存等待状态触发）
.flow 字段 | 写入值 | 说明 |
|---|---|---|
phase | integration（保持不变） | 阶段语义不变，仍属联调阶段 |
status | blocked-by-backend | 关键状态切换：从 active 切换到 blocked-by-backend，新对话恢复时 AI 首响欢迎语会变为「接口好了吗？还是先看看其他需求？」 |
recovery.yesterday | "联调发现 X 接口 Y 字段缺失，已暂存等待后端" | 简述阻塞原因 |
recovery.next_action | "等后端确认 X 接口修复进度后恢复联调" | 明确等待对象 |
recovery.pending | 待后端确认/修复的具体问题清单 | 必填，作为后端就绪后的检查清单 |
联调恢复时（用户说「后端接口好了」等信号）
.flow 字段 | 写入值 | 说明 |
|---|---|---|
phase | integration（保持不变） | — |
status | active | 从 blocked-by-backend 切回 active |
recovery.yesterday | "暂存期间后端已修复 X，准备恢复联调" | 衔接暂存到恢复的过渡描述 |
recovery.next_action | "重新验证 X 接口的 Y 场景" | 从联调执行流程第 1 步开始 |
联调通过时（进入步骤 7）
.flow 字段 | 写入值 | 说明 |
|---|---|---|
phase | 切换为 commit-archive | 阶段切换信号 |
status | active | — |
last_commit_hash | 步骤 7 commit 后的新 hash | 见 step-router.md L482-484 |
联调专用工作上下文区块
进入 phase: integration 时，工作上下文必须存在 ## 联调暂存 区块（见 references/working-context.md §「阶段感知区块」→ §「## 联调暂存（仅 phase: integration 时强制要求）」），用于记录"为联调临时改动、联调结束后必须恢复"的清单。 该区块在联调结束后不删除（作为历史档案），仅将每条记录的"状态"列改为 ✅ 已恢复 或 ❌ 已遗留。
联调通过标准
- 所有涉及的接口调用正常（请求发出、响应正确解析）
- 业务功能符合需求描述（任务平台/Figma 中定义的行为）
- 无控制台报错（网络错误、JS 异常等）
回退机制
| 情况 | 处理 |
|---|---|
| ✅ 联调通过 | 清理调试代码 → 步骤 7 |
| ⚠️ 前端问题 | 回退步骤 5 修复 → 5.5 → 6A → 继续 6C 联调 |
| ⚠️ 后端问题 | 记录问题 → 暂存等待后端修复 → 后端修复后恢复联调 |
| ⚠️ 协议不一致 | 前后端协商 → 按协商结果调整（可能回退步骤 3 重新制定方案） |
| ❌ 联调不通过 | 分析根因 → 按根因回退到对应步骤 |