47 lines
3.1 KiB
Markdown
47 lines
3.1 KiB
Markdown
# dodo 数据模型
|
|
|
|
业务主键使用 UUIDv7；带 `user_id` 的实体按用户隔离。时间点按 UTC 保存，用户时区用于日期语义与展示。生产使用 PostgreSQL，测试使用 SQLite。
|
|
|
|
## 账户
|
|
|
|
- `app_state`：初始化状态
|
|
- `users`：用户名、密码散列、时区
|
|
- `sessions`：会话令牌散列、过期/最近访问时间、IP 与 User-Agent
|
|
- `audit_logs`：用户、动作、实体、非敏感摘要和时间
|
|
|
|
## 任务域
|
|
|
|
- `folders`：名称、位置、软删除时间；删除文件夹只解除清单分组
|
|
- `task_lists`：文件夹、名称、收集箱标记、位置、软删除时间
|
|
- `tasks`：清单、可空父任务、标题、Markdown 描述、优先级、完成/完成时间、截止时间、`due_has_time`、位置、版本、软删除与外部 ID
|
|
- `recurrence_templates`：任务的一对一重复规则、开始/结束、计划或完成后触发模式、完成后间隔与最近完成时间
|
|
- `recurrence_exceptions`：模板发生时间及标题/截止/完成/删除覆盖
|
|
- `attachments`：任务、原始文件名、服务端存储名、MIME、大小和创建时间
|
|
- `purge_operations`：清单永久删除时附件隔离区清理的补偿状态
|
|
|
|
任务树只允许一层，父子任务属于同一清单。清单归档仅设置清单 `deleted_at`，保留所有任务的 `list_id`；查询隐藏归档清单内任务，恢复清单后原任务和完成状态重新可见。任务与子任务软删除/恢复按生命周期规则处理，永久删除会清理关联重复数据和附件。
|
|
|
|
## 习惯、倒数日与备忘录
|
|
|
|
- `habits`：完成型/数值型、目标/上限、日/周/月/间隔计划、开始日、排序和归档
|
|
- `habit_logs`：习惯与日期唯一的数值记录
|
|
- `habit_pauses`：习惯暂停区间
|
|
- `countdowns`：标题、日期、公历/农历字段、类型、重复、兼容保留的图标字段、置顶与归档
|
|
- `memos`：标题、Markdown 内容、乐观锁版本、创建/更新时间和软删除时间
|
|
|
|
## 完整备份 v2 内部状态
|
|
|
|
- `backup_preflights`：令牌散列、用户、备份 ID/摘要/大小、暂存路径、模式、状态、过期/消费时间和待清理路径
|
|
- `backup_imports`：每用户已导入备份 ID、归档摘要、模式和时间；用于幂等判断
|
|
- `backup_import_entities`：源实体 ID 到目标 ID 的映射及内容摘要；用于 merge 冲突检测与可重试导入
|
|
|
|
这些表和账户/会话/审计信息不属于用户可迁移业务实体。ZIP v2 只导出：
|
|
|
|
`folders`、`lists`、`tasks`、`recurrences`、`recurrence_exceptions`、`habits`、`habit_logs`、`habit_pauses`、`countdowns`、`memos`、`attachments`。
|
|
|
|
附件导出时去掉内部 `storage_name`，改用归档内安全路径并携带真实字节；恢复时生成目标存储名。每个实体文件和附件字节均由 manifest SHA-256 覆盖。
|
|
|
|
## 迁移
|
|
|
|
迁移按 `0001` 至 `0019` 顺序应用；当前最新 `0019_backup_imports.py` 增加完整备份预检、导入及实体映射账本。历史迁移还覆盖任务管理、会话元数据、查询索引、习惯排序、倒数日/农历、日期型截止语义、重复触发模式、备忘录与 `completed_at` 等演进。
|