它解决的三件事
客户价格和可见商品隔离
等级价、专属价和包装换算由服务端确定，下单前获取最新报价；价格变化需重新确认，客户不能借接口查看别人的价格。
库存、信用和发货对得上
确认订单时一起校验可用库存与信用，成功才预占；部分发货、取消未发和退货均保留独立流水与幂等保护。
分清预收、应收与核销
发货才形成应收，收款登记后按单分配；原价退货冲减原单，多核销先解除，实际线下退款另记，不把登记说成银行到账核验。
三端分别能做什么
同一套服务端，不同账号只访问自己的角色范围。H5 可按演示入口体验，App 与小程序的配置、安装和发布状态分别验收。
订货与财务后台
老板、销售、仓库、财务，按角色授权
- 客户建档与审核、账期信用、等级与专属价格
- 商品图片、固定单位换算、初始库存和调整原因
- 销售代客下单、确认预占、分批发货及退货审核
- 实际线下收款、指定订单核销、退款登记和完整月度分录 CSV
仓库端
仓库员工，H5 / App 资源共用手机界面
- 查看有权限的待发订单和包装数量
- 按本次实际数量分批发货，填写物流公司与单号
- 不直接改客户价格、信用和财务核销
客户订货端
已审核门店客户，独立账号登录
- 浏览本客户可见商品和价格，采购车及地址管理
- 取得最新报价并确认，查看每批物流和签收
- 申请退货、查看订单与月度往来账本
适合谁
- 办公、清洁耗材等单供货企业，为固定客户供货
- 固定包装单位、单仓、账期或先款客户的轻量批发业务
- 面向开发者二开与部署；不是综合进销存或多商户平台
不包含
- 在线支付、真实银行到账校验、自动资金清算
- 多商户分账、多仓、生鲜称重和批次效期
- 完整 ERP、财务总账与税控开票
要你自己准备的
- 独立服务器、域名和 HTTPS；初始化脚本生成自己的密码和密钥，不沿用公开演示账号。
- 安卓原生打包需要自己的 DCloud AppID/AppKey 与签名；小程序如需发布，另备自己的 AppID、合适类目及合法域名。
- 按真实经营主体配置协议、隐私及业务参数；上线前验证实际角色流程和备份恢复。
- 采用账号、密码和图形验证码，首次登录需按策略修改密码。
- 收退款为财务核实后的线下记录，不自动划转资金。
- 当前列表单次最多 500 条，规模扩大时需补充分页与历史检索验收。
技术与交付文档
- 服务端：Spring Boot 3.5.16、Spring Security、MyBatis、Flyway；Java 编译目标 17，Docker 运行 21。
- 管理端：React 19、TypeScript、Vite 8、Tailwind CSS 4 与 shadcn；独立角色和业务权限。
- 手机端：uni-app + Vue 3，H5 与 App 共用真实 API；MySQL 8.4、Redis 7.4，Docker Compose 部署。
默认 App 名称：澄川订货。完整源码、初始化与维护文档随包交付；安装包和小程序上架分别验收。
演示入口
演示数据定时恢复，请勿填写真实资料。带在线支付业务的产品使用演示通道，不产生真实扣款；线下收款类产品只记录演示账目。小程序需要在你自己的 AppID 下发布，演示请用 H5 或安卓 App。
小批发订货与对账
后台账号
- 销售
wh_sales公开普通演示账号，不能管理系统安全设置
密码Demo#2026wh以上账号通用
客户端
- 订货客户
buyer01密码同上，已审核标准客户
- 客户用独立账号、密码及图形验证码登录，非手机号短信注册。
- 仓库使用员工账号进入仓库工作台；首次登录按策略修改密码。
自动化测试
小批发订货与对账
- 真实业务接口
- 32 项真实 HTTP，另验 CSV
- 服务端测试报告
- 138 执行通过，5 可选跳过
- 管理端单元测试
- 75 项管理端单测
覆盖库存与信用并发、客户价隔离、部分发货、核销和退货；服务端数量包含公共底座。未做压力测试，不代表银行或线上支付验收。
以上均为本地隔离环境的验证结果，按实际测试类型分列，不与旧六套安全审计数字合并，也不保证没有缺陷。