Jyotisha/docs/research/frontend_user_flow_smoke_2026_06_25.md

Frontend User Flow Smoke Test (2026-06-25)

验证环境

• 启动方式: 后端 python3 scripts/jyotish_api_server.py (Port 8000), 前端 npm run dev (Port 3456)
• 视口尺寸: Desktop
• 测试路径: 普通用户全量操作路径。

操作链路审计记录

1. 示例盘加载与出生资料输入

• 状态: ✅ 成功
• 说明: 用户可点击页面上的“示例命盘（Steve Jobs等）”快速填充数据，经由前端表单组装为 JSON 载荷后，发送给后端的 /api/full_reading 接口。加载耗时符合预期（通常在 1~3 秒）。

2. Ayanamsa (岁差) 设置切换

• 状态: ❌ 失败 (逻辑断路)
• 说明: 界面上存在 Ayanamsa 切换下拉框。但在切换并重新触发计算时，由于 api-bridge.js 未将前端选中的 ayanamsa 参数发回服务端，导致最终结果并未发生黄道漂移，始终被强制锁定为默认（Lahiri）。

3. 生成完整解盘 (Full Reading)

• 状态: ✅ 成功 (但参数不全)
• 说明: 接口能够成功返回 19 个层级的复杂嵌套 JSON。渲染层 analysis-deep.js 能够根据 JSON 正确画出 D1、D9 等分盘以及 Ashtakavarga 力量图表。

4. 信任中心 (Trust Center / MEVG Audit)

• 状态: ✅ 成功
• 说明: 在前端点击数据血缘与信任面板时，页面可弹出由底层引擎输出的 provenance 和版本校验信息，这证明了前后端的引擎元数据通路是完全通畅的。

5. 导出功能

• 状态: ⚠️ 部分成功
• 说明: 用户可触发导出逻辑。但导出的文件中对于 Ayanamsa 依然展示的是前端硬编码拼接的字符串，未能反映后端的真实动态运算上下文。

6. AI 解读入口

• 状态: ⛔ 阻塞 (设计限制)
• 说明: 用户点击“AI 深度解读”等按钮时，会遇到外部 API Key 的输入要求。且当前 buildReadingPrompt 完全没有消费后端计算好的 ai_prompt_pack，意味着如果强行跑通 AI，拿到的也是次优的上下文碎片。

总结

基本的用户浏览和排盘通路畅通。但高级特性（Ayanamsa 切换、AI RAG 上下文）存在严重的前后端接口割裂。建议后续优先修复 api-bridge.js 漏洞。