mics-sgpt-master

zlt-microservices-platform

如果您觉得有帮助，请点右上角 "Star" 支持一下谢谢

[TOC]

 

1. 社管项目打包与部署

• 1、运行

  • 启动nacos服务：运行项目目录中的 zlt-register\nacos\bin\startup.cmd
  • 在全局配置【zlt-config】中的bootstrap.properties配置【naocs注册中心地址】和【开发环境】，application.properties中配置【开发环境】
  • 启动【idaas-center】：修改运行环境为dev，运行idaas-center\src\main\java\com\central\IdaasCenterApp.java
  • 启动【zuul-gateway】：修改bootstrap.yml的【naocs注册中心地址】，运行zlt-gateway\zuul-gateway\src\main\java\com\central\GatewayApp.java
  • 除idaas-center\src\main\java\com\central\config\WebConfig.java 配置的路径外，所有接口均需要传SSOToken；
  • 运行前端vue项目：【scocial-management-platform-frontend】

• 2、打包

  • 需要部署的项目：【zuul-gateway】、【idaas-center】和【csb-center】

  • 生产环境nacos注册中心为 【127.0.0.1:8848】

  • 首先在模块内配置bootstrap.yml的【naocs注册中心地址】，application.yml的【部署环境】、【redis地址】

  • 在全局配置【zlt-config】中的bootstrap.properties配置【naocs注册中心地址】和【部署环境】，application.properties中配置【部署环境】， 确保全局和模块的部署环境一致

  • 确认配置文件无误后，使用Maven在根目录【central-platform(root)】下执行install，进行打包。

  注：打包前建议跳过test步骤

  • 打包完成后可在相应模块下的target目录下找到模块jar包

• 3、部署

• 使用电科账号登录EDAS平台

• 在命名空间：dainke_99中，找到相应项目（gateway,idaas-center），即可上传最新jar包进行初次部署或热更新

 

2. 模块说明

• 备注
  • 除zlt-business下的【idaas-center】、【csb-center】和【sms-center】以外，均为原框架项目模块
  • 使用了原框架的【zuul-gateway】、【zlt-commons】和【zlt-config】模块实现社管总平台相关模块的开发
  • 其中特别说明在【zlt-commons】下的日志模块：zlt-log-spring-boot-starter中，有基于原框架修改的统一埋点日志工具类:【NewPointUtil】， 具体使用方式请参考附件：《社管二期平台系统统一日志输出格式说明-20210409更新xml配置版.docx》

central-platform -- 父项目，公共依赖
│  ├─zlt-business -- 业务模块一级工程
│  │  ├─ * idaas-center -- 社管平台-总平台统一认证中心[6000]
│  │  ├─ * csb-center -- 社管平台-总平台阿里CSB接口服务中心[6100]
│  │  ├─废弃 - sms-center -- 社管平台-总平台短信中心[6200] - 废弃
│  │  ├─user-center -- 用户中心[7000]
│  │  ├─file-center -- 文件中心[5000]
│  │  ├─code-generator -- 代码生成器[7300]
│  │  ├─search-center -- 搜索中心
│  │  │  ├─search-client -- 搜索中心客户端
│  │  │  ├─search-server -- 搜索中心服务端[7100]
│  │─zlt-commons -- 通用工具一级工程
│  │  ├─zlt-auth-client-spring-boot-starter -- 封装spring security client端的通用操作逻辑
│  │  ├─zlt-common-spring-boot-starter -- 封装通用操作逻辑
│  │  ├─zlt-db-spring-boot-starter -- 封装数据库通用操作逻辑
│  │  ├─ * zlt-log-spring-boot-starter -- 封装log通用操作逻辑
│  │  ├─zlt-redis-spring-boot-starter -- 封装Redis通用操作逻辑
│  │  ├─zlt-ribbon-spring-boot-starter -- 封装Ribbon和Feign的通用操作逻辑
│  │  ├─zlt-sentinel-spring-boot-starter -- 封装Sentinel的通用操作逻辑
│  │  ├─zlt-swagger2-spring-boot-starter -- 封装Swagger通用操作逻辑
│  ├─zlt-config -- 配置中心，全局配置数据库连接、redis等参数
│  ├─zlt-doc -- 项目文档
│  ├─zlt-gateway -- api网关一级工程
│  │  ├─ * zuul-gateway -- netflix-zuul[9900]
│  ├─zlt-job -- 分布式任务调度一级工程
│  │  ├─job-admin -- 任务管理器[8081]
│  │  ├─job-core -- 任务调度核心代码
│  │  ├─job-executor-samples -- 任务执行者executor样例[8082]
│  ├─zlt-monitor -- 监控一级工程
│  │  ├─sc-admin -- 应用监控[6500]
│  │  ├─log-center -- 日志中心[6200]
│  ├─zlt-uaa -- spring-security认证中心[8000]
│  ├─ * zlt-register -- 注册中心Nacos[8848]
│  ├─zlt-web -- 前端一级工程
│  │  ├─back-web -- 后台前端[8066]
│  ├─zlt-transaction -- 事务一级工程
│  │  ├─txlcn-tm -- tx-lcn事务管理器[7970]
│  ├─zlt-demo -- demo一级工程
│  │  ├─txlcn-demo -- txlcn分布式事务demo
│  │  ├─seata-demo -- seata分布式事务demo
│  │  ├─sharding-jdbc-demo -- sharding-jdbc分库分表demo
│  │  ├─rocketmq-demo -- rocketmq和mq事务demo

 

