岗位会商

frontend-web/docs/position-roundtable-delivery-workflow-plan.md

@@ -4,6 +4,29 @@
 >
 > 目标：在现有岗位会商基础上补齐“产物交付、查看、驳回、方案总结、行动规划”的完整闭环，同时继续保持原多智能体会商页面不受影响。
 
+## 实施核对（2026-07-21）
+
+本计划已按“岗位会商独立路由、无总控、各席位直接问答”的边界完成第一轮闭环。实际流程调整为：
+
+```text
+任务信息 → 情报分析岗识别并确认意图 → 启动校验并冻结业务链
+→ 分阶段席位直接问答/交付 Markdown → 全部有效交付
+→ 方案总结智能体（roundtable-summary）→ 行动规划智能体（position-action-planner）
+→ 可随时返回交付产物驳回 → 后续阶段及内置产物级联失效 → 重做后重新收口
+```
+
+- [x] 情报意图、业务链选择、席位岗位归属和席位智能体配置均在启动前校验；启动后保存业务链快照。
+- [x] 普通席位直接调用各自分配的智能体，并注入任务、意图及已完成上游席位的问答/产物；不经过总控智能体。
+- [x] 普通席位必须在 `outputs` 中交付 Markdown 才会完成；情报分析岗以确认的结构化意图完成为准。
+- [x] 节点、交付卡片、流程图和大图弹窗均展示 `locked / ready / running / done / rejected / stale / error` 状态，并可回看节点会话和产物。
+- [x] 驳回要求标题和理由；当前节点转为 `rejected`，后续阶段按依赖转为 `stale/locked`，总结和行动规划同时失效，历史内容保留可查看。
+- [x] 被驳回或失效的普通席位必须写入一份**新的或已改写** Markdown 才能再次完成；单纯继续问答且没有新交付不会误使下游产物失效。
+- [x] 方案总结复用 `roundtable-summary` 的真实流式线程；行动规划新增 `position-action-planner`，强制输出 Markdown 报告和 `action-plan-subtasks.json`。
+- [x] 两个内置智能体的线程、产物快照和来源节点版本栅栏均持久化；流式期间若上游版本变化，旧运行不能覆盖最新状态。
+- [x] 右侧“交付产物”可查看内置节点结果、继续同一线程问答/修改交付，并在打开 Markdown 沙箱时自动收起右栏。
+
+设计收敛：当前版本以节点的 `artifact_manifest`、`latest_answer`、版本、驳回记录及 Session 内置快照作为唯一事实来源，已能覆盖统一产物卡片和级联逻辑，因此不新增重复的 `position_roundtable_deliverables` 表。若后续需要“单个文件独立驳回、跨会话检索或完整版本对比”，再将清单归一化为独立产物表，避免现在的双写一致性风险。
+
 ## 0. 核心结论
 
 - 方案总结智能体建议复用现有会商里的 `roundtable-summary` 能力，但不要直接搬整套 Step 3 页面流程。
@@ -75,32 +98,32 @@
 
 ### 3.1 Session 扩展
 
-`position_roundtable_sessions` 建议增加：
+`position_roundtable_sessions` 已使用下列持久化字段：
 
 | 字段 | 含义 |
 | --- | --- |
-| `workflow_status` | `intent_pending / active / summarizing / planning / completed / archived` |
+| `status` | `intent_pending / active / completed / archived`；总结/规划运行态由前端瞬时状态与对应快照的 `status` 表示，避免一次运行中断后留下伪运行态 |
 | `summary_thread_id` | 方案总结智能体线程 |
 | `summary_snapshot` | 最新有效总结报告快照 |
 | `action_plan_thread_id` | 行动规划智能体线程 |
 | `action_plan_snapshot` | 最新有效行动规划快照 |
-| `invalidated_at` | 最近一次级联失效时间，可选 |
+| `invalidated_at` | 记录在 `summary_snapshot` / `action_plan_snapshot` 内，包含 `invalidated_by`，无需重复写 Session 字段 |
 
 ### 3.2 Node 扩展
 
