新增客户管理

赵旭婷
1 parent 33d656b8
Showing 14 changed files with 715 additions and 52 deletions
fixtures/testFixture.ts
pages/consignmentPage.ts
pages/customerPage.ts
test-data/img/海拉鲁.jpg
test-data/img/海拉鲁鲈鱼.jpg
test-data/img/牛肉.jpg
test-data/img/猪肉.jpg
test-data/img/苹果.jpg
test-data/img/莫利布林.jpg
test-data/img/角.jpg
test-data/img/鸭子.jpg
tests/consignmentOrder.spec.ts
tests/customer.spec.ts
utils/dataGenerator.ts
@@ -3,6 +3,7 @@ import { LoginPage } from &#39;../pages/loginPage&#39;;
 import { ProductPage } from '../pages/productPage';
 import { SalePage } from '../pages/salePage';
 import { ConsignmentPage } from '../pages/consignmentPage';
+import { CustomerPage } from '../pages/customerPage';
  
 /**
  * 页面对象夹具类型定义
@@ -27,6 +28,11 @@ export type PageFixtures = {
    * 代销入库页面
    */
   consignmentPage: ConsignmentPage;
+  
+  /**
+   * 客户管理页面
+   */
+  customerPage: CustomerPage;
 };
  
 /**
@@ -52,6 +58,11 @@ export const test = base.extend&lt;PageFixtures&gt;({
   consignmentPage: async ({ page }, use) => {
     await use(new ConsignmentPage(page));
   },
+  
+  // 客户管理页面
+  customerPage: async ({ page }, use) => {
+    await use(new CustomerPage(page));
+  },
 });
  
 /**
@@ -85,4 +96,8 @@ export const fullTest = authTest.extend&lt;PageFixtures&gt;({
   consignmentPage: async ({ authenticatedPage }, use) => {
     await use(new ConsignmentPage(authenticatedPage));
   },
-});
 \ No newline at end of file
+  customerPage: async ({authenticatedPage }, use) =>{
+    await use(new CustomerPage(authenticatedPage));
+  },
+  
+  });
 \ No newline at end of file
@@ -169,6 +169,37 @@ export class ConsignmentPage extends BasePage {
     await this.productListButton.click();
   }
  
+  // /**
+  //  * 获取商品列表中所有可用的商品名称
+  //  * @returns 商品名称数组
+  //  */
+  // async getAvailableProducts(): Promise<string[]> {
+  //   // 等待商品列表加载
+  //   await this.page.locator('.productName').first().waitFor({ state: 'visible', timeout: 5000 });
+    
+  //   // 获取所有商品名称
+  //   const productElements = await this.page.locator('.productName').allTextContents();
+  //   return productElements.filter(name => name.trim() !== '');
+  // }
+
+  // /**
+  //  * 随机选择一个商品
+  //  * @returns 随机选择的商品名称
+  //  */
+  // async selectRandomProduct(): Promise<string> {
+  //   const products = await this.getAvailableProducts();
+    
+  //   if (products.length === 0) {
+  //     throw new Error('商品列表为空，无法选择商品');
+  //   }
+    
+  //   const randomIndex = Math.floor(Math.random() * products.length);
+  //   const selectedProduct = products[randomIndex];
+  //   console.log(`随机选择的商品: ${selectedProduct}`);
+    
+  //   return selectedProduct;
+  // }
+
   /**
    * 选择商品
    * @param productName 商品名称
+import { Page, Locator, expect } from '@playwright/test';
+import { BasePage } from './basePage';
+
+/**
+ * 客户管理页面选择器
+ */
+const selectors = {
+  // 导航
+  customerMenu: 'text=客户管理',
+  addCustomerButton: 'text=新增客户',
+  
+  // 表单字段
+  customerNameInput: 'textbox', // 客户名称输入框
+  phoneInput: 'spinbutton', // 手机号输入框
+  idCardInput: 'textbox', // 身份证输入框
+  
+  // 客户分组
+  customerGroupPicker: '.nut-input__mask',
+  normalCustomerOption: 'uni-view:has-text("普通客户")',
+  
+  // 赊欠额度
+  creditLimitSwitch: '.nut-form-item__body__slots > .nut-switch',
+  creditLimitInput: 'uni-input:has-text("请输入赊欠额度/不输为不限额") input',
+  
+  // 车牌号
+  // licensePlateInput: '.nut-input__mask',
+  licensePlateInput:'uni-view:nth-child(11) > .nut-cell__value > .nut-form-item__body__slots > .input-wrapper > .flex-input > .nut-input > .nut-input__value > .nut-input__mask',
+  confirmLicenceButton:'text=确定',
+  // 省市区选择
+  regionPicker: 'uni-view:nth-child(12) > .nut-cell__value > .nut-form-item__body__slots > .input-wrapper > .flex-input > .nut-input > .nut-input__value > .nut-input__mask',
+  confirmRegionButton: 'text=确认选择',
+  
+  // 详细地址
+  detailedAddressInput: 'uni-view:nth-child(13) > .nut-cell__value > .nut-form-item__body__slots > .nut-input > .nut-input__value > .nut-input__input > .uni-input-wrapper > .uni-input-input',
+  
+  // 操作按钮
+  confirmButton: 'text=确定',
+  saveButton: 'text=保存',
+  
+  // 验证
+  customerInList: (customerName: string) => `uni-view:has-text("${customerName}")`,
+};
+
+/**
+ * 客户管理页面类
+ * 处理客户管理相关操作
+ */
+export class CustomerPage extends BasePage {
+  // 导航定位器
+  readonly customerMenu: Locator;
+  readonly addCustomerButton: Locator;
+  
+  // 表单字段
+  readonly customerNameInput: Locator;
+  readonly phoneInput: Locator;
+  readonly idCardInput: Locator;
+  
+  // 客户分组
+  readonly customerGroupPicker: Locator;
+  readonly normalCustomerOption: Locator;
+  
+  // 赊欠额度
+  readonly creditLimitSwitch: Locator;
+  readonly creditLimitInput: Locator;
+  
+  // 车牌号
+  readonly licensePlateInput: Locator;
+  
+  // 省市区选择
+  readonly regionPicker: Locator;
+  readonly confirmRegionButton: Locator;
+  
+  // 详细地址
+  readonly detailedAddressInput: Locator;
+  
+  // 操作按钮
+  readonly confirmButton: Locator;
+  readonly saveButton: Locator;
+
+  constructor(page: Page) {
+    super(page);
+    
+    this.customerMenu = page.getByText('客户管理');
+    this.addCustomerButton = page.getByText('新增客户');
+    this.customerNameInput = page.getByRole('textbox').nth(1);
+    this.phoneInput = page.getByRole('spinbutton').first();
+    this.idCardInput = page.getByRole('textbox').nth(2);
+    this.customerGroupPicker = page.locator('.nut-input__mask').first();
+    this.normalCustomerOption = page.locator('uni-view').filter({ hasText: /^普通客户$/ }).nth(3);
+    this.creditLimitSwitch = page.locator('.nut-form-item__body__slots > .nut-switch');
+    this.creditLimitInput = page.locator('uni-input').filter({ hasText: '请输入赊欠额度/不输为不限额' }).getByRole('spinbutton');
+    this.licensePlateInput = page.locator('.nut-input__mask').first();
+    this.regionPicker = page.locator('uni-view:nth-child(11) > .nut-cell__value > .nut-form-item__body__slots > .input-wrapper > .flex-input > .nut-input > .nut-input__value > .nut-input__mask');
+    this.confirmRegionButton = page.getByText('确认选择');
+    this.detailedAddressInput = page.locator('uni-view:nth-child(12) > .nut-cell__value > .nut-form-item__body__slots > .nut-input > .nut-input__value > .nut-input__input > .uni-input-wrapper > .uni-input-input');
+    this.confirmButton = page.getByText('确定');
+    this.saveButton = page.getByText('保存');
+  }
+
+  /**
+   * 导航到首页并等待加载
+   */
+  async gotoHome(): Promise<void> {
+    await this.navigate('/');
+    await this.page.waitForLoadState('networkidle', { timeout: 30000 });
+  }
+
+  /**
+   * 打开客户管理页面
+   */
+  async openCustomerManagement(): Promise<void> {
+    await this.customerMenu.click();
+    await this.page.waitForLoadState('networkidle', { timeout: 30000 });
+  }
+
+  /**
+   * 点击新增客户按钮
+   */
+  async clickAddCustomer(): Promise<void> {
+    await this.addCustomerButton.click();
+    await this.page.waitForLoadState('networkidle', { timeout: 30000 });
+  }
+
+  /**
+   * 填写客户名称
+   * @param name 客户名称
+   */
+  async fillCustomerName(name: string): Promise<void> {
+    await this.customerNameInput.click();
+    await this.customerNameInput.fill(name);
+  }
+
+  /**
+   * 填写手机号
+   * @param phone 手机号
+   */
+  async fillPhone(phone: string): Promise<void> {
+    await this.phoneInput.click();
+    await this.phoneInput.fill(phone);
+  }
+
+  /**
+   * 填写身份证号
+   * @param idCard 身份证号
+   */
+  async fillIdCard(idCard: string): Promise<void> {
+    await this.idCardInput.click();
+    await this.idCardInput.fill(idCard);
+  }
+
+  /**
+   * 选择客户分组（选择"普通客户"）
+   */
+  async selectCustomerGroup(): Promise<void> {
+    // 点击客户分组选择器
+    await this.customerGroupPicker.click();
+    
+    // 等待弹窗出现
+    await this.page.waitForTimeout(500);
+    
+    // 选择"普通客户"（使用 nth(4) 和 force: true 绕过遮罩层）
+    await this.page.locator('uni-view').filter({ hasText: /^普通客户$/ }).nth(4).click({ force: true });
+  }
+
+  /**
+   * 开启赊欠额度开关
+   */
+  async enableCreditLimit(): Promise<void> {
+    await this.creditLimitSwitch.click();
+  }
+
+  /**
+   * 填写赊欠额度
+   * @param amount 赊欠额度金额
+   */
+  async fillCreditLimit(amount: string): Promise<void> {
+    await this.creditLimitInput.click();
+    await this.creditLimitInput.fill(amount);
+  }
+
+  /**
+   * 填写车牌号
+   * @param licensePlate 车牌号（如：渝ZY0706）
+   */
+  async fillLicensePlate(licensePlate: string): Promise<void> {
+    // 等待页面稳定
+    await this.page.waitForTimeout(500);
+    
+    // 点击车牌号输入框 - nth-child(11)，开启赊欠额度后位置
+    await this.page.locator('uni-view:nth-child(11) > .nut-cell__value > .nut-form-item__body__slots > .input-wrapper > .flex-input > .nut-input > .nut-input__value > .nut-input__mask').click();
+    
+    // 等待车牌键盘面板加载完成
+    await this.page.waitForTimeout(1000);
+    
+    // 解析车牌号的省份和字母部分
+    const province = licensePlate.charAt(0); // 如：渝
+    const letter = licensePlate.charAt(1); // 如：Z
+    const numbers = licensePlate.substring(2); // 如：Y0706
+    
+    // 点击省份
+    await this.page.locator('uni-view').filter({ hasText: new RegExp(`^${province}$`) }).click();
+    
+    // 等待字母键盘出现
+    await this.page.waitForTimeout(300);
+    
+    // 点击第一个字母（需要用 nth(1) 选择第二个匹配项）
+    await this.page.locator('uni-view').filter({ hasText: new RegExp(`^${letter}$`) }).nth(1).click();
+    
+    // 逐个点击车牌号码
+    for (let i = 0; i < numbers.length; i++) {
+      const char = numbers[i];
+      await this.page.waitForTimeout(100);
+      if (char.match(/[A-Za-z]/)) {
+        // 字母
+        await this.page.locator('uni-view').filter({ hasText: new RegExp(`^${char.toUpperCase()}$`) }).click();
+      } else if (char.match(/[0-9]/)) {
+        // 数字 - 检查是否需要使用 nth(1)
+        const digitCount = await this.page.locator('uni-view').filter({ hasText: new RegExp(`^${char}$`) }).count();
+        if (digitCount > 1) {
+          // 如果有多个相同数字，点击第二个
+          await this.page.locator('uni-view').filter({ hasText: new RegExp(`^${char}$`) }).nth(1).click();
+        } else {
+          await this.page.locator('uni-view').filter({ hasText: new RegExp(`^${char}$`) }).click();
+        }
+      }
+    }
+    
+    // 点击确定按钮
+    await this.page.getByText('确定').click();
+  }
+
+  /**
+   * 选择省市区
+   * @param province 省份（如：山西省）
+   * @param city 城市（如：长治市）
+   * @param district 区县（如：潞城区）
+   */
+  async selectRegion(province: string, city: string, district: string): Promise<void> {
+    // 点击省市区选择器 - nth-child(12)，开启赊欠额度后位置
+    await this.page.locator('uni-view:nth-child(12) > .nut-cell__value > .nut-form-item__body__slots > .input-wrapper > .flex-input > .nut-input > .nut-input__value > .nut-input__mask').click();
+    
+    // 等待弹窗出现
+    await this.page.waitForTimeout(500);
+    
+    // 选择省份
+    await this.page.getByText(province).click();
+    
+    // 选择城市
+    await this.page.getByText(city).click();
+    
+    // 选择区县
+    await this.page.getByText(district).click();
+    
+    // 确认选择
+    await this.page.getByText('确认选择').click();
+  }
+
+  /**
+   * 填写详细地址
+   * @param address 详细地址
+   */
+  async fillDetailedAddress(address: string): Promise<void> {
+    // 点击详细地址输入框 - nth-child(13)，开启赊欠额度后位置
+    await this.page.locator('uni-view:nth-child(13) > .nut-cell__value > .nut-form-item__body__slots > .nut-input > .nut-input__value > .nut-input__input > .uni-input-wrapper > .uni-input-input').click();
+    // 填写详细地址
+    await this.page.locator('uni-view:nth-child(13) > .nut-cell__value > .nut-form-item__body__slots > .nut-input > .nut-input__value > .nut-input__input > .uni-input-wrapper > .uni-input-input').fill(address);
+  }
+
+  /**
+   * 上传客户图片
+   * @param imagePath 图片文件路径（相对于项目根目录）
+   */
+  async uploadCustomerImage(imagePath: string): Promise<void> {
+    // 使用 Playwright 的 file_chooser 事件处理文件上传
+    // 监听文件选择器事件
+    const fileChooserPromise = this.page.waitForEvent('filechooser');
+    
+    // 点击上传按钮触发文件选择器
+    await this.page.locator('uni-scroll-view uni-button').click();
+    
+    // 等待文件选择器出现并设置文件
+    const fileChooser = await fileChooserPromise;
+    await fileChooser.setFiles(imagePath);
+    
+    // 等待上传完成
+    await this.page.waitForTimeout(1000);
+  }
+
+  /**
+   * 创建新客户 - 完整流程
+   * @param customerInfo 客户信息
+   * @param options 可选配置
+   */
+  async createCustomer(
+    customerInfo: {
+      name: string;
+      phone: string;
+      idCard: string;
+      detailedAddress?: string;
+    },
+    options?: {
+      creditLimit?: string;
+      licensePlate?: string;
+      province?: string;
+      city?: string;
+      district?: string;
+      imagePath?: string;
+    }
+  ): Promise<void> {
+    // 打开客户管理
+    await this.openCustomerManagement();
+    
+    // 点击新增客户
+    await this.clickAddCustomer();
+    
+    // 填写客户名称
+    await this.fillCustomerName(customerInfo.name);
+    
+    // 填写手机号
+    await this.fillPhone(customerInfo.phone);
+    
+    // 填写身份证
+    await this.fillIdCard(customerInfo.idCard);
+    
+    // 选择客户分组（默认第一个）
+    await this.selectCustomerGroup();
+    
+    // 如果有赊欠额度配置
+    if (options?.creditLimit) {
+      await this.enableCreditLimit();
+      await this.fillCreditLimit(options.creditLimit);
+    }
+    
+    // 如果有车牌号配置
+    if (options?.licensePlate) {
+      await this.fillLicensePlate(options.licensePlate);
+    }
+    
+    // 如果有省市区配置
+    if (options?.province && options?.city && options?.district) {
+      await this.selectRegion(options.province, options.city, options.district);
+    }
+    
+    // 如果有详细地址
+    if (customerInfo.detailedAddress) {
+      await this.fillDetailedAddress(customerInfo.detailedAddress);
+    }
+    
+    // 如果有图片上传
+    if (options?.imagePath) {
+      await this.uploadCustomerImage(options.imagePath);
+    }
+    
+    // 保存客户
+    await this.saveButton.click();
+    
+    // 等待保存完成
+    await this.page.waitForLoadState('networkidle', { timeout: 30000 });
+  }
+
+  /**
+   * 验证客户是否创建成功
+   * @param customerName 客户名称
+   */
+  async verifyCustomerCreated(customerName: string): Promise<boolean> {
+    try {
+      await this.page.waitForSelector(selectors.customerInList(customerName), { timeout: 10000 });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+}
 \ No newline at end of file
@@ -34,57 +34,8 @@ test.describe(&#39;代销入库&#39;, () =&gt; {
       );
       await consignmentPage.attachScreenshot(testInfo,'代销入库成功截图');
     })
