脑科学与认知训练类课程的教学流程与普通课程不同,训练任务要按次记录,作答与测评结果要能回溯到具体哪一次
项目概览
项目背景
这是一套脑科学方向的教育产品与教学平台,共 11 个仓库,覆盖 2021 至 2023 年。后端为 Java 编写,包含 284 个 Java 文件,PC 端有两代版本;教学前端为 Vue,多套版本并行迭代,单套最多包含 173 个 Vue 文件,另有静态页面。后端基于成熟开源框架自研业务层。PC 端存在两代版本这一事实本身,也说明产品在教学场景里经历过比较大的方向调整。
客户当时的状态
脑科学与认知训练类课程和普通课程不一样,它的价值在过程里:训练任务要按次完成,作答与测评结果要能对应到具体哪一次。这类项目在推进中容易出现两个问题。一是记录粒度太粗,只留汇总值,教学方回看时看不出哪一次出了状况;二是版本太多——PC 端两代并存,教学前端又有多个版本同时迭代,如果业务规则散在各端,同一批数据会出现两种算不清的口径。
我们的做法与取舍
第一个取舍是把训练任务与作答记录收敛到后端,前端只负责呈现与交互。代价是前端改动也要走后端联调,收益是记录口径唯一,任何一端看到的都是同一份数据。
第二个取舍是接受多版本前端并行,用统一接口约束它们,而不是立刻合并代码。合并的回归成本高、影响面难枚举,接口统一才是更现实的收敛路径。
第三个取舍是把技术来源说清楚。后端基于成熟开源框架搭建,业务层是我们自研的,对外统一表述为「基于成熟开源框架自研业务层」——把开源框架说成自研,短期好看,长期是隐患。
系统怎么承载这条链路
接入层是 PC 端两代、多套教学前端与静态页面;业务层承载课程章节、训练任务下发与作答测评记录;数据层保存作答与测评结果。各版本前端接入同一套接口,训练记录只有一份,不随端变化。版本之间的差异主要体现在界面组织与使用习惯上,记录部分共用同一套数据。
交付状态与边界
仓库覆盖到 2023 年,最近一次提交在 2023 年(具体月份未披露),目前没有再更新的记录。边界说明:课程内容与教研方法由客户方教研团队负责,我们负责系统承载;训练效果的评价结论解释权在教学方,系统只提供记录与统计能力;教学硬件设备不在开发范围。另外如实说明,后端基于成熟开源框架自研业务层,不存在所谓自研框架。
项目信息
某脑科学教育产品项目
教育与培训
未披露
Java(后端业务层,284 个 Java 文件;PC 端两代)/ Vue(多套教学前端,单套最多 173 个 Vue 文件)/ HTML
教育产品与教学平台
CHALLENGES
客户当时面对的现实
PC 端存在两代版本,教学前端又有多个版本并行迭代,改一处要判断影响哪些端
训练记录、作答记录与测评结果的口径必须唯一,分散在各端就会出现同一批数据两种说法
教学方向由教研决定,系统只负责承载,这个分工如果在设计阶段不清楚,后面会反复返工
CAPABILITIES
我们交付的能力
训练类课程的关键是每次训练都能回溯
教学流程承载
课程、章节与训练任务按教学流程组织,任务下发与完成情况可查。
训练与作答记录
每次训练任务的作答与测评结果落库,可以回溯到具体一次训练,而不是只有汇总值。
多版本前端并行
PC 端两代与多套教学前端并行迭代,通过统一接口约束各版本,数据口径不分叉。
业务层自研
后端基于成熟开源框架自研业务层,教学流程与记录逻辑由我们实现。
SCOPE
交付范围
以下范围按本项目实际交付内容与边界整理,不属于这次范围的部分一并列出。
已交付
- 教学流程与训练任务系统(Java 后端业务层)
- 训练作答与测评记录
- PC 端两代应用
- 多套教学前端(Vue)与静态页面(HTML)
- 统一数据接口
不在本次范围
- 课程内容与教研方法:由客户方教研团队负责,我们负责系统承载
- 训练效果的评价结论:解释权在教学方,系统只提供记录与统计能力
- 教学硬件设备:如需配套设备,由贵方按教学方案采购
ARCHITECTURE
分层技术架构
公开口径归纳为三层:接入层是 PC 端两代、教学前端与静态页面;业务层承载课程、训练任务与作答记录;数据层保存作答与测评结果,保证记录可回溯。
接入层
覆盖不同时期的教学使用场景
业务层
承载训练类教学流程,记录粒度落到每一次训练
数据层
让训练过程可回溯、口径唯一
DELIVERY
交付过程
分阶段推进,每个阶段都有可验收的产出,客户在早期就能看到实际效果。
教学流程与记录口径
梳理课程、训练任务与作答环节,确定记录粒度与口径。
后端业务层
基于成熟开源框架搭建后端,实现教学流程与记录逻辑。
PC 端与教学前端
PC 端两代与多套教学前端接入统一接口,按版本并行迭代。
版本收敛与交付
统一数据接口约束各版本,完成交付范围内的版本整理。
FACTS
可核验的交付事实
以下内容来自本项目实际交付物;未经验证的指标不予展示。
覆盖教学平台与配套前端
后端业务层代码规模
单套教学前端的最大文件数
TRANSFER
这套做法适不适合你
案例的用处不是证明"我们做过",而是让你判断"在我们这种条件下能不能做成"。下面三句是我们对这一单的判断,写下来供你对照自己的情况。
适合什么情况
适合教学环节包含反复训练与测评、且需要按次留痕的教育类产品。
什么情况下别照搬
若课程只是单向内容播放、没有训练与作答环节,按次记录属于过度设计;教研方法与课程内容不在开发范围内。
如果要试,第一步做什么
先把教学流程拆成可记录的动作清单,明确记录粒度。
RELATED SERVICES
相关服务
从实际业务问题出发,查看对应服务的适用场景、交付物与不含项;具体范围仍需单独确认。
FAQ
常见问题
以下是同类项目沟通中出现频率最高的问题,答案就是我们实际的做法。
为什么训练记录要做到「按次」?
多套前端版本并行不是很乱吗?
后端是你们自己写的框架吗?
系统现在还在维护吗?
做教学类平台第一步做什么?
本页最后更新:2026年9月24日