feat: scaffold personal progress monitor MVP

This commit is contained in:
MobKBK
2026-08-24 06:18:21 +08:00
commit 094e03f341
21 changed files with 1480 additions and 0 deletions

22
需求记录.md Normal file
View File

@@ -0,0 +1,22 @@
# 个人进度监视系统需求记录
## 已冻结的 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、多副本的分布式锁和更强一致性压力测试。
- 自定义布局编辑器、更多图表和提醒通知。
- 细化周/月目标的跨周期统计与时区偏好设置。