lamp-cloud

lamp-cloud 是基于 jdk11 + SpringCloud(Hoxton.SR10) + SpringBoot(2.3.10.RELEASE) 的微服务快速开发平台，其中的可配置的 SaaS 功能尤其闪耀，具备 RBAC 功能、网关统一鉴权、Xss 防跨站攻击、自动代码生成、多种存储系统、分布式事务、分布式定时任务等多个模块，支持多业务系统并行开发，支持多服务并行开发，可以作为后端服务的开发脚手架。代码简洁，注释齐全，架构清晰，非常适合学习和企业作为基础框架使用。

功能介绍

1、租户管理：运营人员管理所有的租户创建

2、工作台：普通用户常用功能

3、组织管理：组织、岗位、用户数据维护、重置用户密码等

4、资源中心：消息、短信、附件管理

5、流程管理：流程部署、模型管理、流程示例

6、系统设置：菜单、资源配置、角色管理、给角色绑定用户、给角色授权菜单和资源、字典、地区、系统参数、操作日志、登录日志、应用管理等

7、网关设置：限流和阻止访问

8、开发者管理：定时任务、接口文档、注册&配置中心、服务监控、数据库监控、zipkin 监控、SkyWalking 监控

软件特色

服务注册&发现与调用：

基于 Nacos 来实现的服务注册与发现，使用使用 Feign 来实现服务互调，可以做到使用 HTTP 请求远程调用时能与调用本地方法一样的编码体验，开发者完全感知不到这是远程方法，更感知不到这是个 HTTP 请求。

负载均衡：

将服务保留的 rest 进行代理和网关控制，除了平常经常使用的 node.js、nginx 外，Spring Cloud 系列的 zuul 和 ribbon，可以帮我们进行正常的网关管控和负载均衡。其中扩展和借鉴国外项目的扩展基于 JWT 的 Zuul 限流插件，方面进行限流。

服务鉴权：

通过 JWT 的方式来加强服务之间调度的权限验证，保证内部服务的安全性。

熔断机制：

因为采取了服务的分布，为了避免服务之间的调用“雪崩”，采用了 Hystrix 的作为熔断器，避免了服务之间的“雪崩”。

监控：

利用 Spring Boot Admin 来监控各个独立 Service 的运行状态；利用 turbine 来实时查看接口的运行状态和调用频率；通过 Zipkin 来查看各个服务之间的调用链等。

链路调用监控：

同时实现了 Zipkin 和 SkyWalking 作为本项目的全链路性能监控，从整体维度到局部维度展示各项指标，将跨应用的所有调用链性能信息集中展现，可方便度量整体和局部性能，并且方便找到故障产生的源头，生产上可极大缩短故障排除时间。

数据权限

利用基于 Mybatis 的 DataScopeInnerInterceptor 拦截器实现了数据权限功能

SaaS(多租户) 的无感解决方案

本项目支持 3 种常见的租户解决方案和无租户方案，同一套代码，修改一个配置即可实现租户模式只有切换。

缓存抽象

采用 CacheOps 操作缓存，内置 2 种实现：Caffeine、Redis，可以让项目应急时在无 Redis 环境正常运行

优雅的 Bean 转换

采用 Dozer、BeanUtil 等组件来对 DTO、DO、PO 等对象的优化转换

前后端统一表单验证

严谨的表单验证通常需要 前端 + 后端同时验证，但传统的项目，均只能前后端各做一次检验，后期规则变更，又得前后端同时修改。故在 hibernate-validator 的基础上封装了 lamp-validator-starter 起步依赖，提供一个通用接口，可以获取需要校验表单的规则，然后前端使用后端返回的规则，以后若规则改变，只需要后端修改即可。

防跨站脚本攻击 (XSS)

通过过滤器对所有请求中的 表单参数 进行过滤

通过 Json 反序列化器实现对所有 application/json 类型的参数 进行过滤

当前登录用户信息注入器

通过注解实现用户身份注入

在线 API

由于原生 swagger-ui 某些功能支持不够友好，故采用了国内开源的 knife4j，并制作了 stater，方便 springboot 用户使用。

代码生成器

基于 Mybatis-plus-generator 自定义了一套代码生成器，通过配置数据库字段的注释，自动生成枚举类、数据字典注解、SaveDTO、UpdateDTO、表单验证规则注解、Swagger 注解等。

定时任务调度器：

基于 xxl-job 进行了功能增强。(如：指定时间发送任务、执行器和调度器合并项目、多数据源)

大文件/断点/分片续传

前端采用 webupload.js、后端采用 NIO 实现了大文件断点分片续传，启动 Eureka、Zuul、File 服务后，直接打开 docs/chunkUploadDemo/demo.html 即可进行测试。经测试，本地限制堆栈最大内存 128M 启动 File 服务，5 分钟内能成功上传 4.6G+ 的大文件，正式服耗时则会受到用户带宽和服务器带宽的影响，时间比较长。

分布式事务

集成了阿里的分布式事务中间件：seata，以 高效 并且对业务 0 侵入 的方式，解决 微服务 场景下面临的分布式事务问题。

跨表、跨库、跨服务的关联数据自动回显

用于解决跨表、跨库、跨服务分页数据的属性或单个对象的属性 回显关联数据之痛，支持对静态数据属性 (数据字典)、动态主键数据进行自动注入。

灰度发布

为了解决频繁的服务更新上线，版本回退，快速迭代，公司内部协同开发，本项目采用修改 ribbon 的负载均衡策略来实现来灰度发布。