1445043649
d98498b705
alembic heads/history both empty, versions/ dir empty: 0001 can be the first revision with down_revision=None. alembic_version table will be auto-created on first upgrade head. doctor.py needs no new check. Also records T4 preparation grep findings on _ensure_admin_user current behavior (open issue #3 resolved). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
85 lines
7.0 KiB
Markdown
85 lines
7.0 KiB
Markdown
# Stage 0 进度面板
|
||
|
||
> **每完成 1 个 PR 后必更新**。本文是 Stage 0 唯一的"现在到哪了"权威来源——其它文件（plan、ADR、各 PR impl note）都是静态的，不反映执行进度。
|
||
>
|
||
> 上次更新：2026-05-12，PR3 merge + 7 项 LOCK 决策团队全 ✅ sign-off 后
|
||
|
||
## 一句话状态
|
||
|
||
PR1 + PR2 + PR3 已 merge + **live 验证通过**（RDS 上 11 张表 = DeerFlow 7 含 workspaces / workspace_memberships + LangGraph 4，partial unique on owner 索引也验过）+ **7 项 LOCK 决策团队 2026-05-12 全 ✅ sign-off**（id=String(36) / 命名=workspace_id / slug 规则 / memberships 复合 PK / JWT 一次到位 sub+wid+role+exp+iat+ver / default_workspace_id / FK CASCADE）+ **docs branch 已 push origin（38 commits, 2026-05-12 SSH-over-443）CI 用户已确认绿**。**下一个：PR4（注册流程改造 + JWT 加 wid+role + AuthMiddleware ContextVar 注入 + /auth/me + alembic 0001 加 default_workspace_id）**，plan 推荐 Inline 模式（auth 改造跨多 router 文件耦合紧）。
|
||
|
||
## 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](./pr1-postgres-setup.md) |
|
||
| **PR2** | ✅ merged | 8 (T2.1-T2.10) | merged into docs branch (`404135a1..1112a197`) | [pr2-postgres-default.md](./pr2-postgres-default.md) |
|
||
| **PR3** | ✅ merged | 7 (T3.1-T3.10) | merged into docs branch (`f63089ae..dda82640`) | [pr3-workspaces.md](./pr3-workspaces.md) |
|
||
| **PR4** | 🟡 pending | 0 | — | — |
|
||
| **PR5** | 🟡 pending | 0 | — | — |
|
||
| **PR6** | 🟡 pending | 0 | — | — |
|
||
| **PR7** | 🟡 pending | 0 | — | — |
|
||
| **PR8** | 🟡 pending | 0 | — | — |
|
||
|
||
**测试基线**：3134 passed + 25 skipped + 0 failed（PR3 末），PR2 末 3087，PR1 之前 3086 + 18 skipped。+47 PR3 新测试（16 ws_context + 23 ws_repo + 8 membership_repo）+ 2 PG-only skipped（T3.8）。期间 1 个偶发 flaky `tests/test_client_live.py::TestLiveStreaming::test_stream_ai_content_nonempty`（单跑 PASS，env 相关，与本 Stage 无关）。
|
||
|
||
## 用户必须跟进的事（live verification / 决策）
|
||
|
||
下列任务**只能用户做**，agent 没权限或没环境：
|
||
|
||
| 项 | 状态 | 谁做 | 怎么做 |
|
||
|---|---|---|---|
|
||
| 启动 Docker daemon 后实跑 PG smoke 测试（testcontainers 路径）| ⏳ | 用户 | `docker compose -f docker/docker-compose-dev.yaml up -d postgres && cd backend && PYTHONPATH=. uv run pytest -m postgres -v`。注：现在 RDS 已 live 验证（`make dev` 起 gateway + 9 张表已建），但 testcontainers ephemeral 路径仍未实跑过 |
|
||
| ~~远程 RDS 大版本对齐 testcontainers 镜像~~ | ✅ done 2026-05-11 | — | RDS = PostgreSQL 17.9（`make doctor` 确认），fixture 已调到 `postgres:17-alpine` |
|
||
| ~~Push docs branch 到 origin 跑 CI（含新 `backend-postgres-tests` workflow）~~ | ✅ done 2026-05-12 | — | 38 commits pushed（dce5e959..a592319e），SSH-over-443 绕代理；CI 用户确认绿 |
|
||
| ~~7 项 schema 不可逆 LOCK 决策团队 review~~ | ✅ done 2026-05-12 | — | 全 7 项 ✅ sign-off：id=String(36) / 命名=workspace_id+wid / slug `^[a-z0-9](-?[a-z0-9])*$` 3-32 / memberships 复合 PK / JWT 一次到位 / default_workspace_id / FK CASCADE。详见 [workspace-schema-design §5](../01-redesign/workspace-schema-design.zh-CN.md#5-不可逆决策清单)。PR4 可开工 |
|
||
| 远程 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 [关键开放问题](../../superpowers/plans/2026-05-10-stage-0-multi-tenant-foundation.md#关键开放问题执行-session-第一件事处理)：
|
||
|
||
1. ~~**PR4 起会真正用到 alembic**——首个 revision 之前要不要加 baseline？~~ **✅ T4.1 (2026-05-12) 已验证**：`versions/` 空 + `alembic heads`/`history` 都空输出 → 0001 直接当首个 revision、`down_revision = None`，**不需要 baseline**。`alembic_version` 表首次 `upgrade head` 时自动建；现有 create_all() 已建好的 schema 不冲突（0001 只 ADD COLUMN）。`doctor.py` 不需要加自动检测
|
||
2. ~~**`_ensure_admin_user(app)` 现状的孤立 thread 迁移逻辑**~~ **✅ T4 准备阶段 (2026-05-12) 已 grep**：`app.py:52` 当前只做两件事——(a) admin_count==0 时仅日志提示去 `/setup`，(b) admin 已存在时跑 LangGraph store 孤立 thread 迁移。**不自建 admin**。所以 T4.13 真实任务范围 = "admin 已存在但无 workspace"的 idempotent backfill 分支（plan 顶部"风险与缓解"段写的才对，task 措辞"建完 admin 顺带建"是误导，实际归 T4.8）
|
||
3. **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 那刻）必更新本文件：
|
||
|
||
1. 把 PR 的状态行从 🟡 pending 改 ✅ merged
|
||
2. 填 commits 数 + commit hash 范围 + impl note 链接
|
||
3. 把 PR 跳过/推迟的子任务移到"跳过 / 推迟的子任务"表
|
||
4. 把 PR 引入的开放问题加到"即将遇到的开放问题"
|
||
5. 更新"上次更新"时间 + "一句话状态"
|
||
|
||
**进入新 session 第一件事**：读本文件 + 读"即将遇到的开放问题"段 + 验证文件提到的代码锚点是否还在（防 plan 与代码漂移）。
|
||
|
||
## 阅读路径
|
||
|
||
- **新加入项目想立即了解状态** → 本文件
|
||
- **写代码前要看 plan** → [Stage 0 master plan](../../superpowers/plans/2026-05-10-stage-0-multi-tenant-foundation.md)
|
||
- **理解某个具体 PR 怎么落的** → 03-impl/prN-*.md
|
||
- **需要 Stage 0 之外的全局理解** → [README.zh-CN.md](../README.zh-CN.md)（多租户改造汇总索引）
|