爱伴 · AI之旅 ｜ 训练营小程序
需求规格说明书（SRS）
用 AI 管好家里的三本账 · 让 AI 成为您的贴心伙伴
课程体系：L0/L1/L2/L3/L4 · 首期课程 L0 = 「家立方 · AI管家半日营」
版本：V2.0
日期：2026-09-04
状态：修订稿
替代：V1.0（2026-09-03）
1文档说明与版本变更
1.1 文档目的
本文档定义「爱伴 · AI之旅」训练营微信小程序（学员端，uni-app Vue2）的需求规格，作为前端实现、后端开发与验收测试的基准。本文档依据 C:\Users\liaoxg.DESKTOP-DGLN79N\WorkBuddy\2026-09-03-19-40-57 目录下的产品方案文档重写，具体引用文件见 1.3。
1.2 版本变更记录（V1.0 → V2.0）
| 章节 | V1.0（旧） | V2.0（本版） |
|---|
| 定位 |
面向「L0 半天营 30人 / 5组 / 积分对抗」单场景的完整课堂功能 |
按生命周期分期：一期=课堂管理；二期=课前准备；三期=课后跟踪；另新增报名 / 付费 / 裂变分享 |
| 课堂管理 |
分散描述 |
归并为「一期」，与现有页面/表对齐（分组、分工、上传、教学卡、路演、投票、积分榜） |
| 课前准备 |
仅装机打卡 |
新增：课前资料包、数据自检、课前 3 件事（见 §7） |
| 课后跟踪 |
仅 7 天计划 |
新增：T+1/T+3/T+7/T+21/T+30 跟进、测评调研、卡券发放（见 §8） |
| 报名 / 付费 / 裂变 |
无 |
新增模块（见 §9） |
1.3 引用源文档（WorkBuddy 2026-09-03）
| 源文档 | 关系 |
|---|
| 01_校友圈AI培训与教练陪伴_整体方案.html | 产品体系、商业模式、L0-L4 金字塔、定价 |
| 02_课纲_AI管家启航营_半天版_V4_三本账分工.html | 课堂管理主需求：6 模块、积分赛制、两轮投票、三本账分工、五步教学卡 |
| 06_引流与产品闭环设计.html | 报名、付费、裂变分享、转介激励、完课证书 |
| 11_小程序需求规格说明书.html | 旧版 SRS（本文档重写对象） |
| 13_文件索引与版本说明.html | 文档索引、品牌名词约定 |
2项目背景与目标
2.1 产品背景
「爱伴 · AI之旅」面向希望用 AI 管理家庭生活的用户（尤其校友圈），提供「精品半天课 → 工作坊 → 系统营 → 21 天陪跑 → 年度教练会员 → 校友讲师团」的进阶路径。课程核心是教会用户用 WorkBuddy（得力/爱达玳 AI 助手） 管好家里的三本账：财富账、健康账、成长账。
- L0 · 家立方·AI管家半日营：入门体验课，3 小时，30 人 / 5 组 / 积分对抗。
- L1 · 三场景工作坊：单场景深度 + 三场景联报。
- L2 · 个人系统建造营：搭建个人 AI 管家系统。
- L3 · 21 天陪跑：教练陪伴、习惯固化。
- L4 · 校友讲师团：优秀学员成长为讲师。
2.2 本小程序定位
小程序（学员端）是线下训练营的数字化载体，覆盖「报名 → 课前准备 → 课堂管理 → 课后跟踪 → 裂变转介绍」全生命周期。一期聚焦课堂内实时管理，后续逐步补齐课前课后与商业闭环。
2.3 总体目标
- 一期实现线下课堂的高效管理：分组、分工、积分、投票、成果沉淀，替代纸质记录。
- 二期打通课前准备，降低课堂上手门槛（预装、数据就绪）。
- 三期承接课后跟踪，提升完课率与留存转化。
- 新增报名 / 付费 / 裂变分享，形成从获客到转化的商业闭环。
3产品体系与名词约定
3.1 品牌与课程
| 项 | 约定 |
|---|
| 总品牌 | 爱伴 · AI之旅 |
| 品牌标语（课程层） | 用 AI 管好家里的三本账 |
| 品牌标语（品牌层） | 让 AI 成为您的贴心伙伴 |
| 课程体系 | L0/L1/L2/L3/L4 五级 |
| 首期课程（L0） | 家立方 · AI管家半日营（保留为 L0 的 course name） |
| 三本账 | 财富账（wealth）· 健康账（health）· 成长账（growth） |
3.2 关键名词表
| 名词 | 含义 |
|---|
| 班次 Class | 一次授课场次（例：2026-09-06 上午场），30 人 / 5 组 |
| 小组 Group | 6 人一组，组名含数字 + 三本账之一 + 8 字口号 |
| 分工 Assignment | 组内按三本账分工，role=专家/expert 或 支援/support |
| 成果 Submission | 深度产出（deep）或 互教跑通（taught） |
| 教学卡 TeachingCard | 互教 5 步教学卡（五槽位） |
| 路演 Roadmap | 各组终局展示 + 讲师评分 0-40 |
| 两轮投票 Vote | 第1轮「我学会了」；第2轮「最想抄走」 |
| 积分 Score | 组积分 + 个人积分，满分 230 |
| 嘉宾 Gift | 完课后的卡券 / 私教名额 / 年会员等权益 |
| 浠艾福 | AI 托管运营引擎，「一灯传百灯」创客生态（裂变载体） |
4用户角色与权限
| 角色 | 说明 | 主要权限 |
|---|
| 学员 Student | 报名参训的营员（train_user.role=student） | 报名、进班、分组、上传成果、投票、查看积分 |
| 讲师 Lecturer | 主讲老师（train_admin.role=lecturer） | 建班、管理后台、路演评分、积分手动加分、颁奖 |
| 助教 Assistant | 课堂协助（train_admin.role=assistant） | 核验成果、管理负责的组（manage_group_ids） |
| 运营 Admin | 后台运营（train_admin.role=admin） | 全部后台权限、课程/班次/卡券/统计管理 |
| （游客） | 未登录 / 未报名用户 | 浏览课程介绍、发起报名、微信授权登录 |
权限边界
小程序端权限由后端 JWT + 角色控制；后台（train-web）独立账号体系（train_admin）。助教只能操作其负责的小组。
5分期规划总览
本文档按交付优先级将需求分为三期，并标注新增的报名 / 付费 / 裂变分享模块（扩展三期）。各功能需求以 FR-xx-ID 编号，并打上分期标签：一期二期三期。
| 分期 | 聚焦 | 核心功能 | 对应页面 / 表（现状） |
一期
课堂管理 |
线下课堂实时管理 |
进班、分组、分工、成果上传与核验、教学卡、路演、两轮投票、积分榜、奖项、后台 |
页面：index/class/group/assignment/upload/teaching/roadmap/vote/scoreboard/verify
表：train_class/group/group_member/assignment/submission/teaching_card/roadmap/vote/score |
二期
课前准备 |
降低课堂上手门槛 |
课前资料包、装机打卡、数据自检、课前 3 件事、通知提醒 |
页面：checkin/prep(新)
表：train_checkin/train_prep_check |
三期
课后跟踪 |
提升完课率与留存 |
7 天行动计划、T+ 系列跟进、测评兴趣调研、卡券/权益发放、证书 |
页面：plan/survey/mine(卡券)
表：train_plan/train_survey/train_coupon |
扩展
报名·付费·裂变 |
商业闭环 |
报名表单、支付、团报、专属海报、邀请码、转介激励、转介绍统计 |
页面：enroll/pay/share(新)
表：train_order/train_enrollment/train_invite（新增） |
分期建议
一期（课堂管理）为最低可用闭环，建议最先交付；二期（课前）与三期（课后）可同步并行；报名 / 付费 / 裂变涉及支付与第三方能力，建议在三期后或与三期并行启动。
6一期 · 课堂管理
一期一期聚焦线下课堂的实时管理，对应现有小程序已实现的页面与后端表。目标：替代纸质流程，让讲师/助教/学员在课堂上用小程序完成全部协作。以下功能需求均已具备实现基础，本版 SRS 予以固化表述。
6.1 登录与进班
FR-CM-01 微信授权登录 一期
学员通过微信授权登录，绑定 openid。登录后自动获取微信手机号与昵称，填充个人资料（train_user.phone / name）。后端签发 JWT（密钥与 cfc 体系互通）。
FR-CM-02 校友身份校验 一期
学员可提交校友身份（姓名、届别、院系、城市）进行校验，状态 pending（待审）/ accepted（通过）/ rejected（驳回）。通过后方可享受校友价/进入对应班次。后台可审核（train-web）。
页面：verify。
FR-CM-03 班级码进班 一期
学员通过 6 位班级码（train_class.code）加入班次，系统自动记录 class_id。已在班则提示。班次状态 draft/active/finished 控制可加入性。
页面：class。
6.2 分组与组队
FR-CM-04 组队与组名口号 一期
班内 30 人分为 5 组（每组 6 人）。学员创建或加入小组，组名需包含「数字 + 钱/身体/孩子之一」+ 8 字口号。组名称示例符合课纲 V4 规则。
页面：group。
FR-CM-05 组内分工（三本账） 一期
组内成员认领三本账（wealth/health/growth）之一，role=expert（专家）或 support（支援）。可标记是否使用 etotem 脱敏样本。分工状态 pending/confirmed。
页面：group，assignment。
FR-CM-06 路演发言人登记 一期
每组登记路演发言人（话最少的人，登记后不可更换），作为路演评分对象。
表字段：train_group.spokesperson_uid。
6.3 成果沉淀与核验
FR-CM-07 成果上传 一期
学员上传深度产出（deep）或互教跑通（taught）成果，支持多文件（files JSON）+ 核心产出截图（image）。标记是否样本数据（sample_flag）与是否确认脱敏（desensitized）。
页面：upload。
FR-CM-08 助教核验 一期
助教对成果进行 approved/rejected 审核，rejected 需填退回原因。核验通过后计入对应积分。
后端：SubmissionController + AdminReviewController。
FR-CM-09 五步教学卡 一期
学员按五槽位生成互教教学卡：①想一个问题 ②放进数据 ③让它报字段 ④发指令·验数字 ⑤存下来·定个时。可上传教学卡照片，讲师给质量分 0-20。
表：train_teaching_card；页面：teaching。
6.4 路演与投票
FR-CM-10 路演材料提交 一期
各组提交路演材料（截图/文件），记录命题（proposition A-E）与发言人。讲师路演评分 0-40。
表：train_roadmap；页面：roadmap。
FR-CM-11 两轮投票 一期
- 第1轮「我学会了」：每人 2 票，不得投本组，投两个不同组；票王 30 / 第二 22 / 第三 15 / 其余 8。
- 第2轮「最想抄走」：每人 1 票，可投本组；票王 20 / 第二 14 / 第三 9 / 其余 4。
防作弊：不得重复投票。
页面：vote；表：train_vote。
6.5 积分与排名
FR-CM-12 积分流水 一期
组积分与个人积分统一记录在 train_score，计分项含：install/prep/find/upload/teach/roadmap_quality/roadmap/vote/help。支持加分项（跨组互助 +10/次、进阶命题 +15）。
页面：scoreboard。
FR-CM-13 积分榜与奖项 一期
实时排行榜展示各组/个人积分，支持颁奖（冠军组、最佳教学、同题最优、最想抄走、最佳互教、最佳洞察、闪电装机、全员完课）。
页面：scoreboard，mine。
6.6 管理后台（一期）
FR-CM-14 后台管理 一期
train-web 管理后台提供：课程/班次管理、学员管理、身份审核、成果审核、路演评分、积分手动加分、统计报表（AdminStatsController）。后台角色 admin/lecturer/assistant。
一期现状对齐
上述一期功能在小程序端已有对应页面（index/login/verify/class/group/assignment/upload/teaching/roadmap/vote/scoreboard/mine）与后端控制器（Auth/Class/Group/Assignment/Submission/TeachingCard/Roadmap/Vote/Score + admin/*）。本版 SRS 固化为一期范围。
7二期 · 课前准备
二期课前准备降低课堂上手门槛，确保学员到课即能动手。对应现有 train_checkin / train_prep_check 表，需补充课前资料包与提醒通知。
7.1 课前资料与提醒
FR-PRE-01 课前资料包 二期
报名并进班后，系统推送课前资料包：课件 PDF、导出指引、脱敏清单、课前 3 件事说明。资料可按班次配置（train_class 扩展字段或独立附件表）。
FR-PRE-02 课前提醒通知 二期
上课前 T-7/T-3/T-1 通过微信订阅消息提醒学员完成课前准备，并附上课时间地点（train_class.time/place）。
7.2 课前 3 件事
FR-PRE-03 装机打卡 二期
学员提交 WorkBuddy 已安装并登录的截图（train_checkin.image），status=done 即完成。计入课前完成状态，课堂模块二「装机通关」可读取该状态提速。
页面：checkin（现有）。
FR-PRE-04 数据准备自检 二期
学员自检三本账数据是否就绪：券商持仓（wealth）、体检或血压（health）、孩子成绩或日程（growth）。可勾「选了无」，系统分配 etotem 脱敏样本。
表：train_prep_check；页面：prep（新增）。
FR-PRE-05 课前 3 件事引导 二期
引导页展示课前 3 件事：①预装 WorkBuddy ②拷贝真实数据 ③想好「我家最乱的一本账」。全部完成点亮，未完成可反复提醒。
8三期 · 课后跟踪
三期课后跟踪提升完课率、留存与转化，把「半天课」延伸为「持续陪伴」。对应现有 train_plan / train_survey / train_coupon 表。
8.1 7 天行动计划
FR-POST-01 7 天行动计划提交 三期
学员填写课后 4 件事：①补齐账本 ②固化 3 个用法 ③第 2 条自动化 ④约 etotem 测评。提交后进入 7 天执行期，状态 pending/done。
页面：plan；表：train_plan。
8.2 T+ 系列跟进
FR-POST-02 课后跟进节奏 三期
- T+1：推送成果合集与课堂照片。
- T+3：提醒补齐未完成项。
- T+7：回访 7 天计划完成度。
- T+21：约线上复盘会。
- T+30：留存统计与续课推荐。
8.3 测评调研与权益发放
FR-POST-03 测评兴趣调研 三期
课后收集学员感兴趣的后续方向（interest_health / interest_growth），用于精准推荐 L1-L4 课程。
页面：survey；表：train_survey。
FR-POST-04 卡券 / 权益发放 三期
按完成情况自动发放卡券（train_coupon）：L1 / private（私教）/ etotem（测评），触发来源 vote/finish/research/champion/teaching。学员在「我的」查看并使用。
页面：mine（卡券区）。
FR-POST-05 完课证书 三期
完成离场验收 6 项（见 §6 备注与课纲）后，生成可分享的电子完课证书，作为社交货币用于裂变。
9报名 · 付费 · 裂变分享
扩展本模块为新增需求，落地商业闭环。引用源文档 06_引流与产品闭环设计.html 与 01_整体方案.html。需新增后端表 train_order / train_enrollment / train_invite，及前端页面 enroll / pay / share。
9.1 报名
FR-ENROLL-01 报名表单 扩展
游客可浏览课程介绍并发起报名，填写：姓名、手机号、（选填）是否带电脑、已备数据类别、最想解决的 3 个问题。报名后生成报名单（train_enrollment），状态 pending/confirmed。
FR-ENROLL-02 班次选择与容量 扩展
报名时选择班次（train_class），展示时间/地点/剩余名额；满员（capacity）停止报名。校友价/公开价由身份校验结果决定。
FR-ENROLL-03 邀请链接 / 班级码进班 扩展
已报名学员可通过邀请链接或班级码进入班次与小组，衔接一期课堂管理。
9.2 付费
FR-PAY-01 在线支付 扩展
接入微信支付，学员对报名单完成支付，生成订单（train_order）。订单状态 unpaid/paid/refunded/failed。金额以「分」为单位整数存储（与 cfc 金额规范一致）。
FR-PAY-02 定价分层 扩展
- L0 半天营：校友价 199-399，公开价 699-999。
- L1 三场景工作坊：单场景 1280-1980，联报 3980。
- L2 系统营：6800-9800。
- 21 天陪跑：1980；年度教练会员：12800-19800/年。
- 团报：30000-80000/场。
价格由后台配置，支付按实付金额结算。
FR-PAY-03 团报与发票 扩展
支持团报下单（多学员一单）与企业开票信息采集。
9.3 裂变分享
FR-FISS-01 专属海报与邀请码 扩展
每位学员生成专属分享海报 + 邀请码（train_user.invite_code 复用），带参进入报名页，记录转介关系（train_invite：inviter_id / invitee_id）。
页面：share（新增）。
FR-FISS-02 转介激励 扩展
- 转介 1 人：赠 1 次私教（private）体验。
- 转介 3 人：赠年度会员权益。
- 「一灯传百灯」创客生态：邀请进入浠艾福创客体系，获得后续分成。
FR-FISS-03 转介绍统计 扩展
后台展示每位学员的转介绍人数、成功报名数、发放权益记录，形成转介绍漏斗。
FR-FISS-04 学员案例采集与授权 扩展
对优秀学员成果进行「采集 → 脱敏 → 授权 → 回流」。”案例用于招生与裂变内容，需学员明确授权（同意隐私条款）。
支付合规提示
付费功能涉及微信支付商户号、签名、回调验签、退款与财务对账。属于独立开发单元，建议单独立项并重点关注安全性（金额用整型分、回调幂等、防止重复支付）。
10数据模型
下表汇总现存表（schema.sql 已实现）与新增表（本版新增需求）。金额一律整型分；时间 ISO 8601；编码 utf8mb4。
10.1 现存表（一期已具备）
| 表 | 用途 | 分期 |
|---|
| train_course | 课程 L0-L4 | 一期 |
| train_class | 班次 | 一期 |
| train_user | 学员 | 一期 |
| train_group / train_group_member | 小组与成员 | 一期 |
| train_assignment | 三本账分工 | 一期 |
| train_submission | 成果上传 | 一期 |
| train_teaching_card | 五步教学卡 | 一期 |
| train_roadmap | 路演材料 | 一期 |
| train_vote | 两轮投票 | 一期 |
| train_score | 积分流水 | 一期 |
| train_checkin | 装机打卡 | 二期 |
| train_prep_check | 数据自检 | 二期 |
| train_plan | 7 天计划 | 三期 |
| train_survey | 测评调研 | 三期 |
| train_coupon | 卡券 | 三期 |
| train_admin / train_audit_log | 后台账号 / 审计 | 一期 |
10.2 新增表（报名/付费/裂变）
| 表 | 关键字段 | 用途 |
|---|
| train_order |
order_no, uid, class_id, amount(INT 分), status, pay_channel, pay_time, refund |
支付订单 |
| train_enrollment |
uid, class_id, form_data(JSON), status, source(invite/scene) |
报名单 |
| train_invite |
inviter_id, invitee_id, code, order_id, reward_status |
转介绍关系 |
11接口与集成
- 接口规范：后端统一
@PostMapping，响应统一 Result<T>（code/message/data）。分层 Controller → Service → Mapper。
- 鉴权：JWT（密钥与 cfc 对齐），营员 token 与 cfc 体系互通。
- 微信能力：登录（openid）、手机号授权、订阅消息（提醒）、微信支付（三期扩展）。开发环境 test-mode（openid=test_<code>）。
- 文件上传：UploadController 统一处理成果/截图/头像，返回可访问 URL。
- cfc 集成：CfcUser / CfcActivity 映射 cfc 同库 users / activities 表；金额与账本字段对齐 cfc 规范。
12非功能需求与合规
| 维度 | 要求 |
|---|
| 性能 | 课堂并发 ≤ 数百人，投票/积分实时刷新可接受秒级延迟；后台报表异步生成。 |
| 安全 | 金额整型分；支付回调幂等、验签；防止重复支付与越权访问（按角色校验）。 |
| 隐私合规 | 学员真实数据（持仓/血压/成绩）必须脱敏（desensitized）；案例采集需明确授权；同意隐私政策。 |
| 兼容 | uni-app Vue2（小程序端）；不支持可选链/CSS Grid；时间展示用 utils/format.js 的 parseDate。 |
| 可用性 | 断网/弱网下课堂操作可重试；已提交数据不丢失。 |
13验收标准与排期建议
13.1 验收标准（分阶段）
| 阶段 | 通过准则 |
|---|
| 一期 · 课堂管理 | 一次完整 L0 半天营课堂（30人/5组）全程可用小程序完成：进班、分组、分工、上传、核验、路演、两轮投票、积分榜、颁奖；后台可导出。 |
| 二期 · 课前准备 | 报名学员收到课前资料与提醒；装机打卡与数据自检状态可被课堂读取提速。 |
| 三期 · 课后跟踪 | 7 天计划、T+ 跟进、测评调研、卡券发放全流程跑通。 |
| 扩展 · 报名付费裂变 | 报名→支付→进班闭环；邀请海报/邀请码→转介绍→权益发放→后台转介绍漏斗。 |
13.2 排期建议
- 一期（课堂管理）：现有代码已基本具备，建议优先验收、上线支撑首期线下课。
- 二期（课前）+ 三期（课后）：可并行开发，共用订阅消息与资料体系。
- 扩展（报名/付费/裂变）：涉及微信支付与商业结算，单独立项，紧随一期之后或与三期并行启动。
结论
本 SRS 将原 V1.0 单场景文档重构为「一期课堂管理 → 二期课前准备 → 三期课后跟踪 + 报名/付费/裂变」的分期体系，与现有代码库已实现的 18 张表、15 个前端页面对齐，并为商业闭环预留新增表与页面。可按 §13.2 排期分阶段交付与验收。