a560634091
- 核心库：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>
94 lines
2.6 KiB
TypeScript
94 lines
2.6 KiB
TypeScript
import type { Priority } from './derive';
|
||
|
||
export type DevTaskStatus = 'todo' | 'in_progress' | 'testing' | 'submitted' | 'done';
|
||
|
||
export interface DevTask {
|
||
id: string;
|
||
taskNo: string;
|
||
requirementId: string;
|
||
title: string;
|
||
description?: string;
|
||
categoryId: string;
|
||
assigneeId: string;
|
||
reviewerId?: string;
|
||
priority: Priority;
|
||
estimateHours: number;
|
||
actualHours: number;
|
||
startDate?: string;
|
||
dueDate?: string;
|
||
completedAt?: string;
|
||
status: DevTaskStatus;
|
||
isBlocked: boolean;
|
||
blockReason?: string;
|
||
blockedById?: string;
|
||
predecessorIds?: string[];
|
||
riskLevel?: 'low' | 'medium' | 'high';
|
||
createdBy: string;
|
||
createdAt: string;
|
||
updatedAt: string;
|
||
}
|
||
|
||
export const DEV_TASK_STATUS_LABEL: Record<DevTaskStatus, string> = {
|
||
todo: '待开发',
|
||
in_progress: '开发中',
|
||
testing: '自测',
|
||
submitted: '提测',
|
||
done: '已完成',
|
||
};
|
||
|
||
export const DEV_TASK_STATUS_COLOR: Record<DevTaskStatus, string> = {
|
||
todo: 'bg-zinc-100 text-zinc-600',
|
||
in_progress: 'bg-blue-50 text-blue-600',
|
||
testing: 'bg-purple-50 text-purple-600',
|
||
submitted: 'bg-orange-50 text-orange-600',
|
||
done: 'bg-emerald-50 text-emerald-600',
|
||
};
|
||
|
||
export const STATUS_PROGRESS: Record<DevTaskStatus, number> = {
|
||
todo: 0,
|
||
in_progress: 50,
|
||
testing: 80,
|
||
submitted: 90,
|
||
done: 100,
|
||
};
|
||
|
||
export const ALLOWED_TRANSITIONS: Record<DevTaskStatus, DevTaskStatus[]> = {
|
||
todo: ['in_progress'],
|
||
in_progress: ['testing'],
|
||
testing: ['submitted', 'in_progress'],
|
||
submitted: ['done', 'in_progress'],
|
||
done: [],
|
||
};
|
||
|
||
export function canTransition(from: DevTaskStatus, to: DevTaskStatus): boolean {
|
||
return ALLOWED_TRANSITIONS[from].includes(to);
|
||
}
|
||
|
||
export function calcTaskProgress(task: DevTask): number {
|
||
return STATUS_PROGRESS[task.status];
|
||
}
|
||
|
||
export function calcGroupProgress(tasks: DevTask[]): number {
|
||
if (tasks.length === 0) return 0;
|
||
const totalEstimate = tasks.reduce((sum, t) => sum + t.estimateHours, 0);
|
||
if (totalEstimate === 0) return 0;
|
||
const weighted = tasks.reduce((sum, t) => sum + t.estimateHours * STATUS_PROGRESS[t.status], 0);
|
||
return Math.round(weighted / totalEstimate);
|
||
}
|
||
|
||
export function formatHours(hours: number): string {
|
||
if (hours < 8) return `${hours}h`;
|
||
const days = Math.floor(hours / 8);
|
||
const remainder = hours % 8;
|
||
if (remainder === 0) return `${hours}h（${days}人天）`;
|
||
return `${hours}h（≈${days}人天）`;
|
||
}
|
||
|
||
export function generateTaskNo(existingTasks: DevTask[]): string {
|
||
const maxNum = existingTasks.reduce((max, t) => {
|
||
const num = parseInt(t.taskNo.replace('DEV-', ''), 10);
|
||
return isNaN(num) ? max : Math.max(max, num);
|
||
}, 0);
|
||
return `DEV-${String(maxNum + 1).padStart(3, '0')}`;
|
||
}
|