千夜网 · 公网文档 · 实施与运维
研学 + 教育 · 运维手册（骨架）
研学内容以老师生产为核心，系统要提供可控的发布、审核、版本与统计能力；并支持线下活动的离线回传与数据对账。
内容发布与审核
知识点管理
- 按课标/教材版本维护，支持草稿/发布/回滚
- 记录知识点来源与版权信息
- 支持批量导入与导出
- 定期更新知识点库
POI ↔ 知识点锚定
- 提供排序、适龄范围、建议时长与关联活动模板
- 支持批量关联与批量调整
- 可视化编辑器，便于操作
- 审核流程：编辑 → 审核 → 发布
个性化复盘
- 可用 AI 辅助生成，但必须“发布前人工审核”
- 按学科模板生成复盘草稿
- 支持用户修改与确认
- 审核标准：内容准确性、版权合规、适龄性
线下活动数据对账
离线缓存与补传
- 端上按 event 流存储，恢复网络后批量补传
- 支持断点续传，确保数据不丢失
- 补传状态实时反馈给用户
- 定期清理已成功补传的本地缓存
幂等设计
- 服务端按 idempotency_key 去重，避免重复打卡/重复奖励
- 客户端生成唯一 UUID 作为幂等键
- 幂等键有效期：30 天
- 重复请求返回相同结果，不重复处理
统计口径
- 完成率：完成任务数 / 总任务数
- 到点率：实际到达 POI 数 / 路线 POI 数
- 学习时长：累计学习时间
- 复盘提交率：提交复盘数 / 参与人数
- 补传成功率：成功补传事件数 / 总补传事件数
运行监控
活动日高峰监控
- 回传队列堆积情况
- 补传失败率
- 补传延迟时间
- 系统资源使用情况
内容侧监控
- 内容发布频率
- 内容被退回次数
- 版本回滚次数
- 知识点更新频率
告警机制
- 补传失败率 > 10% 时告警
- 回传队列堆积 > 1000 条时告警
- 系统资源使用率 > 80% 时告警
- 内容审核积压 > 24 小时时告警
运维最佳实践
活动前准备
- 提前导入知识点与路线数据
- 测试离线补传功能
- 检查系统资源配置
- 制定应急方案
活动中监控
- 实时监控系统状态
- 及时处理告警
- 准备应急响应
- 收集用户反馈
活动后复盘
- 分析活动数据
- 总结经验教训
- 优化系统配置
- 更新运维手册