feat(admin): 添加用户管理相关文件

添加用户管理视图、API和状态管理文件
2026-03-28 14:37:29 +08:00
commit 08ea5fbe98
1643 changed files with 255646 additions and 0 deletions
@@ -0,0 +1,113 @@
+# 测试框架API文档
+
+## 核心模块
+
+### TestConfig
+
+配置管理模块，提供统一的配置接口。
+
+#### 方法
+
+- `getInstance()`: 获取单例实例
+- `getEnvironment()`: 获取当前环境配置
+- `setEnvironment(envName: string)`: 设置环境
+
+#### 示例
+
+```typescript
+import { testConfig } from './core/test-config';
+
+const env = testConfig.getEnvironment();
+console.log(env.baseURL);
+```
+
+### TestLogger
+
+日志记录模块，提供统一的日志接口。
+
+#### 方法
+
+- `debug(message: string)`: 记录调试信息
+- `info(message: string)`: 记录一般信息
+- `warn(message: string)`: 记录警告信息
+- `error(message: string, error?: Error)`: 记录错误信息
+- `startTest(testName: string)`: 开始测试
+- `endTest(testName: string, status: string)`: 结束测试
+
+#### 示例
+
+```typescript
+import { testLogger } from './core/test-logger';
+
+testLogger.startTest('示例测试');
+testLogger.info('测试步骤1');
+testLogger.endTest('示例测试', 'passed');
+```
+
+### TestDataManager
+
+数据管理模块，提供测试数据管理接口。
+
+#### 方法
+
+- `createTestUser(userData: Partial<TestUser>)`: 创建测试用户
+- `createTestRole(roleData: Partial<TestRole>)`: 创建测试角色
+- `getTestData(key: string)`: 获取测试数据
+- `cleanup()`: 清理测试数据
+
+#### 示例
+
+```typescript
+import { testDataManager } from './core/test-data-manager';
+
+const user = await testDataManager.createTestUser({
+  realName: '测试用户',
+  email: 'test@example.com'
+});
+
+await testDataManager.cleanup();
+```
+
+## 辅助工具
+
+### FormHelper
+
+表单操作辅助工具。
+
+#### 方法
+
+- `fillField(selector: string, value: string)`: 填充字段
+- `fillForm(fields: Record<string, { value: string }>)`: 填充表单
+- `selectOption(selector: string, value: string)`: 选择选项
+- `submitForm(selector?: string)`: 提交表单
+
+#### 示例
+
+```typescript
+import { FormHelper } from './helpers/form-helper';
+
+const formHelper = new FormHelper(page);
+await formHelper.fillField('input[name="username"]', 'testuser');
+await formHelper.submitForm();
+```
+
+### TableHelper
+
+表格操作辅助工具。
+
+#### 方法
+
+- `getRowCount(tableSelector: string)`: 获取行数
+- `getCellText(tableSelector: string, row: number, col: number)`: 获取单元格文本
+- `findRowsByCellText(tableSelector: string, searchText: string)`: 查找行
+- `clickRow(tableSelector: string, row: number)`: 点击行
+
+#### 示例
+
+```typescript
+import { TableHelper } from './helpers/table-helper';
+
+const tableHelper = new TableHelper(page);
+const rowCount = await tableHelper.getRowCount('.user-table');
+const cellText = await tableHelper.getCellText('.user-table', 1, 2);
+```