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

快速部署（Docker）

• 1：准备环境变量（不要提交真实口令到仓库）
  • 复制 .env.example 到 .env 并填写 ADMIN_TOKEN
• 2：启动服务

docker-compose up -d

• 3：访问入口
  • 浏览器打开 http://<服务器IP或域名>:57778

腾讯云环境优化

• 使用腾讯云 PyPI 镜像：Dockerfile 已设置 pip -i https://mirrors.cloud.tencent.com/pypi/simple
• 设置时区为 Asia/Shanghai：Dockerfile 安装并配置 tzdata
• 数据持久化：docker-compose.yml 将宿主机 ./data 映射为容器 /app/data，数据库路径 sqlite:///data/data.db

功能概览

• 每日 23:00（服务器本地时区）自动生成并定版当日营业额
• 修正接口：支持按日期修正金额，前端即时一致更新；修正过程不直接在前端展示
• 审计与日志：所有生成/修正写入审计表，兼容追加到 app.log
• 看板：今日/昨日/前日、本周（周一～昨日）、上周（周一～周日）、本月
• 折线图：最近 7 天、本月、上月、最近 90 天；支持缩放、导出图片/CSV

项目结构

.
├── backend/           # Flask API + APScheduler
├── frontend/          # 单页 HTML（Tailwind+Chart.js）
├── seed/              # 预置数据CSV（revenue.sample.csv），构建时复制到 /app/init/
├── data/              # SQLite 数据卷（自动创建/挂载）
├── Dockerfile         # 生产镜像（已适配腾讯云）
├── docker-compose.yml # 一键部署
├── .env.example       # 环境变量示例（不要提交真实 .env）
└── README.md

环境变量

• DATABASE_URL：数据库连接字符串（默认 sqlite:///data/data.db）
• ADMIN_TOKEN：管理修正口令；修正时在请求头加入 X-Admin-Token
• TZ：容器时区（默认 Asia/Shanghai）
• PORT：应用监听端口（默认 5000，示例已改为 57778）

修正接口示例

curl -X PUT http://localhost:5000/api/admin/turnover \
  -H "Content-Type: application/json" \
  -H "X-Admin-Token: $ADMIN_TOKEN" \
  -d '{"date":"2025-12-06","amount":3123.45,"reason":"调整入账"}'

数据预置与迁移

• 首次启动自动导入（DB为空时）：
  1. 如果存在 /app/data/import.csv，优先导入该文件
  2. 否则导入镜像内 /app/init/revenue.csv（可将 seed/revenue.sample.csv 重命名为 revenue.csv）
• CSV格式：

  date,amount
  2025-12-01,12345.67
  2025-12-02,11890.12
  

• 手动导入接口：

  curl -X POST http://<服务器>:57778/api/admin/import \
    -H "X-Admin-Token: $ADMIN_TOKEN" -H "Content-Type: text/csv" \
    --data-binary @revenue.csv
  

环境优化（最优解）

• 基础镜像切换为 python:3.11-alpine，构建更快、体积更小
• 依赖安装走腾讯云 PyPI 镜像：PIP_INDEX_URL=https://mirrors.cloud.tencent.com/pypi/simple
• 自动数据导入：环境变量 AUTO_IMPORT_ON_START=1，启动时按顺序导入
  1. /app/data/import.csv（宿主机 ./data/import.csv）
  2. /app/init/revenue.csv（仓库 seed/revenue.csv）
  3. /app/init/revenue.sample.csv

生产建议

• 建议使用反向代理（Nginx）暴露 5000 端口，并开启 gzip
• 建议通过 docker-compose 的 restart: unless-stopped 保持服务稳定
• 如需外部数据库，设置 DATABASE_URL（例如 PostgreSQL），并移除数据卷映射