feat: complete task management workflow

docs/decisions.md

@@ -0,0 +1,113 @@
+# dodo 产品与技术决策记录
+
+## 定位
+
+dodo 是一个纯自托管的 TickTick-like 任务与习惯管理工具。目标不是一比一复刻 TickTick，而是做一个数据归自己、界面温暖紧凑、适合个人长期使用的任务系统。
+
+## 当前边界
+
+- 首版只做本地开发验证，不部署。
+- 首版不做通知渠道：Web Push、Telegram、SMTP 暂不实现。
+- 首版附件只做本地存储，不实现 S3。
+- 首版不做番茄钟。
+- 首版不做自然语言创建任务。
+
+## 技术栈
+
+- Monorepo：`frontend/`、`backend/`、`worker/`
+- 前端：Vue 3 + TypeScript + Vite + Tailwind CSS + Shadcn-vue/Reka UI
+- 后端：FastAPI + Pydantic v2 + SQLAlchemy 2 Async + Alembic
+- 数据库：PostgreSQL，主键 UUIDv7，时间统一 UTC，用户配置时区
+- 后台：独立 Worker + APScheduler
+- 包管理：uv + pnpm
+- 交付：单 Docker 镜像，外部 PostgreSQL
+- 许可证：AGPL-3.0
+
+## 数据库
+
+本地开发数据库：
+
+```text
+postgresql+asyncpg://postgres:***@10.10.100.99:5433/dodo
+```
+
+已从默认 `postgres` 库迁移到独立 `dodo` 库。误建在 `postgres.public` 的 dodo 表已清理。
+
+## 产品模型
+
+### 任务
+
+- 文件夹 → 清单 → 任务
+- 系统内置收集箱，不允许删除
+- 任务支持一层子任务
+- 状态：未完成 / 已完成
+- 优先级：无 / 低 / 中 / 高
+- Markdown 描述
+- 截止日期 + 具体时间
+- 多提醒设计预留
+- 全局彩色标签
+- 删除为软删除，回收站手动清空
+- 支持创建、修改、完成、恢复、删除操作历史
+- 并发编辑使用原子乐观锁
+
+### 重复任务
+
+- RFC 5545 RRULE
+- 模板 + 实例
+- 修改范围：仅本次 / 本次及以后 / 全部
+- 删除单次保存为例外
+- 每月 31 日在无 31 日月份跳过
+- 逾期完成不影响下次计划日期
+
+### 习惯
+
+- 完成型 + 数值型
+- 每天 / 每周 / 每月 / 间隔天数
+- 数值型当日累计，达标后封顶
+- 允许补打和修改历史
+- 支持暂停区间，暂停期不破坏连续记录
+- 归档后保留历史统计
+
+## UI 方向
+
+- 手账生活感
+- 中高信息密度
+- 10–12px 中等圆角
+- 细分割线为主，少量浅底色
+- 强调色：`#F15A29`
+- 只做浅色模式
+- 系统字体栈
+- 不使用猫猫元素
+- 轻微动效
+
+## 页面结构
+
+- 桌面三栏：左导航 / 中任务列表 / 右任务详情
+- 手机底部导航
+- 顶部快速输入，手机悬浮新增按钮
+- 桌面右侧详情栏，手机底部弹层
+- 日历默认月视图
+- 习惯首页：今日习惯列表 + 一周打卡格
+- 搜索：顶部搜索框 + 全局搜索快捷键
+
+## 工程质量
+
+- `/api/v1` API 路径
+- 统一错误码、可读提示和字段详情
+- 页面内诊断信息 + Toast
+- readiness 检查数据库
+- 首版不提供 Prometheus metrics
+- 审计日志记录操作人、实体、动作、时间和变更摘要
+- 手动 JSON 全量导出
+- 附件默认 20MB，可用环境变量调整
+- 默认允许常用文档与图片，拒绝危险文件类型
+
+## 第一阶段验收
+
+- 可初始化管理员
+- 可登录
+- 可创建清单和任务
+- 后端测试通过
+- 前端生产构建通过
+- PostgreSQL 迁移成功
+- 本地应用可以启动并访问