🍚 大米采购管理系统 v2.0#

记录每个客户的大米进货、消耗与应收款，自动计算库存剩余天数，支持分批进货、欠款追踪、月底对账提醒。

v2.0 新功能#

• ✅ 分批进货：支持客户多次进货，自动汇总总库存
• ✅ 欠款追踪：记录每笔进货的单价、金额、付款状态
• ✅ 对公/对私：区分对私（微信/支付宝）和对公（公户转账）
• ✅ 月底结账：设置结账日期，到期自动提醒收款
• ✅ 月度对账：按月份统计每个客户的进货量、金额、已付、欠款
• ✅ 双提醒：库存提醒 + 对账到期提醒

功能特性#

📦 库存追踪#

• 添加客户（姓名、手机号、人口、消耗频率）
• 自动汇总所有进货的总库存
• 计算剩余天数、预计吃完日期
• 状态标签：已耗尽（红）/ 即将耗尽（橙）/ 注意（蓝）/ 充足（绿）

📝 进货记录#

• 支持分批多次进货
• 记录：日期、斤数、单价、金额
• 账户类型：对私（微信/支付宝）/ 对公（公户转账）
• 结账日期：设置月底结账日
• 一键标记已付款

💰 对账管理#

• 按月份查看对账单
• 统计每个客户：进货量、总金额、已付、欠款
• 到期未付款自动提醒（逾期天数）
• 支持对公/对私分别统计

🔔 自动提醒（双重提醒）#

• 库存提醒：大米即将吃完时提醒采购
• 对账提醒：结账日期到期但未付款时提醒收款

使用方式#

📋 常用操作（告诉 AI 即可）#

操作示例添加客户"添加客户：张三，手机13800138001，家里3口人"添加进货"张三又买了500斤，3.4元/斤，未付款，4月底结账"标记已付"张三那笔3400元的已付款了"查看库存"查看大米库存"查看对账"查看3月对账单"删除客户"删除张三的记录"测试提醒"运行一次大米检查"

🌐 Web 界面#

bash

python3 ~/.openclaw/workspace/skills/rice-tracker/scripts/app.py

• 电脑浏览器： http://localhost:5001
• 手机浏览器： http://<本机IP>:5001

界面包含 3 个 Tab：

1. 📦 库存追踪 - 客户库存状态一览
2. 📝 进货记录 - 添加/查看进货明细
3. 💰 对账管理 - 月度对账单与到期提醒

🔔 自动提醒#

每天 20:00（Asia/Shanghai）自动检查，有提醒会自动推送：

• 📦 库存提醒：哪些客户大米快吃完
• 💰 对账提醒：哪些账目到期未付

文件结构#

text

rice-tracker/
├── SKILL.md
└── scripts/
    ├── app.py              # Flask Web 主程序 (v2.0)
    └── check_alerts.py     # 每日检查脚本 (v2.0)

数据结构#

json

{
  "owner": "张三",
  "phone": "13800138001",
  "people": 3,
  "daily_rate": 0.4,
  "frequency": "daily",
  "purchases": [
    {
      "date": "2026-03-04",
      "quantity": 1000,
      "price_per_jin": 3.4,
      "total_amount": 3400,
      "paid": false,
      "settle_date": "2026-04-30",
      "account_type": "corporate",
      "note": "食堂第一批货"
    }
  ]
}

启动服务#

bash

# 启动 Web 服务（后台运行）
nohup python3 ~/.openclaw/workspace/skills/rice-tracker/scripts/app.py \
  > ~/.openclaw/workspace/skills/rice-tracker/app.log 2>&1 &

# 测试提醒脚本
python3 ~/.openclaw/workspace/skills/rice-tracker/scripts/check_alerts.py

定时提醒配置#

bash

# 每天 20:00 自动检查并推送提醒
openclaw cron add --name "大米系统每日检查" \
  --schedule "0 20 * * *" \
  --timezone "Asia/Shanghai" \
  --message "请运行以下命令检查：\npython3 ~/.openclaw/workspace/skills/rice-tracker/scripts/check_alerts.py\n运行后将结果整理成消息发送给我。" \
  --channel webchat