# dodo

一个自托管、移动端友好的任务与生活管理 PWA，数据由自己掌控。

## 当前主要能力

- 文件夹、收集箱与自定义清单；清单归档后保留任务归属，恢复后原样可见
- 任务与一层子任务、优先级、Markdown 备注、日期/时间、回收站、拖拽排序
- RFC 5545 计划重复与“完成后重复”；乐观锁避免并发覆盖
- 今日页按逾期任务、今日任务、今日习惯分组，并提供进度与环境信息
- 完成型/数值型习惯、日/周/月/间隔计划、暂停、历史与归档
- 倒数日、纪念日、生日及公历/农历重复
- Markdown 备忘录及软删除/恢复
- 任务附件、登录设备管理与审计日志
- 完整 ZIP v2 备份（含附件字节、manifest 与 SHA-256）及预检后合并/替换恢复
- 兼容旧版 CSV / JSON v1 恢复

## 界面约定

- 弹层统一使用 `AppSheet` / `AppDialog`，共享遮罩、焦点陷阱、Escape、背景 inert 和嵌套栈行为
- 设置页按“数据、账户与安全、登录设备、活动、危险操作”连续分组
- 手机底栏直接进入今天、习惯、倒数日、设置，不再使用“更多”中转
- 新增入口是普通的圆形 Plus FAB，共用于任务、习惯、倒数日和备忘录

## 技术栈

- Frontend: Vue 3 + TypeScript + Vite + Tailwind CSS
- Backend: FastAPI + Pydantic v2 + SQLAlchemy 2 Async + Alembic
- DB: PostgreSQL（测试使用 SQLite）
- Package: uv + pnpm

## 本地开发

```bash
cd /Users/bboysoul/PycharmProjects/dodo
uv sync
uv run uvicorn backend.main:app --host 0.0.0.0 --port 8781

cd frontend
pnpm install
pnpm run dev
```

配置项见 [`.env.example`](.env.example)，API 与数据合同见 [`docs/api.md`](docs/api.md) 和 [`docs/data-model.md`](docs/data-model.md)。

## 验证

```bash
uv run ruff check backend tests
uv run pytest -q
cd frontend
pnpm test
pnpm build
cd ..
git diff --check
```