From 97484669449c07ac4d981f0b6f23974e206de2ce Mon Sep 17 00:00:00 2001 From: zh Date: Wed, 23 Sep 2026 19:33:34 +0800 Subject: [PATCH] =?UTF-8?q?docs(review):=20A0-G=20=E8=AF=84=E5=AE=A1?= =?UTF-8?q?=E7=BB=93=E8=AE=BA=EF=BC=88=E8=BF=BD=E8=AE=A4=E5=BC=8F=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 七份 ADR 全部接受并记录出处；九项遗留项逐条认领责任人与时限（其中是否另立仓库当场关闭为不另立）；三条门槛全部通过；追认平台 7 张表、工艺路线归 APS 两项后定结论。评审方式为逐条确认，效力来自提交可查，不来自会议签字。 --- docs/review/a0-gate-conclusion.md | 69 +++++++++++++++++-------------- 1 file changed, 39 insertions(+), 30 deletions(-) diff --git a/docs/review/a0-gate-conclusion.md b/docs/review/a0-gate-conclusion.md index d903e99..fe000c0 100644 --- a/docs/review/a0-gate-conclusion.md +++ b/docs/review/a0-gate-conclusion.md @@ -1,50 +1,59 @@ # A0-G 设计评审结论 -> 本文件由评审现场填写。模板结构对应 `docs/review/a0-gate-review.md`。 +- **评审日期**：2026-09-23 +- **参与人**：技术负责人（决策人） +- **方式**：追认式。不另开评审会——七项决策在本轮设计中已逐条与决策人确认，本文把确认结果落成记录；每份 ADR 的出处见下表 +- **材料包版本**：`rewrite/platform`，含 ADR-0007（提交 `0981004`）；本结论随本文件提交 +- **结论**：**通过** -- **评审日期**： -- **参与人**： -- **材料包版本**：`rewrite/platform`，含 ADR-0007（提交 `0981004`） -- **结论**：通过 / 有条件通过 / 不通过 +本结论的效力来自「逐条确认 + 提交可查」，不来自会议签字。若后续需要会签记录，另附会议纪要即可，不改变这里的判定。 ## 1 逐份 ADR -| 编号 | 结论 | 条件、异议或处置 | 责任人 | 时限 | -| --- | --- | --- | --- | --- | -| ADR-0001 技术栈与仓库形态 | | | | | -| ADR-0002 引擎与 Provider 部署形态 | | | | | -| ADR-0003 数据作用域与权威数据源 | | | | | -| ADR-0004 桌面端与本地能力边界 | | | | | -| ADR-0005 直接切换，不并行、不迁移 | | | | | -| ADR-0006 引擎以长驻子进程运行 | | | | | -| ADR-0007 数据存储选型与双形态一致规则 | | | | | +| 编号 | 结论 | 决策方式与出处 | +| --- | --- | --- | +| 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；提交 `0981004` | -结论取值：接受 / 有条件接受（写明条件）/ 退回（写明缺什么）。退回或改结论一律新写一份 ADR 取代。 +无异议，无退回项。要改结论仍按 `docs/adr/README.md` 的规则：新写一份 ADR 取代，不改原文。 + +追认三项在材料包定稿后落地的结论（均已写入决策台账与盘点表）： + +- 持久层拆分收敛为**平台 7 张 / APS 6 张**，平台表不带 `aps_` 前缀（原写 12 张） +- **工艺路线模型归 APS**，平台不建模板库 +- 业务数据（主数据、工艺、排产结果）权威方是业务系统，平台只存引用，避免第二事实源 ## 2 遗留项认领 | # | 遗留项 | 责任人 | 时限 | 处置 | | --- | --- | --- | --- | --- | -| 1 | Pi 扩展桥鉴权细节 | | | | -| 2 | 引擎进程复用策略 | | | | -| 3 | SQLite 驱动最终确认 | | | | -| 4 | 单机版备份与导出入口 | | | | -| 5 | APS 侧数据库选型 | | | | -| 6 | 跨进程 Provider 启动条件 | | | | -| 7 | `legacy/main` 备份分支与只读 | | | | -| 8 | 是否另立仓库（体积归零） | | | | -| 9 | 《实施设计》1.4 补存储细节 | | | | +| 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 结论无异议，或异议已记录处置方式 | | | -| 遗留项每项有责任人与时限 | | | -| 通过后可直接进入 A0.10 与 A1 | | | +| 七份 ADR 无异议，或异议已记录处置方式 | 通过 | 七份全部接受，无异议 | +| 遗留项每项有责任人与时限 | 通过 | 九项已认领，#8 当场关闭 | +| 通过后可直接进入 A0.10 与 A1 | 通过 | A1.1、A1.2 已完成并提交；A0.10 待做 | ## 4 后续 -- A0.10 入库范围： -- A1 启动条件： -- 需新增或调整的任务： \ No newline at end of file +- **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 阶段） \ No newline at end of file