Browse Source

docs(story): 更新故事008.006任务列表,添加银行卡、备注、回访信息组件任务

- 添加任务8:实现银行卡、备注、回访信息组件
- 添加任务9:验证和测试
- 更新状态为In Progress
- 添加待实现功能说明
- 检查API支持情况:已确认支持银行卡、备注、回访信息

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 1 day ago
parent
commit
6d8e2aefca

+ 56 - 10
docs/stories/008.006.transplant-disability-person-management-ui.story.md

@@ -1,7 +1,7 @@
 # Story 008.006: 移植残疾人个人管理UI(disability_person → @d8d/allin-disability-person-management-ui)
 
 ## Status
-Ready for Review - 照片上传功能已完善
+In Progress - 需要实现银行卡、备注、回访信息组件
 
 ## Story
 **As a** 开发者,
@@ -128,8 +128,15 @@ Ready for Review - 照片上传功能已完善
   - [x] 创建备注管理组件:`src/components/RemarkManagement.tsx`
     - **目标文件**:`allin-packages/disability-person-management-ui/src/components/RemarkManagement.tsx`
     - **功能**:残疾人备注管理,支持添加、编辑、删除备注
+  - [ ] 创建银行卡管理组件:`src/components/BankCardManagement.tsx`
+    - **目标文件**:`allin-packages/disability-person-management-ui/src/components/BankCardManagement.tsx`
+    - **功能**:残疾人银行卡管理,支持添加、编辑、删除银行卡,支持默认银行卡设置
+    - **集成文件上传**:银行卡照片上传功能
+  - [ ] 创建回访信息管理组件:`src/components/VisitManagement.tsx`
+    - **目标文件**:`allin-packages/disability-person-management-ui/src/components/VisitManagement.tsx`
+    - **功能**:残疾人回访记录管理,支持添加、编辑、删除回访记录
   - [x] 创建多步骤表单状态管理:使用React状态管理多步骤表单流程
-    - **步骤**:基本信息 → 照片上传 → 区域选择 → 备注管理
+    - **步骤**:基本信息 → 照片上传 → 银行卡管理 → 区域选择 → 备注管理 → 回访管理
     - **状态管理**:使用React Context或useReducer管理多步骤状态
 
 - [x] 任务7:编写集成测试 (AC: 10)
@@ -148,6 +155,12 @@ Ready for Review - 照片上传功能已完善
   - [x] 实现枚举选择器集成测试:验证枚举选择功能
     - **测试场景**:枚举选择器组件集成,选项加载和选择
     - **验证点**:枚举值正确传递,表单验证正常工作
+  - [ ] 实现银行卡管理集成测试:验证银行卡管理功能
+    - **测试场景**:银行卡管理组件集成,银行卡添加、编辑、删除、默认银行卡设置
+    - **验证点**:银行卡照片上传功能,默认银行卡逻辑
+  - [ ] 实现回访信息集成测试:验证回访信息管理功能
+    - **测试场景**:回访信息管理组件集成,回访记录添加、编辑、删除
+    - **验证点**:回访日期、类型、内容等字段验证
   - [x] 实现表单验证测试:验证必填字段、身份证号唯一性等
     - **测试场景**:必填字段验证、身份证号格式验证、身份证号唯一性验证
     - **参考模式**:残疾人模块集成测试中的验证逻辑
@@ -155,14 +168,35 @@ Ready for Review - 照片上传功能已完善
     - **测试场景**:API错误、网络错误、表单验证错误
     - **参考模式**:平台管理集成测试中的错误处理
 
