校享团 · 开发文档 v1.1

架构原则：三端数据互通 · ERP 数据统一存放在供应链中心
小程序、平台后台、供应商门户共用一套 API 与主库，不是三个独立系统。

一、三端一体，数据互通

三个端 = 三个入口，一套数据。 商品、库存、供货单、订单在底层共用同一 ID，按角色展示不同界面。

┌──────────┐   ┌──────────┐   ┌──────────┐
│ 小程序 C端 │   │ 平台后台  │   │ 供应商端  │
└────┬─────┘   └────┬─────┘   └────┬─────┘
     └──────────────┼──────────────┘
                    ▼
         ┌─────────────────────┐
         │   校享团统一业务 API   │
         └──────────┬──────────┘
                    ▼
         ┌─────────────────────┐
         │  ★ 供应链中心（ERP）  │  ← SKU/库存/供货/WMS/成本 主数据
         └──────────┬──────────┘
                    ▼
              订单中心 · 支付中心 · 可选外同步

业务动作	写入	其他端可见
供应商维护 SKU	供应链	平台审核 → 小程序上架
扫码入库/发货	供应链 WMS	平台待验收、库存更新
平台验收	供应链	供应商对账、楼长可采购
学生下单	订单中心	扣减供应链库存、触发分账

二、ERP 数据放在供应链里

ERP 不是外接第三方主库，而是校享团自研「供应链中心」。

数据	存放	三端互通
SKU / 条码 / 多单位	供应链 · 商品主数据	✅
库存 / 流水	供应链 · 库存中心	✅
供货单 / 验收 / 对账	供应链 · 采购协同	✅
WMS 扫码 / 盘点	供应链 · 仓储作业	✅
成本 / 凭证	供应链 · 财务汇算	✅
支付 / 分账	支付中心 + 汇付	✅（SKU 同源）

第三方 ERP（聚水潭/管家婆）的新定位

❌ 不再作为主数据存储
✅ 可选导出/备份/与已有系统对接（Adapter）
不强制采购；供应链中心才是权威数据源

三、供应链中心模块

供应链中心（Supply Chain / ERP Core）
├── 商品主数据      sku, barcode, category
├── 库存中心        inventory, inventory_log
├── 采购协同        supply_order, shipment, receipt
├── 仓储作业(WMS)   scan_record, stocktake
├── 财务汇算        cost_ledger, voucher, reconciliation
└── 可选外同步      → 聚水潭/管家婆 Adapter

演示页：supplier/wms/（WMS）· admin/warehouse/receipt.html（验收）· admin/finance/（财务）

四、统一 API（节选）

方法	路径	说明
POST	`/api/v1/scm/sku`	SKU 创建/更新
GET	`/api/v1/scm/inventory`	库存查询（三端，按权限）
POST	`/api/v1/scm/shipment`	装车发货
POST	`/api/v1/scm/receipt/confirm`	平台验收
POST	`/api/v1/scm/wms/scan`	扫码入/出/拣
POST	`/api/v1/order/sales`	C 端下单（扣库存）
POST	`/api/v1/integration/export/{vendor}`	可选导出第三方 ERP

完整契约见 Markdown 版开发文档

五、演示站 vs 正式版

能力	演示站	正式版
三端 UI 流程	✅	✅
数据同源	Mock 模拟（demo-data.js）	供应链主库 + 统一 API
三端实时联动	❌	✅
ERP 主数据	文档定义	供应链中心自研

六、FAQ

Q：还要买聚水潭/管家婆吗？
A：不强制。供应链中心自研为主库；第三方 ERP 仅可选同步。

Q：供应商端的 ERP 是什么？
A：供应链模块在供应商侧的操作界面，数据写入同一主库。

Q：系统分几个？
A：产品上讲三端；研发上讲一个平台 + 供应链中心（内置 ERP）。