1. 项目概述Java商品采购管理系统是一个面向中小型企业采购流程管理的开源解决方案。这个系统我前后迭代开发了三年多最初是为了解决朋友服装厂混乱的采购台账问题后来逐渐演变成一个通用的采购管理平台。它用最朴实的Java技术栈解决了企业采购中最头疼的三不清问题供应商往来不清、库存变动不清、资金流向不清。系统采用经典的B/S架构前端用Thymeleaf模板引擎实现动态页面后端基于Spring Boot框架数据库选用MySQL 8.0。之所以选择这套技术组合是因为它既保证了开发效率又能满足中小型企业200-500TPS的并发需求。我在多个客户现场实测单服务器配置4核8G下可稳定支持50人同时操作。2. 核心功能解析2.1 供应商全生命周期管理系统为每个供应商建立独立档案包含基础信息、合作历史、评估记录三大部分。其中评估模块采用加权算法质量40%交期30%价格20%服务10%自动生成供应商等级。这里有个设计细节评估数据不允许手动修改必须关联具体的采购订单和质检记录防止人情分。供应商准入流程特别加入了黑名单联动机制。当在工商信息核验接口发现供应商存在经营异常时系统会自动触发风控流程。这个功能我们接入了天眼查的免费API每天有1000次的免费查询额度对中小企业完全够用。2.2 智能采购申请流程传统的采购申请最大的问题是审批流与库存脱节。我们的解决方案是申请单自动关联库存数据设置安全库存阈值预警支持按需采购和定额补货两种模式特别要说明的是阈值计算算法安全库存 日均消耗量 × 采购周期 × 波动系数(1.2-1.5)这个公式是我们调研了32家制造企业后总结的黄金比例在系统里可以按物料类别设置不同的系数。2.3 采购订单自动化订单生成环节实现了三个自动化自动比价从历史订单和供应商目录中提取最近3次有效报价自动条款根据供应商等级应用预设的付款条款和质保要求自动预警交期前3天提醒跟单逾期自动触发督办流程开发时踩过一个坑最初比价逻辑只取最低价结果导致质量事故。后来改进为最优价算法综合考虑价格、交期和供应商等级。3. 技术实现细节3.1 架构设计系统采用分层架构但做了些针对性优化表现层Thymeleaf Bootstrap 应用层Spring Boot 2.7 Spring Security 业务层自定义采购引擎 规则引擎 数据层MyBatis-Plus MySQL 8.0特别要提的是采购引擎的设计它把采购流程抽象为状态机public enum PurchaseStatus { DRAFT, // 草稿 APPROVING, // 审批中 APPROVED, // 已批准 ORDERED, // 已下单 PART_RECEIVED, // 部分到货 COMPLETED, // 已完成 CANCELLED // 已取消 }状态转换通过Spring StateMachine实现每个转换都可以插入业务逻辑。3.2 核心表结构设计采购系统的表关系比较复杂主要解决了三个问题单据版本控制防止修改历史记录审批链追溯物料多单位转换关键表包括CREATE TABLE purchase_order ( id bigint NOT NULL AUTO_INCREMENT, order_no varchar(32) NOT NULL COMMENT 订单编号, supplier_id bigint NOT NULL, total_amount decimal(12,2) NOT NULL COMMENT 含税总金额, status varchar(20) NOT NULL COMMENT 状态, payment_terms varchar(255) DEFAULT NULL COMMENT 付款条款, creator_id bigint NOT NULL, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, update_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_order_no (order_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;3.3 报表性能优化采购分析报表涉及大量历史数据聚合我们采用了三种优化手段预聚合每日凌晨跑Job生成统计快照读写分离报表查询走从库缓存策略使用Redis缓存热门供应商的年度合作数据对于千万级数据量的客户建议增加ClickHouse作为分析型数据库。我们在某个客户现场实测同样的年度采购分析报表MySQL需要12秒ClickHouse只要0.8秒。4. 部署与二次开发4.1 最小化部署方案对于预算有限的客户推荐以下配置服务器2核4G云主机实测可支撑20人团队数据库阿里云RDS MySQL基础版中间件Redis 6.x单节点部署步骤安装JDK17导入SQL脚本修改application-prod.yml配置启动Spring Boot应用有个易错点MySQL需要显式设置时区否则日志时间会错乱spring.datasource.urljdbc:mysql://localhost:3306/purchase?useSSLfalseserverTimezoneAsia/Shanghai4.2 扩展开发建议系统预留了多个扩展点供应商评估插件接口审批流程自定义钩子数据导出适配器以微信通知为例实现流程Service public class WechatNotifier implements ApprovalEventListener { Override public void onApprovalEvent(ApprovalEvent event) { // 调用微信接口发送通知 } }5. 常见问题解决方案5.1 性能问题排查症状审批页面加载慢排查步骤检查是否关联查询过多确认审批历史表是否有索引查看Nginx是否开启gzip压缩解决方案给审批流关联查询添加覆盖索引ALTER TABLE approval_flow ADD INDEX idx_form_type_status (form_type, form_id, status);5.2 数据一致性问题典型场景库存扣减异常根本原因并发更新导致解决方案采用乐观锁控制Update(UPDATE inventory SET stock stock - #{qty}, version version 1 WHERE sku_id #{skuId} AND version #{version}) int deductStockWithVersion(Param(skuId) Long skuId, Param(qty) Integer qty, Param(version) Integer version);6. 开源项目运营经验这个项目在GitHub上收获了1200星过程中总结了三点经验文档比代码重要 - 我们维护了中英文双语文档包含视频教程Issue分类处理 - 使用模板引导用户提供完整信息版本规划透明 - 公开Roadmap收集社区意见特别提醒开源项目要特别注意license选择。我们最终采用LGPL-3.0既保证了开源性又避免了商业滥用。
