# Demo 说明

## 一键启动
```bash
cd gig-poc
sh infrastructure/scripts/dev-up.sh
```
默认会自动完成：
- 启动容器并健康检查
- bootstrap 样本数据
- 闭环验收（抽取 -> 入库 -> 匹配 -> 解释）
- 导出 `docs/openapi.json`
- 可选压测并生成 `docs/CAPACITY_BASELINE.md`（`RUN_BASELINE_ON_UP=true`）

## 演示步骤
1. 打开 `http://127.0.0.1:5173`
2. 在“岗位测试页”输入岗位文本并点击“抽取岗位”
3. 点击“入库并匹配工人”，观察 TopN 匹配与推荐原因
4. 在“工人测试页”输入工人文本并点击“抽取工人画像”
5. 点击“入库并匹配岗位”，观察 TopN 匹配与推荐原因
6. 打开“数据浏览页”查看已入库样本
7. 打开“系统状态页”查看健康状态，必要时重新执行 bootstrap

## 生产环境启动
```bash
cd gig-poc
sh infrastructure/scripts/prod-up.sh
```

## 生产环境停止
```bash
cd gig-poc
sh infrastructure/scripts/prod-down.sh
```

## OpenAPI 交接文件导出
```bash
cd gig-poc
sh infrastructure/scripts/export-openapi.sh
```

## OpenAPI 固化入库（离线）
```bash
cd gig-poc
sh infrastructure/scripts/freeze-openapi.sh
```

## 一键闭环验收（可单独执行）
```bash
cd gig-poc
sh infrastructure/scripts/acceptance-e2e.sh
```

## 容量基线压测（可单独执行）
```bash
cd gig-poc
sh infrastructure/scripts/load-baseline.sh
```

## 高并发演示建议
1. 同步匹配：调用 `POST /poc/match/workers` 观察实时结果。
2. 异步匹配削峰：调用 `POST /poc/match/workers/async` 获取 `task_id`。
3. 轮询结果：调用 `GET /poc/match/queue/{task_id}` 直到 `status=done`。
4. 打开 `GET /poc/ops/system/metrics` 观察缓存命中率、队列积压和限流熔断状态。

## 演示建议
- 先演示系统状态页，确认健康与 bootstrap 正常
- 再演示岗位找人、人找岗位两个闭环
- 最后展开 OpenAPI 文档讲接口交接方式