iboard/docs/V0.2/任务模块/任务模块需求文档.md

# iBoard V0.2 任务模块 需求文档 — 轻量任务 / 项目管理

> 版本：V0.2 · 模块：任务（Task） · 日期：2026-10-24
> 适用范围：iBoard APP 内的任务模块（沿用现有项目框架、路由体系与登录态实现）
> 关联文档：《设计文档》《数据库设计文档》《界面设计》——接口清单在**设计阶段**重新设计，本文档不含接口定义

---

## 1. 总体需求

### 1.1 一句话描述

在 iBoard 现有 APP 内新增一个**轻量级的项目与任务管理模块**：界面交互参考 Todoist，以**项目**为隔离单位组织任务，提供**列表 / 看板**双视图，并允许**每个项目独立配置看板列与任务状态的对应关系、以及每列已完成任务的保留选项**，用最小认知成本覆盖「个人琐事记录」与「多人协作推进」两类场景。

**「轻量」的含义**：不做需求管理、工时、甘特图、工作流引擎、审批流；字段克制、结构最多两层（任务 + 一级子任务）、权限不做细分角色。目标是用最少的配置让用户"打开就能记、记完就能推进"。

### 1.2 核心概念

| 概念 | 定义 |
| --- | --- |
| **项目（Project）** | 任务归属的隔离单位，**也是权限单位**。用户只能看到自己是成员的项目；项目内成员权限目前均等 |
| **个人默认项目（Personal Project）** | 每个用户自动拥有且仅有一个的私有项目。**不可删除、不可添加其他成员**，名称以用户名开头且可自定义，用于个人琐碎事务 |
| **普通协作项目（Shared Project）** | 用户新建的项目，可增删成员、可归档 |
| **项目成员（Member）** | 用户与项目的多对多关联。成员的**存在**决定权限，「负责人 / 任务成员」字段只决定**展示** |
| **任务（Task）** | 一条事务记录。归属唯一项目；含基础字段 + 内置可折叠的**扩展信息卡片**；特例：子任务 |
| **一级子任务（Subtask）** | 挂在父任务下的任务。**最多一层**，不可再嵌套；必须与父任务同项目；完成状态与父任务**相互独立** |
| **负责人（Assignee）** | 任务上的**单人**标记，字号更大、视觉突出。**新建任务时默认填入创建者本人**，可清空 |
| **任务成员（Task Members）** | 任务上的**多人**标记，字号更小、弱化展示，位于卡片 / 条目下方 |
| **扩展信息卡片** | 任务内置的可折叠信息区，承载**任意名称 / 值 / 链接**的扩展信息（来源不限、字段不固定），**默认收起、全部非必填** |
| **看板列（Column）** | 项目级可配置的列，**默认 4 列** `Plan → Doing → Action → Done`；**可增删改、可调整顺序**，数量不固定 |
| **任务状态（Status）** | 任务的处理阶段，取值为 `未开始` / `执行中` / `完成`。**与看板列是两个独立概念**，二者的对应关系由项目配置决定 |
| **列-状态绑定（Column Status Binding）** | 项目级配置：**每一列独立**选择"是否绑定任务状态"以及"绑定到哪个状态"。绑定后列与状态双向联动；不绑定时二者完全独立 |
| **已完成但未绑定状态** | 任务状态为「完成」、但其所在看板列未绑定到「完成」的情形——此时列保持不变 |
| **看板列保留选项（Column Retention）** | 项目级配置：**每一列独立**设置已完成任务的保留时长，取值为「永不显示」/「当天」/「3 天」/「本周」/「本月」/「永久显示」六档，用于控制该列中已完成任务的可见性 |
| **视图记忆** | 设备端按项目独立保存"上次选择的视图（列表 / 看板）"，进入项目自动恢复 |
| **上下文** | 用户当前所处的视图位置（某个项目 / 某个父任务的子任务列表 / 某个列表分区），用于解释"本次修改"相对哪些任务生效 |

### 1.3 完整功能

1. **视图体系**：列表视图、看板视图，可随时互相切换，同源数据、实时双向同步；每个项目独立记忆上次使用的视图。列表只是不按列分组，**任务归属的看板列与看板视图完全一致**。**首屏**上部为「最近项目」（3 个卡片 + 更多入口，卡片可手动排序），下部直接展示**当前项目**的任务管理视图，不必先进项目列表。
2. **看板与任务状态的绑定配置**：
   - 看板列**默认 4 列** `Plan → Doing → Action → Done`；列**可增删改、可调整顺序**，数量不固定。
   - **每一列独立**选择是否绑定任务状态，并可选择绑定到 `未开始 / 执行中 / 完成` 中的任一个；**允许多列绑定同一状态**。
   - **列决定状态**：任务拖入某列时，该列绑定了状态则状态随之改变；该列未绑定则**保留原状态**。
   - **状态与列不匹配时自动归位**：状态改变后若当前所在列未绑定该状态，则按**当前列顺序**移入第一个绑定该状态的列；**没有匹配列就不移动**，保留当前位置。
   - **默认**：`Plan` 绑定「未开始」、`Doing` 绑定「执行中」、`Done` 绑定「完成」、`Action` **不绑定**。
   - 配置是**项目级**的，项目内任意成员均可修改，不同项目互不影响。
   - **子任务不受列-状态绑定约束**，其状态可与父任务不一致。
3. **已完成任务显示控制**：**按看板列独立配置保留选项**——`永不显示` / `当天` / `3 天` / `本周` / `本月` / `永久显示` 六选一；超出保留选项的已完成任务在该列中自动隐藏。列表视图按其所属列的配置执行同样的显示控制。
4. **任务字段体系**：基础字段（标题必填，负责人默认本人）+ 内置可折叠**扩展信息卡片**（默认收起、全非必填）；负责人（单人）与任务成员（多人）均为信息标记。
5. **负责人 & 成员展示规则**：负责人大字号突出、成员小字号弱化并置于下方；二者只能从**当前项目成员**中选择；不改变项目统一读写权限。
6. **子任务体系**：仅一级、必须同项目、父子完成状态互不联动；列表视图支持缩进与折叠展开；**看板卡片内以简洁形式嵌套展示子任务并可直接勾选**，完整详情在卡片弹窗内编辑；支持**长按拖拽把任务降为另一个任务的一级子任务**。
7. **项目体系**：个人默认项目（不可删、不可加成员、名称以用户名开头且可改名）；普通协作项目（可增删成员）；创建人可主动退出；成员清空后静默保留，交后台维护。成员管理、列设置与项目信息（改名 / 归档 / 删除 / 退出）统一收进「**项目管理**」入口。
8. **项目权限**：以项目为隔离单位，只能看到自己是成员的项目；项目内成员权限均等、全读写；预留权限分级入口但不实现细分角色；任意成员均可归档项目。
9. **跨项目拷贝**：是**拷贝**不是移动；完整复制全部字段、扩展信息、子任务、负责人、成员、状态、看板列、标签；新任务创建人为执行拷贝者；拷贝后新旧任务完全独立。
10. **UI 交互规范**：参考 Todoist 的列表交互与子任务折叠风格；看板卡片轻量化；列表与看板同源、切换无刷新、数据一致；具备空状态 / 加载状态 / 数据异常状态。
11. **模块入口**：任务模块作为**顶级 Tab** 接入底部导航，位于**「打卡」之后**（顺序：打卡 → 任务 → 宏观 → 监控 → 我）。

### 1.4 典型用法

**场景 A · 个人琐事（个人默认项目）**
用户打开模块 → 进入自己的个人默认项目（如「张三的琐事」）→ 列表视图输入标题回车新增，**负责人自动是本人**，也可清空 → 需要推进时切到看板，把任务从 `Plan` 拖到 `Doing`。
因个人项目**不能加成员**，负责人 / 成员的可选范围只有自己，无需任何权限配置。

