docs: record backend capacity review

This commit is contained in:
Codex
2026-07-01 03:01:02 +08:00
parent ad1c69037b
commit 49358aae6b
8 changed files with 124 additions and 22 deletions

View File

@@ -2,12 +2,12 @@
这个目录记录从 PocketBase 单体项目迁移到 Supabase/PostgreSQL + 新 API + Taro 学生端的重构过程。
当前第一阶段目标:
当前阶段目标:
- 本地 Supabase 能启动并创建多租户 PostgreSQL schema
- 新 API 能连接数据库并解析租户
- PocketBase 的 `docs/pb_schema.json` 能被解析,后续真实数据导出后可导入到新库
- 先保留旧 React Web 项目,逐步把学生端和后台接到新 API
- Supabase/PostgreSQL 多租户后端继续支撑 Taro H5/小程序、租户后台和平台后台全面联调
- 使用真实 PocketBase 导出数据反复演练导入、抽样和容量压测
- 上云前补齐生产 provider、对象存储安全、Auth/RLS、备份恢复、日志告警和上线证据门禁
- 旧 PocketBase/React 项目只作为功能、样式和迁移参考,不再作为新项目源码入口
关键文件:
@@ -30,13 +30,15 @@
- `docs/refactor/taro-h5-deployment.md`Taro H5 三域名部署、运行时配置、Nginx、CSP、缓存和 CORS 边界。
- `docs/refactor/postgresql-4c16g-tuning.md`4 核 16G 自托管 PostgreSQL 起步调参、观察 SQL 和回滚方式。
- `docs/refactor/performance-benchmark-runbook.md`:本地/云端 API 压测、4 核 16G 阶梯并发矩阵和报告归档方式。
- `docs/refactor/performance-benchmark-summary-20260630.md`:真实迁移数据压测脱敏摘要。
- `docs/refactor/backend-open-items-and-capacity-20260701.md`:后端剩余功能、已定稿产品口径和最新在线容量估算。
- `docs/refactor/multitenant-auth-security-contract.md`:多租户隔离、鉴权、权限和资源安全红线。
- `docs/refactor/production-launch-evidence.template.json`:生产上线证据模板;真实证据填入本地 `production-launch-evidence.json` 后运行 `npm run launch:gate`
下一步优先级:
1. `docs/refactor/multitenant-auth-security-contract.md` 的 P0 清单补齐鉴权、生产配置和租户隔离测试,并在上云前运行 `npm run readiness:production` / `npm run readiness:production:db`
2. 新建 `apps/taro``docs/refactor/taro-frontend-integration.md` 优先接租户解析、首页、题库练习、背单词、知识手册、个人中心
3. 继续`docs/refactor/pocketbase-real-data-migration-runbook.md` 处理真实旧数据人工复核项;当前真实导入已能生成新架构题库入口、分类、合集和练习蓝图
4. 上云前按 `docs/refactor/postgresql-4c16g-tuning.md` 准备 4 核 16G PostgreSQL 起步参数,再按 `docs/refactor/performance-benchmark-runbook.md` 跑 smoke、30/50 并发和少量写入压测
5. 接真实短信、微信/QQ 登录、微信支付/支付宝,继续增强 CRM worker 和其它异步任务,进入商用验收
1. 上云前`docs/refactor/multitenant-auth-security-contract.md``docs/refactor/production-launch-evidence.template.json` 执行生产配置、Auth/JWKS、RLS、备份恢复和上线证据门禁
2. 继续`docs/refactor/pocketbase-real-data-migration-runbook.md` 处理真实旧数据人工复核项;当前重点是已支付缺用户订单和缺所属手册章节
3. 在目标 4 核 16G 云服务器`docs/refactor/postgresql-4c16g-tuning.md` 调参,再按 `docs/refactor/performance-benchmark-runbook.md` 复跑只读和混合读写压测
4. 接真实短信、微信/QQ 登录、微信支付/支付宝、对象存储 AV/内容安全、CDN 防盗链和支付账单抽样验收
5. Taro 继续补小程序真机、公式图片混排、状态管理、包体优化、前端端到端测试和租户/平台后台体验细节。学生头像上传不做,排行榜默认不启用