gongxue-base/docs/refactor/blueprint-coverage.md

SaaS 蓝图覆盖矩阵

更新时间：2026-06-29

目标定位

新项目要覆盖旧 PocketBase 项目全部功能，同时升级为多租户 SaaS：

• 平台超级管理员：管理所有租户、SaaS 套餐、年费/服务费、公共/地区题库披露。
• 租户公司：拥有自己的品牌、域名、支付/登录/CRM 配置、成员角色、题库内容、销售/代理体系。
• 学生端：刷题、错题、收藏、背单词、知识手册、分数线、视频解析、会员权益。
• 跨端前端：后续 Taro 一套代码输出 H5 和小程序，统一调用 apps/api。

当前覆盖情况

蓝图模块	当前状态	已落地内容	待补内容
平台超级管理员	部分完成	租户管理、SaaS 套餐、订阅、账单、服务费收款、用量记录	公共题库披露策略、地区/全国套餐权限、平台侧主题模板库、平台审计
租户品牌和域名	基础完成	品牌、Logo、主题 JSON、公开资源、域名、租户公开配置	三套默认主题、主题可视化编辑、图标/图片上传
租户成员权限	可联调	owner/admin/operator/teacher/sales/agent/student，权限矩阵，成员启停，角色模板、菜单/模块/字段权限、班级/学生范围权限和审计查询	前端权限 UI、更细的数据范围组合
题库内容维护	可联调	内容入口、任意深度分类树、院校/专业/学科/销售意向标记、题目集合、顺序/随机/全真模拟练习蓝图、题目录入/更新、题目/单词/知识手册/分数线/视频 JSON/CSV/Excel 预览导入、executionMode=async 导入 worker、导入后复检、模板/字段映射 API、视频绑定、分数线、单词、知识手册后台 API、公共题库授权、采纳快照、手动同步、自动同步 worker、同步通知和冲突查询 API	字段映射 UI、公共题库失败告警/冲突操作台增强、可视化拖拽排序前端
学生刷题	基础完成	内容入口、分类树、题目集合、顺序刷题、随机刷题、全真模拟 session 题目快照、答题、错题本、收藏夹、模考交卷评分报告、错题复习计划、排行榜	专项练习策略、题型统计深度分析、排行榜防刷/预聚合
背单词	基础完成	单词单元、单词、进度、收藏、统计、每日复习计划、旧模板/新模板 JSON/CSV/Excel 预览导入、内容导航绑定、排行榜	更细复习参数
知识手册	基础完成	科目、章节、条目只读与后台维护、书籍/章节/小节/知识点嵌套 JSON 预览导入、内容导航绑定	富文本资源、版本管理、附件/PDF 关联、Excel/Markdown 批量解析
分数线	可联调	字段、院校、专业、记录、趋势、年份、JSON 批量导入	复杂动态筛选、AI 择校数据上下文
视频解析会员	可联调	题目视频、批量查询、后台绑定、视频 JSON 导入、SVIP 权限、播放次数扣减、签名 URL、播放日志	深度防盗链、动态水印、播放统计
资料下载/PDF	可联调	content_assets 资源台账、后台资源管理、OSS/COS/Supabase Storage 上传下载签名、上传确认、PDF/图片预览签名、学生端列表、SVIP 下载权限、assets worker 复检、内置安全扫描和外部 HTTP scanner 接入层	CDN 防盗链、真实 AV/内容安全服务联调、资料前端管理页
营销中心	基础完成	SVIP 套餐、激活码批次、激活码生成、优惠券、Banner/FAQ/公告、勋章管理和手动发放	勋章自动发放、复杂活动规则、核销报表
销售/代理客资	可联调	邀请码、扫码/分享事件、首绑保护、销售统计、客资明细、团队关系、手动补绑、分佣比例、归因、结算单、审核和打款状态	真实微信小程序码、真实打款、结算导出、销售团队看板
CRM 系统	可联调	CRM 配置、密钥私密存储、客资入队、队列查询、generic/钉钉/飞书/企微 worker、签名、重试和日志	定向/轮询分配、富卡片模板、失败告警、死信运营台
数据看板	可联调	租户 dashboard 聚合接口，收益、注册、学习、内容、激活码、反馈、趋势、24h 活跃、套餐销量和运营动态	预聚合 worker、缓存、慢 SQL 监控和销售转化看板
登录认证	可联调	短信 mock、阿里云/腾讯云短信 adapter、迁移期 session、Supabase Auth JWT、微信小程序登录、微信网页登录、QQ 登录、手机号绑定/换绑、OAuth 配置表	真实生产账号和回调域名联调
支付	可联调	订单、支付记录、手动确认权限保护、权益发放、租户商户配置、微信支付 JSAPI、支付宝 WAP/H5、webhook 幂等、退款状态机、退款通知、补偿 worker、资金对账导入比对、异常查询、差错工单和事件轨迹	官方账单自动下载、异常订单运营台、服务商/平台代收模式
AI 择校推荐	未开始	暂无	数据上下文、AI provider、JSON 报告 schema、PDF 报告生成
Taro 跨端	未开始	旧 Web 新 API 适配开始	apps/taro、共享 API client、H5/小程序统一构建

接下来优先级

1. 完善内容导入和对象存储：字段映射 UI、真实数据 dry-run、CDN 防盗链、真实 AV/内容安全服务联调和视频水印。
2. 公共题库/地区题库授权：已完成披露、采纳快照、手动同步、自动同步 worker、同步通知、冲突查询和租户自改保护；继续补生产失败告警、冲突操作台增强和按 SaaS 套餐限制地区。
3. 学习统计增强：排行榜防刷/预聚合、断点续练、专项练习策略和更细题型分析。
4. 视频会员控制：深度防盗链、水印和播放统计。
5. 数据看板预聚合：把实时聚合升级为大租户可承载的日/周/月预聚合。
6. 真实 provider：短信、微信/QQ 登录、微信支付/支付宝生产账号联调；CRM worker 基础已落地，继续补分配策略和告警。