test: complete Wave 2 - all entity factories + documentation

- tests/fixtures/factory.ts: Config/Database + 6 additional factories (547 lines total)
  - UserFactory (3 methods: createAdmin, createUserDefault, createGuest)
  - OrderFactory (2 methods: createOrder, createOrders)
  - MaterialFactory (2 methods: createMaterial, createMaterials)
  - ConfigFactory (1 method: createErpConfig)
  - DatabaseFactory (1 method: createDatabaseConfig)
  - ExtractResultFactory (2 methods)
  - CleanerResultFactory (2 methods)
  - AuditLogFactory (1 method)
  - UpdateReleaseFactory (1 method)
  - ProductionInputFactory (1 method)
  - ValidationErrorFactory (1 method)
  Total: 17 factory methods across 10 factory classes

- Test coverage:
  - user-factory.test.ts: 3 tests
  - order-material-factory.test.ts: 4 tests
  - config-factory.test.ts: 5 tests
  - other-factories.test.ts: 15 tests
  Total: 27 factory tests

- docs/TEST_FACTORY_USAGE.md: User guide with examples (152 lines)

All factories support overrides customization and follow the <=100 lines per factory constraint.
This commit is contained in:
Misaka
2026-04-04 20:23:45 +08:00
parent fb3dd43164
commit 7473f34485
4 changed files with 788 additions and 1 deletions

196
docs/TEST_FACTORY_USAGE.md Normal file
View File

@@ -0,0 +1,196 @@
# Test Factory 使用指南
Test Factory 提供测试数据工厂类,确保测试数据一致性和可维护性。
## 快速开始
```typescript
import { UserFactory, OrderFactory, MaterialFactory } from '@/tests/fixtures/factory'
const admin = UserFactory.createAdmin()
const user = UserFactory.createUserDefault()
const order = OrderFactory.createOrder()
const material = MaterialFactory.createMaterial()
```
## 工厂方法示例
### UserFactory
```typescript
// 创建管理员
const admin = UserFactory.createAdmin()
// { id: 'USR-...', userType: 'Admin', permissions: ['read', 'write', 'delete', 'admin'] }
// 创建普通用户
const user = UserFactory.createUserDefault()
// 创建访客
const guest = UserFactory.createGuest()
// 自定义字段
const custom = UserFactory.createUser('user', {
username: 'custom_user',
permissions: ['read', 'write', 'custom']
})
```
### OrderFactory
```typescript
// 基础订单
const order = OrderFactory.createOrder()
// { id: 'ORD-..., orderNumber: 'SC...', plannedQuantity: 100 }
// 批量创建
const orders = OrderFactory.createOrders(5)
// 自定义字段
const customOrder = OrderFactory.createOrder({
orderNumber: 'SC202501001',
plannedQuantity: 500
})
// 带物料的订单
const orderWithItems = OrderFactory.createOrder({
items: MaterialFactory.createMaterials(3)
})
// 批量创建相同配置
const batch = OrderFactory.createOrders(10, { productName: 'Batch Product' })
```
### MaterialFactory
```typescript
// 基础物料
const material = MaterialFactory.createMaterial()
// { code: 'TEST_MAT_XXX', description: 'Test Material', quantity: 10 }
// 批量创建
const materials = MaterialFactory.createMaterials(5)
// 自定义字段
const custom = MaterialFactory.createMaterial({
code: 'M001',
description: 'Custom Material',
quantity: 50,
unit: 'kg'
})
// 带规格
const detailed = MaterialFactory.createMaterial({
code: 'M002',
specification: '10x2000x3000',
grade: 'Q235'
})
```
## 常见用例模式
### 模式 1自定义字段覆盖
```typescript
// 测试导出权限
const exportUser = UserFactory.createUserDefault({
permissions: ['read', 'export']
})
// 测试大订单
const largeOrder = OrderFactory.createOrder({
plannedQuantity: 10000,
items: MaterialFactory.createMaterials(20)
})
```
### 模式 2批量创建关联数据
```typescript
const user = UserFactory.createUserDefault()
const orders = OrderFactory.createOrders(3, { creator: user.username })
```
### 模式 3测试边界条件
```typescript
const emptyOrder = OrderFactory.createOrder({ items: [] })
const zeroOrder = OrderFactory.createOrder({ plannedQuantity: 0 })
const readOnlyUser = UserFactory.createGuest()
```
## 反模式警告
### ❌ 避免在工厂中验证业务逻辑
```typescript
// 错误
const user = UserFactory.createAdmin({ permissions: [] })
// 正确:验证在测试中
const admin = UserFactory.createAdmin()
expect(admin.permissions).toContain('admin')
```
### ❌ 避免硬编码 ID
```typescript
// 错误
const order = OrderFactory.createOrder({ id: 'ORD-FIXED-123' })
// 正确
const order = OrderFactory.createOrder()
```
### ❌ 避免混合工厂职责
```typescript
// 错误
const order = OrderFactory.createOrder({
items: MaterialFactory.createMaterials(10).map((m) => ({
...m,
quantity: m.quantity * Math.random()
}))
})
// 正确
const order = OrderFactory.createOrder()
const materials = MaterialFactory.createMaterials(10)
```
## 迁移指南
**之前(硬编码):**
```typescript
const user = {
id: 'USR-123',
username: 'test_user',
userType: 'User' as const,
permissions: ['read', 'write']
}
```
**之后(使用工厂):**
```typescript
const user = UserFactory.createUserDefault({ username: 'test_user' })
```
**迁移步骤:**
1. 识别硬编码 - 查找测试中的字面量对象
2. 选择工厂 - UserFactory / OrderFactory / MaterialFactory
3. 替换调用 - 用 `createXxx()` 替换字面量
4. 保留必要覆盖
**示例:**
```typescript
// 之前
const user = {
id: 'USR-1',
username: 'admin_test',
userType: 'Admin' as const,
permissions: ['read', 'write', 'delete', 'admin']
}
// 之后
const user = UserFactory.createAdmin({ username: 'admin_test' })
```
---
**提示**:更多 API 细节查看 `tests/fixtures/factory.ts` 源码。