采购小精灵 V2 (Procurement Elf)
> 从询价到付款，覆盖采购全生命周期 —— 25张表、24个CLI命令、12页面Web面板。
V2 新增功能（对比V1）
| 阶段 | V1 | V2新增 |
|---|---|---|
| 采购前 | 供应商/物料基础管理 | + 采购申请单+审批流 / 预算管控 / 样品管理 / 主备供应商 / 招标寻源 |
| 采购中 | 询价比价 | + 物流跟踪 / 催货提醒 / 价格历史趋势 |
| 采购后 | 订单/入库 | + 质检报告 / 退货换货 / 对账付款 / 使用反馈 |
| 持续管理 | 合同/评价 | + ABC物料分级 / 供应商KPI / 风险管理 |
快速启动
Web面板（推荐）
pip install flask
python scripts/web_server.py --port 8770
浏览器打开 http://localhost:8770 — 12个页面，浅蓝清爽主题。
CLI命令行
# 初始化数据库
python scripts/db.py --force
# 查看所有命令
python scripts/procurement_cli.py --help
# 数据看板
python scripts/procurement_cli.py dashboard
24个CLI命令速查
基础模块（V1）
| 命令 | 别名 | 功能 |
|---|---|---|
supplier |
sup |
供应商管理(列表/搜索/新增) |
material |
mat |
物料管理(列表/搜索/新增) |
rfq |
— | 询价比价(创建/报价/综合推荐) |
po |
— | 采购订单(创建/审批/收货入库) |
alert |
— | 库存预警+智能补货建议 |
contract |
— | 合同管理+到期提醒 |
eval |
— | 供应商四维评价 |
dashboard |
dash |
数据看板 |
template |
tpl |
5大行业物料模板 |
扩展模块（V2）
| 命令 | 别名 | 功能 |
|---|---|---|
request |
req/pr |
采购申请单(创建/审批) |
budget |
bud |
预算管理(年度/月度/执行率) |
sample |
smp |
样品管理(申请/测试/量产批准) |
backup |
spb |
主备供应商(分配比例策略) |
price |
ph |
价格历史趋势(涨跌幅/均价) |
logistics |
log/ship |
物流跟踪(状态/位置更新) |
kpi |
— | 供应商KPI排行(准时率/合格率) |
quality |
qc |
质检报告(合格率/缺陷) |
return |
ret |
退货换货管理 |
payment |
pay |
对账付款(发票/付款/逾期) |
feedback |
fb |
使用反馈(质量评分/复购意愿) |
abc |
— | 物料ABC分类(自动/策略) |
risk |
— | 风险管理(识别/缓解) |
sourcing |
src |
招标寻源(项目/中标) |
expedite |
exp |
催货提醒(超期/即将到期) |
文件结构
procurement-elf/
├── SKILL.md ← 本文件
├── procurement.db ← SQLite数据库(28张表)
├── scripts/
│ ├── db.py ← 数据库(28张表 + 5大行业种子数据)
│ ├── procurement_cli.py ← CLI主入口(9基础模块 + V2注册)
│ ├── procurement_cli_v2.py ← V2扩展A(7模块: 申请/预算/样品/主备/价格/物流/KPI)
│ ├── procurement_cli_v2b.py ← V2扩展B(8模块: 质检/退货/付款/反馈/ABC/风险/招标/催货)
│ ├── web_server.py ← Flask Web面板(12页面 + 20+API)
│ └── test_procurement.py ← 集成测试
└── references/
数据库设计（25张业务表）
基础表（V1）
suppliers / materials / rfqs / rfq_items / quotes /
purchase_orders / po_items / stock_in / alerts / contracts / supplier_evaluations
扩展表（V2）
| 表 | 用途 |
|---|---|
purchase_requests / _items |
采购申请单+明细 |
budgets |
年度/月度预算 |
samples |
样品管理 |
supplier_primary_backup |
主备供应商 |
price_history |
价格历史追踪 |
logistics |
物流跟踪 |
quality_inspections |
质检报告 |
returns |
退货换货 |
payments |
对账付款 |
usage_feedback |
使用反馈 |
material_classification |
ABC分类 |
sourcing_projects |
招标寻源 |
supplier_kpi |
供应商KPI |
risk_events |
风险事件 |
expediting |
催货提醒 |
Web面板页面
| 页面 | 功能 |
|---|---|
| 仪表盘 | 7项核心指标 + 行业分布图表 |
| 供应商 | 按行业筛选/评分/资质 |
| 物料 | 库存状态色标 |
| 询价比价 | 多供应商报价对比 |
| 采购订单 | 状态追踪 |
| 合同 | 到期倒计时 |
| 采购申请 | 申请单列表+状态 |
| 预算 | 预算执行率 |
| KPI | 供应商绩效排行 |
| 质检 | 质检报告+合格率 |
| 付款 | 对账付款状态 |
| 风险 | 风险事件预警 |
内置5大行业案例数据
| 行业 | 物料 | 供应商 |
|---|---|---|
| 🏭 制造业 | 不锈钢板/圆钢/铝型材/螺栓/导轨/伺服电机 | 金工精密、长安五金 |
| 🍽️ 餐饮 | 鸡胸肉/鸡蛋/蔬菜/调料/包材 | 鲜达供应链、绿源农产品 |
| 🛒 零售 | 抽纸/洗洁精/矿泉水/电子 | 百汇百货 |
| 💊 医药 | 口罩/酒精/药品/注射器/器械 | 国药控股、康泰医疗 |
| 🏗️ 工程 | 水泥/钢筋/管材/电缆/砂石 | 中建二局、华强建材 |
核心业务流程（完整生命周期）
采购前 采购中 采购后
─────── ────── ──────
部门提需求 ──→ 申请审批 ──→ 询价 ──→ 比价 ──→ 下单 ──→ 物流跟踪 ──→ 质检 ──→ 入库
│ │ │ │ │ │ │
│ │ │ │ │ │ ├─→ 退货(如有)
├─→ 预算检查 ├─→ 样品测试 ├─→ 主备供应商 ├─→ 催货提醒 ├─→ 对账付款
│ │ │
├─→ 招标寻源 └─→ 价格趋势 └─→ 使用反馈
│
└─→ 风险识别 ──→ KPI统计 ──→ ABC分类 ──→ 持续优化
技术栈
- Python 3.11+ / Flask / SQLite
- 纯HTML/CSS/JS前端（无框架依赖）
版本历史
- v2.0.0 (2026-07-12) — 全生命周期升级：+15表 +15命令 +6页面
- v1.0.0 (2026-07-12) — 首版：9大功能 + 5大行业 + Web面板
