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

SaaS 蓝图覆盖矩阵

更新时间：2026-06-21 21:42

目标定位

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

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

当前覆盖情况

蓝图模块	当前状态	已落地内容	待补内容
平台超级管理员	部分完成	租户管理、SaaS 套餐、订阅、账单、服务费收款、用量记录	公共题库披露策略、地区/全国套餐权限、平台侧主题模板库、平台审计
租户品牌和域名	基础完成	品牌、Logo、主题 JSON、公开资源、域名、租户公开配置	三套默认主题、主题可视化编辑、图标/图片上传
租户成员权限	基础完成	owner/admin/operator/teacher/sales/agent/student，权限矩阵，成员启停，审计查询	前端权限 UI、自定义角色模板、菜单级可见配置
题库内容维护	基础完成	题目录入/更新、题目 JSON 预览/导入、视频绑定、分数线、单词、知识手册后台 API	Excel/CSV 批量导入、分类/节点完整管理、公题库采纳/复制/授权
学生刷题	基础完成	题目列表、练习 session、答题、错题本、收藏夹	模考、专项练习策略、错题复习计划、题型统计深度分析
背单词	基础完成	单词单元、单词、进度、收藏、统计	复习算法、每日计划、排行榜
知识手册	基础完成	科目、章节、条目只读与后台维护	富文本资源、版本管理、附件/PDF 关联
分数线	基础完成	字段、院校、专业、记录、趋势、年份	复杂动态筛选、批量导入、AI 择校数据上下文
视频解析会员	部分完成	题目视频、批量查询、后台绑定	SVIP 权限、播放次数扣减、签名 URL、防盗链、水印、播放统计
资料下载/PDF	基础完成	content_assets 资源台账、后台资源管理、上传/下载签名占位、学生端列表、SVIP 下载权限	真实 OSS/COS/Supabase Storage 签名、PDF 预览渲染、防盗链、资料前端管理页
营销中心	基础完成	SVIP 套餐、激活码批次、激活码生成、优惠券、Banner/FAQ/公告	勋章自动发放、复杂活动规则、核销报表
销售/代理客资	基础完成	邀请码、扫码/分享事件、首绑保护、销售统计、客资明细、团队关系、手动补绑、小程序码占位	真实微信小程序码、分佣结算单、销售团队看板、代理费结算
CRM 系统	基础完成	CRM 配置、密钥私密存储、客资入队、队列查询	worker 发送、钉钉/飞书/企微 adapter、重试签名、定向/轮询分配
数据看板	数据表部分具备	dashboard_daily_stats、revenue_daily_stats 表、旧 backfill 脚本	API 聚合、24h 活跃、收入趋势、题型/科目/套餐销售看板
登录认证	迁移期可用	短信 mock、迁移期 session、OAuth 配置表	阿里云/腾讯云短信、微信/QQ 登录真实 adapter、Supabase Auth/JWT
支付	迁移期可用	订单、支付记录、手动确认、权益发放、租户商户配置	微信支付/支付宝/XPay adapter、webhook 幂等、退款
AI 择校推荐	未开始	暂无	数据上下文、AI provider、JSON 报告 schema、PDF 报告生成
Taro 跨端	未开始	旧 Web 新 API 适配开始	apps/taro、共享 API client、H5/小程序统一构建

接下来优先级

1. 完善内容导入和对象存储：Excel/CSV、单词/手册/分数线/视频导入，真实 OSS/COS/Supabase Storage 签名。
2. 公共题库/地区题库授权：平台题库向租户披露、租户采纳、按 SaaS 套餐限制地区。
3. 视频会员控制：视频资源签名 URL、防盗链、水印、播放次数和会员权益。
4. 数据看板 API：把旧 dashboard/revenue 统计迁到新 API。
5. 真实 provider：短信、微信/QQ 登录、微信支付/支付宝、CRM worker。