1. 立项原因
传统饮料行业合同管理依赖线下纸质流程，存在合同流转慢、审核周期长、模板不统一、经销商签约效率低等问题。本项目旨在构建一套完整的经销商合同全生命周期数字化管理系统，实现合同模板化管理、在线审核、电子签章及与ERP系统数据互通，大幅提升合同处理效率，降低运营成本。
2. 行业背景
快消品饮料行业具有经销商数量多、合同条款复杂、销售政策多样化（如搭赠、折扣、销售计划）等特点。经销商合同涉及年度签约、销售目标确认、促销政策执行等多个环节，需要支持多维度数据关联和全流程管控。本系统作为SaaS架构的B端业务管理服务，支撑经销商合同下发、审核、盖章、作废等核心业务流程，与DMS系统、ERP系统深度集成，形成完整的销售业务闭环。
1. 功能模块
事业部合同管理：支持事业部合同新增、编辑、审核、封存、下发
经销商合同管理：支持经销商合同创建、下发、审核、盖章、作废、退回、重来
年度签约清单：经销商年度签约计划分页查询与管理
合同模板填充：合同模板变量自动填充与PDF导出
冰柜确认函：冰柜相关合同附件管理与PDF导出
客户确认函：客户确认模板与确认状态管理
合同数据导入：批量导入合同相关数据
签章管理：签章公司/签章人管理，电子盖章流程
2. 主要功能描述
系统实现合同从创建、审核、下发、盖章到归档的完整闭环管理。支持多级审批流程、合同附件管理、在线电子签章、与ERP/DMS系统数据互通，并提供合同分页导出功能，提升合同处理效率与规范化管理水平。
项目实现
1. 技术栈
框架：Spring Boot + Spring Cloud Alibaba（微服务架构）
服务治理：Nacos（配置中心、服务注册与发现）
通信：OpenFeign（服务间HTTP调用）
数据库：MyBatis-Plus（ORM映射）、MongoDB（文档存储）
缓存：Redis + Redisson（分布式锁）
模板引擎：Freemarker（合同模板渲染）
PDF处理：PDFBox、iTextPDF、Spire.Doc（合同/确认函PDF生成）
电子签章：e签宝SDK（电子合同签署）
构建：Maven（多模块项目，VO包独立发布）
2. 架构亮点
SaaS微服务架构，支持多环境配置（dev/test/uat/prod/gs）
基于MapStruct实现DTO/VO对象映射转换
统一的权限认证体系（@AuthResource/@AuthOperation）
幂等性控制（@EnableRepeatValidate防重复提交）
VO模块独立打包，供其他服务依赖引用
3. 实现难点
合同模板变量动态填充与多格式PDF导出
电子签章流程与第三方e签宝系统对接
多系统数据集成（ERP销售计划、DMS经销商信息）
合同状态机流转与审批流程联动
评论