**场景 B · 多人协作与列-状态绑定**
用户新建普通项目「APP 改版」并加入 3 名同事。默认配置下：任务在 `Plan`=未开始、`Doing`=执行中、`Done`=完成；`Action` 不绑定状态，任务放进去后状态保持不变。
成员 A 把任务拖入 `Done` ⇒ **状态自动变为「完成」**；成员 B 在列表视图把某任务状态改为「完成」⇒ 任务**自动出现在 `Done` 列**。
若任务停留在 `Action`（不绑定）里被改成「完成」，因当前列与状态不匹配，系统**自动归位**到第一个绑定「完成」的列（默认即 `Done`）；若该项目把「完成」的绑定全部取消，则**无匹配列，任务留在 `Action` 不动**。若把 `Action` 也设为绑定「完成」，则按列序仍先进 `Done`——这是**项目级**配置，不影响其他项目。

**场景 C · 扩展信息卡片**
新增任务「登录接口返回 500」→ 展开默认收起的**扩展信息卡片** → 按需添加任意条目，如「仓库 = gitlab/app」「分支 = fix/login-500」或一条相关链接（全部非必填，不填不影响任务本身）。

**场景 D · 跨项目复用**
把「APP 改版」里的某任务跨项目拷贝到「APP 二期」→ 生成一条**全新任务**，字段、扩展信息、子任务、负责人、成员、状态、看板列、标签全部复制，创建人记为执行拷贝的用户；此后两任务互不影响。

**场景 E · 按列控制已完成任务显示**
某项目的 `Done` 列已完成任务过多影响阅读 → 把该列保留选项设为「当天」→ 更早的已完成任务自动隐藏；同时把 `Action` 列设为「永不显示」，该列不再展示已完成任务；`Plan` 列保持「永久显示」不受影响。列表视图同样按各任务所属列的配置隐藏它们，与看板一致。切到另一个项目时，该项目各列配置保持自己的设置（互不干扰）。

**场景 F · 拖拽调整层级**
列表视图中长按任务卡片，向上拖动到另一个任务上并停留 → 该任务成为目标任务的**一级子任务**（缩进显示）。若目标任务本身已是子任务，或被拖任务已带子任务，则拒绝并给出提示（仅支持一级）。降为子任务后，它原有的看板列与状态保持不变。

**场景 G · 看板卡片内的子任务**
看板中某任务卡片下方以简洁样式嵌套显示其子任务 → 直接在卡片内勾选子任务完成，**父任务状态不受影响**，子任务状态也不受该列绑定规则约束；每个嵌套子任务带**自身状态小标记**，便于识别与父任务不一致的状态；需要编辑子任务标题或负责人时，点开卡片弹窗操作。

**场景 H · 从底部 Tab 进入（首屏）**
底部导航顺序为「打卡 → **任务** → 宏观 → 监控 → 我」→ 点击「任务」进入首屏：**上部**是最近使用的 3 个项目卡片 + 「更多项目」入口（点卡片即切换当前项目，长按卡片可调整顺序）；**下部**直接是当前项目（上次访问的，记录在设备端；无记录则回到个人默认项目）的任务管理页，无需先进项目列表。点「更多项目」才进入完整的项目列表页。

**场景 I · 项目管理**
在项目页头部点「项目管理」→ 弹出统一管理页，内含三个分区：**成员**（查看 / 添加 / 移除）、**列设置**（列管理 / 状态绑定 / 保留选项）、**项目信息**（改名 / 归档 / 删除 / 退出，个人默认项目不出现删除与退出）。

### 1.5 不在本期范围（明确排除）

- 多层子任务（仅一级）。
- 角色 / 权限分级（只预留入口，本期全部成员权限均等）。
- 任务评论、@提及、附件上传、提醒通知、日历同步。
- 列内拖拽排序的精细规则（本期为简单位置值）。
- 甘特图、工时、报表统计。
- 项目成员清空后的数据清理（由后台维护，前端不做特殊处理）。
- 独立的 WebView / 登录态 / 返回键适配（**沿用现有项目框架**，不单独提出要求）。

---

## 2. 术语与概念定义

| 术语 | 定义 |
| --- | --- |
| **项目（Project）** | 任务与权限的隔离单位；用户只能看到自己为成员的项目 |
| **个人默认项目** | 每个用户唯一、自动创建、不可删除、不可添加成员的私有项目；`isPersonal = true` |
| **普通协作项目** | 可增删成员、可归档的项目；`isPersonal = false` |
| **项目成员（Member）** | `ProjectMember` 记录，决定**读写权限** |
| **负责人（Assignee）** | 任务上的单人标记（须为项目成员），决定列表 / 卡片视觉上的突出位置；新建时默认为创建者，可清空 |
| **任务成员（TaskMember）** | 任务上的多成员标记（须为项目成员），弱化展示，可为空 |
| **任务状态（status）** | `todo`（未开始）/ `doing`（执行中）/ `done`（完成），三值枚举 |
| **看板列（column）** | 项目级可配置的列实体，默认 `Plan` / `Doing` / `Action` / `Done` 四列；可增删改、可排序，数量不固定 |
| **列-状态绑定（columnBindings）** | 项目级配置：每列独立声明「是否绑定」及「绑定到哪个状态」；默认 plan→todo、doing→doing、done→done、action→不绑定 |
| **已完成但未绑定状态** | 状态为 `done` 但所在列未绑定到 `done`；此时拖拽/勾选只改状态不改列（见 T-EX-04） |
| **看板列保留选项（columnRetention）** | 项目级配置：每列独立设置已完成任务的保留时长，`never` 永不显示 / `today` 当天 / `3d` 3 天 / `week` 本周 / `month` 本月 / `forever` 永久显示 |
| **视图记忆（viewMode）** | `list` / `board`，**按项目独立记忆、保存在设备端** |
| **扩展信息卡片** | 任务的折叠信息区，存任意 `[{label, value, url?}]` 条目，默认收起、全部非必填 |
| **一级子任务** | `parentId` 非空的任务；其父任务必须为顶层任务，且同项目 |
| **上下文** | 本次操作所处位置（项目 / 父任务 / 列表分区），用于界定"从该列拖出"等相对语义的作用范围 |
| **拷贝（Copy）** | 跨项目生成新任务并复制全部内容；原任务不受影响 |

---

## 3. 需求点

**编号规则**：`T-模块-序号`。前缀 `T` 表示本模块（Task / 任务）。模块：

| 模块码 | 模块名 | 对应 §1.3 条目 |
| --- | --- | --- |
| `VW` | 视图体系 | 第 1 条 |
| `COL` | 看板列管理 | 第 2 条 |
| `BD` | 看板与列-状态绑定 | 第 2 条 |
| `FL` | 已完成任务显示控制（按列保留选项） | 第 3 条 |
| `TK` | 任务字段体系（含扩展信息卡片） | 第 4 条 |
| `AS` | 负责人与成员 | 第 5 条 |
| `ST` | 子任务体系 | 第 6 条 |
| `PJ` | 项目体系 | 第 7 条 |
| `PM` | 项目权限与模块入口 | 第 8 条、第 11 条 |
| `CP` | 跨项目拷贝 | 第 9 条 |
| `UI` | UI 交互规范 | 第 10 条 |
| `DT` | 数据需求 | — |
| `NF` | 非功能需求 | — |
| `EX` | 异常与边界 | — |

**优先级**：`P0` = 本期必须有；`P1` = 本期应该有；`P2` = 有则更好（可延后）。

**验收要点写法**：统一采用「给什么输入 / 做什么操作 → 期望得到什么可观察结果」，可直接转写为测试用例。

### 3.1 视图体系（T-VW）

