Commit Graph
2 Commits
Author SHA1 Message Date
张胜宇 29da85d010 docs(W24): 交付前复核补正 + 场内基金演示线 + 一键启动端到端实跑
按甲方「按你建议的来 一次性搞定上边的建议」执行七项。

文档事实纠错(4 处,逐条实测核对后改)
- D2.4 §AC-04/AC-05:「当前 617 块全部为 public」与本文档自己的 v1.6/v1.8
  版本行(public 730 / registered 25)自相矛盾 ⇒ 标「设计当时」+ 补 v1.8 现状
  (755 块),写明 AC-04/AC-05 现已可证伪、不再需要「造一条测试块」
- D2.5 演示脚本:「family_id 628 块全覆盖」⇒ 755 块(W24 复测)
- D4.8 §9.2:把「集合条数 basic 105 / product 398 / faq 300 / policy 576」
  当成真实条数引用 —— 那是 upsert 墓碑行被计入 get_collection_stats().row_count
  的结果(同 D2.1 v6.9)。已补口径更正段,定规:引用块数一律用 _chunks.jsonl
- D2.6 答辩报告:补 W24 状态 —— docs/43 已入库(702 → 755 块);出口经
  E2c-my 细分后共六个,转人工只在 E5c

演示脚本增强
- D2.5 新增 §4.7 场内基金演示线:5 条台词逐条真 HTTP 实测
  · 场内基金有哪些?             → 20 只清单(13 ETF + 7 LOF)
  · 科创债ETF南方怎么样?        → 单只产品行(R2 / 净值 101.8009)
  · 南方金利定开债券A的管理费率? → 0.50%/年 + 0.15%/年
  · 场内基金报价的最小变动单位?  → 0.001 元
  · 沪深300ETF怎么样?           → E4 生成式作答,且明示「非本公司发行」
  并附修复前/后对比表(修复前:命中另一只产品 / 返回 20 只整张表)
- demo.ps1 自检 2:补 fin_basic_collection ⇒ 四个集合计数(154/251/288/62=755)

_build 处置(不删,改为「把废弃做成一眼可见」)
- 与 D1.6 §4.22 四 已记录的裁定冲突(理由:删掉等于删留痕,也删掉
  「为什么不能重跑」的证据)⇒ 不删
- 三个正文源 _body_kb/_body_plan/_body_requirements.html 顶部加红框
  「已过期」横幅,逐文件列出已核实的滞后项(617 块全 public / 旧品牌
  XX科技·400-XXX·nanfangwm ×5 / 48 条·51 项·7 个批次 / US-CS-08·FR-CS-023)
- _build\README 追加「五、2026-09-21 补记」

端到端实跑(冷启动,非 -SkipStart)
- 停掉全部服务 → 启动演示.bat(demo.ps1 -NoBrowser)⇒ 五项自检全过、rc=0
- 8 个入口 URL 全部 200(portal 首页 / 访客页 / 客户登录 / 员工登录 /
  投顾工作台 / docs / openapi.json / health)
- 访客 token 真对话「科创债ETF南方怎么样?」⇒ succeeded、transfer=False、答单只产品

落档
- D2.1 v6.39 追加「交付前文档复核补正」表(7 项)+ 端到端实跑结论
- D1.6 §11.2 补 W24-8 / W24-9;§11.5 补第 5、6 条
2026-09-21 14:51:32 +08:00
张胜宇 e0992c663e feat(demo): 新增演示一键启动脚本(demo.ps1 + 启动演示.bat)
演示真正要做的事只有一件:**把要看的前端页面按顺序打开,并确认环境真的就绪**。
原先只有 `start.ps1`(起服务),演示前还得手工跑行情刷新与五项自检,容易漏。

本次新增:

- `start.ps1`:不动(它已经幂等,缺什么补什么,重复执行不会起第二个 API/Worker)。
- `demo.ps1`:在 start.ps1 之上补三件事 ——
  ① **刷新行情**:下单要求行情快照落在 15 分钟有效期内(`trade_service.MAX_QUOTE_AGE`),
     过期后所有委托直接 503,而系统没有自动刷新机制;
  ② **五项自检**:口径与 `客服agent/D2.5` §1 完全一致(容器三件套 / 向量库三集合计数 /
     Worker 在跑 / 行情有效期 / `milvus_local_uri` 开关为空);
  ③ **打开演示页面**:访客页(客服浮窗主战场)+ 客户登录页。
  另把「**登录限流 10 次 / 60 秒**,不要反复登录」这条最容易造成假故障的提醒印在「开讲前必看」。
- `启动演示.bat`(GBK,与本仓库既有 .bat 同编码):双击即用,参数透传给 demo.ps1。

实测(本机):`启动演示.bat -SkipStart -NoBrowser` 与完整路径(含调用 start.ps1)
均 **五项自检全过、退出码 0**。

排错留痕(避免后人改回去):Milvus 探测代码原本用 `& $Python -c $probe` 传参,
Windows PowerShell 5.1 传原生命令参数时会把内嵌双引号吞掉(报 `unterminated string literal`)
⇒ 改为经 **stdin** 传给 python,并在脚本里写明原因。
2026-09-20 15:02:53 +08:00