feat: establish production SaaS foundation

docs/refactor/README.md

@@ -1,5 +1,12 @@
 # SaaS 重构工作区
 
+当前接管先读：
+
+- `production-foundation-baseline-20260712.md`：后端/API 冻结结论、前端启动边界、生产硬阻断和正式上线顺序。
+- `clean-room-migration-audit-20260712.md`：官方 Supabase PG15 空库 78 个迁移、扩展/ACL、运行角色、RLS、约束和幂等审计证据。
+- `taro-h5-browser-qa-20260712.md`：学生端、租户后台、平台后台桌面/移动浏览器和主交互验收记录。
+- `taro-supply-chain-baseline-20260712.md`：Taro 4.2.0 安全 override、H5 runtime patch、干净安装与构建工具链风险边界。
+
 这个目录记录从 PocketBase 单体项目迁移到 Supabase/PostgreSQL + 新 API + Taro 学生端的重构过程。
 
 当前阶段目标：
@@ -18,7 +25,7 @@
 - `scripts/import-pocketbase`：PocketBase schema/数据导入工具。
 - `docker-compose.api.yml`、`docker-compose.api.benchmark.yml`、`apps/api/Dockerfile`：本地 Docker API 和受限资源压测入口。
 - `scripts/deploy/README.md`：云服务器部署 runbook，覆盖 `tjszsb.com` 六域名规划、服务器目录、Gitea 安全部署、Nginx、systemd 和更新脚本。
-- `scripts/deploy/bin/deploy.sh`：服务器端发布脚本模板，负责拉取 Gitea、构建 API/worker/Taro H5、发布静态文件和重启服务；真实密钥只从 `/etc/tiku-saas/*.env` 读取。
+- 根目录 `deploy.sh`：推荐的 release/symlink 原子发布入口，包含严格 runtime config、readiness、安全、H5 smoke、manifest 和真实 production launch gate；`scripts/deploy/bin/deploy.sh` 仅保留为旧服务器兼容入口并同步执行同类门禁。真实密钥只从服务器受控 env 读取。
 - `docs/refactor/architecture.md`：新重构目录边界和工程规范。
 - `docs/refactor/ai-development-guardrails.md`：后续 AI/开发者必须遵守的 Supabase-first 架构和安全守则。
 - `docs/refactor/content-import-contract.md`：题目、单词、知识手册导入契约，明确后端校验、旧格式转换和前端职责。
@@ -32,10 +39,11 @@
 - `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 阶梯并发矩阵、Docker 受限资源预演和报告归档方式。
+- `docs/refactor/tenant-student-capacity-runbook.md`：单租户最多 10 万学生的安全合成夹具、cursor/搜索 SQL 基准、EXPLAIN 证据和专用命名空间清理流程。
 - `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`。
+- `docs/refactor/production-launch-evidence.template.json`：生产上线证据模板；真实 evidence 与 `launch-artifacts/` 作为完整 bundle 放在服务器受控目录，不进入 Git，再运行 `npm run launch:gate -- --evidence <absolute-path>`。
 
 下一步优先级：