feat(V0.2): 任务模块 —— 项目 / 列表与看板 / 列-状态绑定 / 一级子任务

需求 142 条 (T-*), 设计见 docs/V0.2/任务模块/ 数据层: - 新增 6 张表: Project / ProjectMember / BoardColumn / Task / TaskMember / TaskTag - 看板列是实体(可增删改排序), Task.columnId 外键 RESTRICT 防误删列丢任务 - Task.status(todo/doing/done) 与 columnId 双落库, 二者正交领域层 server/task-domain/ (唯一口径, 前后端不重复实现): - resolveStatus: 列决定状态(只看目标列, 无拖出回退); 状态与列不匹配时按列序取第一个绑定该状态的列自动归位, 无匹配列则不移动; 子任务完全豁免 - retention: 逐列 6 档保留窗口(永不显示/当天/3天/本周/本月/永久显示), 以 doneAt 判定 - copyTask: 跨项目深拷贝, 人员按目标项目成员过滤并回报丢弃名单接口: /api/projects, /api/columns, /api/tasks (均校验项目成员) 前端: - 底部 Tab 插入「任务」, 位于「打卡」之后; 默认首页仍为打卡 - 列表视图(子任务缩进+折叠) / 看板视图(长按拖拽换列、拖到卡片降为子任务) - 列设置(列管理+状态绑定+保留选项) / 任务详情(扩展信息卡片默认收起) / 成员管理 - 视图记忆与上次项目存设备端已验证: 95 文件语法 0 错误、相对导入 0 缺失、领域逻辑用例全部通过
2026-10-24 11:21:16 +08:00
parent 42acf72f1e
commit 6c9cd3fd99
36 changed files with 6194 additions and 0 deletions
@@ -0,0 +1,328 @@
+// 任务模块: 项目 / 成员 / 看板列
+import { Router } from 'express'
+import { prisma } from '../db.js'
+import { authRequired } from '../middleware.js'
+import { loadProjectForUser, loadColumns, loadMemberIds } from '../task-domain/access.js'
+
+const router = Router()
+router.use(authRequired)
+
+// 新建项目时的默认 4 列 (T-COL-01, T-BD-09)
+export const DEFAULT_COLUMNS = [
+  { name: 'Plan',   sortOrder: 0, boundStatus: 'todo' },
+  { name: 'Doing',  sortOrder: 1, boundStatus: 'doing' },
+  { name: 'Action', sortOrder: 2, boundStatus: null },
+  { name: 'Done',   sortOrder: 3, boundStatus: 'done' },
+]
+
+export const MAX_COLUMNS = 10
+const MAX_NAME = 20
+
+/** 建 4 个默认列 */
+async function createDefaultColumns(projectId) {
+  await prisma.boardColumn.createMany({
+    data: DEFAULT_COLUMNS.map((c) => ({ ...c, projectId, retention: 'forever' })),
+  })
+}
+
+/** 确保用户有一个个人默认项目 (T-PJ-01), 幂等 */
+export async function ensurePersonalProject(userId) {
+  const exist = await prisma.project.findFirst({ where: { ownerId: userId, isPersonal: true } })
+  if (exist) return exist
+  const user = await prisma.user.findUnique({ where: { id: userId }, select: { name: true } })
+  const name = `${user?.name || '我'}的任务`
+  const project = await prisma.project.create({
+    data: { name, ownerId: userId, isPersonal: true, members: { create: { userId } } },
+  })
+  await createDefaultColumns(project.id)
+  return project
+}
+
+function projectSummary(p) {
+  return {
+    id: p.id,
+    name: p.name,
+    ownerId: p.ownerId,
+    isPersonal: p.isPersonal,
+    archived: p.archived,
+    createdAt: p.createdAt,
+    updatedAt: p.updatedAt,
+    memberCount: p._count?.members ?? undefined,
+    taskCount: p._count?.tasks ?? undefined,
+  }
+}
+
+// ---------- 项目 ----------
+
+// GET /api/projects   我参与的项目
+router.get('/', async (req, res, next) => {
+  try {
+    const userId = req.user.sub
+    await ensurePersonalProject(userId)
+    const rows = await prisma.project.findMany({
+      where: { members: { some: { userId } } },
+      include: { _count: { select: { members: true, tasks: true } } },
+      orderBy: [{ archived: 'asc' }, { updatedAt: 'desc' }],
+    })
+    res.json({ items: rows.map(projectSummary) })
+  } catch (e) { next(e) }
+})
+
+// POST /api/projects  { name }
+router.post('/', async (req, res, next) => {
+  try {
+    const userId = req.user.sub
+    const name = String(req.body?.name || '').trim()
+    if (!name) return res.status(400).json({ error: '项目名称不能为空' })
+    if (name.length > MAX_NAME) return res.status(400).json({ error: `项目名称不能超过 ${MAX_NAME} 字` })
+
+    const project = await prisma.project.create({
+      data: { name, ownerId: userId, isPersonal: false, members: { create: { userId } } },
+    })
+    await createDefaultColumns(project.id)
+    const full = await prisma.project.findUnique({
+      where: { id: project.id },
+      include: { _count: { select: { members: true, tasks: true } } },
+    })
+    res.json({ item: projectSummary(full) })
+  } catch (e) { next(e) }
+})
+
+// GET /api/projects/:id   详情(项目 + 成员 + 列)
+router.get('/:id', 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 [members, columns] = await Promise.all([
+      prisma.projectMember.findMany({
+        where: { projectId: project.id },
+        include: { user: { select: { id: true, name: true, email: true } } },
+        orderBy: { createdAt: 'asc' },
+      }),
+      loadColumns(project.id),
+    ])
+    res.json({
+      item: {
+        ...projectSummary(project),
+        members: members.map((m) => ({ userId: m.userId, name: m.user.name, email: m.user.email, permission: m.permission })),
+        columns,
+      },
+    })
+  } catch (e) { next(e) }
+})
+
+// PUT /api/projects/:id  { name?, archived? }
+router.put('/:id', 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 { name, archived } = req.body || {}
+    const data = {}
+    if (name !== undefined) {
+      const t = String(name).trim()
+      if (!t) return res.status(400).json({ error: '项目名称不能为空' })
+      if (t.length > MAX_NAME) return res.status(400).json({ error: `项目名称不能超过 ${MAX_NAME} 字` })
+      data.name = t
+    }
+    if (archived !== undefined) data.archived = !!archived
+    const row = await prisma.project.update({ where: { id: project.id }, data })
+    res.json({ item: projectSummary(row) })
+  } catch (e) { next(e) }
+})
+
+// DELETE /api/projects/:id   个人项目拒绝 (T-PJ-02, T-EX-09)
+router.delete('/:id', 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: '项目不存在或无权限' })
+    if (project.isPersonal) return res.status(400).json({ error: '个人默认项目不可删除' })
+    await prisma.project.delete({ where: { id: project.id } })
+    res.json({ ok: true })
+  } catch (e) { next(e) }
+})
+
+// ---------- 成员 ----------
+
+// POST /api/projects/:id/members  { userId } | { email }
+router.post('/:id/members', 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: '项目不存在或无权限' })
+    if (project.isPersonal) return res.status(400).json({ error: '个人默认项目不可添加成员' })
+
+    const { userId: targetId, email } = req.body || {}
+    let target = null
+    if (targetId) target = await prisma.user.findUnique({ where: { id: Number(targetId) } })
+    else if (email) target = await prisma.user.findFirst({ where: { email: String(email).trim() } })
+    if (!target) return res.status(404).json({ error: '用户不存在' })
+
+    const exist = await prisma.projectMember.findUnique({
+      where: { projectId_userId: { projectId: project.id, userId: target.id } },
+    })
+    if (exist) return res.status(409).json({ error: '该用户已是项目成员' })
+
+    await prisma.projectMember.create({ data: { projectId: project.id, userId: target.id } })
+    res.json({ ok: true, member: { userId: target.id, name: target.name } })
+  } catch (e) { next(e) }
+})
+
+// DELETE /api/projects/:id/members/:uid   移除成员 / 自己退出 (T-PJ-06/07)
+router.delete('/:id/members/:uid', 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: '项目不存在或无权限' })
+    if (project.isPersonal) return res.status(400).json({ error: '个人默认项目不可移除成员' })
+
+    const target = Number(req.params.uid)
+    // 只能移除自己, 或是创建人移除他人 (本期权限均等, 允许成员自退)
+    if (target !== userId && project.ownerId !== userId) {
+      return res.status(403).json({ error: '只能移除自己，或由创建人移除他人' })
+    }
+    await prisma.projectMember.deleteMany({ where: { projectId: project.id, userId: target } })
+    // 成员清空后项目静默保留 (T-PJ-08)
+    res.json({ ok: true })
+  } catch (e) { next(e) }
+})
+
+// ---------- 看板列 ----------
+
+// GET /api/projects/:id/columns
+router.get('/:id/columns', 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: '项目不存在或无权限' })
+    res.json({ items: await loadColumns(project.id) })
+  } catch (e) { next(e) }
+})
+
+// POST /api/projects/:id/columns  { name }
+router.post('/:id/columns', 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 name = String(req.body?.name || '').trim()
+    if (!name) return res.status(400).json({ error: '列名不能为空' })
+    if (name.length > MAX_NAME) return res.status(400).json({ error: `列名不能超过 ${MAX_NAME} 字` })
+
+    const cols = await loadColumns(project.id)
+    if (cols.length >= MAX_COLUMNS) return res.status(400).json({ error: `最多 ${MAX_COLUMNS} 列` })
+    if (cols.some((c) => c.name === name)) return res.status(409).json({ error: '列名已存在' })
+
+    const row = await prisma.boardColumn.create({
+      data: {
+        projectId: project.id,
+        name,
+        sortOrder: cols.length ? Math.max(...cols.map((c) => c.sortOrder)) + 1 : 0,
+        boundStatus: null,
+        retention: 'forever',
+      },
+    })
+    res.json({ item: row })
+  } catch (e) { next(e) }
+})
+
+// PUT /api/projects/:id/columns/order  { ids: number[] }
+router.put('/:id/columns/order', 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 ids = Array.isArray(req.body?.ids) ? req.body.ids.map(Number) : []
+    const cols = await loadColumns(project.id)
+    if (ids.length !== cols.length) return res.status(400).json({ error: '列数量不匹配' })
+
+    await prisma.$transaction(
+      ids.map((id, idx) => prisma.boardColumn.update({ where: { id }, data: { sortOrder: idx } })),
+    )
+    res.json({ items: await loadColumns(project.id) })
+  } catch (e) { next(e) }
+})
+
+// PUT /api/columns/:id  { name?, boundStatus?, retention? }
+export const columnRouter = Router()
+columnRouter.use(authRequired)
+
+columnRouter.put('/:id', async (req, res, next) => {
+  try {
+    const userId = req.user.sub
+    const id = Number(req.params.id)
+    const col = await prisma.boardColumn.findUnique({ where: { id } })
+    if (!col) return res.status(404).json({ error: '列不存在' })
+    const project = await loadProjectForUser(col.projectId, userId)
+    if (!project) return res.status(404).json({ error: '项目不存在或无权限' })
+
+    const { name, boundStatus, retention } = req.body || {}
+    const data = {}
+    if (name !== undefined) {
+      const t = String(name).trim()
+      if (!t) return res.status(400).json({ error: '列名不能为空' })
+      if (t.length > MAX_NAME) return res.status(400).json({ error: `列名不能超过 ${MAX_NAME} 字` })
+      const dup = await prisma.boardColumn.findFirst({ where: { projectId: col.projectId, name: t, NOT: { id } } })
+      if (dup) return res.status(409).json({ error: '列名已存在' })
+      data.name = t
+    }
+    if (boundStatus !== undefined) {
+      // null | todo | doing | done
+      if (boundStatus !== null && !['todo', 'doing', 'done'].includes(boundStatus)) {
+        return res.status(400).json({ error: '绑定状态取值非法' })
+      }
+      data.boundStatus = boundStatus
+    }
+    if (retention !== undefined) {
+      if (!['never', 'today', '3d', 'week', 'month', 'forever'].includes(retention)) {
+        return res.status(400).json({ error: '保留选项取值非法' })
+      }
+      data.retention = retention
+    }
+    const row = await prisma.boardColumn.update({ where: { id }, data })
+    res.json({ item: row })
+  } catch (e) { next(e) }
+})
+
+// DELETE /api/columns/:id?moveToColumnId=N   删列并迁移任务 (T-COL-04, T-EX-16/17)
+columnRouter.delete('/:id', async (req, res, next) => {
+  try {
+    const userId = req.user.sub
+    const id = Number(req.params.id)
+    const col = await prisma.boardColumn.findUnique({ where: { id } })
+    if (!col) return res.status(404).json({ error: '列不存在' })
+    const project = await loadProjectForUser(col.projectId, userId)
+    if (!project) return res.status(404).json({ error: '项目不存在或无权限' })
+
+    const cols = await loadColumns(col.projectId)
+    if (cols.length <= 1) return res.status(400).json({ error: '至少保留一列' })
+
+    // 迁移目标: 指定列 否则相邻列(优先后一个, 没有则前一个)
+    let targetId = Number(req.query.moveToColumnId) || 0
+    if (!targetId) {
+      const idx = cols.findIndex((c) => c.id === id)
+      targetId = (cols[idx + 1] || cols[idx - 1]).id
+    }
+    const target = cols.find((c) => c.id === targetId)
+    if (!target || target.id === id) return res.status(400).json({ error: '迁移目标列非法' })
+
+    // 迁移任务: 状态按目标列绑定重新裁决 (设计文档 §2.4)
+    const tasks = await prisma.task.findMany({ where: { columnId: id } })
+    const newStatus = target.boundStatus || null
+    await prisma.task.updateMany({
+      where: { columnId: id },
+      data: {
+        columnId: target.id,
+        ...(newStatus ? { status: newStatus } : {}),
+      },
+    })
+    await prisma.boardColumn.delete({ where: { id } })
+    res.json({ ok: true, moved: tasks.length, toColumnId: target.id })
+  } catch (e) { next(e) }
+})
+
+export { createDefaultColumns, loadMemberIds }
+export default router