| 编号 | 需求描述 | 验收要点 | 优先级 |
| --- | --- | --- | --- |
| T-VW-01 | 项目内提供**列表视图**与**看板视图**两种呈现方式 | 同一项目的同一批任务，两种视图均能完整呈现，条数一致 | P0 |
| T-VW-02 | 可在列表 / 看板之间**互相切换**，切换过程**无整页刷新** | 切换不触发页面重载、不出现白屏，切换后滚动位置或回到顶部行为明确 | P0 |
| T-VW-03 | **视图记忆按单个项目独立保存**：A 项目选列表、B 项目选看板互不影响 | 项目 A 切到看板 → 进入项目 B → B 仍为 B 上次选择的视图；回到 A → 仍为看板 | P0 |
| T-VW-04 | 进入项目时**自动恢复**该项目上次选择的视图 | 退出模块后重新进入某项目，视图与上次退出时一致 | P0 |
| T-VW-05 | 从未选择过视图的新项目，**默认使用列表视图** | 新建项目首次进入为列表视图 | P1 |
| T-VW-06 | 视图记忆保存在**设备端**，不要求跨设备同步；本机跨会话保持 | 杀进程重进某项目，视图仍为上次选择；换设备登录不要求一致 | P0 |
| T-VW-07 | **上次访问的项目**记录在**设备端**；无记录时**一律回到个人默认项目** | 杀进程重进落在上次项目；首次使用或记录失效则进入个人默认项目 | P0 |
| T-VW-08 | 任务**首屏上部**展示**最近使用的 3 个项目**卡片，末尾放「更多项目」入口；点击「更多项目」进入完整项目列表页 | 最近项目按访问时间倒序取前 3；点卡片切换当前项目并高亮；点「更多」进入项目列表 | P0 |
| T-VW-09 | 任务**首屏下部**直接展示**当前选中项目**的任务管理视图（列表 / 看板，随该项目视图记忆）；当前项目默认为上次访问的项目，无记录时为个人默认项目 | 进入任务 Tab 即见当前项目的任务，**无需先进项目列表**；切换首屏项目卡片后下部随之切换 | P0 |
| T-VW-10 | 首屏**最近项目卡片支持手动排序**（长按拖动调整顺序），排序结果存**设备端**；未手动排序时按最近使用时间自动排列 | 拖动后顺序持久化，杀进程重进保持；新近访问但未手动排序的项目不出现在固定卡位之外 | P1 |

### 3.2 看板列管理（T-COL）

> 看板列是**项目级可配置实体**：默认 4 列，允许增删改与排序。列与「状态绑定」「保留选项」是三条正交的配置。

| 编号 | 需求描述 | 验收要点 | 优先级 |
| --- | --- | --- | --- |
| T-COL-01 | 新建项目**默认生成 4 列**：`Plan` / `Doing` / `Action` / `Done`，顺序即此 | 新项目看板渲染 4 列且名称、顺序与默认一致 | P0 |
| T-COL-02 | 支持**新增列**（自定义名称），新列默认追加在末尾 | 新增后看板多一列，位于最后一列之后，可正常拖入任务 | P0 |
| T-COL-03 | 支持**重命名列** | 改名后看板、列设置、任务归属处同步显示新名称 | P0 |
| T-COL-04 | 支持**删除列**；删除前需二次确认，并明确其中任务的处理方式 | 按 T-EX-16 约定迁移任务，不产生无归属任务 | P0 |
| T-COL-05 | 支持**调整列顺序**（拖动排序），顺序即看板显示顺序 | 拖动后顺序持久化，重新进入保持新顺序 | P0 |
| T-COL-06 | 列数量**不固定**，约束上下限：**至少 1 列、至多 10 列**（上限待确认） | 可增到多于 4 列；删到仅剩 1 列时禁止再删；达 10 列时禁止新增并提示 | P0 |
| T-COL-07 | 列名需**非空**且有长度上限，同一项目内**不允许重名** | 提交空名 / 重名时拒绝保存并提示 | P0 |
| T-COL-08 | 删除列时，若该列绑定了状态，绑定关系随之解除 | 删除绑定「完成」的列后，该状态不再有该列可归位 | P1 |
| T-COL-09 | 列配置属**项目级**，项目内任意成员可修改，不影响其他项目 | 成员 A 改列名，成员 B 同步可见；其他项目列不受影响 | P0 |
| T-COL-10 | 列表视图不展示列分组，但任务仍归属某一列（列可被增删后依然成立） | 删除/新增列后，列表视图中任务的列归属正确 | P0 |

### 3.3 看板与列-状态绑定（T-BD）

| 编号 | 需求描述 | 验收要点 | 优先级 |
| --- | --- | --- | --- |
| T-BD-01 | 看板以**列**为单位组织任务，列由项目配置（默认 4 列，支持增删改与排序，详见 T-COL） | 看板按项目当前列配置渲染；调整列后任务归属随之正确呈现 | P0 |
| T-BD-02 | **每一列独立**配置是否绑定任务状态；绑定时可选择绑定到 `未开始` / `执行中` / `完成` 中任一个 | 每列都有独立的绑定开关与状态选择器；各列配置独立保存 | P0 |
| T-BD-03 | 允许**多列绑定到同一个状态**（如 `Done` 与 `Action` 都绑定「完成」） | 同一项目配置两列均绑定「完成」后，两列均能触发完成联动 | P0 |
| T-BD-04 | **绑定列 → 拖入即改状态**：任务落入绑定列时，任务状态改为该列所绑定的状态 | 把「未开始」任务拖入绑定「执行中」的列 → 状态变「执行中」；拖入绑定「完成」的列 → 状态变「完成」 | P0 |
| T-BD-05 | **状态 → 自动移入列**：任务状态改为某状态时，任务自动移入绑定该状态的列 | 列表视图把状态改为「完成」→ 切到看板，任务位于绑定「完成」的列 | P0 |
| T-BD-06 | 同一状态被多列绑定时，自动移入**按当前列顺序取第一个**匹配列，规则确定且可预期 | 两列均绑定「完成」时，任务状态改为「完成」后仅出现在列序靠前的那个绑定列，不重复出现 | P0 |
| T-BD-07 | **列决定状态，不看来源列**：拖动任务时，一律以「**目标列**的绑定配置」决定任务状态——目标列绑定了状态，则状态改为所绑定状态；**目标列未绑定，则任务保留原状态** | ①从绑定「完成」的列拖到绑定「执行中」的列 → 状态变「执行中」；②从任意列拖到**未绑定**的 `Action` → 状态保持不变 | P0 |
| T-BD-08 | **不绑定列**与任务状态**完全独立**：拖入、拖出该列以及在其他位置改变状态，均不改变该列归属以外的行为 | 把「执行中」任务拖入未绑定的 `Action` → 状态仍为「执行中」，仅列变化 | P0 |
| T-BD-14 | **状态与所在列不匹配时自动归位**：任务状态改变后，若其**当前所在列未绑定该状态**，则自动查找绑定该状态的列并将其移入 | 在未绑定的 `Action` 中把任务改为「完成」→ 任务自动移入绑定「完成」的列 | P0 |
| T-BD-15 | 自动归位时**按当前列的实际显示顺序取第一个匹配列**（列顺序可被用户调整） | 若两列都绑定「完成」，状态改为「完成」后移入排在前面那一列 | P0 |
| T-BD-16 | **无匹配列时任务不移动**，保留在原列（状态照常改变） | 取消所有列对「完成」的绑定后，把任务改为「完成」→ 状态为完成，列保持不变 | P0 |
| T-BD-09 | **默认配置**：`Plan` 绑定「未开始」、`Doing` 绑定「执行中」、`Done` 绑定「完成」、`Action` 不绑定 | 新建项目首次打开看板配置，四列取值与默认完全一致 | P0 |
| T-BD-10 | 绑定配置是**项目级**的，项目内**任意成员**均可修改，不同项目互不影响 | 成员 A 修改项目一配置成功；项目二配置不受影响；成员 B 也能修改 | P0 |
| T-BD-11 | 修改绑定配置**不批量改写**既有任务的状态与列，仅对之后的操作生效 | 把 `Action` 由不绑定改为绑定「完成」后，已在 `Action` 的任务状态保持原样 | P1 |
| T-BD-12 | 绑定配置变更后，看板与列表**即时一致**，无需手动刷新 | 保存配置后，看板列徽标与完成态立即反映新规则 | P1 |
| T-BD-13 | **子任务不受看板列-状态绑定影响**：子任务状态不因所在列而改写，也不触发「状态 → 移入列」 | 父任务在绑定「完成」的列，其子任务状态仍可为「执行中」且不被改写；修改子任务状态不使其离开当前列 | P0 |

### 3.4 已完成任务显示控制（T-FL）

> 本节的「保留选项」**以看板列为单位**配置，取代原先的「项目整体 5 档过滤」。

