diary-system/FEATURES.md

日记系统 - 功能清单

最后更新：2026-04-15

---

✅ 已实现功能

后端 API

日记模块 (/api/entries/)

• GET / - 获取所有日记
• GET /{id}/ - 获取单条日记
• POST / - 创建日记
• PUT /{id}/ - 更新日记
• DELETE /{id}/ - 删除日记
• GET /today/ - 获取今天的日记
• GET /recent/ - 获取最近 7 天的日记
• GET /stats/ - 获取统计信息

经验总结模块 (/api/experiences/)

• GET / - 获取所有经验
• GET /{id}/ - 获取单条经验
• POST / - 创建经验
• PUT /{id}/ - 更新经验
• DELETE /{id}/ - 删除经验
• GET /recent/ - 获取最近 10 条经验
• GET /by_category/ - 按类别分组

进度追踪模块 (/api/progress/)

• GET / - 获取所有进度
• GET /{id}/ - 获取单条进度
• POST / - 创建进度
• PUT /{id}/ - 更新进度
• DELETE /{id}/ - 删除进度

前端页面

统计面板

• 总日记数
• 总任务数
• 进行中任务
• 已完成任务
• 完成率
• 经验总结数

日历组件 ⭐

• 月历视图
• 有日记的日期标记 📝
• 今天高亮显示
• 点击日期查看详情
• 上月/下月切换
• 星期标题

Tab 切换

• 工作任务 Tab
• 日记 Tab
• 经验总结 Tab

日记展示

• 日历视图（主视图）
• 列表视图
• 详情展示
• 日期选择

经验总结展示

• 列表展示
• 分类标签
• 问题/解决方案格式
• 经验教训高亮

数据模型

DiaryEntry

• date - 日期
• title - 标题
• completed_tasks - 完成的任务
• learned - 学到的东西
• problems - 遇到的问题
• reflections - 想法和反思
• improvements - 进步点
• plans - 明日计划
• created_at - 创建时间
• updated_at - 更新时间

Experience

• title - 标题
• category - 类别（deployment/development/database/permission/network/other）
• problem - 问题描述
• solution - 解决方案
• lesson_learned - 经验教训
• date - 日期
• created_at - 创建时间

DailyProgress

• entry - 关联日记
• category - 类别
• description - 描述
• progress_percent - 进度百分比
• created_at - 创建时间

部署

本地部署

• Gunicorn 服务（端口 8002）
• Nginx 反向代理（端口 8001）
• PostgreSQL 数据库

云服务器部署

• Gunicorn systemd 服务
• Nginx 反向代理
• SQLite 数据库
• 访问地址：http://cssc.datalibstar.com:8001/

---

🚧 计划功能

• 日记创建/编辑表单
• 经验总结创建表单
• 搜索功能
• 数据导出（Markdown）
• 用户认证
• 数据备份

---

📝 修改检查清单

每次修改代码前，对照此清单确保不丢失功能：

• 日历组件是否正常
• 统计面板数据是否正确
• Tab 切换是否正常
• 日记列表是否显示
• 经验总结是否显示
• API 接口是否可用
• 云服务器是否同步更新

---

此文档必须在每次功能变更后更新