# Tennis Training Hub - 变更日志

## v3.0.0 (2026-03-14)

### 新增功能

- **训练视频教程库**：分类浏览（正手/反手/发球/截击/脚步/体能），含要点说明和常见错误
- **教程自评系统**：星级自评、学习笔记、已学标记、学习进度追踪
- **训练提醒通知**：支持训练/打卡/分析多类型提醒，自定义时间和重复日期
- **浏览器通知推送**：Notification API集成，权限管理和状态提示
- **通知记录管理**：未读计数、全部标记已读、历史记录浏览
- **文案优化**：去除“在家”等冗余描述，简化为直接信息反馈

### 数据库变更

- 新增 `tutorial_videos` 表（教程视频库）
- 新增 `tutorial_progress` 表（学习进度追踪）
- 新增 `training_reminders` 表（训练提醒设置）
- 新增 `notification_log` 表（通知记录）

### 测试

- 测试用例从47个增加到65个
- 新增教程库、提醒、通知相关测试

---

## 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个核心功能测试