Merge branch 'xfbhlyx' into 'master'

Xfbhlyx 合并 See merge request !1

Merge branch 'xfbhlyx' into 'master'
Xfbhlyx 合并 See merge request !1
李玉霞
2 parents 486d0cf6 3e54b8e4
Showing 8 changed files with 1289 additions and 0 deletions
CLAUDE.md
fixtures/testFixture.ts
pages/supplierGroupingPage.ts
pages/supplierPage.ts
scripts/codegen-authenticated.ts
tests/supplier.spec.ts
tests/supplier_grouping.spec.ts
utils/dataGenerator.ts
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Playwright-based UI test automation framework for a business management system (supplier, customer, product, sales management). Uses page object pattern with Allure reporting.
+
+## Commands
+
+```bash
+npm install          # Install dependencies
+npm run test:ci      # Run tests in CI mode
+npm run report      # View Allure test reports
+npm run save-auth    # Save authentication state to auth.json
+```
+
+Run a single test file:
+```bash
+npx playwright test tests/customer.spec.ts
+```
+
+## Architecture
+
+### Fixture System
+
+Two parallel fixture systems exist in `fixtures/testFixture.ts`:
+
+1. **`test`** - Standard Playwright test with regular page
+2. **`fullTest`** - Uses `authenticatedPage` from `authFixture.ts` (pre-authenticated)
+
+Page objects are attached via `testFixture.ts`:
+```typescript
+const { fullTest } = require('./fixtures');
+fullTest('my test', async ({ customerPage, authenticatedPage }) => {
+  // customerPage is attached to authenticatedPage
+});
+```
+
+Tests using `fullTest` must also set `storageState: 'auth.json'`:
+```typescript
+test.use({ storageState: 'auth.json' });
+```
+
+### Page Object Pattern
+
+All page objects extend `BasePage` (`pages/basePage.ts`) which provides:
+- `navigate(path)` - Navigate using BASE_URL/#{path}
+- `click/fill/selectOptionByText` - Basic interactions
+- `waitForVisible/expectVisible/expectText` - Assertions
+- `takeScreenshot(name)` - Saves to `screenshots/` directory
+- `attachScreenshot(testInfo, name)` - Attaches to Allure report
+- `fillLicensePlate(plate)` - Handles custom license plate keyboard input
+- `uploadImage(path)` - Handles file upload dialogs
+- `selectRegion(province, city, district)` - Handles region picker dialogs
+
+### Test Organization
+
+- `tests/*.spec.ts` - Test specs
+- `pages/*.ts` - Page object classes
+- `fixtures/*.ts` - Test fixtures and authentication
+- `utils/dataGenerator.ts` - Test data generation utilities
+- `auth.json` - Saved authentication state (git-ignored)
+
+### Test Style
+
+Tests use Allure step reporting and screenshot attachments:
+```typescript
+await allure.step('Step description', async () => {
+  await customerPage.createCustomer(info);
+  await customerPage.attachScreenshot(testInfo, 'screenshot name');
+});
+```
+
+Serial execution is used per test file to avoid interference:
+```typescript
+test.describe.configure({ mode: 'serial' });
+```
+
+## Environment
+
+Configure in `.env` (copy from `.env.example` if exists):
+- `BASE_URL` - Application URL (e.g., `http://localhost:8080`)
+
+## Key Files
+
+- `playwright.config.ts` - Test configuration, reporters (Allure HTML)
+- `fixtures/authFixture.ts` - Authentication via storageState
+- `fixtures/testFixture.ts` - Page object fixtures and fullTest
+- `pages/basePage.ts` - Base class with common UI interaction methods
+- `utils/dataGenerator.ts` - Functions for generating test data (names, phones, IDs, etc.)
@@ -4,6 +4,8 @@ import { ProductPage } from &#39;../pages/productPage&#39;;
 import { SalePage } from '../pages/salePage';
 import { ConsignmentPage } from '../pages/consignmentPage';
 import { CustomerPage } from '../pages/customerPage';
+import { SupplierPage } from '../pages/supplierPage';
+import { SupplierGroupingPage } from '../pages/supplierGroupingPage';
 /**
  * 页面对象夹具类型定义
@@ -33,6 +35,16 @@ export type PageFixtures = {
    * 客户管理页面
    */
   customerPage: CustomerPage;
