From 183113f62464d8a49e6454a9bde99525cd087edc Mon Sep 17 00:00:00 2001 From: iomgaa Date: Mon, 10 Aug 2026 04:24:01 -0400 Subject: [PATCH] =?UTF-8?q?docs:=200011=20=E4=B8=8E=200012=20=E8=BD=AC?= =?UTF-8?q?=E5=B7=B2=E6=8E=A5=E5=8F=97=EF=BC=8CREADME=20=E9=98=B6=E6=AE=B5?= =?UTF-8?q?=E6=B8=85=E5=8D=95=E5=8B=BE=E5=88=B0=20=E2=91=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ④ 与 ⑤ 都勾上但各自注明了欠账：e2e 那一层还是空的（它要打真实模型网关）；事件出口没有调用 点（Event 还没有字段）；stores 只有逐行追加那一种形态。勾上是因为骨架与十个模块确实都落地 了，注明欠账是因为清单是进度的权威处，含糊会让人以为这两件事已经做完。 --- README.md | 9 ++++++--- research-wiki/design/0011-jsonl-run-store.md | 2 +- research-wiki/design/0012-gateway-model-client.md | 2 +- 3 files changed, 8 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 44abc56..7cadd81 100644 --- a/README.md +++ b/README.md @@ -39,9 +39,12 @@ 所以它排在架构前面：边界画错，后面每一份架构文档都要重写 - [x] ③ 架构 —— `research-wiki/explanation/architecture.md` 与 `pyproject.toml` 的 import-linter 契约。 架构文档先于代码存在，此期间它是一份规格而不是描述，文档开头须写明这一点 -- [ ] ④ 测试框架 —— unit / integration / e2e / contract 四层骨架（划分判据是「依赖什么」， - 见 [CLAUDE.md](CLAUDE.md) §1.9），以及 `tests/contract/` 那套公共行为一致性用例的形状 -- [ ] ⑤ 实现 —— 分块落地，每块必须有对应层级的测试接住，守着它的 import-linter 契约在同一个提交里加上 +- [x] ④ 测试框架 —— unit / integration / contract 三层已在跑；**e2e 还是空的**，它要打真实 + 模型网关（划分判据是「依赖什么」，见 [CLAUDE.md](CLAUDE.md) §1.9）。`tests/contract/` + 那套公共行为一致性用例接上了自带的存储实现，解释器与执行器那几条仍等下游把实现接进来 +- [x] ⑤ 实现 —— 十个模块全部落地。**两处已知欠账**：事件出口收下了但没有调用点（`Event` + 还没有字段，事件集要独立成一份 design doc）；`stores` 只有逐行追加那一种形态，关系 + 数据库那种由下游自己实现，契约套件是它的准入标准 - [ ] ⑥ 迁移验收 —— 真的把 dissect 与 GovDoc-SaaS 迁过来，以两边测试全绿为准 ## 本地检查 diff --git a/research-wiki/design/0011-jsonl-run-store.md b/research-wiki/design/0011-jsonl-run-store.md index 3dc27a1..9f91785 100644 --- a/research-wiki/design/0011-jsonl-run-store.md +++ b/research-wiki/design/0011-jsonl-run-store.md @@ -1,6 +1,6 @@ # Design 0011 · 逐行追加的日志存储 -**日期** 2026-08-10 · **状态** 待确认 +**日期** 2026-08-10 · **状态** 已接受（2026-08-10 项目负责人确认） **落实** `0003-public-api-shape.md` 决策四与 `0005-storage-atomicity-and-record-fields.md` 决策二、五。那两份定了存储接缝有哪六个方法、写入粒度是什么、哪两次写是耐久屏障、以及前缀 diff --git a/research-wiki/design/0012-gateway-model-client.md b/research-wiki/design/0012-gateway-model-client.md index 40cd482..d659207 100644 --- a/research-wiki/design/0012-gateway-model-client.md +++ b/research-wiki/design/0012-gateway-model-client.md @@ -1,6 +1,6 @@ # Design 0012 · 模型调用接缝的网关适配器 -**日期** 2026-08-10 · **状态** 待确认 +**日期** 2026-08-10 · **状态** 已接受（2026-08-10 项目负责人确认） **落实** `0003-public-api-shape.md` 决策四里的模型调用接缝，与 `../../CLAUDE.md` §1.5 「模型调用一律走 PolyGateway，不在本项目里另写重试 / 限流 / 熔断 / 缓存 / 遥测」。