Browse Source

docs(order-management): 更新故事008.007,添加任务12修正订单详情弹窗添加人员流程

- 添加任务12:修正订单详情弹窗添加人员流程,与原系统保持一致
- 问题:当前实现选择人员后立即调用API,原系统是先添加到待添加列表
- 解决方案:实现待添加人员列表,支持薪资编辑,确认后才调用API
- 更新Change Log:添加版本1.6记录
- 更新状态:从Ready for Review改为In Progress

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
yourname 3 hours ago
parent
commit
16931b5459
1 changed files with 44 additions and 1 deletions
  1. 44 1
      docs/stories/008.007.transplant-order-management-ui.story.md

+ 44 - 1
docs/stories/008.007.transplant-order-management-ui.story.md

@@ -1,7 +1,7 @@
 # Story 008.007: 移植订单管理UI(order → @d8d/allin-order-management-ui)
 
 ## Status
-Ready for Review - 所有任务已完成,测试通过率96.2% (25/26)
+In Progress - 新增任务12需要实现,测试通过率96.2% (25/26)
 
 ## Story
 **As a** 开发者,
@@ -241,6 +241,48 @@ Ready for Review - 所有任务已完成,测试通过率96.2% (25/26)
     - 验证底部操作按钮功能正常
     - 验证工作状态更新功能
 
+- [ ] 任务12:修正订单详情弹窗添加人员流程,与原系统保持一致(新增)
+  - [ ] **问题分析**:当前订单详情弹窗中的添加人员流程与原系统不一致。当前实现是选择人员后立即调用API添加,而原系统的工作流程是:选择人员→添加到待添加人员列表→编辑薪资→点击"确认添加"按钮→调用API批量添加
+  - [ ] **解决方案**:修改OrderDetailModal组件,实现原系统的添加人员工作流程
+  - [ ] **实现步骤**:
+    1. **创建待添加人员状态管理**:
+       - 添加`pendingPersons`状态(对应原系统的`selectedPersons`)
+       - 每个待添加人员对象包含:`personId`、`name`、`gender`、`disabilityType`、`phone`、`salaryDetail`等字段
+    2. **修改人员选择处理逻辑**:
+       - 修改`handlePersonSelect`函数:将选择的人员添加到`pendingPersons`列表
+       - **自动查询薪资**:根据人员的省、市信息查询默认薪资(需要实现薪资查询功能)
+       - 检查重复:避免添加已在订单中或已在待添加列表中的人员
+    3. **创建待添加人员列表组件**:
+       - 在"绑定人员列表"上方添加"待添加人员列表"卡片
+       - 显示字段:ID、姓名、性别、残疾类型、联系电话、**薪资(可编辑)**、操作
+       - **薪资编辑**:使用`Input`组件,支持数值输入
+       - **移除功能**:支持从待添加列表中移除
+    4. **添加确认添加功能**:
+       - 在待添加人员列表上方添加"确认添加 (X)"按钮(X为待添加人员数量)
+       - 点击按钮时,调用`batchAddPersonsMutation.mutate(pendingPersons)`
+       - **入职日期**:使用当前日期`new Date().toISOString().split('T')[0]`
+       - 成功后清空`pendingPersons`列表,刷新订单人员列表
+    5. **实现薪资查询功能**:
+       - 根据人员的省、市信息查询默认薪资
+       - 需要调用薪资查询API(参考原系统`getSalaryByLocation`)
+    6. **更新UI布局**:
+       - 保持与原系统一致的布局:"待添加人员列表"在"绑定人员列表"上方
+       - 当有待添加人员时才显示"待添加人员列表"卡片
+  - [ ] **技术要求**:
+    - 保持与现有残疾人选择器组件(`DisabledPersonSelector`)的集成
+    - 实现薪资查询功能,需要调用新的API端点
+    - 确保与现有批量添加人员API的兼容性
+    - 入职日期使用当前日期,不可编辑
+  - [ ] **测试要求**:
+    - 验证选择人员后添加到待添加列表,不立即调用API
+    - 验证自动根据省、市查询默认薪资
+    - 验证在订单详情弹窗中显示待添加人员列表
+    - 验证支持编辑待添加人员的薪资
+    - 验证支持从待添加列表中移除人员
+    - 验证点击"确认添加 (X)"按钮后调用批量添加API
+    - 验证入职日期使用当前日期
+    - 验证成功后清空待添加列表,刷新显示
+
 ## Dev Notes
 
 ### 吸取前面故事的经验(基于故事008.006)
@@ -390,6 +432,7 @@ Ready for Review - 所有任务已完成,测试通过率96.2% (25/26)
 ## Change Log
 | Date | Version | Description | Author |
 |------|---------|-------------|--------|
+| 2025-12-08 | 1.6 | 添加任务12修正订单详情弹窗添加人员流程,与原系统保持一致 | John (PM) |
 | 2025-12-08 | 1.5 | 添加任务11实现订单详情弹窗功能,与原系统功能对齐 | John (PM) |
 | 2025-12-06 | 1.4 | 添加任务10修复订单创建时的人员绑定差异,确保与原系统功能一致 | John (PM) |
 | 2025-12-04 | 1.3 | 添加任务8修复window.confirm使用问题,替换为共享UI包AlertDialog | James (Dev) |