🔥 热门速查: 采购入库怎么增加库存 订单跨仓库自动拆单 冷藏与常温商品设置 仓库拣货与指派司机 司机电子签名与拍照签收 配送失败怎么再次派送 Stripe/信用卡/余额支付 中英西法多语言配置 扫码枪条形码录入 客户电子发票开具

📊 系统总览、端到端流程与访问入口

系统全局必读
0.1 系统四大终端访问地址与角色分工矩阵 域名:bulkchef888.fugo.ltd
▼

BULK CHEF 是面向餐饮餐厅与食材供应商的一体化 B2B 食材/餐饮耗材在线批发采购商城与 WMS 仓储物流配送管理系统。全系统统一采用美元($)计价,支持多语言切换、多仓库智能库存分配与自有车队 Google Maps 导航配送。

终端名称 访问入口路径 适用角色 核心功能职责
1. 商城采购前端 (H5 / APP / PC) https://您的域名/ 或 /pages/index/index(PC端自动适配) 餐厅采购客户、门店采购员 邮箱/手机号注册登录、多语言切换、按分类/SKU搜索食材、满足起订量加购、预约送货日期与时间段、Stripe/银行转账/余额支付、申请电子发票、一键“再次购买”补单、查看物流与签收凭证。
2. 平台运营管理后台 https://您的域名/admin 平台超级管理员、商城运营、财务、客服 商品与多规格SKU发布(设置条形码、起订量、冷藏标识)、商品分类/标签/参数维护、客户账户审核与分组、订单改价/退款审核/配货单打印、优惠券/秒杀/拼团/积分营销、商城页面DIY装修、多语言词条及支付配置。
3. WMS 仓储物流管理系统 https://您的域名/admin 左侧菜单【仓储】模块 仓库管理员、仓库拣货/出入库操作员 多仓库管理、供应商档案管理、采购/生产/退货入库单录入(支持扫码枪扫条形码)、各仓库实时库存与出入库流水查询、销售订单自动生成的出库单核对、确定拣货、指派送货司机或第三方物流。
4. 送货司机配送端 (移动端H5 / APP) https://您的域名/driver 自营车队送货司机 使用司机手机号+密码登录、实时上报GPS位置、查看名下【待取货/配送中/配送失败/已完成】任务、自动测算客户距离与预计耗时、一键拉起 Google Maps 驾车导航、装车确认取货、异常配送失败报备、二次派送、客户现场手写电子签名+拍照上传签收。
0.2 全链路核心业务流转全景图(从商品入库到司机签收) 核心联动机制
▼

商城前端、平台后台、WMS 仓储与司机端之间通过库存与订单状态实现全自动无缝联动,完整闭环流程如下:

① 后台创建商品&规格SKU(设条码/冷藏/起订量) → ② WMS【采购入库】选仓库&供应商并确认入库 → ③ 系统自动增加该仓库存并汇总同步至商城前台总库存 → ④ 餐厅客户前台下单、选预约送达时间并完成支付 → ⑤ 系统按各仓库存量降序自动分配仓库、扣减库存并拆单生成【待拣货(10)】出库单(WA开头) → ⑥ 仓库人员在WMS【出库配送】点击【确定拣货】变为【待出库(20)】 → ⑦ 仓库点击【选择配送】指派司机,变为【待取货(30)】推送至司机端 → ⑧ 司机端登录点击【确定取货】变为【配送中(40)】并开启Google导航 → ⑨ 送达餐厅后客户手写电子签名+拍照上传,变为【已完成(60)】
💡 核心库存联动规则说明:商城商品的总库存由 WMS 各仓库的实时库存自动汇总而成。新建商品后,建议通过【仓储 -> 采购入库】创建入库单并将状态设为“已入库”,系统会自动更新对应仓库库存及商城前台可售库存。
0.3 单据编号规则与全系统状态码速查表 单号与状态字典
▼
单据/状态类别 编码/前缀格式 状态流转值与含义
WMS 入库单号 ST + 8位年月日 + 6位随机数
例:ST20261122839201
• 0 = 未入库(草稿状态,可继续编辑商品或删除单据,尚未增加库存)
• 1 = 已入库(正式生效,自动增加对应仓库及商城商品库存,不可删除)
• -1 = 作废
• 入库分类:BUY(采购入库)、MAKE(生产入库)、REFUND(退货入库)
WMS 出库配送单号 WA + 8位年月日 + 6位随机数
例:WA20261122510492
• 10 = 待拣货(客户订单支付成功后自动生成,等待仓库人员拣货)
• 20 = 待出库(仓库已点击“确定拣货”,等待指派送货司机或物流)
• 30 = 待取货(已指派送货司机,等待司机在司机端确认装车取货)
• 40 = 配送中(司机已点击“确定取货”,正在前往餐厅客户地址途中)
• 50 = 配送失败(司机遇到客户关门/拒收等异常提交失败原因,支持点击“再次配送”重回40状态)
• 60 = 已完成(司机已上传客户手写签名图、签收人姓名与现场照片,完成交付)
• 90 = 第三方物流/无需物流已发货
出库单配送温层标识 字段 delivery_temp • 0 = 常温(出库单内全部为常温商品)
• 1 = 冷藏(出库单内商品开启了“冷藏配送”)
• 2 = 混合(同时包含常温与冷藏商品,提醒仓库与司机注意冷链分装)

一、商城前端操作说明(餐厅采购客户 H5 / APP / PC)

餐厅采购客户
1.1 客户账号注册、邮箱登录与密码找回 前台路径:登录/注册页
▼

1. 注册新采购账号

  • 1打开商城首页或点击底部导航【我的 (User)】,进入登录界面后点击【注册 (Register)】。
  • 2依次填写:
    • 真实姓名 / 餐厅联系人姓名 (realname);
    • 电子邮箱地址 (email)(作为登录主账号);
    • 登录密码 (password)(长度需为 6~32 位字符,不可设置为纯 123456 弱密码);
    • 邀请码 (inviter,选填):若有业务员或上级推荐码可填写。
  • 3点击提交完成注册,系统支持后台开启新客注册奖励(新人礼:自动赠送优惠券、积分或首单体验余额)。

2. 账号登录与忘记密码

  • 1邮箱密码登录:输入注册邮箱与密码即可登录;PC 端同时支持扫码快捷登录。
  • 2忘记密码找回:在登录页点击【忘记密码 (Forgot Password)】,输入注册邮箱并点击【获取邮箱验证码】,填入收到的 6 位验证码与新密码即可重置。
1.2 多语言切换(English / 中文 / Español / Français 等) 前台路径:右上角语言切换 / 个人中心
▼

针对美国本地多元化餐厅客户(中餐馆、西餐厅、墨西哥餐厅等),商城前端内置实时多语言切换功能:

  • 1在商城首页顶部或【个人中心 -> 设置】中找到语言切换入口(Language)。
  • 2选择目标语言(如 English (en-US)、简体中文 (zh-CN) 等,具体语种由后台【维护 -> 语言设置 -> 语言列表】配置)。
  • 3切换后,商城界面固定按钮、分类菜单及提示语会自动通过语言包(get_lang_json)即时刷新,价格统一以美元 $ 显示。
