# 年会互动大屏系统 - 压力测试指南

## 快速开始

### 1. 安装依赖
```bash
cd packages/server
pnpm add -D artillery @artilleryio/engine-socketio-v3
```

### 2. 确保服务运行
```bash
# 根目录启动所有服务
pnpm dev

# 或仅启动服务端
pnpm dev:server
```

### 3. 运行压测
```bash
# 冒烟测试 (快速验证)
pnpm test:load:smoke

# 标准测试
pnpm test:load

# 重压模式 (200并发，对应需求规格书验收标准)
pnpm test:load:heavy

# 脉冲测试 (模拟现场投票热潮)
pnpm test:load:pulse
```

---

## 测试模式说明

| 模式 | 命令 | 并发量 | 持续时间 | 用途 |
|------|------|--------|----------|------|
| `smoke` | `pnpm test:load:smoke` | 5 | 5s | 快速验证配置 |
| `standard` | `pnpm test:load` | 50 | 20s | 日常开发测试 |
| `heavy` | `pnpm test:load:heavy` | 200 | 35s | **验收标准 (150人并发)** |
| `pulse` | `pnpm test:load:pulse` | 150-200 | 21s | 模拟现场脉冲式投票 |

---

## 验收标准

根据 `年会互动大屏系统需求规格说明书.md`：

| 指标 | 目标值 | 检查方式 |
|------|--------|----------|
| 并发连接 | 200+ | Artillery 报告 `vusers.session_length` |
| QPS | > 1000 | 报告 `socketio.emit_rate` |
| 延迟 P95 | < 500ms | 报告 `socketio.response_time.p95` |
| 错误率 | < 1% | 报告 `vusers.failed` / `vusers.completed` |
| Redis 计数 | 准确无丢票 | 对比 Redis 统计与预期投票数 |

---

## 报告输出

测试完成后会输出类似以下报告：

```
All VUs finished. Total time: 35 seconds

--------------------------------
Summary report @ 16:30:00(+0800)
--------------------------------

socketio.emit: ..................... 5000
socketio.emit_rate: ................ 142.86/sec
socketio.response_time:
  min: ............................. 12
  max: ............................. 456
  median: .......................... 48
  p95: ............................. 189
  p99: ............................. 312

vusers.completed: .................. 200
vusers.created: .................... 200
vusers.created_by_name.完整投票流程: 140
vusers.created_by_name.快速连投压力: 40
vusers.created_by_name.观望用户: .... 20
vusers.failed: ..................... 0
vusers.session_length:
  min: ............................. 2500
  max: ............................. 6800
  median: .......................... 3400
  p95: ............................. 5200
  p99: ............................. 6100
```

---

## 高级用法

### 生成 HTML 报告
```bash
npx artillery run packages/server/load-test/vote-load-test.yaml \
  --output report.json && \
  npx artillery report report.json
```

### 指定环境运行
```bash
npx artillery run packages/server/load-test/vote-load-test.yaml -e heavy
```

### 调试模式 (查看详细日志)
```bash
DEBUG=socketio:* npx artillery run packages/server/load-test/vote-load-test.yaml -e smoke
```

---

## 故障排查

### 1. 连接失败
- 检查服务端是否运行在 `localhost:3000`
- 确认 CORS 配置允许本地访问

### 2. 投票被拒绝 (VOTING_CLOSED)
- 确保导播台已开启投票通道
- 或临时修改服务端绕过投票状态检查

### 3. 性能不达标
- 检查 Redis 连接是否正常
- 确认未在调试模式运行
- 考虑增加 Node.js 内存限制: `NODE_OPTIONS="--max-old-space-size=4096"`
