Airtep/gig-poc/docs/DEMO.md

Demo 说明

一键启动

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

生产环境启动

cd gig-poc
sh infrastructure/scripts/prod-up.sh

生产环境停止

cd gig-poc
sh infrastructure/scripts/prod-down.sh

OpenAPI 交接文件导出

cd gig-poc
sh infrastructure/scripts/export-openapi.sh

OpenAPI 固化入库（离线）

cd gig-poc
sh infrastructure/scripts/freeze-openapi.sh

一键闭环验收（可单独执行）

cd gig-poc
sh infrastructure/scripts/acceptance-e2e.sh

容量基线压测（可单独执行）

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 文档讲接口交接方式