ZY-Agent

Files

T

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

adr-001-data-isolation.zh-CN.md

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

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

adr-002-sandbox-isolation.zh-CN.md

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

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

adr-003-llm-key-billing.zh-CN.md

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

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

adr-004-tenant-rbac.zh-CN.md

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