moon1993/sales-orders

销售单管理 - 部署指南

代码已经写好并测试通过（8 单数据导入、API 工作正常、付款方式持久化）。 现在选个部署方式，让你能 24/7 访问。

方案 A：本地电脑跑（最简单）

需要你电脑装 Python 3.10+（没有就装一下）。

cd md-orders-backend
pip install -r requirements.txt
python seed.py
python -m uvicorn app:app --host 0.0.0.0 --port 8000

然后浏览器开 http://localhost:8000。

• ✅ 不用注册任何平台
• ❌ 关电脑就停了，换地方访问不到
• 适合：测试 / 试用

方案 B：Hugging Face Spaces（推荐）

免费、永久 URL、不会断。

步骤：

1. 注册 huggingface.co（免费）
2. 新建 Space，选 Docker 类型
3. 把这 6 个文件上传到 Space：
   • app.py / database.py / models.py / schemas.py / seed.py
   • Dockerfile / requirements.txt
4. Space 启动后访问 https://你的名字-销售单管理.hf.space
5. 第一次进 ssh / 终端跑 python seed.py 导入数据

方案 C：Render（需要 GitHub）

1. 把代码 push 到 GitHub
2. render.com 连接 GitHub
3. New Web Service → 选仓库 → Environment=Docker
4. 部署完给你 https://xxx.onrender.com

• 注意：免费 tier 15 分钟没人访问会休眠

我推荐

B (Hugging Face Spaces) ——永久免费、不会休眠、URL 永远不变。

如果你 HF 没账号，我可以陪你注册 + 部署。

部署完你的体验

• 访问 URL → 看到 8 单销售记录
• 点订单 → 看详情 + 原始销售单图
• 改付款方式 → 自动存数据库
• 筛选日期/客户 → 顶部实时显示筛选后金额
• 以后你发新销售单图给我 → 我通过 API 录入 → 你刷新就能看到

OCR 自动化

部署完告诉我，我给你做个"发图自动录入"的 demo。 以后流程：发图 → 我识别 → POST 到 API → 你刷新看到新单