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>
This commit is contained in:
@@ -26,7 +26,8 @@ docs/multi-tenant-redesign/
|
||||
│ ├── adr-spike-langgraph-postgres spike:LangGraph PG 注入能力
|
||||
│ ├── adr-vs-code-audit 审计:ADR vs 现状代码
|
||||
│ ├── multi-tenant-phase-0-plan Phase-0 时间盒 / 产出物
|
||||
│ └── workspace-schema-design **Stage 0 schema 锁定版**(不可逆决策点)
|
||||
│ ├── workspace-schema-design **Stage 0 schema 锁定版**(不可逆决策点)
|
||||
│ └── database-schema-as-built **数据库设计落地版**(对照实现代码的事实参考)
|
||||
└── 02-rollout/ 落地路线 + 集成轨道
|
||||
├── phased-rollout-by-scale **Stage 0–4 主线** 路线图
|
||||
├── stage-0-code-map Stage 0 现状代码地图(行号锚点)
|
||||
@@ -49,6 +50,7 @@ docs/multi-tenant-redesign/
|
||||
| spike | [LangGraph PG 注入](./01-redesign/adr-spike-langgraph-postgres.zh-CN.md) | 已结论 | 2026-05-09 | `langgraph-checkpoint-postgres==3.0.5` **不存在 connection_factory**;改走应用层强校验 + 自有表 RLS 的两层模型 |
|
||||
| 审计 | [ADR vs 代码](./01-redesign/adr-vs-code-audit.zh-CN.md) | 已结论 | 2026-05-09 | 代码库 0 处 `tenant`;Better Auth 不存在;ObjectStorage / KMS / Postgres 测试夹具全缺;底座先行 §3.5 |
|
||||
| 锁定 | [workspace-schema-design](./01-redesign/workspace-schema-design.zh-CN.md) | **Stage 0 锁定版** | 2026-05-10 | `workspace_id` 命名 + 7 项不可逆决策;Stage 0 PR1 动手前必读 |
|
||||
| 参考 | [database-schema-as-built](./01-redesign/database-schema-as-built.zh-CN.md) | **落地版(as-built)** | 2026-06-27 | 对照实现代码的 10 张表全字段 / 外键 / 索引 / 迁移参考;与锁定版冲突以本文为准 |
|
||||
| 计划 | [phase-0-plan](./01-redesign/multi-tenant-phase-0-plan.zh-CN.md) | 计划 | 2026-05-09 | Phase-0 时间盒 3 周;含底座先行(§3.5) |
|
||||
| 路线 | [phased-rollout-by-scale](./02-rollout/phased-rollout-by-scale.zh-CN.md) | **当前主线路线图** | 2026-05-09 | Stage 0–4 + 触发/退出/时间盒/Go-No-Go |
|
||||
| 锚点 | [stage-0-code-map](./02-rollout/stage-0-code-map.zh-CN.md) | Stage 0 用 | 2026-05-09 | 当前代码文件:行号锚点 + Stage 0 改动落点 |
|
||||
|
||||
Reference in New Issue
Block a user