1.3 食材商品浏览、SKU搜索、起订量与冷链标识查看 前台路径:首页 / 分类页 / 搜索页 / 商品详情页
▼
  • 1多维分类浏览:点击底部【分类 (Category)】,左侧为一级大类(如肉禽生鲜、海鲜水产、调料干货、餐盒耗材等),右侧展示二级子类及对应商品列表。
  • 2关键词与排序筛选:在顶部搜索框输入食材名称、关键字或标签即可模糊检索;列表页支持按综合、价格高低、销量、新品排序。
  • 3查看商品规格与起订量:进入商品详情页可查看:
    • 多图轮播与视频展示;
    • 规格选择(SKU):如“整箱 (Case)”、“袋装 (Bag)”,不同规格对应独立价格($)与实时库存;
    • 最小起订量(min_qty)与限购量:若商品设有起订量(例如最少 5 箱起批),加购数量将自动从起订量开始递增;
    • 冷藏配送标识与商品参数:查看食材产地、存储条件(常温/冷藏/冷冻)、保质期及售后服务保障。
1.4 收货地址管理与 Google 地图坐标自动定位 前台路径:个人中心 -> 地址管理 (Address)
▼

餐厅客户可保存多个门店收货地址,系统通过 Google Maps API 自动进行地理编码与距离测算:

  • 1进入【个人中心 -> 收货地址】,点击【新增地址】。
  • 2填写收货联系人姓名、联系电话、所在州/省(Province/State)、城市(City)、详细街道地址(Address)及邮政编码(Post Code)。
  • 3也支持点击地图定位图标,系统自动调用接口 get_address_from_coordinates 根据当前 GPS 经纬度反解出美国标准街道地址、城市与邮编。
  • 4勾选【设为默认地址】,下单结算时将自动带出该地址。
📌 地址准确性提示:请确保填写的美国街道地址与邮政编码(ZIP Code)准确无误,WMS 生成出库单后会自动将该地址坐标同步给送货司机端用于计算距离与 Google Maps 导航。
1.5 购物车管理、预约配送时间与下单结算 前台路径:购物车 (Cart) -> 确认订单
▼
  • 1购物车批量调整:在【购物车】页面可勾选本次要采购的食材,点击 + / - 或直接输入数字修改采购数量,也可批量移入收藏夹或删除失效商品。
  • 2确认订单信息:点击【去结算 (Checkout)】进入订单确认页:
    • 配送方式:选择【商家配送/快递】或【到店自提】(若后台开启了提货点自提);
    • 预约送达日期与时间段:选择期望送货上门的日期(delivery_appt_date)与时间段(delivery_appt_time,如上午 09:00-12:00 / 下午 13:00-17:00),该预约时间会直接显示在仓库出库单和司机配送单上;
    • 优惠抵扣:选择可用优惠券或开启积分抵扣(系统实时调用 order/computed 计算应付美元总额);
    • 订单备注:填写卸货要求(如“请从餐厅后厨门送入”、“需提供纸质送货单”等)。
  • 3点击【提交订单】,生成唯一订单号并进入收银台。
1.6 订单支付(Stripe信用卡 / Apple Pay / 银行转账 / 余额预付 / 线下支付) 前台路径:订单收银台 (Cashier)
▼

收银台支持多种适合北美餐饮 B2B 采购的支付方式(可在后台按需开启或关闭):

支付方式 操作流程与到账机制
Stripe 在线支付 (stripe) 支持 Visa / MasterCard / Amex 信用卡、借记卡以及 Apple Pay / Google Pay。支付成功后通过 Stripe Webhook 自动回调,订单秒级变为“待发货”并自动推送到 WMS 仓库生成拣货出库单。
账户余额支付 (yue) 餐厅客户可预先在【个人中心 -> 账户充值】充值预付款余额(或由后台财务人工充值授信额度)。结算时选择“余额支付”,立即扣款完成支付并推送至 WMS 仓库。
银行转账 / 线下支付 (bank / offline) 适合支票(Check)、ACH 银行电汇或货到付款客户。选择线下支付提交后,由后台财务人员核实款项到账后在后台点击【线下立即支付】,订单即刻转为已支付并自动推送至 WMS 仓库。
微信支付 / 支付宝 (weixin / alipay) 面向华人餐厅老板提供跨境/本地微信及支付宝扫码快捷支付。
1.7 一键补单(“再次购买”功能) 前台路径:个人中心 -> 我的订单 -> 再次购买
▼

餐厅每日或每周高频采购固定食材清单时,无需重新逐一搜索商品:

  • 1进入【个人中心 -> 我的订单】,找到历史已完成或已购买的采购订单。
  • 2点击订单右下角的【再次购买 (Buy Again)】按钮(对应接口 order/again)。
  • 3系统会自动将该历史订单中的所有商品及对应规格重新批量加入购物车并跳转至购物车/结算页,客户可在购物车微调本次采购数量后一键下单。
1.8 电子发票抬头管理与开票申请/下载 前台路径:个人中心 -> 发票管理 (Invoice)
▼
  • 1维护餐厅公司抬头与税号:进入【个人中心 -> 发票管理 -> 抬头管理】,添加企业发票抬头,填写餐厅公司名称、纳税人识别号(TIN / EIN 税号)、开户行、地址及接收邮箱,可设为默认抬头。
  • 2下单时勾选开票或事后补开:
    • 在下单确认页可直接勾选“需要开具发票”并选择默认抬头;
    • 若下单时未申请,可在订单列表/详情页点击【申请开票】(接口 v2/order/make_up_invoice)进行补开申请。
  • 3查看与下载电子发票:后台财务审核并开具发票后,客户可在【发票记录】中查看开票详情并点击【下载电子发票】保存凭证。
1.9 收货确认与售后退款/退货申请 前台路径:个人中心 -> 我的订单 / 售后退款
▼
  • 1整单或部分商品拆分退款:系统支持对整笔订单或订单内的某几个单品(refund/cart_info)单独发起售后。
  • 2选择售后类型:
    • 仅退款(未发货或少发漏发);
    • 退货退款(已收货发现食材品质问题需退回仓库)。
  • 3上传凭证并提交:选择退款原因、修改退款件数与金额,上传现场食材照片提交审核。后台同意退货后,客户可填写退回物流信息或由司机上门取回,仓库验收后完成原路退款。

二(1)、平台管理后台 —— 商品、分类、规格与冷链设置

后台路径:/admin -> 商品
2.1.1 商品分类管理(无限级分类结构) 菜单:商品 -> 商品分类 (/product/product_classify)
▼
  • 1进入【商品 -> 商品分类】,点击【添加分类】。
  • 2选择上级分类(选“顶级分类”即为一级大类;选择某一级分类即为二级子类)。
  • 3填写分类名称、上传分类图标(建议尺寸 180×180px)及分类大图,设置排序数字(数字越大越靠前),状态设为“显示”并保存。
2.1.2 商品规格模板、商品参数、商品标签与服务保障配置 菜单:商品 -> 商品规格 / 商品参数 / 商品标签 / 商品保障
▼

在发布商品前,预先配置好标准化模板可大幅提升商品上架效率:

子菜单名称 功能用途与操作方法
商品规格 (/product/product_attr) 预设常用批发包装规格模板。例如创建模板“包装规格”,属性名设为“规格”,属性值填入“整箱(20lb)”、“半箱(10lb)”、“袋装(2lb)”。发布多规格商品时可一键套用。
商品参数 (/product/param/list) 预设食材属性参数表模板,如“产地(Origin)”、“存储温度(Storage Temp)”、“保质期(Shelf Life)”、“净含量(Net Weight)”,在商品详情页以规格参数表格形式展示。
商品标签 (/product/label/list) 创建醒目营销/属性角标,如“USDA Prime”、“冷冻生鲜”、“餐厅必采”、“有机食材”,支持自定义标签文字颜色与背景色。
商品保障 (/product/protection/list) 配置售后服务承诺条款,如“冷链专车直达”、“破损包赔”、“源头直采质检”,增强餐厅客户采购信任度。
2.1.3 发布与编辑商品(含条形码、起订量、冷藏配送与SKU设置) 菜单:商品 -> 商品管理 (/product/product_list)
▼

