Earthworm 项目中课程进度存储方案的技术演进

背景与需求分析

在在线学习平台 Earthworm 的实际使用场景中，用户经常面临跨设备学习的需求。典型场景是用户在公司完成了部分课程内容后，希望回家继续学习，但发现学习进度无法同步。这种体验断裂严重影响了用户的学习连贯性和积极性。

原有方案分析

项目最初采用前端本地存储（localStorage）来保存课程进度，这种方案存在几个明显缺陷：

1. 数据无法跨设备同步
2. 浏览器清除缓存会导致进度丢失
3. 缺乏集中式的进度管理能力

技术方案设计

核心需求

1. 实现用户课程进度的持久化存储
2. 支持多设备间进度同步
3. 保持系统性能不受显著影响

数据库设计

在 course-history 表中新增 progress 字段，用于记录用户在当前课程中的具体进度。该设计需考虑：

• 字段类型选择（建议使用 JSON 或特定格式字符串）
• 与现有 CompletionCount（完成次数）字段的关系处理
• 索引优化策略

服务端实现

1. 进度上报机制：

   • 采用节流(throttle)技术控制上报频率
   • 支持批量更新减少数据库压力
   • 实现乐观更新策略提升用户体验

2. 数据同步方案：

   • 客户端启动时拉取最新进度
   • 采用版本号或时间戳解决冲突
   • 实现增量同步减少数据传输量

技术挑战与解决方案

进度存储时机

最初考虑每次题目切换都存储的方案会带来较大性能压力，优化方案包括：

1. 采用防抖(debounce)技术，在用户停止操作后统一提交
2. 重要节点（如章节完成）强制提交
3. 本地缓存与远程存储的协同机制

数据一致性

为确保多设备间的数据一致性，实现方案：

1. 基于时间戳的最后写入获胜策略
2. 客户端缓存失效机制
3. 服务端数据校验

架构演进

最终方案调整为"一个课程包只存储一个课程的进度"，这种设计：

1. 简化了数据结构
2. 减少了数据库操作
3. 更符合用户实际使用场景

性能考量

1. 数据库查询优化：为常用查询路径添加适当索引
2. 缓存策略：对热点数据使用Redis缓存
3. 异步处理：非关键路径采用异步写入

用户体验提升

1. 进度可视化：清晰展示学习进度
2. 冲突提示：当多设备同时修改时给予用户提示
3. 离线支持：在网络不稳定时仍能记录进度

总结

Earthworm 项目通过将课程进度存储迁移到数据库，解决了用户跨设备学习的关键痛点。这一技术演进不仅提升了用户体验，也为后续的学习数据分析、个性化推荐等功能奠定了基础。方案设计中平衡了数据实时性与系统性能的关系，采用了多种优化技术确保系统稳定运行。