# 订单班命名规范和映射表

## 命名统一原则

所有订单班的命名必须在以下三个地方保持一致：
1. **orderClasses.json** 中的 `id` 字段
2. **simulationMap** 中的 key
3. **终端模拟文件名**和**导出函数名**

## 当前订单班中英文映射表

| 中文名称 | 英文ID | 文件名 | 导出函数名 | 状态 |
|---------|--------|--------|-----------|------|
| 食品 | `food` | `food.ts` | `foodSimulation` | ✅ 已实现 |
| 文旅 | `wenlu` | `wenlu.ts` | `wenluSimulation` | ✅ 已实现 |
| 智能制造 | `manufacturing` | `intelligentManufacturing.ts` | `intelligentManufacturingSimulation` | ✅ 已实现 |
| 智能开发 | `developer` | - | - | ⏸️ 未实现 |
| 财经商贸 | `finance` | - | - | ⏸️ 未实现 |
| 视觉设计 | `visual` | `visualDesign.ts` | `visualSimulation` | ✅ 已实现 |
| 大健康 | `health` | `health.ts` | `healthSimulation` | ✅ 已实现 |
| 交通物流 | `transportation` | `transportation.ts` | `transportationSimulation` | ✅ 已实现 |
| 能源 | `energy` | `energy.ts` | `energySimulation` | ✅ 已实现 |
| 化工 | `chemical` | - | - | ⏸️ 未实现 |
| 环保 | `environmental` | - | - | ⏸️ 未实现 |
| 土木 | `civil` | `civilEngineering.ts` | `civilEngineeringSimulation` | ✅ 已实现 |

## 最近修改记录 (2025-10-02)

### 交通物流订单班统一命名
**问题**: 
- orderClasses.json 中 ID 为 `transportation`
- simulationMap 中 key 为 `logistics`
- 导致点击"交通物流"模版无法触发终端模拟

**解决方案**:
1. 重命名文件：`logistics.ts` → `transportation.ts`
2. 更新函数名：`logisticsSimulation()` → `transportationSimulation()`
3. 更新变量名：`logisticsAgents` → `transportationAgents`
4. 更新 orderClassId：`'logistics'` → `'transportation'`
5. 更新 index.ts 导入语句和 simulationMap 注册

### 智能制造订单班ID修正
**问题**: orderClasses.json 中 ID 为 `manufacture`，但 simulationMap 中为 `manufacturing`

**解决方案**: 修改 orderClasses.json 中的 ID：`"manufacture"` → `"manufacturing"`

## 关键文件位置

- **订单班配置**: `/web_frontend/exhibition-demo/src/data/orderClasses.json`
- **模拟数据映射**: `/web_frontend/exhibition-demo/src/data/terminalSimulations/index.ts`
- **各订单班模拟数据**: `/web_frontend/exhibition-demo/src/data/terminalSimulations/*.ts`

## 添加新订单班的流程

1. 在 `orderClasses.json` 中添加订单班配置，设定统一的 `id`
2. 创建 `/terminalSimulations/{id}.ts` 文件
3. 导出函数命名为 `{id}Simulation`
4. 在 `index.ts` 中导入并注册到 `simulationMap`
5. 确保 orderClassId 与配置文件中的 id 一致

## 注意事项

- ⚠️ **切勿使用不同的命名**：orderClasses.json 的 ID 必须与 simulationMap 的 key 完全一致
- ⚠️ **函数命名规范**：导出函数应命名为 `{id}Simulation`，如 `transportationSimulation`
- ⚠️ **变量命名规范**：Agent 数组应命名为 `{id}Agents`，如 `transportationAgents`
- ✅ **ID 使用英文单词**：优先使用完整、直观的英文单词，如 `transportation` 而不是 `logistics`