PushToZhaoShang/README.md

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

快速部署（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）
├── 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":"调整入账"}'

生产建议

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