南向资金监控平台
当前需求概览
- 以港股通南向资金为唯一统计口径，实时展示当日总净流入、沪深拆分、时段阈值、分钟级趋势，并在非交易时段沉淀自
2026-01-01起的日/周/月/累计历史。 - 所有数据必须可追溯到真实采集接口，至少记录采集时间、来源、精度、原始载荷；前端展示「盘中值」「收盘最终值」「历史精度」等标记，避免推测数值。
- 关键事件（阈值突破、5 分钟异动）要形成邮件提示，并把推送记录持久化；推送记录页按时间倒序展示每条通知、规则、触发值、状态与错误信息。
- 当前版本使用 JSON 文件作为存储介质，Repository 层屏蔽路径与命名细节，保持未来迁移 MySQL 所需的与 API 一致的字段契约。
目录说明
backend/：FastAPI + JSON Repository + 采集/聚合/告警/邮件逻辑，启动在localhost:10000。frontend/：Vue 3 + TypeScript、Composition API，Tab 风格单页展示实时、历史、推送三个面板。tools/：辅助脚本（同步东财、发送测试邮件等），用于手动触发数据或告警流程。南向资金监控平台需求.md：正式版需求文档与当前实施状态说明。
启动流程
后端
python -m pip install -r backend/requirements.txt
python -m uvicorn app.main:app --app-dir backend --host 127.0.0.1 --port 10000
前端
cd frontend
npm install
npm run dev -- --host 0.0.0.0 --port 9000
目前推荐用
npm run build生成dist/后再用python -m http.server 9000或任何静态服务直接提供，因为 Vite dev server 在当前安全环境下有权限限制。
数据与推送维护
- 实时+历史数据由
tools/sync_eastmoney.py拉取并写入backend/data/minute_snapshots/、daily_stats/summary.json等；可定时或手动触发。 backend/data/system_config.json记录阈值、邮件、数据源配置；添加了smtp_username与smtp_password等字段，填入腾讯授权码即可发送。tools/send_test_alert.py和新的POST /api/push-records/test接口会生成一条基于当前快照的测试推送，并写入backend/data/push_records/records.json，方便前端列表展示。
关键文档
- 需求全貌：
南向资金监控平台需求.md - 运行日志：
run_backend.out.log、run_backend.err.log、run_frontend.err.log - 配置：
backend/data/system_config.json（sender_email/smtp_username/smtp_password/recipients）
下一步建议
- 让运维持续运行
tools/sync_eastmoney.py，保证数据每日自动刷新并在backend/data/下形成新的 JSON。 - 结合最新推送记录，把前端列表配色补充成更明显的状态差异（绿色、橙、红）。
- 计划将
push_records和告警指标逐步拔高为数据库存储，API 输出保持不变，避免前端适配成本。