caremate

爱伴·AI之旅 训练营系统

CareMate · AI Journey — Training Camp System

一套面向AI技能培训的全端训练营系统，支持L0-L4五级课程体系、学员成长管理、现场投屏互动、团报裂变与完课证书发放。

---

目录

1. 项目概述
2. 项目结构
3. 技术栈
4. 系统架构
5. 快速开始
6. 功能模块
7. 数据库设计
8. 前端页面
9. 后端接口
10. 管理后台路由
11. 开发规范
12. 编码硬约束
13. 外部依赖与阻塞项
14. Git工作流
15. 产品愿景

---

项目概述

「爱伴·AI之旅」（CareMate · AI Journey）是一套完整的AI技能培训训练营系统，覆盖学员从报名、学习、互动到完课的全生命周期管理。

核心能力：

• 五级课程体系（L0-L4），支持模块化半天制教学
• 班次管理与插班制，支持灵活排课
• 现场投屏大屏互动，提升课堂参与感
• 三本账分工、互教教学卡、两轮投票等教学互动机制
• 完课证书（CM编号体系）与防伪查验
• 32枚徽章 + 5段位成长体系
• 沙龙引流 → L0高频 → L1模块化 → L2系统 → L3陪跑 → L4讲师的完整漏斗

---

项目结构

train/                          # 单 git 仓库
├── train-backend/              # Spring Boot 2.7.18 / Java 8 / MyBatis-Plus 3.5.3.1
├── train-frontend/             # uni-app Vue2 小程序（学员端）
├── train-web/                  # Vue2 + Element UI 管理后台
├── docs/                       # 二次文档（SRS/详细设计/需求变更/合规核查）
└── AGENTS.md                   # AI Agent 工作规范

---

技术栈

端	技术栈	端口
train-backend	Spring Boot 2.7.18 / Java 8 / MyBatis-Plus 3.5.3.1 / JWT	9083
train-frontend	uni-app Vue2 (@dcloudio 2.x) / HBuilderX 打包微信小程序	—
train-web	Vue2 + vue-cli 5 + Element UI	—
数据库	MySQL 192.168.16.251:3306 / zxyj (cfc 同库)	3306

---

系统架构

+-------------------+     +-------------------+     +-------------------+
|   train-frontend  |     |     train-web     |     |   train-backend   |
|   (微信小程序)    |     |   (管理后台)      |     |   (Spring Boot)   |
|   uni-app Vue2    |     |   Vue2 + Element  |     |   Java 8 / JWT    |
+--------+----------+     +--------+----------+     +--------+----------+
         |                        |                        |
         |     REST API (POST)    |     REST API (POST)   |
         +------------------------+------------------------+
                                  |
                         +--------v--------+
                         |   MySQL 3306    |
                         |   zxyj 数据库   |
                         | (cfc 同库)      |
                         +-----------------+

架构说明：

• 三端共享同一数据库，后端与 cfc 系统共用 zxyj 库
• 所有接口统一使用 @PostMapping，响应格式统一为 Result<T>
• JWT 密钥与 cfc 系统对齐，实现 token 互通

---

快速开始

环境要求

• JDK 8+
• Node.js 14+
• Maven 3.6+
• HBuilderX（小程序打包）
• 微信开发者工具

后端启动

cd train-backend
mvn clean compile          # 编译通过即提交（skipTests=true）
mvn spring-boot:run        # 启动服务，端口 9083

数据库连接：

• 地址：通过环境变量 TRAIN_DB_URL 配置（默认 192.168.16.251:3306/zxyj）
• 账号密码：通过 TRAIN_DB_USERNAME / TRAIN_DB_PASSWORD 环境变量配置
• Schema 由 DatabaseInitializer 启动时自动执行 schema.sql

前端（学员端 H5）

cd train-frontend
npm install
npm run dev:h5             # 开发模式
npm run build:h5           # 构建生产包

小程序打包

1. HBuilderX 导入 train-frontend/ 目录
2. 运行 → 运行到微信开发者工具
3. 产物位于 unpackage/dist/dev/mp-weixin/

⚠️ 注意：npm run build:mp-weixin 的 dist 产物不完整，必须使用 HBuilderX 打包

管理后台

cd train-web
npm install
npm run dev                # 开发模式
npm run build              # 构建生产包

---

功能模块

已落地模块

