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>
This commit is contained in:
Script Generator
2026-06-11 18:02:07 +08:00
parent 8bc23fbf3d
commit a560634091
20 changed files with 3054 additions and 6 deletions

View File

@@ -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);
},
}));