 lzf_0626
|
bfd3964ef8
|
feat(demo): 演示数据一键准备、启动脚本与演示流程文档
交付"别人能自己把系统跑起来做演示"所需的四件东西：
- tools/seed_demo_data.py 演示数据一键准备：10 步按依赖排序
（此前散在 10 个脚本里，没人知道该跑哪些、按什么顺序跑，且知识库那步
根本没有脚本、靠手工调接口）
- tools/seed_knowledge_demo.py 知识库演示素材灌入，幂等（先删同 source_file 再灌）
- start.ps1 启动 API + Worker，含依赖检查与**自动刷新行情**
- docs/44-演示流程.md 8 个主线场景的照读流程 + 排障表 + 账号/命令速查
两条硬约束同时写进了脚本和文档：
1. **Worker 必须常驻**：没有它客服对话一直停在 queued（前端只显示"超时"）、
新知识不进 Milvus 且**没有任何报错**。
2. **行情有效期仅 15 分钟**（`trade_service.MAX_QUOTE_AGE`）：超时后所有委托
直接 503「行情已过期」，而系统**没有自动刷新机制**。故 start.ps1 启动时刷一次，
文档另给"演示中途 503 时补刷、无需重启服务"的处置方法（已实测）。
实测证据：
- start.ps1 在 8099 完整启动，`/docs` 与 `/portal/` 均 HTTP 200（测试进程已清理）
- `tools/e2e_smoke_test.py` → 40/40 通过
- `tools/seed_demo_data.py --dry-run` → 10 步全部正常列出
- 文档中的下单命令实跑：510300 成交价 4.579、金额 457.90、手续费 0.05
|
2026-09-13 21:56:27 +08:00 |
|