点击【商品 -> 商品管理 -> 添加商品】,按顶部标签页分步填写(系统每分钟自动缓存草稿,防止意外关闭丢失):

  • 1基础信息:
    • 选择商品类型(普通商品)、商品分类(可多选)、填写商品名称、单位(如 箱 / Case / lb)、上传商品主图与轮播图(或主图视频);
    • 冷藏配送开关 (is_cold_delivery):若该食材属于冷藏/冷冻品,请务必开启【冷藏配送】,系统在生成 WMS 出库单及司机配送单时会自动标记为“冷藏”或“混合”温层!
  • 2规格库存(与 WMS 联动核心):
    • 选择【单规格】或【多规格】;
    • 填写每个 SKU 的售价 (`$`)、成本价、原价、重量(kg)、体积(m³);
    • 商品条形码 (bar_code) / 商品编号:强烈建议为每个 SKU 填写唯一的条形码或 SKU 编码,方便在 WMS【采购入库】中使用扫码枪快速扫码录入!
  • 3起订量与限购设置(B2B 批发控制):
    • 起购数量 (min_qty):设置餐厅客户单次最少购买件数(默认 1,批发商品可设为 5、10 等);
    • 是否限购 (is_limit):针对特价引流食材,可开启“单次限购”或“长期限购”并填入限购数量(limit_num)。
  • 4物流设置与商品详情:勾选支持的物流方式(快递/商家配送、到店自提),选择固定邮费或运费模板;在详情编辑器中上传图文介绍,关联商品参数、商品标签与服务保障后点击【保存】。
⚠️ 关于商品库存的重要说明:商品创建完成后,请前往【仓储 -> 采购入库】为该商品办理入库单(选择具体存放的仓库并设为“已入库”),否则在未建立分仓库存的情况下,客户订单支付后无法自动分配仓库生成出库单!
2.1.4 会员专属价、分销返佣与阶梯/VIP价格独立设置 菜单:商品管理列表 -> 操作列【会员价/佣金】
▼

针对不同等级的签约餐厅(如连锁大客户 VIP、普通餐厅),可对每个商品单独设置专属采购价:

  • 1在【商品 -> 商品管理】列表中找到目标商品,点击右侧操作列中的设置项(对应接口 otherInfo / otherSave)。
  • 2开启【自定义会员价 (is_vip)】或【付费会员专享 (vip_product)】,为每个 SKU 填入会员专属批发单价。
  • 3若启用业务员推广返佣,可在此开启【单独分佣 (is_sub)】并设置一级、二级推广返佣金额或比例。
2.1.5 商品批量设置、Excel迁移导入导出与回收站恢复 菜单:商品 -> 商品管理顶部工具栏
▼
  • 1批量上下架与批量设置:勾选多个商品后,点击顶部【批量上架】、【批量下架】或【批量设置】(可一次性批量修改分类、物流方式、运费模板、赠送积分、关联优惠券、商品标签及推荐属性)。
  • 2商品迁移导出与导入:支持将现有商品数据一键导出为 Excel(productExport),或上传标准格式 Excel 表格(参考根目录 product_migration.xlsx)批量导入商品。
  • 3商品回收站管理:删除的商品会先进入【回收站】页签(避免误删导致历史订单关联丢失);在【回收站】页签中可点击【恢复商品】或【彻底删除】。
2.1.6 商品评论管理与虚拟自评添加 菜单:商品 -> 商品评论 (/product/product_reply)
▼

在【商品 -> 商品评论】中可查看所有餐厅客户提交的订单评价,支持管理员点击【回复】进行官方解答,也可点击【添加自评】为新品录入图文评价展示。在【设置 -> 商品配置】中可控制评论是否需要后台审核后才在前台显示。

二(2)、平台管理后台 —— 订单处理、改价、打印与售后退款

后台路径:/admin -> 订单
2.2.1 订单列表筛选、订单详情查看与 WMS 拆单状态核对 菜单:订单 -> 订单管理 (/order/list)
▼
  • 1在【订单 -> 订单管理】页面,顶部统计卡片实时展示全部订单、未支付、未发货、待收货、待评价、交易完成、仅退款、退货退款的数量与金额汇总。
  • 2支持按订单号、客户姓名、手机号、商品名称、支付方式(Stripe/余额/银行转账/线下支付等)、下单时间区间组合检索。
  • 3查看 WMS 分配状态:客户订单完成支付后,系统自动调用 WmsServices::allocateOrder 推送至 WMS 仓储模块,订单会关联生成的 WMS 出库单号(wastage_documents,如 WA2026...)以及分配状态(1=已全部分配仓库,2=部分库存不足仅部分分配)。
2.2.2 未支付订单改价与线下支付/银行转账确认收款 菜单:订单 -> 订单管理 -> 操作列
▼

1. 订单改价(议价/抹零/修改运费)

对于状态为“未支付”的订单,点击右侧操作列【更多 -> 订单改价】,可直接修改实际应付商品总价(pay_price)、实际支付邮费(pay_postage)或赠送积分。保存后客户在前端收银台刷新即可按修改后的新金额付款。

2. 线下支付 / 银行转账 / 支票人工确认收款

当餐厅客户采用支票(Check)、ACH 银行电汇或线下现金结算时,财务核实到账后,在订单列表找到该笔未支付订单,点击操作列【立即支付】(线下确认付款)。系统将立刻把该订单标记为“已支付”,并自动触发 WMS 仓库分配与出库单生成流程!

2.2.3 订单发货方式(WMS仓储发货 vs 商城后台直接发货/批量导入发货) 菜单:订单 -> 订单管理 / 仓储 -> 出库配送
▼

系统提供两种发货作业路径,可根据业务场景灵活使用:

  • 1标准 WMS 仓库拣货与司机配送(推荐):订单支付后自动进入【仓储 -> 出库配送】,由仓库人员执行【确定拣货】并【选择配送】指派送货司机,司机通过司机端 APP 完成取货与签收。
  • 2商城订单后台直接发货 / Excel批量导入发货:在【订单 -> 订单管理】中点击【发送货】,可选择“快递发货(填写快递公司与单号或电子面单打印)”、“送货上门(选择配送员)”或“虚拟发货”;也支持点击顶部【批量发货】上传 Excel 表格批量录入物流单号。
2.2.4 打印配货单、小票打印与订单Excel导出 菜单:订单 -> 订单管理 / 设置 -> 小票配置
▼
  • 1打印配货单 (printShipping):在订单列表勾选一笔或多笔订单,或进入订单详情点击【打印配货单】,系统会生成标准 A4 食材配货清单(包含餐厅客户信息、收货地址、商品名称、规格 SKU、单价、数量、合计金额及备注),可直接连接办公室打印机打印随车附送。
  • 2小票打印机自动/手动打单 (order_print):在【设置 -> 小票配置】中绑定易联云/飞鹅云热敏小票打印机后,客户下单支付可自动吐出订单小票,也可在订单列表手动点击【打印小票】。
  • 3导出订单 Excel 报表:设置筛选条件后点击【导出】,可下载完整的订单财务与商品明细 Excel 表格用于对账。
2.2.5 售后退款单审核与主动退款处理 菜单:订单 -> 售后订单 (/order/refund)
▼
  • 1处理客户发起的售后:进入【订单 -> 售后订单】,查看客户提交的退款原因与照片凭证:
    • 若为“仅退款”:点击【同意退款】并确认退款金额,款项将原路退回客户的支付渠道(如余额、Stripe 等);
    • 若为“退货退款”:先点击【同意退货】并提供退货仓库收件地址;待仓库收到退回食材并核验无误后,再次点击【确认收货并退款】完成资金退回,同时在【仓储 -> 采购入库】创建一张“退货入库 (REFUND)”单将完好商品重新入库。
    • 若不符售后条件:点击【拒绝退款】并填写驳回说明。
  • 2后台管理员主动退款:即使客户未在前端申请,管理员也可直接在【订单 -> 订单管理】操作列点击【立即退款】为客户办理全额或部分金额退款。
