gongxue-base/docs/refactor

SaaS 重构工作区

这个目录记录从 PocketBase 单体项目迁移到 Supabase/PostgreSQL + 新 API + Taro 学生端的重构过程。

当前第一阶段目标：

• 本地 Supabase 能启动并创建多租户 PostgreSQL schema。
• 新 API 能连接数据库并解析租户。
• PocketBase 的 docs/pb_schema.json 能被解析，后续真实数据导出后可导入到新库。
• 先保留旧 React Web 项目，逐步把学生端和后台接到新 API。

关键文件：

• supabase/config.toml：本地 Supabase 配置。
• supabase/migrations/202606210001_core_multitenant_schema.sql：第一版商用级多租户 schema。
• apps/api：新业务 API 服务，内部按 src/core 和 src/features 分层。
• packages/config、packages/db、packages/domain：新系统共享基础包。
• scripts/import-pocketbase：PocketBase schema/数据导入工具。
• docker-compose.api.yml、apps/api/Dockerfile：本地 Docker API 运行入口。
• docs/refactor/architecture.md：新重构目录边界和工程规范。
• docs/refactor/content-import-contract.md：题目、单词、知识手册导入契约，明确后端校验、旧格式转换和前端职责。
• docs/refactor/next-development-todo.md：后端剩余缺口、Taro 前端接入顺序、上云测试前待办。
• docs/refactor/backend-handoff-roadmap.md：进入 Taro 前端前的后端进度同步、缺口清单和接入路线图。

下一步优先级：

1. 先按 docs/refactor/backend-handoff-roadmap.md 的 P0 清单补齐上云测试和 Taro 主链路所需能力。
2. 导出 PocketBase 真实数据到 pb_export/*.json，执行 npm run pb:import:json 和 npm run pb:import:validate。
3. 新建 apps/taro，优先接租户解析、首页、题库练习、背单词、知识手册、个人中心。
4. 为对象存储、分数线、视频、Excel/CSV 补齐 provider/导入能力，并复用 content_import_jobs 管线。
5. 接真实短信、微信/QQ 登录、微信支付/支付宝和 CRM worker，进入商用验收。