feat(工时): 增加通用工时汇总引擎

apps/web/lib/work-effort-engine.test.ts

@@ -0,0 +1,31 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+import { aggregateWorkEffort, roundHalfHour } from './work-effort-engine';
+
+test('roundHalfHour rounds to nearest half hour', () => {
+  assert.equal(roundHalfHour(0.24), 0);
+  assert.equal(roundHalfHour(0.25), 0.5);
+  assert.equal(roundHalfHour(1.24), 1);
+  assert.equal(roundHalfHour(1.25), 1.5);
+});
+
+test('aggregateWorkEffort calculates weighted progress by estimate', () => {
+  const result = aggregateWorkEffort([
+    { estimateHours: 1, actualHours: 0, progress: 0 },
+    { estimateHours: 3, actualHours: 1.25, progress: 100 },
+  ]);
+
+  assert.equal(result.estimateHours, 4);
+  assert.equal(result.actualHours, 1.5);
+  assert.equal(result.progress, 75);
+});
+
+test('aggregateWorkEffort falls back to item average when estimates are zero', () => {
+  const result = aggregateWorkEffort([
+    { estimateHours: 0, actualHours: 0, progress: 50 },
+    { estimateHours: 0, actualHours: 0, progress: 100 },
+  ]);
+
+  assert.equal(result.progress, 75);
+});