本项目面向消费品经销/分销场景，解决公司内部「下单、审批、发货协同、客户账余」分散在表格和多个系统里、容易对不上账的问题。业务上，内勤/业务员要给线上线下客户下销售单、换货、补发、退货；商品主数据与库存在聚水潭维护，本系统负责价格档位、客户层级绑定、订单审批与资金池扣减；发货由聚水潭履约，本系统需同步订单状态与快递单号。同时客户有专属打款账号，到账后需自动入账到账余资金池，供后续下单冻结与结算。项目目标是把「客户档案—商品价格—订单工作台—审批流—资金池—仓储发货」串成闭环，减少人工对账和漏审、错价、资金超用风险，服务公司内部少量员工日常作业。
系统为公司内部管理后台，主要模块包括：
员工与角色：账号由管理员维护，基于 RBAC 配置菜单与操作权限，支持角色分配与密码重置。
字典管理：维护客户层级、业务枚举等可配置属性。
客户管理：客户档案、多地址（含默认地址）、发票信息库，支持查询与 Excel 导出。
商品管理：从聚水潭同步商品/库存；本地维护多档价格与客户层级绑定；改价、绑层触发审批后方可生效。
订单工作台与售后：支持销售订单、售后换货、售后补发、退货单；可保存草稿或提交审批；关联原单、批量导入商品、按客户层级自动匹配价格，并实时拉库存。
审批中心与审批引擎：可配置审批链路（版本化）；支持待我审批/我发起的/历史；业务自动触发（订单、改价、绑客户等）与手动触发（返利、提前入账资金池、发票申请）；驳回可修改重提；审批结果通过事件驱动后续业务。
消息中心：对接飞书，向审批人/发起人推送通知。
资金模块：客户账余资金池、返利资金池（可用/冻结）；订单审批通过后冻结、发货后结算、取消解冻；退货入账；对接招商银行到账回调自动入账。
仓库与订单状态同步：仓库信息维护；订单推送聚水潭后轮询/手动同步状态，已发货写入物流单号。
审计与文件：关键操作可审计；发票等文件对接对象存储。
整体主链路：工作台下单 → 审批 → 同步聚水潭 → 状态回写 → 资金池变更，实现经销出货业务的线上化闭环。
本人主要负责该系统的业务落地与联调，包括：后端模块拆分与接口实现、订单/审批/资金联动逻辑、与聚水潭订单与商品同步、飞书消息推送、招行到账回调入账，以及前端订单工作台、审批中心、客户/商品等页面的对接与联调。
技术栈：前端 React + Vite + Ant Design；后端 Spring Boot 3、MyBatis-Plus、MySQL 8、Sa-Token（RBAC）；本地事件用 Spring ApplicationEvent，审批结束采用事务提交后异步监听，解耦订单建单、价格生效、资金池变更；文件侧对接阿里云 OSS。
实现重点与难点：
1）订单状态机与聚水潭中间态映射，发货前取消需先查实时状态防超发；
2）资金池「可用/冻结」与审批通过、发货结算、退货确认的一致性，避免超用与重复入账；
3）审批模板版本化，保证在途实例不受新链路影响；
4）改价/绑层/发票等跨模块流程用事件驱动，保证审批与业务结果最终一致。
MVP 以小团队内勤使用为主，优先正确性与可维护性，复杂链路保留扩展点便于后续增强。
评论