feat: complete tenant learning and admin experience

docs/legacy-feature-gap.md

@@ -0,0 +1,63 @@
+# 旧版页面与 .NET 接口覆盖矩阵
+
+更新日期：2026-08-04。接口事实来源为 `tiku-backend.net` 当前 `/openapi/v1.json`；旧版页面只用于确认业务内容和信息层级，不复用 PocketBase、`MockBackend` 或浏览器伪造结果。
+
+状态说明：
+
+- `ready`：第一批已接入可用的 .NET 契约。
+- `partial`：存在可复用基础契约，但缺少完整业务流程或公开发起配置。
+- `missing`：当前 OpenAPI 没有满足该学生功能的契约；仅保留前端类型位置，生产入口隐藏。
+- `deferred`：后端已有契约，但不在第一批核心学习闭环范围内。
+
+## 第一批闭环
+
+| 旧版能力 | SaaS 路由/位置 | 状态 | 当前 .NET 契约 | 前端模块 |
+| --- | --- | --- | --- | --- |
+| 密码/短信登录 | `/login` | ready | `/api/tenant/auth/browser/login/password`、`sms/send`、`login/sms` | `studentAuthApi` |
+| 找回密码 | `/reset-password` | ready | `/api/tenant/auth/browser/password/reset/*` | `studentAuthApi` |
+| 地区选择 | `/select-region` | ready | `/api/public/catalog/regions`、`PATCH /api/student/profile/me` | `catalogApi`、`profileApi` |
+| 学习首页 | `/` | ready | Profile、learning stats/trend、exam countdowns、banners、announcements | `DashboardPage` |
+| 科目/章节 | `/subjects`、`/subject/:subjectId` | ready | subjects、categories、practice-blueprints | `catalogApi` |
+| 刷题与恢复 | `/quiz` | ready | practice-sessions create/detail、answers、submit | `learningApi` |
+| 报告 | `/quiz/report/:sessionId` | ready | practice-sessions/report，含 `PendingReview` | `PracticeReportPage` |
+| 错题/收藏 | `/collections` | ready | wrong-questions、favorites/questions | `CollectionsPage` |
+| 公开品牌首页 | `/`（未登录） | ready | `/api/public/runtime/bootstrap`、学生资产 preview | `PublicLandingPage`、`RuntimeProvider` |
+| 主题建站/发布 | `/manage/site` | ready | frontend-config draft/publish、`configVersion` | `site-builder/*` |
+| OSS 主题资产 | 建站资产库 | ready | uploads/sign → OSS PUT → uploads/confirm → student asset preview | `assetApi`、`useThemeAssets` |
+| 词汇单元与词表 | `/vocabulary/*` | ready | public vocabulary units/words | `VocabularyPage`、`VocabularyUnitPage` |
+| 知识手册阅读 | `/handbook/*` | ready | public handbook subjects/chapters/entries | `student/pages/Handbook*` |
+| 院校分数线 | `/scoreline` | ready | public scoreline records/years | `ScorelinePage` |
+| 个人中心基础能力 | `/profile` | ready | student profile | `ProfilePage` |
+
+## 缺失与部分支持
+
+| 旧版能力 | 目标路由 | 状态 | 缺少的后端契约 | 前端预留 |
+| --- | --- | --- | --- | --- |
+| 择校报告/志愿规划 | `/school-planning` | missing | 报告输入校验、生成、版本、查询和导出契约；公共 schools 目录不足以生成报告 | `SchoolPlanningClient`、feature `school-planning` |
+| QQ OAuth | `/login` | missing | 浏览器授权发起、state/回调和租户公开 AppId 配置 | `QqOAuthClient`；不渲染按钮 |
+| 学生自助激活码核销 | `/activation-code` | missing | 当前 activation/commerce 契约不能证明等价于旧版学生自助权益核销流程 | `StudentActivationCodeClient`、feature `activation-code` |
+| 旧版 C/C++ 代码运行器 | `/code-runner` 或题目内 | missing | 沙箱执行、资源限制、语言版本、结果和审计契约 | `CodeRunnerClient`、feature `code-runner` |
+| 微信网页登录 | `/login` | partial | 已有回调处理 `/api/tenant/auth/browser/oauth/wechat`，但 Runtime 缺少公开授权发起参数/URL | 仅记录 `loginMethods`，暂不显示不可完成入口 |
+| 独立模拟考试/作业 | 待定 | partial | practice session 可承载答题和判分，但缺考试日程、限时、作业下发、班级分配、交卷策略和成绩册流程 | 后续在 learning 领域扩展，不伪装成普通练习 |
+| 主题资产专用权限 | 建站资产库 | partial | 当前资产控制器复用 `tenant:question-bank:manage`，没有更细的 `tenant:theme-assets:manage` | 权限不足时只读保留资产，不回退 Data URL |
+
+## 已有接口但延期接入
+
+| 能力 | 旧版路由/入口 | 状态 | 已确认 .NET 契约族 | 计划前端领域 |
+| --- | --- | --- | --- | --- |
+| 词汇学习进度/收藏/复习 | `/vocabulary/*` | deferred | student vocabulary progress/review/favorites | `student/vocabulary` |
+| 视频精讲 | 题目解析/视频中心 | deferred | student videos search/play/progress、question videos | `student/videos` |
+| 分数线动态图表与字段筛选 | `/scoreline` | deferred | public scoreline fields/trend | `student/scoreline` |
+| 个人中心完整能力 | `/profile` | deferred | score-events、membership、设置等 | `student/profile` |
+| 排行榜 | 首页/个人中心 | deferred | `/api/student/learning/leaderboard` | `student/leaderboard` |
+| 积分/兑换 | 个人中心/商城 | deferred | `/api/student/points/*` | `student/points` |
+| 商城、订单与支付 | `/store` | deferred | student commerce orders/coupons；支付能力需按实际支付渠道复核 | `student/commerce` |
+| 优惠券 | 商城 | deferred | student commerce coupons claim/list/check | `student/commerce` |
+| 推荐增长 | 邀请入口 | deferred | `/api/student/referral/*` | `student/referral` |
+
+## 前端约束
+
+- 正式路由和导航必须同时满足：前端注册项为 `ready`、Runtime `enabledFeatures` 已启用、租户发布配置允许显示。
+- `missing`、`deferred` 能力可进入固定的建设中页面，但不得调用猜测接口或返回 Mock 成功；租户仍可在发布配置中隐藏入口。
+- 不允许配置 JSON 注入任意 React 组件、路由或远程脚本。
+- 缺失功能不调用猜测路径、不持久化 Mock 成功结果。后端补齐后，应先更新 OpenAPI 快照，再实现对应 Client。

