26 KiB
26 KiB
模块与功能完成度（SSOT）
更新: 2026-09-20（模块开发规范与耦合审计已合入文档；批次 A–G 仍为 planned，不改 production_ready）
production_ready: yes（权威来源：gap-matrix；本表不推导发布门禁）
发布缺口: ../remediation/gap-matrix.md
协作焦点: ../ops/CURRENT.md
连续性审计: ../audit/2026-09-16-feature-matrix-production-readiness-audit.md
整改计划: ../remediation/2026-09-16-feature-matrix-production-readiness-plan.md
本表描述能力成熟度；上线 blocker 见 gap-matrix。二者正交：能力行不必全部
done才能发布；partial/deferred不得自动回退production_ready。2026-09-19 深度审计的 critical/high 已分四批合入
dev（数据一致性、鉴权、SSE/事件、前端 XSS）。不改production_ready。未做项在 long-term。
状态契约
| 字段 | 含义 |
|---|---|
| 声明范围 | 本行冻结的能力边界；done 只对该边界负责 |
| 状态 | done | partial | planned | deferred | blocked | removed（已下线，仅留历史证据） |
| 发布关系 | 与当前首发/已签门禁的关系：non_blocker / 补证 / 加固 / deferred_enhancement |
| 关闭条件 | 何时可将本行升为 done（或关闭 partial）；stub/SKIP/fallback 不得冒充 |
| 证据 | 可追溯到报告/commit/环境/schema；代码或 artifact 变化后须重验 |
| mutex | 并行认领互斥键（见 CURRENT） |
状态判定
done：声明范围内能力已达生产验收证据；不表示该领域永无后续。新增增强须拆行或进 backlog。partial：已交付可用子集，关闭条件仍未满足。planned：方案存在，尚未开始实施。deferred：明确不进当前路线，且不是发布 blocker（除非盘点确认违规 → 升 gap-matrix）。blocked：本行目标无法继续，须写明 blocker 与恢复条件。production_ready：只由 gap-matrix 发布门禁决定。
重验触发器
授权谓词/owner port、schema/迁移/compose/镜像/环境晋升、flag 升级、PI Runner/model/protocol、event consumer/writer、浏览器持久化边界变化时，受影响行须重验；历史 PASS 不能单独证明新 artifact。
禁止
- 靠缩小声明范围制造
done（须保留 before/after 与义务迁移）。 - 用 stub、SKIP、deterministic fallback 冒充真实 PI / 完整叙事闭环。
- 无真实 blocker 变化时改写 gap-matrix /
production_ready。
完成度矩阵
| 模块 | 声明范围 | 状态 | 发布关系 | 证据 | 剩余工作 / 关闭条件 | mutex |
|---|---|---|---|---|---|---|
| Agent worktree 治理自动化 | 主目录保护、任务 worktree、机器认领、候选集成、dev 部署与安全清理 | planned | non_blocker | 方案；调研 | 工作规范 已采纳；人工显式校验立即执行。自动注册表、队列、脚本守卫、部署闭环和权限隔离仍待实施，不能宣称自动强制已完成 | agent-workflow-governance |
| 意图识别 L1 | 18 类 Intent、三分支消解、写/只读分流、双标签 DOC_BUSY、intent 纯依赖边界 |
done | non_blocker | intent-recognition；工作流作用域；审计；报告；双标签；U1–U3 | 边界 before：含 U9–U12 叙事混入 → after：U9–U12 迁至「多意图扩面」行。关闭：纯依赖边界回归即重开 | intent |
| 多意图持久计划（U1–U8 基线） | app/intentflow 生命周期、HITL、默认 legacy、U1–U8 代码与安全基线 |
partial | non_blocker（默认 legacy） | 设计；U1–U8；Wave2 真 PI；2026-09-20 复核 | legacy 有限只读多意图仍默认启用；新持久计划生产组合根仍使用 Fake query owner，confirm 后缺可靠调度，typed 参数/目标版本不足。原 U1–U8 测试证据保留，但不足以证明升 auto_read/confirm 可用。关闭条件见整改方案 Foundation 1 与 Track I |
intent-plan |
| 多意图扩面（U9–U12） | U9 LLM 分段实验；U10 mutate；U11 docgov；U12 workflow/run-control | partial | deferred_enhancement | 设计；go/no-go GO；脚手架；U9；U10；U11；U12；2026-09-20 复核 | U9 proposer 已实现和注入但未进入生产聊天分段调用；提议请求已带 reasoning profile。U10–U12 当前为 dry-run/validated-only adapter。历史直接调用/PI 测试继续有效，不代表 live 接线。逐域实现和验收，禁止以 full 一次放量 |
intent-plan |
| 对话 / ctxmgr baseline | 多轮上下文、刷新/重登/重启恢复、授权同集正文与计数、U10 端口化停止扩面 | done | non_blocker | multi-turn；刷新审计；U10；门禁 B3（项目 6359） | before：语义摘要误标 D5 混入 → after：摘要迁「语义摘要 D3」；D7 数据治理独立。U10 停止扩面 | chat |
| 语义摘要（D3） | 授权后可见集合上的语义摘要；shadow → 可选替换 deterministic | partial | deferred_enhancement | chat-agent-p6-backlog；go/no-go GO；pu6；脚手架；W2 真 PI；2026-09-20 复核 | shadow 默认 off。00058 增加 chat_summaries，写入失败不再伪装成功；运行中的库仍是 schema 53。摘要请求已带 tool_profile=reasoning（argv 为 --no-tools），当前容器要等镜像或 dev 挂载更新后才生效。授权可见集 digest 仍空。SEMANTIC_SUMMARY_REPLACE 未接线。 |
chat |
| 对话数据治理（D7） | 留存/删除口径、库·备份·日志控制、敏感字段加密边界 | deferred | deferred_enhancement（违规则升 blocker） | 计划 Scope Boundaries；收口 §7.1；D7 ADR 草案；W7 盘点；报告；D7-TRACE | after W7：只读盘点完成（sessions/messages/KB/日志/备份/event）。未发现已确认基线违规，未写发布 blocker。口径仍 pending-compliance-signoff；禁止按 365/180/30 物理删除。追踪索引另定为 record（设计 §9），不把本行升 done |
chat |
| 智能体小队 | 角色-任务-工作区-黑板 | done | non_blocker | agent-squad；test 2026-09-07 | 非关键步骤降级(A5/A6)属 backlog | squad |
| 工作流治理 | 三正式工作流、设置页/DutyMode、动作级鉴权、真实 PI 三工作流 E2E、full/none 混合长链 | done | non_blocker | 三工作流整改；409/职责；鉴权；PI E2E；Wave2 full/none | full 跨用户审批 + none 免审批不阻塞已签。纯软件自举仍独立 planned | workflow |
| 研发设计控制（rdev） | 医疗第 4 工作流：13×60 manifest/模板、squad.rdev_doc.v1 kind 编排、main-completed 硬 precheck、StageKey 动态化；不含前端/真 PI/键名空间化 |
partial | deferred_enhancement | 设计；short-term；模板深度；S0+S1 首批报告；S1 续批报告；写作规范；backlog | P0+P1 done。模板深度 S0+S1 首批 + S1 续批 done：60/60 模板已补强；真 PI 抽样 PASS（含 rd_planning_review + rd_design_vv，项目 6446）。剩余：S3 overlay 与 R2/R3 已接。P2 名称匹配、阶段折叠、批量审批已接。选中 rdev 时显示与服务端相同的 CDO 前置说明（workflowPrerequisite.test.ts）。P4 键名空间化已接：发布清单用 bd_/pm_/tm_/sw_，旧键仍走同一套步骤和模板，旧 doc_id 仍可查（keyspace_test.go）。P3 三样本已在 dev 真 PI 上跑过（项目 6533）：rd_sw_plan 规划期关闭；rd_proposal completed 但未对齐模板标题；rd_planning_review 当时质量门禁 score 20，是把同节后一张法规表算进问题行。门禁已只读第一张表；保存的终稿不再报「问题行缺少」。建议书标题仍未对齐模板。没有新的真 PI。见 P3 报告。nightly 未扩成四工作流。 |
workflow-def / rdev-templates |
| 纯软件项目自举 | 软件项目创建、Bootstrap、Delivery、受控工程交接 | partial | deferred_enhancement（明确不挡首发） | 设计；ADR；L1 报告；W5a | before：L1 + UI 仍克隆医疗模板。after W5a：catalog 驱动创建、软件不挂医疗 key、docs_only 真 PI 建议 delivery 且不自动激活。SWBOOT-10 仍 stub（W5b）；本行不升 done | workflow-design |
| IAM / 鉴权 | 项目级 API 鉴权 + RBAC；会话/阶段授权 | done | 加固 | v3 full inventory；session 中断；fail-closed；410 策略；R13 | 全路由 inventory + session 中断负例 + 410 冻结 + R13 基线已签 | authz |
| 文档治理 | 法定文档生命周期 + 租约 + 受控正文读取 | done | non_blocker | docgov；正文 UI；canonical hash；键统一 | 项目 143 只读；不终止。doc_proj* 同一发布键不能再并存 |
docgov |
| 文档版本 baseline | 账本、人工修订、确定性 diff+lineage、运行时 UI、负责人通知 | done | non_blocker | 管理；Round20 UI；ADR；proposed/authoritative | before：完整 PI narrative 混入 → after：迁「PI change-report 叙事」。fallback 报告是本行内显式行为，不是缺口。lineage GET 已按 URL 项目和文档可见性裁剪。test_manager 血缘的下游/上游版本改读文档版本，不再写死 1。Agent 候选报告为 proposed，正式提交才写 authoritative 后继并挂到版本；拒绝、替代后旧报告不能再出建议。人工修订、导入和聊天卡仍未分开预估与正式报告，见 T1。项目追踪索引见下一行 |
docgov |
| 阶段回溯与影响闭环 | 五表追踪索引、影响报告、L1 文档修订、L2 阶段再打开、待复核软标记、对话修订提案 | done | deferred_enhancement（不挡首发） | 设计；Track T；对话化报告 | 已合入 dev。常驻「需求与影响」面板已退役，新待复核与下游影响改走已有项目会话。dev schema 59。test/main 未升。阶段推进确认门禁仍在。不签 D7 对话 ADR，不改 production_ready |
trace-index |
| PI change-report 叙事 | 只读消费 diff+lineage 的 PI 叙事；失败全量降级 fallback | partial | deferred_enhancement | Round20；go/no-go GO；pu7；脚手架；W3 真 PI；2026-09-20 复核；最小化输入 | flag 默认 off。facts.json 含截断后的 hunk 前后文和影响说明，以及完整 hunk/impact 计数与省略数；摘要 digest 仍不含正文。叙事请求已带 tool_profile=reasoning。运行中的 runner 尚未切到 --no-tools。不打开开关 |
docgov |
| 前端工作台 | 三栏 + 块文档 + SSE；错误卡/TaskRunCard 竖向进度/busy；版本冲突信封；demo seed 默认关；终止 preview |
done | non_blocker | workbench；双标签；demo；B4（项目 6363）；TaskRunCard | before：空「缺口」却 partial → after：本行 done。其他 409 消费方信封复用另列 hardening backlog | web |
| PI Runner / 配置链 | pi-agent + MiniMax + typed-result-v1 | done | non_blocker | piagent；container-env；typed-result | 文档生成仍使用读写和搜索工具。tool_profile=reasoning 的 argv 是 --no-tools 且不加载搜索扩展；未知 profile 拒绝启动。dev 挂载了 pi-args.mjs，但本轮未重启容器 |
pi-agent |
| 三环境运维 | dev/test/main + 共享 KB；对话/业务库隔离 | done | non_blocker | PROJECT.md §4；CURRENT 环境快照 dev/test schema 48、main 47 | — | infra |
| CI / E2E | PR CI、PG 集成、治理 PG、已签真实 PI 门禁；nightly schedule/workflow_dispatch + infra/product 分类 receipt |
done | 加固（阻止下一次晋升，不自动否定已发布） | BUG-08；PI 三工作流；Wave2B；Wave2C；W1 green + receipt 6e2476f0… |
before：partial（FullNone product_fail / secrets 文案过时）→ after：secrets 已配；duplicate goose 00048 已清；FullNone+U8 nightly verdict=pass |
ci |
| Artifact 同 digest 晋升 | 候选 commit 一次构建、按 digest 晋升、promotion receipt | done | 加固 | 计划 PU5B；Wave2B；Wave2C | 关闭：same-image pin（candidate-images-* + PINNED_IMAGE_MODE + promote --require-digests）。声明：单机 retag/digest pin；远程 registry 推送另立任务 |
infra |
| 可靠事件核心 | PG dispatcher、notify/advance/projection live、生产闭包 hook 退出、Phase2 选择性解耦已合入 | done | non_blocker | E0A–E2 等；复盘；shared live；phase2 closeout | before：与 FAV off 混成 partial → after：FAV 独立行。选择性后续解耦按收益触发 | architecture-docs / events |
| 模块开发规范 | 窄端口、领域事件、wire DTO 三种契约；故障隔离红线；新增模块/表/事件流程。不含批次 A–G 的代码整改 | done | non_blocker | 规范；审计；ADR | 文档入口已立。代码整改不在本行 | module-decoupling-spec |
| 模块解耦批次 A–G | server 端口装配、chat 解环、docgov 词汇、工作流单向依赖、巨型文件、前端 api client、21 条例外清零 | planned | non_blocker | 分批计划；审计 | 各批独立 short-term 与验收后另拆行升 done。G1 例外 2026-09-28 到期，到期前须迁走或书面延期。禁止把本行标成进行中来代表七批都已开工 |
module-decoupling-spec |
| Final Artifact Vault（FAV） | 不可变终态制品库；FAV_DEGRADED_READ=false |
partial | deferred_enhancement | Track E 复盘；U7 报告；W6 shadow；short-term | after W6：subscriber ObserveShadow 只计算 intended outcome，不写副作用。仍禁止整支 merge；FAV_DEGRADED_READ 默认 false；live 未放量（staging→artifact→publication 各 ≥7 天观察窗） |
events |
| 系统管理台 | 全屏系统级管理视图（总览/KB/特性开关/系统设置/工作流/角色/用户/文档 8 分组）；/api/v1/admin/system/*；system_settings 白名单可写；吸收下线 AdminSettingsModal |
done | non_blocker | short-term；测试报告；commit f1404d5/0eaca61、merge dc7c31e（dev）；dev 冒烟 schema 49 + 四端点 + 写读回环 PASS |
二期：Playwright 实跑、细粒度 system:* 权限、设置审计日志、KB 运维动作、白名单项接消费方 |
web + sysadmin |
| 个人工程中控台（已移出） | 原本地只读看板与后来的 Control Center 都不再属于本仓库 | removed | 进度管理改由独立项目承担 | 历史设计；历史报告 | 2026-09-19 删除 cmd/control-center、internal/controlcenter、control-center/web、deploy/control-center。不恢复 engineering-dashboard |
— |
Wave 0 边界 lineage（收口摘要）
| 行 | before 状态/口径 | after | 原义务去向 | 现有证据是否覆盖冻结边界 |
|---|---|---|---|---|
| Intent L1 | partial（混入 U9–U12） | done | U9–U12 → 多意图扩面 | 是（双标签 + 分流 + U1–U3） |
| Chat/ctxmgr | partial（混入语义摘要 D5 误标） | done | D3 摘要行；D7 治理行 | 是（B3 项目 6359） |
| Document revision | partial（混入完整 PI 叙事） | done | PI change-report 叙事行 | 是（Round20；fallback 为声明行为） |
| Frontend workbench | partial（缺口栏已空） | done | Wave 3 已收口 projectMembers/freeformDoc/taskRuns/chatSessions 结构化错误信封复用 | 是（B4 项目 6363） |
| 可靠事件 | partial（与 FAV 混行） | done | FAV 独立 deferred | 是（E0–E2 + shared live） |
更新规则
- 模块状态变化时同步本表；仅当发布 blocker 出现或关闭时改 gap-matrix
- 同一
mutex同时仅一个 Agentin_progress（见 CURRENT） - 新能力行：复制 ../ops/templates/feature-matrix-row.md
- 拆行/收口须保留 before/after 与义务迁移（见上表）；禁止缩口径假完成
2026-09-17 首次加载性能专项
首次加载与重启首访性能优化：partial（U2 静态交付已验收；U3 只做了登录壳拆包，未关闭）。审计 · 方案 · U2 报告。U2：自托管字体 + br/gzip。U3 进展（fix/audit-remainder-closeout）：导出、预览、管理台、块编辑器、Mermaid/公式改为点击或出现时再加载。入口包 index-*.js 由 2.83 MB / br 626 KB 降到 737 kB / br 170 KB（index-j0BIrjIR.js，包内无 katex）。公式在气泡或正文里出现时才加载，富文本复制同样延后。U3 的浏览器资源瀑布还没测，本行不关。U5：/auth/me 复用本请求已核过的用户，不再第二次解析会话；会话与用户状态合成一次 JOIN。没有锁等待证据，所以不节流 last_seen。TestAuthMe_LogoutNextRequestIs401。U1、U6、U7 未做。U4 进展：登录不再按项目数拉成员名册，只同步当前项目；其他项目先种入当前用户以保持会话可见，完整名册在打开成员面板时取。会话列表不再因项目数组变化而重拉，迟到响应用代次丢弃，同一项目的在途成员请求合并。src/data/initFanout.test.ts。2026-09-19 浏览器证据（e2e/initial-load-performance.spec.ts，n=20，本仓 Vite :3100 代理 :8080）：每次登录成员项目数 1、会话列表 GET 1，匿名与登录后资源路径均无 katex/mermaid/docx。同一探针在重建后的 :8080（index-DOO0-Yh7.js，schema 53，n=5）成员项目 1、会话列表 GET 1，匿名 JS 传输 172,417 B，首屏路径无 katex/mermaid/docx。重建前旧包 n=1 曾是 704/30。慢网 n=3、CPU 4 倍：10 Mbps 表单可见 558–604 ms，2 Mbps 1279–1296 ms，样本不足 20，U1 不关。U6 不加索引：测到的瓶颈是已消失的成员扇出，没有慢 SQL 证据。U7 已测未关：报告。Vite 监听约 0.3 s；314 个模块冷/热 1.45/1.11 s，不是历史十几秒。postgres+app 到 /ready 1.0–1.2 s。无头浏览器缺系统库，登录表单可见未测；不宣称较基线下降 50%。mutex web + static-delivery（U2 done）/ loading-performance-audit。
2026-09-17 文档编制人兼任方案
新增能力 done（U1–U6，已合入 dev@09a9921）：方案 · 源码核查 · U6 验收 · 收口交接。任务归档：archive/ops/2026-09-17-document-author-only-u{1..6}.md。总开关默认 off；test/main 晋升与开放授权另授。变更提案 HTTP 仍缺（audit）。mutex document-duty-policy。