aps-agent/docs/review/a0-gate-conclusion.md

4.4 KiB
Raw Permalink Blame History

A0-G 设计评审结论

  • 评审日期:2026-09-23
  • 参与人:技术负责人(决策人)
  • 方式:追认式。不另开评审会——七项决策在本轮设计中已逐条与决策人确认,本文把确认结果落成记录;每份 ADR 的出处见下表
  • 材料包版本:rewrite/platform,含 ADR-0007(提交 de8d044);本结论随本文件提交
  • 结论:通过

本结论的效力来自「逐条确认 + 提交可查」,不来自会议签字。若后续需要会签记录,另附会议纪要即可,不改变这里的判定。

1 逐份 ADR

编号 结论 决策方式与出处
ADR-0001 技术栈与仓库形态 接受 逐条确认(原地重写、孤儿分支、工作区以 main 内容为起点);提交 7806e41,85fab9d 修订(去掉迁移假设)
ADR-0002 引擎与 Provider 部署形态 接受 决策 D1;提交 8d261af
ADR-0003 数据作用域与权威数据源 接受 决策 D2;提交 8d261af,85fab9d 修订(无历史数据需迁移)
ADR-0004 桌面端与本地能力边界 接受 决策 D4;提交 8d261af
ADR-0005 直接切换,不并行、不迁移 接受 决策 D7;提交 6fb5310
ADR-0006 引擎以长驻子进程运行 接受 决策 D10;提交 e144429
ADR-0007 数据存储选型与双形态一致规则 接受 决策 D11;提交 de8d044

无异议,无退回项。要改结论仍按 docs/adr/README.md 的规则:新写一份 ADR 取代,不改原文。

追认三项在材料包定稿后落地的结论(均已写入决策台账与盘点表):

  • 持久层拆分收敛为平台 7 张 / APS 6 张,平台表不带 aps_ 前缀(原写 12 张)
  • 工艺路线模型归 APS,平台不建模板库
  • 业务数据(主数据、工艺、排产结果)权威方是业务系统,平台只存引用,避免第二事实源

2 遗留项认领

# 遗留项 责任人 时限 处置
1 Pi 扩展桥鉴权(nonce 轮换、端口预留) 平台侧 A3.11 设计时 随 A3.11 出方案
2 引擎进程复用策略 平台侧 A3.10 之后,观察实际进程数 首版不做
3 SQLite 驱动最终确认 平台侧 A3.7(会话落库)之前 实测 better-sqlite3 与 node:sqlite,二选一
4 单机版备份与导出入口 客户端 A6 随界面设计定入口
5 APS 侧数据库选型 APS 侧 B2 APS 自主决定,平台不干预
6 跨进程 Provider 启动条件 平台侧 A8 或更晚 第三方接入或需独立发版时评估
7 legacy/main 备份分支与只读设置 平台侧 切换前(A0.2 执行) 强推覆盖 main 之前必须完成
8 是否另立仓库让体积归零 技术负责人 已决 不另立:孤儿历史不减体积可接受(ADR-0001 遗留)
9 《实施设计》1.4 补 SQLite 路径与主键、时间约定 平台侧 A0.10 随设计文档入库一起做

时限调整:#3 原定 A1.1,A1.1 只建骨架、未引入数据库,改到 A3.7 之前;#2 从"观察后评估"明确为 A3.10 之后。

3 门槛判定

通过标准 结论 说明
七份 ADR 无异议,或异议已记录处置方式 通过 七份全部接受,无异议
遗留项每项有责任人与时限 通过 九项已认领,#8 当场关闭
通过后可直接进入 A0.10 与 A1 通过 A1.1、A1.2 已完成并提交;A0.10 待做

4 后续

  • A0.10 入库范围:两份设计文档(架构设计、实施设计)转入仓库 docs/,同时补《实施设计》1.4 的存储细节
  • A1 启动条件:已满足。已完成 A1.1(monorepo 骨架)、A1.2(依赖方向检查接入 CI)。建议顺序:A1.7(协议与事件模型)→ A1.3(server 最小闭环)→ A1.4(client 最小界面)→ A1.5(一键启动)→ A1.6(补齐 lint 与测试矩阵)
  • 需新增或调整的任务:无(A2.6 能力描述规范、A2.7 问法评测集已在评审前按讨论补入 A2 阶段)

2026-09-23 补记:A0.10 已完成——两份设计文档入库(docs/architecture.md、docs/implementation.md),1.4 已补存储细节。A0 阶段收口。

注:2026-09-23 统一提交署名为 zh givbw@hotmail.com,本分支 10 个提交被重写,提交号随之变化(内容未变)。本文与材料包内的提交号均为重写后的编号。