-`position_roundtable_nodes` 建议增加：
+`position_roundtable_nodes` 已使用下列字段（展示状态由前端按状态映射）：
 
 | 字段 | 含义 |
 | --- | --- |
-| `display_status` | 面向前端的聚合状态，可后端计算也可前端映射 |
+| `status` | `locked / ready / running / done / stale / rejected / error`，前端直接映射为展示状态 |
 | `rejection_count` | 当前节点累计驳回次数 |
 | `last_rejection` | 最新驳回标题、理由、操作者、时间 |
-| `valid_revision` | 当前有效交付版本 |
+| `revision` | 当前有效交付版本 |
 | `invalidated_by` | 导致当前节点失效的上游节点 key |
 
-### 3.3 Deliverable 新表
+### 3.3 Deliverable 新表（后续可选）
 
-建议新增 `position_roundtable_deliverables`，不要只依赖 `artifact_manifest`。
+当需要“单个文件独立驳回、跨会话检索或完整版本对比”时，再新增 `position_roundtable_deliverables`，不要只依赖 `artifact_manifest`。
 
 | 字段 | 含义 |
 | --- | --- |
@@ -121,7 +144,7 @@
 | `created_at` | 创建时间 |
 | `updated_at` | 更新时间 |
 
-这样右侧产物卡片、驳回记录、总结输入材料都能从同一张表聚合。
+当前第一轮不新增这张表：右侧产物卡片、驳回记录、总结输入材料从节点 `artifact_manifest`、节点版本/驳回记录和 Session 快照聚合，避免节点表与产物表双写。后续引入该表时，应把它提升为唯一事实来源，而不是并行维护两套状态。
 
 ## 4. 驳回与级联失效规则
 
@@ -173,25 +196,27 @@
 
 | 方法 | 路径 | 用途 |
 | --- | --- | --- |
-| `GET` | `/api/position-roundtable/sessions/{id}/deliverables` | 获取右侧产物列表 |
-| `GET` | `/api/position-roundtable/deliverables/{deliverable_id}` | 获取产物详情 |
-| `POST` | `/api/position-roundtable/deliverables/{deliverable_id}/reject` | 驳回产物并触发级联失效 |
-| `POST` | `/api/position-roundtable/nodes/{node_id}/complete-turn` | 节点回答结束后同步回答与产物 |
+| `GET` | `/api/position-roundtable/sessions/{id}/results` | 获取右侧统一产物来源节点（前端聚合文件与内置快照） |
+| `GET` | `/api/position-roundtable/sessions/{id}/nodes/{node_key}` | 获取节点详情；文件正文由既有线程产物预览接口读取 |
+| `POST` | `/api/position-roundtable/sessions/{id}/nodes/{node_key}/reject` | 驳回当前节点交付并触发级联失效 |
+| `POST` | `/api/position-roundtable/sessions/{id}/nodes/{node_key}/complete-turn` | 节点回答结束后同步回答与产物 |
 
 ### 5.3 方案总结与行动规划
 
 | 方法 | 路径 | 用途 |
 | --- | --- | --- |