+  
+  /**
+   * 供应商管理页面
+   */
+  supplierPage: SupplierPage;
+
+  /**
+   * 供应商分组页面
+   */
+  supplierGroupingPage: SupplierGroupingPage;
 };
 /**
@@ -63,6 +75,16 @@ export const test = base.extend&lt;PageFixtures&gt;({
   customerPage: async ({ page }, use) => {
     await use(new CustomerPage(page));
   },
+  
+  // 供应商管理页面
+  supplierPage: async ({ page }, use) => {
+    await use(new SupplierPage(page));
+  },
+
+  // 供应商分组页面
+  supplierGroupingPage: async ({ page }, use) => {
+    await use(new SupplierGroupingPage(page));
+  },
 });
 /**
@@ -100,4 +122,12 @@ export const fullTest = authTest.extend&lt;PageFixtures&gt;({
     await use(new CustomerPage(authenticatedPage));
   },
+  supplierPage: async ({authenticatedPage }, use) => {
+    await use(new SupplierPage(authenticatedPage));
+  },
+
+  supplierGroupingPage: async ({authenticatedPage }, use) => {
+    await use(new SupplierGroupingPage(authenticatedPage));
+  },
+
   });
 \ No newline at end of file
+import { Page, Locator } from '@playwright/test';
+import { BasePage } from './basePage';
+
+/**
+ * 供应商分组选择器
+ */
+const selectors = {
+  // 导航
+  moreMenu: 'text=更多 >',
+  supplierGroupingMenu: 'text=供应商分组',
+  addButton: 'text=新建',
+
+  // 表单字段
+  groupNameInput: 'uni-input:filter([placeholder*="分组名称"]) input',
+  remarkInput: 'uni-input:filter([placeholder*="备注"]) input',
+
+  // 操作按钮
+  confirmButton: 'text=确定',
+  saveButton: 'text=确定',
+
+  // 供应商分组列表
+  supplierGroupingList: '.supplier-grouping-list',
+  supplierGroupingItem: '.supplier-grouping-list .item',
+};
+
+/**
+ * 供应商分组页面类
+ * 处理供应商分组相关操作
+ */
+export class SupplierGroupingPage extends BasePage {
+  // 导航定位器
+  readonly moreMenu!: Locator;
+  readonly supplierGroupingMenu: Locator;
+  readonly addButton: Locator;
+
+  // 表单字段
+  readonly groupNameInput: Locator;
+  readonly remarkInput: Locator;
+
+  // 操作按钮
+  readonly confirmButton: Locator;
+  readonly saveButton: Locator;
+
+  constructor(page: Page) {
+    super(page);
+
+    // 导航
+    this.moreMenu = page.getByText('更多 >');
+    this.supplierGroupingMenu = page.getByText('供应商分组').first();
+    this.addButton = page.getByText('新建');
+
+    // 表单字段
+    this.groupNameInput = page.locator('uni-input').filter({ hasText: '请输入分组名称' }).getByRole('textbox');
+    this.remarkInput = page.locator('uni-input').filter({ hasText: '请输入备注' }).getByRole('textbox');
+
+    // 操作按钮
+    this.confirmButton = page.getByText('确定');
+    this.saveButton = page.getByText('确定');
+  }
+
+  /**
+   * 打开更多菜单
+   */
+  async openMoreMenu(): Promise<void> {
+    await this.moreMenu.click();
+    await this.wait(500);
+  }
+
+  /**
+   * 打开供应商分组页面
+   */
+  async openSupplierGrouping(): Promise<void> {
+    await this.supplierGroupingMenu.click({ force: true });
+    await this.waitForPageLoad();
+    await this.wait(500);
+  }
+
+  /**
+   * 点击新建分组按钮
+   */
+  async clickAddButton(): Promise<void> {
+    await this.addButton.click();
+    await this.waitForPageLoad();
+  }
+
+  /**
+   * 填写分组名称
+   * @param name 分组名称
+   */
+  async fillGroupName(name: string): Promise<void> {
+    await this.groupNameInput.click();
+    await this.groupNameInput.fill(name);
+  }
+
+  /**
+   * 填写备注
+   * @param remark 备注内容
+   */
+  async fillRemark(remark: string): Promise<void> {
+    await this.remarkInput.click();
+    await this.remarkInput.fill(remark);
+  }
+
+  /**
+   * 保存分组
+   */
+  async saveGrouping(): Promise<void> {
+    await this.saveButton.click();
+    await this.waitForPageLoad();
+    await this.wait(500);
+  }
+
+  /**
+   * 搜索分组
+   * @param groupName 分组名称
+   */
+  async searchGrouping(groupName: string): Promise<void> {
+    await this.page.getByRole('textbox').click();
+    await this.wait(300);
+    await this.page.getByRole('textbox').fill(groupName);
+    await this.wait(1500);
+    await this.page.getByRole('textbox').press('Enter');
+    await this.wait(1000);
+  }
+
+  /**
+   * 验证分组是否创建成功
+   * @param groupName 分组名称
+   */
+  async verifyGroupingCreated(groupName: string): Promise<boolean> {
+    try {
+      await this.navigateToSupplierGrouping();
+      await this.searchGrouping(groupName);
+      await this.page.waitForSelector(`uni-view:has-text("${groupName}")`, { timeout: 10000 });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * 进入供应商分组页面（完整流程）
+   */
+  async navigateToSupplierGrouping(): Promise<void> {
+    await this.navigate('/');
+    await this.openMoreMenu();
+    await this.openSupplierGrouping();
+  }
+
+  /**
+   * 点击编辑分组按钮
+   */
+  async clickEditButton(): Promise<void> {
+    await this.page.getByText('编辑').click();
+    await this.waitForPageLoad();
+  }
+
+  /**
+   * 修改分组
+   * @param groupName 新的分组名称
+   * @param remark 新的备注
+   */
+  async updateGrouping(groupName: string, remark: string): Promise<void> {
+    await this.fillGroupName(groupName);
+    await this.fillRemark(remark);
+    await this.saveGrouping();
+  }
+
+  /**
+   * 验证分组是否修改成功
+   * @param groupName 分组名称
+   */
+  async verifyGroupingUpdated(groupName: string): Promise<boolean> {
+    try {
+      await this.navigateToSupplierGrouping();
+      await this.searchGrouping(groupName);
+      await this.page.waitForSelector(`uni-view:has-text("${groupName}")`, { timeout: 10000 });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * 点击删除分组按钮
+   */
+  async clickDeleteButton(): Promise<void> {
+    await this.page.getByText('删除', { exact: true }).click();
+  }
+
+  /**
+   * 点击分组项
+   * @param groupName 分组名称
+   */
+  async clickGroupingItem(groupName: string): Promise<void> {
+    await this.page.locator('uni-view').filter({ hasText: new RegExp(`^${groupName}$`) }).first().click();
+    await this.waitForPageLoad();
+  }
+
+  /**
+   * 确认删除分组
+   */
+  async confirmDelete(): Promise<void> {
+    await this.page.getByText('确定', { exact: true }).click();
+    await this.waitForPageLoad();
+    await this.wait(500);
+  }
+
+  /**
+   * 验证分组是否删除成功
+   * @param groupName 分组名称
+   */
+  async verifyGroupingDeleted(groupName: string): Promise<boolean> {
+    try {
+      await this.navigateToSupplierGrouping();
+      await this.searchGrouping(groupName);
+      // 删除成功后，列表会显示"没有数据哦~"
+      await this.page.waitForSelector(`uni-view:has-text("No data")`, { timeout: 10000 });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+}
+import { Page, Locator, expect } from '@playwright/test';
+import { BasePage } from './basePage';
+import { generateSupplierName, generatePhoneNumber, generateChineseName } from '../utils/dataGenerator';
+
+/**
+ * 供应商信息接口
+ */
+export interface SupplierInfo {
+  name: string;
+  managerName: string;
+  phone: string;
+  remark?: string;
+}
+
+/**
+ * 供应商选项接口
+ */
+export interface SupplierOptions {
+  enableParkCard?: boolean;
+  parkCardNumber?: string;
+  parkCardChannel?: string;
+}
+
+/**
+ * 供应商管理页面选择器
+ */
+const selectors = {
+  // 导航
+  moreMenu: 'text=更多 >',
+  supplierMenu: 'text=供应商管理',
+  addSupplierButton: 'text=新建供应商',
+  
+  // 表单字段
+  supplierNameInput: 'uni-input:has-text("请输入供应商名称") input',
+  managerNameInput: 'uni-input:has-text("请输入负责人名称") input',
+  phoneInput: 'spinbutton',
+  
+  // 供应商分组选择器
+  groupPicker: '.nut-input__mask',
+  groupOption: 'text=普通供应商',
+  
+  // 备注
+  remarkInput: 'uni-input:has-text("请输入备注") input',
+  
+  // 园区卡
+  parkCardSearchInput: 'uni-view:nth-child(2) > .nut-searchbar__search-input',
+  queryButton: 'text=查询',
+  bindButton: 'uni-button',
+  
+  // 操作按钮
+  confirmButton: 'text=确定',
+  saveButton: 'text=确定',
+  
+  // 供应商列表
+  supplierList: '.supplier-list',
+  supplierItem: '.supplier-list .item',
+  supplierItemClick: '.supplier-list .item-click',
+};
+
+/**
+ * 供应商管理页面类
+ * 处理供应商管理相关操作
+ */
+export class SupplierPage extends BasePage {
+  // 导航定位器
+  readonly moreMenu!: Locator;
+  readonly supplierMenu: Locator;
+  readonly addSupplierButton: Locator;
+  
+  // 表单字段
+  readonly supplierNameInput: Locator;
+  readonly managerNameInput: Locator;
+  readonly phoneInput: Locator;
+  
+  // 供应商分组
+  readonly groupPicker: Locator;
+  readonly groupOption: Locator;
+  
+  // 备注
+  readonly remarkInput: Locator;
+  
+  // 园区卡
+  readonly parkCardSearchInput: Locator;
+  readonly queryButton: Locator;
+  readonly bindButton: Locator;
+  
+  // 操作按钮
+  readonly confirmButton: Locator;
+  readonly saveButton: Locator;
+
+  constructor(page: Page) {
+    super(page);
+    
+    // 导航
+    this.moreMenu = page.getByText('更多 >');
+    this.supplierMenu = page.getByText('供应商管理').first();
+    this.addSupplierButton = page.getByText('新建供应商');
+    
+    // 表单字段
+    this.supplierNameInput = page.locator('uni-input').filter({ hasText: '请输入供应商名称' }).getByRole('textbox');
+    this.managerNameInput = page.locator('uni-input').filter({ hasText: '请输入负责人名称' }).getByRole('textbox');
+    this.phoneInput = page.getByRole('spinbutton');
+    this.remarkInput = page.locator('uni-input').filter({ hasText: '请输入备注' }).getByRole('textbox');
+    
+    // 供应商分组
+    this.groupPicker = page.locator('.nut-input__mask').first();
+    this.groupOption = page.locator('.select-item');
+    
+    // 园区卡
+    this.parkCardSearchInput = page.locator('uni-view:nth-child(2) > .nut-searchbar__search-input > .nut-searchbar__input-inner > .nut-searchbar__input-form > span > .nut-searchbar__input-bar > .uni-input-wrapper > .uni-input-input');
+    this.queryButton = page.getByText('查询', { exact: true });
+    this.bindButton = page.locator('uni-button').filter({ hasText: '绑定' });
+    
+    // 操作按钮
+    this.confirmButton = page.getByText('确定');
+    this.saveButton = page.getByText('确定');
+  }
+
+  /**
+   * 导航到首页并等待加载
+   */
+  async gotoHome(): Promise<void> {
+    await this.navigate('/');
+    await this.waitForPageLoad();
+  }
+
+  /**
+   * 打开更多菜单
+   */
+  async openMoreMenu(): Promise<void> {
+    await this.moreMenu.click();
+    await this.wait(500);
+  }
+
+  /**
+   * 打开供应商管理页面
+   */
+  async openSupplierManagement(): Promise<void> {
+    await this.supplierMenu.click({ force: true });
+    await this.waitForPageLoad();
+    await this.wait(500);
+  }
+
+  /**
+   * 点击新建供应商按钮
+   */
+  async clickAddSupplier(): Promise<void> {
+    await this.addSupplierButton.click();
+    await this.waitForPageLoad();
+  }
+
+  /**
+   * 点击编辑按钮
+   */
+  async clickEditButton(): Promise<void> {
+    await this.page.getByText('编辑').click();
+    await this.waitForPageLoad();
+  }
+
+  /**
+   * 点击确定/保存按钮
+   */
+  async clickConfirmButton(): Promise<void> {
+    await this.confirmButton.click();
+    await this.waitForPageLoad();
+  }
+
+  /**
+   * 填写表单字段（通用方法）
+   * @param locator 表单字段定位器
+   * @param value 填写值
+   */
+  async fillFormField(locator: Locator, value: string): Promise<void> {
+    await locator.click();
+    await locator.fill(value);
+  }
+
+  /**
+   * 清除并填写表单字段（通用方法）
+   * @param locator 表单字段定位器
+   * @param value 填写值
+   */
+  async clearAndFillFormField(locator: Locator, value: string): Promise<void> {
+    await locator.click();
+    await locator.fill('');
+    await locator.fill(value);
+  }
+
+  /**
+   * 点击选择器弹窗（通用方法，用于供应商分组、园区卡等）
+   * @param index 选择器索引（0=第一个，1=第二个）
+   */
+  async clickPickerSelector(index: number = 0): Promise<void> {
+    await this.page.locator('.nut-form-item__body__slots .nut-input__mask').nth(index).click();
+    await this.wait(500);
+  }
+
+  /**
+   * 选择供应商类型（必选字段）
+   * @param type 供应商类型（默认"代卖"）
+   */
+  async selectSupplierType(type: string = '代卖'): Promise<void> {
+    await this.page.locator('.nut-form-item__body__slots > .nut-checkbox-group > uni-view').first().click();
+    await this.wait(500);
+  }
+
+  /**
+   * 选择供应商分组
+   */
+  async selectGroup(): Promise<void> {
+    await this.groupPicker.first().click();
+    await this.wait(500);
+    await this.groupOption.click();
+    await this.wait(500);
+  }
+
+  /**
+   * 选择园区卡渠道
+   * @param channel 渠道名称
+   */
+  async selectParkCardChannel(channel: string = '地利'): Promise<void> {
+    await this.page.locator('uni-view').filter({ hasText: new RegExp(`^${channel}$`) }).first().click();
+    await this.wait(500);
+  }
+
+  /**
+   * 搜索园区卡
+   * @param cardNumber 园区卡号
+   */
+  async searchParkCard(cardNumber: string): Promise<void> {
+    await this.parkCardSearchInput.click();
+    await this.parkCardSearchInput.fill(cardNumber);
+    await this.queryButton.click();
+    await this.wait(500);
+  }
+
+  /**
+   * 绑定园区卡
+   */
+  async bindParkCard(): Promise<void> {
+    await this.bindButton.click();
+    await this.waitForPageLoad();
+    await this.wait(500);
+  }
+
+  /**
+   * 选择园区卡（完整流程）
+   * @param cardNumber 园区卡号
+   * @param channel 渠道名称（可选）
+   */
+  async selectParkCard(cardNumber: string, channel?: string): Promise<void> {
+    // 点击园区卡输入框（第二个，因为第一个是供应商分组）
+    await this.clickPickerSelector(1);
+    
+    // 选择渠道（如果指定）
+    if (channel) {
+      await this.selectParkCardChannel(channel);
+    }
+    
+    // 搜索并绑定
+    await this.searchParkCard(cardNumber);
+    await this.bindParkCard();
+  }
+
+  /**
+   * 点击供应商列表项
+   * @param index 列表索引（0=第一个.item，1=第二个.item）
+   */
+  async clickSupplierItemByIndex(index: number = 0): Promise<void> {
+    await this.page.locator(selectors.supplierItem).nth(index).click();
+  }
+
+  /**
+   * 搜索供应商
+   * @param supplierName 供应商名称
+   */
+  async searchSupplier(supplierName: string): Promise<void> {
+    await this.page.getByRole('textbox').click();
+    const input = this.page.locator('uni-input').filter({ hasText: '供应商名称/联系电话' }).getByRole('textbox');
+    await input.fill(supplierName);
+    await this.page.waitForTimeout(1500);
+    await input.press('Enter');
+    await this.page.waitForTimeout(1000);
+  }
+
+  /**
+   * 进入供应商管理页面（完整流程）
+   */
+  async navigateToSupplierManagement(): Promise<void> {
+    await this.gotoHome();
+    await this.openMoreMenu();
+    await this.openSupplierManagement();
+  }
+
+  /**
+   * 验证供应商是否创建成功
+   * @param supplierName 供应商名称
+   */
+  async verifySupplierCreated(supplierName: string): Promise<boolean> {
+    try {
+      await this.navigateToSupplierManagement();
+      await this.searchSupplier(supplierName);
+      await this.page.waitForSelector(`uni-view:has-text("${supplierName}")`, { timeout: 10000 });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * 点击删除按钮
+   */
+  async clickDeleteButton(): Promise<void> {
+    await this.page.getByText('删除').click();
+  }
+
+  /**
+   * 确认删除
+   */
+  async confirmDelete(): Promise<void> {
+    await this.page.getByText('确定', { exact: true }).click();
+  }
+
+  /**
+   * 点击录入欠款按钮
+   */
+  async clickRecordDebt(): Promise<void> {
+    await this.page.getByText('录入欠款').click();
+  }
+
+  /**
+   * 点击返回按钮
+   */
+  async clickBackButton(): Promise<void> {
+    await this.page.locator('.uni-icons.uniui-left').click();
+    await this.wait(300);
+  }
+
+  /**
+   * 选择欠款方向
+   * @param direction 欠款方向（'我方欠供应商' 或 '供应商欠我方'）
+   */
+  async selectDebtDirection(direction: 'oweSupplier' | 'supplierOwe'): Promise<void> {
+    const text = direction === 'oweSupplier' ? '我方欠供应商' : '供应商欠我方';
+    await this.page.getByText(text, { exact: true }).click();
+  }
+
+  /**
+   * 选择赊欠日期
+   * @param day 日期（1-31），不传则选择今日
+   */
+  async selectDebtDate(day?: number): Promise<void> {
+    await this.page.getByText('赊欠日期*请选择赊欠日期').click();
+    await this.wait(300);
+
+    if (day) {
+      await this.page.getByText(`${day}日`).click();
+    } else {
+      const today = new Date().getDate();
+      await this.page.getByText(`${today}today`).click();
+    }
+    await this.wait(300);
+  }
+
+  /**
+   * 填写赊欠金额
+   * @param amount 金额
+   */
+  async fillDebtAmount(amount: string): Promise<void> {
+    const amountMask = this.page.locator('uni-view:nth-child(6) > .nut-cell__value > .nut-form-item__body__slots > .nut-input > .nut-input__value > .nut-input__mask');
+    await amountMask.click();
+    await this.wait(300);
+
+    await this.page.getByText('1', { exact: true }).click();
+    await this.page.getByText('0', { exact: true }).nth(0).click();
+    await this.page.getByText('0', { exact: true }).nth(0).click();
+    await this.page.getByText('完成').click();
+  }
+
+  /**
+   * 填写备注
+   * @param remark 备注内容
+   */
+  async fillRemark(remark: string): Promise<void> {
+    const remarkInput = this.page.locator('uni-view:nth-child(7) > .nut-cell__value > .nut-form-item__body__slots > .nut-input > .nut-input__value > .nut-input__input > .uni-input-wrapper > .uni-input-input');
+    await remarkInput.click();
+    await remarkInput.fill(remark);
+  }
+
+  /**
+   * 上传欠款凭证
+   * @param imagePath 图片路径
+   */
+  async uploadDebtVoucher(imagePath: string): Promise<void> {
+    await this.page.locator('body').setInputFiles(imagePath);
+  }
+
+  /**
+   * 保存欠款记录
+   */
+  async saveDebt(): Promise<void> {
+    await this.page.getByText('保存').click();
+    await this.waitForPageLoad();
+  }
+
+  /**
+   * 获取供应商名称（从详情页）
+   */
+  async getSupplierName(): Promise<string> {
+    // 供应商名称通常显示在页面顶部，可能是 "供应商名称" 标签后面
+    const nameElement = this.page.locator('uni-view').filter({ hasText: /^供应商名称/ }).locator('..').locator('uni-view').last();
+    const name = await nameElement.textContent();
+    return name || '';
+  }
+
+  /**
+   * 获取应付金额
+   * @returns 应付金额字符串，如 '¥ 221300.01'
+   */
+  async getPayableAmount(): Promise<string> {
+    const amountText = await this.page.getByText(/应付 ¥/).textContent();
+    return amountText || '';
+  }
+
+  /**
+   * 解析应付金额为数字
+   * @returns 应付金额数值
+   */
+  async parsePayableAmount(): Promise<number> {
+    const amountText = await this.getPayableAmount();
+    const match = amountText.match(/¥ ?([\d.]+)/);
+    return match ? parseFloat(match[1]) : 0;
+  }
+
+  /**
+   * 验证欠款录入成功（检查应付金额是否增加）
+   * @param originalAmount 原始应付金额
+   * @param addedAmount 新增金额
+   * @returns 是否验证成功
+   */
+  async verifyDebtRecorded(originalAmount: number, addedAmount: number): Promise<boolean> {
+    try {
+      const currentAmount = await this.parsePayableAmount();
+      // 允许小幅误差（由于金额格式或四舍五入）
+      const expectedAmount = originalAmount + addedAmount;
+      return Math.abs(currentAmount - expectedAmount) < 0.01;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * 点击供应商的金额显示区域
+   * @param index 供应商索引
+   */
+  async clickSupplierAmount(index: number): Promise<void> {
+    await this.page.getByText('¥').nth(index).click();
+  }
+
+  /**
+   * 获取供应商列表中所有供应商的金额信息
+   * @returns 金额数组
+   */
+  async getSupplierAmounts(): Promise<number[]> {
+    const yuanElements = await this.page.getByText('¥').all();
+    const amounts: number[] = [];
+
+    for (const element of yuanElements) {
+      const text = await element.textContent();
+      const match = text?.match(/¥(\d+)/);
+      if (match) {
+        amounts.push(parseInt(match[1], 10));
+      }
+    }
+
+    return amounts;
+  }
+
+  /**
+   * 查找符合条件的供应商（所有金额都是0）
+   * @returns 是否找到符合条件的供应商
+   */
+  async clickSupplierWithZeroAmounts(): Promise<boolean> {
+    // 获取所有供应商项
+    const supplierItems = await this.page.locator(selectors.supplierItem).all();
+
+    for (let i = 0; i < supplierItems.length; i++) {
+      // 点击供应商列表项
+      await this.clickSupplierItemByIndex(i);
+      await this.wait(300);
+
+      // 获取所有金额文本，检查是否都为'¥ 0'
+      const yuanTexts = await this.page.locator('text=¥').allTextContents();
+
+      // 检查所有金额是否都是'¥ 0'
+      const allZero = yuanTexts.every(text => {
+        const trimmed = text.trim();
+        return trimmed === '¥ 0.00' || trimmed === '¥0.00';
+      });
+
+      // 如果全为0，返回true（保持在当前页面继续删除流程）
+      if (allZero && yuanTexts.length > 0) {
+        return true;
+      }
+
+      // 如果不全为0，继续尝试下一个供应商（不返回页面，直接点击下一个）
+    }
+
+    return false;
+  }
+
+  /**
+   * 生成随机供应商信息
+   * @param options 可选配置
+   */
+  async generateRandomSupplierInfo(options?: {
+    namePrefix?: string;
+    managerName?: string;
+  }): Promise<SupplierInfo> {
+    const timestamp = Date.now().toString().slice(-6);
+
+    const name = options?.namePrefix
+      ? `${options.namePrefix}_${timestamp}`
+      : generateSupplierName();
+
+    const managerName = options?.managerName || generateChineseName();
+
+    return {
+      name,
+      managerName,
+      phone: generatePhoneNumber(),
+      remark: `自动化测试_${timestamp}`,
+    };
+  }
+
+
+}
+/**
+ * 启动已认证的 Playwright Codegen
+ * 
+ * 使用方式：
+ * 1. 先确保 auth.json 已存在（运行 npx playwright test login.setup.ts）
+ * 2. 然后运行：npx ts-node scripts/codegen-authenticated.ts
+ * 
+ * 或者直接使用命令：
+ * npx playwright codegen --storage-state=auth.json $BASE_URL
+ */
+
+import { spawn } from 'child_process';
+import path from 'path';
+import fs from 'fs';
+import dotenv from 'dotenv';
+
+// 加载环境变量
+dotenv.config({ path: path.resolve(__dirname, '../.env') });
+
+const authFile = path.join(process.cwd(), 'auth.json');
+const baseUrl = process.env.BASE_URL || 'http://localhost:8080';
+
+console.log('='.repeat(50));
+console.log('启动已认证的 Playwright Codegen');
+console.log('='.repeat(50));
+console.log(`认证文件: ${authFile}`);
+console.log(`目标地址: ${baseUrl}`);
+console.log('');
+
+// 检查 auth.json 是否存在
+if (!fs.existsSync(authFile)) {
+  console.error('错误: auth.json 文件不存在！');
+  console.error('请先运行以下命令生成认证文件:');
+  console.error('  npx playwright test login.setup.ts');
+  console.log('');
+  console.error('如果环境变量未设置，还需要设置:');
+  console.error('  BASE_URL - 目标网站地址');
+  console.error('  TEST_USER_NAME - 登录后显示的用户名（用于验证登录成功）');
+  process.exit(1);
+}
+
+console.log('✓ auth.json 文件存在');
+console.log('');
+
+// 启动 codegen
+console.log('正在启动 Codegen...');
+console.log('');
+
+const isWindows = process.platform === 'win32';
+
+// Playwright codegen 使用 --load-storage 来加载已保存的认证状态
+const loadStorageArg = isWindows ? `--load-storage ${authFile}` : `--load-storage=${authFile}`;
+
+const codegen = spawn(
+  'npx',
+  ['playwright', 'codegen', loadStorageArg, baseUrl],
+  {
+    stdio: 'inherit',
+    shell: true,
+    cwd: process.cwd()
+  }
+);
+
+codegen.on('close', (code) => {
+  if (code !== 0) {
+    console.error(`Codegen 退出，代码: ${code}`);
+  }
+  process.exit(code ?? 0);
+});
+
+codegen.on('error', (err) => {
+  console.error('启动 Codegen 失败:', err);
+  process.exit(1);
+});
+
+// 处理 Ctrl+C
+process.on('SIGINT', () => {
+  console.log('\n正在关闭 Codegen...');
+  codegen.kill('SIGINT');
+});
+import { test, expect } from '../fixtures';
+import * as allure from 'allure-js-commons';
+
+/**
+ * 供应商管理测试
+ */
+test.describe('供应商管理', () => {
+  // 使用已保存的认证状态
+  test.use({ storageState: 'auth.json' });
+
+  // 强制测试串行执行，避免并行测试之间的干扰
+  test.describe.configure({ mode: 'serial' });
+
+  test('新建供应商并绑定园区卡', async ({ supplierPage }, testInfo) => {
+    await allure.epic('供应商管理');
+    await allure.feature('供应商信息');
+    await allure.story('新建供应商');
+
+    // 步骤1：生成随机供应商信息
+    const supplierInfo = await allure.step('生成随机供应商信息', async () => {
+      const info = await supplierPage.generateRandomSupplierInfo();
+
+      console.log('供应商名称:', info.name);
+      console.log('负责人:', info.managerName);
+      console.log('手机号:', info.phone);
+      console.log('备注:', info.remark);
+
+      return info;
+    });
+
+    // 步骤2：填写并提交供应商表单
+    await allure.step('填写并提交供应商表单', async () => {
+      await supplierPage.navigateToSupplierManagement();
+      await supplierPage.clickAddSupplier();
+      await supplierPage.fillFormField(supplierPage.supplierNameInput, supplierInfo.name);
+      await supplierPage.selectGroup();
+      await supplierPage.fillFormField(supplierPage.managerNameInput, supplierInfo.managerName);
+      await supplierPage.fillFormField(supplierPage.phoneInput, supplierInfo.phone);
+      await supplierPage.selectParkCard('888810046477', '地利');
+      await supplierPage.fillFormField(supplierPage.remarkInput, supplierInfo.remark || '');
+      await supplierPage.saveButton.click();
+      await supplierPage.attachScreenshot(testInfo, '新建供应商成功截图');
+    });
+
+    // 步骤3：验证供应商创建成功
+    await allure.step('验证供应商创建成功', async () => {
+      const isCreated = await supplierPage.verifySupplierCreated(supplierInfo.name);
+      expect(isCreated).toBeTruthy();
+    });
+  });
+
+  test('编辑供应商并绑定园区卡', async ({ supplierPage }, testInfo) => {
+    await allure.epic('供应商管理');
+    await allure.feature('供应商信息');
+    await allure.story('编辑供应商');
+
+    // 步骤1：生成新的供应商信息
+    const supplierInfo = await allure.step('生成新的供应商信息', async () => {
+      const namePrefixes = ['修改', '更新', '调整', '变更'];
+      const namePrefix = namePrefixes[Math.floor(Math.random() * namePrefixes.length)];
+      const info = await supplierPage.generateRandomSupplierInfo({
+        namePrefix: namePrefix,
+      });
+
+      console.log('新供应商名称:', info.name);
+      console.log('新负责人:', info.managerName);
+      console.log('新手机号:', info.phone);
+      console.log('新备注:', info.remark);
+
+      return info;
+    });
+
+    // 步骤2：填写并提交供应商表单
+    await allure.step('填写并提交供应商表单', async () => {
+      await supplierPage.navigateToSupplierManagement();
+      await supplierPage.clickSupplierItemByIndex(0);
+      await supplierPage.clickEditButton();
+      await supplierPage.clearAndFillFormField(supplierPage.supplierNameInput, supplierInfo.name);
+      await supplierPage.clearAndFillFormField(supplierPage.managerNameInput, supplierInfo.managerName);
+      await supplierPage.clearAndFillFormField(supplierPage.phoneInput, supplierInfo.phone);
+      await supplierPage.selectSupplierType();
+      await supplierPage.selectParkCard('888800010617');
+      await supplierPage.clearAndFillFormField(supplierPage.remarkInput, supplierInfo.remark || '');
+      await supplierPage.clickConfirmButton();
+      await supplierPage.attachScreenshot(testInfo, '编辑供应商成功截图');
+    });
+
+    // 步骤3：验证供应商修改成功
+    await allure.step('验证供应商修改成功', async () => {
+      const isUpdated = await supplierPage.verifySupplierCreated(supplierInfo.name);
+      expect(isUpdated).toBeTruthy();
+    });
+  });
+
+  test('删除供应商（金额都为0）', async ({ supplierPage }, testInfo) => {
+    await allure.epic('供应商管理');
+    await allure.feature('供应商信息');
+    await allure.story('删除供应商');
+
+    // 步骤1：进入供应商管理页面
+    await allure.step('进入供应商管理页面', async () => {
+      await supplierPage.navigateToSupplierManagement();
+    });
+
+    // 步骤2：查找并点击金额都为0的供应商
+    await allure.step('查找并点击金额都为0的供应商', async () => {
+      const found = await supplierPage.clickSupplierWithZeroAmounts();
+      expect(found).toBeTruthy();
+    });
+
+    // 步骤3：点击删除按钮
+    await allure.step('点击删除按钮', async () => {
+      await supplierPage.clickDeleteButton();
+    });
+
+    // 步骤4：确认删除
+    await allure.step('确认删除', async () => {
+      await supplierPage.confirmDelete();
+      await supplierPage.attachScreenshot(testInfo, '删除供应商成功截图');
+    });
+  });
+
+  test('录入欠款并验证应付金额增加', async ({ supplierPage }, testInfo) => {
+    await allure.epic('供应商管理');
+    await allure.feature('供应商信息');
+    await allure.story('录入欠款');
+
+    // 录入的欠款金额
+    const debtAmount = '100';
+    const remark = '测试录入欠款';
+
+    // 步骤1：进入供应商管理页面并选择第2个供应商，记录原始应付金额和供应商名称
+    let supplierName = '';
+    const originalAmount = await allure.step('记录原始应付金额', async () => {
+      await supplierPage.navigateToSupplierManagement();
+      await supplierPage.clickSupplierItemByIndex(1);
+      await supplierPage.waitForPageLoad();
+      await supplierPage.wait(300);
+      supplierName = await supplierPage.getSupplierName();
+      return await supplierPage.parsePayableAmount();
+    });
+    console.log('录入前应付金额:', originalAmount);
+
+    // 步骤2：点击录入欠款
+    await allure.step('点击录入欠款', async () => {
+      await supplierPage.clickRecordDebt();
+    });
+
+    // 步骤3：选择欠款方向（我方欠供应商）
+    await allure.step('选择欠款方向', async () => {
+      await supplierPage.selectDebtDirection('oweSupplier');
+    });
+
+    // 步骤4：选择赊欠日期（今日）
+    await allure.step('选择赊欠日期', async () => {
+      await supplierPage.selectDebtDate();
+    });
+
+    // 步骤5：填写赊欠金额
+    await allure.step('填写赊欠金额', async () => {
+      await supplierPage.fillDebtAmount(debtAmount);
+    });
+
+    // 步骤6：填写备注
+    await allure.step('填写备注', async () => {
+      await supplierPage.fillRemark(remark);
+    });
+
+    // 步骤7：保存欠款记录
+    await allure.step('保存欠款记录', async () => {
+      await supplierPage.saveDebt();
+    });
+
+    // 步骤8：验证欠款录入成功 - 搜索同一供应商查看应付金额
+    const currentAmount = await allure.step('验证欠款录入成功', async () => {
+      await supplierPage.navigateToSupplierManagement();
+      await supplierPage.clickSupplierItemByIndex(1);
+      await supplierPage.page.waitForLoadState('networkidle');
+      await supplierPage.page.waitForTimeout(300);
+      const amount = await supplierPage.parsePayableAmount();
+      console.log('录入后应付金额:', amount);
+      return amount;
+    });
+
+    // 验证应付金额增加了录入的金额
+    expect(currentAmount).toBeCloseTo(originalAmount + parseFloat(debtAmount), 1);
+
+    await supplierPage.attachScreenshot(testInfo, '录入欠款成功截图');
+  });
+});
+import { test, expect } from '../fixtures';
+import * as allure from 'allure-js-commons';
+
+/**
+ * 供应商分组管理测试
+ */
+test.describe('供应商分组管理', () => {
+  // 使用已保存的认证状态
+  test.use({ storageState: 'auth.json' });
+
+  // 强制测试串行执行，避免并行测试之间的干扰
+  test.describe.configure({ mode: 'serial' });
+
+  test('新增供应商分组', async ({ supplierGroupingPage }, testInfo) => {
+    await allure.epic('供应商管理');
+    await allure.feature('供应商分组');
+    await allure.story('新增供应商分组');
+
+    // 步骤1：生成随机分组信息
+    const groupName = `自动${Date.now().toString().slice(-3)}`;
+    const remark = '自动化测试';
+
+    // 步骤2：进入供应商分组页面并点击新建
+    await allure.step('进入供应商分组页面', async () => {
+      await supplierGroupingPage.navigateToSupplierGrouping();
+      await supplierGroupingPage.clickAddButton();
+    });
+
+    // 步骤3：填写分组信息
+    await allure.step('填写分组信息', async () => {
+      await supplierGroupingPage.fillGroupName(groupName);
+      await supplierGroupingPage.fillRemark(remark);
+    });
+
+    // 步骤4：保存分组
+    await allure.step('保存分组', async () => {
+      await supplierGroupingPage.saveGrouping();
+      await supplierGroupingPage.attachScreenshot(testInfo, '新增供应商分组成功截图');
+    });
+
+    // 步骤5：验证分组创建成功
+    await allure.step('验证分组创建成功', async () => {
+      const isCreated = await supplierGroupingPage.verifyGroupingCreated(groupName);
+      expect(isCreated).toBeTruthy();
+    });
+  });
+
+  test('修改供应商分组', async ({ supplierGroupingPage }, testInfo) => {
+    await allure.epic('供应商管理');
+    await allure.feature('供应商分组');
+    await allure.story('修改供应商分组');
+
+    // 步骤1：生成新的分组信息
+    const newGroupName = `修改${Date.now().toString().slice(-2)}`;
+    const newRemark = '自动化测试修改';
+
+    // 步骤2：进入供应商分组页面
+    await allure.step('进入供应商分组页面', async () => {
+      await supplierGroupingPage.navigateToSupplierGrouping();
+    });
+
+    // 步骤3：点击编辑分组
+    await allure.step('点击编辑分组', async () => {
+      await supplierGroupingPage.clickEditButton();
+    });
+
+    // 步骤4：修改分组信息
+    await allure.step('修改分组信息', async () => {
+      await supplierGroupingPage.updateGrouping(newGroupName, newRemark);
+      await supplierGroupingPage.attachScreenshot(testInfo, '修改供应商分组成功截图');
+    });
+
+    // 步骤5：验证分组修改成功
+    await allure.step('验证分组修改成功', async () => {
+      const isUpdated = await supplierGroupingPage.verifyGroupingUpdated(newGroupName);
+      expect(isUpdated).toBeTruthy();
+    });
+  });
+
+  test('删除供应商分组', async ({ supplierGroupingPage }, testInfo) => {
+    await allure.epic('供应商管理');
+    await allure.feature('供应商分组');
+    await allure.story('删除供应商分组');
+
+    // 步骤1：生成待删除的分组名称
+    const groupName = `删除${Date.now().toString().slice(-2)}`;
+
+    // 步骤2：先创建一个分组用于删除
+    await allure.step('创建待删除的分组', async () => {
+      await supplierGroupingPage.navigateToSupplierGrouping();
+      await supplierGroupingPage.clickAddButton();
+      await supplierGroupingPage.fillGroupName(groupName);
+      await supplierGroupingPage.fillRemark('自动化测试');
+      await supplierGroupingPage.saveGrouping();
+    });
+
+    // 步骤3：删除分组
+    await allure.step('删除分组', async () => {
+      await supplierGroupingPage.navigateToSupplierGrouping();
+      await supplierGroupingPage.clickGroupingItem(groupName);
+      await supplierGroupingPage.clickDeleteButton();
+      await supplierGroupingPage.confirmDelete();
+      await supplierGroupingPage.attachScreenshot(testInfo, '删除供应商分组成功截图');
+    });
+
+    // 步骤4：验证分组删除成功
+    await allure.step('验证分组删除成功', async () => {
+      const isDeleted = await supplierGroupingPage.verifyGroupingDeleted(groupName);
+      expect(isDeleted).toBeTruthy();
+    });
+  });
+});
@@ -34,6 +34,31 @@ export function generateCustomerName(): string {
   return `${familyName}${givenName}${timestamp}`;
 }
+// 随机生成中文姓名（用于负责人等场景）
+export function generateChineseName(): string {
+  const firstNames = ['张', '李', '王', '刘', '陈', '杨', '黄', '赵', '周', '吴', '徐', '孙', '马', '朱', '胡', '郭', '何', '林', '高', '罗'];
+  const lastNames = ['伟', '芳', '娜', '敏', '静', '丽', '强', '磊', '军', '洋', '勇', '艳', '杰', '涛', '明', '超', '秀英', '建国', '志强', '晓明'];
+  const firstName = firstNames[Math.floor(Math.random() * firstNames.length)];
+  const lastName = lastNames[Math.floor(Math.random() * lastNames.length)];
+  return `${firstName}${lastName}`;
+}
+
+// 随机生成供应商名称
+export function generateSupplierName(): string {
+  const prefixes = ['华', '中', '东', '西', '南', '北', '安', '盛', '祥', '隆', '鑫', '福', '源', '顺', '昌', '聚', '恒', '威', '腾', '宇'];
+  const suffixes = ['源', '丰', '盛', '达', '祥', '隆', '福', '禄', '宝', '瑞', '昌', '华', '兴', '光', '天', '地', '人和', '利', '盈', '发'];
+  const businessTypes = ['商贸', '实业', '贸易', '供应', '物流', '配送', '批发', '科技', '材料', '能源'];
+  
+  const prefix = prefixes[Math.floor(Math.random() * prefixes.length)];
+  const suffix = suffixes[Math.floor(Math.random() * suffixes.length)];
+  const businessType = businessTypes[Math.floor(Math.random() * businessTypes.length)];
+  
+  // 使用时间戳（后6位）确保不易重复
+  const timestamp = Date.now().toString().slice(-6);
+  
+  return `自动化${prefix}${suffix}${businessType}${timestamp}`;
+}
+
 // 随机生成身份证号码（18位）
 export function generateIdCard(): string {
   // 省份代码