feat: add reporting workflow and optimize dashboard loading
This commit is contained in:
93
docs/技术文档.md
93
docs/技术文档.md
@ -245,3 +245,96 @@ npm run dev -- --host 127.0.0.1 --port 5173
|
||||
- 历史文档与部分配置存在中文乱码
|
||||
- 部分来源数据原始字段编码不稳定
|
||||
- 页面样式近期经历多轮快速调整,仍建议补视觉回归测试
|
||||
|
||||
## 9. 定时更新与邮件报送方案
|
||||
|
||||
为满足“每天下午 17:00 自动更新并发送盘后邮件”的新增需求,建议增加一个独立的调度与报送模块。
|
||||
|
||||
### 9.1 调度方式
|
||||
|
||||
建议采用以下任一方式:
|
||||
|
||||
- 服务器 `cron`
|
||||
- Windows 任务计划程序
|
||||
- 后续统一接入独立任务调度器
|
||||
|
||||
默认调度时间:
|
||||
|
||||
- 每天下午 `17:00`
|
||||
|
||||
### 9.2 推荐执行流程
|
||||
|
||||
每日任务执行顺序建议如下:
|
||||
|
||||
1. 拉取当日龙虎榜与行情数据
|
||||
2. 更新数据库
|
||||
3. 重新生成预警数据
|
||||
4. 统计关注池情况
|
||||
5. 统计待加入关注候选列表
|
||||
6. 生成 PDF 日报
|
||||
7. 发送邮件正文与附件
|
||||
8. 记录执行日志
|
||||
|
||||
### 9.3 建议新增模块
|
||||
|
||||
建议新增以下能力:
|
||||
|
||||
- `backend/scripts/daily_report.py`
|
||||
- 串联数据更新、统计、PDF 生成、邮件发送
|
||||
- `backend/src/lhbfx/reporting.py`
|
||||
- 负责报表数据整理
|
||||
- `backend/src/lhbfx/mailer.py`
|
||||
- 负责 SMTP 或邮件服务发送
|
||||
- `backend/src/lhbfx/pdf_export.py`
|
||||
- 负责 PDF 生成
|
||||
|
||||
### 9.4 配置项建议
|
||||
|
||||
建议在配置文件中新增:
|
||||
|
||||
- 是否启用邮件报送
|
||||
- SMTP 主机
|
||||
- SMTP 端口
|
||||
- 发件人账号
|
||||
- 发件人密码或授权码
|
||||
- 收件人列表
|
||||
- 抄送列表
|
||||
- 日报输出目录
|
||||
- 调度时间
|
||||
|
||||
### 9.5 PDF 生成建议
|
||||
|
||||
PDF 附件可以通过以下方式生成:
|
||||
|
||||
- 基于 HTML 模板渲染后导出 PDF
|
||||
- 或直接使用 Python PDF 库生成结构化报告
|
||||
|
||||
推荐内容结构:
|
||||
|
||||
1. 标题页
|
||||
2. 数据更新时间
|
||||
3. 关注池总览
|
||||
4. 关注池流水摘要
|
||||
5. 今日待加入关注列表
|
||||
6. 风险与预警摘要
|
||||
|
||||
### 9.6 邮件正文建议
|
||||
|
||||
正文采用简洁摘要形式,便于手机查看:
|
||||
|
||||
- 今日关注池概况
|
||||
- 今日关注池重点动作
|
||||
- 今日待加入关注候选
|
||||
- 风险提示
|
||||
- 附件说明
|
||||
|
||||
### 9.7 测试建议
|
||||
|
||||
新增该需求后,应补充以下验证:
|
||||
|
||||
- 17:00 定时任务是否被正确触发
|
||||
- 更新失败时是否生成错误日志
|
||||
- PDF 是否成功生成
|
||||
- 邮件正文是否包含关键摘要
|
||||
- 附件是否能正常打开
|
||||
- 多收件人场景是否发送成功
|
||||
|
||||
Reference in New Issue
Block a user