3.4 KiB
Order List Open Work Count Implementation Plan
For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (
- [ ]) syntax for tracking.
Goal: 订单列表待处理数量展示统一使用后端 open_work_item_count，不再使用旧 open_task_count 或前端自行相加。
Architecture: 类型层在订单列表 item 上补齐 open_work_item_count，页面层新增展示列和格式化 helper，只读取该统一字段。继续处理入口仍复用现有 V4 优先、旧任务回退 helper，不改变 V4 任务详情、任务列表或 S10/S99 来源通知逻辑。
Tech Stack: Vue 3, TypeScript, Vue Router, Vue I18n, Vitest, Vue Test Utils.
Global Constraints
- 不改后端接口。
- 不改 V4 订单任务详情页。
- 不改任务列表。
- 不改 S10/S99 来源通知逻辑。
- 不在前端计算
open_task_count + v4_open_order_task_count。 - 提交时不带入
.idea、client/dist.zip、后端代码或其他无关工作区改动。
Task 1: Order List Uses Backend Unified Open Count
Files:
- Modify:
client/src/types/reservation.ts - Modify:
client/src/views/reservation/ReservationOrderListView.vue - Modify:
client/src/tests/reservationViews.spec.ts - Modify:
client/src/tests/reservationService.spec.ts - Modify:
client/src/i18n/locales/zh-CN.ts - Modify:
client/src/i18n/locales/en-US.ts - Modify:
client/src/i18n/locales/th-TH.ts
Interfaces:
-
Consumes:
ReservationOrderListItem.open_work_item_count?: number | null -
Produces: 订单列表“待处理”列只展示
open_work_item_count -
Step 1: Write failing view test
Add a case where open_task_count=99, v4_open_order_task_count=88, and open_work_item_count=3; assert the order row shows 3 under the open count column and does not show 99 or 88.
- Step 2: Verify red
Run CI=true pnpm --dir client test -- reservationViews.spec.ts.
Expected: FAIL because the current order list has no open_work_item_count display.
- Step 3: Implement types and UI
Add open_work_item_count to ReservationOrderListItem. Add a “待处理 / Open work” column and render only formatOpenWorkItemCount(order).
- Step 4: Update service test
Add open_work_item_count to the order list service mock and assert the value is preserved.
- Step 5: Verify green
Run CI=true pnpm --dir client test -- reservationViews.spec.ts reservationService.spec.ts.
Task 2: Documentation, Review, Verification, Commit
Files:
- Modify:
PROJECT_STATE.md - Modify:
docs/project/frontend-backend/backend-to-frontend-notes.md - Modify:
docs/project/frontend-backend/frontend-to-backend-api-requests.md
Interfaces:
-
Produces: 前端已改用
open_work_item_count的状态说明 -
Step 1: Update docs
Record that frontend order list display now uses open_work_item_count and no longer uses open_task_count as the displayed count.
- Step 2: Run verification
Run:
-
CI=true pnpm --dir client lint -
CI=true pnpm --dir client typecheck -
CI=true pnpm --dir client test -
CI=true pnpm --dir client build -
Step 3: Code review
Review routing invariants, open count source, tests, docs, and staged files.
- Step 4: Commit
Stage only related frontend/doc files and commit with a Chinese message.