| 编号 | 需求描述 | 验收要点 | 优先级 |
| --- | --- | --- | --- |
| T-FL-01 | **每一列独立**配置已完成任务的保留选项，配置项属于项目级 | 各列（含新增列）都有独立配置入口，修改一列不影响其他列 | P0 |
| T-FL-02 | 保留选项为**固定 6 档**：`永不显示` / `当天` / `3 天` / `本周` / `本月` / `永久显示` | 下拉仅此六项，不提供自由输入天数 | P0 |
| T-FL-03 | 「永久显示」：该列已完成任务**始终展示**，不受时间限制 | 设为永久显示后，历史任意时间完成的任务均可见 | P0 |
| T-FL-04 | 「永不显示」：该列已完成任务**始终不展示** | 设为永不显示后，该列无已完成任务卡片 | P0 |
| T-FL-05 | 「当天」：仅展示**完成于今天（自然日）**的已完成任务 | 今天完成的可见；昨天完成的次日即不显示 | P0 |
| T-FL-06 | 「3 天」：展示**完成于最近 3 个自然日（含今天）**的已完成任务 | 今天、昨天、前天完成可见，更早不显示 | P0 |
| T-FL-07 | 「本周」：展示**完成于本周（周一 00:00 起，至今天）**的已完成任务 | 周一起算；下周一进来看，上周完成的任务不再显示 | P0 |
| T-FL-08 | 「本月」：展示**完成于本月（当月 1 日起，至今天）**的已完成任务 | 当月 1 日起算；进入次月后，上月完成的任务不再显示 | P0 |
| T-FL-09 | 超出所选档位范围的已完成任务**自动隐藏**（无需手动操作） | 某列设为「当天」，次日进入该列，昨日完成的任务自动消失 | P0 |
| T-FL-10 | 保留判定以「该任务的**完成时间**」为准，与任务当前所在列无关 | 任务完成后再移动列，可见性仍按其完成时间与新列档位判定 | P0 |
| T-FL-11 | **列表视图与看板视图行为一致**：列表只是不按看板列分组展示，任务归属哪一列仍是哪一列，显示控制同样按**其所属列**的配置执行 | 看板中某列已隐藏的已完成任务，在列表视图中同样不出现；两视图可见条数一致 | P0 |
| T-FL-12 | 该配置仅影响**已完成任务**；未完成任务始终展示，不受保留选项影响 | 未完成任务在任何保留选项配置下均可见 | P0 |
| T-FL-13 | 显示控制为**展示层过滤**，不改变任务数据与状态 | 修改保留选项后，任务数据、状态、计数口径不发生变化 | P0 |
| T-FL-14 | 过滤后每列的计数与展示条数一致 | 列头显示 N 条时，该列实际可见卡片同为 N 条 | P1 |
| T-FL-15 | 保留选项配置在**项目内所有成员间共享**（属项目配置，非个人偏好） | 成员 A 修改后，成员 B 进入即按新配置显示 | P0 |

### 3.5 任务字段体系（T-TK）

| 编号 | 需求描述 | 验收要点 | 优先级 |
| --- | --- | --- | --- |
| T-TK-01 | 任务包含**基础字段**：标题（必填）、描述、所属项目、看板列、任务状态、负责人、任务成员、标签、创建人、创建时间、更新时间 | 新建任务后上述字段均可正确保存与读取 | P0 |
| T-TK-02 | 标题为**唯一必填**字段，其余字段均可为空 | 仅填标题即可保存成功；仅清空标题时拒绝保存并提示 | P0 |
| T-TK-03 | 任务状态为三值枚举：`未开始` / `执行中` / `完成` | 任一任务的状态只能取这三个值之一，不存在第四种取值 | P0 |
| T-TK-04 | ~~内置扩展信息卡片~~ **已移除**（2026-10-24 评审）：相关信息记录改由**项目信息块**承载（T-PJ-13） | — | 已取消 |
| T-TK-05 | ~~扩展信息条目~~ **随 T-TK-04 一并移除** | — | 已取消 |
| T-TK-06 | ~~扩展信息卡片折叠~~ **随 T-TK-04 一并移除** | — | 已取消 |
| T-TK-07 | ~~扩展信息非必填~~ **随 T-TK-04 一并移除** | — | 已取消 |
| T-TK-08 | 每条任务有**负责人（单人）** | 任务最多只有一个负责人，重复设置时以最后一次为准 | P0 |
| T-TK-09 | 新建任务时**负责人默认填入创建者本人** | 新建任务后未手动修改时，负责人即为创建者 | P0 |
| T-TK-10 | 负责人**允许清空为空** | 清空后任务可正常保存，展示为「未指派」 | P0 |
| T-TK-11 | 每条任务有**任务成员（多人）** | 可设置 0 ~ 多个成员，成员不重复 | P0 |
| T-TK-12 | 任务支持**标签** | 可添加多个标签，展示于条目 / 卡片 | P1 |
| T-TK-13 | 任务的创建人、创建时间、更新时间由系统维护，用户不可直接编辑 | 编辑任务不改变创建人与创建时间；任何修改刷新更新时间 | P1 |
| T-TK-14 | 任务标题收紧至**30 个汉字**；快速添加输入框允许输入 200 字，超过 30 字时自动在 30 字以内的**分隔符（空格/标点等）**处截断，前段作为标题，整体文本并入描述 | 输入长文本创建后：标题 ≤30 字且不在词中间切断；描述包含完整原文余文；直接编辑标题超 30 字时拒绝保存并提示 | P0 |
| T-TK-15 | 任务可选**时间标记**（完整日期存储），设置了时间标记的任务在列表行与看板卡片上以 `MM-dd` 小标签展示 | 详情页可选择/清除时间标记；设置后卡片出现 MM-dd 标签，清除后消失 | P1 |
| T-TK-16 | 快速添加输入框支持**时间词前缀**：以 今天/明天/后天/本周/下周/本月/下月 开头（后跟分隔符）时，自动为任务设置对应时间标记并把该前缀从标题中移除 | 输入「明天 交周报」→ 创建任务标题为「交周报」、时间标记为明天的日期；无匹配前缀时行为不变 | P1 |

### 3.6 负责人 & 成员 UI 展示规则（T-AS）

| 编号 | 需求描述 | 验收要点 | 优先级 |
| --- | --- | --- | --- |
| T-AS-01 | **负责人**字号更大、视觉突出，位于条目 / 卡片的主要信息区 | 同名负责人与成员并排时，负责人字号明显更大且位于主位 | P0 |
| T-AS-02 | **任务成员**字号更小、弱化展示（低对比色），位于卡片 / 条目**下方** | 成员信息渲染在负责人 / 标题之下，视觉层次弱于负责人 | P0 |
| T-AS-03 | 负责人只能从**当前项目的成员**中选择 | 选择器只列出本项目成员；项目外用户无法被选中 | P0 |
| T-AS-04 | 任务成员只能从**当前项目的成员**中选择 | 选择器只列出本项目成员，不提供项目外用户 | P0 |
| T-AS-05 | 负责人为空（已清空）时展示「未指派」占位，正常渲染 | 清空负责人后条目 / 卡片显示「未指派」，可再次指派 | P0 |
| T-AS-06 | 人员被移出项目后，其负责人 / 成员标记按约定处理且不报错 | 见 T-EX-06 | P1 |
| T-AS-07 | 负责人、任务成员**仅为信息标记**，不改变项目统一读写权限 | 仅为负责人或仅为成员的用户，对项目读写能力与其他成员完全相同 | P0 |

### 3.7 子任务体系（T-ST）

