forked from wangziqi/gongxue-base
7.5 KiB
7.5 KiB
旧题库功能差距矩阵
更新时间：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：前端联调到云端前
- 正式鉴权：Supabase Auth/JWT 或服务端 session，替换迁移期请求头。
- 生产配置 fail-fast：默认密钥、
CORS=*、mock SMS、平台默认 key 必须禁止。 - JSON body size limit：导入接口可配置更大限制，但必须有上限。
- 真实租户隔离测试：跨租户读写、角色越权、资源下载越权。
- 真实短信/微信小程序登录最小闭环。
P1：商用主链路
- 微信/支付宝支付和 webhook 幂等。
- 对象存储 PDF 预览、视频播放签名、防盗链、水印。
- Excel/CSV、分数线、视频批量导入。
- 数据看板和销售/代理分佣结算。
- 公共题库授权、租户采纳和版本同步。
P2：增强体验
- 主题模板、素材库、主题预览/发布。
- 班级、教师、学生分组和学习督导。
- AI 择校推荐和 PDF 报告。
- 题库导出、试卷生成、每日一练运营工具。