docs: add current handoff status

README.md

@@ -6,11 +6,47 @@
 
 ## 当前状态
 
-更新时间：2026-07-01
+更新时间：2026-07-02
+
+## 接管快照
+
+截至 2026-07-02，当前 `main` 已同步到 Gitea，最新前端交付提交为 `f54421f test: align Taro visual guardrails with legacy UI`，其前一个核心实现提交为 `aa71251 fix: align Taro H5 with legacy question bank UI`。另一台工作机接管时，优先从 Gitea 拉取 `main`，不要从服务器的构建产物反向覆盖源码。
+
+本轮已完成的关键变化：
+
+- 学生 H5 已按旧题库主视觉重做：浅灰网格背景、旧蓝色主色、PC 侧边栏、移动端底部导航、蓝色学习 banner、白色数据卡、彩色功能模块和紧凑列表。
+- 租户后台和平台后台已按旧后台工作台风格收敛：白/灰高密度界面、侧边栏/移动导航、深色激活态、紧凑表格/表单/行布局。
+- 受保护页面已补路由守卫：Auth/角色校验期间不渲染业务内容；静态 H5 可以加载入口壳，但不应在未鉴权时暴露可用业务数据。
+- 三端 H5 首屏入口按构建目标区分：`student`、`tenant-admin`、`platform-admin`。
+- 视觉守卫已从通用圆角/渐变规则调整为旧题库 UI 规则，防止后续改回营销页式大卡片风格。
+
+本地已通过的验证命令：
+
+```bash
+npm --workspace @tiku-saas/taro run check
+node scripts/taro-route-contract-test.js
+npm run guard:taro:visual
+node scripts/taro-visual-guardrails-test.js
+npm run build:taro:h5:student
+npm run build:taro:h5:tenant
+npm run build:taro:h5:platform
+npm run smoke:taro:h5
+npm run smoke:taro:h5:interaction
+node scripts/taro-h5-release-guardrails-test.js
+```
+
+云服务器当前接管点：
+
+- 服务器仓库：`/opt/tiku-saas/repo`
+- H5 发布目录：`/srv/tiku-saas/www/student`、`/srv/tiku-saas/www/tenant-admin`、`/srv/tiku-saas/www/platform-admin`
+- 发布脚本：`/opt/tiku-saas/bin/deploy.sh`
+- 线上 Supabase、自研 API、Nginx、runtime-config 已能基本联通；`https://api.tjszsb.com/api/tenant/resolve?host=app.tjszsb.com` 已返回 `master` 租户。
+- Gitea SSH 端口是 `2222`，服务器 `deploy` 用户拉取应使用 `ssh://git@git.gongxue100.com:2222/chenhaogxjy/tiku-supabase.git` 或在 SSH config 中显式配置 `Port 2222`。
+- 2026-07-02 服务器手动执行 `sudo -u deploy npm run build:taro:h5:student` 时出现 Taro 构建长时间无输出、CPU 持续接近满载、`dist/h5-student` 未更新的情况。接管后建议先中止残留构建进程，清理目标目录，再用 `CI=1 NODE_OPTIONS="--max-old-space-size=4096"` 重新构建三端，详见 `scripts/deploy/README.md` 的“服务器接管和故障恢复”。
 
 ## 最新交付快照
 
-截至 2026-07-01，当前 `main` 已推送到 Gitea，可进入云服务器部署和生产测试阶段。这里的“生产测试”指在真实云服务器、真实域名、真实对象存储和真实 provider 配置下做灰度/演练验证；正式对 C 端或合作商放量前，仍必须通过本文的生产上线证据门禁。
+截至 2026-07-02，当前 `main` 已推送到 Gitea，可进入云服务器部署和生产测试阶段。这里的“生产测试”指在真实云服务器、真实域名、真实对象存储和真实 provider 配置下做灰度/演练验证；正式对 C 端或合作商放量前，仍必须通过本文的生产上线证据门禁。
 
 - 后端核心业务已经覆盖旧题库主链路：刷题、背单词、知识手册、分数线、错题本、收藏夹、资料下载、题目视频、会员/订单/优惠券/激活码、个人中心、站内通知、勋章、租户后台、平台 SaaS 管理、公共题库授权/采纳/同步、CRM/销售/代理/分佣、财务对账和 worker 任务。
 - 多租户安全底座已经具备商用联调条件：平台/租户/学生三类身份边界、Supabase Auth JWT、迁移期 `tk_` session、RLS 测试、租户角色模板、成员权限、班级/教师/学生范围、字段脱敏、审计日志、私有资源短签名、导入/导出 job 审计均已落地。