2.2.6 到店自提订单核销与核销记录查询 菜单:订单 -> 核销记录 (/setting/merchant/system_verify_order/index)
▼

针对选择“到店/到仓自提”的餐厅客户,客户提货时出示自提核销码,店员或管理员可在后台【订单 -> 订单管理】顶部点击【核销订单】输入 12 位核销码完成核销,所有核销历史可在【订单 -> 核销记录】中追溯。

二(3)、平台管理后台 —— 餐厅客户管理、分组标签与余额授信

后台路径:/admin -> 用户
2.3.1 后台新建餐厅客户账号、资料审核与状态管控 菜单:用户 -> 用户管理 (/user/list)
▼
  • 1后台直接开户:除了客户在前台自行注册外,业务员签约新餐厅后可在【用户 -> 用户管理】点击【添加用户】,录入客户真实姓名/餐厅名、手机号、登录密码、联系地址、客户等级、所属分组与标签,状态设为“开启”即可交付客户使用。
  • 2客户资质审核与冻结:点击客户的【编辑】,可查看或补充备注信息(如营业执照号、餐饮许可证信息);若某客户存在违约或欠款逾期,可在编辑页将其状态设为“禁止 (0)”,冻结其登录与下单权限。
2.3.2 人工调整客户账户余额(预付款充值/扣减)与积分 菜单:用户 -> 用户管理 -> 操作列【积分余额】
▼

当餐厅客户通过线下支票、银行电汇预先打款充值账户余额,或平台给予客户账期授信额度时:

  • 1在【用户 -> 用户管理】列表中找到对应餐厅客户,点击右侧操作列【更多 -> 修改积分余额】(对应接口 edit_other / update_other)。
  • 2选择余额操作类型:【增加】或【减少】,输入美元金额($)。
  • 3点击提交后,客户账户余额(now_money)立即更新,并在【财务 -> 余额记录】中自动生成一条带操作管理员 ID 的资金流水记录。客户即可在前台使用“余额支付”下单。
2.3.3 客户分组、客户标签与客户等级折扣体系 菜单:用户 -> 用户分组 / 用户标签 / 用户等级
▼
功能模块 操作方法与业务场景
用户分组 (/user/group) 按餐厅类型或配送片区建立分组(如“中餐连锁组”、“快餐店组”、“纽约曼哈顿片区”),支持在用户列表批量勾选客户一键分配分组。
用户标签 (/user/label) 支持建立标签分类与多维标签(如“高客单价”、“月结大客户”、“高频采购生鲜”),便于精准发放定向优惠券及统计分析。
用户等级 (/user/level) 设置 VIP 等级与全场采购折扣率(例如:普通餐厅 100% 原价、银牌合作餐厅享 95 折、金牌连锁餐厅享 90 折)。管理员可在用户列表操作列点击【赠送会员等级】直接指定客户的批发折扣等级。
2.3.4 客户全维档案详情(消费总额/历史订单/账单明细/持有优惠券) 菜单:用户 -> 用户管理 -> 操作列【详情】
▼

在【用户管理】列表点击任意客户的【详情】按钮,右侧会滑出该餐厅客户的 360° 全景档案抽屉,可一站式查阅其:累计采购总金额、累计订单笔数、当前可用余额、消费订单列表、积分变动明细、签到记录、持有的优惠券、余额变动账单以及推广关系。

2.3.5 付费会员卡(SVIP)与卡密批量生成 菜单:营销 -> 付费会员 (/user/grade)
▼

若平台推行付费年度合作会员(如缴年费享全年批发特权价),可在【营销 -> 付费会员】中配置会员类型(月卡/季卡/年卡/永久)及会员权益,还可在【卡密会员】中批量生成实体卡密并导出 Excel,供线下业务员拓展餐厅客户激活使用。

二(4)、平台管理后台 —— 促销营销、优惠券、秒杀与业务员分销

后台路径:/admin -> 营销 / 分销
2.4.1 优惠券创建、满减/品类券设置与定向发送 菜单:营销 -> 优惠券 -> 优惠券列表 (/marketing/store_coupon_issue/index)
▼
  • 1进入【营销 -> 优惠券 -> 优惠券列表】,点击【添加优惠券】。
  • 2设置优惠券名称、面值($)、发送方式(客户手动领取 / 新人注册自动赠送 / 买商品满额赠送 / 后台管理员手动定向派发)。
  • 3设置适用范围:通用券(全场食材可用)、品类券(仅指定分类如“海鲜类”可用)或商品券(仅指定单品可用),并设置最低消费门槛金额(如满 $500 减 $30)与有效期限。
  • 4定向派发给指定餐厅:在【用户 -> 用户管理】勾选目标餐厅客户,点击顶部【发送优惠券】即可将优惠券直接塞入客户账户。
2.4.2 限时秒杀(尾货清仓 / 每日特价食材)配置 菜单:营销 -> 秒杀管理 (/marketing/store_seckill)
▼
  • 1配置秒杀时间段:先在【营销 -> 秒杀管理 -> 秒杀配置】中设定每日开放秒杀的场次时段(如 08:00-12:00 早市特惠、14:00-18:00 晚市清仓)。
  • 2添加秒杀商品:进入【秒杀商品】点击【添加秒杀商品】,从现有普通商品库中选择食材,设定活动起止日期、参与场次、单次限购数量及每个 SKU 的秒杀特惠价与活动限量库存。
2.4.3 拼团采购、砍价活动与预售商品设置 菜单:营销 -> 拼团管理 / 砍价管理
▼

• 拼团采购 (/marketing/store_combination):适合多餐厅联合集采大宗食材。设置几人成团、拼团特惠价及开启“虚拟成团”(到时未满员自动补齐成团发货)。
• 预售商品设置:在【商品 -> 商品管理】编辑商品时开启【预售商品】开关,设定预售起止时间与预售结束后第几天发货,适合进口生鲜到港前提前锁单。

2.4.4 积分商城、每日签到与新人礼配置 菜单:营销 -> 积分管理 / 每日签到 / 新人礼
▼

• 积分配置:在【营销 -> 积分管理 -> 积分配置】中设定客户每消费 $1 赠送多少积分,以及下单时 1 积分可抵扣多少美元($)和最高抵扣比例。
• 积分商品:可在【积分商品】上架可用纯积分或“积分+美元”兑换的餐饮小工具或赠品。
• 新人礼 (/marketing/newuser/gift):配置新餐厅客户首次注册成功后自动赠送的余额、积分及新人专享优惠券包。

2.4.5 用户充值套餐设置(充赠活动) 菜单:营销 -> 用户充值 -> 金额设置 (/marketing/recharge)
▼

为鼓励餐厅客户预存采购款,可在【营销 -> 用户充值 -> 金额设置】中配置多档充值阶梯(例如:充值 $1,000 赠送 $30;充值 $5,000 赠送 $200),并在【充值配置】中开启前台充值入口。

2.4.6 业务员/代理商分销体系管理 菜单:分销 -> 分销设置 / 分销员管理 / 分销员申请
▼

平台可利用【分销】模块管理线下BD业务员或渠道代理商:业务员通过专属邀请码或推广二维码发展餐厅客户注册后,餐厅客户的每笔采购订单均可按预设比例自动为业务员结算推广佣金,管理员可在【分销员管理】中查看每位业务员名下的餐厅客户数与推广订单业绩。

