Files

T

1445043649 ad22242ecc docs(impl): add Stage 0 progress dashboard (STATUS.md)

新增 docs/multi-tenant-redesign/03-impl/STATUS.md 作为 Stage 0 唯一的"现在
到哪了"权威来源：

  - 8 PR 状态表（PR0-PR2 ✅ merged，PR3-PR8 🟡 pending）
  - 用户必须跟进的事（live PG 实跑 / RDS 大版本对齐 / push origin / LOCK
    review / 远程 RDS 密码轮换）
  - 跳过/推迟的子任务（T1.10 docker-pending、T2.7 acked、T2.8 optional
    skipped、T2.9 backend/CLAUDE.md 待补）
  - 即将遇到的开放问题（PR4 alembic baseline / _ensure_admin_user 现状 /
    PG 大版本）
  - PR3 模式选择 trade-off（Inline vs Subagent-Driven）
  - 维护规则：完成 PR 后必更新；新 session 首先读本文件

填补 plan/impl notes 之外的空白：plan 是静态的，impl notes 是 per-PR
快照；STATUS 是跨 PR 的执行状态视图。

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

2026-05-11 16:44:09 +08:00

5.5 KiB

Raw Blame History

Stage 0 进度面板

每完成 1 个 PR 后必更新。本文是 Stage 0 唯一的"现在到哪了"权威来源——其它文件（plan、ADR、各 PR impl note）都是静态的，不反映执行进度。

上次更新：2026-05-11，PR2 merge 进 docs branch 后

一句话状态

PR1 + PR2 已 merge 进 docs/multi-tenant-redesign（领先 origin 25 commits）。下一个：PR3（workspaces + workspace_memberships 表 + 仓储），plan 推荐 Subagent-Driven 模式。

8 PR 状态表

PR	状态	Commits	分支 / 落点	impl note
PR0	✅ merged	1	`a74b88a4` on docs branch	—
PR1	✅ merged	8 (T1.1-T1.10)	merged into docs branch (`fab85b14..85a14f4c`)	pr1-postgres-setup.md
PR2	✅ merged	8 (T2.1-T2.10)	merged into docs branch (`404135a1..1112a197`)	pr2-postgres-default.md
PR3	🟡 pending	0	（会起 `feat/stage-0-pr3-workspaces`）	—
PR4	🟡 pending	0	—	—
PR5	🟡 pending	0	—	—
PR6	🟡 pending	0	—	—
PR7	🟡 pending	0	—	—
PR8	🟡 pending	0	—	—

测试基线：3087 passed + 23 skipped + 0 failed（PR2 末测试），PR1 之前是 3086 passed + 18 skipped。期间 1 个偶发 flaky tests/test_client_live.py::TestLiveStreaming::test_stream_ai_content_nonempty（单跑 PASS，env 相关，与本 Stage 无关）。

用户必须跟进的事（live verification / 决策）

下列任务只能用户做，agent 没权限或没环境：

项	状态	谁做	怎么做
启动 Docker daemon 后实跑 PG smoke 测试	⏳	用户	`docker compose -f docker/docker-compose-dev.yaml up -d postgres && cd backend && PYTHONPATH=. uv run pytest -m postgres -v`
远程 RDS 大版本对齐 testcontainers 镜像	⏳	用户	`psql -h pgm-bp133hb7gna78yp7vo.pg.rds.aliyuncs.com -U wanggx -d postgres -c 'SELECT version();'`；如非 PG 16 调整 `backend/tests/fixtures/postgres.py` 里的 image tag
Push docs branch 到 origin 跑 CI（含新 `backend-postgres-tests` workflow）	⏳	用户	`git push origin docs/multi-tenant-redesign` 后看 GitHub Actions
7 项 schema 不可逆 LOCK 决策团队 review	⏳	用户 + 团队	见 workspace-schema-design §5；PR3 合入前必须签字
远程 RDS 密码轮换	⏳	用户	之前在聊天里给过明文密码——建议事后轮换

跳过 / 推迟的子任务（agent 当时主动跳的，需用户认可或后续补）

来源	跳过项	原因	建议
PR1 T1.10	本地实跑 PG smoke 测试	docker daemon 未起	用户跟进表第 1 项
PR2 T2.7	写 setup_wizard 推荐 PG 的代码	已在 PR1 T1.8 完整实现（empty commit `745a33e0` 仅做 task tracking）	无需跟进
PR2 T2.8	sqlite→pg 数据迁移工具 (`scripts/migrate_sqlite_to_postgres.py`)	plan 标 optional + Stage 0 没生产数据	如果出现"dev 用 SQLite 跑过一段、想保留数据迁 PG"的需求再补
PR2 T2.9	`backend/CLAUDE.md` Database 段更新	README 已覆盖 80% 价值	写 PR3 时顺手补一句（agent 自己能做，不阻塞）

即将遇到的开放问题（plan 末尾列的，下个 session 处理）

详见 plan 关键开放问题：

PR4 起会真正用到 alembic——首个 revision 之前要不要加 baseline？plan agent 建议 0001 直接当首个 revision，down_revision = None。验证：跑 cd backend && PYTHONPATH=. uv run alembic current 看默认行为
_ensure_admin_user(app) 现状的孤立 thread 迁移逻辑——PR4 / PR5 假设它能扩；先 grep app.py 看现状
PG 大版本对齐（同上"用户必须跟进"#2）

下一步建议

按 plan 推荐的 PR3 = Subagent-Driven 模式。如果继续 Inline（像 PR1/PR2 那样）也可以，trade-off：

	Inline（PR1/PR2 模式）	Subagent-Driven
速度	主 agent 推全流	主 agent 派单到 subagent，等结果
上下文消耗	多	少（任务上下文不污染主 agent）
调试	错了主 agent 直接看	错了要找 subagent log
适用	PR1/PR2 这种"一个 PR 内有强耦合 reasoning"的	PR3 这种"10 个机械任务，每个独立"的

维护规则

完成一个 PR 后（merge 进 docs branch 那刻）必更新本文件：

把 PR 的状态行从 🟡 pending 改 ✅ merged
填 commits 数 + commit hash 范围 + impl note 链接
把 PR 跳过/推迟的子任务移到"跳过 / 推迟的子任务"表
把 PR 引入的开放问题加到"即将遇到的开放问题"
更新"上次更新"时间 + "一句话状态"

进入新 session 第一件事：读本文件 + 读"即将遇到的开放问题"段 + 验证文件提到的代码锚点是否还在（防 plan 与代码漂移）。

阅读路径

新加入项目想立即了解状态 → 本文件
写代码前要看 plan → Stage 0 master plan
理解某个具体 PR 怎么落的 → 03-impl/prN-*.md
需要 Stage 0 之外的全局理解 → README.zh-CN.md（多租户改造汇总索引）

5.5 KiB Raw Blame History Unescape Escape