核心变更: - DevTask 字段重构:startDate/dueDate/estimateHours/actualHours 替换为 expectedStartAt/expectedEndAt/actualStartAt/actualEndAt(含时分),预计/实际工时按工作时段(9:00-12:00 + 13:00-18:00)派生计算 - 状态机自动化:到点自动切开发中、未到可手动开干、超期需填延后原因 - 新建 lib/work-hours.ts:calcWorkHours(工作时段过滤)、formatWorkHours(X h(Y 天))、calcTwoMetrics(日历/人力双口径) - 新建 lib/dev-task-transitions.ts:状态切换守卫 - 三个 Tab 顶部统计:开发任务(预/日历/人力)、测试用例 / Bug(日历 / 人力);版本概览总人天投入改双行(日历总耗时 / 人力总投入) - 三个 Tab 加搜索框:300ms debounce + 标题/编号模糊匹配 - 性能优化:requirementIds/categories/requirements/testCases 转 Map/Set 索引、Row 组件 React.memo - 全局耗时显示统一带天数换算:8h(1天)、11h(1.4天) 新增文件: SearchInput.tsx, useDebouncedValue.ts, work-hours.ts, dev-task-transitions.ts, 设计文档 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
138 lines
4.3 KiB
TypeScript
138 lines
4.3 KiB
TypeScript
'use client';
|
|
import { create } from 'zustand';
|
|
import type { DevTask, DevTaskStatus } from '@/lib/dev-task';
|
|
import { canTransition, generateTaskNo, isLegacyTask } from '@/lib/dev-task';
|
|
import { findTasksToAutoStart, deriveActualStartAt } from '@/lib/dev-task-transitions';
|
|
|
|
const STORAGE_KEY = 'ftb_dev_tasks_v2';
|
|
const LEGACY_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) {
|
|
const parsed = JSON.parse(raw);
|
|
if (Array.isArray(parsed) && parsed.some(isLegacyTask)) {
|
|
localStorage.removeItem(STORAGE_KEY);
|
|
return null;
|
|
}
|
|
return parsed;
|
|
}
|
|
if (localStorage.getItem(LEGACY_KEY)) {
|
|
localStorage.removeItem(LEGACY_KEY);
|
|
}
|
|
} catch {}
|
|
return null;
|
|
}
|
|
|
|
interface DevTaskState {
|
|
tasks: DevTask[];
|
|
fetchTasks: () => void;
|
|
createTask: (data: Omit<DevTask, 'id' | 'taskNo' | 'createdAt' | 'updatedAt' | 'isBlocked'>) => DevTask;
|
|
updateTask: (id: string, data: Partial<DevTask>) => void;
|
|
deleteTask: (id: string) => void;
|
|
changeStatus: (id: string, to: DevTaskStatus, opts?: { delayReason?: string }) => { ok: boolean; message?: string };
|
|
setBlocked: (id: string, blocked: boolean, reason?: string, blockedById?: string) => 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();
|
|
const list = cached ?? [];
|
|
const now = new Date();
|
|
const autoStarts = findTasksToAutoStart(list, now);
|
|
if (autoStarts.length > 0) {
|
|
const map = new Map(autoStarts.map((a) => [a.taskId, a.actualStartAt]));
|
|
const updated = list.map((t) =>
|
|
map.has(t.id)
|
|
? { ...t, status: 'in_progress' as DevTaskStatus, actualStartAt: map.get(t.id)!, updatedAt: now.toISOString() }
|
|
: t,
|
|
);
|
|
set({ tasks: updated });
|
|
saveLocal(updated);
|
|
} else {
|
|
set({ tasks: list });
|
|
}
|
|
},
|
|
|
|
createTask: (data) => {
|
|
const list = get().tasks;
|
|
const now = new Date().toISOString();
|
|
const task: DevTask = {
|
|
...data,
|
|
id: `task-${Date.now()}`,
|
|
taskNo: generateTaskNo(list),
|
|
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, opts) => {
|
|
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 now = new Date();
|
|
const patch: Partial<DevTask> = { status: to };
|
|
if (to === 'in_progress' && !task.actualStartAt) {
|
|
patch.actualStartAt = deriveActualStartAt(task, 'manual', now);
|
|
if (opts?.delayReason) patch.delayReason = opts.delayReason;
|
|
}
|
|
if (to === 'submitted') {
|
|
patch.actualEndAt = now.toISOString();
|
|
}
|
|
get().updateTask(id, patch);
|
|
return { ok: true };
|
|
},
|
|
|
|
setBlocked: (id, blocked, reason, blockedById) => {
|
|
get().updateTask(id, {
|
|
isBlocked: blocked,
|
|
blockReason: blocked ? reason : undefined,
|
|
blockedById: blocked ? blockedById : undefined,
|
|
});
|
|
},
|
|
|
|
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);
|
|
},
|
|
}));
|