fix(任务): 归档以整棵树为单位并移除隐藏中间态

- 自动归档改为 doneAt + autoArchive 到期，只判定顶层任务，到期整树归档
- 手动归档/恢复提升到根父任务，子任务完全跟随父任务
- 新增 normalizeArchiveTree 修复历史父子归档不一致
- 移除按列保留窗口的显示过滤（前后端实现删除，T-FL-01~15 废止）
- 列 retention 字段仅兼容旧数据保留，不再参与判定
- 已归档查询返回归档子任务，删除提示可正确显示连带条数

docs/V0.2/任务模块/任务模块数据库设计文档.md

@@ -20,7 +20,7 @@
 | --- | --- | --- |
 | `Project` | 项目（隔离与权限单位） | 项目域 |
 | `ProjectMember` | 项目成员（权限关系） | 项目域 |
-| `BoardColumn` | 看板列（名称 / 顺序 / 状态绑定 / 保留选项） | 看板域 |
+| `BoardColumn` | 看板列（名称 / 顺序 / 状态绑定；`retention` 字段已废弃） | 看板域 |
 | `Task` | 任务与子任务（自关联，一层） | 任务域 |
 | `TaskMember` | 任务成员（多人标记） | 任务域 |
 | `TaskTag` | 任务标签 | 任务域 |
@@ -29,7 +29,7 @@
 
 1. **列是实体，不是枚举。** 看板列允许增删改与排序（T-COL），若仍用 `plan/doing/action/done` 枚举，则"改名"无从表达、"排序"只能堆在 JSON 里、"删除列"会留下悬空字符串。因此独立建 `BoardColumn` 表，`Task` 用 `columnId` 外键引用。
 2. **状态与列双落库，互不推导。** `Task.status`（三值）与 `Task.columnId` 是两个正交维度；未绑定的列（默认 `Action`）必须允许二者不一致（T-BD-08、T-BD-16），任何"由状态反推列"或"由列反推状态"的写法都会丢失信息。联动只在写接口中按项目配置即时裁决。
-3. **配置不下沉到任务。** 绑定与保留选项只存在 `BoardColumn` 上，任务不冗余任何配置副本——改配置立即对所有任务生效，且不需要回填。
+3. **配置不下沉到任务。** 列-状态绑定只存在 `BoardColumn` 上，自动归档档位只存在 `Project` 上，任务不冗余任何配置副本——改配置立即对所有任务生效，且不需要回填。
 4. **按项目隔离。** 所有业务表都可通过 `projectId` 归集，权限校验统一查 `ProjectMember`。
 5. **软删除优先。** 项目用 `archived`；任务删除为级联物理删除（T-ST-11），但删除前有二次确认。
 6. **迁移只增不改。** 新增需求一律新迁移文件，不修改已执行的迁移。
@@ -131,7 +131,7 @@
 
 ### 3.3 `BoardColumn` — 看板列
 
-**本模块新增的核心实体**，承载三件事：显示顺序、状态绑定、已完成保留选项。
+**本模块新增的核心实体**，承载两件事：显示顺序、状态绑定。`retention` 字段仅为兼容旧数据保留，已不参与业务判定。
 
 | 字段 | 类型 | 空 | 默认 | 说明 |
 | --- | --- | --- | --- | --- |
@@ -140,7 +140,7 @@
 | `name` | `VARCHAR(20)` | 否 | — | 列名，项目内唯一（T-COL-07） |
 | `sortOrder` | `INT` | 否 | `0` | 显示顺序；**决定自动归位取"第一个匹配列"**（T-BD-15） |
 | `boundStatus` | `VARCHAR(8)` | **是** | `NULL` | `NULL`=不绑定；或 `todo`/`doing`/`done`（T-BD-02） |
-| `retention` | `VARCHAR(8)` | 否 | `'forever'` | `never`/`today`/`3d`/`week`/`month`/`forever`（T-FL-02） |
+| `retention` | `VARCHAR(8)` | 否 | `'forever'` | **已废弃**：仅为兼容旧数据保留，不再参与显示/归档判定 |
 | `createdAt` | `DATETIME(3)` | 否 | `now()` | — |
 | `updatedAt` | `DATETIME(3)` | 否 | — | — |
 
@@ -153,14 +153,14 @@
 
 **默认数据**（新建项目时由应用层在事务内写入，T-COL-01、T-BD-09）：
 
-| sortOrder | name | boundStatus | retention |
+| sortOrder | name | boundStatus | retention（废弃） |
 | --- | --- | --- | --- |
 | 0 | `Plan` | `todo` | `forever` |
 | 1 | `Doing` | `doing` | `forever` |
 | 2 | `Action` | `NULL` | `forever` |
 | 3 | `Done` | `done` | `forever` |
 