二(5)、平台管理后台 —— 财务对账、发票开具与数据报表

后台路径:/admin -> 财务 / 主页
2.5.1 发票管理与电子发票审核开具 菜单:财务 -> 财务操作 -> 发票管理 (/order/invoice/list)
▼
  • 1进入【财务 -> 财务操作 -> 发票管理】,可按开票状态(待开票 / 已开票 / 退款取消)筛选客户提交的开票申请。
  • 2点击【查看/开票】,核对订单实付金额、客户发票抬头、税号(TIN)与邮箱。
  • 3将开票状态改为【已开票】,填写发票号码、上传电子发票文件或填写备注保存,客户前端即可同步查看并下载发票。
2.5.2 资金流水与日/月/年账单记录导出 菜单:财务 -> 财务记录 -> 资金流水 / 账单记录
▼

• 资金流水 (/finance/capital_flow/index):记录平台每一笔进出账明细(支付订单入账、充值入账、订单退款支出、佣金提现支出),包含关联订单号、交易对方、支付方式与交易时间。
• 账单记录 (/finance/billing_records/index):自动按日账单、周账单、月账单汇总平台总收入、总支出与净入账金额,点击【下载账单】即可导出财务对账 Excel 报表。

2.5.3 充值记录、余额变动记录与提现审核 菜单:财务 -> 充值记录 / 余额记录 / 提现申请
▼

• 充值记录 (/finance/user_recharge/index):查看所有客户线上预存充值的订单及赠送金额明细。
• 余额记录 (/finance/balance/balance):追溯客户账户余额的每一次变动(订单余额消费、充值增加、退款退回余额、管理员人工加减款)。
• 提现申请 (/finance/user_extract/index):审核业务员或客户的佣金提现申请,支持通过或驳回。

2.5.4 主页运营看板与统计报表(商品销量/订单趋势/客户排行) 菜单:主页 (/index)
▼

登录后台后的【主页】数据大屏提供全方位经营统计(对应 OrderStatistic、ProductStatistic、UserStatistic、TradeStatistic):实时展示今日销售额($)、订单量、新增餐厅客户数、待办事项提醒(待发货订单、待审核售后、库存预警商品)以及按日/周/月/年维度的采购金额趋势折线图与热销食材 TOP 排行榜。

2.5.5 在线客服管理、快捷话术与自动回复 菜单:客服 -> 客服列表 / 客服话术 / 自动回复 / 用户留言
▼

在【客服 -> 客服列表】中可将后台或前端用户添加为在线坐席客服;客服人员可点击【进入工作台】直接与餐厅采购员在线沟通、发送商品卡片与核对订单。同时可在【客服话术】与【自动回复】中预设常见问题(如配送时效、起送金额、开票说明)的快捷回复模板。

二(6)、平台管理后台 —— 视觉装修、支付配置、运费与多语言国际化

后台路径:/admin -> 装修 / 设置 / 维护
2.6.1 商城首页可视化 DIY 装修、轮播图、分类页与主题换色 菜单:装修 -> 首页装修 / 商品分类 / 个人中心 / 主题风格
▼
  • 1首页拖拽式装修 (/setting/pages/devise/0):点击模板的【编辑】进入可视化设计器,左侧组件库可拖拽添加搜索框、轮播广告图、金刚区导航图标、滚动公告栏、促销活动魔方、商品列表组件,右侧实时编辑图片、跳转链接与间距,点击保存即刻同步到前端。
  • 2分类页与个人中心样式 (cate_page / user_page):可一键切换商品分类页的布局样式(左分类右商品 / 顶部导航带购物车快捷加购样式)及个人中心菜单排布。
  • 3主题风格与 PC 端装修:在【主题风格】可一键切换全站品牌主色调;在【应用 -> PC端 -> PC端装修】可配置 PC 网页商城的顶部轮播图与友情链接。
2.6.2 运费模板、区域配送费与提货点设置 菜单:设置 -> 发货设置 -> 运费模板 / 提货点设置
▼
  • 1运费模板 (/setting/freight/shipping_templates/list):点击【添加运费模板】,可按件数、重量(kg)或体积(m³)计费,支持配置“指定区域满额包邮”(如订单满 $300 免配送费,未满收取 $25 基础配送费)以及偏远区域不配送限制。
  • 2提货点设置 (/setting/merchant/system_store/index):若允许餐厅客户直接到仓库自提,可在此填写自提仓库名称、营业时间、联系电话及详细地址,并添加自提核销员。
2.6.3 商城支付配置(Stripe / 余额支付 / 线下支付 / 微信 / 支付宝) 菜单:设置 -> 接口配置 -> 商城支付配置 (/setting/other_config/pay/2/23)
▼

在【设置 -> 接口配置 -> 商城支付配置】中可统一管理各支付通道开关与密钥:

  • 1余额支付:开启/关闭客户使用账户预存余额付款。
  • 2线下支付:开启后客户下单时可选择“线下支付”,适合支票、银行转账或货到收款场景。
  • 3Stripe / 微信支付 / 支付宝:填入对应支付网关的商户号、AppID 及 API 密钥即可启用在线收款。
2.6.4 多语言国际化管理(语言列表 / 语言词条详情 / 机器翻译配置) 菜单:维护 -> 语言设置 (/setting/lang)
▼

系统内置完整的多语言词条管理引擎(同时服务于商城前端与司机配送端):

  • 1语言列表 (/setting/lang/list):管理当前启用的语种(如简体中文 zh-CN、英文 en-US、西班牙语 es-ES 等),可将英文或中文设为默认语言(前台首次打开时默认加载该语言)。
  • 2地区列表 (/setting/lang/country):将浏览器语言标识(如 en-US、en-GB)绑定到对应的语言包类型。
  • 3语言详情 / 词条翻译 (/setting/lang/info):可按端(页面端 / 接口端)搜索任意界面文字或错误提示码,直接修改各语种对应的翻译文本;配置好【翻译配置】后还支持调用翻译接口一键自动填充多国语言翻译。修改后系统会自动更新语言版本号(lang_version),客户端刷新即刻生效。
2.6.5 角色权限分配与管理员账号创建(区分平台管理员与仓库操作员) 菜单:设置 -> 管理权限 -> 角色管理 / 管理员列表
▼

通过 RBAC 角色权限体系,可实现“平台运营管理员”、“财务人员”、“仓库管理员”、“仓库拣货操作员”的权限隔离:

  • 1创建角色 (/setting/system_role/index):点击【添加身份】,例如创建“仓库管理员”角色,在菜单权限树中仅勾选【仓储】模块(仓库管理、供应商管理、采购入库、库存详情、出库配送、司机管理);若创建“仓库拣货员”,可仅勾选【采购入库】与【出库配送】。
  • 2创建子管理员账号 (/setting/system_admin/index):点击【添加管理员】,填写登录账号、密码、姓名并勾选刚刚创建的“仓库管理员”角色。该员工使用此账号登录 /admin 后台时,左侧只会显示其被授权的仓储菜单,无法看到财务、商城设置等敏感模块。
2.6.6 系统设置、云存储配置与消息通知管理 菜单:设置 -> 系统设置 / 消息管理 / 系统存储配置
▼

• 系统设置 (/setting/system_config/2/129):配置网站名称(BULK CHEF)、网站 Logo、联系电话、默认用户头像等基础参数(注:地图配置与备案配置已按定制要求隐藏)。
• 系统存储配置 (/setting/storage):支持本地存储或 Amazon S3、阿里云 OSS、腾讯云 COS、七牛云对象存储切换。
• 消息管理 (/setting/notification/index):统一开关每一个业务节点(新订单提醒、发货通知、退款通知)的站内信、短信等提醒方式。

