tamboot-cloud-admin
Tamboot Cloud Admin是一個基於 tamboot cloud(一個基於spring cloud的微服務框架) 的微服務腳手架項目,實現了常見的用戶管理、角色管理、權限管理、菜單管理等基本功能,開發者可基於此快速搭建微服務系統。
模塊介紹
tamboot-cloud-admin-eureka-server
Eureka服務註冊中心:集成了服務權限校驗功能,當配置項spring.security.user.name
和spring.security.user.password
存在時,自動開啓服務權限校驗功能。如果服務權限校驗功能開啓,則服務消費端的eureka配置地址需添加權限信息,如: http://user:password@localhost:8761/eureka/
。
tamboot-cloud-admin-security
系統權限校驗模塊:在需要權限校驗的應用中引入該模塊,系統自動根據配置的權限信息來校驗用戶的訪問權限。
tamboot-cloud-admin-system-ms
系統微服務:提供用戶、角色、菜單、權限等基礎服務,在tamboot-cloud-admin-security
、tamboot-cloud-admin-system-app
模塊中均有使用這些服務。
tamboot-cloud-admin-system-app
系統應用:實現了用戶管理、角色管理、菜單管理、權限管理等後臺管理功能。
模塊命名
原則上微服務模塊命名以ms(microservice)結尾,應用模塊命名以app結尾。
快速上手
安裝依賴
由於tamboot和tamboot cloud尚未發佈到maven倉庫,因此運行項目前,需要先在本地編譯安裝。
$ git clone https://github.com/chensheng/tamboot.git
$ cd tamboot
$ mvn install
$ git clone https://github.com/chensheng/tamboot-cloud.git
$ cd tamboot-cloud
$ mvn install
下載項目
$ git clone https://github.com/chensheng/tamboot-cloud-admin.git
創建數據庫
數據庫初始化文件在項目的sql/
目錄下。
啓動redis
由於系統的權限信息存儲在redis中,所以需要啓動redis,具體的redis安裝啓動步驟可查看redis官網。
運行服務註冊中心
運行完,可訪問http://localhost:8761/
驗證。
cd tamboot-cloud-admin-eureka-server
mvn spring-boot:run
運行系統服務
運行完,可查看服務註冊中心後臺,驗證服務是否註冊成功。
cd tamboot-cloud-admin-system-ms
mvn spring-boot:run
運行系統應用
cd tamboot-cloud-admin-system-app
mvn spring-boot:run
返回值
所有接口統一返回json格式數據,返回格式如下:
{
"code": "1",
"msg": "success",
"data": null
}
字段 | 說明 |
---|---|
code | 狀態碼。除了使用框架定義的狀態碼,開發者也可以自定義狀態碼。具體見下表。 |
msg | 提示信息 |
data | 數據。不同接口返回不同數據。 |
狀態碼
code | 說明 |
---|---|
0 | 失敗 |
1 | 成功 |
1001 | 未登錄 |
1002 | 無權限 |
9999 | 系統異常 |
初始用戶
系統初始用戶:admin,初始密碼:Tamboot@123456