-- [x] 任务8:验证和测试 (AC: 11)
-  - [x] 运行`pnpm typecheck`确保无类型错误
-  - [x] 运行`pnpm test`确保所有集成测试通过
-  - [x] 验证文件上传组件集成正常工作
-  - [x] 验证区域选择器组件集成正常工作
-  - [x] 验证枚举选择器组件集成正常工作
-  - [x] 验证表单验证和错误处理功能
-  - [x] 验证组件导出和类型定义正确
+- [ ] 任务8:实现银行卡、备注、回访信息组件 (AC: 2, 3, 7, 8)
+  - [ ] 分析原系统银行卡管理功能:`allin_system-master/client/app/admin/dashboard/disability_person/AddDisabledPersonModal.tsx`
+    - **源文件**:`allin_system-master/client/app/admin/dashboard/disability_person/AddDisabledPersonModal.tsx`
+    - **查看要点**:银行卡管理UI、银行卡照片上传、默认银行卡设置
+  - [ ] 分析原系统回访信息管理功能:`allin_system-master/client/app/admin/dashboard/disability_person/AddDisabledPersonModal.tsx`
+    - **源文件**:`allin_system-master/client/app/admin/dashboard/disability_person/AddDisabledPersonModal.tsx`
+    - **查看要点**:回访记录管理UI、回访类型、回访内容、下次回访日期
+  - [ ] 创建银行卡管理组件:`src/components/BankCardManagement.tsx`
+    - **目标文件**:`allin-packages/disability-person-management-ui/src/components/BankCardManagement.tsx`
+    - **功能**:支持多个银行卡管理,每个银行卡包含银行名称、卡号、持卡人姓名、发卡支行、是否默认
+    - **文件上传**:集成FileSelector组件用于银行卡照片上传
+    - **默认银行卡逻辑**:只能有一个默认银行卡
+  - [ ] 创建回访信息管理组件:`src/components/VisitManagement.tsx`
+    - **目标文件**:`allin-packages/disability-person-management-ui/src/components/VisitManagement.tsx`
+    - **功能**:支持多个回访记录管理,每个回访包含回访日期、回访类型、回访内容、回访结果、下次回访日期
+  - [ ] 集成到主表单:在DisabilityPersonManagement.tsx中集成银行卡和回访信息管理
+    - **表单集成**:在创建/编辑表单中添加银行卡和回访信息管理标签页或折叠面板
+    - **数据传递**:通过聚合API传递银行卡和回访信息数据
+
+- [ ] 任务9:验证和测试 (AC: 10, 11)
+  - [ ] 运行`pnpm typecheck`确保无类型错误
+  - [ ] 运行`pnpm test`确保所有集成测试通过
+  - [ ] 验证文件上传组件集成正常工作
+  - [ ] 验证区域选择器组件集成正常工作
+  - [ ] 验证枚举选择器组件集成正常工作
+  - [ ] 验证银行卡管理组件集成正常工作
+  - [ ] 验证回访信息管理组件集成正常工作
+  - [ ] 验证表单验证和错误处理功能
+  - [ ] 验证组件导出和类型定义正确
 
 ## Dev Notes
 
@@ -418,6 +452,18 @@ Claude Code (d8d-model)
    - ✅ 集成聚合API,支持照片数据完整传输
    - ✅ 更新查看详情功能,显示照片预览
 
+9. **API支持检查完成**:
+   - ✅ 检查残疾人模块实体定义:已确认有银行卡、备注、回访信息实体
+   - ✅ 检查Schema定义:已确认有银行卡、备注、回访信息Schema
+   - ✅ 检查聚合API:已确认支持银行卡、备注、回访信息的创建、查询、更新
+   - ✅ 检查服务层实现:aggregated.service.ts已支持银行卡、备注、回访信息处理
+
+10. **待实现功能**:
+    - ⚠️ **银行卡管理组件**:需要创建`BankCardManagement.tsx`组件,支持多个银行卡管理、银行卡照片上传、默认银行卡设置
+    - ⚠️ **回访信息管理组件**:需要创建`VisitManagement.tsx`组件,支持多个回访记录管理
+    - ⚠️ **备注管理组件**:已在任务6中创建,但需要验证是否完整实现
+    - ⚠️ **主表单集成**:需要在DisabilityPersonManagement.tsx中集成银行卡、备注、回访信息管理功能
+
 ### File List
 **新创建的文件:**
 - `allin-packages/disability-person-management-ui/package.json` - 包配置文件