阶段	提交范围	内容
Phase1-8	ce8db0b~6a08ebd	基础框架（JWT/Schema/CURD/投屏大屏/后台角色路由）
Phase9-10	47301fb~9ba5889	课程现场投屏大屏
Phase11	56a64fd	班级码进班联动 enrollment
Phase12	372b4ec	分享海报 sharePath/shareText
Phase13	d811135	FollowUpTask T+21/T+30 + PreClassReminderTask
Phase14	afb30a1	团报发票与案例授权
Phase15a-b	f1bdbe2~248714d	课程双态（列表/主页）+ 管理端课程审核
登录统一	c85d2ba~c9fa4cc	浮层登录 + 全局守卫 + storage 兜底
报名重构	4605b2c~9f06216	报名挂课程 + 后台分配班次 + 按课程分组
合规修复	b9d8daa	移除学员端违规入口（SRS CR-003/022）
课程增强	092ffb3~5371fda	版块维护 + 资料维护 + 学员管理强化（SRS CR-013）
PhaseA3	d5ab795	vote/finish 两个 L1 券触发点
完善	a2046b3	订阅消息真实推送 + 课前课后定时任务 + 海报小程序码
Phase4	1efa4cc	沙龙产品化与浠艾福活动打通
Phase5	0c81bef	完课证书编号体系（CM 格式）+ 防伪查验
Phase6	5cb6b4d	徽章与成长体系（32 枚徽章 + 5 段位 + 成长地图）

待实现模块

阶段	内容	状态
T1-T4	讲师平行资格体系（评教/合规笔试 2 年有效/课时费 200-1200）	待实现

---

数据库设计

训练营业务表（31 张）

序号	表名	说明
1	train_course	课程（L0-L4 五级）
2	train_course_section	课程版块（管理端维护）
3	train_class	班次
4	train_user	学员用户
5	train_group	小组
6	train_group_member	组内成员
7	train_assignment	三本账分工
8	train_submission	成果上传
9	train_teaching_card	互教教学卡
10	train_score	积分流水
11	train_vote	两轮投票
12	train_roadmap	路演材料
13	train_checkin	装机打卡
14	train_prep_check	数据准备自检
15	train_plan	7 天行动计划
16	train_coupon	卡券
17	train_survey	测评兴趣调研
18	train_admin	管理后台账号
19	train_audit_log	审计日志
20	train_enrollment	报名单
21	train_order	支付订单
22	train_invite	转介绍关系
23	train_course_material	课前资料包
24	train_screen_config	班级投屏配置
25	train_group_order	团报订单
26	train_group_order_member	团报成员
27	train_case	学员案例
28	train_salon	沙龙期次
29	train_certificate	完课证书（CM 编号体系）
30	train_badge	徽章目录（32 枚种子）
31	train_user_badge	用户徽章

cfc 共享表（只读引用）

• users — 用户表
• activities — 活动表
• user_platform_balance — 用户平台余额
• tianpan_member_annual_energy — 天盘会员年度能量

数据库与 cfc 系统共用 zxyj 库，com.train.cfc 包下的实体类映射 cfc 表结构，修改字段必须与 cfc 侧对齐。

---

前端页面

TabBar 页面（4 个）

位置	页面	路径
首页	index	pages/index/index
任务	checkin	pages/checkin/index
课程	course	pages/course/index
我的	mine	pages/mine/index

子页面（25 个）

页面	路径	说明
assignment	pages/assignment/index	三本账分工
badge	pages/badge/index	成长地图
case	pages/case/index	案例授权
class	pages/class/index	进班
course/detail	pages/course/detail	课程主页
enroll/list	pages/enroll/list	课程报名
enroll/form	pages/enroll/form	报名信息
group/index	pages/group/index	我的小组
group-order/index	pages/group-order/index	团报
group-order/create	pages/group-order/create	发起团报
group-order/detail	pages/group-order/detail	团报详情
login	pages/login/index	登录页（已移除，改为首页浮层）
material	pages/material/index	课前资料
pay/index	pages/pay/index	确认支付
pay/result	pages/pay/result	支付结果
plan	pages/plan/index	行动计划
roadmap	pages/roadmap/index	路演材料
salon/list	pages/salon/list	沙龙活动
salon/form	pages/salon/form	沙龙报名
scoreboard	pages/scoreboard/index	积分榜
share/index	pages/share/index	我的海报
share/stats	pages/share/stats	我的邀请
survey	pages/survey/index	兴趣调研
teaching	pages/teaching/index	教学卡
upload	pages/upload/index	成果上传
verify	pages/verify/index	校友身份校验
vote	pages/vote/index	路演投票

---

后端接口

学员端接口（19 个）

控制器	说明
AuthController	登录认证
WxAuthController	微信登录
BadgeController	徽章管理
AssignmentController	三本账分工
CaseController	学员案例
CertVerifyController	证书查验
ClassController	班次管理
CourseController	课程管理
EnrollmentController	报名管理
GroupController	小组管理
GroupOrderController	团报管理
InviteController	转介绍
MaterialController	课前资料
OrderController	订单支付
PlanController	行动计划
SalonController	沙龙管理
SubmissionController	成果上传
UploadController	文件上传
VoteController	两轮投票

管理端接口（12 个）

控制器	说明
AdminAuthController	管理员登录
AdminBadgeController	徽章管理
AdminBizController	业务管理
AdminCaseController	案例管理
AdminClassController	班次管理
AdminCourseController	课程管理
AdminGroupOrderController	团报管理
AdminMaterialController	资料管理
AdminReviewController	审核管理
AdminSalonController	沙龙管理
AdminScreenController	投屏配置
AdminStatsController	统计分析