2.6.7 系统维护:刷新缓存、定时任务、操作日志与数据库备份 菜单:维护 -> 安全维护 / 开发配置 / 数据维护
▼
  • 1刷新缓存 (/system/maintain/clear/index):当修改了系统配置、语言包或页面装修未立即显示时,点击【刷新缓存】即可一键清理全站数据缓存。
  • 2定时任务 (/system/crontab):管理系统自动化任务(如未支付订单到期自动取消、已发货订单超期自动收货、预售商品到期下架等)。
  • 3系统日志 (/system/maintain/system_log/index):审计所有后台管理员的登录及操作行为日志。
  • 4数据库管理 (/system/maintain/system_databackup/index):支持在线一键备份 MySQL 数据库表并下载备份包。

三、WMS 仓储物流管理系统操作说明

后台路径:/admin -> 仓储 (WMS)
3.1 仓库管理(新建与维护多仓库/冷库档案) 菜单:仓储 -> 仓库管理 (/wms/warehouse/index)
▼

在使用入库与出库功能前,需先建立至少一个实体仓库或温区仓库(例如:洛杉矶一号常温仓、洛杉矶二号冷藏仓、纽约总仓):

  • 1进入【仓储 -> 仓库管理】,点击【添加仓库】。
  • 2填写以下信息:
    • 仓库名称 (name):如“LA 冷藏中心仓”;
    • 仓库编码 (code,必填且全系统唯一):如 WH-LA-01(若编码重复系统会提示已存在);
    • 仓库地址 (address):填写仓库详细街道地址;
    • 备注 (remark):填写仓库负责人或温区说明。
  • 3点击保存完成创建;后续可随时点击【编辑】修改仓库信息。
3.2 供应商管理(建立上游食材供货商档案) 菜单:仓储 -> 供应商管理 (/wms/supplier/index)
▼
  • 1进入【仓储 -> 供应商管理】,点击【添加供应商】。
  • 2填写供应商名称 (name)、供应商唯一编码 (code,如 SUP-001)、供应商地址 (address) 及联系人电话备注(remark)。
  • 3保存后,在办理【采购入库】时即可从下拉列表中直接选择该供货商,实现食材来源全程可追溯。
3.3 采购入库 / 生产入库 / 退货入库(支持扫码枪条形码录入) 菜单:仓储 -> 采购入库 (/wms/storage/index)
▼

所有商城商品的分仓库存均通过【采购入库】模块建立与增加:

1. 创建或编辑入库单

  • 1进入【仓储 -> 采购入库】,点击【新增入库单】,系统自动生成以 ST 开头的唯一入库单号(如 ST20261122105829)。
  • 2选择单据头信息:
    • 入库类型 (document_cate):选择 采购入库 (BUY)、生产入库 (MAKE) 或 退货入库 (REFUND);
    • 入库仓库 (warehouse_id):选择本次货品存放的目标仓库;
    • 供应商 (supplier_id):选择供货商名称;
    • 单据备注 (remark):可填写采购批次号、生产日期、保质期或送货车牌号。
  • 3添加入库商品明细(支持两种方式):
    • 方式 A(扫码枪快速扫码):将光标置于条码扫描框,使用 USB/蓝牙条码枪扫描外箱条形码(调用接口 wms/scan_barcod 匹配商品 SKU 的 bar_code),系统自动将对应规格商品加入明细表;
    • 方式 B(手动搜索选择):点击【选择商品】(调用 wms/get_product_list),按商品名称或关键字搜索并勾选要入库的商品规格 SKU。
  • 4在商品明细表中填写每一项 SKU 的入库数量 (goods_num) 与采购进货单价 (goods_price),系统自动核算小计与单据总金额(goods_money)、总件数(goods_num)。
  • 5选择入库状态并提交:
    • 若货品尚在清点中:状态选为【未入库 (0)】暂存草稿,此时不会增加库存,后续仍可随时编辑或删除该入库单;
    • 若清点无误正式上架:状态选为【已入库 (1)】并提交保存!
🚨 入库生效与不可逆提示:一旦将入库单状态设为【已入库】并保存,后台任务 WmsJob::storageIncStock 会立即将商品数量累加至所选仓库的库存中,并自动重新汇总更新商城前台该商品的总库存;已入库的单据锁定不可删除,请务必核对数量无误后再确认“已入库”!
3.4 库存详情与出入库流水记录查询 菜单:仓储 -> 库存详情 (/wms/stock/index)
▼
  • 1进入【仓储 -> 库存详情】,可按商品名称、SKU 编码或关键字搜索所有商品规格的实时库存列表。
  • 2点击任意 SKU 的【库存记录 / 出入库明细】(对应接口 wms/get_product_record_list),系统会列出该 SKU 在各个仓库的每一次入库(input)与出库(output)单据流水、关联仓库、变动数量、单价及发生时间,账实一清二楚。
3.5 订单自动智能分配仓库与跨仓拆单机制详解 核心自动化逻辑:WmsServices::allocateOrder
▼

当餐厅客户在商城前端完成支付(或后台财务点击“线下立即支付”)后,系统无需人工手动建单,会自动执行以下智能分仓逻辑:

  • 1按库存量优先匹配仓库:系统遍历订单中的每一个商品 SKU,自动查询所有仓库中该 SKU 的当前可用库存,并按库存量从多到少降序排列。
  • 2自动跨仓补足与拆单:
    • 若单个仓库库存充足,则直接从该仓库扣减库存并生成 1 张出库单;
    • 若某商品在 A 仓库只有 3 箱,客户买了 5 箱,系统会自动从 A 仓分配 3 箱、再从有货的 B 仓分配剩余 2 箱;
    • 最终系统按分配到的不同仓库,每个仓库独立生成一张以 WA 开头的出库单(初始状态为 10 = 待拣货),自动带入客户的姓名、电话、收货地址、城市、邮编、预约送达日期(customer_appt_date)、预约送达时间段(customer_appt_time)及订单备注。
  • 3温层自动识别:系统自动检测出库单内的商品是否开启了“冷藏配送”,自动在出库单标注 常温、冷藏 或 混合。
3.6 出库配送管理 —— 第一步:仓库拣货确认(待拣货 -> 待出库) 菜单:仓储 -> 出库配送 (/wms/wastage/index)
▼
  • 1仓库操作员进入【仓储 -> 出库配送】,顶部状态栏会实时显示各状态单据数量(待拣货、待出库、待取货、配送中、配送失败、已完成),并支持按所属仓库(warehouse_id)和出库单号筛选。
  • 2切换到【待拣货 (10)】页签,点击出库单的【详情】查看该单需拣选的食材名称、规格 SKU、数量、温层要求及客户的预约送达时间。
  • 3仓库人员在货架完成实物拣货与打包后,在列表中勾选一张或多张已拣好的出库单,点击【确定拣货】按钮(对应接口 wms/wastage/picking)。
  • 4系统自动记录拣货完成时间(picking_time),并将出库单状态更新为【待出库 (20)】。
3.7 出库配送管理 —— 第二步:选择配送方式与指派送货司机(待出库 -> 待取货) 菜单:仓储 -> 出库配送 -> 【待出库】页签
▼
  • 1在【仓储 -> 出库配送】切换到【待出库 (20)】页签。
  • 2支持单选或按相同配送片区批量勾选多张出库单,点击【选择配送】按钮(对应接口 wms/wastage/delivery)。
  • 3在弹出的配送方式窗口中选择:
    • 1. 司机配送 (type = 1,最常用):从下拉框中选择负责该路线的送货司机(driver_id)并确认。提交后,出库单状态变为【待取货 (30)】,并即刻出现在该司机的手机配送端【待取货】列表中;
    • 2. 快递发货 (type = 2):选择第三方快递公司(delivery_name)并填写快递单号(delivery_id),状态直接完成出库(90);
    • 3. 无需物流/客户自提 (type = 3):直接确认完成出库(90)。
