Files
personal-progress-monitor/需求记录.md
2026-08-24 06:18:21 +08:00

1.5 KiB
Raw Blame History

个人进度监视系统需求记录

已冻结的 MVP

  • 服务器可部署、可远程访问;Docker Compose 默认绑定本机端口,生产使用反向代理和 HTTPS。
  • JSON 是主存储契约,不把运行数据提交到 Git;单 worker/单副本。
  • 分层 JSON:任务当前定义、任务修订、每日事实、可重建月归档;原始事实不因归档被移动或删除。
  • 任务使用稳定 UUID;默认软删除;改名或修改属性保留 taskRevision,后台支持恢复和确认后永久删除。
  • metrics[] 可并存 checkin、quantity、duration;周期 day/week/month/lifetime;target: null 表示无上限;duration 使用整数秒。
  • 创建、编辑、删除、恢复、排序;字段包括名称、起止日期、优先级 1-5、状态和描述。
  • 每日记录支持一键打卡、数量、时长、心得和完成时间;修改记录带版本冲突检测。
  • 首页与任务详情分别读取独立布局 JSON;布局组件白名单校验,禁止动态执行。
  • 中文响应式 UI:左侧任务列表和拖放排序,右侧任务详情、热力图、多指标进度和今日记录。
  • 可选单用户密码会话认证、HttpOnly 会话 Cookie、基本 CSRF 校验。

后续路线图

  • 备份/恢复向导与定期快照。
  • 多 worker、多副本的分布式锁和更强一致性压力测试。
  • 自定义布局编辑器、更多图表和提醒通知。
  • 细化周/月目标的跨周期统计与时区偏好设置。