tennis-training-hub/docs/CHANGELOG.md

Tennis Training Hub - 变更日志

v2.0.0 (2026-03-14)

新增功能

• 社区排行榜：支持按NTRP评分、训练时长、训练次数、击球数四种维度排名
• 每日打卡系统：日历视图展示打卡记录，自动计算连续打卡天数
• 成就徽章系统：24种成就徽章，涵盖里程碑、训练、连续打卡、视频、分析、评分6个类别
• 实时摄像头分析：支持手机/电脑摄像头实时捕捉和MediaPipe姿势分析
• 摄像头位置确认提示：引导用户调整摄像头到最佳位置
• 在线录制系统：稳定压缩流录制，自适应码率1-2.5Mbps
• 断线自动重连：摄像头意外断开时自动检测并重新连接
• 自动剪辑功能：基于运动检测自动标记关键时刻
• 移动端全面适配：安全区域、触摸优化、横屏支持
• 手机摄像头优化：前后摄像头切换、自适应分辨率

数据库变更

• 新增 daily_checkins 表
• 新增 user_badges 表
• users 表新增 currentStreak、longestStreak、totalShots 字段

测试

• 测试用例从15个增加到47个
• 新增打卡、徽章、排行榜相关测试

文档

• 新增完整README.md
• 新增API接口文档
• 新增数据库设计文档
• 新增功能列表清单
• 新增代码规范文档
• 新增变更日志

---

v1.0.0 (2026-03-14)

初始版本

• 用户名简单登录系统
• AI训练计划生成（初/中/高级）
• 视频上传功能（webm/mp4）
• MediaPipe浏览器端姿势识别
• 姿势矫正建议系统（AI生成）
• 训练计划自动调整
• NTRP自动评分系统（五维度加权）
• 训练进度追踪（可视化图表）
• 视频库管理
• 击球次数统计
• 挥拍速度估算
• 运动轨迹可视化
• 帧级别关键时刻标注
• 球员统计面板

数据库

• 初始9张表设计
• Drizzle ORM集成
• 3次数据库迁移

测试

• 15个核心功能测试