-> **为什么保留选项默认为 `forever` 而不是 `never`**：默认应"看得见"，避免用户误以为数据丢失；隐藏是主动行为。
+> **保留字段说明**：`retention` 默认仍为 `forever` 仅为兼容旧库；2026-11-10 起不再按列隐藏已完成任务，归档由 `Project.autoArchive` 控制。
 
 **约束与校验**
 
@@ -170,7 +170,7 @@
 | 至少保留 1 列（T-EX-17） | 应用层：删除前 count > 1 |
 | 删列必须指定迁移目标（T-EX-16） | 应用层：接口必须带 `moveToColumnId` |
 | `boundStatus` 取值合法 | 应用层白名单校验 |
-| `retention` 取值合法 | 应用层白名单校验 |
+| `retention` 字段 | 已废弃，不再校验/使用 |
 
 ### 3.4 `Task` — 任务 / 子任务
 
@@ -185,7 +185,7 @@
 | `kind` | `VARCHAR(20)` | **是** | `NULL` | 任务类型标签，取值见 `Project.taskKinds` |
 | `markDate` | `DATETIME(3)` | **是** | `NULL` | 时间标记，完整日期存储、展示 `MM-dd`（T-TK-15；迁移 20261025120000） |
 | `status` | `VARCHAR(8)` | 否 | `'todo'` | `todo`/`doing`/`done`（T-TK-03） |
-| `doneAt` | `DATETIME(3)` | **是** | `NULL` | 完成时刻；**保留选项判定依据**（T-FL-10） |
+| `doneAt` | `DATETIME(3)` | **是** | `NULL` | 完成时刻；**自动归档判定依据** |
 | `assigneeId` | `INT` | **是** | `NULL` | 负责人（单人）；新建默认创建者（T-TK-09） |
 | `creatorId` | `INT` | 否 | — | 创建人；拷贝时为操作者（T-CP-04） |
 | `extras` | `JSON` | 否 | `[]` | 扩展信息卡片 `[{label,value,url?}]`（T-TK-04/05） |
@@ -208,7 +208,7 @@
 | `idx_task_project_column` | `(projectId, columnId)` | — | 看板按列查询 |
 | `idx_task_project_status` | `(projectId, status)` | — | 列表/统计 |
 | `idx_task_parent` | `(parentId)` | — | 取子任务 |
-| `idx_task_done_at` | `(projectId, doneAt)` | — | 保留窗口计算 |
+| `idx_task_done_at` | `(projectId, doneAt)` | — | 自动归档到期计算 |
 | `idx_task_project_archived` | `(projectId, archived, archivedAt)` | — | 已归档查询（T-ARC-04） |
 | `idx_task_project_status_arch` | `(projectId, status, archived)` | — | 主列表/看板排除归档（T-ARC-03） |
 
@@ -292,7 +292,7 @@ model BoardColumn {
   name        String   @db.VarChar(20)
   sortOrder   Int      @default(0)
   boundStatus String?  @db.VarChar(8)   // null | todo | doing | done
-  retention   String   @default("forever") @db.VarChar(8)
+  retention   String   @default("forever") @db.VarChar(8) // 已废弃: 兼容旧数据
   createdAt   DateTime @default(now())
   updatedAt   DateTime @updatedAt
 
@@ -384,7 +384,7 @@ model User {
 | 项目详情 + 列 | `SELECT * FROM BoardColumn WHERE projectId=? ORDER BY sortOrder` |
 | 看板任务（含子任务） | 顶层：`WHERE projectId=? AND parentId IS NULL`；子任务：`WHERE parentId IN (...)` 一次取回后在内存分组（避免 N+1） |
 | 权限校验 | `SELECT 1 FROM ProjectMember WHERE projectId=? AND userId=?` |
-| 保留窗口过滤 | 服务端可选：`status <> 'done' OR (doneAt >= ?)`；前端另有一份同口径实现 |
+| 自动归档到期 | 顶层任务：`parentId IS NULL AND archived=0 AND status='done' AND doneAt <= now - autoArchive`；到期后整棵树一起归档 |
 | 自动归位选列 | 内存中对已加载的 `columns`（按 sortOrder）`find(c => c.boundStatus === status)` |
 | 已归档查询（T-ARC-04） | `WHERE projectId=? AND archived=1 [AND kind=?] [AND columnId=?] [AND archivedAt BETWEEN ? AND ?] [AND title LIKE ?] ORDER BY archivedAt DESC, id DESC LIMIT ?+1`；多取 1 条判定 `nextCursor` |