feat(任务模块): 任务归档 T-ARC-01~08 实现

- 数据: Project.autoArchive + Task.archived/archivedAt/archiveSource,
  迁移 20261026000000_task_archive (两索引)
- 领域: server/task-domain/archive.js —— hiddenAtOf 与保留口径精确同源,
  autoArchiveDue 到期判定, runAutoArchiveForProject (读时惰性) +
  runAutoArchiveSweep (每小时 cron 兜底)
- 接口: POST /tasks/:id/archive|unarchive (连带子任务, 幂等);
  GET /projects/:id/tasks/archived (keyword/kind/columnId/from/to 过滤,
  archivedAt+id 游标分页); 项目 PUT 收 autoArchive (枚举校验);
  主列表/子任务/项目 taskCount 全部排除归档
- 前端: ⋯ 菜单「归档」(确认含子任务条数); 项目栏「已归档」入口 →
  ArchivedTasks 弹层 (关键词/类型/列/归档时段过滤 + 加载更多 + 恢复/删除);
  项目管理「归档设置」四档 Picker

server/routes/tasks.js

@@ -8,10 +8,13 @@ import {
 import { resolveTaskWrite } from '../task-domain/resolveStatus.js'
 import { filterVisible } from '../task-domain/retention.js'
 import { copyTask } from '../task-domain/copyTask.js'
+import { runAutoArchiveForProject } from '../task-domain/archive.js'
 
 const router = Router()
 router.use(authRequired)
 
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/
+
 const TASK_INCLUDE = {
   column: true,
   assignee: { select: { id: true, name: true } },
@@ -19,6 +22,7 @@ const TASK_INCLUDE = {
   members: { include: { user: { select: { id: true, name: true } } } },
   tags: true,
   children: {
+    where: { archived: false },
     include: {
       column: true,
       assignee: { select: { id: true, name: true } },
@@ -50,9 +54,12 @@ router.get('/projects/:id/tasks', async (req, res, next) => {
     const project = await loadProjectForUser(req.params.id, userId)
     if (!project) return res.status(404).json({ error: '项目不存在或无权限' })
 
+    // 读时惰性自动归档 (T-ARC-02): 保证刚到期的隐藏任务当场消失
+    await runAutoArchiveForProject(project.id)
+
     const columns = await loadColumns(project.id)
     const rows = await prisma.task.findMany({
-      where: { projectId: project.id, parentId: null },
+      where: { projectId: project.id, parentId: null, archived: false },
       include: TASK_INCLUDE,
       orderBy: [{ sortOrder: 'asc' }, { createdAt: 'asc' }],
     })
@@ -63,6 +70,82 @@ router.get('/projects/:id/tasks', async (req, res, next) => {
   } catch (e) { next(e) }
 })
 
+// ---------- 归档 (T-ARC) ----------
+
+// POST /api/tasks/:id/archive  手动归档: 连带全部子任务, 幂等
+router.post('/tasks/:id/archive', async (req, res, next) => {
+  try {
+    const userId = req.user.sub
+    const found = await loadTaskForUser(req.params.id, userId)
+    if (!found) return res.status(404).json({ error: '任务不存在或无权限' })
+    const { task } = found
+    const children = await prisma.task.findMany({ where: { parentId: task.id }, select: { id: true } })
+    const r = await prisma.task.updateMany({
+      where: { id: { in: [task.id, ...children.map((c) => c.id)] } },
+      data: { archived: true, archivedAt: new Date(), archiveSource: 'manual' },
+    })
+    res.json({ ok: true, count: r.count })
+  } catch (e) { next(e) }
+})
+
+// POST /api/tasks/:id/unarchive  恢复: 回原列, 状态不变, 连带子任务
+router.post('/tasks/:id/unarchive', async (req, res, next) => {
+  try {
+    const userId = req.user.sub
+    const found = await loadTaskForUser(req.params.id, userId)
+    if (!found) return res.status(404).json({ error: '任务不存在或无权限' })
+    const { task } = found
+    const children = await prisma.task.findMany({ where: { parentId: task.id }, select: { id: true } })
+    const r = await prisma.task.updateMany({
+      where: { id: { in: [task.id, ...children.map((c) => c.id)] } },
+      data: { archived: false, archivedAt: null, archiveSource: null },
+    })
+    res.json({ ok: true, count: r.count })
+  } catch (e) { next(e) }
+})
+
+// GET /api/projects/:id/tasks/archived  已归档查询: 过滤 + 游标分页 (T-ARC-04)
+router.get('/projects/:id/tasks/archived', async (req, res, next) => {
+  try {
+    const userId = req.user.sub
+    const project = await loadProjectForUser(req.params.id, userId)
+    if (!project) return res.status(404).json({ error: '项目不存在或无权限' })
+
+    const q = req.query || {}
+    const where = { projectId: project.id, archived: true, parentId: null }
+    if (q.keyword) where.title = { contains: String(q.keyword).trim() }
+    if (q.kind) where.kind = String(q.kind)
+    if (q.columnId && Number.isFinite(Number(q.columnId))) where.columnId = Number(q.columnId)
+    if (q.from && DATE_RE.test(q.from)) where.archivedAt = { ...(where.archivedAt || {}), gte: new Date(q.from + 'T00:00:00+08:00') }
+    if (q.to && DATE_RE.test(q.to)) where.archivedAt = { ...(where.archivedAt || {}), lte: new Date(q.to + 'T23:59:59.999+08:00') }
+
+    const limit = Math.min(100, Math.max(1, Number(q.limit) || 20))
+    if (q.cursor) {
+      const [ts, id] = String(q.cursor).split('|')
+      const t = new Date(ts)
+      if (Number.isNaN(t.getTime()) || !Number.isFinite(Number(id))) {
+        return res.status(400).json({ error: 'cursor 无效' })
+      }
+      where.OR = [
+        { archivedAt: { lt: t } },
+        { archivedAt: t, id: { lt: Number(id) } },
+      ]
+    }
+
+    const rows = await prisma.task.findMany({
+      where,
+      include: TASK_INCLUDE,
+      orderBy: [{ archivedAt: 'desc' }, { id: 'desc' }],
+      take: limit + 1,
+    })
+    const hasMore = rows.length > limit
+    const page = rows.slice(0, limit)
+    const last = page[page.length - 1]
+    const nextCursor = hasMore && last ? `${last.archivedAt.toISOString()}|${last.id}` : null
+    res.json({ items: page.map(shape), nextCursor })
+  } catch (e) { next(e) }
+})
+
 // POST /api/projects/:id/tasks  { title, description?, parentId?, assigneeId?, memberIds?, tags? }
 router.post('/projects/:id/tasks', async (req, res, next) => {
   try {