feat: 开发任务时间字段重构 + 双口径耗时 + 搜索 + 性能优化
核心变更: - 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>
This commit is contained in:
62
apps/web/lib/dev-task-transitions.ts
Normal file
62
apps/web/lib/dev-task-transitions.ts
Normal file
@@ -0,0 +1,62 @@
|
||||
import type { DevTask } from './dev-task';
|
||||
|
||||
/**
|
||||
* 是否可以"手动"切到 in_progress
|
||||
* - 仅当 todo 且未到 expectedStartAt 时返回 true
|
||||
* - 已到点:自动机制接管,UI 不应再显示手动按钮
|
||||
* - 已超期:返回 false,UI 应要求填 delayReason
|
||||
*/
|
||||
export function canManualStart(task: DevTask, now: Date = new Date()): boolean {
|
||||
if (task.status !== 'todo') return false;
|
||||
if (!task.expectedStartAt) return true;
|
||||
return now.getTime() < new Date(task.expectedStartAt).getTime();
|
||||
}
|
||||
|
||||
/**
|
||||
* 自动切换扫描:返回所有需要从 todo 切到 in_progress 的任务
|
||||
* - status === 'todo'
|
||||
* - now >= expectedStartAt(且未超期超过 0 秒就自动切——超期未切的可单独走 needsDelayReason 流程)
|
||||
*
|
||||
* 注意:超期任务也包含在内,由调用方决定要不要扫;当前策略是 fetchTasks 调用时只扫"刚好到点",
|
||||
* 超期任务保留在 todo 等用户填 delayReason。所以这里加 maxOverdueMs 参数,默认 24h 内的算到点。
|
||||
*/
|
||||
export function findTasksToAutoStart(
|
||||
tasks: DevTask[],
|
||||
now: Date = new Date(),
|
||||
maxOverdueMs: number = 24 * 60 * 60 * 1000,
|
||||
): Array<{ taskId: string; actualStartAt: string }> {
|
||||
const result: Array<{ taskId: string; actualStartAt: string }> = [];
|
||||
for (const t of tasks) {
|
||||
if (t.status !== 'todo' || !t.expectedStartAt || t.actualStartAt) continue;
|
||||
const expected = new Date(t.expectedStartAt).getTime();
|
||||
if (isNaN(expected)) continue;
|
||||
const diff = now.getTime() - expected;
|
||||
if (diff >= 0 && diff <= maxOverdueMs) {
|
||||
result.push({ taskId: t.id, actualStartAt: t.expectedStartAt });
|
||||
}
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* 是否处于"超期手动开干需填延后原因"状态
|
||||
* - todo 且 now > expectedStartAt
|
||||
*/
|
||||
export function needsDelayReason(task: DevTask, now: Date = new Date()): boolean {
|
||||
if (task.status !== 'todo' || !task.expectedStartAt) return false;
|
||||
return now.getTime() > new Date(task.expectedStartAt).getTime();
|
||||
}
|
||||
|
||||
/**
|
||||
* 进入 in_progress 时计算 actualStartAt
|
||||
* - auto: 等于 expectedStartAt
|
||||
* - manual: 等于 now
|
||||
*/
|
||||
export function deriveActualStartAt(
|
||||
task: DevTask,
|
||||
trigger: 'auto' | 'manual',
|
||||
now: Date = new Date(),
|
||||
): string {
|
||||
if (trigger === 'auto' && task.expectedStartAt) return task.expectedStartAt;
|
||||
return now.toISOString();
|
||||
}
|
||||
Reference in New Issue
Block a user