PushToZhaoShang/docs/自动化营业额系统/PRD.md

自动化营业额数据推送与展示系统 PRD

项目概述

• 目标：摆脱第三方平台依赖，实现每日自动生成、持久化、展示营业额数据，并通过 Docker 一键部署。
• 使用人群：运营（查看与导出）、技术（运维与配置）。

用户角色

• 管理员：配置任务、查看与导出数据、触发重跑、查看告警。
• 访客：查看仪表盘与历史数据。

核心功能

• 数据生成：保留现有假数据逻辑（可优化为可参数化），每日定时生成。
• 数据存储：SQLite（默认）/ PostgreSQL（生产），结构化存储并持久化历史。
• Web 展示：响应式仪表盘、趋势图、表格历史查询、区间筛选与导出。
• 定时执行：APScheduler（内嵌）或 Celery（可选扩展）。
• 容器化：Dockerfile + Docker Compose 一键部署。
• 通知提醒：邮件或 Webhook（可选），失败时发送告警。
• 访问控制：简易登录（可选），基于环境变量开关。

页面与交互

• 首页仪表盘
  • 当日营业额、近7/30日趋势图、同比环比（基于模拟规则）。
• 历史数据页
  • 时间区间筛选、列表与图表联动、CSV/Excel 导出。
• 配置管理页（可选）
  • 定时规则、数据生成参数、通知渠道配置。

验收标准

• 每日自动生成与写库，无需人工干预。
• Web 界面在 PC 与移动端均能正常展示与操作。
• 历史数据可查询并支持 CSV/Excel 导出。
• Docker Compose 可一键启动全部服务并运行定时任务。
• 失败自动告警可在启用时生效。

非功能需求

• 可维护：配置项集中于 .env 与 config.json。
• 可扩展：后端 API 与任务模块化，便于替换生成逻辑。
• 安全：不提交敏感信息到代码仓库；登录开关默认关闭。

里程碑

• M1：后端 API + 数据模型 + 定时任务（APScheduler）。
• M2：前端响应式展示 + 区间查询 + 导出。
• M3：Docker 化与部署文档。
• M4：告警通知与简单登录（可选）。