SpringBoot+Vue企业级供应商管理系统开发实战

1. 企业级供应商管理系统架构解析

这套基于SpringBoot+Vue+MyBatis+MySQL的供应商管理系统，是我在参与某大型制造企业数字化改造时沉淀下来的实战方案。不同于简单的CRUD系统，企业级供应商管理需要处理复杂的资质审核、绩效评估、合同生命周期管理等场景。系统采用前后端分离架构，后端SpringBoot提供RESTful API，前端Vue实现动态交互，MyBatis作为ORM层与MySQL数据库对接。

核心业务模块包括：

• 供应商准入管理（资质审查、黑名单校验）
• 采购合同全流程跟踪
• 供应商绩效KPI动态计算
• 多维度数据分析看板

技术栈选型上，SpringBoot 2.7.x提供了开箱即用的企业级特性如Actuator监控、Security安全机制；Vue 2.6配合Element UI实现响应式前端；MyBatis 3.5+MyBatis-Plus增强插件处理复杂SQL映射；MySQL 8.0支持JSON字段和窗口函数，满足分析报表需求。

关键设计原则：所有供应商数据变更必须保留操作日志，通过@Aspect实现审计切面，这是企业合规的基本要求

2. 环境搭建与项目初始化

2.1 后端工程配置

使用Spring Initializr生成项目骨架时，必须勾选：

• Spring Web (嵌入式Tomcat)
• MyBatis Framework
• MySQL Driver
• Lombok (简化POJO)

pom.xml需额外添加：

xml复制<!-- MyBatis-Plus 代码生成器 -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-generator</artifactId>
    <version>3.5.3</version>
</dependency>
<!-- 阿里数据源 -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid-spring-boot-starter</artifactId>
    <version>1.2.16</version>
</dependency>

数据库配置示例（application.yml）：

yaml复制spring:
  datasource:
    url: jdbc:mysql://localhost:3306/supplier_db?useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: 加密密码建议使用Jasypt
    type: com.alibaba.druid.pool.DruidDataSource
    druid:
      initial-size: 5
      max-active: 20
      validation-query: SELECT 1 FROM DUAL

2.2 前端工程搭建

通过Vue CLI创建项目时选择：

• Vue 2.x
• Router
• Vuex
• CSS Pre-processors (Sass)

关键依赖安装：

bash复制npm install element-ui axios vuex-persistedstate echarts --save

踩坑记录：Vue 2项目不要误装Vue 3版本的依赖，特别是Vuex和Router，会导致兼容性问题

3. 核心业务模块实现

3.1 供应商资质管理

采用RBAC模型控制权限，核心表结构设计：