---

管理后台路由

路由	说明
/login	登录页
/screen	课程现场投屏
/dashboard	数据看板
/courses	课程管理
/classes	班次管理
/salons	沙龙管理
/enrollments	报名管理
/orders	订单管理
/group-orders	团报管理
/cases	案例管理
/groups	小组管理
/invites	转介绍管理
/materials	资料管理
/users	学员管理
/review/submissions	成果审核
/review/cards	教学卡审核
/review/roadmaps	路演审核
/scoreboard	积分榜
/manual-score	手动积分
/stats	统计分析

---

开发规范

编码硬约束

后端规范

1. 接口统一 @PostMapping：禁止使用 @GetMapping、@PutMapping、@DeleteMapping
2. 依赖注入用 @Resource：禁止使用 @Autowired，字段名 = 类名首字母小写
3. 响应统一 Result<T>：所有接口返回 com.train.common.Result 格式
4. 分层架构：Controller → Service → Mapper，禁止 Controller 直接操作 Mapper
5. 金额字段用整数：单位为"分"，禁止使用 double / float

前端规范（小程序）

1. Vue2 Options API：禁止使用 Composition API
2. 禁止可选链：使用 && 替代 ?.
3. 禁止 CSS Grid：使用 flexbox
4. 禁止 :key 运算符：使用方法调用 :key="getItemKey(item)"
5. 禁止 :class 方法调用：不能在 :class 绑定中调用方法
6. 禁止 new Date(string)：使用 parseDate() 解析时间
7. 禁止 CSS 中文类名：类名/选择器不能包含中文

数据库规范

• 迁移脚本必须幂等（重复执行不报错）
• 加列/建表/索引用 try-catch 忽略"已存在"错误
• 每次迁移后同步更新 schema.sql 的完整定义

时间显示规范

• 后端返回 ISO 8601 格式（2026-08-15T14:30:00）
• 展示时间：yyyy-MM-dd HH:mm:ss
• 仅日期：yyyy-MM-dd
• 禁止使用 new Date(str).toLocaleString()

---

外部依赖与阻塞项

编号	依赖项	影响范围	状态
CR-004	校友白名单/邀请码数据	阻塞首课报名	待提供
CR-023	L0 招生海报真实报名二维码	阻塞招生	待提供
CR-024	浠艾福菌群/DNA 脱敏样本 3-5 份	阻塞首课	待提供
CR-026	商标检索 + 域名排查 + 英文名定稿	阻塞品牌对外	待确认

---

Git 工作流

仓库信息

• 远程地址：http://git.iwintrue.com/liaoxg/caremate.git
• 主分支：master

提交规范

1. Commit Message 格式：中文 Conventional 风格

   Phase6: 徽章与成长体系
   登录统一: 浮层登录+全局守卫+storage兜底
   

2. 提交流程：

   git status                    # 确认改动范围
   git diff                      # 检查具体变更
   git add <目标文件>            # 只 stage 目标文件
   git diff --cached --stat      # 确认 staged 内容
   git commit -m "PhaseX: 描述"  # 提交
   

3. 编译验证：

   cd train-backend && mvn clean compile  # 编译通过即提交
   

注意事项

• JWT 密钥已与 cfc 对齐，不要改回独立密钥
• 品牌名固定为「爱伴·AI之旅」（CareMate · AI Journey），勿回退为旧称
• 本机 MySQL 通常不可达，编译通过就提交，不要因连不上库而卡住

Windows/PowerShell 编码陷阱

PowerShell 把 UTF-8 当 GBK 解码，git diff / 终端输出的中文会显示为乱码——是假乱码。判断文件编码/JSON 合法性用 Node 或 read/grep 工具，不要信 PowerShell 的显示。

---

产品愿景

V3.3 解决方案要点

1. 沙龙做引流：4 类主题轮播 + 半日制 20 分钟流程，比做产物划算
2. 模块化教学：L1/L2 模块化半天制 + L0 高频滚动（每周 ≥ 4 期），降低报名门槛
3. 插班制：模块化能成立的唯一前提
4. 五段位成长主线：见习 → 启航 → 专精 → 系统师 → 讲师
5. 徽章体系：32 枚徽章（12 模块 + 5 课程 + 6 技能 + 5 里程碑 + 4 讲师）
6. 讲师资格阶梯：T1-T4（评教/合规笔试 2 年有效/课时费 200-1200）

完整漏斗

沙龙引流 → L0 高频（家立方-AI管家成长营）
         → L1 模块化 → L2 系统 → L3 陪跑 → L4 讲师

---

文档

详细设计文档、SRS 需求规格、需求变更记录、合规核查结果等，参见 docs/ 目录。

AI Agent 工作规范参见 AGENTS.md。

---

最后更新：2026-09