feat(0.2.1): M3 前端接入 —— PowerSyncProvider/登录连接/登出清库, 任务模块数据层切本地库 (projectApi/columnApi/taskApi 本地实现, 离线读写+自动上行), 任务编号徽标展示

2026-10-26 00:41:51 +08:00
parent 1a695920ce
commit a714013e3e
13 changed files with 771 additions and 48 deletions
@@ -26,6 +26,16 @@ export function setRememberFlag(v) {
  else localStorage.removeItem(REMEMBER_KEY)
 }

+// 当前用户 id (0.2.1 离线写入需要 ownerId/creatorId, 本地库无法即时从服务端获取)
+const UID_KEY = 'iboard_uid'
+export function getCurrentUserId() {
+  return localStorage.getItem(UID_KEY) || ''
+}
+export function setCurrentUserId(id) {
+  if (id !== null && id !== undefined && id !== '') localStorage.setItem(UID_KEY, String(id))
+  else localStorage.removeItem(UID_KEY)
+}
+
 export function getApiBase() {
  return API_BASE
 }
@@ -1,41 +1,683 @@
-import { api } from './client.js'
+// 任务模块数据层 (0.2.1): 已切换为 PowerSync 本地 SQLite
+//   - 读: 全部来自本地库 (离线可用); 写: 本地写入 -> upload queue -> /api/powersync/upload (按 uuid 幂等)
+//   - 对页面保持与原 REST 版一致的调用签名与响应形状 (projectApi / columnApi / taskApi)
+//   - 编号: Project.code / Task.number 由服务端统一分配, 本地新建行同步前分别为空 -> 展示占位
+// 见 docs/V0.2/离线编辑模块/0.2.1实施方案.md
+import { getPowersyncDb } from '../lib/powersync/db.js'
+import { api, getCurrentUserId } from './client.js'
+import { filterVisible } from '../pages/task/date.js'

