Skip to content

微服务版本使用手册

项目概述

PointLion Cloud 是一套基于 Spring Cloud Alibaba 的企业级微服务架构解决方案,采用模块化设计,提供了完整的分布式系统基础设施建设能力。项目致力于为企业级应用开发提供高效、稳定、可扩展的技术架构平台,支持多种业务场景的快速开发与部署。

核心技术栈

基础框架

  • Spring Boot 2.7.18 - 应用基础框架
  • Spring Cloud 2021.0.9 - 微服务核心框架
  • Spring Cloud Alibaba 2021.0.6.2 - 阿里巴巴微服务组件
  • Spring Framework 5.3.39 - 核心框架
  • Spring Security 5.8.16 - 安全框架
  • Java 8 - 开发语言版本

服务治理

  • Nacos - 服务注册与配置中心
  • Sentinel - 流量控制与熔断降级
  • Spring Cloud Gateway - API 网关
  • Dubbo - RPC 远程调用框架
  • Feign - 声明式 HTTP 客户端

数据存储

  • MyBatis-Plus 3.5.10.1 - ORM 框架增强
  • Dynamic-Datasource 4.3.1 - 多数据源动态切换
  • Druid 1.2.24 - 数据库连接池
  • MyBatis-Plus-Join 1.4.13 - 多表关联查询增强
  • Easy-Trans 3.0.6 - 字段翻译注解处理器
  • Redisson 3.41.0 - Redis 分布式客户端

数据库兼容

  • MySQL - 主数据库
  • DM8 (达梦) 8.1.3.140 - 国产数据库支持
  • KingBase (人大金仓) 8.6.0 - 国产数据库支持
  • OpenGauss 5.1.0 - 开源数据库支持
  • TDengine 3.3.3 - 时序数据库支持

消息队列

  • RocketMQ Spring 2.3.1 - 消息中间件

任务调度

  • XXL-Job 2.4.0 - 分布式任务调度平台

工作流引擎

  • Flowable 6.8.0 - 业务流程管理

监控与链路追踪

  • SkyWalking 8.12.0 - APM 监控系统
  • Spring Boot Admin 2.7.15 - 应用监控管理
  • OpenTracing 0.33.0 - 分布式追踪标准

工具类库

  • Hutool 5.8.35 - Java 工具类库
  • Lombok 1.18.36 - 代码简化注解
  • MapStruct 1.6.3 - 对象映射工具
  • EasyExcel 4.0.3 - Excel 处理工具
  • Guava 33.4.8 - Google 核心库
  • FastJSON 1.2.83 - JSON 处理工具

API 文档

  • Knife4j 4.5.0 - Swagger 增强工具
  • SpringDoc 1.8.0 - OpenAPI 3.0 文档生成

服务保障

  • Lock4j 2.2.7 - 分布式锁框架

前端技术栈

  • Vue 3.x - 前端框架
  • TypeScript - 类型系统
  • Element Plus - UI 组件库
  • Vite - 构建工具
  • Pinia - 状态管理

核心业务模块

系统基础模块 (pointlion-module-system)

提供用户管理、角色管理、菜单管理、部门管理、岗位管理、字典管理、参数配置、通知公告、日志服务等系统核心功能。

基础设施模块 (pointlion-module-infra)

提供文件管理、代码生成、数据源配置、API 日志等基础设施服务。

工作流模块 (pointlion-module-bpm)

基于 Flowable 流程引擎,提供流程定义、流程实例、任务管理、表单管理等业务流程管理能力。

商城模块 (pointlion-module-mall)

包含商品管理、订单管理、营销管理、支付管理、会员管理、统计报表等电商核心功能。

客户关系管理 (pointlion-module-crm)

提供客户管理、合同管理、商机管理、产品管理等 CRM 核心功能。

企业资源计划 (pointlion-module-erp)

包含采购管理、销售管理、库存管理、产品管理等 ERP 核心模块。

办公自动化 (pointlion-module-oa)

提供请假、出差、报销、审批等办公自动化功能。

人力资源 (pointlion-module-hrm)

包含员工管理、薪资管理、考勤管理、绩效管理等 HR 核心功能。

资产管理 (pointlion-module-am / pointlion-module-ams)

提供固定资产管理、资产台账、资产盘点等资产管理功能。

物联网模块 (pointlion-module-iot)

支持 MQTT、HTTP、EMQX 等多种物联网协议,提供设备管理、数据采集等功能。

大数据模块 (pointlion-module-bd)

提供大数据分析、数据可视化等能力。

邮件模块 (pointlion-module-mail)

提供邮件发送、邮件模板管理等邮件服务。

AI 模块 (pointlion-module-ai)

基于 Spring AI 实现 LLM 大模型接入(需要 JDK 17 版本)。

技术特性

高可用性

  • 服务注册与发现自动故障转移
  • 断路器模式防止级联故障
  • 多数据源动态切换与负载均衡
  • 分布式锁保证数据一致性

高性能

  • Redis 分布式缓存提升响应速度
  • MyBatis-Plus 提供高效 ORM 操作
  • 异步消息处理解耦业务逻辑
  • 前后端分离提升用户体验

高扩展性

  • 模块化设计便于功能扩展
  • 微服务架构支持独立部署
  • 插件化架构支持功能定制
  • 多租户支持 SaaS 化部署

安全性

  • Spring Security + JWT 实现认证授权
  • 接口级权限控制
  • 数据权限隔离
  • SQL 注入防护
  • XSS 攻击防护

可观测性

  • SkyWalking 全链路追踪
  • Spring Boot Admin 应用监控
  • 日志集中管理
  • 性能指标监控

部署架构

项目支持以下部署模式:

微服务部署模式

各业务模块独立部署,通过 Nacos 进行服务注册与发现,通过 Gateway 统一入口,适合中大型企业应用。

单体部署模式

所有模块部署在同一个应用中,适合小型项目或快速原型开发。

适用场景

  • 企业级管理系统开发
  • SaaS 平台建设
  • 电商系统开发
  • CRM/ERP/OA 等业务系统
  • 物联网平台建设
  • 数据分析平台

版本说明

当前版本:2.6.0-jdk8-SNAPSHOT

  • 基于 Java 8 开发,保证广泛的兼容性
  • 支持 JDK 17 版本的 AI 模块(独立配置)
  • 持续集成最新稳定版本依赖
  • 定期安全漏洞修复与版本升级