2.2. idaas-center模块说明

• 前言
  • 作为社管总平台主要业务模块，在此着重介绍结构;
  • 代码模块：zlt-business/idaas-center
• 主要业务介绍
  • 1、对接阿里idaas，集成其提供的接口：包括但不限于用户目录、组织架构、单点登录、权限系统等功能，可在application.yml配置中查看接口地址与描述
  • idaas.param:用户目录系统（app）接口全局配置、权限系统（ps）接口全局配置
  • sso-api: 单点登录相关接口，使用登录后的得到的SSOToken调用
    • 代码模块：/modules/sso
  • app-api: 用户目录、组织机构数据接口，使用APPToken（用户目录系统token）调用
    • 代码模块：/modules/application
  • ps-api: 权限数据接口，使用登录后的得到的PSToken(权限系统)调用
    • 代码模块：/modules/permission
  • 2、对接阿里MQ消息队列
  • 作为生产者，负责推送用户登录、登出状态（联创），以及每日用户活跃度数据推送（联科）、用户点击菜单状态（阿里）；
    • 代码模块：/modules/mq
  • 3、对接阿里CSB云服务总线
  • 作为消费者，负责获取用户未读消息数和代办事件数（阿里）；
    • 代码模块：/modules/csb
    • 实际调用的是【csb-center】服务的接口
  • 4、定时任务模块
  • 主要完成阿里用户信息和部门信息缓存信息定时更新、每日用户活跃度数据定时推送
    • 代码模块：/common/task
  • 单独的一个定时任务：更新、备份阿里用户数据
    • 代码模块：/modules/test/controller/TestIdaasController.java updateUserActLogExId()方法
  • 5、琼海分平台对接
  • 作为中转站，联通琼花分平台和idaas的用户体系，提供部分idaas接口转发
    • 代码模块：idaas-center\src\main\java\com\central\modules\sso\controller\IdaasQHForwordController.java
    • 配置文件中有对琼海APP服务IP白名单的设置，目前还未提供IP,所以打包前，请注释掉调用checkIP(request)方法的部分代码
  • 6、社管APP对接（北信源）
  • 为社管APP提供用户验证接口
    • 代码模块：idaas-center\src\main\java\com\central\modules\sso\controller\IdaasLoginController.java 中的appUser**()方法
      

3. 原框架介绍

• 技术交流群 250883130
• 详细在线文档 点击查看
  • 项目更新日志
  • 文档更新日志
• 演示环境地址： http://mp.zlt2000.cn
  • 账号密码：admin/admin
  • APM监控账号密码：admin/admin
  • Grafana账号：zlt/zlt
  • txlcn事务管理器密码：admin
  • 任务管理账号密码：admin/123456
  • Sentinel：sentinel/sentinel
• 演示环境有全方位的监控示例：日志系统 + APM系统 + GPE系统
• Gitee地址：https://gitee.com/zlt2000/microservices-platform
• Github地址：https://github.com/zlt2000/microservices-platform
• 前后端分离的企业级微服务架构
• 主要针对解决微服务和业务开发时常见的非功能性需求
• 深度定制Spring Security真正实现了基于RBAC、jwt和oauth2的无状态统一权限认证的解决方案
• 提供应用管理，方便第三方系统接入，支持多租户(应用隔离)
• 引入组件化的思想实现高内聚低耦合并且高度可配置化
• 注重代码规范，严格控制包依赖，每个工程基本都是最小依赖
• 非常适合学习和企业中使用

重构于开源项目OCP&cp：https://gitee.com/owenwangwen/open-capacity-platform

 

4. 项目总体架构图

 

4. 功能介绍

• 统一认证功能
  • 支持oauth2的四种模式登录
  • 支持用户名、密码加图形验证码登录
  • 支持手机号加密码登录
  • 支持openId登录
  • 支持第三方系统单点登录
• 分布式系统基础支撑
  • 服务注册发现、路由与负载均衡
  • 服务降级与熔断
  • 服务限流(url/方法级别)
  • 统一配置中心
  • 统一日志中心
  • 统一搜索中心
  • 统一分布式缓存操作类、cacheManager配置扩展
  • 分布式锁
  • 分布式任务调度器
  • 支持CI/CD持续集成(包括前端和后端)
  • 分布式Id生成器
  • 分布式事务(强一致性/最终一致性)
  • 日志链路追踪
• 系统监控功能
  • 服务调用链监控
  • 应用拓扑图
  • 慢查询SQL监控
  • 应用吞吐量监控(qps、rt)
  • 服务降级、熔断监控
  • 服务限流监控
  • 微服务服务监控
  • 服务器监控
  • redis监控
  • mysql监控
  • elasticSearch监控
  • nacos监控
  • prometheus监控
• 业务基础功能支撑
  • 多租户(应用隔离)
  • 高性能方法级幂等性支持
  • RBAC权限管理，实现细粒度控制(方法、url级别)
  • 快速实现导入、导出功能
  • 数据库访问层自动实现crud操作
  • 代码生成器
  • 基于Hutool的各种便利开发工具
  • 网关聚合所有服务的Swagger接口文档
  • 统一跨域处理
  • 统一异常处理