📊 系统概述
为生鲜配送行业量身定制的企业级管理系统，实现从订单到结算的全链路闭环
✨ 核心特性
专为生鲜配送行业设计的独特功能
实重结算
支持称重后自动重新计算订单金额，真实反映实际配送重量和价格
先下单后定价
灵活的定价机制，支持客户等级价、单独议价等多种定价策略
智能采购
自动汇总订单需求生成采购任务，支持一品多供和到货实重修正
库存流水
所有库存变动都可追溯，禁止直接修改库存数量，确保数据准确性
中央厨房
BOM 管理、净菜率计算、原料反算，支持半成品加工管理
真实毛利
基于实重和实际成本计算真实毛利，拒绝估算，数据精准可查
🎯 功能模块
完整的生鲜配送业务全链路解决方案
订货商城
- 多端下单（Web/小程序）
- 常用清单/历史复购
- 客户可见商品控制
- 按客户定价展示
商品定价
- 商品基础信息管理
- 多规格支持
- 客户等级价
- 单独议价
订单中心
- 订单审核
- 批量改价
- 状态流转管理
- AI抄单（预留）
智能采购
- 自动生成采购任务
- 一品多供管理
- 到货实重修正
- 供应商评估
智能分拣
- 分拣任务管理
- 智能秤接入
- 标签打印
- 称重回写
仓储管理
- 多仓多库位
- 损耗/报损管理
- 盘点功能
- 库存流水追溯
配送调度
- 路线管理
- 一键排线
- 司机App接口
- 签收确认
中央厨房
- BOM配方管理
- 净菜率设置
- 原料反算
- 加工管理
财务结算
- 客户账单
- 供应商结算
- 毛利报表
- 应收应付管理
报表分析
- 订单分析
- 库存报表
- 财务分析
- 经营看板
🏗️ 技术架构
现代化的技术栈，保证系统稳定性和可扩展性
技术栈详情
PHP 8.2
Laravel 10+ 框架
Vue 3
Vite + Element Plus
MySQL 8
InnoDB 引擎
Redis
缓存与队列
RESTful API
JSON 数据格式
Sanctum
API 认证 + RBAC
🗄️ 数据库设计
完整的数据库表设计，支持生鲜行业特殊需求
核心实体关系（ERD）- 完整版
核心关系详细说明
客户 ← 客户定价 → 商品
一个客户可对多个商品有独立价格，支持等级价和单独议价
订单 1:N 订单明细
金额计算以订单明细为最小颗粒，支持实重结算
订单明细 1:1 分拣任务
称重回写订单明细，触发金额重算
订单明细 N:1 采购明细
按商品+供应商+日期聚合，支持一品多供
采购明细 1:N 库存流水
只记流水不直接改库存，确保可追溯
订单 1:1 应收款
应收金额来源于订单明细汇总，支持对账
商品 N:N BOM配方 N:N 商品
支持BOM配方管理，净菜率计算，原料反算
采购任务 → 质检记录 → 不合格品处理
全链路追溯，问题批次快速召回
核心实体字段设计
| 实体名称 | 中文说明 | 核心字段 | 行业特性 |
|---|---|---|---|
| 客户 | 客户基本信息 | 客户等级、信用额度、结算方式 | 支持先下单后定价 |
| 商品 | 商品主数据 | 商品分类、规格单位、产地 | 多规格、效期管理 |
| 订单 | 客户订单主表 | 下单时间、配送日期、预估金额 | 预估金额≠结算金额 |
| 订单明细 | 订单明细行 | 订货重量、分拣重量、结算重量 | 实重驱动金额 |
| 分拣任务 | 分拣工作项 | 分拣人员、分拣时间、实际重量 | 称重回写触发重算 |
| 采购任务 | 采购单主表 | 供应商、采购日期、预计金额 | 支持到货实重修正 |
| 采购明细 | 采购明细行 | 采购重量、到货重量、单价 | 实际重量入库 |
| 库存流水 | 库存变动记录 | 变动类型、变动数量、变动前/后 | 只增流水不改库存 |
| 应收款 | 客户应收账款 | 账单金额、已收金额、账期 | 金额可反查明细 |
| BOM配方 | 中央厨房配方 | 成品、原料、净菜率 | 支持原料反算 |
三大行业设计原则
禁止覆盖
实重 ≠ 订货重，结算价 ≠ 预估价，全部留字段、留记录
库存只认流水
不直接 update 库存数量，所有变化来自 Stock_Ledger
金额以明细为王
不在 Orders 存真实金额，真实金额来自 Order_Item 汇总
👥 人力资源模块
完整的员工管理、考勤、薪酬、绩效、招聘解决方案
员工管理
考勤管理
请假管理
加班管理
薪资管理
绩效考核
招聘管理
培训管理
排班管理
HRM 核心报表
| 报表代码 | 报表名称 | 报表类型 | 说明 |
|---|---|---|---|
| HRM001 | 员工列表 | list | 所有员工基本信息 |
| HRM010 | 考勤记录 | list | 每日考勤打卡记录 |
| HRM020 | 工资条 | form | 个人工资明细 |
| HRM030 | 绩效考核列表 | list | 员工绩效考核记录 |
| HRM040 | 招聘需求列表 | list | 所有招聘需求 |
📦 库存模块
支持多仓库、批次管理、效期跟踪等生鲜行业特性
入库流程
采购到货 → 质检验收 → 入库确认 → 更新库存
出库流程
订单拣货 → 出库确认 → 扣减库存 → 发货配送
调拨流程
调拨申请 → 调拨出库 → 在途运输 → 调拨入库
生鲜行业适配点
批次管理
每批入库产品必须记录批次号，出库时严格按先进先出（FIFO）原则
效期管理
入库时必须登记有效期，系统自动计算临期预警，过期产品禁止出库
温湿度监控
仓库配置支持温湿度范围设置，运输过程中的温湿度监控与预警
预留库存
订单确认时预留库存，分拣完成后扣减预留
📅 开发里程碑
分阶段实施，快速上线核心功能
阶段一（4-6周）
订单 + 分拣 + 财务
跑通核心业务流程：下单 → 分拣 → 对账
阶段二（3-4周）
采购 + 库存 + 配送
完善供应链管理，实现全链路闭环
阶段三（2-3周）
中央厨房 + 报表
支持加工管理，完善经营分析
📋 详细功能模块设计
研发级详细功能设计，包含API接口、核心表、业务逻辑
系统权限模块
- 用户管理（多角色用户）
- 角色管理（预设+自定义）
- 权限管理（功能/数据/字段）
- 操作日志全记录
订货商城模块
- 商品列表（按客户定价）
- 快速下单/常用清单
- 历史订单复购
- API: GET /api/products
商品定价模块
- 商品基础信息管理
- 多规格支持（斤/kg/箱）
- 客户等级价/单独议价
- PricingService 服务
订单中心模块
- 订单审核流程
- 批量改价功能
- 状态机：待确认→已确认→分拣中→已配送
- AI抄单（预留）
智能采购模块
- 自动生成采购任务
- 一品多供管理
- 到货实重修正
- 采购量公式：需求-可用+安全
智能分拣模块
- 分拣任务管理
- 智能秤接入
- 标签打印
- 称重即回写+金额重算
✅ 质量控制模块（QC）
严格的质检流程，确保生鲜品质安全
质检标准管理
按商品/品类定义质检标准，包括外观、重量、温度、包装、效期等检验项目
到货质检
采购到货时的质检流程：抽样→检验→合格/不合格判定→入库/退货处理
质检报告
完整的质检结果记录，支持追溯查询和统计分析
不合格品处理
退货、换货、降价处理等多种处理方式，记录完整处理过程
生鲜行业质检要点
| 检验项目 | 说明 | 不合格处理方式 |
|---|---|---|
| 外观质量 | 新鲜度、色泽、形状 | 降价处理/拒收 |
| 重量规格 | 实际重量与标称重量差异 | 短重拒收/补偿 |
| 温度 | 到货温度是否符合冷链要求 | 温度异常拒收 |
| 包装 | 包装完整性、标签清晰度 | 包装破损拒收 |
| 保质期 | 剩余保质期是否符合要求 | 临期产品降价 |
📉 损耗管理模块
全链路损耗追踪与分析，降低运营成本
损耗记录
各环节损耗登记（采购/分拣/配送/仓储）
原因分析
按品类/供应商/时间多维度统计分析
损耗预警
超阈值自动预警，及时发现问题
成本核算
损耗成本计入核算，提升盈利能力
🤝 客户关系管理模块（CRM）
提升客户满意度，增强客户粘性
客户档案
- 客户基本信息管理
- 联系人管理
- 客户分级标签
客户拜访
- 拜访计划制定
- 拜访记录登记
- 拜访效果分析
投诉管理
- 投诉受理登记
- 处理跟踪反馈
- 投诉统计分析
满意度调查
- 问卷设计配置
- 调查执行管理
- 结果分析报告
📢 消息通知模块
多渠道消息通知，确保信息及时触达
站内消息
系统内消息通知，支持未读已读状态跟踪
短信通知
订单状态、配送提醒、异常告警短信通知
微信推送
订单状态变更、账单通知、活动推送
邮件通知
对账单发送、报表定时推送、重要通知
通知模板管理
| 模板类型 | 触发场景 | 支持渠道 | 说明 |
|---|---|---|---|
| 订单确认 | 客户下单成功 | 站内/短信/微信 | 订单号、商品明细、金额 |
| 配送提醒 | 商品开始配送 | 短信/微信 | 预计送达时间、司机联系 |
| 账单通知 | 生成对账单 | 站内/邮件 | 账单明细、付款方式 |
| 异常告警 | 库存不足/配送异常 | 站内/短信 | 异常类型、处理建议 |
🔬 食品安全追溯模块
全链路追溯，确保食品安全可查可控
溯源信息采集
供应商资质审查、批次信息登记、全程温湿度记录
溯源链路查询
正向追溯（来源→去向）、反向追溯（成品→原料）
问题批次召回
快速定位问题批次，制定召回计划，执行跟踪记录
溯源档案管理
电子档案存档管理，支持扫码查询追溯信息
追溯核心数据
⚙️ 技术规范说明
API设计、定时任务、消息队列等技术规范
API 接口规范
| 规范项 | 说明 |
|---|---|
| 认证方式 | Laravel Sanctum Token 认证 |
| 请求格式 | JSON (application/json) |
| 响应格式 | {code, message, data, timestamp} |
| 分页参数 | page, per_page (默认20) |
定时任务清单
| 任务名称 | 执行频率 | 说明 |
|---|---|---|
| 自动生成采购任务 | 每日 02:00 | 汇总订单需求生成采购 |
| 库存预警检查 | 每小时 | 检查安全库存发送预警 |
| 订单状态更新 | 每5分钟 | 更新超时未签收订单 |
| 财务报表生成 | 每日 06:00 | 生成昨日经营报表 |