sql复制CREATE TABLE `supplier_info` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '雪花算法ID',
  `name` varchar(100) NOT NULL COMMENT '供应商名称',
  `credit_code` varchar(18) UNIQUE COMMENT '统一社会信用代码',
  `qualification_files` json DEFAULT NULL COMMENT '资质文件URL数组',
  `audit_status` tinyint DEFAULT 0 COMMENT '0-未审核 1-已通过 2-已拒绝',
  `blacklist_reason` varchar(255) DEFAULT NULL,
  PRIMARY KEY (`id`),
  INDEX `idx_credit_code` (`credit_code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

MyBatis动态SQL示例：

xml复制<select id="selectByCondition" resultType="SupplierDTO">
  SELECT * FROM supplier_info
  <where>
    <if test="name != null and name != ''">
      AND name LIKE CONCAT('%',#{name},'%')
    </if>
    <if test="auditStatus != null">
      AND audit_status = #{auditStatus}
    </if>
    <if test="notInBlacklist == true">
      AND blacklist_reason IS NULL
    </if>
  </where>
  ORDER BY id DESC
</select>

3.2 采购合同管理

实现合同版本控制的核心逻辑：

java复制@Transactional
public void updateContract(ContractVO vo) {
    // 1. 将当前合同标记为历史版本
    contractMapper.updateStatus(vo.getId(), ContractStatus.HISTORY);
    
    // 2. 插入新版本记录
    Contract newContract = BeanUtil.copyProperties(vo, Contract.class);
    newContract.setVersion(vo.getVersion() + 1);
    newContract.setId(Snowflake.nextId()); // 新ID
    contractMapper.insert(newContract);
    
    // 3. 记录变更日志
    auditLogService.logOperation("CONTRACT_UPDATE", 
        "合同ID:" + vo.getId() + "版本更新至" + newContract.getVersion());
}

3.3 供应商绩效评估

使用MySQL窗口函数计算动态排名：

sql复制SELECT 
    supplier_id,
    AVG(score) OVER(PARTITION BY supplier_id) AS avg_score,
    RANK() OVER(ORDER BY AVG(score) DESC) AS rank
FROM evaluation_records
WHERE evaluation_time BETWEEN #{start} AND #{end}
GROUP BY supplier_id;

Vue动态图表实现：

javascript复制// 在setup中初始化ECharts
const initChart = () => {
  const chartDom = document.getElementById('scoreChart');
  const myChart = echarts.init(chartDom);
  
  axios.get('/api/supplier/score-rank').then(res => {
    const option = {
      tooltip: { trigger: 'axis' },
      xAxis: { data: res.data.map(item => item.supplierName) },
      yAxis: { type: 'value' },
      series: [{
        data: res.data.map(item => item.avgScore),
        type: 'bar',
        showBackground: true,
        label: {
          show: true,
          position: 'top',
          formatter: ({ dataIndex }) => `No.${res.data[dataIndex].rank}`
        }
      }]
    };
    myChart.setOption(option);
  });
}

4. 企业级特性实现

4.1 审计日志切面

java复制@Aspect
@Component
public class AuditLogAspect {
    
    @Autowired
    private AuditLogMapper logMapper;

    @Pointcut("@annotation(com.xxx.annotation.RequiresAudit)")
    public void auditPointcut() {}

    @AfterReturning(pointcut = "auditPointcut()", returning = "result")
    public void afterReturning(JoinPoint joinPoint, Object result) {
        MethodSignature signature = (MethodSignature) joinPoint.getSignature();
        RequiresAudit annotation = signature.getMethod().getAnnotation(RequiresAudit.class);
        
        AuditLog log = new AuditLog();
        log.setOperation(annotation.value());
        log.setParams(JsonUtil.toJson(joinPoint.getArgs()));
        log.setResult(JsonUtil.toJson(result));
        log.setCreateTime(LocalDateTime.now());
        
        logMapper.insert(log);
    }
}

4.2 分布式锁控制

使用Redisson防止供应商信息并发修改：

java复制public boolean updateSupplier(Supplier supplier) {
    RLock lock = redissonClient.getLock("supplier:lock:" + supplier.getId());
    try {
        if (lock.tryLock(5, 10, TimeUnit.SECONDS)) {
            return supplierMapper.updateById(supplier) > 0;
        }
    } catch (InterruptedException e) {
        Thread.currentThread().interrupt();
    } finally {
        lock.unlock();
    }
    return false;
}

4.3 文件安全存储

供应商资质文件存储方案：

java复制public String uploadQualification(MultipartFile file) {
    // 1. 校验文件类型
    String contentType = file.getContentType();
    if (!ALLOWED_TYPES.contains(contentType)) {
        throw new BusinessException("不支持的文件类型");
    }

    // 2. 生成加密文件名
    String originalFilename = file.getOriginalFilename();
    String fileExt = originalFilename.substring(originalFilename.lastIndexOf("."));
    String storedFilename = UUID.randomUUID() + fileExt;
    
    // 3. 存储到加密目录
    Path path = Paths.get(ENCRYPTED_STORAGE_PATH, storedFilename);
    Files.copy(file.getInputStream(), path, StandardCopyOption.REPLACE_EXISTING);
    
    // 4. 记录文件哈希值
    String fileHash = DigestUtils.md5DigestAsHex(file.getBytes());
    fileRecordService.saveFileMeta(storedFilename, fileHash);
    
    return "/secure-file/" + storedFilename;
}

5. 系统部署与优化

5.1 多环境配置

通过Spring Profile实现：

yaml复制# application-dev.yml
spring:
  datasource:
    url: jdbc:mysql://dev-db:3306/supplier_dev
    username: dev_user

# application-prod.yml
spring:
  datasource:
    url: jdbc:mysql://prod-db:3306/supplier_prod?useSSL=true
    username: prod_user
    password: ${DB_PASSWORD} # 从环境变量读取

5.2 Vue项目优化

1. 路由懒加载：

javascript复制const SupplierList = () => import('./views/SupplierList.vue');
const routes = [
  { path: '/suppliers', component: SupplierList }
];

2. 生产环境禁用console：

javascript复制if (process.env.NODE_ENV === 'production') {
  console.log = function() {};
}

3. 使用webpack分包：

javascript复制configureWebpack: {
  optimization: {
    splitChunks: {
      chunks: 'all',
      maxSize: 244 * 1024 // 244KB
    }
  }
}

5.3 MySQL性能调优

关键配置参数：

ini复制[mysqld]
innodb_buffer_pool_size = 4G  # 总内存的50-70%
innodb_log_file_size = 256M
innodb_flush_log_at_trx_commit = 2  # 非金融级应用可放宽
max_connections = 200
query_cache_type = 0  # 8.0已移除

慢查询监控：

sql复制-- 开启慢查询日志
SET GLOBAL slow_query_log = 'ON';
SET GLOBAL long_query_time = 1;
SET GLOBAL slow_query_log_file = '/var/log/mysql/mysql-slow.log';

-- 使用pt-query-digest分析
-- pt-query-digest /var/log/mysql/mysql-slow.log > slow_report.txt

6. 常见问题解决方案

6.1 MyBatis映射异常

典型错误：Invalid bound statement (not found)
排查步骤：

1. 检查mapper.xml的namespace是否对应接口全限定名
2. 确认maven是否编译xml到target目录（需配置build/resources）
3. 检查方法名是否与xml中的id一致
4. 查看MyBatis启动日志是否加载了该mapper

6.2 Vue跨域问题

开发环境解决方案（vue.config.js）：

javascript复制devServer: {
  proxy: {
    '/api': {
      target: 'http://localhost:8080',
      changeOrigin: true,
      pathRewrite: { '^/api': '' }
    }
  }
}

生产环境需配置Nginx：

nginx复制location /api/ {
    proxy_pass http://backend-server/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

6.3 SpringBoot事务失效场景

1. 检查方法是否为public
2. 确认是否抛出RuntimeException（非检查异常）
3. 避免同类内方法调用（AOP代理问题）
4. 多数据源需指定事务管理器
5. MySQL表引擎需为InnoDB

6.4 并发修改冲突处理

乐观锁实现方案：

java复制// 实体类添加版本字段
public class Supplier {
    @Version
    private Integer version;
    //...其他字段
}

// 更新时自动校验版本
public void updateWithLock(Supplier supplier) {
    int affected = supplierMapper.updateById(supplier);
    if (affected == 0) {
        throw new OptimisticLockException("供应商信息已被其他用户修改");
    }
}

7. 扩展功能建议

7.1 对接第三方征信系统

通过FeignClient调用企业征信API：

java复制@FeignClient(name = "credit-service", url = "${credit.api.url}")
public interface CreditServiceClient {
    
    @GetMapping("/check")
    CreditResult checkCredit(@RequestParam("creditCode") String creditCode);
}

// 业务逻辑中调用
public boolean checkSupplierCredit(String creditCode) {
    CreditResult result = creditServiceClient.checkCredit(creditCode);
    return result.getScore() > MIN_CREDIT_SCORE;
}

7.2 区块链存证

使用Hyperledger Fabric保存关键操作哈希：

java复制public void saveToBlockchain(AuditLog log) {
    BlockchainClient client = BlockchainClient.getInstance();
    String txId = client.invoke("supplier-chaincode", "saveAuditLog", 
        log.getId().toString(),
        log.getOperation(),
        DigestUtils.sha256Hex(log.getParams())
    );
    log.setBlockchainTxId(txId);
    auditLogMapper.updateById(log);
}

7.3 风险供应商预警

基于规则引擎实现：

java复制// 使用Drools规则引擎
KieSession kieSession = kieContainer.newKieSession();
kieSession.insert(supplier);
kieSession.fireAllRules();

List<RiskWarning> warnings = new ArrayList<>();
kieSession.getObjects(obj -> obj instanceof RiskWarning)
          .forEach(obj -> warnings.add((RiskWarning)obj));
          
if (!warnings.isEmpty()) {
    warningService.sendAlerts(warnings);
}

8. 项目部署实战

8.1 后端打包与运行

1. 生成可执行JAR：

bash复制mvn clean package -DskipTests

2. 生产环境启动命令：

bash复制nohup java -Xms512m -Xmx1024m -Dspring.profiles.active=prod \
-jar supplier-system.jar > /var/log/supplier.log 2>&1 &

3. 健康检查接口：

bash复制curl http://localhost:8080/actuator/health

8.2 前端部署流程

1. 构建生产包：

bash复制npm run build

2. Nginx配置示例：

nginx复制server {
    listen       80;
    server_name  supplier.example.com;
    
    location / {
        root   /opt/supplier-front/dist;
        index  index.html;
        try_files $uri $uri/ /index.html;
    }
    
    location /api {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
    }
}

8.3 数据库初始化

1. 使用Flyway管理迁移脚本：

sql复制-- V1__Initial_schema.sql
CREATE TABLE supplier_info (...);

-- V2__Add_audit_columns.sql
ALTER TABLE supplier_info ADD created_by VARCHAR(32);
ALTER TABLE supplier_info ADD created_time DATETIME;

2. 配置application.yml：

yaml复制spring:
  flyway:
    locations: classpath:db/migration
    baseline-on-migrate: true
    validate-on-migrate: false

9. 监控与运维

9.1 SpringBoot监控端点

安全配置示例：

java复制@Configuration
public class ActuatorSecurity extends WebSecurityConfigurerAdapter {
    
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.authorizeRequests()
            .antMatchers("/actuator/health").permitAll()
            .antMatchers("/actuator/**").hasRole("ADMIN")
            .and().httpBasic();
    }
}

关键监控指标：

• /actuator/metrics 系统指标
• /actuator/threaddump 线程分析
• /actuator/heapdump 内存快照

9.2 日志收集方案

Logback配置示例（JSON格式便于ELK收集）：

xml复制<appender name="JSON" class="ch.qos.logback.core.ConsoleAppender">
    <encoder class="net.logstash.logback.encoder.LogstashEncoder">
        <customFields>{"app":"supplier-system","env":"${spring.profiles.active}"}</customFields>
    </encoder>
</appender>

9.3 性能瓶颈定位

使用Arthas诊断：

bash复制# 1. 启动Arthas
java -jar arthas-boot.jar

# 2. 监控方法调用
watch com.example.service.SupplierService getSupplierById '{params,returnObj}' -x 3

# 3. 生成火焰图
profiler start
profiler stop --format html

10. 安全加固措施

10.1 接口防护

Spring Security配置：

java复制@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.csrf().disable()
            .authorizeRequests()
            .antMatchers("/api/public/**").permitAll()
            .antMatchers("/api/admin/**").hasRole("ADMIN")
            .anyRequest().authenticated()
            .and()
            .addFilter(new JwtAuthenticationFilter(authenticationManager()))
            .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS);
    }
}

10.2 数据加密

敏感字段加密处理：

java复制public class Supplier {
    @EncryptedField
    private String legalPersonId; // 法定代表人身份证号
    
    // Getter/Setter会通过AOP自动加解密
}

加密切面实现：

java复制@Aspect
@Component
public class EncryptAspect {
    
    @Autowired
    private StringEncryptor encryptor;

    @Around("@annotation(com.xxx.annotation.EncryptedField)")
    public Object around(ProceedingJoinPoint pjp) throws Throwable {
        Object value = pjp.proceed();
        return value != null ? encryptor.encrypt(value.toString()) : null;
    }
}

10.3 定期安全扫描

使用OWASP ZAP进行自动化测试：

1. 配置扫描策略：排除破坏性测试
2. 设置认证信息（JWT Token）
3. 针对/api/**路径执行主动扫描
4. 分析报告并修复漏洞

11. 项目演进路线

11.1 技术债务管理

1. 静态代码分析（SonarQube）
2. 技术债务看板（Tech Debt Burndown Chart）
3. 定期重构计划（每迭代预留20%时间）

11.2 微服务化拆分

演进步骤：

1. 按业务域拆分（供应商/合同/评估服务）
2. 引入Spring Cloud Alibaba生态
3. 配置中心（Nacos）
4. 服务网格（Dubbo 3.x）

11.3 智能化升级

1. 供应商风险预测（TensorFlow模型）
2. 合同条款智能比对（NLP技术）
3. 自动化审批流程（RPA集成）

12. 团队协作规范

12.1 Git工作流

采用Git Flow变种：

• feature/ 前缀：功能开发分支
• hotfix/ 前缀：紧急修复分支
• release/ 前缀：预发布分支
• 主干分支保护：需Code Review+CI通过

12.2 代码风格检查

前端ESLint配置：

json复制{
  "extends": ["eslint:recommended", "plugin:vue/recommended"],
  "rules": {
    "vue/multi-word-component-names": "off",
    "no-console": process.env.NODE_ENV === "production" ? "error" : "warn"
  }
}

后端Checkstyle配置：

xml复制<module name="TreeWalker">
    <module name="MethodLength">
        <property name="max" value="50"/>
    </module>
    <module name="ParameterNumber">
        <property name="max" value="5"/>
    </module>
</module>

12.3 文档自动化

Swagger API文档集成：

java复制@Configuration
@EnableSwagger2
public class SwaggerConfig {
    
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
            .select()
            .apis(RequestHandlerSelectors.basePackage("com.example.controller"))
            .paths(PathSelectors.any())
            .build()
            .apiInfo(metaData());
    }
}

13. 性能压测方案

13.1 JMeter测试计划

关键配置：

• 线程组：500并发，持续10分钟
• HTTP请求：模拟供应商查询/更新操作
• CSV数据文件：参数化测试数据
• 监听器：聚合报告+响应时间图

13.2 瓶颈分析与优化

典型优化案例：

1. N+1查询问题 → 添加MyBatis二级缓存
2. 大文件上传内存溢出 → 改用分块上传
3. 列表查询慢 → 添加复合索引
4. 前端渲染卡顿 → 虚拟滚动优化

13.3 熔断降级策略

Sentinel配置示例：

java复制@SentinelResource(
    value = "supplierQuery",
    blockHandler = "handleBlock",
    fallback = "handleFallback"
)
public PageInfo<Supplier> querySuppliers(QueryCondition condition) {
    // 业务逻辑
}

// 流控处理
public PageInfo<Supplier> handleBlock(QueryCondition condition, BlockException ex) {
    log.warn("触发流控", ex);
    return new PageInfo<>(Collections.emptyList());
}

14. 项目交接要点

14.1 知识转移清单

1. 系统架构图（C4模型）
2. 关键业务流程时序图
3. 运维手册（部署/监控/应急）
4. 技术决策记录（ADR）

14.2 环境矩阵

维护各环境信息：

14.3 常见问题速查

建立FAQ文档：

1. 密码重置流程
2. 数据修正申请单
3. 报表生成异常处理
4. 接口权限申请指南

15. 项目演进思考

在完成基础功能后，建议从三个维度持续优化：

1. 用户体验维度：

• 增加操作引导（Tour.js集成）
• 实现个性化工作台
• 优化移动端适配

2. 技术深度维度：

• 引入GraalVM提升启动速度
• 试用Vue 3组合式API重构复杂组件
• 探索MyBatis-Flex替代方案

3. 业务价值维度：

• 对接ERP系统实现采购闭环
• 开发供应商门户（B2B协作）
• 构建行业对标分析模型

这套系统在实际部署中，我们遇到最棘手的问题是供应商资质文件的合规性检查。后来通过引入Tesseract OCR识别营业执照关键字段，结合人工复核，将审核效率提升了60%。建议在实施时特别注意企业特定的合规要求，这些往往是标准系统无法覆盖的定制点。