46 lines
2.0 KiB
Markdown
46 lines
2.0 KiB
Markdown
# 自动化营业额数据推送与展示系统 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：告警通知与简单登录（可选）。
|
||
|