# 校享团 · 开发文档 > **站点**：https://ceshi.aikex.ink > **项目名**：校享团（校园 B2B2C 零食分销） > **文档版本**：v1.1 · 2026-06-23 > **架构原则**：**三端数据互通 · ERP 数据统一存放在供应链中心** --- ## 一、核心架构原则 ### 1.1 三端一体，数据互通 小程序、平台后台、供应商门户是**同一套系统的三个入口**，不是三个独立项目。 | 原则 | 说明 | |------|------| | **统一后端** | 一套 API + 一套 MySQL 主库 | | **统一主数据** | 商品/SKU、库存、供货单、订单、成本 共用同一份数据 | | **分端展示** | 三端按角色权限看到不同菜单和字段，底层 ID 一致 | | **实时联动** | 供应商发货 → 平台验收 → 库存更新 → 小程序可售量变化，同一事务链 | ``` ┌──────────┐ ┌──────────┐ ┌──────────┐ │ 小程序 C端 │ │ 平台后台 │ │ 供应商端 │ │ miniapp/ │ │ admin/ │ │ supplier/│ └────┬─────┘ └────┬─────┘ └────┬─────┘ │ │ │ └──────────────┼──────────────┘ ▼ ┌─────────────────────┐ │ 校享团统一业务 API │ └──────────┬──────────┘ ▼ ┌─────────────────────┐ │ ★ 供应链中心（ERP） │ ← 库存/SKU/供货/WMS/成本 主数据存这里 └──────────┬──────────┘ │ ┌──────────────┼──────────────┐ ▼ ▼ ▼ 订单/支付中心 楼长/用户中心 财务汇算模块 │ │ ▼ ▼ 汇付斗拱（外接） 可选：导出至聚水潭/管家婆 ``` ### 1.2 ERP 数据放在供应链里 **ERP 不是外接第三方的主库，而是校享团自研「供应链中心」模块。** | 数据类型 | 存放位置 | 三端是否互通 | |----------|----------|--------------| | SKU / 条码 / 多单位 | 供应链 · 商品主数据 | ✅ 供应商维护 → 平台审核 → 小程序上架 | | 库存账面 / 流水 | 供应链 · 库存中心 | ✅ 验收入库后全端可见可售量 | | 供货单 / 发货 / 验收 | 供应链 · 采购协同 | ✅ 供应商推单、平台验收、财务对账同源 | | WMS 扫码记录 | 供应链 · 仓储作业 | ✅ 蜀粮扫码写入，平台可查验收依据 | | 成本流水 / 凭证 / 盘点 | 供应链 · 财务汇算 | ✅ 平台汇总、供应商看本户 | | C 端销售订单 | 订单中心 | ✅ 扣减供应链库存 | | 支付 / 分账 | 支付中心 + 汇付 | ✅ 与供货资金线分开，但 SKU 同源 | **第三方 ERP（聚水潭、管家婆等）定位调整为：** - ❌ 不再是主数据存储 - ✅ **可选**的导出/备份/对接通道（Adapter 单向或双向同步） - 用于：已有 ERP 习惯的供应商、财务归档、与外部系统对账 --- ## 二、三端数据互通明细 | 业务动作 | 写入方 | 供应链变化 | 其他端可见 | |----------|--------|------------|------------| | 供应商维护 SKU | 供应商端 | `sku` 新增/更新 | 平台审核后 → 小程序商品 | | 扫码入库 | 供应商 WMS | `inventory` + `inventory_log` | 平台库存、可售量 | | 装车发货 | 供应商端 | `supply_shipment` 状态 | 平台待验收列表 | | 平台验收 | 平台后台 | 库存 + `platform_receipt` | 供应商对账、楼长可采购 | | 楼长 B2B 采购 | 平台/楼长 | 库存扣减 | 平台订单、财务 | | 学生 C 端下单 | 小程序 | 预占/扣减库存 | 平台销售订单、分账 | | 成本核算 | 供应链财务 | `cost_ledger` | 平台利润报表、供应商利润 | **权限隔离**：数据互通 ≠ 全员全可见。学生只看自己的单，供应商只看本户 SKU/供货单，平台看全局。 --- ## 三、系统划分（推荐口径） | 口径 | 划分 | |------|------| | **产品** | 三个端：小程序 + 平台后台 + 供应商门户 | | **研发** | 一个平台 + **供应链中心（内置 ERP）** | | **外接** | 仅支付（汇付）、小程序、短信；ERP 类外接为**可选** | --- ## 四、供应链中心模块结构 ``` 供应链中心（Supply Chain / ERP Core） ├── 商品主数据 sku, sku_unit, barcode, category ├── 库存中心 inventory, inventory_log, warehouse ├── 采购协同 supply_order, supply_shipment, platform_receipt ├── 仓储作业(WMS) scan_record, pick_list, stocktake ├── 财务汇算 cost_ledger, voucher, reconciliation └── 可选外同步 integration_sync_log → 聚水潭/管家婆 Adapter ``` 演示页面对照： | 模块 | 供应商端 | 平台端 | |------|----------|--------| | WMS 扫码 | `supplier/wms/` | — | | 供货验收 | 供货单/发货 | `admin/warehouse/receipt.html` | | 库存/财务 | `supplier/finance/` | `admin/finance/` | | 集成配置 | `supplier/integrations/` | `admin/integrations/` | --- ## 五、数据流（优化后） ``` 蜀粮仓库扫码 供应链中心（主库） 三端 + 外接 ──────────── ────────────── ───────── 入库/拣货/发货 ──写入──► SKU · 库存 · 供货单 │ 平台在线验收 ──写入──► 验收记录 · 库存增加 │ 楼长采购/C端下单 ──扣减──► 库存 · 销售订单 │ ├──► 小程序（可售/订单） ├──► 平台后台（全局） ├──► 供应商端（本户） └──► 可选导出 → 聚水潭/管家婆 ``` --- ## 六、当前演示站状态 | 能力 | 状态 | |------|------| | 98 页 UI + 三端流程 | ✅ 演示可用 | | Mock 数据（`demo-data.js`） | ✅ 模拟三端同源数据 | | 意见反馈 API | ✅ 已实现 | | 统一后端 + 供应链主库 | ❌ Phase 1–2 正式开发 | | 三端实时联动 | ❌ 待后端落地 | > 演示站用一份 Mock 文件模拟「三端互通」；正式版由供应链中心 + 统一 API 实现。 --- ## 七、开放 API 契约（统一网关） 所有端调用同一套 API，通过 `X-Tenant-Role` / JWT 区分供应商、平台、C 端用户。 ### 7.1 供应链 · 主数据 | 方法 | 路径 | 说明 | |------|------|------| | POST | `/api/v1/scm/sku` | 创建/更新 SKU（供应商） | | GET | `/api/v1/scm/sku/{id}` | 查询 SKU（三端） | | GET | `/api/v1/scm/inventory` | 库存查询（三端，按权限过滤） | | POST | `/api/v1/scm/inventory/adjust` | 库存调整（平台/系统） | ### 7.2 供应链 · 采购协同 | 方法 | 路径 | 说明 | |------|------|------| | POST | `/api/v1/scm/supply-order` | 供货单创建 | | POST | `/api/v1/scm/shipment` | 装车发货（含扫码明细） | | POST | `/api/v1/scm/receipt/confirm` | 平台验收确认 | | GET | `/api/v1/scm/reconciliation` | 对账单（供应商/平台） | ### 7.3 供应链 · WMS | 方法 | 路径 | 说明 | |------|------|------| | POST | `/api/v1/scm/wms/scan` | 扫码入库/出库/拣货 | | POST | `/api/v1/scm/wms/stocktake` | 盘点 | ### 7.4 订单 / 支付 | 方法 | 路径 | 说明 | |------|------|------| | POST | `/api/v1/order/sales` | C 端下单（扣减供应链库存） | | POST | `/api/v1/payment/huifu/notify` | 汇付回调 | ### 7.5 可选外同步 | 方法 | 路径 | 说明 | |------|------|------| | POST | `/api/v1/integration/export/{vendor}` | 手动/定时导出至第三方 ERP | | GET | `/api/v1/integration/sync-log` | 同步日志 | --- ## 八、核心数据库表（供应链为主库） | 表名 | 归属 | 说明 | |------|------|------| | `scm_sku` / `scm_sku_unit` | 供应链 | 商品、条码、多单位 | | `scm_inventory` / `scm_inventory_log` | 供应链 | 库存账面、流水 | | `scm_supply_order` / `scm_shipment` | 供应链 | 供货单、发货 | | `scm_receipt` | 供应链 | 平台验收 | | `scm_scan_record` / `scm_stocktake` | 供应链 | WMS 扫码、盘点 | | `scm_cost_ledger` / `scm_voucher` | 供应链 | 成本、凭证 | | `scm_reconciliation` | 供应链 | 对账 | | `sales_order` | 订单中心 | C 端订单（引用 scm_sku） | | `purchase_order` | 订单中心 | 楼长 B2B 采购 | | `payment` / `split_record` | 支付中心 | 汇付分账 | | `integration_sync_log` | 集成层 | 可选外同步日志 | --- ## 九、第三方集成（调整后） | 系统 | 角色 | 优先级 | |------|------|--------| | **校享团供应链中心** | **ERP 主数据（自研）** | P0 | | 汇付斗拱 | 支付/分账 | P0 | | 微信小程序 | C 端 | P0 | | 聚水潭 / 管家婆等 | **可选**导出/导入 Adapter | P2 | | 阿里云短信 | 通知 | P2 | | 扫码枪硬件 | 蜀粮 WMS 作业 | P1 | --- ## 十、FAQ **Q：三端数据互通吗？** A：**是。** 正式版共用一套后端和供应链主库；三端是同一数据的不同视图。 **Q：ERP 数据存哪？** A：**存在校享团供应链中心**，不以外部 ERP 为主库。聚水潭/管家婆仅作可选同步。 **Q：供应商端的「ERP」是什么？** A：是供应链模块在供应商侧的**操作界面**（供货、WMS、对账），数据写入同一供应链库。 **Q：演示站现在互通吗？** A：用 `demo-data.js` **模拟**三端同源；真实联动待后端开发。 **Q：还要买聚水潭/管家婆吗？** A：**不强制。** 若供应商或财务已有习惯，可开 Adapter 做导出备份；非必需。 --- ## 十一、相关链接 | 资源 | URL | |------|-----| | 开发文档（网页） | https://ceshi.aikex.ink/docs/dev-guide.html | | 演示首页 | https://ceshi.aikex.ink/ | | 集成中心 | https://ceshi.aikex.ink/admin/integrations/index.html | | 供应链对接演示 | https://ceshi.aikex.ink/supplier/integrations/connect.html | --- *文档维护：艾科技 · 校享团项目组*