forked from wangziqi/gongxue-base
docs: add backend and taro handoff guides
This commit is contained in:
Codex
111
docs/refactor/legacy-feature-gap-matrix.md
Normal file
111
docs/refactor/legacy-feature-gap-matrix.md
Normal file
@@ -0,0 +1,111 @@
|
||||
# 旧题库功能差距矩阵
|
||||
|
||||
更新时间：2026-06-28
|
||||
|
||||
旧项目位于 `F:\project\参考\旧题库项目`，只作为功能、样式、交互和迁移参考。新项目不再复刻 PocketBase/SQLite 的数据结构，而是以新多租户 SaaS 模型为准。
|
||||
|
||||
状态说明：
|
||||
|
||||
- `已覆盖`：新后端已有对应模型和接口。
|
||||
- `部分覆盖`：已有主干，但商用体验或边界还要补。
|
||||
- `未覆盖`：需要新增后端能力。
|
||||
- `前端为主`：后端已有基础，主要由 Taro/H5 实现展示和交互。
|
||||
|
||||
## 学生端功能
|
||||
|
||||
| 旧功能/页面 | 旧项目参考 | 新后端状态 | 待补齐 |
|
||||
| --- | --- | --- | --- |
|
||||
| 登录/注册 | `pages/Login.tsx` | 部分覆盖 | 短信 mock/session 已有；微信小程序、微信网页、QQ、正式 JWT 未完成 |
|
||||
| 选地区 | `pages/RegionSelector.tsx` | 已覆盖 | 需要前端按租户套餐和权益展示可选地区 |
|
||||
| 首页/学生看板 | `pages/StudentDashboardNew.tsx` | 部分覆盖 | 品牌、Banner、公告、入口、个人统计有基础；缺完整运营动态/学习任务聚合 |
|
||||
| 题库入口 | `pages/SubjectSelector.tsx`、`RegionArchitectureEditor.tsx` | 已覆盖 | 前端应改接 `content_entries/content_nodes` |
|
||||
| 多级分类树 | 旧 module/subject/category 树 | 已覆盖 | 新后端支持任意深度和 `marker_type`；前端不要写死层级 |
|
||||
| 顺序刷题 | `pages/Quiz.tsx` | 已覆盖 | 继续补题量限制、断点续练、更多题型渲染 |
|
||||
| 随机刷题 | `pages/Quiz.tsx` | 已覆盖 | 已有 blueprint/session 快照，前端需按 mode 调用 |
|
||||
| 全真模拟 | `components/AdminMockexam`、`MockExamConfigModal.tsx` | 部分覆盖 | 后端有 blueprint 基础；缺完整交卷报告、排名、复盘 |
|
||||
| 错题本 | 用户 stats/错题逻辑 | 已覆盖 | 后续补错题复习计划 |
|
||||
| 收藏夹 | `WordFavoritesPage.tsx`、题目收藏 | 已覆盖 | 题目和单词收藏已有 |
|
||||
| 题目视频 | `VideoPlayer.tsx` | 部分覆盖 | 题目视频查询已有；缺播放签名、次数扣减、水印、防下载 |
|
||||
| 背单词 | `VocabularyPage.tsx`、`VocabularyQuiz.tsx` | 部分覆盖 | 单词列表/进度/收藏/统计已有；缺完整艾宾浩斯算法、每日计划、收藏练习细节 |
|
||||
| 知识手册 | `Handbook*.tsx` | 已覆盖 | 前端需做好 Markdown/公式/图片渲染和搜索体验 |
|
||||
| 分数线 | `ScorelinePage.tsx` | 已覆盖 | 动态字段/趋势已有；缺批量导入和复杂筛选优化 |
|
||||
| 商城/SVIP | `Store.tsx`、`SvipModal.tsx` | 部分覆盖 | 套餐/订单/权益/激活码已有；缺真实支付、优惠券抵扣 |
|
||||
| 个人中心 | `Profile.tsx` | 部分覆盖 | 基本资料、权益、订单统计有；缺完整勋章、签到、学习报告 |
|
||||
| 资料下载 | `QuestionExporterPublishModal.tsx` 等 | 部分覆盖 | 资源台账/签名下载已有；缺 PDF 预览、下载水印、防盗链 |
|
||||
| AI 择校推荐 | 业务规划新增 | 未覆盖 | 需设计学生输入 schema、地区数据上下文、AI JSON 输出、PDF 报告 |
|
||||
|
||||
## 租户后台功能
|
||||
|
||||
| 旧功能/组件 | 新后端状态 | 待补齐 |
|
||||
| --- | --- | --- |
|
||||
| 用户管理 | 部分覆盖 | 租户成员 API 已有；学生用户列表、批量导入、禁用/补绑/CRM 批量推送还需完善 |
|
||||
| 销售/代理管理 | 部分覆盖 | referral/team/stats 有；缺分佣比例、结算单、审核、导出 |
|
||||
| 班级/教师管理 | 未覆盖 | 需新增班级、学生分班、教师可见范围 |
|
||||
| 数据看板 | 部分覆盖 | 表基础有；缺收益、注册、答题、活跃、套餐销量等聚合 API |
|
||||
| 地区管理 | 部分覆盖 | 地区和内容入口已有；缺按 SaaS 套餐限制地区/题库授权的完整流程 |
|
||||
| 品牌配置 | 已覆盖 | 需要前端做预览和主题发布体验 |
|
||||
| 自定义域名 | 已覆盖 | 生产需补 DNS 校验、证书状态、回源校验 |
|
||||
| 主题系统 | 部分覆盖 | 当前 theme JSON 可用；缺三套平台主题模板和素材管理 |
|
||||
| 商户收款配置 | 部分覆盖 | 配置 API 有；缺真实支付 provider 和验签 |
|
||||
| 登录配置 | 部分覆盖 | 配置 API 有；缺真实短信/OAuth provider 实现 |
|
||||
| Banner/公告/FAQ/活动 | 已覆盖 | 前端运营后台可以接 |
|
||||
| SVIP 套餐 | 已覆盖 | 后续补地区/分类/专业增项限制规则 |
|
||||
| 优惠券 | 部分覆盖 | 后台配置有；前台兑换、下单抵扣待补 |
|
||||
| 激活码 | 已覆盖 | 批次、生成、兑换主链路已有 |
|
||||
| 勋章管理 | 部分覆盖 | 表结构有 badges/user_badges；缺后台和学生端 API |
|
||||
| 题库录入 | 已覆盖 | 单题创建/更新、JSON 导入、集合/蓝图已有 |
|
||||
| 题库导出 PDF/Word/JSON | 未覆盖 | 旧前端有导出组件；新后端需决定是否服务端导出或前端导出 |
|
||||
| 题型分组/模拟卷配置 | 部分覆盖 | question_type_groups 表和 blueprint 有基础；后台配置体验待补 |
|
||||
| 背单词维护 | 已覆盖 | 单元/单词 CRUD 和导入已有 |
|
||||
| 知识手册维护 | 已覆盖 | subject/chapter/entry CRUD 和导入已有 |
|
||||
| 分数线维护 | 已覆盖 | 字段/院校/专业/记录 CRUD 已有 |
|
||||
| 视频维护/绑定 | 已覆盖 | video CRUD 和 question-video 绑定已有 |
|
||||
| CRM 配置和队列 | 部分覆盖 | 配置/队列已有；发送 worker 待补 |
|
||||
| 对象存储配置 | 部分覆盖 | 系统 env provider 已有；租户级存储策略、上传后校验待补 |
|
||||
|
||||
## 平台 SaaS 后台功能
|
||||
|
||||
| 功能 | 新后端状态 | 待补齐 |
|
||||
| --- | --- | --- |
|
||||
| 创建/管理租户 | 已覆盖 | 平台后台页面待做 |
|
||||
| SaaS 套餐 | 已覆盖 | 需要和地区/题库授权策略打通 |
|
||||
| 年费/服务费账单 | 已覆盖 | 真实支付/开票/催缴流程待补 |
|
||||
| 租户用量记录 | 已覆盖 | 自动采集 worker 待补 |
|
||||
| 公共题库/地区题库 | 部分覆盖 | question_banks 有 source_scope；缺租户采纳、授权、版本同步 |
|
||||
| 跨租户运营看板 | 部分覆盖 | overview 有基础；缺完整 BI 聚合 |
|
||||
| 租户安全审计 | 部分覆盖 | audit logs 有；缺平台级审计报表 |
|
||||
|
||||
## 旧功能中应重新设计的点
|
||||
|
||||
- 旧项目把很多用户状态放在 JSON 或前端逻辑里，新项目应拆到独立表或后端服务。
|
||||
- 旧树形结构只作为迁移来源，新前端应使用 `content_entries/content_nodes/question_collections/practice_blueprints`。
|
||||
- 旧资料/视频 URL 不能继续让前端直连私有资源，新项目统一走 `content_assets` 和签名 URL。
|
||||
- 旧后台的一些“隐藏入口/超管直贴 JSON”应改为 preview/import/job/issue 审计流。
|
||||
- 旧支付和激活码逻辑要统一成订单、支付事件、权益开通、幂等 webhook。
|
||||
- 旧销售追踪要升级为租户内角色权限 + 首绑保护 + 分佣结算 + CRM worker。
|
||||
|
||||
## 后端补齐优先级
|
||||
|
||||
### P0：前端联调到云端前
|
||||
|
||||
1. 正式鉴权：Supabase Auth/JWT 或服务端 session，替换迁移期请求头。
|
||||
2. 生产配置 fail-fast：默认密钥、`CORS=*`、mock SMS、平台默认 key 必须禁止。
|
||||
3. JSON body size limit：导入接口可配置更大限制，但必须有上限。
|
||||
4. 真实租户隔离测试：跨租户读写、角色越权、资源下载越权。
|
||||
5. 真实短信/微信小程序登录最小闭环。
|
||||
|
||||
### P1：商用主链路
|
||||
|
||||
1. 微信/支付宝支付和 webhook 幂等。
|
||||
2. 对象存储 PDF 预览、视频播放签名、防盗链、水印。
|
||||
3. Excel/CSV、分数线、视频批量导入。
|
||||
4. 数据看板和销售/代理分佣结算。
|
||||
5. 公共题库授权、租户采纳和版本同步。
|
||||
|
||||
### P2：增强体验
|
||||
|
||||
1. 主题模板、素材库、主题预览/发布。
|
||||
2. 班级、教师、学生分组和学习督导。
|
||||
3. AI 择校推荐和 PDF 报告。
|
||||
4. 题库导出、试卷生成、每日一练运营工具。
|
||||
|
||||
Reference in New Issue
Block a user