-    // 使用页面对象创建代销入库
-    // await consignmentPage.createConsignmentOrder(
-    //   batchAlias,           // 批次别名
-    //   '娃娃菜',        // 商品名称
-    //   '10',                 // 数量
-    //   '1'                   // 费用金额
-    // );
+ 
   });
  
-  // test('新增代销入库 - 简化流程（无费用）', async ({ consignmentPage }) => {
-  //   // 生成唯一批次别名
-  //   const batchAlias = generateOtherName('代卖');
-  //   console.log('生成的批次别名:', batchAlias);
  
-  //   // 使用简化流程创建代销入库
-  //   await consignmentPage.createSimpleConsignmentOrder(
-  //     batchAlias,           // 批次别名
-  //     '娃娃菜'         // 商品名称
-  //   );
-
-  //   // 验证批次创建成功
-  //   await consignmentPage.expectBatchCreated(batchAlias);
-  // });
-
-  // test('新增代销入库 - 分步操作示例', async ({ consignmentPage }) => {
-  //   // 生成唯一批次别名
-  //   const batchAlias = generateOtherName('代卖');
-  //   console.log('生成的批次别名:', batchAlias);
-
-  //   // 导航到新增页面
-  //   await consignmentPage.navigateToNewConsignment();
-
-  //   // 选择仓库
-  //   await consignmentPage.selectWarehouse();
-  //   await consignmentPage.selectSecondWarehouse();
-
-  //   // 输入批次别名
-  //   await consignmentPage.enterBatchAlias(batchAlias);
-
-  //   // 选择商品并输入数量
-  //   await consignmentPage.selectProductWithQuantity('娃娃菜', '10');
-
-  //   // 添加费用
-  //   await consignmentPage.addExpense(0, '1');
-  //   await consignmentPage.selectPaymentMethod(0);
-
-  //   // 点击创建
-  //   await consignmentPage.clickCreate();
-  //   await consignmentPage.waitForCreationComplete();
-
-  //   // 验证
-  //   await consignmentPage.expectBatchCreated(batchAlias);
-  // });
 });
 \ No newline at end of file
