# saas-housekeeper **Repository Path**: DTSEDeveloper_admin/saas-housekeeper ## Basic Information - **Project Name**: saas-housekeeper - **Description**: 项目名称 SaaS-housekeeper，本项目是华为云开发者团队基于SaaS项目技术支持实践，采用微服务架构，结合华为云服务能力开发的SaaS化开源项目，旨在为企业级开发者提供云原生SaaS应用构建的技术参考，包括微服务架构、多租隔离设计、多租户路由、数据存储多租设计等。更多SaaS相关技术细节可参考：华为云开发者文档中心SaaS应用开发指导。 - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: master-dev - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 155 - **Created**: 2022-04-14 - **Last Updated**: 2022-05-24 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ## 项目介绍 本项目是华为云开发者团队基于SaaS项目技术支持实践，采用微服务架构，结合华为云服务能力开发的SaaS化开源项目，旨在为企业级开发者提供云原生SaaS应用构建的技术参考，包括微服务架构、多租隔离设计、多租户路由、数据存储多租设计等。更多SaaS相关技术细节可参考：华为云开发者文档中心SaaS应用开发指导。 ### 业务架构图 ![saas-housekeeper.PNG](document/业务架构图.png) ### 技术架构图 ![saas-housekeeper.PNG](document/技术架构图.png) ### 组织结构 ``` lua saas-housekeeper ├── saas-housekeeper-common-utils -- 工具类及通用代码 ├── saas-housekeeper-config-server -- 配置中心 ├── saas-housekeeper-eureka -- 注册中心 ├── saas-housekeeper-gateway -- 网关中心 ├── saas-housekeeper-message-service -- 消息中心 ├── saas-housekeeper-order-service -- 订单中心 ├── saas-housekeeper-service-publish-service -- 服务发布中心 ├── saas-housekeeper-web-customer -- 用户管理中心 ├── saas-housekeeper-web-super-admin -- 超级管理员管理中心 ├── saas-housekeeper-web-tenant -- 租户管理中心 ├── saas-housekeeper-web-worker -- 任务管理中心 └── saas-housekeeper-config -- 配置文件 ``` ### 技术选型 | 技术 | 说明 | 官网 | | -------------------- | -------------------| -------------------------------------------- | | spring-cloud | 微服务框架 | https://spring.io/projects/spring-cloud | | SpringBoot | 容器+MVC框架 | https://spring.io/projects/spring-boot | | eureka | 注册中心 | https://github.com/xmartlabs/Eureka | | SpringSecurity | 认证和授权框架 | https://spring.io/projects/spring-security | | MyBatis-plus | ORM框架 | https://baomidou.com/ | | K8S | 华为云应用容器引擎CCE | https://support.huaweicloud.com/cce/index.html | | Mysql | 云数据库RDS | https://support.huaweicloud.com/rds/index.html | | redis | 分布式缓存DCS服务 | https://support.huaweicloud.com/intl/zh-cn/dcs/index.html | | RabbitMQ | 分布式消息队列 DMS | https://support.huaweicloud.com/intl/zh-cn/rabbitmq/index.html | | saas-tenant-router-starter | 多租户路由中间件 | https://gitee.com/HuaweiCloudDeveloper/saas-tenant-router-starter.git | | Druid | 数据库连接池 | https://github.com/alibaba/druid | | JWT | JWT登录支持 | https://github.com/jwtk/jjwt | | Lombok | 简化对象封装工具 | https://github.com/rzwitserloot/lombok | | Swagger-UI | 文档生成工具 | https://github.com/swagger-api/swagger-ui | ### 开发环境 | 工具 | 版本号 | 下载 | | ------------- | ------ | ------------------------------------------------------------ | | JDK | 1.8 | https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html | ### 项目启动 ###### 注意！本地运行需要安装RabbitMQ #### 1 执行/db目录下脚本初始化数据库 #### 2 后端服务启动注册中心eureka和配置中心config-server,其它子模块启动顺序任意 #### 3 前端服务启动下列模块: - saas-housekeeper-web-customer - saas-housekeeper-web-super-admin - saas-housekeeper-web-tenant - saas-housekeeper-web-worker #### 在目录下执行命令 #### npm install #### npm run serve #### 4 访问地址 以租户域名abc为例: > 本地运行,模拟域名访问需要修改host参数来实现域名映射,在host文件增加下列参数: > > 127.0.0.1 abc.saas-housekeeper.cloudbu.huawei.com > > 即可直接访问下列地址： > - #### 超级管理中心: [abc.saas-housekeeper.cloudbu.huawei.com:8083/#/login](abc.saas-housekeeper.cloudbu.huawei.com:8083/#/login) > - #### 租户管理中心: [abc.saas-housekeeper.cloudbu.huawei.com:8082/#/login](abc.saas-housekeeper.cloudbu.huawei.com:8082/#/login) > - #### 用户管理中心: [abc.saas-housekeeper.cloudbu.huawei.com:8081/#/login](abc.saas-housekeeper.cloudbu.huawei.com:8081/#/login) > - #### 工人管理中心: [abc.saas-housekeeper.cloudbu.huawei.com:8084/#/login](abc.saas-housekeeper.cloudbu.huawei.com:8084/#/login) > 其中abc为租户注册时所填写的域名,作为租户标识,用于区分不同租户 > > 注意：目前区分租户是采用5级域名区分的,所以域名格式必须为 abc.XXX.XXX.XXX.XXX 其中abc为租户标识 ### 相关参考 链接到 华为云开发者中心SaaS应用开发指导 链接到 多租路由中间件开源项目 readme.md文件