From 3e081addf0c06ba2fc27e0710a00fa1495fc502c Mon Sep 17 00:00:00 2001 From: Windows <19353512109@163.com> Date: Sat, 12 Sep 2026 13:00:30 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20docs/32=E3=80=81docs/33=20=E8=AE=A9?= =?UTF-8?q?=E5=8F=B7=E8=87=B3=2037=E3=80=8138=EF=BC=88=E4=B8=BB=E5=B9=B2?= =?UTF-8?q?=E7=BB=AD=E5=8D=A0=2032=E2=80=9336=EF=BC=89=EF=BC=9B=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=E5=BC=95=E7=94=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 主干 `qyqy_develop` 已占用 29–36（29 登录接口 / 30 投顾迁移TODO / 31 投顾灰度 / 32 平台侧交接与联调准备 / 33–35 ZSY 底座扩展确认往来 / 36 PR7 合并记录）， 本线原用的 32、33 与之重号。按"以架构师为主线"继续让号。 - `docs/32-记忆投影链路实现说明.md` → `docs/37-记忆投影链路实现说明.md` - `docs/33-架构对齐-记忆与画像投影链路.md` → `docs/38-架构对齐-记忆与画像投影链路.md` （两次 `git mv`，保留文件历史） - 同步更新 `AGENTS.md` 内 2 处引用、`docs/38` 内 2 处交叉引用 - 文档内部无自引用编号；全仓已无其它 `docs/32`、`docs/33` 引用（全量搜索确认） 验证：`tools/check_authoritative_docs.py` → checked 41 documents, no number collision --- AGENTS.md | 4 ++-- ...-记忆投影链路实现说明.md => 37-记忆投影链路实现说明.md} | 0 ...与画像投影链路.md => 38-架构对齐-记忆与画像投影链路.md} | 7 ++++--- 3 files changed, 6 insertions(+), 5 deletions(-) rename docs/{32-记忆投影链路实现说明.md => 37-记忆投影链路实现说明.md} (100%) rename docs/{33-架构对齐-记忆与画像投影链路.md => 38-架构对齐-记忆与画像投影链路.md} (97%) diff --git a/AGENTS.md b/AGENTS.md index fcda30b..b006930 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -111,12 +111,12 @@ 大写 + 中文两个条件都不满足 ⇒ **事件任何消费者都领不到、永久滞留且不报错** （唯一键 `(event_uuid, target_store)` 对大小写无约束，MySQL 也不报错）。 取值口径以**主干既有读取方**为准（`projection_reconciliation_service.py`、 - `graph_projection_worker.py`），不是文档。详见 `docs/32-记忆投影链路实现说明.md`。 + `graph_projection_worker.py`），不是文档。详见 `docs/37-记忆投影链路实现说明.md`。 - ⚠️ **一张表只能有一个 ORM 类**：`app/model/` 下曾出现**两个类都映射 `profile_snapshots`** （`profile.py` 与 `risk_questionnaire.py`），各自单独导入都没事，**同时导入即抛** `InvalidRequestError: Table 'profile_snapshots' is already defined for this MetaData instance` —— Worker 既要重建画像又要处理投顾问卷，因此**真的被打挂过**（库里 `memory_sync_outbox` - 留下 `last_error='InvalidRequestError'` 的行）。2026-09-12 已修为 re-export，见 `docs/32` §6.2。 + 留下 `last_error='InvalidRequestError'` 的行）。2026-09-12 已修为 re-export，见 `docs/37` §6.2。 **新增模型前先搜一遍 `__tablename__` 有没有被占用。** - 测试基线：`2 failed, 1312 passed, 2 skipped`（2026-09-12 记忆投影链路落地后实测； 此前为 `3 failed, 1219 passed`——第 3 个失败 diff --git a/docs/32-记忆投影链路实现说明.md b/docs/37-记忆投影链路实现说明.md similarity index 100% rename from docs/32-记忆投影链路实现说明.md rename to docs/37-记忆投影链路实现说明.md diff --git a/docs/33-架构对齐-记忆与画像投影链路.md b/docs/38-架构对齐-记忆与画像投影链路.md similarity index 97% rename from docs/33-架构对齐-记忆与画像投影链路.md rename to docs/38-架构对齐-记忆与画像投影链路.md index 3ccaaa9..601a8a1 100644 --- a/docs/33-架构对齐-记忆与画像投影链路.md +++ b/docs/38-架构对齐-记忆与画像投影链路.md @@ -5,12 +5,13 @@ > **本文只做核对与建议，不改任何代码**。 > > **⚠️ 后续（2026-09-12）**：本文的结论**已落地实施**，实施说明与验证证据见 -> `docs/32-记忆投影链路实现说明.md`。本文保留作为**决策依据** —— 它记录了 +> `docs/37-记忆投影链路实现说明.md`。本文保留作为**决策依据** —— 它记录了 > "为什么选方案 A（复用主干图投影、不引入第二套）"、"为什么由生产端组装 `memory_sources`" -> 这两个决定的原始核对过程与判据，这部分推演在 `docs/32` 里没有重复。 +> 这两个决定的原始核对过程与判据，这部分推演在 `docs/37` 里没有重复。 > > **编号说明**：本文原为 `docs/29`；2026-09-12 让号给架构师线的 -> `docs/29-Agent组员登录接口使用说明.md`（该编号被后推的主干占用），改号为 `docs/33`。 +> `docs/29-Agent组员登录接口使用说明.md`，先改号 `docs/33`，后又因主干续占 32–36 +> 再让号至 `docs/38`（本文的实际编号以文件名与 `AGENTS.md` 为准）。 > > **核对时间**：2026-09-11 晚　**主干**：`qyqy_develop` @ `bbf623a`　**ZSY**：`cbcf7c7`