| 编号 | 需求描述 | 验收要点 | 优先级 |
| --- | --- | --- | --- |
| T-ST-01 | **仅支持一级子任务**，不支持多层嵌套 | 子任务上无「添加子任务」入口；后端拒绝以子任务为父任务创建任务 | P0 |
| T-ST-02 | 子任务**必须与父任务归属同一项目** | 尝试将子任务置于其他项目时被拒绝（含跨项目拷贝场景） | P0 |
| T-ST-03 | 父任务与子任务的**完成状态相互独立**、不自动联动 | 子任务全部完成，父任务状态不变；父任务完成，子任务状态不变 | P0 |
| T-ST-04 | **列表视图**支持子任务**缩进**展示 | 子任务在父任务下方缩进渲染，层级一眼可辨 | P0 |
| T-ST-05 | **列表视图**支持子任务**折叠 / 展开** | 折叠后子任务不显示且不占位；展开后恢复；折叠状态可感知 | P0 |
| T-ST-06 | **看板卡片内嵌套展示子任务**：含子任务的卡片中，子任务以**简洁形式嵌套**显示在任务卡片内 | 卡片内可见子任务列表（如紧凑单行：复选框 + 标题），样式轻量、不喧宾夺主 | P0 |
| T-ST-07 | 嵌套子任务可在**卡片内直接勾选完成**；完整详情（编辑标题 / 负责人 / 扩展信息等）在卡片弹窗内查看编辑 | 点击子任务复选框即切换其状态；点击卡片打开弹窗可编辑子任务全部字段 | P0 |
| T-ST-08 | **子任务状态与父任务状态可以不一致**，且子任务**不受看板列-状态绑定约束** | 父任务在 `Done`（绑定「完成」）时，其子任务可为「未开始」且不被改写 | P0 |
| T-ST-09 | 卡片内嵌套的子任务**显示自身状态小标记**（区分「未开始 / 执行中 / 完成」），以便识别与其父任务不一致的状态 | 父任务为完成、子任务为执行中时，卡片内可见子任务带「执行中」小标记 | P0 |
| T-ST-10 | 子任务不可作为看板独立卡片出现，只在其父任务卡片内嵌套 | 看板上一个任务只占一张卡，子任务不会单独成卡 | P1 |
| T-ST-11 | 删除父任务时**级联删除**其子任务 | 删除父任务后子任务一并删除，不产生孤儿数据 | P0 |
| T-ST-12 | **支持长按拖拽把任务降为另一个任务的一级子任务** | 列表视图长按任务 A 拖到任务 B 上释放 → A 成为 B 的子任务并缩进显示 | P0 |
| T-ST-13 | 拖拽成为子任务时，若目标任务**本身已是子任务**，则拒绝操作并提示 | 把任务拖到某个子任务上 → 操作被拒绝，给出「仅支持一级子任务」提示，数据不变 | P0 |
| T-ST-14 | 拖拽成为子任务时，若被拖任务是**有子任务的父任务**，则拒绝并提示（父任务不可整体挂到别的任务下） | 拖动含子任务的任务到其他任务上 → 拒绝，避免形成二级嵌套 | P0 |
| T-ST-15 | 拖拽成为子任务时，子任务的**看板列与状态保持自身原值**，仅改变父子归属 | 按 T-EX-13 约定处理，保证子任务与父任务同项目且层级合法 | P1 |

### 3.8 项目体系（T-PJ）

| 编号 | 需求描述 | 验收要点 | 优先级 |
| --- | --- | --- | --- |
| T-PJ-01 | 每个用户**自动拥有且仅有一个个人默认项目** | 新用户首次进入模块即已存在个人项目；不可再创建第二个 | P0 |
| T-PJ-02 | 个人默认项目**不可删除** | 无删除入口；直接调用删除接口被拒绝 | P0 |
| T-PJ-03 | 个人默认项目**不能添加其他成员** | 成员管理入口不存在或不可用；调用添加成员接口被拒绝 | P0 |
| T-PJ-04 | 个人默认项目名称**以用户名开头**，且**整体名称可自定义修改** | 初始名称以用户名开头；改名后修改内容生效，仍保持「个人项目」性质 | P0 |
| T-PJ-05 | 支持**新建普通协作项目** | 可创建多个普通项目，创建者为成员 | P0 |
| T-PJ-06 | 普通项目**可以增删成员** | 添加 / 移除成员后，成员列表与可见性即时变化 | P0 |
| T-PJ-07 | **项目创建人可以主动退出项目** | 创建人退出后不再是成员，该项目不再对其可见 | P0 |
| T-PJ-08 | 项目**成员清空后静默保留**，交后台后续维护，前端不做特殊处理 | 成员全部退出后，前端不弹特殊提示、不出现错误；不可见 | P0 |
| T-PJ-09 | 项目可**归档**，归档项目与进行中项目区分展示 | 归档后从进行中列表移出，可在归档区找回 | P1 |
| T-PJ-10 | 项目列表按用户可见范围返回，仅含自己为成员的项目 | 非成员项目不出现在列表中 | P0 |
| T-PJ-11 | 项目的**成员管理、成员新增、列设置**统一收进「**项目管理**」入口；项目页头部不再散置多个功能入口 | 项目管理内含 成员 / 列设置 / 项目信息 三个分区；头部仅保留「项目管理」一个入口 | P0 |
| T-PJ-12 | 项目管理内提供**项目信息管理**：改名（T-PJ-04）、归档 / 取消归档（T-PJ-09）、删除项目（T-PJ-02，个人默认项目禁用）、退出项目（T-PJ-07，创建人可退） | 各操作在项目管理中可用且遵循既有约束；个人项目不出现删除与退出入口 | P0 |
| T-PJ-13 | 项目支持**信息块**：可自由添加任意多个长文本信息块（标题 + 多行内容，如 Readme / 项目说明），每块**独立编辑与删除**；属项目级数据，全体成员可见可编辑 | 可增删改任意块；内容支持多行长文本；所有成员看到同一份信息块 | P0 |

### 3.9 项目权限（T-PM）

| 编号 | 需求描述 | 验收要点 | 优先级 |
| --- | --- | --- | --- |
| T-PM-01 | 权限**以项目为隔离单位**：用户只能看到自己是成员的项目及其任务 | 非成员访问某项目接口返回 403 / 404，列表不出现该项目 | P0 |
| T-PM-02 | 项目内**所有成员权限均等**，具备**全读写**能力 | 任意成员均可新增 / 编辑 / 删除任务、管理成员、修改列-状态绑定与保留选项配置 | P0 |
| T-PM-03 | 预留**权限分级入口**，本期**不实现**细分角色 | 数据结构或接口层保留扩展位；界面无角色分配功能 | P1 |
| T-PM-04 | 项目内**所有成员都可以归档项目** | 任意成员执行归档均成功 | P0 |
| T-PM-05 | 复用现有项目框架的登录态与鉴权，未登录访问被拒 | 无有效登录态访问返回 401 | P0 |
| T-PM-06 | 任务模块作为**顶级 Tab** 接入底部导航，位置在**「打卡」之后** | 底部 Tab 顺序为「打卡 → 任务 → 宏观 → 监控 → 我」；点击该 Tab 进入任务模块 | P0 |
| T-PM-07 | 进入任务模块后**默认落在上次访问的项目**（记录在**设备端**）；**无记录时一律回到个人默认项目** | 首次进入 / 记录失效 → 个人默认项目；再次进入 → 上次离开时的项目；换设备不继承 | P0 |

### 3.10 跨项目拷贝（T-CP）

| 编号 | 需求描述 | 验收要点 | 优先级 |
| --- | --- | --- | --- |
| T-CP-01 | 跨项目操作为**拷贝**，不是移动：源任务保留在原项目 | 拷贝后源任务仍存在于原项目且内容不变 | P0 |
| T-CP-02 | 拷贝时**完整复制全部字段** | 标题、描述、负责人、成员、标签、任务状态、看板列、扩展信息卡片逐项比对一致 | P0 |
| T-CP-03 | 拷贝时**完整复制子任务** | 子任务条数、标题、状态、列归属均与源任务一致 | P0 |
| T-CP-04 | 拷贝后**新任务的创建人**为本次执行拷贝操作的用户 | 新任务创建人 = 操作者，非源任务创建人 | P0 |
| T-CP-05 | 拷贝完成后**新旧任务互相独立**，后续修改互不影响 | 修改新任务标题 / 状态，源任务不变；反之亦然 | P0 |
| T-CP-06 | 拷贝目标必须是操作者**有权限**的项目 | 目标项目非本人成员时拒绝并提示 | P0 |
| T-CP-07 | 拷贝时负责人 / 成员若不属目标项目成员，按约定处理 | 按 T-EX-08 约定处理，不产生「项目外人」脏数据 | P1 |
| T-CP-08 | 拷贝包含子任务时，子任务与父任务**同属目标项目** | 拷贝后子任务项目归属与父任务一致 | P0 |
| T-CP-09 | 拷贝时若目标任务项目的**列-状态绑定规则不同**，按 T-EX-14 约定处理 | 状态与列不出现互相矛盾的组合 | P1 |

