# 算数·酒水分销 — 完整产品参考（llms-full.txt）

> 供 AI 助手与搜索引擎做深度引用的长文本版本。摘要见 llms.txt，智能体索引入口见 ai.txt。
> 本文件描述的能力与演示环境实际菜单一一对应，可在演示站点逐项点开验证。

## 一、产品定位

算数·酒水分销（仓库名 daili-jiushui），是面向**酒水、软饮料、啤酒、乳饮等快消品地区总代理 / 经销商 / 区域分销商**
的一体化经营管理系统。它要解决的不是「记账」，而是酒水这门生意特有的几处失血点：

- 商品有**保质期与批次**，压货压错批次就是直接损耗；
- 客户是**餐饮、烟酒店、商超、团购单位**，渠道价格与账期完全不同；
- 交付靠**自有货车按线路跑**，答应的到货日必须盯住；
- 退回来的货（拒收、退货、换货、破损）**必须有单据**，否则月底对不上；
- 老板要的是**一套口径的数字**，不是三张互相对不上的报表。

## 二、业务闭环

采购进货 → 库存仓储 → 客户拜访 → 销售开单 → 排线配送 → 签收 / 拒收 → 回款结算
　　　　　　　　　└──────── 逆向回流（退货 / 拒收 / 换货 / 报损 / 报废 / 召回）────────┘

## 三、模块明细

### 1. 产品与价格
- 产品档案：名称、规格、品牌、单位、条码、分类
- 酒水行业属性：酒精度、产地、箱规、保质期天数
- 价格体系：零售价、团购价、成本价三级；成本价按角色屏蔽
- 组合与搭赠：用于铺市搭赠与促销档期

### 2. 客户与渠道
- 客户类型：餐饮门店、烟酒店、商超 / 大卖场、团购单位、其他
- 客户档案：联系人、电话、地址、配送线路、结算方式与账期
- 客户等级与区域权限：区域经理只看本区域
- 拜访管理：GPS 打卡、拍照上报、拜访记录与跟进结果

### 3. 采购进货
- 采购订单：下单、审批、到货、入库质检
- 收货入库：按批次录入生产日期与到期日，写入批次台账
- 采购退货：退回供应商，同步冲抵应付
- 供应商往来：应付账款与付款计划

### 4. 库存仓储
- 多仓库存：主仓 / 分仓 / 前置仓，可调拨
- **库存三本账**：库存台账（stocks）、批次在库（stock_batches）、库存流水（stock_logs）实时联动
- 保质期管理：临期与过期双预警，出库按到期日先进先出（FIFO）
- 盘点与报损：盘点差异、报损按成本价计入经营损耗
- 库存流水：每一次出入库都可追溯到具体单据

### 5. 销售与开单
- B 端销售订单：客户 + 商品明细 + 数量 + 价格 + 交期 + 结算方式
- 销售订单编号规则：`XS` + 日期 + 四位流水
- 销售出库：按订单出库，扣减库存并写流水与批次
- 商城订单：C 端订单与 B 端同库，可在后台查看与处理
- 订单状态全链路：待确认 → 已确认 → 出库中 → 已出库 → 已送达 / 已取消

### 6. 交付履约（重点模块）
- **承诺送达日期 + 交付状态**：待排线 → 待配送 → 配送中 → 已送达 / 待自提 → 已自提
- **交货期看板**：逾期、今日必达、按线路负载、未来 7 天日历四种视角
- **配送调度台**：按线路 / 时段 / 配送员排线，支持批量排线与批量发车
- 签收留痕：签收人、签收时间、送达照片
- 超期未达自动进入预警清单
- 全站逾期判定只有一处实现，看板、列表、详情口径完全一致

### 7. 逆向流程（重点模块）
- 六类逆向单据：**退货、拒收、换货、报损、报废、召回**
- 状态机：待审核 → 已审核 → 已入库 → 已完成（审核前不动库存与资金）
- 库存联动：退货回库写入库存与批次流水并校验保质期；换货「收旧 + 补新」净额为零但留两条可追溯流水
- 资金联动：
  - C 端：退会员钱包，回写订单已退金额与售后状态
  - B 端：冲抵客户应收账，不出现金
  - 供应商退货：同步冲抵应付
- 拒收入口：配送签收环节验收不合格，一键生成拒收单并回写订单售后状态

### 8. 财务与回款
- 应收与回款计划、逾期清单
- 收款单 / 付款单、垫付与预算
- 佣金结算与提现审核（提现对采购角色不可见）
- 财务对账：按客户 / 按单据下钻

### 9. 陈列与设备
- 陈列上架 / 下架登记
- 冰柜、展架等设备借出与归还
- 押金登记与超期预警，避免设备流失

### 10. C 端会员分销商城
- 会员注册与登录（手机号）
- 两级分销关系与佣金计算
- 钱包充值、提现申请
- 酒票（提货券）发放与核销
- 商品浏览、购物车、下单（快递发货或到店自提）

