120 lines
3.7 KiB
TypeScript
120 lines
3.7 KiB
TypeScript
export type PlanTaskStatus = 'pending' | 'in_progress' | 'completed';
|
||
|
||
export interface PlanTask {
|
||
id: string;
|
||
title: string;
|
||
status: PlanTaskStatus;
|
||
}
|
||
|
||
export interface VersionPlan {
|
||
id: string;
|
||
versionId: string;
|
||
type: 'research' | 'product' | 'ui';
|
||
title: string;
|
||
owner: string;
|
||
startTime: string;
|
||
endTime: string;
|
||
status: 'pending' | 'in_progress' | 'completed';
|
||
tasks?: PlanTask[];
|
||
completedRequirementIds?: string[];
|
||
linkedRequirementIds?: string[];
|
||
resultType?: 'link' | 'file';
|
||
resultTitle?: string;
|
||
resultUrl?: string;
|
||
resultFileName?: string;
|
||
resultFileData?: string;
|
||
remark?: string;
|
||
overdueReason?: string;
|
||
actualStartAt?: string;
|
||
createdAt: string;
|
||
completedAt?: string;
|
||
addedBy: string;
|
||
aiDecomposeStatus?: 'idle' | 'in_progress' | 'completed' | 'error';
|
||
aiDecomposeAt?: string;
|
||
aiDecomposeBy?: string;
|
||
aiDecomposeError?: string;
|
||
}
|
||
|
||
export type PlanType = VersionPlan['type'];
|
||
|
||
export function calcPlanProgress(tasks?: PlanTask[]): number {
|
||
if (!tasks || tasks.length === 0) return 0;
|
||
const completed = tasks.filter((t) => t.status === 'completed').length;
|
||
return Math.round((completed / tasks.length) * 100);
|
||
}
|
||
|
||
export function calcLinkedReqProgress(linkedIds?: string[], completedIds?: string[]): number {
|
||
if (!linkedIds || linkedIds.length === 0) return 0;
|
||
const done = (completedIds || []).filter((id) => linkedIds.includes(id)).length;
|
||
return Math.round((done / linkedIds.length) * 100);
|
||
}
|
||
|
||
export function calcPlanDuration(start: string, end: string): { days: number; hours: number } {
|
||
const s = new Date(start).getTime();
|
||
const e = new Date(end).getTime();
|
||
if (isNaN(s) || isNaN(e) || e < s) return { days: 0, hours: 0 };
|
||
const diffHours = (e - s) / (1000 * 60 * 60);
|
||
const hours = Math.round(diffHours * 2) / 2; // 精确到0.5h
|
||
const days = Math.ceil(diffHours / 24);
|
||
return { days, hours };
|
||
}
|
||
|
||
export function formatDuration(days: number, hours: number): string {
|
||
if (hours <= 0) return '0h';
|
||
if (hours < 24) return `${hours}h`;
|
||
if (hours % 24 === 0) return `${hours / 24}天`;
|
||
return `${hours}h`;
|
||
}
|
||
|
||
export function calcTotalDuration(plans: VersionPlan[]): string {
|
||
const today = new Date().toISOString().slice(0, 10);
|
||
const activePlans = plans.filter((p) => p.status !== 'pending' || p.startTime <= today);
|
||
if (activePlans.length === 0) return '0天';
|
||
|
||
const intervals = activePlans.map((p) => {
|
||
const start = new Date(p.startTime).getTime();
|
||
const end = p.completedAt
|
||
? new Date(p.completedAt).getTime()
|
||
: p.startTime <= today
|
||
? new Date(today).getTime()
|
||
: new Date(p.startTime).getTime();
|
||
return { start, end };
|
||
}).filter((i) => i.end > i.start).sort((a, b) => a.start - b.start);
|
||
|
||
if (intervals.length === 0) return '0天';
|
||
|
||
let totalMs = 0;
|
||
let currentStart = intervals[0].start;
|
||
let currentEnd = intervals[0].end;
|
||
|
||
for (let i = 1; i < intervals.length; i++) {
|
||
if (intervals[i].start <= currentEnd) {
|
||
currentEnd = Math.max(currentEnd, intervals[i].end);
|
||
} else {
|
||
totalMs += currentEnd - currentStart;
|
||
currentStart = intervals[i].start;
|
||
currentEnd = intervals[i].end;
|
||
}
|
||
}
|
||
totalMs += currentEnd - currentStart;
|
||
|
||
const totalDays = Math.ceil(totalMs / (1000 * 60 * 60 * 24));
|
||
return `${totalDays}天`;
|
||
}
|
||
|
||
import type { TimeInterval } from './work-hours';
|
||
|
||
/**
|
||
* 抽取每条已开始计划的 [actualStartAt, completedAt ?? now] 时间区间
|
||
* 用于双口径耗时统计（calcTwoMetrics）
|
||
*/
|
||
export function planIntervals(plans: VersionPlan[], now: Date = new Date()): TimeInterval[] {
|
||
const out: TimeInterval[] = [];
|
||
const nowIso = now.toISOString();
|
||
for (const p of plans) {
|
||
if (!p.actualStartAt) continue;
|
||
out.push({ start: p.actualStartAt, end: p.completedAt ?? nowIso });
|
||
}
|
||
return out;
|
||
}
|