### 3.11 UI 交互规范（T-UI）

| 编号 | 需求描述 | 验收要点 | 优先级 |
| --- | --- | --- | --- |
| T-UI-01 | 整体界面、列表交互、子任务折叠风格**参考 Todoist** | 列表条目结构、快速新增、勾选完成、子任务折叠的交互与 Todoist 同类操作一致 | P0 |
| T-UI-02 | **看板卡片轻量化**，样式简洁 | 卡片仅承载必要信息，无多余装饰；信息层级清晰 | P0 |
| T-UI-03 | 列表与看板**同源数据**，修改**实时双向同步** | 列表改标题 / 状态 → 切到看板立即可见；看板改 → 切到列表立即可见 | P0 |
| T-UI-04 | 视图切换**无刷新**、数据一致 | 切换过程中不发起整页加载，数据不发生丢失或错位 | P0 |
| T-UI-05 | 移动端适配：复用现有样式体系与底部导航，安全区不遮挡内容 | 375~430px 视口无横向滚动、无内容被遮挡 | P0 |
| T-UI-06 | 勾选完成有即时反馈（视觉状态变化），不阻塞后续操作 | 点击勾选后立即变化，无需等待接口返回才能继续操作 | P1 |
| T-UI-07 | 看板拖拽在移动端支持**长按拖拽**，并提供卡片「移动到」快捷项作为兜底 | 长按可拖起卡片；无法拖拽的场景可用「移动到」菜单完成同效果 | P0 |
| T-UI-08 | 具备**空状态**展示（无项目 / 无任务 / 无子任务等） | 各层级无数据时展示空态与引导入口，不出现空白页 | P0 |
| T-UI-09 | 具备**加载状态**展示 | 首屏与切换视图时展示加载态，不出现闪烁或错乱 | P0 |
| T-UI-10 | 具备**数据异常状态**展示，可重试 | 接口失败时展示异常态与重试入口，重试成功后恢复 | P0 |
| T-UI-11 | 弹层（任务详情等）**底部按钮与屏幕底边保持安全距离**，不被安全区 / 手势条遮挡 | 底部留白 ≥ 安全区高度 + 12px；小屏下弹层内容可滚动，删除等底部按钮始终完整可见可点 | P0 |

### 3.12 数据需求（T-DT）

| 编号 | 需求描述 | 验收要点 | 优先级 |
| --- | --- | --- | --- |
| T-DT-01 | 新增 Prisma 模型：`Project`（含 `isPersonal`、列-状态绑定配置、列保留选项配置、`archived` 等）、`ProjectMember` | 字段见附录 A | P0 |
| T-DT-02 | 列-状态绑定配置**按列存储**，每列独立保存「是否绑定 + 绑定状态」，支持多列指向同一状态 | 任意数量列的配置可独立读写；两列绑定同一状态可正确落库 | P0 |
| T-DT-03 | 列保留选项配置**按列存储**，取值覆盖六档：`never` / `today` / `3d` / `week` / `month` / `forever` | 三档取值均可落库并正确读回 | P0 |
| T-DT-04 | 新增 Prisma 模型：`Task`（含 `parentId` 自关联、`assigneeId`、`status`、看板列、扩展信息卡片、`sortOrder`） | 字段见附录 A | P0 |
| T-DT-05 | 新增 Prisma 模型：`TaskMember`（任务成员关联）、扩展信息卡片结构、标签结构 | 字段见附录 A | P0 |
| T-DT-06 | 视图记忆按**设备端**存储，不要求落库 | 换设备登录不要求视图一致 | P0 |
| T-DT-07 | 建立必要索引：任务按项目查询、按父子关系查询、按状态查询 | 列表 / 看板 / 显示控制查询均走索引 | P0 |
| T-DT-08 | 提供迁移 SQL 并纳入 `prisma migrate deploy` 流程 | 与现有迁移流程一致 | P0 |
| T-DT-09 | 归档采用软删除语义，历史数据保留 | 归档不物理删除任务与项目数据 | P1 |

### 3.13 非功能需求（T-NF）

| 编号 | 需求描述 | 验收要点 | 优先级 |
| --- | --- | --- | --- |
| T-NF-01 | 项目内任务列表首屏加载 < 1.5s（正常网络），交互响应 < 300ms | 真机可感知流畅 | P0 |
| T-NF-02 | 兼容当前 APP 的 WebView 运行环境与移动端浏览器 | 真机验证通过 | P0 |
| T-NF-03 | 前端代码组织遵循现有约定：`src/pages/task/*` + `src/components/*` + `server/routes/task*.js` | 结构一致 | P0 |
| T-NF-04 | 路由与接口挂载**沿用现有项目框架**的组织方式 | 与现有模块的组织方式一致 | P0 |
| T-NF-05 | 数据量按「单项目千级任务 / 年」设计，无需分表 | 千级任务下列表与看板可用 | P1 |

### 3.14 异常与边界（T-EX）

| 编号 | 需求描述 | 处理约定 | 优先级 |
| --- | --- | --- | --- |
| T-EX-01 | 重复点击勾选 / 重复拖拽 | 前端防抖 + 后端幂等，状态最终一致 | P0 |
| T-EX-02 | 接口失败 / 断网 | 乐观更新回滚 + 提示，可重试 | P0 |
| T-EX-03 | 绑定配置被改为「不绑定」时，已在该列的已完成任务 | 保持当前列与状态不变，等待用户后续操作 | P0 |
| T-EX-04 | 任务状态与所在列绑定不一致（如在不绑定的 `Action` 中改为「完成」） | 触发自动归位：移入第一个绑定该状态的列；**无匹配列则不移动**，保留原列（见 T-BD-14~16） | P0 |
| T-EX-05 | 任务被拖到**未绑定状态**的列（如 `Action`），其原状态如何处理 | 原状态**保持不变**，不因离开原列而回退（不存在「拖出即回退」规则） | P0 |
| T-EX-06 | 项目成员被移除，其仍担任某任务负责人 / 成员 | 保留历史标记，展示为「已退出」样式；不报错、不清空 | P1 |
| T-EX-07 | 删除父任务 | 级联删除其子任务，确认弹窗提示「将一并删除 N 条子任务」 | P0 |
| T-EX-08 | 跨项目拷贝时负责人 / 成员不属于目标项目 | 仅保留属于目标项目成员者，其余丢弃并在结果中提示 | P1 |
| T-EX-09 | 个人默认项目尝试添加成员 / 尝试删除 | 接口返回明确错误，前端不提供入口 | P0 |
| T-EX-10 | 某列设为「当天」等档位且该列无符合条件的已完成任务 | 展示该列空态，不报错 | P0 |
| T-EX-11 | 项目成员清空后的项目 | 静默保留，前端不报错、不特殊提示 | P0 |
| T-EX-12 | 子任务所属项目与父任务不一致（绕过前端直接调用） | 后端拒绝并返回错误 | P0 |
| T-EX-13 | 拖拽成为子任务时，子任务的**看板列与状态**如何取值 | 保持自身原值不变，仅改变父子归属 | P1 |
| T-EX-14 | 跨项目拷贝时，源任务的状态 / 列在目标项目绑定规则下无对应关系 | 沿用源值落库，不强行纠正；由后续用户操作自然修正 | P1 |
| T-EX-15 | 拖拽将任务放到自身或其后代上 | 拒绝操作并提示，避免形成环形父子关系 | P0 |
| T-EX-16 | 删除仍有任务的列 | 二次确认后，该列任务迁移至**相邻列**（或由用户指定目标列），不产生无归属任务 | P0 |
| T-EX-17 | 删除唯一剩余的列 | **拒绝操作**并提示「至少保留一列」 | P0 |
| T-EX-19 | 新增列时已达列数上限 | 拒绝新增并提示已达上限，不产生空列 | P1 |
| T-EX-18 | 已完成任务跨周期（周一零点 / 月初零点）后应隐藏 | **当场消失**并带移除动画，其余任务平滑重排，不留空白 | P1 |