-const q = (params) => {
-  const s = new URLSearchParams()
-  Object.entries(params || {}).forEach(([k, v]) => {
-    if (v !== undefined && v !== null && v !== '') s.set(k, v)
-  })
-  const str = s.toString()
-  return str ? '?' + str : ''
+const db = () => getPowersyncDb()
+
+const uuid = () => crypto.randomUUID()
+const now = () => new Date().toISOString()
+const parseJson = (v, fallback) => {
+  if (v === null || v === undefined || v === '') return fallback
+  if (typeof v !== 'string') return v
+  try { return JSON.parse(v) } catch { return fallback }
 }

-// 项目
+// 新建项目时的默认 4 列 (与服务端 DEFAULT_COLUMNS 一致)
+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 DEFAULT_TASK_KINDS = ['需求', 'Bug', 'FEATURE', '优化']
+const MAX_NAME = 20
+
+function normTaskKinds(v) {
+  if (!Array.isArray(v)) return null
+  const out = []
+  for (const k of v) {
+    const s = String(k || '').trim().slice(0, 20)
+    if (s && !out.includes(s)) out.push(s)
+    if (out.length >= 30) break
+  }
+  return out
+}
+
+// ---------- 查询助手 ----------
+
+async function getColumns(projectId) {
+  return db().getAll(
+    'SELECT * FROM BoardColumn WHERE projectId = ? ORDER BY sortOrder, id',
+    [String(projectId)],
+  )
+}
+
+async function getProjectMembers(projectId) {
+  const rows = await db().getAll(
+    `SELECT pm.userId, pm.permission, u.name, u.email
+       FROM ProjectMember pm LEFT JOIN User u ON u.id = pm.userId
+      WHERE pm.projectId = ? ORDER BY pm.createdAt, pm.id`,
+    [String(projectId)],
+  )
+  return rows.map((r) => ({ userId: String(r.userId), name: r.name || String(r.userId), email: r.email || '', permission: r.permission || 'member' }))
+}
+
+function memberMapOf(members) {
+  return new Map(members.map((m) => [m.userId, { id: m.userId, name: m.name }]))
+}
+
+async function shapeTasks(rows, columns) {
+  const columnById = new Map(columns.map((c) => [String(c.id), c]))
+  const projectIds = [...new Set(rows.map((r) => String(r.projectId)))]
+  let membersByProject = new Map()
+  if (projectIds.length) {
+    const ph = projectIds.map(() => '?').join(',')
+    const pmRows = await db().getAll(
+      `SELECT pm.projectId, pm.userId, u.name FROM ProjectMember pm LEFT JOIN User u ON u.id = pm.userId WHERE pm.projectId IN (${ph})`,
+      projectIds,
+    )
+    membersByProject = new Map(projectIds.map((pid) => [pid, new Map()]))
+    for (const r of pmRows) {
+      membersByProject.get(String(r.projectId)).set(String(r.userId), { id: String(r.userId), name: r.name || String(r.userId) })
+    }
+  }
+  const taskIds = rows.map((r) => String(r.id))
+  const memberRows = taskIds.length
+    ? await db().getAll(
+        `SELECT tm.taskId, tm.userId, u.name FROM TaskMember tm LEFT JOIN User u ON u.id = tm.userId WHERE tm.taskId IN (${taskIds.map(() => '?').join(',')})`,
+        taskIds,
+      )
+    : []
+  const tagRows = taskIds.length
+    ? await db().getAll(`SELECT taskId, name FROM TaskTag WHERE taskId IN (${taskIds.map(() => '?').join(',')})`, taskIds)
+    : []
+  const membersByTask = new Map()
+  for (const r of memberRows) {
+    const k = String(r.taskId)
+    if (!membersByTask.has(k)) membersByTask.set(k, [])
+    membersByTask.get(k).push({ userId: String(r.userId), name: r.name || String(r.userId) })
+  }
+  const tagsByTask = new Map()
+  for (const r of tagRows) {
+    const k = String(r.taskId)
+    if (!tagsByTask.has(k)) tagsByTask.set(k, [])
+    tagsByTask.get(k).push(r.name)
+  }
+
+  const shapeOne = (t) => {
+    const members = membersByTask.get(String(t.id)) || []
+    const usersByProject = membersByProject.get(String(t.projectId)) || new Map()
+    return {
+      ...t,
+      extras: parseJson(t.extras, []),
+      column: columnById.get(String(t.columnId)) || null,
+      assignee: t.assigneeId ? (usersByProject.get(String(t.assigneeId)) || { id: String(t.assigneeId), name: String(t.assigneeId) }) : null,
+      members,
+      tags: tagsByTask.get(String(t.id)) || [],
+    }
+  }
+  return shapeOne
+}
+
+function projectSummary(p, memberCount, taskCount) {
+  return {
+    id: String(p.id),
+    uuid: p.uuid,
+    code: p.code || null,
+    name: p.name,
+    ownerId: String(p.ownerId),
+    isPersonal: !!p.isPersonal,
+    archived: !!p.archived,
+    createdAt: p.createdAt,
+    updatedAt: p.updatedAt,
+    taskKinds: normTaskKinds(parseJson(p.taskKinds, null)) || DEFAULT_TASK_KINDS,
+    icon: p.icon || null,
+    memberCount,
+    taskCount,
+  }
+}
+
+function assertUser() {
+  const uid = getCurrentUserId()
+  if (!uid) throw new Error('未登录')
+  return String(uid)
+}
+
+// ---------- 项目 ----------
+
 export const projectApi = {
-  list: () => api('/projects'),
-  detail: (id) => api(`/projects/${id}`),
-  create: (body) => api('/projects', { method: 'POST', body }),
-  update: (id, body) => api(`/projects/${id}`, { method: 'PUT', body }),
-  remove: (id) => api(`/projects/${id}`, { method: 'DELETE' }),
-  addMember: (id, body) => api(`/projects/${id}/members`, { method: 'POST', body }),
-  removeMember: (id, uid) => api(`/projects/${id}/members/${uid}`, { method: 'DELETE' }),
+  // 我参与的项目 (本地库; 个人默认项目缺失且在线时回源一次让服务端补建)
+  list: async () => {
+    const uid = assertUser()
+    let rows = await db().getAll(
+      `SELECT p.* FROM Project p WHERE p.id IN (SELECT pm.projectId FROM ProjectMember pm WHERE pm.userId = ?)
+        ORDER BY p.archived, p.updatedAt DESC`,
+      [uid],
+    )
+    if (!rows.some((r) => !!r.isPersonal && String(r.ownerId) === uid)) {
+      try {
+        await api('/projects')
+        await new Promise((r) => setTimeout(r, 1200))
+        rows = await db().getAll(
+          `SELECT p.* FROM Project p WHERE p.id IN (SELECT pm.projectId FROM ProjectMember pm WHERE pm.userId = ?)
+            ORDER BY p.archived, p.updatedAt DESC`,
+          [uid],
+        )
+      } catch { /* 离线: 无个人项目则跳过 */ }
+    }
+    const items = []
+    for (const p of rows) {
+      const memberCount = await db().getOptional('SELECT COUNT(*) AS n FROM ProjectMember WHERE projectId = ?', [String(p.id)])
+      const taskCount = await db().getOptional('SELECT COUNT(*) AS n FROM Task WHERE projectId = ?', [String(p.id)])
+      items.push(projectSummary(p, memberCount?.n || 0, taskCount?.n || 0))
+    }
+    return { items }
+  },
+
+  detail: async (id) => {
+    const p = await db().getOptional('SELECT * FROM Project WHERE id = ?', [String(id)])
+    if (!p) throw new Error('项目不存在或无权限')
+    const members = await getProjectMembers(p.id)
+    const columns = await getColumns(p.id)
+    const taskCount = await db().getOptional('SELECT COUNT(*) AS n FROM Task WHERE projectId = ?', [String(p.id)])
+    return {
+      item: {
+        ...projectSummary(p, members.length, taskCount?.n || 0),
+        members,
+        columns,
+        notes: parseJson(p.notes, []),
+      },
+    }
+  },
+
+  create: async (body) => {
+    const uid = assertUser()
+    const name = String(body?.name || '').trim()
+    if (!name) throw new Error('项目名称不能为空')
+    if (name.length > MAX_NAME) throw new Error(`项目名称不能超过 ${MAX_NAME} 字`)
+    let code = null
+    const rawCode = body?.code
+    if (rawCode !== undefined && rawCode !== null && String(rawCode).trim() !== '') {
+      code = String(rawCode).trim().toUpperCase()
+      if (!/^[A-Z0-9]{2,8}$/.test(code)) throw new Error('项目编号须为 2~8 位字母数字')
+      const dup = await db().getOptional('SELECT id FROM Project WHERE code = ?', [code])
+      if (dup) throw new Error(`项目编号 ${code} 已被占用`)
+    }
+    const id = uuid()
+    const ts = now()
+    await db().writeTransaction(async (tx) => {
+      await tx.execute(
+        'INSERT INTO Project (id, uuid, code, name, ownerId, isPersonal, archived, notes, taskKinds, icon, createdAt, updatedAt) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)',
+        [id, id, code, name, uid, 0, 0, '[]', null, null, ts, ts],
+      )
+      await tx.execute(
+        'INSERT INTO ProjectMember (id, uuid, projectId, userId, permission, createdAt) VALUES (?, ?, ?, ?, ?, ?)',
+        [uuid(), uuid(), id, uid, 'member', ts],
+      )
+      for (const c of DEFAULT_COLUMNS) {
+        await tx.execute(
+          'INSERT INTO BoardColumn (id, uuid, projectId, name, sortOrder, boundStatus, retention, createdAt, updatedAt) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)',
+          [uuid(), uuid(), id, c.name, c.sortOrder, c.boundStatus, 'forever', ts, ts],
+        )
+      }
+    })
+    const p = await db().get('SELECT * FROM Project WHERE id = ?', [id])
+    return { item: projectSummary(p, 1, 0) }
+  },
+
+  update: async (id, body) => {
+    await db().getOptional('SELECT id FROM Project WHERE id = ?', [String(id)]).then((p) => {
+      if (!p) throw new Error('项目不存在或无权限')
+    })
+    const data = {}
+    if (body?.name !== undefined) {
+      const t = String(body.name).trim()
+      if (!t) throw new Error('项目名称不能为空')
+      if (t.length > MAX_NAME) throw new Error(`项目名称不能超过 ${MAX_NAME} 字`)
+      data.name = t
+    }
+    if (body?.code !== undefined) {
+      const c = String(body.code || '').trim().toUpperCase()
+      if (!/^[A-Z0-9]{2,8}$/.test(c)) throw new Error('项目编号须为 2~8 位字母数字')
+      const dup = await db().getOptional('SELECT id FROM Project WHERE code = ? AND id != ?', [c, String(id)])
+      if (dup) throw new Error(`项目编号 ${c} 已被占用`)
+      data.code = c
+    }
+    if (body?.taskKinds !== undefined) {
+      const kinds = normTaskKinds(body.taskKinds)
+      if (!kinds?.length) throw new Error('至少保留一个任务类型')
+      data.taskKinds = JSON.stringify(kinds)
+    }
+    if (body?.icon !== undefined) {
+      if (body.icon === null) data.icon = null
+      else {
+        const s = String(body.icon)
+        if (!s.startsWith('data:image/')) throw new Error('图标格式非法')
+        if (s.length > 300_000) throw new Error('图标过大')
+        data.icon = s
+      }
+    }
+    if (body?.archived !== undefined) data.archived = body.archived ? 1 : 0
+    if (body?.notes !== undefined) {
+      if (!Array.isArray(body.notes)) throw new Error('信息块格式非法')
+      data.notes = JSON.stringify(body.notes.slice(0, 50).map((n) => ({
+        title: String(n?.title ?? '').slice(0, 50),
+        content: String(n?.content ?? '').slice(0, 20000),
+      })))
+    }
+    const sets = Object.keys(data).map((k) => `"${k}" = ?`)
+    if (sets.length) {
+      await db().execute(
+        `UPDATE Project SET ${sets.join(', ')}, updatedAt = ? WHERE id = ?`,
+        [...Object.values(data), now(), String(id)],
+      )
+    }
+    const p = await db().get('SELECT * FROM Project WHERE id = ?', [String(id)])
+    const memberCount = await db().getOptional('SELECT COUNT(*) AS n FROM ProjectMember WHERE projectId = ?', [String(p.id)])
+    const taskCount = await db().getOptional('SELECT COUNT(*) AS n FROM Task WHERE projectId = ?', [String(p.id)])
+    return { item: projectSummary(p, memberCount?.n || 0, taskCount?.n || 0) }
+  },
+
+  remove: async (id) => {
+    const p = await db().getOptional('SELECT * FROM Project WHERE id = ?', [String(id)])
+    if (!p) throw new Error('项目不存在或无权限')
+    if (!!p.isPersonal) throw new Error('个人默认项目不可删除')
+    // 手动级联 (本地 SQLite 无外键级联)
+    await db().writeTransaction(async (tx) => {
+      const taskIds = (await tx.getAll('SELECT id FROM Task WHERE projectId = ?', [String(p.id)])).map((r) => String(r.id))
+      if (taskIds.length) {
+        const ph = taskIds.map(() => '?').join(',')
+        await tx.execute(`DELETE FROM TaskMember WHERE taskId IN (${ph})`, taskIds)
+        await tx.execute(`DELETE FROM TaskTag WHERE taskId IN (${ph})`, taskIds)
+      }
+      await tx.execute('DELETE FROM Task WHERE projectId = ?', [String(p.id)])
+      await tx.execute('DELETE FROM BoardColumn WHERE projectId = ?', [String(p.id)])
+      await tx.execute('DELETE FROM ProjectMember WHERE projectId = ?', [String(p.id)])
+      await tx.execute('DELETE FROM Project WHERE id = ?', [String(p.id)])
+    })
+    return { ok: true }
+  },
+
+  addMember: async (id, body) => {
+    const p = await db().getOptional('SELECT * FROM Project WHERE id = ?', [String(id)])
+    if (!p) throw new Error('项目不存在或无权限')
+    if (!!p.isPersonal) throw new Error('个人默认项目不可添加成员')
+    let target = null
+    if (body?.userId) target = await db().getOptional('SELECT id, name FROM User WHERE id = ?', [String(body.userId)])
+    else if (body?.email) target = await db().getOptional('SELECT id, name FROM User WHERE email = ?', [String(body.email).trim()])
+    if (!target) throw new Error('用户不存在')
+    const dup = await db().getOptional('SELECT id FROM ProjectMember WHERE projectId = ? AND userId = ?', [String(p.id), String(target.id)])
+    if (dup) throw new Error('该用户已是项目成员')
+    await db().execute(
+      'INSERT INTO ProjectMember (id, uuid, projectId, userId, permission, createdAt) VALUES (?, ?, ?, ?, ?, ?)',
+      [uuid(), uuid(), String(p.id), String(target.id), 'member', now()],
+    )
+    return { ok: true, member: { userId: String(target.id), name: target.name } }
+  },
+
+  removeMember: async (id, uid) => {
+    const p = await db().getOptional('SELECT * FROM Project WHERE id = ?', [String(id)])
+    if (!p) throw new Error('项目不存在或无权限')
+    if (!!p.isPersonal) throw new Error('个人默认项目不可移除成员')
+    const me = getCurrentUserId()
+    if (String(uid) !== me && String(p.ownerId) !== me) throw new Error('只能移除自己，或由创建人移除他人')
+    await db().execute('DELETE FROM ProjectMember WHERE projectId = ? AND userId = ?', [String(p.id), String(uid)])
+    return { ok: true }
+  },
 }

-// 看板列
+// ---------- 看板列 ----------
+
 export const columnApi = {
-  list: (projectId) => api(`/projects/${projectId}/columns`),
-  add: (projectId, body) => api(`/projects/${projectId}/columns`, { method: 'POST', body }),
-  update: (id, body) => api(`/columns/${id}`, { method: 'PUT', body }),
-  remove: (id, moveToColumnId) => api(`/columns/${id}${q({ moveToColumnId })}`, { method: 'DELETE' }),
-  order: (projectId, ids) => api(`/projects/${projectId}/columns/order`, { method: 'PUT', body: { ids } }),
+  list: async (projectId) => ({ items: await getColumns(projectId) }),
+
+  add: async (projectId, body) => {
+    const name = String(body?.name || '').trim()
+    if (!name) throw new Error('列名不能为空')
+    if (name.length > MAX_NAME) throw new Error(`列名不能超过 ${MAX_NAME} 字`)
+    const cols = await getColumns(projectId)
+    if (cols.length >= 10) throw new Error('最多 10 列')
+    if (cols.some((c) => c.name === name)) throw new Error('列名已存在')
+    const id = uuid()
+    const ts = now()
+    await db().execute(
+      'INSERT INTO BoardColumn (id, uuid, projectId, name, sortOrder, boundStatus, retention, createdAt, updatedAt) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)',
+      [id, id, String(projectId), name, cols.length ? Math.max(...cols.map((c) => Number(c.sortOrder))) + 1 : 0, null, 'forever', ts, ts],
+    )
+    return { item: await db().get('SELECT * FROM BoardColumn WHERE id = ?', [id]) }
+  },
+
+  update: async (id, body) => {
+    const col = await db().getOptional('SELECT * FROM BoardColumn WHERE id = ?', [String(id)])
+    if (!col) throw new Error('列不存在')
+    const data = {}
+    if (body?.name !== undefined) {
+      const t = String(body.name).trim()
+      if (!t) throw new Error('列名不能为空')
+      if (t.length > MAX_NAME) throw new Error(`列名不能超过 ${MAX_NAME} 字`)
+      const dup = await db().getOptional('SELECT id FROM BoardColumn WHERE projectId = ? AND name = ? AND id != ?', [String(col.projectId), t, String(id)])
+      if (dup) throw new Error('列名已存在')
+      data.name = t
+    }
+    if (body?.boundStatus !== undefined) {
+      if (body.boundStatus !== null && !['todo', 'doing', 'done'].includes(body.boundStatus)) throw new Error('绑定状态取值非法')
+      data.boundStatus = body.boundStatus
+    }
+    if (body?.retention !== undefined) {
+      if (!['never', 'today', '3d', 'week', 'month', 'forever'].includes(body.retention)) throw new Error('保留选项取值非法')
+      data.retention = body.retention
+    }
+    const sets = Object.keys(data).map((k) => `"${k}" = ?`)
+    if (sets.length) {
+      await db().execute(`UPDATE BoardColumn SET ${sets.join(', ')}, updatedAt = ? WHERE id = ?`, [...Object.values(data), now(), String(id)])
+    }
+    return { item: await db().get('SELECT * FROM BoardColumn WHERE id = ?', [String(id)]) }
+  },
+
+  remove: async (id, moveToColumnId) => {
+    const col = await db().getOptional('SELECT * FROM BoardColumn WHERE id = ?', [String(id)])
+    if (!col) throw new Error('列不存在')
+    const cols = await getColumns(col.projectId)
+    if (cols.length <= 1) throw new Error('至少保留一列')
+    let targetId = String(moveToColumnId || '')
+    if (!targetId) {
+      const idx = cols.findIndex((c) => String(c.id) === String(id))
+      targetId = String((cols[idx + 1] || cols[idx - 1]).id)
+    }
+    const target = cols.find((c) => String(c.id) === targetId)
+    if (!target || String(target.id) === String(id)) throw new Error('迁移目标列非法')
+    await db().writeTransaction(async (tx) => {
+      // 迁移任务: 状态按目标列绑定重新裁决 (与服务端同口径)
+      if (target.boundStatus) {
+        await tx.execute('UPDATE Task SET columnId = ?, status = ?, updatedAt = ? WHERE columnId = ?', [targetId, target.boundStatus, now(), String(id)])
+      } else {
+        await tx.execute('UPDATE Task SET columnId = ?, updatedAt = ? WHERE columnId = ?', [targetId, now(), String(id)])
+      }
+      await tx.execute('DELETE FROM BoardColumn WHERE id = ?', [String(id)])
+    })
+    return { ok: true, toColumnId: targetId }
+  },
+
+  order: async (projectId, ids) => {
+    const list = Array.isArray(ids) ? ids.map(String) : []
+    if (!list.length) throw new Error('ids 不能为空')
+    await db().writeTransaction(async (tx) => {
+      for (let i = 0; i < list.length; i++) {
+        await tx.execute('UPDATE BoardColumn SET sortOrder = ?, updatedAt = ? WHERE id = ?', [i, now(), list[i]])
+      }
+    })
+    return { items: await getColumns(projectId) }
+  },
 }

-// 任务
+// ---------- 任务 ----------
+
+function assertTitle(t) {
+  const s = String(t || '').trim()
+  if (!s) throw new Error('任务标题不能为空')
+  if (s.length > 30) throw new Error('任务标题不能超过 30 字')
+  return s
+}
+
+function parseMarkDate(v) {
+  if (v === null || v === undefined || v === '') return null
+  const d = new Date(v)
+  if (Number.isNaN(d.getTime())) throw new Error('时间标记格式非法')
+  return d.toISOString()
+}
+
 export const taskApi = {
-  list: (projectId) => api(`/projects/${projectId}/tasks`),
-  create: (projectId, body) => api(`/projects/${projectId}/tasks`, { method: 'POST', body }),
-  detail: (id) => api(`/tasks/${id}`),
-  update: (id, body) => api(`/tasks/${id}`, { method: 'PUT', body }),
-  reorder: (projectId, ids) => api(`/projects/${projectId}/tasks/reorder`, { method: 'POST', body: { ids } }),
-  remove: (id) => api(`/tasks/${id}`, { method: 'DELETE' }),
-  copy: (id, projectId) => api(`/tasks/${id}/copy`, { method: 'POST', body: { projectId } }),
+  list: async (projectId) => {
+    const columns = await getColumns(projectId)
+    const rows = await db().getAll(
+      'SELECT * FROM Task WHERE projectId = ? AND parentId IS NULL ORDER BY sortOrder, createdAt, id',
+      [String(projectId)],
+    )
+    const shape = await shapeTasks(rows, columns)
+    const shaped = rows.map(shape)
+    // 子任务挂载 (与服务端 TASK_INCLUDE.children 同构)
+    for (const t of shaped) {
+      const childRows = await db().getAll(
+        'SELECT * FROM Task WHERE parentId = ? ORDER BY sortOrder, id',
+        [String(t.id)],
+      )
+      const childShape = await shapeTasks(childRows, columns)
+      t.children = childRows.map(childShape)
+    }
+    const visible = filterVisible(shaped, columns)
+    return { items: visible, columns, total: shaped.length }
+  },
+
+  create: async (projectId, body) => {
+    const uid = assertUser()
+    const title = assertTitle(body?.title)
+    const columns = await getColumns(projectId)
+    if (!columns.length) throw new Error('项目没有可用的看板列')
+    let parentId = null
+    if (body?.parentId) {
+      const parent = await db().getOptional('SELECT * FROM Task WHERE id = ?', [String(body.parentId)])
+      if (!parent) throw new Error('父任务不存在')
+      if (String(parent.projectId) !== String(projectId)) throw new Error('子任务必须与父任务同项目')
+      if (parent.parentId) throw new Error('仅支持一级子任务')
+      parentId = String(parent.id)
+    }
+    const memberIds = await db().getAll('SELECT userId FROM ProjectMember WHERE projectId = ?', [String(projectId)])
+    const memberSet = new Set(memberIds.map((r) => String(r.userId)))
+    let finalAssignee = null
+    if (body?.assigneeId === undefined) finalAssignee = memberSet.has(uid) ? uid : null
+    else if (body?.assigneeId !== null) {
+      const aid = String(body.assigneeId)
+      if (!memberSet.has(aid)) throw new Error('负责人必须是项目成员')
+      finalAssignee = aid
+    }
+    const firstCol = columns[0]
+    const id = uuid()
+    const ts = now()
+    await db().writeTransaction(async (tx) => {
+      await tx.execute(
+        `INSERT INTO Task (id, uuid, projectId, columnId, parentId, title, description, kind, markDate, status, doneAt, assigneeId, creatorId, extras, sortOrder, number, createdAt, updatedAt)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        [id, id, String(projectId), String(firstCol.id), parentId, title, String(body?.description || ''),
+          body?.kind ? String(body.kind).trim().slice(0, 20) : null, parseMarkDate(body?.markDate),
+          firstCol.boundStatus || 'todo', null, finalAssignee, uid, '[]', 0, null, ts, ts],
+      )
+      for (const mid of (Array.isArray(body?.memberIds) ? body.memberIds : []).map(String).filter((x) => memberSet.has(x))) {
+        await tx.execute('INSERT INTO TaskMember (id, uuid, taskId, userId) VALUES (?, ?, ?, ?)', [uuid(), uuid(), id, mid])
+      }
+      for (const name of (Array.isArray(body?.tags) ? body.tags : []).filter(Boolean).map((n) => String(n).slice(0, 20))) {
+        await tx.execute('INSERT INTO TaskTag (id, uuid, taskId, name) VALUES (?, ?, ?, ?)', [uuid(), uuid(), id, name])
+      }
+    })
+    const row = await db().get('SELECT * FROM Task WHERE id = ?', [id])
+    const shape = await shapeTasks([row], columns)
+    return { item: shape(row) }
+  },
+
+  detail: async (id) => {
+    const row = await db().getOptional('SELECT * FROM Task WHERE id = ?', [String(id)])
+    if (!row) throw new Error('任务不存在或无权限')
+    const columns = await getColumns(row.projectId)
+    const shape = await shapeTasks([row], columns)
+    return { item: shape(row) }
+  },
+
+  update: async (id, body) => {
+    const task = await db().getOptional('SELECT * FROM Task WHERE id = ?', [String(id)])
+    if (!task) throw new Error('任务不存在或无权限')
+    const columns = await getColumns(task.projectId)
+    const data = {}
+
+    if (body?.title !== undefined) data.title = assertTitle(body.title)
+    if (body?.description !== undefined) data.description = String(body.description)
+    if (body?.kind !== undefined) data.kind = body.kind ? String(body.kind).trim().slice(0, 20) : null
+    if (body?.markDate !== undefined) data.markDate = parseMarkDate(body.markDate)
+    if (body?.extras !== undefined) {
+      if (!Array.isArray(body.extras)) throw new Error('扩展信息格式非法')
+      data.extras = JSON.stringify(body.extras.map((e) => ({
+        label: String(e?.label ?? '').slice(0, 40),
+        value: String(e?.value ?? ''),
+        url: e?.url ? String(e.url) : '',
+      })))
+    }
+    if (body?.sortOrder !== undefined) data.sortOrder = Number(body.sortOrder) || 0
+
+    const memberRows = await db().getAll('SELECT userId FROM ProjectMember WHERE projectId = ?', [String(task.projectId)])
+    const memberSet = new Set(memberRows.map((r) => String(r.userId)))
+    if (body?.assigneeId !== undefined) {
+      if (body.assigneeId === null || body.assigneeId === '') data.assigneeId = null
+      else {
+        const aid = String(body.assigneeId)
+        if (!memberSet.has(aid)) throw new Error('负责人必须是项目成员')
+        data.assigneeId = aid
+      }
+    }
+
+    // 列 / 状态联动裁决 (与 server/task-domain/resolveStatus.js 同口径)
+    let status = task.status
+    let columnId = String(task.columnId)
+    const patch = {}
+    if (body?.columnId !== undefined) patch.columnId = String(body.columnId)
+    if (body?.status !== undefined) {
+      if (!['todo', 'doing', 'done'].includes(body.status)) throw new Error('任务状态取值非法')
+      patch.status = body.status
+    }
+    if (patch.columnId !== undefined && !columns.some((c) => String(c.id) === patch.columnId)) {
+      throw new Error('看板列不存在')
+    }
+    if (Object.keys(patch).length) {
+      status = patch.status !== undefined ? patch.status : task.status
+      columnId = patch.columnId !== undefined ? patch.columnId : String(task.columnId)
+      if (!task.parentId) {
+        const ordered = [...columns].sort((a, b) => (Number(a.sortOrder) - Number(b.sortOrder)) || String(a.id).localeCompare(String(b.id)))
+        const targetColumn = ordered.find((c) => String(c.id) === columnId)
+        if (patch.columnId !== undefined && targetColumn) {
+          if (targetColumn.boundStatus) status = targetColumn.boundStatus
+        }
+        if (patch.status !== undefined) {
+          if (!(targetColumn && targetColumn.boundStatus === status)) {
+            const hit = ordered.find((c) => c.boundStatus === status)
+            if (hit) columnId = String(hit.id)
+          }
+        }
+      }
+      data.status = status
+      data.columnId = columnId
+    }
+    if (data.status === 'done' && task.status !== 'done') data.doneAt = now()
+    else if (data.status !== undefined && data.status !== 'done') data.doneAt = null
+
+    // 拖拽降为子任务
+    if (body?.parentId !== undefined) {
+      if (body.parentId === null) {
+        data.parentId = null
+      } else {
+        const pid = String(body.parentId)
+        if (pid === String(task.id)) throw new Error('不能成为自己的子任务')
+        const parent = await db().getOptional('SELECT * FROM Task WHERE id = ?', [pid])
+        if (!parent) throw new Error('目标任务不存在')
+        if (String(parent.projectId) !== String(task.projectId)) throw new Error('子任务必须与父任务同项目')
+        if (parent.parentId) throw new Error('仅支持一级子任务')
+        const childCount = await db().getOptional('SELECT COUNT(*) AS n FROM Task WHERE parentId = ?', [String(task.id)])
+        if ((childCount?.n || 0) > 0) throw new Error('该任务已有子任务，不能成为子任务')
+        data.parentId = pid
+      }
+    }
+
+    await db().writeTransaction(async (tx) => {
+      const sets = Object.keys(data).map((k) => `"${k}" = ?`)
+      if (sets.length) {
+        await tx.execute(`UPDATE Task SET ${sets.join(', ')}, updatedAt = ? WHERE id = ?`, [...Object.values(data), now(), String(task.id)])
+      }
+      if (Array.isArray(body?.memberIds)) {
+        const ids = body.memberIds.map(String).filter((x) => memberSet.has(x))
+        await tx.execute('DELETE FROM TaskMember WHERE taskId = ?', [String(task.id)])
+        for (const mid of ids) {
+          await tx.execute('INSERT INTO TaskMember (id, uuid, taskId, userId) VALUES (?, ?, ?, ?)', [uuid(), uuid(), String(task.id), mid])
+        }
+      }
+      if (Array.isArray(body?.tags)) {
+        await tx.execute('DELETE FROM TaskTag WHERE taskId = ?', [String(task.id)])
+        const names = body.tags.map((n) => String(n).trim()).filter(Boolean).slice(0, 10)
+        for (const name of names) {
+          await tx.execute('INSERT INTO TaskTag (id, uuid, taskId, name) VALUES (?, ?, ?, ?)', [uuid(), uuid(), String(task.id), name.slice(0, 20)])
+        }
+      }
+    })
+    const row = await db().get('SELECT * FROM Task WHERE id = ?', [String(task.id)])
+    const shape = await shapeTasks([row], columns)
+    return { item: shape(row) }
+  },
+
+  reorder: async (projectId, ids) => {
+    const list = Array.isArray(ids) ? ids.map(String).filter(Boolean) : []
+    if (!list.length) throw new Error('ids 不能为空')
+    await db().writeTransaction(async (tx) => {
+      for (let i = 0; i < list.length; i++) {
+        await tx.execute('UPDATE Task SET sortOrder = ?, updatedAt = ? WHERE id = ?', [i, now(), list[i]])
+      }
+    })
+    return { ok: true }
+  },
+
+  remove: async (id) => {
+    const task = await db().getOptional('SELECT * FROM Task WHERE id = ?', [String(id)])
+    if (!task) throw new Error('任务不存在或无权限')
+    const childCount = await db().getOptional('SELECT COUNT(*) AS n FROM Task WHERE parentId = ?', [String(task.id)])
+    await db().writeTransaction(async (tx) => {
+      const ids = [String(task.id), ...((await tx.getAll('SELECT id FROM Task WHERE parentId = ?', [String(task.id)])).map((r) => String(r.id)))]
+      const ph = ids.map(() => '?').join(',')
+      await tx.execute(`DELETE FROM TaskMember WHERE taskId IN (${ph})`, ids)
+      await tx.execute(`DELETE FROM TaskTag WHERE taskId IN (${ph})`, ids)
+      await tx.execute(`DELETE FROM Task WHERE id IN (${ph})`, ids)
+    })
+    return { ok: true, deletedSubtasks: childCount?.n || 0 }
+  },
+
+  copy: async (id, projectId) => {
+    const uid = assertUser()
+    const source = await db().getOptional('SELECT * FROM Task WHERE id = ?', [String(id)])
+    if (!source) throw new Error('任务不存在或无权限')
+    const targetProject = await db().getOptional('SELECT * FROM Project WHERE id = ?', [String(projectId)])
+    if (!targetProject) throw new Error('目标项目不存在或你不是其成员')
+    const targetColumns = await getColumns(targetProject.id)
+    if (!targetColumns.length) throw new Error('目标项目没有可用的看板列')
+    const sourceColumns = await getColumns(source.projectId)
+    const targetMemberIds = new Set((await db().getAll('SELECT userId FROM ProjectMember WHERE projectId = ?', [String(targetProject.id)])).map((r) => String(r.userId)))
+
+    const pickColumn = (sourceColumnId) => {
+      const src = sourceColumns.find((c) => String(c.id) === String(sourceColumnId))
+      if (src) {
+        const same = targetColumns.find((c) => c.name === src.name)
+        if (same) return String(same.id)
+      }
+      return String(targetColumns[0]?.id)
+    }
+
+    const copyOne = async (tx, s, parentId) => {
+      const newId = uuid()
+      const ts = now()
+      await tx.execute(
+        `INSERT INTO Task (id, uuid, projectId, columnId, parentId, title, description, kind, markDate, status, doneAt, assigneeId, creatorId, extras, sortOrder, number, createdAt, updatedAt)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        [newId, newId, String(targetProject.id), pickColumn(s.columnId), parentId, s.title, s.description || '', s.kind || null,
+          s.markDate || null, s.status, s.status === 'done' ? (s.doneAt || ts) : null,
+          s.assigneeId && targetMemberIds.has(String(s.assigneeId)) ? String(s.assigneeId) : null,
+          uid, s.extras || '[]', Number(s.sortOrder) || 0, null, ts, ts],
+      )
+      const tagRows = await tx.getAll('SELECT name FROM TaskTag WHERE taskId = ?', [String(s.id)])
+      for (const t of tagRows) {
+        await tx.execute('INSERT INTO TaskTag (id, uuid, taskId, name) VALUES (?, ?, ?, ?)', [uuid(), uuid(), newId, t.name])
+      }
+      const keptMembers = (await tx.getAll('SELECT userId FROM TaskMember WHERE taskId = ?', [String(s.id)])).map((r) => String(r.userId)).filter((x) => targetMemberIds.has(x))
+      for (const m of keptMembers) {
+        await tx.execute('INSERT INTO TaskMember (id, uuid, taskId, userId) VALUES (?, ?, ?, ?)', [uuid(), uuid(), newId, m])
+      }
+      return newId
+    }
+
+    const newId = await db().writeTransaction(async (tx) => {
+      const pid = await copyOne(tx, source, null)
+      const children = await tx.getAll('SELECT * FROM Task WHERE parentId = ?', [String(source.id)])
+      for (const child of children) await copyOne(tx, child, pid)
+      return pid
+    })
+    const row = await db().get('SELECT * FROM Task WHERE id = ?', [newId])
+    const shape = await shapeTasks([row], targetColumns)
+    return { item: shape(row), dropped: { assignee: null, members: [] } }
+  },
 }