diff --git a/FRONTEND_CHECKLIST.md b/FRONTEND_CHECKLIST.md new file mode 100644 index 0000000..07c4d63 --- /dev/null +++ b/FRONTEND_CHECKLIST.md @@ -0,0 +1,111 @@ +# 前端修改检查清单 + +_⚠️ **每次修改前端代码前必须阅读,修改后必须逐项验证**_ + +--- + +## 📋 修改前准备 + +- [ ] 已查看 `FEATURES.md` 了解所有已实现功能 +- [ ] 已查看当前 `index.html` 的完整代码 +- [ ] 已创建 git 备份分支:`git branch backup-$(date +%Y%m%d-%H%M)` +- [ ] 已在功能分支开发:`git checkout -b feature/xxx` + +--- + +## ✅ 修改后验证清单 + +### 核心功能(P0 - 必须全部通过) + +#### 1. 日历组件 ⭐⭐⭐ **最重要** +- [ ] 日历正常显示当前月份 +- [ ] 星期标题显示(日一二三四五六) +- [ ] 今天的日期高亮显示 +- [ ] 有日记的日期显示 📝 图标 +- [ ] **点击日期能显示当天日记**(最关键!) +- [ ] 无日记的日期显示友好提示 +- [ ] 上月按钮正常工作 +- [ ] 下月按钮正常工作 +- [ ] 非当月日期灰色显示 + +**测试方法**: +```bash +# 1. 打开页面 http://cssc.datalibstar.com:8001/ +# 2. 检查日历是否正常显示 +# 3. 点击今天的日期,查看日记详情 +# 4. 点击有日记的其他日期 +# 5. 点击没有日记的日期 +# 6. 切换上月/下月 +``` + +#### 2. 统计面板 +- [ ] 总日记数显示正确 +- [ ] 总任务数显示正确 +- [ ] 进行中任务数显示正确 +- [ ] 已完成任务数显示正确 +- [ ] 完成率显示正确 +- [ ] 经验总结数显示正确 + +**测试方法**: +```bash +curl http://cssc.datalibstar.com:8001/api/entries/stats/ +curl http://cssc.datalibstar.com:8001/api/experiences/recent/ +``` + +#### 3. Tab 切换 +- [ ] 工作任务 Tab 正常切换 +- [ ] 日记 Tab 正常切换 +- [ ] 经验总结 Tab 正常切换 +- [ ] 切换后内容正确显示 + +**测试方法**: +```bash +# 1. 打开页面 +# 2. 依次点击每个 Tab +# 3. 检查内容是否正确切换 +``` + +#### 4. 日记列表 +- [ ] 日记列表正常显示 +- [ ] 每条日记显示日期 +- [ ] 日记内容完整显示(完成任务、学到的东西等) + +#### 5. 经验总结列表 +- [ ] 经验总结正常显示 +- [ ] 分类标签显示正确 +- [ ] 问题/解决方案格式正确 +- [ ] 经验教训高亮显示 + +--- + +## 🚨 禁止操作 + +- [ ] ❌ 直接覆盖 `index.html` 而不查看原有内容 +- [ ] ❌ 删除任何 `