---

## 4. 优先级汇总（本期交付范围）

- **P0（必须）**：T-VW-01~04、T-VW-06~09；T-COL-01~07、T-COL-09、T-COL-10；T-BD-01~10、13~16；T-FL-01~13、15；T-TK-01~11；T-AS-01~05、07；T-ST-01~09、11~14；T-PJ-01~08、10~13；T-PM-01、02、04~07；T-CP-01~06、08；T-UI-01~05、07~11；T-DT-01~08；T-NF-01~04；T-EX-01~05、07、09~12、15~17。
- **P1（应该）**：T-VW-05、10；T-COL-08；T-BD-11、12；T-FL-14；T-TK-12、13；T-AS-06；T-ST-10、15；T-PJ-09；T-PM-03；T-CP-07、09；T-UI-06；T-DT-09；T-NF-05；T-EX-06、08、13、14、18、19。

---

## 5. 已决策问题（评审记录）

以下问题已在 2026-10-24 评审中确认，作为实现依据：

| # | 问题 | 决策 |
| --- | --- | --- |
| 1 | 列-状态绑定是单列还是多列？ | **每列独立配置**，允许**多列绑定同一状态**；默认 plan→未开始、doing→执行中、done→完成、action→不绑定（T-BD-02、03、09） |
| 2 | 保留档位的时间边界按自然日还是滚动小时？ | **自然日**（Asia/Shanghai，含今天 00:00 起）；本周按周一起算、本月按 1 日起算 |
| 3 | 视图记忆 / 显示配置存在设备端还是服务端？ | 视图记忆**设备端**、不跨设备；保留选项**项目级共享**（T-VW-06、T-FL-12、T-DT-06） |
| 4 | 删除父任务时子任务如何处理？ | **级联删除**，弹窗提示条数（T-EX-07） |
| 5 | 已完成任务在看板中的呈现？ | 由**该列的保留选项**控制显示与隐藏（T-FL-01~10） |
| 6 | 看板拖拽的移动端交互？ | **长按拖拽** + 「移动到」兜底；**允许拖拽降为子任务**（T-UI-07、T-ST-12） |
| 7 | 项目成员清空后是否需要本模块的管理入口？ | **本期不承担**，交后台；前端静默（T-PJ-08） |
| 8 | 扩展信息组的具体字段清单？ | **不固定字段**，改为**任意扩展信息卡片**（T-TK-04、05） |
| 9 | 已完成显示策略的粒度？ | 改为**按看板列独立的保留选项**（T-FL-01、02） |
| 10 | 是否单独要求 WebView / 登录态 / 返回键？ | **不单列**，沿用现有项目框架（T-NF-04、T-PM-05） |
| 11 | 同一状态被多列绑定，状态变化时进哪一列？ | **按当前列顺序取第一个匹配**（T-BD-06、15、B-3） |
| 12 | **从绑定列拖出**时状态是否回退？ | **不设「拖出即回退」规则**。只看**目标列**：目标列绑定了状态就按目标列改，未绑定则**保留原状态**（T-BD-07、B-4） |
| 13 | 列表视图如何处理「按列」的显示控制？ | 列表只是**不按列分组**，任务归属仍是原看板列，行为与看板**完全一致**（T-FL-11、B-6） |
| 14 | 看板卡片如何展示子任务？ | **在卡片内嵌套简洁展示**，可直接勾选；完整详情在卡片弹窗（T-ST-06、07） |
| 15 | 子任务是否受列-状态绑定影响？ | **不受**。子任务状态可与父任务不一致，拖入列不改写其状态（T-BD-13、T-ST-08、B-7） |
| 16 | 父任务能否整体挂到别的任务下？ | **不能**。含子任务的父任务不可被拖拽为子任务（T-ST-14） |
| 17 | 保留选项的取值范围？ | 固定 **6 档**：`永不显示` / `当天` / `3 天` / `本周` / `本月` / `永久显示`，不做自由输入（T-FL-02、B-5） |
| 18 | 任务状态与所在列绑定不一致时怎么处理？ | **触发自动归位**：查找绑定该状态的列并移入，按列序取第一个；**无匹配列则不移动**（T-BD-14~16、B-4b） |
| 19 | 卡片内嵌套的子任务是否显示自身状态？ | **显示小状态标记**，以区分与父任务不一致的状态（T-ST-09） |
| 20 | 任务模块入口放在哪里？ | 作为**顶级 Tab**，位置在**「打卡」之后**（T-PM-06） |

| 21 | 5 个底部 Tab 是否影响既有布局与默认首页？ | **暂无障碍**；默认首页**仍为打卡**（T-PM-06） |
| 22 | 任务状态为「完成」但所有列都未绑定「完成」时，列表视图按哪一列过滤？ | **保留在当前列**，按该列保留选项过滤。**不存在「已完成统一用 Done 列」的强制规则**，那只是默认配置下的自然效果，用户可完全自定义（T-FL-11） |
| 23 | 「本周 / 本月」跨周跨月时是否要求实时隐藏？ | **当场消失并带移除动画，其余任务平滑重排**；以刷新方式实现也可接受（T-EX-18） |
| 24 | 「上次访问的项目」记录在哪？无记录时如何？ | 记录在**设备端**；**无记录一律回个人默认项目**（T-VW-07、T-PM-07） |
| 25 | 看板列是否固定 4 列？ | **非固定**：默认 4 列，支持增删改与排序，数量可变，至少保留 1 列（T-COL-01~07） |

| 26 | 是否允许删除最后一个列？ | **不允许**。删除唯一剩余列时拒绝并提示，项目至少保留 1 列（T-COL-06、T-EX-17） |
| 27 | 新增列的默认设置？ | 按**默认值**：保留选项 `永久显示`、不绑定状态，**不继承**相邻列设置（T-COL-02、B-18） |
| 28 | 看板列数量上限？ | 暂定**上限 10 列**（`待确认`，见下） |
| 29 | 任务首屏结构？ | **上部** = 最近使用的 3 个项目卡片 + 「更多项目」入口；**下部** = 当前选中项目的任务管理视图，默认上次访问的项目（T-VW-08/09） |
| 30 | 首屏「任务卡片可以排序」的指代？ | 指**最近项目卡片**可长按拖动排序，结果存设备端；任务卡片的列内排序维持既有口径（T-VW-10） |
| 31 | 成员 / 列设置入口的位置？ | 统一收进「**项目管理**」入口（含成员、列设置、项目信息三区），项目页头部不再散置（T-PJ-11） |
| 32 | 项目信息管理包含什么？ | 改名、归档 / 取消归档、删除（个人项目禁用）、退出（创建人可退），入口在项目管理内（T-PJ-12） |
| 33 | 任务详情底部按钮遮挡？ | 弹层底部预留**安全区 + 12px** 距离；小屏下弹层可滚动，底部按钮完整可见（T-UI-11） |
| 34 | 项目相关长文本信息记录在哪？ | 项目管理内新增**信息块**分区：任意多个 {标题, 长文本} 块，独立编辑，属项目级数据（T-PJ-13） |
| 35 | 任务级「扩展信息」的去留？ | **移除 UI**（2026-10-24 评审）：任务不再带扩展信息，项目相关长文本由项目信息块（T-PJ-13）承载；DB 字段保留不用 |

**仍待评审确认（影响实现口径）：**

| # | 问题 | 说明 |
| --- | --- | --- |
| A | 列数量上限是否按 10 列？ | 现按「至少 1 列、至多 10 列」写入（T-COL-06）。若无需上限，可去掉上限约束 |

---

## 附录 A：核心实体草案（供设计阶段参考，非最终表结构）