+import { test, expect } from '../fixtures';
+import { generateCustomerName, generateIdCard, generatePhoneNumber, generateDetailedAddress, generateCustomerInfo, getRandomImage } from '../utils/dataGenerator';
+import * as allure from 'allure-js-commons';
+
+/**
+ * 客户管理测试
+ */
+test.describe('客户管理', () => {
+  // 使用已保存的认证状态
+  test.use({ storageState: 'auth.json' });
+
+  test('新增客户', async ({ customerPage }, testInfo) => {
+    // 添加allure元素
+    await allure.epic('客户管理');
+    await allure.feature('客户信息');
+    await allure.story('创建新客户');
+
+    // 步骤1：生成随机客户信息
+    const customerInfo = await allure.step('生成随机客户信息', async (step) => {
+      const name = generateCustomerName();
+      const phone = generatePhoneNumber();
+      const idCard = generateIdCard();
+      const detailedAddress = generateDetailedAddress();
+      
+      
+      console.log('生成的客户信息:', { name, phone, idCard, detailedAddress });
+      
+      return { name, phone, idCard, detailedAddress };
+    });
+
+    // 步骤2：执行新增客户操作
+    await allure.step('填写并提交客户表单', async () => {
+      await customerPage.gotoHome();
+      
+      // 从 test-data/img 目录随机选择一张图片
+      const randomImage = getRandomImage();
+      
+      await customerPage.createCustomer(
+        {
+          name: customerInfo.name,
+          phone: customerInfo.phone,
+          idCard: customerInfo.idCard,
+          detailedAddress: customerInfo.detailedAddress,
+        },
+        {
+          creditLimit: '500',
+          licensePlate: '渝ZY0706',
+          province: '江苏省',
+          city: '连云港市',
+          district: '海州区',
+          imagePath: randomImage || undefined, // 如果有图片则上传
+        }
+      );
+      await customerPage.attachScreenshot(testInfo, '新增客户成功截图');
+    });
+
+    // 步骤3：验证客户创建成功
+    await allure.step('验证客户创建成功', async () => {
+      const isCreated = await customerPage.verifyCustomerCreated(customerInfo.name);
+      expect(isCreated).toBeTruthy();
+    });
+  });
+
+//   test('新增客户 - 仅必填信息', async ({ customerPage }, testInfo) => {
+//     // 添加allure元素
+//     await allure.epic('客户管理');
+//     await allure.feature('客户信息');
+//     await allure.story('创建新客户（仅必填信息）');
+
+//     // 步骤1：生成随机客户信息
+//     const customerInfo = await allure.step('生成随机客户信息', async (step) => {
+//       const info = generateCustomerInfo();
+//       console.log('生成的客户信息:', info);
+//       return info;
+//     });
+
+//     // 步骤2：执行新增客户操作
+//     await allure.step('填写并提交客户表单（仅必填信息）', async () => {
+//       await customerPage.gotoHome();
+//       await customerPage.createCustomer({
+//         name: customerInfo.name,
+//         phone: customerInfo.phone,
+//         idCard: customerInfo.idCard,
+//       });
+//       await customerPage.attachScreenshot(testInfo, '新增客户成功截图');
+//     });
+
+//     // 步骤3：验证客户创建成功
+//     await allure.step('验证客户创建成功', async () => {
+//       const isCreated = await customerPage.verifyCustomerCreated(customerInfo.name);
+//       expect(isCreated).toBeTruthy();
+//     });
+//   });
+
+//   test('新增客户 - 带详细地址', async ({ customerPage }, testInfo) => {
+//     // 添加allure元素
+//     await allure.epic('客户管理');
+//     await allure.feature('客户信息');
+//     await allure.story('创建新客户（带详细地址）');
+
+//     // 步骤1：生成随机客户信息
+//     const customerInfo = await allure.step('生成随机客户信息', async (step) => {
+//       const name = generateCustomerName();
+//       const phone = generatePhoneNumber();
+//       const idCard = generateIdCard();
+//       const detailedAddress = generateDetailedAddress();
+      
+//       console.log('生成的客户信息:', { name, phone, idCard, detailedAddress });
+      
+//       return { name, phone, idCard, detailedAddress };
+//     });
+
+//     // 步骤2：执行新增客户操作
+//     await allure.step('填写并提交客户表单', async () => {
+//       await customerPage.gotoHome();
+//       await customerPage.createCustomer(
+//         {
+//           name: customerInfo.name,
+//           phone: customerInfo.phone,
+//           idCard: customerInfo.idCard,
+//         },
+//         {
+//           creditLimit: '10000',
+//         }
+//       );
+//       await customerPage.attachScreenshot(testInfo, '新增客户成功截图');
+//     });
+
+//     // 步骤3：验证客户创建成功
+//     await allure.step('验证客户创建成功', async () => {
+//       const isCreated = await customerPage.verifyCustomerCreated(customerInfo.name);
+//       expect(isCreated).toBeTruthy();
+//     });
+//   });
+});
 \ No newline at end of file
