酒水/快消经销渠道运营系统产品系统

本平台为酒水/快消经销渠道运营系统：微信小程序（业务员/配送现场作业）+ 管理后台（合同/销量/返利结算）+ Java 后端（对接 ERP/支付/对象存储）。

端侧分工：
- 微信小程序：业务员、司机/配送、临期岗、管理层；客户、下单、配送、收款、陈列/促销、销售看板
- 管理后台：运营/财务/采购；合同、销量提报、上下游返利、核销兑付、采购发运、应收、审批与主数据
- 后端服务：统一业务 API、定时任务、审批流、ERP 同步、银行收款与附件存储

1）主数据与合同
- 客户/门店、物料套餐、渠道与供应商
- 多类型合同（固定返利、扣减、增投等）及结算周期、投入档位/方案

2）订货、采购与现场作业
- 小程序购物车下单、陈列申请/促销、配送与角色工作台
- 管理端订单、采购/发运/退货、对账付款

3）销量与返利结算
- 按合同周期从 ERP 出入库汇总销量、空合同/无有效期跳过
- 上下游返利单 → 费用 → 兑付 → 核销；固定返利周期生成与兑付报表

4）应收收款与资金闭环
- 到账/预收/现金；小程序二维码收款与上传凭证
- 支付流水登记；兑付/费用按需下推 ERP

5）审批与平台能力
- Flowable 审批、权限菜单、定时任务、附件与导入导出

1. 职责范围
本人独立负责本项目全栈开发与运维（后端 + 管理端 + 小程序），含需求落地、联调上线、问题修复与迭代优化。

主要负责模块：
- 合同与费用：固定返利周期结算、增投档位累计费用、合同有效期与销量月交集筛选
- 返利闭环：上下游返利、费用生成/重算、兑付（含物料兑付）、核销（含负数与到账单关联）
- ERP 对接：销量取数状态统一、兑付单审批后手动/批量下推及备注口径
- 订货与采购：套餐/发运退货口径、付款上期结余；小程序下单防重复、撤销、陈列申请
- 收款与运维：扫码收款链路、支付流水、导出报表、空态/精度类缺陷治理

2. 技术与架构
- 形态：Maven 多模块单体（平台能力 + 业务模块），对外多端共用一套 API
- 分层：Controller → Service（事务）→ MyBatis Mapper；管理端动态菜单权限；小程序按角色工作台
- 数据与任务：MySQL 主库 + Redis 缓存/会话；Quartz 定时；Flowable 审批
- 核心集成：K3 Cloud 适配层；银行收款回调写交易流水后再落业务/ERP；OSS 附件；微信会话登录

3. 实现亮点
- 返利全链路：销量提报 → 返利/费用 → 兑付 → 核销，管理端与 ERP 口径可对账
- 固定返利周期引擎：按月/季/年结算月生成费用，兼容现有上报节奏，避免非结算月误生成
- 增投档位幂等：上下游达标分别计费，累计明细 + 来源类型防重复出费
- 可控 ERP 下推：兑付审批后手动/批量同步，跳过已推明细，备注带合同标识，降低误推风险
- 金额与空态治理：核销/兑付支持负数纠偏；赠酒为空、精度误提示、无有效销量合同跳过等边界处理
- 现场收款闭环：小程序多模式收款 + 后端交易登记，支撑业务员/配送一线作业与后台核销联动