feat(dev-task): 开发任务模块 V1 完整实现

- 核心库：dev-task.ts（类型+状态机+进度计算）、task-worklog.ts（工时）、task-category.ts（字典）、work-item.ts（聚合契约） - Store：useDevTaskStore（CRUD+状态流转）、useTaskWorklogStore（工时记录）、useTaskCategoryStore（字典管理） - UI组件：DevTaskTab、DevTaskCreateModal、DevTaskDetailDrawer、DevTaskRow、WorklogPanel、StatusBadge、CategoryChip - 集成：版本详情页"开发任务"Tab、"与我相关"工作台开发任务分组、任务类型管理页 - 设计文档：spec + 实施计划 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-06-11 18:02:07 +08:00
parent 8bc23fbf3d
commit a560634091
20 changed files with 3054 additions and 6 deletions
--- a/apps/web/stores/useDevTaskStore.ts
+++ b/apps/web/stores/useDevTaskStore.ts
@@ -0,0 +1,109 @@
+'use client';
+import { create } from 'zustand';
+import type { DevTask, DevTaskStatus } from '@/lib/dev-task';
+import { canTransition, generateTaskNo } from '@/lib/dev-task';
+
+const STORAGE_KEY = 'ftb_dev_tasks_v1';
+
+function saveLocal(items: DevTask[]) {
+  try { localStorage.setItem(STORAGE_KEY, JSON.stringify(items)); } catch {}
+}
+
+function loadLocal(): DevTask[] | null {
+  try {
+    const raw = localStorage.getItem(STORAGE_KEY);
+    if (raw) return JSON.parse(raw);
+  } catch {}
+  return null;
+}
+
+interface DevTaskState {
+  tasks: DevTask[];
+  fetchTasks: () => void;
+  createTask: (data: Omit<DevTask, 'id' | 'taskNo' | 'createdAt' | 'updatedAt' | 'actualHours' | 'isBlocked'>) => DevTask;
+  updateTask: (id: string, data: Partial<DevTask>) => void;
+  deleteTask: (id: string) => void;
+  changeStatus: (id: string, to: DevTaskStatus) => { ok: boolean; message?: string };
+  setBlocked: (id: string, blocked: boolean, reason?: string, blockedById?: string) => void;
+  syncActualHours: (taskId: string, hours: number) => void;
+  getByRequirement: (requirementId: string) => DevTask[];
+  getByVersionViaRequirements: (requirementIds: string[]) => DevTask[];
+  getByAssignee: (assigneeId: string) => DevTask[];
+}
+
+export const useDevTaskStore = create<DevTaskState>((set, get) => ({
+  tasks: [],
+
+  fetchTasks: () => {
+    const cached = loadLocal();
+    if (cached) set({ tasks: cached });
+  },
+
+  createTask: (data) => {
+    const list = get().tasks;
+    const now = new Date().toISOString();
+    const task: DevTask = {
+      ...data,
+      id: `task-${Date.now()}`,
+      taskNo: generateTaskNo(list),
+      actualHours: 0,
+      isBlocked: false,
+      createdAt: now,
+      updatedAt: now,
+    };
+    const updated = [...list, task];
+    set({ tasks: updated });
+    saveLocal(updated);
+    return task;
+  },
+
+  updateTask: (id, data) => {
+    const updated = get().tasks.map((t) =>
+      t.id === id ? { ...t, ...data, updatedAt: new Date().toISOString() } : t,
+    );
+    set({ tasks: updated });
+    saveLocal(updated);
+  },
+
+  deleteTask: (id) => {
+    const updated = get().tasks.filter((t) => t.id !== id);
+    set({ tasks: updated });
+    saveLocal(updated);
+  },
+
+  changeStatus: (id, to) => {
+    const task = get().tasks.find((t) => t.id === id);
+    if (!task) return { ok: false, message: '任务不存在' };
+    if (!canTransition(task.status, to)) {
+      return { ok: false, message: `不允许从「${task.status}」流转到「${to}」` };
+    }
+    const completedAt = to === 'done' ? new Date().toISOString().slice(0, 10) : task.completedAt;
+    get().updateTask(id, { status: to, completedAt });
+    return { ok: true };
+  },
+
+  setBlocked: (id, blocked, reason, blockedById) => {
+    get().updateTask(id, {
+      isBlocked: blocked,
+      blockReason: blocked ? reason : undefined,
+      blockedById: blocked ? blockedById : undefined,
+    });
+  },
+
+  syncActualHours: (taskId, hours) => {
+    get().updateTask(taskId, { actualHours: hours });
+  },
+
+  getByRequirement: (requirementId) => {
+    return get().tasks.filter((t) => t.requirementId === requirementId);
+  },
+
+  getByVersionViaRequirements: (requirementIds) => {
+    const idSet = new Set(requirementIds);
+    return get().tasks.filter((t) => idSet.has(t.requirementId));
+  },
+
+  getByAssignee: (assigneeId) => {
+    return get().tasks.filter((t) => t.assigneeId === assigneeId);
+  },
+}));
--- a/apps/web/stores/useTaskCategoryStore.ts
+++ b/apps/web/stores/useTaskCategoryStore.ts
@@ -0,0 +1,65 @@
+'use client';
+import { create } from 'zustand';
+import type { TaskCategory, CategoryGroup } from '@/lib/task-category';
+import { PRESET_CATEGORIES } from '@/lib/task-category';
+
+const STORAGE_KEY = 'ftb_task_categories_v1';
+
+function saveLocal(items: TaskCategory[]) {
+  try { localStorage.setItem(STORAGE_KEY, JSON.stringify(items)); } catch {}
+}
+
+function loadLocal(): TaskCategory[] | null {
+  try {
+    const raw = localStorage.getItem(STORAGE_KEY);
+    if (raw) return JSON.parse(raw);
+  } catch {}
+  return null;
+}
+
+interface TaskCategoryState {
+  categories: TaskCategory[];
+  fetchCategories: () => void;
+  addCategory: (name: string, group: CategoryGroup, color?: string) => void;
+  updateCategory: (id: string, data: Partial<TaskCategory>) => void;
+  deleteCategory: (id: string) => boolean;
+}
+
+export const useTaskCategoryStore = create<TaskCategoryState>((set, get) => ({
+  categories: PRESET_CATEGORIES,
+
+  fetchCategories: () => {
+    const cached = loadLocal();
+    if (cached) set({ categories: cached });
+  },
+
+  addCategory: (name, group, color) => {
+    const list = get().categories;
+    const item: TaskCategory = {
+      id: `cat-${Date.now()}`,
+      name,
+      group,
+      color,
+      sortOrder: list.length + 1,
+      isSystem: false,
+    };
+    const updated = [...list, item];
+    set({ categories: updated });
+    saveLocal(updated);
+  },
+
+  updateCategory: (id, data) => {
+    const updated = get().categories.map((c) => (c.id === id ? { ...c, ...data } : c));
+    set({ categories: updated });
+    saveLocal(updated);
+  },
+
+  deleteCategory: (id) => {
+    const target = get().categories.find((c) => c.id === id);
+    if (!target || target.isSystem) return false;
+    const updated = get().categories.filter((c) => c.id !== id);
+    set({ categories: updated });
+    saveLocal(updated);
+    return true;
+  },
+}));
--- a/apps/web/stores/useTaskWorklogStore.ts
+++ b/apps/web/stores/useTaskWorklogStore.ts
@@ -0,0 +1,57 @@
+'use client';
+import { create } from 'zustand';
+import type { TaskWorklog } from '@/lib/task-worklog';
+
+const STORAGE_KEY = 'ftb_task_worklogs_v1';
+
+function saveLocal(items: TaskWorklog[]) {
+  try { localStorage.setItem(STORAGE_KEY, JSON.stringify(items)); } catch {}
+}
+
+function loadLocal(): TaskWorklog[] | null {
+  try {
+    const raw = localStorage.getItem(STORAGE_KEY);
+    if (raw) return JSON.parse(raw);
+  } catch {}
+  return null;
+}
+
+interface TaskWorklogState {
+  worklogs: TaskWorklog[];
+  fetchWorklogs: () => void;
+  addWorklog: (data: Omit<TaskWorklog, 'id' | 'createdAt'>) => void;
+  deleteWorklog: (id: string) => void;
+  getActualHours: (taskId: string) => number;
+}
+
+export const useTaskWorklogStore = create<TaskWorklogState>((set, get) => ({
+  worklogs: [],
+
+  fetchWorklogs: () => {
+    const cached = loadLocal();
+    if (cached) set({ worklogs: cached });
+  },
+
+  addWorklog: (data) => {
+    const item: TaskWorklog = {
+      ...data,
+      id: `wl-${Date.now()}`,
+      createdAt: new Date().toISOString(),
+    };
+    const updated = [...get().worklogs, item];
+    set({ worklogs: updated });
+    saveLocal(updated);
+  },
+
+  deleteWorklog: (id) => {
+    const updated = get().worklogs.filter((w) => w.id !== id);
+    set({ worklogs: updated });
+    saveLocal(updated);
+  },
+
+  getActualHours: (taskId) => {
+    return get().worklogs
+      .filter((w) => w.taskId === taskId)
+      .reduce((sum, w) => sum + w.hours, 0);
+  },
+}));