+import * as fs from 'fs';
+import * as path from 'path';
+
 //商品管理-随机商品名
 export function generateUniqueProductName(baseName: string = '测试商品'): string {
   // 使用时间戳，精确到毫秒，保证每次都不一样
@@ -14,4 +17,159 @@ export function generateOtherName(baseName: string = &#39;批次别名&#39;): string {
   // 再加一个随机数，防止同一毫秒内多次调用
 //   const random = Math.floor(Math.random() * 100);
   return `${baseName}${timestamp}`;
-}
 \ No newline at end of file
+}
+
+// 随机生成中文客户名称
+export function generateCustomerName(): string {
+  const familyNames = ['张', '王', '李', '刘', '陈', '杨', '黄', '赵', '周', '吴', '徐', '孙', '马', '朱', '胡', '郭', '何', '林', '罗', '高'];
+  const givenNames = ['伟', '芳', '娜', '敏', '静', '丽', '强', '磊', '军', '洋', '勇', '艳', '杰', '涛', '明', '超', '秀英', '华', '平', '刚', '桂英', '文', '志强', '建华', '建国', '建军', '晓明', '小红', '建军', '婷婷', '秀兰', '伟', '芳', '军', '勇', '艳', '杰', '娟', '涛', '明', '超', '秀英', '华'];
+  
+  const familyName = familyNames[Math.floor(Math.random() * familyNames.length)];
+  const givenName = givenNames[Math.floor(Math.random() * givenNames.length)];
+  
+  return familyName + givenName;
+}
+
+// 随机生成身份证号码（18位）
+export function generateIdCard(): string {
+  // 省份代码
+  const provinceCodes = ['11', '12', '13', '14', '15', '21', '22', '23', '31', '32', '33', '34', '35', '36', '37', '41', '42', '43', '44', '45', '46', '50', '51', '52', '53', '54', '61', '62', '63', '64', '65'];
+  
+  // 随机选择省份
+  const provinceCode = provinceCodes[Math.floor(Math.random() * provinceCodes.length)];
+  
+  // 随机生成城市和区县代码（各2位）
+  const cityCode = String(Math.floor(Math.random() * 99) + 1).padStart(2, '0');
+  const districtCode = String(Math.floor(Math.random() * 99) + 1).padStart(2, '0');
+  
+  // 随机生成出生日期（1950-01-01 到 2005-12-31）
+  const startYear = 1950;
+  const endYear = 2005;
+  const year = Math.floor(Math.random() * (endYear - startYear + 1)) + startYear;
+  const month = String(Math.floor(Math.random() * 12) + 1).padStart(2, '0');
+  const day = String(Math.floor(Math.random() * 28) + 1).padStart(2, '0');
+  const birthDate = `${year}${month}${day}`;
+  
+  // 随机生成顺序码（3位）
+  const sequenceCode = String(Math.floor(Math.random() * 999)).padStart(3, '0');
+  
+  // 前17位
+  const id17 = provinceCode + cityCode + districtCode + birthDate + sequenceCode;
+  
+  // 计算校验码
+  const weights = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];
+  const checkCodes = ['1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2'];
+  
+  let sum = 0;
+  for (let i = 0; i < 17; i++) {
+    sum += parseInt(id17[i]) * weights[i];
+  }
+  const checkCode = checkCodes[sum % 11];
+  
+  return id17 + checkCode;
+}
+
+// 隨机生成手机号码
+export function generatePhoneNumber(): string {
+  // 中国移动号段
+  const mobilePrefixes = ['134', '135', '136', '137', '138', '139', '147', '150', '151', '152', '157', '158', '159', '178', '182', '183', '184', '187', '188'];
+  // 中国联通号段
+  const unicomPrefixes = ['130', '131', '132', '145', '155', '156', '175', '176', '185', '186'];
+  // 中国电信号段
+  const telecomPrefixes = ['133', '149', '153', '177', '180', '181', '189'];
+  
+  const allPrefixes = [...mobilePrefixes, ...unicomPrefixes, ...telecomPrefixes];
+  
+  const prefix = allPrefixes[Math.floor(Math.random() * allPrefixes.length)];
+  const suffix = String(Math.floor(Math.random() * 100000000)).padStart(8, '0');
+  
+  return prefix + suffix;
+}
+
+// 随机生成详细地址（街道、门牌号等，不含省市区）
+export function generateDetailedAddress(): string {
+  const streets = ['中山路', '人民路', '建设路', '解放路', '和平路', '幸福路', '文化路', '科技路', '商业街', '繁华大道', '朝阳路', '胜利路', '长江路', '黄河路', '振兴路', '发展大道', '创业路', '创新路', '东风路', '西山路'];
+  const communities = ['阳光小区', '幸福花园', '和谐家园', '金色年华', '锦绣华庭', '碧水蓝天', '盛世华城', '锦绣江南', '紫荆花园', '翠竹苑', '莲花小区', '牡丹园', '玫瑰园', '百合苑', '茉莉花园'];
+  const buildings = ['1栋', '2栋', '3栋', '5栋', '6栋', '8栋', '9栋', '10栋', 'A座', 'B座', 'C座', 'D座'];
+  const units = ['1单元', '2单元', '3单元', '一单元', '二单元', '三单元'];
+  const floors = ['1楼', '2楼', '3楼', '5楼', '6楼', '8楼', '10楼', '12楼', '15楼', '18楼', '20楼'];
+  const rooms = ['101室', '201室', '301室', '401室', '501室', '601室', '701室', '801室', '1001室', '1101室', '1201室'];
+  
+  const street = streets[Math.floor(Math.random() * streets.length)];
+  const community = communities[Math.floor(Math.random() * communities.length)];
+  const building = buildings[Math.floor(Math.random() * buildings.length)];
+  const unit = units[Math.floor(Math.random() * units.length)];
+  const floor = floors[Math.floor(Math.random() * floors.length)];
+  const room = rooms[Math.floor(Math.random() * rooms.length)];
+  
+  // 随机组合地址格式
+  const formats = [
+    `${street}${Math.floor(Math.random() * 999) + 1}号`,
+    `${street}${Math.floor(Math.random() * 999) + 1}号${community}`,
+    `${community}${building}${unit}${room}`,
+    `${street}${Math.floor(Math.random() * 999) + 1}号${community}${building}${room}`,
+    `${street}${Math.floor(Math.random() * 999) + 1}号${floor}${room}`,
+    `${community}${building}${unit}${floor}${room}`
+  ];
+  
+  return formats[Math.floor(Math.random() * formats.length)];
+}
+
+// 生成完整的客户信息对象
+export function generateCustomerInfo(): {
+  name: string;
+  idCard: string;
+  phone: string;
+  detailedAddress: string;
+} {
+  return {
+    name: generateCustomerName(),
+    idCard: generateIdCard(),
+    phone: generatePhoneNumber(),
+    detailedAddress: generateDetailedAddress()
+  };
+}
+
+/**
+ * 从指定目录随机选择一张图片
+ * @param imageDir 图片目录路径，默认为 'test-data/img'
+ * @returns 随机选择的图片完整路径，如果目录不存在或没有图片则返回 null
+ */
+export function getRandomImage(imageDir: string = 'test-data/img'): string | null {
+  try {
+    // 获取项目根目录
+    const projectRoot = process.cwd();
+    const fullImagePath = path.join(projectRoot, imageDir);
+    
+    // 检查目录是否存在
+    if (!fs.existsSync(fullImagePath)) {
+      console.warn(`图片目录不存在: ${fullImagePath}`);
+      return null;
+    }
+    
+    // 读取目录中的所有文件
+    const files = fs.readdirSync(fullImagePath);
+    
+    // 过滤出图片文件（支持常见图片格式）
+    const imageExtensions = ['.jpg', '.jpeg', '.png', '.gif', '.bmp', '.webp'];
+    const imageFiles = files.filter(file => {
+      const ext = path.extname(file).toLowerCase();
+      return imageExtensions.includes(ext);
+    });
+    
+    if (imageFiles.length === 0) {
+      console.warn(`图片目录中没有图片文件: ${fullImagePath}`);
+      return null;
+    }
+    
+    // 随机选择一张图片
+    const randomIndex = Math.floor(Math.random() * imageFiles.length);
+    const selectedImage = imageFiles[randomIndex];
+    
+    // 返回相对于项目根目录的路径
+    return path.join(imageDir, selectedImage);
+  } catch (error) {
+    console.error('获取随机图片失败:', error);
+    return null;
+  }
+}