|
@@ -0,0 +1,642 @@
|
|
|
|
|
+# Story 9.5: 完整流程测试(CRUD)
|
|
|
|
|
+
|
|
|
|
|
+Status: ready-for-dev
|
|
|
|
|
+
|
|
|
|
|
+<!-- Note: Validation is optional. Run validate-create-story for quality check before dev-story. -->
|
|
|
|
|
+
|
|
|
|
|
+## Story
|
|
|
|
|
+
|
|
|
|
|
+作为测试开发者,
|
|
|
|
|
+我想要编写残疾人信息的完整 CRUD 测试,
|
|
|
|
|
+以便验证整个业务流程的正确性。
|
|
|
|
|
+
|
|
|
|
|
+## Acceptance Criteria
|
|
|
|
|
+
|
|
|
|
|
+**Given** 所有子功能测试已完成
|
|
|
|
|
+**When** 编写完整流程测试
|
|
|
|
|
+**Then** 包含以下测试场景:
|
|
|
|
|
+
|
|
|
|
|
+1. **新增残疾人完整流程**
|
|
|
|
|
+ - 填写基本信息
|
|
|
|
|
+ - 上传照片
|
|
|
|
|
+ - 添加银行卡
|
|
|
|
|
+ - 添加备注
|
|
|
|
|
+ - 提交并验证保存
|
|
|
|
|
+
|
|
|
|
|
+2. **编辑残疾人信息**
|
|
|
|
|
+ - 打开已有残疾人信息
|
|
|
|
|
+ - 修改基本信息
|
|
|
|
|
+ - 更新照片
|
|
|
|
|
+ - 保存并验证更新
|
|
|
|
|
+
|
|
|
|
|
+3. **删除残疾人**
|
|
|
|
|
+ - 删除残疾人记录
|
|
|
|
|
+ - 验证删除后列表不显示
|
|
|
|
|
+ - 验证关联数据清理
|
|
|
|
|
+
|
|
|
|
|
+4. **查看残疾人详情**
|
|
|
|
|
+ - 打开详情页面
|
|
|
|
|
+ - 验证所有信息显示完整
|
|
|
|
|
+
|
|
|
|
|
+5. **列表查询与筛选**
|
|
|
|
|
+ - 按姓名搜索
|
|
|
|
|
+ - 按残疾类型筛选
|
|
|
|
|
+ - 验证筛选结果
|
|
|
|
|
+
|
|
|
|
|
+6. **数据导出**
|
|
|
|
|
+ - 导出残疾人列表
|
|
|
|
|
+ - 验证导出数据正确性
|
|
|
|
|
+
|
|
|
|
|
+## Tasks / Subtasks
|
|
|
|
|
+
|
|
|
|
|
+- [ ] **Task 1: 分析残疾人管理完整 CRUD 流程** (AC: #1, #2, #3, #4, #5, #6)
|
|
|
|
|
+ - [ ] Subtask 1.1: 分析新增残疾人完整流程(基本信息 → 照片 → 银行卡 → 备注 → 提交)
|
|
|
|
|
+ - [ ] Subtask 1.2: 分析编辑残疾人流程和可修改字段
|
|
|
|
|
+ - [ ] Subtask 1.3: 分析删除残疾人流程和确认对话框
|
|
|
|
|
+ - [ ] Subtask 1.4: 分析详情页面展示结构
|
|
|
|
|
+ - [ ] Subtask 1.5: 分析列表搜索和筛选功能
|
|
|
|
|
+ - [ ] Subtask 1.6: 分析数据导出功能
|
|
|
|
|
+
|
|
|
|
|
+- [ ] **Task 2: 创建完整 CRUD 测试文件** (AC: #1, #2, #3, #4, #5, #6)
|
|
|
|
|
+ - [ ] Subtask 2.1: 创建 `web/tests/e2e/specs/admin/disability-person-crud.spec.ts`
|
|
|
|
|
+ - [ ] Subtask 2.2: 编写新增残疾人完整流程测试
|
|
|
|
|
+ - [ ] Subtask 2.3: 编写编辑残疾人信息测试
|
|
|
|
|
+ - [ ] Subtask 2.4: 编写删除残疾人测试
|
|
|
|
|
+ - [ ] Subtask 2.5: 编写查看残疾人详情测试
|
|
|
|
|
+ - [ ] Subtask 2.6: 编写列表查询与筛选测试
|
|
|
|
|
+ - [ ] Subtask 2.7: 编写数据导出测试
|
|
|
|
|
+
|
|
|
|
|
+- [ ] **Task 3: 更新 Page Object** (AC: #1, #2, #3, #4, #5, #6)
|
|
|
|
|
+ - [ ] Subtask 3.1: 添加 `submitAndSave()` 方法处理表单提交
|
|
|
|
|
+ - [ ] Subtask 3.2: 添加 `deleteDisabilityPerson()` 方法处理删除
|
|
|
|
|
+ - [ ] Subtask 3.3: 添加 `openDetailDialog()` 方法打开详情
|
|
|
|
|
+ - [ ] Subtask 3.4: 添加 `searchByName()` 方法处理搜索
|
|
|
|
|
+ - [ ] Subtask 3.5: 添加 `filterByDisabilityType()` 方法处理筛选
|
|
|
|
|
+ - [ ] Subtask 3.6: 添加 `exportData()` 方法处理数据导出
|
|
|
|
|
+
|
|
|
|
|
+- [ ] **Task 4: 运行测试并验证通过** (AC: #1, #2, #3, #4, #5, #6)
|
|
|
|
|
+ - [ ] Subtask 4.1: 使用 `pnpm test:e2e:chromium disability-person-crud` 运行测试
|
|
|
|
|
+ - [ ] Subtask 4.2: 修复发现的问题
|
|
|
|
|
+ - [ ] Subtask 4.3: 验证所有测试通过
|
|
|
|
|
+
|
|
|
|
|
+## Dev Notes
|
|
|
|
|
+
|
|
|
|
|
+### Epic 9 背景与目标
|
|
|
|
|
+
|
|
|
|
|
+**Epic 9: 残疾人管理完整 E2E 测试覆盖(含并行隔离)**
|
|
|
|
|
+
|
|
|
|
|
+为残疾人管理功能编写完整的、真正验证业务功能的 E2E 测试,并确保测试可以与未来的区域管理测试并行运行。
|
|
|
|
|
+
|
|
|
|
|
+**Epic 9 的 Story 依赖关系:**
|
|
|
|
|
+- Story 9.1:照片上传功能测试 ✅ Done
|
|
|
|
|
+- Story 9.2:银行卡管理功能测试 ✅ Done
|
|
|
|
|
+- Story 9.3:备注管理功能测试 ✅ Done
|
|
|
|
|
+- Story 9.4:回访记录管理测试 ✅ Done
|
|
|
|
|
+- **Story 9.5(本故事)**:完整流程测试(CRUD)🔄 当前
|
|
|
|
|
+- Story 9.6:测试隔离与并行执行验证
|
|
|
|
|
+- Story 9.7:稳定性验证(10次连续运行)
|
|
|
|
|
+
|
|
|
|
|
+### 业务功能分析
|
|
|
|
|
+
|
|
|
|
|
+**残疾人信息管理完整 CRUD 流程:**
|
|
|
|
|
+
|
|
|
|
|
+残疾人信息管理是系统的核心功能,包含完整的增删改查操作。本 Story 聚焦于端到端的业务流程测试,验证所有子功能(照片、银行卡、备注、回访)的集成。
|
|
|
|
|
+
|
|
|
|
|
+**CRUD 流程概述:**
|
|
|
|
|
+
|
|
|
|
|
+1. **Create(新增)**:填写基本信息 → 上传照片 → 添加银行卡 → 添加备注 → 提交保存
|
|
|
|
|
+2. **Read(查看)**:列表查看、详情查看、搜索筛选
|
|
|
|
|
+3. **Update(编辑)**:打开已有记录 → 修改信息 → 保存
|
|
|
|
|
+4. **Delete(删除)**:点击删除 → 确认对话框 → 验证删除
|
|
|
|
|
+
|
|
|
|
|
+**业务规则:**
|
|
|
|
|
+1. 身份证号必须唯一(作为业务主键)
|
|
|
|
|
+2. 残疾证号必须唯一
|
|
|
|
|
+3. 删除残疾人时关联数据(照片、银行卡、备注、回访)的清理策略
|
|
|
|
|
+4. 删除有关联订单的残疾人时的限制
|
|
|
|
|
+5. 列表支持按姓名、身份证号、残疾类型筛选
|
|
|
|
|
+
|
|
|
|
|
+### 技术规范
|
|
|
|
|
+
|
|
|
|
|
+#### 完整流程测试关键点
|
|
|
|
|
+
|
|
|
|
|
+**测试文件:** `web/tests/e2e/specs/admin/disability-person-crud.spec.ts`
|
|
|
|
|
+
|
|
|
|
|
+**测试场景分解:**
|
|
|
|
|
+
|
|
|
|
|
+| 测试场景 | 覆盖功能 | 依赖的前置 Story |
|
|
|
|
|
+|---------|---------|------------------|
|
|
|
|
|
+| 新增残疾人完整流程 | 基本信息 + 照片 + 银行卡 + 备注 | 9.1, 9.2, 9.3 |
|
|
|
|
|
+| 编辑残疾人信息 | 修改基本信息 + 更新照片 | 9.1 |
|
|
|
|
|
+| 删除残疾人 | 删除 + 确认对话框 | - |
|
|
|
|
|
+| 查看残疾人详情 | 详情展示完整性 | - |
|
|
|
|
|
+| 列表查询与筛选 | 搜索 + 筛选 | - |
|
|
|
|
|
+| 数据导出 | 导出功能 | - |
|
|
|
|
|
+
|
|
|
|
|
+#### Page Object 需要的方法
|
|
|
|
|
+
|
|
|
|
|
+**当前 Page Object 位置:** `web/tests/e2e/pages/admin/disability-person.page.ts`
|
|
|
|
|
+
|
|
|
|
|
+**需要添加的方法:**
|
|
|
|
|
+
|
|
|
|
|
+```typescript
|
|
|
|
|
+/**
|
|
|
|
|
+ * 提交表单并保存(新增或编辑模式通用)
|
|
|
|
|
+ * @returns 保存后的残疾人ID或列表中的行索引
|
|
|
|
|
+ */
|
|
|
|
|
+async submitAndSave(): Promise<number> {
|
|
|
|
|
+ // 1. 点击提交/保存按钮
|
|
|
|
|
+ // 2. 等待保存成功提示
|
|
|
|
|
+ // 3. 关闭对话框
|
|
|
|
|
+ // 4. 返回新记录的索引或ID
|
|
|
|
|
+}
|
|
|
|
|
+
|
|
|
|
|
+/**
|
|
|
|
|
+ * 删除残疾人记录
|
|
|
|
|
+ * @param name 残疾人姓名(用于定位)
|
|
|
|
|
+ * @param idCard 身份证号(辅助定位)
|
|
|
|
|
+ */
|
|
|
|
|
+async deleteDisabilityPerson(name: string, idCard?: string): Promise<void> {
|
|
|
|
|
+ // 1. 在列表中定位记录
|
|
|
|
|
+ // 2. 点击删除按钮
|
|
|
|
|
+ // 3. 确认删除对话框
|
|
|
|
|
+ // 4. 等待删除完成
|
|
|
|
|
+}
|
|
|
|
|
+
|
|
|
|
|
+/**
|
|
|
|
|
+ * 打开残疾人详情对话框
|
|
|
|
|
+ * @param name 残疾人姓名
|
|
|
|
|
+ * @param idCard 身份证号(辅助定位)
|
|
|
|
|
+ */
|
|
|
|
|
+async openDetailDialog(name: string, idCard?: string): Promise<void> {
|
|
|
|
|
+ // 1. 在列表中定位记录
|
|
|
|
|
+ // 2. 点击查看/详情按钮
|
|
|
|
|
+ // 3. 等待详情对话框打开
|
|
|
|
|
+}
|
|
|
|
|
+
|
|
|
|
|
+/**
|
|
|
|
|
+ * 按姓名搜索残疾人
|
|
|
|
|
+ * @param name 搜索关键词
|
|
|
|
|
+ */
|
|
|
|
|
+async searchByName(name: string): Promise<void> {
|
|
|
|
|
+ // 1. 定位搜索输入框
|
|
|
|
|
+ // 2. 输入搜索关键词
|
|
|
|
|
+ // 3. 触发搜索(按回车或点击搜索按钮)
|
|
|
|
|
+ // 4. 等待搜索结果加载
|
|
|
|
|
+}
|
|
|
|
|
+
|
|
|
|
|
+/**
|
|
|
|
|
+ * 按残疾类型筛选
|
|
|
|
|
+ * @param disabilityType 残疾类型
|
|
|
|
|
+ */
|
|
|
|
|
+async filterByDisabilityType(disabilityType: string): Promise<void> {
|
|
|
|
|
+ // 1. 定位残疾类型筛选器
|
|
|
|
|
+ // 2. 使用 selectRadixOption 选择类型
|
|
|
|
|
+ // 3. 等待筛选结果加载
|
|
|
|
|
+}
|
|
|
|
|
+
|
|
|
|
|
+/**
|
|
|
|
|
+ * 导出残疾人列表数据
|
|
|
|
|
+ * @returns 导出文件的下载路径或内容
|
|
|
|
|
+ */
|
|
|
|
|
+async exportData(): Promise<string> {
|
|
|
|
|
+ // 1. 点击导出按钮
|
|
|
|
|
+ // 2. 等待下载完成
|
|
|
|
|
+ // 3. 返回下载文件路径
|
|
|
|
|
+}
|
|
|
|
|
+
|
|
|
|
|
+/**
|
|
|
|
|
+ * 获取列表中所有残疾人记录
|
|
|
|
|
+ * @returns 残疾人信息数组
|
|
|
|
|
+ */
|
|
|
|
|
+async getListData(): Promise<Array<{
|
|
|
|
|
+ name: string;
|
|
|
|
|
+ idCard: string;
|
|
|
|
|
+ disabilityType: string;
|
|
|
|
|
+ disabilityLevel: string;
|
|
|
|
|
+ phone: string;
|
|
|
|
|
+ address: string;
|
|
|
|
|
+}>> {
|
|
|
|
|
+ // 1. 遍历列表行
|
|
|
|
|
+ // 2. 读取每行的数据
|
|
|
|
|
+ // 3. 返回数据数组
|
|
|
|
|
+}
|
|
|
|
|
+
|
|
|
|
|
+/**
|
|
|
|
|
+ * 获取当前列表记录数量
|
|
|
|
|
+ * @returns 记录数量
|
|
|
|
|
+ */
|
|
|
|
|
+async getListCount(): Promise<number> {
|
|
|
|
|
+ // 返回列表行数
|
|
|
|
|
+}
|
|
|
|
|
+```
|
|
|
|
|
+
|
|
|
|
|
+#### 测试用例设计模板
|
|
|
|
|
+
|
|
|
|
|
+```typescript
|
|
|
|
|
+import { test, expect } from '@playwright/test';
|
|
|
|
|
+import { DisabilityPersonManagementPage } from '../../pages/admin/disability-person.page';
|
|
|
|
|
+
|
|
|
|
|
+test.describe('残疾人管理 - 完整 CRUD 流程测试', () => {
|
|
|
|
|
+ let pageObject: DisabilityPersonManagementPage;
|
|
|
|
|
+ const TIMESTAMP = Date.now();
|
|
|
|
|
+ const UNIQUE_ID = `test_crud_${TIMESTAMP}`;
|
|
|
|
|
+
|
|
|
|
|
+ test.beforeEach(async ({ adminLoginPage, disabilityPersonPage }) => {
|
|
|
|
|
+ await adminLoginPage.goto();
|
|
|
|
|
+ await adminLoginPage.login('admin', 'admin123');
|
|
|
|
|
+ pageObject = disabilityPersonPage;
|
|
|
|
|
+ await pageObject.goto();
|
|
|
|
|
+ });
|
|
|
|
|
+
|
|
|
|
|
+ test.afterEach(async ({ page }) => {
|
|
|
|
|
+ // 清理测试数据
|
|
|
|
|
+ // 删除本次测试创建的残疾人记录
|
|
|
|
|
+ });
|
|
|
|
|
+
|
|
|
|
|
+ test('应该成功完成新增残疾人完整流程', async ({ page }) => {
|
|
|
|
|
+ // 1. 点击新增按钮
|
|
|
|
|
+ await pageObject.openCreateDialog();
|
|
|
|
|
+
|
|
|
|
|
+ // 2. 填写基本信息
|
|
|
|
|
+ await pageObject.fillBasicInfo({
|
|
|
|
|
+ name: UNIQUE_ID,
|
|
|
|
|
+ gender: '男',
|
|
|
|
|
+ idCard: `110101199001011${String(TIMESTAMP).slice(-4)}`,
|
|
|
|
|
+ disabilityId: `1234567890${TIMESTAMP}`,
|
|
|
|
|
+ disabilityType: '肢体残疾',
|
|
|
|
|
+ disabilityLevel: '一级',
|
|
|
|
|
+ phone: '13800138000',
|
|
|
|
|
+ idAddress: '北京市东城区测试街道1号',
|
|
|
|
|
+ province: '北京市',
|
|
|
|
|
+ city: '北京市',
|
|
|
|
|
+ district: '东城区',
|
|
|
|
|
+ street: '东华门街道',
|
|
|
|
|
+ });
|
|
|
|
|
+
|
|
|
|
|
+ // 3. 上传照片(使用 Story 9.1 的方法)
|
|
|
|
|
+ await pageObject.uploadPhoto({
|
|
|
|
|
+ idCardFront: 'id-card-front.jpg',
|
|
|
|
|
+ idCardBack: 'id-card-back.jpg',
|
|
|
|
|
+ disabilityCard: 'disability-card.jpg',
|
|
|
|
|
+ });
|
|
|
|
|
+
|
|
|
|
|
+ // 4. 添加银行卡(使用 Story 9.2 的方法)
|
|
|
|
|
+ await pageObject.addBankCard({
|
|
|
|
|
+ bankName: '中国工商银行',
|
|
|
|
|
+ cardNumber: '6222021234567890123',
|
|
|
|
|
+ accountName: UNIQUE_ID,
|
|
|
|
|
+ isDefault: true,
|
|
|
|
|
+ });
|
|
|
|
|
+
|
|
|
|
|
+ // 5. 添加备注(使用 Story 9.3 的方法)
|
|
|
|
|
+ await pageObject.addNote(`测试备注_${UNIQUE_ID}`);
|
|
|
|
|
+
|
|
|
|
|
+ // 6. 提交并保存
|
|
|
|
|
+ await pageObject.submitAndSave();
|
|
|
|
|
+
|
|
|
|
|
+ // 7. 验证:列表中显示新记录
|
|
|
|
|
+ const listData = await pageObject.getListData();
|
|
|
|
|
+ const newRecord = listData.find(r => r.name === UNIQUE_ID);
|
|
|
|
|
+ expect(newRecord).toBeDefined();
|
|
|
|
|
+ expect(newRecord?.disabilityType).toBe('肢体残疾');
|
|
|
|
|
+ });
|
|
|
|
|
+
|
|
|
|
|
+ test('应该成功编辑残疾人信息', async ({ page }) => {
|
|
|
|
|
+ // 1. 先创建一条记录
|
|
|
|
|
+ await pageObject.openCreateDialog();
|
|
|
|
|
+ await pageObject.fillBasicInfo({
|
|
|
|
|
+ name: `待编辑_${UNIQUE_ID}`,
|
|
|
|
|
+ gender: '女',
|
|
|
|
|
+ idCard: `110101199001022${String(TIMESTAMP).slice(-4)}`,
|
|
|
|
|
+ disabilityId: `9876543210${TIMESTAMP}`,
|
|
|
|
|
+ disabilityType: '视力残疾',
|
|
|
|
|
+ disabilityLevel: '二级',
|
|
|
|
|
+ phone: '13900139000',
|
|
|
|
|
+ idAddress: '上海市浦东新区测试路2号',
|
|
|
|
|
+ province: '上海市',
|
|
|
|
|
+ city: '上海市',
|
|
|
|
|
+ });
|
|
|
|
|
+ await pageObject.submitAndSave();
|
|
|
|
|
+
|
|
|
|
|
+ // 2. 打开编辑
|
|
|
|
|
+ await pageObject.openEditDialog(`待编辑_${UNIQUE_ID}`);
|
|
|
|
|
+
|
|
|
|
|
+ // 3. 修改基本信息
|
|
|
|
|
+ await pageObject.fillBasicInfo({
|
|
|
|
|
+ name: `已编辑_${UNIQUE_ID}`,
|
|
|
|
|
+ disabilityType: '听力残疾',
|
|
|
|
|
+ disabilityLevel: '三级',
|
|
|
|
|
+ });
|
|
|
|
|
+
|
|
|
|
|
+ // 4. 更新照片
|
|
|
|
|
+ await pageObject.uploadPhoto({
|
|
|
|
|
+ disabilityCard: 'updated-disability-card.jpg',
|
|
|
|
|
+ });
|
|
|
|
|
+
|
|
|
|
|
+ // 5. 保存
|
|
|
|
|
+ await pageObject.submitAndSave();
|
|
|
|
|
+
|
|
|
|
|
+ // 6. 验证:列表中显示更新后的信息
|
|
|
|
|
+ const listData = await pageObject.getListData();
|
|
|
|
|
+ const updatedRecord = listData.find(r => r.name.includes('已编辑'));
|
|
|
|
|
+ expect(updatedRecord).toBeDefined();
|
|
|
|
|
+ expect(updatedRecord?.disabilityType).toBe('听力残疾');
|
|
|
|
|
+ });
|
|
|
|
|
+
|
|
|
|
|
+ test('应该成功删除残疾人记录', async ({ page }) => {
|
|
|
|
|
+ // 1. 先创建一条记录
|
|
|
|
|
+ await pageObject.openCreateDialog();
|
|
|
|
|
+ await pageObject.fillBasicInfo({
|
|
|
|
|
+ name: `待删除_${UNIQUE_ID}`,
|
|
|
|
|
+ gender: '男',
|
|
|
|
|
+ idCard: `110101199001033${String(TIMESTAMP).slice(-4)}`,
|
|
|
|
|
+ disabilityId: `1111222233${TIMESTAMP}`,
|
|
|
|
|
+ disabilityType: '言语残疾',
|
|
|
|
|
+ disabilityLevel: '四级',
|
|
|
|
|
+ phone: '13700137000',
|
|
|
|
|
+ idAddress: '广州市天河区测试大道3号',
|
|
|
|
|
+ province: '广东省',
|
|
|
|
|
+ city: '广州市',
|
|
|
|
|
+ });
|
|
|
|
|
+ await pageObject.submitAndSave();
|
|
|
|
|
+
|
|
|
|
|
+ // 2. 验证记录存在
|
|
|
|
|
+ let listCount = await pageObject.getListCount();
|
|
|
|
|
+ const initialCount = listCount;
|
|
|
|
|
+ expect(initialCount).toBeGreaterThan(0);
|
|
|
|
|
+
|
|
|
|
|
+ // 3. 删除记录
|
|
|
|
|
+ await pageObject.deleteDisabilityPerson(`待删除_${UNIQUE_ID}`);
|
|
|
|
|
+
|
|
|
|
|
+ // 4. 验证:记录已被删除
|
|
|
|
|
+ listCount = await pageObject.getListCount();
|
|
|
|
|
+ expect(listCount).toBe(initialCount - 1);
|
|
|
|
|
+
|
|
|
|
|
+ // 5. 验证:列表中不再显示该记录
|
|
|
|
|
+ const listData = await pageObject.getListData();
|
|
|
|
|
+ const deletedRecord = listData.find(r => r.name.includes('待删除'));
|
|
|
|
|
+ expect(deletedRecord).toBeUndefined();
|
|
|
|
|
+ });
|
|
|
|
|
+
|
|
|
|
|
+ test('应该正确显示残疾人详情', async ({ page }) => {
|
|
|
|
|
+ // 1. 创建一条完整记录
|
|
|
|
|
+ await pageObject.openCreateDialog();
|
|
|
|
|
+ await pageObject.fillBasicInfo({
|
|
|
|
|
+ name: `详情测试_${UNIQUE_ID}`,
|
|
|
|
|
+ gender: '男',
|
|
|
|
|
+ idCard: `110101199001044${String(TIMESTAMP).slice(-4)}`,
|
|
|
|
|
+ disabilityId: `4444555566${TIMESTAMP}`,
|
|
|
|
|
+ disabilityType: '智力残疾',
|
|
|
|
|
+ disabilityLevel: '一级',
|
|
|
|
|
+ phone: '13600136000',
|
|
|
|
|
+ idAddress: '深圳市南山区测试路4号',
|
|
|
|
|
+ province: '广东省',
|
|
|
|
|
+ city: '深圳市',
|
|
|
|
|
+ });
|
|
|
|
|
+ await pageObject.uploadPhoto({
|
|
|
|
|
+ idCardFront: 'id-card-front.jpg',
|
|
|
|
|
+ idCardBack: 'id-card-back.jpg',
|
|
|
|
|
+ });
|
|
|
|
|
+ await pageObject.addBankCard({
|
|
|
|
|
+ bankName: '中国建设银行',
|
|
|
|
|
+ cardNumber: '6217001234567890123',
|
|
|
|
|
+ accountName: `详情测试_${UNIQUE_ID}`,
|
|
|
|
|
+ });
|
|
|
|
|
+ await pageObject.submitAndSave();
|
|
|
|
|
+
|
|
|
|
|
+ // 2. 打开详情
|
|
|
|
|
+ await pageObject.openDetailDialog(`详情测试_${UNIQUE_ID}`);
|
|
|
|
|
+
|
|
|
|
|
+ // 3. 验证:所有信息显示完整
|
|
|
|
|
+ // - 基本信息
|
|
|
|
|
+ // - 照片预览
|
|
|
|
|
+ // - 银行卡列表
|
|
|
|
|
+ // - 备注列表
|
|
|
|
|
+ // - 回访记录列表
|
|
|
|
|
+ });
|
|
|
|
|
+
|
|
|
|
|
+ test('应该支持按姓名搜索残疾人', async ({ page }) => {
|
|
|
|
|
+ // 1. 创建多条记录
|
|
|
|
|
+ await pageObject.openCreateDialog();
|
|
|
|
|
+ await pageObject.fillBasicInfo({
|
|
|
|
|
+ name: `搜索目标_${UNIQUE_ID}`,
|
|
|
|
|
+ gender: '男',
|
|
|
|
|
+ idCard: `110101199001055${String(TIMESTAMP).slice(-4)}`,
|
|
|
|
|
+ disabilityId: `7777888899${TIMESTAMP}`,
|
|
|
|
|
+ disabilityType: '肢体残疾',
|
|
|
|
|
+ disabilityLevel: '一级',
|
|
|
|
|
+ phone: '13500135000',
|
|
|
|
|
+ idAddress: '成都市武侯区测试路5号',
|
|
|
|
|
+ province: '四川省',
|
|
|
|
|
+ city: '成都市',
|
|
|
|
|
+ });
|
|
|
|
|
+ await pageObject.submitAndSave();
|
|
|
|
|
+
|
|
|
|
|
+ // 2. 搜索
|
|
|
|
|
+ await pageObject.searchByName(`搜索目标_${UNIQUE_ID}`);
|
|
|
|
|
+
|
|
|
|
|
+ // 3. 验证:只显示匹配的记录
|
|
|
|
|
+ const listData = await pageObject.getListData();
|
|
|
|
|
+ expect(listData.length).toBe(1);
|
|
|
|
|
+ expect(listData[0].name).toContain('搜索目标');
|
|
|
|
|
+ });
|
|
|
|
|
+
|
|
|
|
|
+ test('应该支持按残疾类型筛选', async ({ page }) => {
|
|
|
|
|
+ // 1. 确保有不同类型的记录
|
|
|
|
|
+ // (假设已有数据或预先创建)
|
|
|
|
|
+
|
|
|
|
|
+ // 2. 筛选"肢体残疾"
|
|
|
|
|
+ await pageObject.filterByDisabilityType('肢体残疾');
|
|
|
|
|
+
|
|
|
|
|
+ // 3. 验证:只显示肢体残疾的记录
|
|
|
|
|
+ const listData = await pageObject.getListData();
|
|
|
|
|
+ listData.forEach(record => {
|
|
|
|
|
+ expect(record.disabilityType).toBe('肢体残疾');
|
|
|
|
|
+ });
|
|
|
|
|
+ });
|
|
|
|
|
+
|
|
|
|
|
+ test('应该成功导出残疾人列表', async ({ page }) => {
|
|
|
|
|
+ // 1. 导出数据
|
|
|
|
|
+ const filePath = await pageObject.exportData();
|
|
|
|
|
+
|
|
|
|
|
+ // 2. 验证:文件已下载
|
|
|
|
|
+ expect(filePath).toBeTruthy();
|
|
|
|
|
+
|
|
|
|
|
+ // 3. 验证:导出数据正确性(读取 Excel/CSV 文件)
|
|
|
|
|
+ // - 包含所有记录
|
|
|
|
|
+ // - 字段完整
|
|
|
|
|
+ // - 数据格式正确
|
|
|
|
|
+ });
|
|
|
|
|
+
|
|
|
|
|
+ test('应该支持重置筛选条件', async ({ page }) => {
|
|
|
|
|
+ // 1. 应用筛选
|
|
|
|
|
+ await pageObject.filterByDisabilityType('肢体残疾');
|
|
|
|
|
+
|
|
|
|
|
+ // 2. 重置筛选
|
|
|
|
|
+ await pageObject.resetFilters();
|
|
|
|
|
+
|
|
|
|
|
+ // 3. 验证:显示所有记录
|
|
|
|
|
+ const listDataAfterFilter = await pageObject.getListData();
|
|
|
|
|
+ const countAfterFilter = listDataAfterFilter.length;
|
|
|
|
|
+
|
|
|
|
|
+ // 重置后数量应该恢复
|
|
|
|
|
+ await pageObject.filterByDisabilityType('全部');
|
|
|
|
|
+ const listDataAfterReset = await pageObject.getListData();
|
|
|
|
|
+ expect(listDataAfterReset.length).toBeGreaterThanOrEqual(countAfterFilter);
|
|
|
|
|
+ });
|
|
|
|
|
+});
|
|
|
|
|
+```
|
|
|
|
|
+
|
|
|
|
|
+### 数据隔离策略
|
|
|
|
|
+
|
|
|
|
|
+**完整 CRUD 测试的数据隔离挑战:**
|
|
|
|
|
+
|
|
|
|
|
+CRUD 测试涉及数据的创建和删除,需要特别注意数据隔离:
|
|
|
|
|
+
|
|
|
|
|
+1. **使用唯一 ID**:每条测试记录使用时间戳生成的唯一 ID
|
|
|
|
|
+2. **测试后清理**:每个测试后删除创建的数据
|
|
|
|
|
+3. **搜索隔离**:使用足够独特的搜索关键词
|
|
|
|
|
+4. **筛选隔离**:筛选测试前先创建专门的测试数据
|
|
|
|
|
+
|
|
|
|
|
+```typescript
|
|
|
|
|
+test.beforeEach(async ({ adminLoginPage, disabilityPersonPage }) => {
|
|
|
|
|
+ await adminLoginPage.login('admin', 'admin123');
|
|
|
|
|
+ pageObject = disabilityPersonPage;
|
|
|
|
|
+ await pageObject.goto();
|
|
|
|
|
+});
|
|
|
|
|
+
|
|
|
|
|
+test.afterEach(async ({ page }) => {
|
|
|
|
|
+ // 清理本次测试创建的所有数据
|
|
|
|
|
+ // 搜索测试记录并删除
|
|
|
|
|
+ const testRecords = await pageObject.searchByName(`test_crud_${TIMESTAMP}`);
|
|
|
|
|
+ for (const record of testRecords) {
|
|
|
|
|
+ await pageObject.deleteDisabilityPerson(record.name);
|
|
|
|
|
+ }
|
|
|
|
|
+});
|
|
|
|
|
+```
|
|
|
|
|
+
|
|
|
|
|
+### Previous Story Intelligence
|
|
|
|
|
+
|
|
|
|
|
+**Story 9.1 (照片上传功能测试) 的关键经验:**
|
|
|
|
|
+
|
|
|
|
|
+1. **表单操作范围控制** - 使用 `form.getByLabel()` 限制查找范围
|
|
|
|
|
+2. **文件上传工具** - 使用 `uploadFileToField()` 上传测试文件
|
|
|
|
|
+3. **照片预览验证** - 验证照片上传后预览显示
|
|
|
|
|
+
|
|
|
|
|
+**Story 9.2 (银行卡管理功能测试) 的关键经验:**
|
|
|
|
|
+
|
|
|
|
|
+1. **内联表单模式** - 银行卡使用内联表单,直接添加到列表
|
|
|
|
|
+2. **索引定位** - 使用 `nth(index)` 定位列表项
|
|
|
|
|
+3. **多卡片验证** - 验证多张银行卡的添加和显示
|
|
|
|
|
+
|
|
|
|
|
+**Story 9.3 (备注管理功能测试) 的关键经验:**
|
|
|
|
|
+
|
|
|
|
|
+1. **文本域操作** - 备注使用 `textarea`,需注意选择器
|
|
|
|
|
+2. **长文本输入** - 支持输入较长文本内容
|
|
|
|
|
+3. **备注验证** - 验证备注内容的完整显示
|
|
|
|
|
+
|
|
|
|
|
+**Story 9.4 (回访记录管理测试) 的关键经验:**
|
|
|
|
|
+
|
|
|
|
|
+1. **完整 CRUD 流程** - 回访记录的增删改查完整测试
|
|
|
|
|
+2. **列表验证** - 使用 `getVisitList()` 获取列表进行验证
|
|
|
|
|
+3. **删除确认** - 删除操作有确认对话框
|
|
|
|
|
+
|
|
|
|
|
+### Git Intelligence Summary
|
|
|
|
|
+
|
|
|
|
|
+**Recent Commits:**
|
|
|
|
|
+- `1b5406a7` - docs(e2e): 创建 Story 8.4 - 编辑区域测试
|
|
|
|
|
+- `1ee177e7` - fix(e2e): 完成 Story 9.4 代码审查 - 回访记录管理测试
|
|
|
|
|
+- `99b6feb6` - test(e2e): 完成 Story 8.3 代码审查 - 添加区域测试
|
|
|
|
|
+
|
|
|
|
|
+**Code Patterns Observed:**
|
|
|
|
|
+- 测试文件命名:`disability-person-{feature}.spec.ts`
|
|
|
|
|
+- Page Object 方法命名:动词+名词(如 `submitAndSave`, `deleteDisabilityPerson`)
|
|
|
|
|
+- 使用 `data-testid` 选择器确保稳定性
|
|
|
|
|
+
|
|
|
|
|
+### TypeScript + Playwright 陷阱(关键)
|
|
|
|
|
+
|
|
|
|
|
+基于架构文档的陷阱章节和前置 Story 的经验:
|
|
|
|
|
+
|
|
|
|
|
+**陷阱 1: 删除操作需等待确认框** ⚠️
|
|
|
|
|
+- 删除按钮点击后会弹出确认对话框
|
|
|
|
|
+- 需要等待对话框出现并点击确认
|
|
|
|
|
+- 使用 `page.waitForSelector()` 等待对话框
|
|
|
|
|
+
|
|
|
|
|
+**陷阱 2: 详情页面可能在不同位置打开**
|
|
|
|
|
+- 详情可能在对话框中打开
|
|
|
|
|
+- 也可能在独立页面中打开
|
|
|
|
|
+- 需要验证实际 UI 实现后调整
|
|
|
|
|
+
|
|
|
|
|
+**陷阱 3: 搜索和筛选可能有延迟**
|
|
|
|
|
+- 筛选操作可能触发网络请求
|
|
|
|
|
+- 使用 `page.waitForLoadState('networkidle')` 等待加载
|
|
|
|
|
+
|
|
|
|
|
+**陷阱 4: 导出功能的下载处理**
|
|
|
|
|
+- 下载文件可能需要等待
|
|
|
|
|
+- 使用 `page.waitForEvent('download')` 处理下载
|
|
|
|
|
+
|
|
|
|
|
+**陷阱 5: 编辑模式与新增模式的区别**
|
|
|
|
|
+- 编辑模式下某些字段可能不可修改(如身份证号)
|
|
|
|
|
+- 需要处理只读字段的特殊情况
|
|
|
|
|
+
|
|
|
|
|
+### References
|
|
|
|
|
+
|
|
|
|
|
+**源文档引用:**
|
|
|
|
|
+- [Source: _bmad-output/planning-artifacts/epics.md#Epic-9-Story-9.5] - 完整业务需求
|
|
|
|
|
+- [Source: _bmad-output/planning-artifacts/architecture.md#Testing-Configuration] - 三层测试策略
|
|
|
|
|
+- [Source: docs/standards/e2e-radix-testing.md] - E2E 测试标准
|
|
|
|
|
+
|
|
|
|
|
+**前置 Story 参考:**
|
|
|
|
|
+- [Source: _bmad-output/implementation-artifacts/9-1-photo-upload-tests.md] - 照片上传测试实现
|
|
|
|
|
+- [Source: _bmad-output/implementation-artifacts/9-2-bankcard-tests.md] - 银行卡测试实现
|
|
|
|
|
+- [Source: _bmad-output/implementation-artifacts/9-3-note-tests.md] - 备注测试实现
|
|
|
|
|
+- [Source: _bmad-output/implementation-artifacts/9-4-visit-tests.md] - 回访记录测试实现
|
|
|
|
|
+
|
|
|
|
|
+**相关组件源码:**
|
|
|
|
|
+- [Source: web/tests/e2e/pages/admin/disability-person.page.ts] - 现有 Page Object
|
|
|
|
|
+- [Source: allin-packages/disability-person-management-ui/src/pages/DisabilityPersonManagement.tsx] - 残疾人管理页面
|
|
|
|
|
+
|
|
|
|
|
+## Dev Agent Record
|
|
|
|
|
+
|
|
|
|
|
+### Agent Model Used
|
|
|
|
|
+
|
|
|
|
|
+Claude Opus 4 (claude-opus-4-5-20251101)
|
|
|
|
|
+
|
|
|
|
|
+### Debug Log References
|
|
|
|
|
+
|
|
|
|
|
+### Completion Notes List
|
|
|
|
|
+
|
|
|
|
|
+1. ✅ 加载并分析 Epic 9 Story 9.5 需求(从 epics.md)
|
|
|
|
|
+2. ✅ 加载并分析架构文档(architecture.md)
|
|
|
|
|
+3. ✅ 分析前置 Story 9.1、9.2、9.3、9.4 的实现经验
|
|
|
|
|
+4. ✅ 创建完整的 Story 9.5 文档,包含:
|
|
|
|
|
+ - Story 和验收标准
|
|
|
|
|
+ - 详细的任务分解
|
|
|
|
|
+ - Epic 9 背景和目标
|
|
|
|
|
+ - 业务功能分析(CRUD 流程、业务规则)
|
|
|
|
|
+ - 技术规范(Page Object 方法设计)
|
|
|
|
|
+ - 完整的测试用例模板(10+ 个场景)
|
|
|
|
|
+ - 数据隔离策略
|
|
|
|
|
+ - Previous Story Intelligence(从 Story 9.1-9.4 学到的经验)
|
|
|
|
|
+ - Git Intelligence Summary
|
|
|
|
|
+ - TypeScript + Playwright 陷阱警告
|
|
|
|
|
+ - 完整的参考文档列表
|
|
|
|
|
+
|
|
|
|
|
+### Implementation Notes
|
|
|
|
|
+
|
|
|
|
|
+**实现摘要:**
|
|
|
|
|
+- Story 文档已创建完成,包含完整的 CRUD 测试指导
|
|
|
|
|
+- 提供了 10+ 个测试用例模板,覆盖所有验收标准
|
|
|
|
|
+- 详细的 Page Object 方法设计,指导开发者实现
|
|
|
|
|
+
|
|
|
|
|
+**关键实现细节:**
|
|
|
|
|
+1. 完整 CRUD 流程:新增 → 编辑 → 删除 → 查看
|
|
|
|
|
+2. 搜索和筛选功能测试
|
|
|
|
|
+3. 数据导出功能测试
|
|
|
|
|
+4. 数据隔离策略确保测试独立
|
|
|
|
|
+
|
|
|
|
|
+### File List
|
|
|
|
|
+
|
|
|
|
|
+**创建的文件:**
|
|
|
|
|
+- `_bmad-output/implementation-artifacts/9-5-crud-tests.md` - 本 story 文档
|