docs/tenant-admin-coverage-matrix.md

@@ -0,0 +1,40 @@
+# 租户后台旧版能力与 .NET 覆盖矩阵
+
+更新日期：2026-08-04。旧版 `tiki-web` 和线上参考后台只用于确认功能名称、信息层级和交互密度；接口状态以当前 `tiku-backend.net` OpenAPI、`ui-bootstrap` 菜单、权限和 Runtime Feature 为准。
+
+状态：`live` 已有真实页面；`frontend_pending` 后端能力存在但前端待接入；`backend_missing` 缺少等价后端契约；`tenant_disabled` 由运行时根据租户 Feature 动态判定。
+
+| 一级大类 | 二级功能 | 前端路由 | 状态 | .NET 菜单/权限/Feature 或缺口 |
+| --- | --- | --- | --- | --- |
+| 总览 | 数据看板 | `/manage` | live | `tenant.dashboard` / `tenant:dashboard:view`；当前真实展示 Runtime 与 onboarding，统一经营聚合接口缺失 |
+| 总览 | 收益账本 | `/manage/revenue` | backend_missing | 缺租户级收入趋势、渠道汇总和账本聚合契约 |
+| 教学内容 | 题库管理 | `/manage/question-bank` | frontend_pending | `tenant.question-bank` / `tenant:question-bank:manage` / `question_bank.private` |
+| 教学内容 | 词汇管理 | `/manage/vocabulary` | frontend_pending | `tenant.vocabulary` / `tenant:vocabulary:manage` / `content.vocabulary` |
+| 教学内容 | 知识手册 | `/manage/handbook` | frontend_pending | `tenant.handbook` / `tenant:handbook:manage` / `content.handbook` |
+| 教学内容 | 视频精讲 | `/manage/video` | frontend_pending | `tenant.video` / `tenant:video:manage` / `content.video` |
+| 教学内容 | 分数线配置 | `/manage/scoreline` | frontend_pending | `tenant.scoreline` / `tenant:scoreline:manage` / `content.scoreline` |
+| 教学内容 | 模拟考试 | `/manage/teaching/mock-exams` | backend_missing | 缺独立考试日程、试卷发布、监考策略和成绩册契约 |
+| 教学内容 | 智能组卷、PDF 拆章、每日一练、题目导出 | `/manage/teaching/*` | backend_missing | 缺租户端任务、排期、生成物和导出契约 |
+| 学员运营 | 学员与班级 | `/manage/students` | frontend_pending | `tenant.students` / `tenant:student:manage` / `student.management` |
+| 学员运营 | 学习记录 | `/manage/students/learning-history` | backend_missing | 学生侧记录已有，缺租户管理端跨学员聚合查询 |
+| 学员运营 | 反馈管理 | `/manage/students/feedback` | frontend_pending | Tenant Admin Direct feedback 契约 / `tenant:student:manage` |
+| 学员运营 | CRM 跟进 | `/manage/students/crm` | frontend_pending | `tenant:crm:manage` / `crm.followup`；当前 `ui-bootstrap` 尚无独立租户 CRM 菜单 |
+| 营销交易 | 商品套餐、订单、优惠券 | `/manage/commerce/*` | frontend_pending | `tenant.commerce` / `tenant:commerce:operate` / `commerce.student_store` |
+| 营销交易 | 激活码 | `/manage/commerce/activation-codes` | backend_missing | 缺学生自助核销与租户端完整激活码管理契约 |
+| 营销交易 | 代理推广 | `/manage/commerce/referrals` | frontend_pending | `tenant:commission:manage` / `growth.referral_commission`；当前 `ui-bootstrap` 尚无独立佣金菜单 |
+| 营销交易 | 销售追踪 | `/manage/commerce/sales` | backend_missing | 缺渠道归因、销售漏斗和人员业绩聚合契约 |
+| 站点装修 | 站点与主题 | `/manage/site/:tab` | live | frontend-config draft/publish、资产 sign/confirm/preview；上传暂复用 `tenant:question-bank:manage` |
+| 站点装修 | 运营内容 | `/manage/site-content` | frontend_pending | `tenant.site-content` / `tenant:site-content:manage` / `marketing.site_content` |
+| 系统设置 | 地区管理 | `/manage/settings/regions` | backend_missing | 公共地区目录可读，缺租户自主管理地区范围契约 |
+| 系统设置 | 员工与权限 | `/manage/staff` | frontend_pending | `tenant.staff` / `tenant:staff:manage` |
+| 系统设置 | 基础设置 | `/manage/settings/base` | frontend_pending | `tenant:settings:manage` 与 Tenant Admin Direct 品牌/域名等契约 |
+| 系统设置 | 登录方式、外部服务、短信 | `/manage/settings/*`、`/manage/providers` | frontend_pending | `tenant.providers` / `tenant:provider:manage` |
+| 系统设置 | SaaS 账务 | `/manage/billing` | frontend_pending | `tenant.billing` / `tenant:billing:manage` |
+| 系统设置 | 审计日志 | `/manage/settings/audit` | frontend_pending | Tenant Admin Direct audit 契约；前端按 `tenant:settings:manage` 暂时归组 |
+
+## 前端行为约束
+
+- `ui-bootstrap` 返回的已知菜单只映射到固定注册路由；未知菜单代码忽略并在开发环境告警。
+- 具备权限但套餐 Feature 未启用时显示 `tenant_disabled`，不发送业务请求。
+- `frontend_pending` 和 `backend_missing` 路由只显示统一占位页，不返回 Mock 成功结果。
+- Mock 模式模拟 Owner 完整权限、标准菜单和天津演示数据；API 模式不会因为接口为空或失败回退 Mock。