3.8 司机管理(创建司机账号、车牌绑定与配送任务监控) 菜单:仓储 -> 司机管理 (/wms/driver/index)
▼
  • 1新增送货司机:进入【仓储 -> 司机管理】,点击【添加司机】,填写:
    • 司机头像 (avatar) 与 司机姓名 (nickname);
    • 手机号码 (phone,必填且唯一):作为司机登录司机端的账号;
    • 登录密码 (password):6~20 位字母、数字或符号(0-9a-z_$);
    • 车牌号码 (car_number) 与 备注 (remark);
    • 状态 (status):设为“开启 (1)”。
  • 2查看司机配送任务与签收凭证:在司机管理列表中,点击某位司机的【司机任务 / 详情】(接口 wms/driver/task),后台管理员可实时查看该司机名下所有配送单的当前状态、取货时间、客户电子签名图片及现场交货照片。

四、送货司机配送端操作说明(移动端 H5 / 司机 APP)

司机端入口:/driver
4.1 司机端登录、多语言切换与 GPS 实时位置上报 司机端路径:/driver -> 登录页
▼
  • 1司机在手机浏览器打开 https://您的域名/driver 或打开司机专用 APP。
  • 2右上角支持一键切换界面语言(English / 中文等,与后台语言包实时同步)。
  • 3输入后台【仓储 -> 司机管理】为其开通的手机号码 (phone) 和密码 (password) 点击登录(注意:若司机账号在后台被停用,登录会提示账号已禁用)。
  • 4登录后请允许浏览器/APP 获取手机定位权限(Location),司机端会自动调用 user/set_location 上报当前经纬度坐标,并反解出当前所在街道地址。
4.2 查看配送任务列表与装车【确定取货】(待取货 -> 配送中) 司机端路径:任务列表 -> 【待取货】页签
▼
  • 1司机登录后,首页顶部展示 4 个任务状态页签及对应单量角标:待取货 (30)、配送中 (40)、配送失败 (50)、已完成 (60)。
  • 2在仓库装车时,切换到【待取货】页签,每张卡片清晰展示:
    • 出库单号(WA...)、取货仓库名称、温层标识(常温 / 冷藏 / 混合);
    • 餐厅客户名称、联系电话、收货地址、预约送达日期与时间段;
    • 实时车程测算:系统自动通过 Google Maps Distance Matrix API 计算并显示司机当前位置距离该餐厅的驾车里程 (delivery_distance) 与预计行驶时间 (delivery_duration)。
  • 3核对货品装车无误后,可勾选单张或多张配送单,点击【确定取货】(接口 order/pickup)。
  • 4系统自动记录司机取货时间戳(driver_pickup_time),单据状态立即转入【配送中 (40)】。
4.3 一键开启 Google Maps 路线导航与一键拨打客户电话 司机端路径:任务详情页
▼
  • 1在【配送中】列表点击任意配送单进入【配送单详情页】。
  • 2详情页内嵌/提供 Google Maps 驾车路线导航链接(map_directions_url),点击【地图导航】按钮即可直接拉起 Google Maps 从司机当前坐标导航至餐厅客户收货地址。
  • 3点击客户手机号旁边的【拨打电话】图标,可直接呼叫餐厅收货人确认卸货位置。
4.4 送达餐厅:客户手写电子签名 + 现场拍照上传完成签收(配送中 -> 已完成) 司机端路径:【配送中】详情页 -> 签收确认
▼

货品送达餐厅并由后厨/收货人清点无误后,司机在【配送中】详情页执行标准电子签收流程(接口 order/sign/:id):

  • 1手写电子签名 (sign_image,必填):请餐厅收货人在手机屏幕的手写签名板上直接手写签名(系统自动生成签名图片上传)。
  • 2填写签收人姓名 (sign_name,必填):输入餐厅实际签收人的姓名。
  • 3拍摄上传现场交货/签字单照片 (sign_photo,支持多图):点击拍照按钮,拍摄摆放在餐厅后厨的食材实物照片或纸质送货签字单照片上传留证。
  • 4填写签收备注 (sign_remark,选填):如有特殊交接说明可备注。
  • 5点击【确认签收】,该单据状态立即变为【已完成 (60)】(自动记录精确签收时间 driver_sign_time),后台【仓储 -> 出库配送】同步更新并可随时查阅签名与照片凭证。
✅ 签收防呆校验:为防止虚假签收或日后扯皮,系统强制校验“手写电子签名图”与“签收人姓名”两项必填,缺一不可提交。
4.5 异常情况处理:提交【配送失败】与【再次配送】闭环 司机端路径:【配送中】详情 -> 配送失败 / 【配送失败】页签 -> 再次配送
▼

若司机到达餐厅时遇到餐厅未开门营业、电话无人接听、地址有误或客户临时要求改期等突发状况:

  • 1上报配送失败:在【配送中 (40)】详情页点击【配送失败】按钮(接口 order/transit),填写具体的失败原因说明(content,必填,如“10:30到达门店未营业,电话3次无人接听”),提交后单据转入【配送失败 (50)】页签,并记录异常时间(driver_delivery_time),后台调度员可同步看到失败原因。
  • 2发起再次配送:当与客户重新沟通确认可送货后,司机在【配送失败 (50)】页签找到该单,点击【再次配送】按钮(接口 order/re_delivery/:id),单据状态立即恢复为【配送中 (40)】,送达后即可正常办理手写电子签名签收!
4.6 历史已完成配送单按日期查询 司机端路径:【已完成】页签
▼

司机切换到【已完成 (60)】页签后,可通过顶部日期选择器(date)按具体日期筛选自己每日完成的配送单量及每笔订单的签收详情,方便司机核对每日出车工作量。

五、常见问题排查与实操问答速查库(FAQ)

问题检索速查
Q1 为什么客户订单已经付款成功了,但在【仓储 -> 出库配送】里没有生成出库单? 高频问题 · WMS联动
▼

原因分析:系统在订单支付成功后调用 WmsServices::allocateOrder 自动生成出库单时,会去查询 eb_wms_warehouse_stock(WMS分仓库存表)。如果你只是在【商品 -> 商品管理】里直接填了库存数字,而没有通过【仓储 -> 采购入库】办理入库单,那么 WMS 分仓库存为 0,系统不知道该从哪个仓库发货,导致无法分配出库单。

解决方法:
1. 先确认【仓储 -> 仓库管理】里已建好仓库;
2. 进入【仓储 -> 采购入库】新建入库单,选择仓库并添加该商品 SKU,将状态选为“已入库”保存;
3. 以后所有商品库存的新增,都统一通过【仓储 -> 采购入库】操作,它会自动同步更新商城前台库存。

Q2 为什么在【仓储 -> 采购入库】里添加了入库单,商品库存却没有增加? 高频问题 · 采购入库
▼

原因分析与解决:
1. 检查入库单状态:请看该入库单的状态是否为“未入库”。状态为“未入库 (0)”时仅作为草稿保存,不会增加库存;只有点击编辑将状态改为“已入库 (1)”并保存后才会触发加库存。
2. 检查队列进程:入库加库存由队列任务 WmsJob::storageIncStock 执行,若服务器开启了异步 Redis/数据库队列,请确保后台队列监听进程(php think queue:listen 或 Workerman 服务)处于运行状态。

