wuye / MicroCommunit

README.md 6.6 KB

SpringBoot 主启动模块

模块概述

SpringBoot模块是MicroCommunity社区管理系统的Spring Boot版本主启动模块，负责整合所有业务服务模块并提供统一的启动入口。该模块采用Spring Boot框架，集成了社区管理、用户管理、财务管理、订单管理、报表统计等12个核心业务模块，提供完整的社区管理解决方案。

技术架构

核心框架

  • Spring Boot 2.x: 主框架，提供快速应用开发能力
  • Spring MVC: Web MVC框架
  • Spring Cloud: 微服务支持（可选）
  • MyBatis: 数据持久层框架
  • Druid: 数据库连接池

数据库支持

  • MySQL: 主数据库
  • Redis: 缓存数据库

其他技术组件

  • WebSocket: 实时通信支持
  • Thymeleaf: 模板引擎
  • Quartz: 定时任务调度（已完全注释，需手动启用）
  • Activiti: 工作流引擎（已排除自动配置）

功能说明

集成业务模块

本模块集成了以下12个核心业务模块：

  • service-acct: 账户管理模块
  • service-common: 通用服务模块
  • service-community: 社区管理模块
  • service-dev: 开发工具模块
  • service-fee: 费用管理模块
  • service-job: 任务调度模块
  • service-oa: 办公自动化模块
  • service-order: 订单管理模块
  • service-report: 报表统计模块
  • service-store: 商户管理模块
  • service-user: 用户管理模块
  • service-scm: 供应链管理模块

核心功能特性

  1. 统一启动入口: 提供BootApplicationStart主启动类
  2. 命令驱动架构: 支持命令发现和事件发布机制
  3. API文档自动生成: 集成API文档自动发现功能
  4. 多环境配置: 支持debug、dev等多环境配置
  5. 缓存管理: 集成Redis缓存和缓存刷新机制

配置说明

数据库配置

spring:
  datasource:
    url: jdbc:mysql://192.168.31.250:3306/TT?useUnicode=true&characterEncoding=utf-8&serverTimezone=GMT%2B8&useSSL=false
    username: TT
    password: hc12345678
    type: com.alibaba.druid.pool.DruidDataSource
    driver-class-name: com.mysql.cj.jdbc.Driver

Redis配置

spring:
  redis:
    database: 0
    host: 127.0.0.1
    port: 6379
    password: hc

服务器配置

server:
  port: 8008
  tomcat:
    uri-encoding: UTF-8

FTP文件服务配置

java110.ftpServer = 121.4.123.73
java110.ftpPort = 6069
java110.ftpUserName = hcftp
java110.ftpUserPassword = 123456

部署指南

环境要求

  • JDK: 1.8+
  • Maven: 3.5+
  • MySQL: 5.7+
  • Redis: 3.2+

构建步骤

  1. 克隆项目到本地
  2. 配置数据库连接信息
  3. 执行Maven构建命令： bash mvn clean package spring-boot:repackage -Dmaven.test.skip=true
  4. 运行生成的JAR文件： bash java -jar target/MicroCommunityBoot.jar

启动参数

  • -Dcache: 启动时强制刷新缓存
  • 自动缓存检测: 系统启动时会自动检测Redis中是否存在java110_hc_version缓存键，如果不存在会自动触发缓存刷新
  • 默认端口: 8008

多环境部署

  • 开发环境: 使用application-dev.yml配置
  • 调试环境: 使用application-debug.yml配置（默认）
  • 生产环境: 可创建application-prod.yml配置

API接口

命令接口

模块采用命令驱动架构，支持以下业务域的API接口：

账户管理接口 (com.java110.acct.cmd)

  • 账户查询、资金管理、交易记录等命令接口

通用服务接口 (com.java110.common.cmd)

  • 系统配置、字典管理、文件上传等通用接口

社区管理接口 (com.java110.community.cmd)

  • 社区信息、楼栋管理、房屋管理等接口

开发工具接口 (com.java110.dev.cmd)

  • 缓存管理、系统监控等开发工具接口

费用管理接口 (com.java110.fee.cmd)

  • 费用设置、账单管理、缴费记录等接口

任务调度接口 (com.java110.job.cmd)

  • 定时任务管理、任务执行监控等接口

办公自动化接口 (com.java110.oa.cmd)

  • 流程审批、公文管理等OA接口

订单管理接口 (com.java110.order.cmd)

  • 订单创建、状态管理、支付处理等接口

报表统计接口 (com.java110.report.cmd)

  • 数据统计、报表生成、分析图表等接口

商户管理接口 (com.java110.store.cmd)

  • 商户入驻、商品管理、库存管理等接口

用户管理接口 (com.java110.user.cmd)

  • 用户注册、登录认证、权限管理等接口

供应链管理接口 (com.java110.scm.cmd)

  • 供应商管理、采购订单、库存管理等接口

REST接口

模块还提供REST风格的API接口，位于com.java110.boot.rest包中，支持：

  • HTTP/HTTPS协议
  • JSON数据格式
  • 统一的错误处理机制
  • API文档自动生成

依赖关系

核心依赖

  • java110-boot: 核心启动框架
  • java110-service: 基础服务框架
  • spring-boot-starter-websocket: WebSocket支持
  • spring-boot-starter-thymeleaf: 模板引擎

业务模块依赖

本模块集成了以下12个核心业务模块：

  • service-acct: 账户管理模块
  • service-common: 通用服务模块
  • service-community: 社区管理模块
  • service-dev: 开发工具模块
  • service-fee: 费用管理模块
  • service-job: 任务调度模块
  • service-oa: 办公自动化模块
  • service-order: 订单管理模块
  • service-report: 报表统计模块
  • service-store: 商户管理模块
  • service-user: 用户管理模块
  • service-scm: 供应链管理模块
  • service-api: API接口模块

依赖管理说明

重要架构设计: 所有业务模块均排除了java110-service依赖，避免重复依赖冲突

  • 依赖排除配置: 在pom.xml中每个业务模块dependency都配置了exclusions排除java110-service
  • 架构优势: 采用集中式服务依赖管理，确保依赖版本一致性
  • 构建优化: 避免重复依赖，减少构建包大小，提高构建效率

注意事项

  1. 缓存刷新: 系统支持两种缓存刷新方式：
    • 自动检测: 启动时自动检测Redis中java110_hc_version缓存键，不存在时自动刷新
    • 强制刷新: 使用-Dcache参数强制刷新缓存，适用于首次启动或配置变更
  2. 数据库初始化: 确保数据库已正确初始化并包含必要的表结构
  3. Redis连接: 确保Redis服务正常运行且配置正确
  4. 文件上传: 文件上传大小限制为100MB，可在配置中调整
  5. 多环境切换: 通过修改spring.profiles.active切换运行环境

技术支持

如有技术问题，请联系开发团队或查阅相关技术文档。