-| `POST` | `/api/position-roundtable/sessions/{id}/summary/start` | 启动或重启方案总结 |
-| `POST` | `/api/position-roundtable/sessions/{id}/summary/ask` | 对方案总结继续提问或修改 |
-| `POST` | `/api/position-roundtable/sessions/{id}/action-plan/start` | 基于总结和产物生成行动规划 |
-| `POST` | `/api/position-roundtable/sessions/{id}/action-plan/ask` | 对行动规划继续提问或修改 |
+| `POST` | `/api/position-roundtable/sessions/{id}/summary/prepare` | 服务端准备版本锁定的总结材料和线程信息 |
+| `POST` | `/api/position-roundtable/sessions/{id}/summary/ask` | 服务端准备总结的同线程续问材料 |
+| `POST` | `/api/position-roundtable/sessions/{id}/summary/complete` | 校验 Markdown 交付与来源版本后持久化总结快照 |
+| `POST` | `/api/position-roundtable/sessions/{id}/action-plan/prepare` | 服务端准备行动规划材料和线程信息 |
+| `POST` | `/api/position-roundtable/sessions/{id}/action-plan/ask` | 服务端准备行动规划同线程续问材料 |
+| `POST` | `/api/position-roundtable/sessions/{id}/action-plan/complete` | 校验 Markdown + JSON 交付与来源版本后持久化行动规划快照 |
 
 可以复用现有 `streamMultiAgent` 流式协议，但建议在岗位会商下包一层 API，由后端负责拼装岗位会商材料，前端不直接拼长 prompt。
 
 ## 6. 前端实施步骤
 
-### 阶段 1：状态与启动校验
+### 阶段 1：状态与启动校验（已完成）
 
 - 扩展 `PositionNodeStatus` 和状态显示映射。
 - “确认意图并启动业务链”前补齐校验提示。
@@ -201,7 +226,7 @@
 
 验收标准：未选择业务链、岗位未配齐、意图未完成时都能准确阻止启动；启动后流程图能显示各节点状态。
 
-### 阶段 2：流程图弹窗
+### 阶段 2：流程图弹窗（已完成）
 
 - 左侧保留小型从上到下流程图。
 - 流程图右上角增加“查看”按钮。
@@ -210,7 +235,7 @@
 
 验收标准：小图不挤占左侧空间，大图能完整展示业务链和两个内置收口节点。
 
-### 阶段 3：产物卡片与预览
+### 阶段 3：产物卡片与预览（已完成）
 
 - 右侧新增或改造“分析结果”Tab 为“交付产物”列表。
 - 卡片展示智能体名称、产物名称、岗位名称、时间、状态。
@@ -220,7 +245,7 @@
 
 验收标准：节点回答和文件产物能进入统一产物列表；点击可查看详情。
 
-### 阶段 4：驳回弹窗与级联失效
+### 阶段 4：驳回弹窗与级联失效（已完成）
 
 - 新增 `RejectDeliverableDialog`。
 - 驳回表单包含标题和理由，均必填。
@@ -230,7 +255,7 @@
 
 验收标准：驳回第一阶段任意节点后，第二阶段及之后产物都显示未完成或已失效；旧内容可查看但不能作为总结输入。
 
-### 阶段 5：方案总结智能体
+### 阶段 5：方案总结智能体（已完成）
 
 - 封装 `usePositionSummary`，内部复用 `roundtable-summary` 的线程初始化、流式输出和 Markdown 产物预览能力。
 - 输入材料改为岗位会商材料：
@@ -245,7 +270,7 @@
 
 验收标准：总结报告使用现有方案总结能力生成 Markdown；刷新页面后可恢复；上游驳回后总结标记失效。
 
-### 阶段 6：行动规划智能体
+### 阶段 6：行动规划智能体（已完成）
 
 - 新增内置智能体 ID，建议先命名为 `position-action-planner`。
 - 新增行动规划 prompt：
@@ -261,7 +286,7 @@
 
 验收标准：行动规划能生成可读报告和结构化子任务；刷新可恢复；上游驳回后自动失效。
 
-### 阶段 7：返回修改与重新生成
+### 阶段 7：返回修改与重新生成（已完成）
 
 - 用户在方案总结或行动规划视图中仍可切回“交付产物”。
 - 驳回后自动显示需要重做的节点。
@@ -270,7 +295,7 @@
 
 验收标准：不会因为进入总结/规划阶段而锁死前序产物；前序重做后能形成新版本闭环。
 
-### 阶段 8：测试与回归
+### 阶段 8：测试与回归（已完成）
 
 - 后端测试：
   - activate 校验。