ZY-Agent

xuan/ZY-Agent

Fork 0

Commit Graph

Author	SHA1	Message	Date
1445043649	45efba50e4	docs(db): 补充数据库设计落地版（as-built）并登记进 README 新增 docs/multi-tenant-redesign/01-redesign/database-schema-as-built.zh-CN.md：对照实现代码（persistence/*/model.py + base.py/engine.py + alembic 0001-0003）生成的事实参考，补齐之前只有「锁定版」（动手前决策）而缺失的落地 schema 文档。涵盖： - 持久化层总览：memory/sqlite/postgres 三后端、create_all vs Alembic、 Postgres 库自愈、SQLite WAL、JSON ensure_ascii=False、partial index 双 where 兼容 - LangGraph checkpointer/store 表不归 ORM 管的说明 - ER 图（mermaid）+ 10 张表全字段参考（users/workspaces/workspace_memberships/ threads_meta/runs/run_events/feedback/service_accounts/api_keys/external_users） - 外键与删除策略矩阵（CASCADE/RESTRICT/SET NULL） - 迁移历史 0001-0003（含 0002→0003 两段式上线：可空列→回填→锁 NOT NULL） - 与锁定版的差异（run_events 已确认为 DB 表、runs token 分项列、status 状态机等） README.zh-CN.md 的「文档总图」与「状态表」登记该文档，并注明与锁定版冲突时以落地版为准。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	2026-06-27 22:55:01 +08:00
1445043649	89fe54cc07	docs(multi-tenant): 加入汇总索引、跨文档一致性修订、Postgres 切换前移到 Stage 0 * 新增 README.zh-CN.md 汇总索引：ADR 状态表 + Stage 0-4 业务目标 / 技术路径 / 验证方式 + Stage↔ADR 对照矩阵 + 不可逆决策一览 + 用语映射 + FAQ + 阅读路径 * 新增 workspace-schema-design.zh-CN.md（Stage 0 schema 锁定版）一并入库 * 7 份 ADR 顶部加"代码命名"映射行（tenant_id ↔ workspace_id） * ADR-002 §1 加分期落地提示，明确 K8s 推迟到 Stage 3 * ADR-005 §5"第 1/2 阶段"补出与 rollout Stage 2/3 的映射 * ADR-007 §4 加 /api/v1/ 反向链接；§8 加 tid → wid 字段名映射 * headless-api §0/§7 把"SaaS + on-prem 双主线"改为"SaaS 主线、schema 兼容 on-prem" * phased-rollout 去除重复的"Go/No-Go 进入 Stage 2"段 Postgres 切换从 Stage 1 提前到 Stage 0：Stage 0 已要 ALTER 4 张表加 workspace_id，先 SQLite 再 PG 是纯返工；Stage 0 没有生产数据，迁移阻力最小。同步调整 phased-rollout / headless-api / phase-0-plan / workspace-schema-design / README 中的时间盒（Stage 0: 3-4→4-5 周；Stage 1: 10-15→8-13 周）、不可逆决策清单、PR 顺序、轨道前置依赖。 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-05-10 21:39:58 +08:00

Author

SHA1

Message

Date

1445043649

45efba50e4

docs(db): 补充数据库设计落地版（as-built）并登记进 README

新增 docs/multi-tenant-redesign/01-redesign/database-schema-as-built.zh-CN.md：
对照实现代码（persistence/*/model.py + base.py/engine.py + alembic 0001-0003）
生成的事实参考，补齐之前只有「锁定版」（动手前决策）而缺失的落地 schema 文档。

涵盖：
- 持久化层总览：memory/sqlite/postgres 三后端、create_all vs Alembic、
  Postgres 库自愈、SQLite WAL、JSON ensure_ascii=False、partial index 双 where 兼容
- LangGraph checkpointer/store 表不归 ORM 管的说明
- ER 图（mermaid）+ 10 张表全字段参考（users/workspaces/workspace_memberships/
  threads_meta/runs/run_events/feedback/service_accounts/api_keys/external_users）
- 外键与删除策略矩阵（CASCADE/RESTRICT/SET NULL）
- 迁移历史 0001-0003（含 0002→0003 两段式上线：可空列→回填→锁 NOT NULL）
- 与锁定版的差异（run_events 已确认为 DB 表、runs token 分项列、status 状态机等）

README.zh-CN.md 的「文档总图」与「状态表」登记该文档，并注明
与锁定版冲突时以落地版为准。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-27 22:55:01 +08:00

1445043649

89fe54cc07

docs(multi-tenant): 加入汇总索引、跨文档一致性修订、Postgres 切换前移到 Stage 0

* 新增 README.zh-CN.md 汇总索引：ADR 状态表 + Stage 0-4 业务目标 / 技术路径 /
  验证方式 + Stage↔ADR 对照矩阵 + 不可逆决策一览 + 用语映射 + FAQ + 阅读路径
* 新增 workspace-schema-design.zh-CN.md（Stage 0 schema 锁定版）一并入库
* 7 份 ADR 顶部加"代码命名"映射行（tenant_id ↔ workspace_id）
* ADR-002 §1 加分期落地提示，明确 K8s 推迟到 Stage 3
* ADR-005 §5"第 1/2 阶段"补出与 rollout Stage 2/3 的映射
* ADR-007 §4 加 /api/v1/ 反向链接；§8 加 tid → wid 字段名映射
* headless-api §0/§7 把"SaaS + on-prem 双主线"改为"SaaS 主线、schema 兼容 on-prem"
* phased-rollout 去除重复的"Go/No-Go 进入 Stage 2"段

Postgres 切换从 Stage 1 提前到 Stage 0：Stage 0 已要 ALTER 4 张表加
workspace_id，先 SQLite 再 PG 是纯返工；Stage 0 没有生产数据，迁移阻力最小。
同步调整 phased-rollout / headless-api / phase-0-plan / workspace-schema-design /
README 中的时间盒（Stage 0: 3-4→4-5 周；Stage 1: 10-15→8-13 周）、不可逆决策
清单、PR 顺序、轨道前置依赖。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-10 21:39:58 +08:00

2 Commits