Q3 为什么在【采购入库】里点击删除入库单时报错提示无法删除? 采购入库规则
▼

原因说明:为了保证仓库库存账实一致,系统规定只有“未入库 (0)”草稿状态的入库单才允许删除。一旦入库单状态变为“已入库 (1)”,库存已经累加到仓库和商城商品中,因此禁止删除。

Q4 为什么客户只下了一笔订单,【仓储 -> 出库配送】里却生成了 2 张或多张 WA 开头的出库单? 自动拆单规则
▼

原因说明:这是系统的跨仓库智能自动拆单功能。当一笔订单中包含的多个商品存放在不同仓库(例如牛排在“冷藏仓”、餐盒在“常温仓”),或者某个商品在 A 仓库存不足、系统自动从 B 仓调拨补足剩余数量时,系统会按不同发货仓库自动拆分为多张出库单,方便不同仓库各自独立拣货与安排车辆。

Q5 如何让出库单和司机配送单上显示“冷藏”或“混合”温层提醒? 冷链温层配置
▼

操作方法:进入后台【商品 -> 商品管理】,编辑需要冷链运输的商品,在商品信息中将【冷藏配送 (is_cold_delivery)】设为开启并保存。这样包含该商品的出库单就会自动标记为“冷藏”或“混合”温层。

Q6 采购入库时如何使用扫码枪扫描商品条形码快速录入? 扫码枪操作
▼

操作步骤:
1. 先在【商品 -> 商品管理】编辑商品规格属性时,在规格表格的【条形码 (bar_code)】列填入该包装箱上的条形码数字并保存;
2. 在【仓储 -> 采购入库】新建入库单时,将鼠标光标点击到条码扫描输入框,用扫码枪对准商品条码滴一下,系统即自动调用 wms/scan_barcod 匹配并添加该商品到入库列表中。

Q7 司机端为什么看不到与餐厅客户之间的距离(Distance)和预计车程时间(Duration)? 司机端 · Google定位
▼

排查方法:距离和预计耗时需要“司机当前经纬度”与“客户收货地址经纬度”两个坐标同时存在才能由 Google Maps API 计算得出:
1. 请检查司机手机浏览器或 APP 是否已授予位置定位权限(GPS),并在司机端触发了位置上报;
2. 请检查客户填写的收货地址是否为真实有效的街道地址(系统能够解析出 customer_latitude 和 customer_longitude)。

Q8 司机在送货时误点了【配送失败】,或者客户重新约了时间,怎么继续配送并签收? 司机端 · 二次派送
▼

解决方法:司机只需在司机端切换到【配送失败】页签,找到该笔配送单,点击【再次配送】按钮,该单据就会立刻回到【配送中】页签,之后即可正常上传客户手写电子签名完成签收。

Q9 司机端登录提示密码错误,或者司机忘记了登录密码怎么办? 司机账号维护
▼

解决方法:后台管理员进入【仓储 -> 司机管理】,找到该司机点击【编辑】,在密码栏直接输入一个新的 6~16 位密码(仅限字母、数字或 _、$)并保存即可重置司机密码(若不修改密码则留空即可)。同时确认司机的状态开关为“开启”。

Q10 客户通过线下支票(Check)或银行转账付款后,后台怎么把订单改成已付款并推送到仓库拣货? 财务收款操作
▼

操作方法:进入后台【订单 -> 订单管理】,找到该笔未支付订单,点击右侧操作列中的【立即支付】(线下确认收款)。确认后订单状态立即变为“已支付/待发货”,同时系统会自动触发 WMS 库存分配并生成待拣货出库单。

Q11 如何为某一家长期合作的餐厅客户设置专属全场折扣(例如全场 92 折)或预先充值授信额度? B2B客户管理
▼

操作方法:
• 设置全场折扣:先在【用户 -> 用户等级】里创建一个等级(如“VIP签约餐厅”,折扣设为 92),然后在【用户 -> 用户管理】找到该客户,点击操作列【更多 -> 赠送会员等级】选择该等级即可。
• 充值预付款/授信余额:在【用户 -> 用户管理】找到该客户,点击操作列【更多 -> 修改积分余额】,在余额项选择“增加”并输入金额即可。

Q12 如何给仓库员工开通一个只能操作【仓储】出入库、看不到商城财务和系统设置的后台账号? 权限隔离配置
▼

操作步骤:
1. 进入【设置 -> 管理权限 -> 角色管理】,点击【添加身份】,角色名填“仓库操作员”,在权限列表中只勾选【仓储】下的菜单,保存;
2. 进入【设置 -> 管理权限 -> 管理员列表】,点击【添加管理员】,填写仓库员工的登录账号和密码,身份勾选“仓库操作员”保存即可。

Q13 如何修改前端或司机端的英文/多语言翻译词条?为什么改了语言词条前台没变化? 多语言配置
▼

操作方法:进入【维护 -> 语言设置 -> 语言详情】,搜索中文原词或对应译文进行修改并保存。保存后请前往【维护 -> 安全维护 -> 刷新缓存】点击刷新缓存,客户端刷新页面或重新切换一次语言即可加载最新词条。

Q14 如何设置食材的“最小起订量”(例如某种冻肉最少 5 箱起买)? 商品起订量
▼

操作方法:在【商品 -> 商品管理】中添加或编辑该商品,找到【起购数量 (min_qty)】字段,将其填写为 5 并保存。客户在前台加购该商品时,最低购买数量即为 5 箱。

Q15 客户退货回来的商品,后台同意退款后,仓库库存会自动加回去吗? 售后退货入库
▼

处理规范:因为生鲜食材退货可能存在损耗或报废(不一定能二次销售),所以后台【订单 -> 售后订单】完成退款后,需要由仓库人员在实物验货后决定是否重新入库。若食材完好可二次销售,请仓库人员在【仓储 -> 采购入库】新建一张入库单,入库类型选择【退货入库 (REFUND)】,设为“已入库”即可将完好数量加回对应仓库。

Q16 服务器上需要开启哪些后台常驻服务才能保证消息推送、自动任务和队列正常运行? 运维与服务进程
▼

在服务器项目根目录下,建议保持以下进程运行(Windows 可双击根目录 workerman.bat,Linux 可使用 Supervisor 守护):

  • 1Workerman 长连接与聊天服务:php think workerman start --d(用于后台订单实时提醒弹窗、在线客服即时通讯);
  • 2定时任务服务:php think timer start --d(用于订单超时自动取消、自动收货等定时任务);
  • 3消息队列服务:php think queue:listen --queue(用于处理 WMS 入库异步加库存、批量发货、群发优惠券等异步任务)。
🔍

未找到匹配的说明条目

请尝试更换简短的关键词(如“入库”、“出库”、“拆单”、“司机”、“签收”、“冷藏”、“退款”、“发票”、“多语言”)或点击上方“全部条目”。

🤖 BULK CHEF AI 助手 仅限本系统知识库

👋 您好!我是 BULK CHEF 系统专属 AI 操作顾问。

本知识库限定在本系统的前后端、WMS 仓储与司机端操作规范及代码框架内。遇到任何操作疑问,请直接用自然语言问我,我会为您提供分步最佳解决方案!

⚙️ 配置 AI 账号(仅需 1 个 API Key)
💡 两种配置方式任选其一:
1. 服务器统一配置:编辑网站目录下 public/ai_assistant.php 第 26 行填入 api_key,所有访问人员开箱即用;
2. 当前浏览器配置:直接在下方填入您的 API Key 保存即可(支持离线双击打开 HTML 直接调用 AI)。
若您已在服务器 public/ai_assistant.php 中配置好密钥,此处可留空。