### 11. 提货点门店端
- 门店入驻申请与审核
- 自提订单管理、6 位核销码核销
- 门店收款码
- 酒票核销

### 12. 经营看板（14 张）
销售看板、商品看板、补货看板、效期看板、应收看板、设备看板、任务看板、陈列看板、垫付看板、
库存看板、批次看板、库存流水看板、交货期看板、逆向流程看板。
看板 KPI 与明细表行均可点击下钻，最终回到原始单据。

### 13. AI 能力中心
分组与场景（共 19 个场景，8 个已跑通真实数据闭环）：

- 交易与订单：AI 下单（已实现）、AI 报价与议价建议、智能搭赠与凑单
- 交付与调度：AI 排线（已实现）、AI 路径优化与装载建议、AI 到货预约
- 任务与工单：AI 工单助手（已实现）、AI 盘点核对、AI 入库质检判级
- 库存与补货：AI 补货预测（样例已实现）、AI 临期处置（样例已实现）
- 客户与回款：AI 回款催收（样例已实现）、AI 客户流失预警（样例已实现）、AI 拜访总结、AI 陈列拍照识别、AI 话术陪练
- 经营问答：AI 经营问数（已实现）、AI 经营日报、AI 异常稽核

**实现口径与边界（对客户必须讲清楚）**
- 当前演示使用**本地规则引擎**：断网可跑、结果可复算、推理过程可解释，适合现场演示与业务验收。
- 接入真实大模型（通义千问 / DeepSeek / 私有化小模型）时，只替换「自然语言理解」这一层，
  页面与落库动作不变。
- AI 只产出**草稿与建议**，任何写入动作都必须人工确认，并写入操作审计日志。
- AI 读取的数据受当前登录人角色权限约束，不会额外放大数据可见范围。
- AI 不臆造价格与库存，缺失信息时追问而不是猜测。

## 四、角色与权限

| 角色 | 可见范围 |
| --- | --- |
| 超级管理员 | 全部模块、账号角色、支付参数 |
| 采购 | 采购、供应商、库存查询、补货看板；不可见佣金提现 |
| 销售 / 运营 | 商品、营销、订单发货、会员、门店审核、酒票；成本价屏蔽 |
| 财务 | 财务全模块、佣金结算、提现审核、收付款对账 |
| 仓管 | 库存出入库、盘点调拨、设备在库管理 |
| 区域经理 | 本区域客户、订单、拜访与看板（区域隔离） |
| 业务员（移动端） | 客户档案、GPS 拜访上报、任务、B 端开单、陈列上报 |
| 提货点门店 | 自提订单核销、酒票核销、门店收款码 |
| C 端会员 / 代理商 | 商城下单、分享赚佣、团队查看、钱包提现 |

## 五、技术形态

- 单体 Web 应用，服务端渲染，浏览器直接访问，无需安装客户端
- 移动端为 H5 自适应（业务员端 / 会员端 / 门店核销端共用一套代码）
- 数据库轻量（SQLite），可平滑迁移至 MySQL / PostgreSQL
- 支持云演示、本地私有化、专有云与子目录部署，数据可留在客户环境
- 宣传站与系统演示数据均按酒水行业规则生成，非占位数据

## 六、常见问题

**Q：这套系统适合什么样的酒水企业？**
A：酒水、软饮料、啤酒、乳饮等快消品的地区总代理 / 经销商 / 区域分销商。

**Q：跟通用进销存相比，酒水行业特有的地方在哪里？**
A：批次与保质期、临期过期预警、多仓调拨盘点、按客户类型差异化的价格体系、
配送排线与签收留痕、拒收当场转逆向、酒票与门店扫码核销。

**Q：能不能管住「答应的到货日」？**
A：能。每张销售单据都有承诺送达日期与交付状态，逾期判定全站唯一实现；
交货期看板提供逾期 / 今日必达 / 按线路负载 / 未来 7 天日历四种视角。

**Q：退货、拒收、换货这些逆向流程怎么做？**
A：六类逆向单据统一走状态机，审核通过才动库存与资金；
库存侧回写库存与批次流水并校验保质期，资金侧 C 端退钱包、B 端冲抵应收、退供应商冲抵应付。

**Q：AI 能力是真的还是概念图？**
A：19 个场景已完成设计，其中 8 个已跑通真实数据闭环，可在演示环境现点现算；
演示使用本地规则引擎，接入真实大模型只替换自然语言理解层。

**Q：支持私有化部署吗？可以先演示看看吗？**
A：支持云演示、私有化与子目录部署。演示环境已灌入整套酒水行业数据，
可跑通从进货到回款、从发车到签收退货的完整闭环。商务联系 18016313342（微信同号）。

## 七、联系与索引

- 厂商：算数科技 — https://zerocod.cn/
- 产品介绍：https://p.zerocod.cn/daili-jiushui/index.php?r=/intro
- 商务：18016313342（微信同号）
- 摘要：/daili-jiushui/public/llms.txt
- 智能体索引：/daili-jiushui/public/ai.txt
- 网站地图：/daili-jiushui/public/sitemap.xml