```prisma
// 项目
model Project {
  id        Int      @id @default(autoincrement())
  name      String
  ownerId   Int                          // 创建人 (可退出项目, 故与成员表分离)
  isPersonal Boolean @default(false)     // true = 个人默认项目: 不可删、不可加成员
  archived  Boolean  @default(false)
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  members   ProjectMember[]
  columns   BoardColumn[]
  tasks     Task[]

  @@index([archived])
}

// 看板列 (项目级实体: 默认 4 列, 可增删改与排序)
model BoardColumn {
  id           Int     @id @default(autoincrement())
  projectId    Int
  project      Project @relation(fields: [projectId], references: [id], onDelete: Cascade)
  name         String                      // 列名, 项目内唯一
  sortOrder    Int     @default(0)         // 显示顺序, 决定自动归位时的"第一个匹配列"
  boundStatus  String?                     // null = 不绑定; todo | doing | done
  retention    String  @default("forever") // never | today | 3d | week | month | forever

  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  tasks Task[]

  @@unique([projectId, name])
  @@index([projectId, sortOrder])
}

// 项目成员 (权限单位: 在表内即全读写)
model ProjectMember {
  id        Int      @id @default(autoincrement())
  projectId Int
  project   Project  @relation(fields: [projectId], references: [id], onDelete: Cascade)
  userId    Int
  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
  permission String  @default("member")  // 预留权限分级入口, 本期恒为 member
  createdAt DateTime @default(now())

  @@unique([projectId, userId])
  @@index([userId])
}

// 任务 / 子任务 (parentId 为空 = 顶层任务)
model Task {
  id         Int      @id @default(autoincrement())
  projectId  Int
  project    Project  @relation(fields: [projectId], references: [id], onDelete: Cascade)
  parentId   Int?                        // 非空 = 一级子任务 (最多一层)
  parent     Task?    @relation("Subtask", fields: [parentId], references: [id], onDelete: Cascade)
  children   Task[]   @relation("Subtask")

  title       String
  description String  @default("")
  status      String  @default("todo")   // todo | doing | done
  columnId    Int                        // 所属看板列 (BoardColumn), 列可增删改故用 id 而非固定名
  column      BoardColumn @relation(fields: [columnId], references: [id])

  assigneeId Int?                        // 负责人 (可空; 新建默认 = 创建者)
  assignee   User?    @relation("Assignee", fields: [assigneeId], references: [id], onDelete: SetNull)
  creatorId  Int                         // 创建人 (跨项目拷贝时 = 操作者)
  creator    User     @relation("Creator", fields: [creatorId], references: [id])

  // 扩展信息卡片: 任意条目, 默认收起
  extras     Json     @default("[]")     // [{ label: "仓库", value: "gitlab/app", url: "" }]

  sortOrder  Int      @default(0)
  createdAt  DateTime @default(now())
  updatedAt  DateTime @updatedAt

  members    TaskMember[]
  tags       TaskTag[]

  @@index([projectId, columnId])
  @@index([projectId, status])
  @@index([parentId])
}

// 任务成员 (多人, 须为项目成员)
model TaskMember {
  id     Int  @id @default(autoincrement())
  taskId Int
  task   Task @relation(fields: [taskId], references: [id], onDelete: Cascade)
  userId Int
  user   User @relation(fields: [userId], references: [id], onDelete: Cascade)

  @@unique([taskId, userId])
}

// 任务标签
model TaskTag {
  id     Int    @id @default(autoincrement())
  taskId Int
  task   Task   @relation(fields: [taskId], references: [id], onDelete: Cascade)
  name   String
  @@index([taskId])
}
```

> 说明：
> 1. `status` 与 `columnId` **两个字段都落库**（而非互相推导），因为未绑定的列需要二者彼此独立；联动仅在项目配置了绑定的列/状态之间发生，由服务端统一裁决。
> 2. 保留选项的判定依赖「在该列的完成时间」，建议在任务上记录完成时间或按列迁移时间计算，具体口径在设计阶段确定。
> 3. 视图记忆存设备端（localStorage），不落库。

---

## 附录 B：实现约定（开发期补充，用于消除口径歧义）

| # | 约定 | 说明 |
| --- | --- | --- |
| B-1 | **看板列** | 列是项目级实体（`BoardColumn`），含名称与顺序；默认 4 列 `Plan/Doing/Action/Done`；支持增删改与排序，至少保留 1 列 |
| B-2 | **列-状态绑定** | `columnBindings` 为「列 → 状态或 null」映射；null 表示不绑定；**允许多列指向同一状态**；状态枚举 `todo` / `doing` / `done` |
| B-3 | **多列绑定同一状态时的目标列** | 移入列时按**当前列顺序**取**第一个**绑定该状态的列（列顺序可被用户调整） |
| B-4 | **列决定状态** | 拖动任务时只看**目标列**：目标列绑定了状态 ⇒ 状态 = 所绑定状态（含从任意列拖入）；目标列未绑定 ⇒ 状态保持原值。**不存在「从某列拖出即回退」的规则** |
| B-4b | **状态与列不一致时的自动归位** | 状态改变后，若当前所在列未绑定该状态 ⇒ 按列序取第一个绑定该状态的列并移入；**无匹配列则不移动**，状态照常改变 |
| B-5 | **列保留选项** | `columnRetention` 为「列 → 选项」映射，选项为固定 6 档：`never`（永不显示）/ `today`（当天）/ `3d`（3 天）/ `week`（本周）/ `month`（本月）/ `forever`（永久显示） |
| B-5b | **各档位口径** | 均按 Asia/Shanghai 自然日：`today` = 今天；`3d` = 含今天在内的最近 3 天；`week` = 本周一 00:00 起；`month` = 本月 1 日 00:00 起；判定依据为任务的**完成时间** |
| B-6 | **显示控制作用域** | 列表视图与看板视图**同样**按任务**当前所属列**的保留选项执行过滤；列表只是不按列分组，归属不变；未完成任务不受影响 |
| B-7 | **子任务与绑定无关** | 子任务状态**不受**看板列-状态绑定影响：拖入列不改写子任务状态，修改子任务状态也不触发「移入列」 |
| B-8 | **子任务约束** | `parentId` 非空时：父任务 `parentId` 必须为空（禁止二级）；`projectId` 必须与父任务一致；禁止指向自身或后代 |
| B-9 | **拖拽降为子任务** | 长按拖动任务 A 到任务 B 上释放 ⇒ A.parentId = B.id；要求 B 为顶层任务且 A 本身无子任务，否则拒绝 |
| B-10 | **负责人默认值** | 新建任务时若未显式指定，`assigneeId` 默认取创建者的 userId；显式传 null 表示清空 |
| B-11 | **个人默认项目** | `isPersonal = true`；服务端拒绝「添加成员」「删除项目」；名称初始为 `{用户名}的任务`，可改名 |
| B-12 | **成员清空** | 移除最后一名成员时不删除 `Project`，仅删除 `ProjectMember` 记录；前端不特判 |
| B-13 | **跨项目拷贝** | 新建任务（新 id）+ 复制全部字段、扩展卡片与子任务；`creatorId` = 操作者；负责人 / 成员按 T-EX-08 过滤；状态与列按 T-EX-14 沿用 |
| B-14 | **权限校验** | 所有项目 / 任务接口均先校验「请求者为该项目成员」，非成员返回 403 |
| B-15 | **偏好存储** | 视图记忆与「上次访问的项目」存设备端；列定义、列-状态绑定、列保留选项属项目配置，存服务端、项目内共享 |
| B-16 | **看板列实体** | 列为 `BoardColumn`（name / sortOrder / boundStatus / retention）；默认 4 列由新建项目时初始化；至少保留 1 列；列名项目内唯一 |
| B-17 | **删除列的迁移** | 删除列前需二次确认；列内任务迁移至指定列（默认相邻列），迁移后任务状态按目标列绑定重新裁决；**唯一剩余列不可删除** |
| B-18 | **新增列默认值** | 新增列取默认值：`retention = forever`、`boundStatus = null`，**不继承**相邻列配置；`sortOrder` 追加到末尾 |
| B-19 | **列数上限** | 至少 1 列、至多 10 列（上限待确认） |