diff --git a/build-docker.sh b/build-docker.sh
index 3839b82..877f249 100644
--- a/build-docker.sh
+++ b/build-docker.sh
@@ -10,15 +10,15 @@ java -Djarmode=layertools -jar target/*.jar extract --destination target/extract
if [[ "${JAR_VERSION}" =~ ^.*SNAPSHOT$ ]]
then
- docker build -t hub.fatweb.top/fatweb-api:snapshot-latest -t hub.fatweb.top/fatweb-api:$JAR_VERSION -t hub.fatweb.top/fatweb-api:$JAR_VERSION-${BUILD_TIME} .
+ docker build -t hub.fatweb.top/oxygen-api:snapshot-latest -t hub.fatweb.top/oxygen-api:$JAR_VERSION -t hub.fatweb.top/oxygen-api:$JAR_VERSION-${BUILD_TIME} .
cat "${KEYS_PATH}/docker.password" | docker login hub.fatweb.top -u jenkins --password-stdin
- docker push hub.fatweb.top/fatweb-api:snapshot-latest
- docker push hub.fatweb.top/fatweb-api:$JAR_VERSION
- docker push hub.fatweb.top/fatweb-api:$JAR_VERSION-${BUILD_TIME}
+ docker push hub.fatweb.top/oxygen-api:snapshot-latest
+ docker push hub.fatweb.top/oxygen-api:$JAR_VERSION
+ docker push hub.fatweb.top/oxygen-api:$JAR_VERSION-${BUILD_TIME}
else
- docker build -t hub.fatweb.top/fatweb-api:latest -t hub.fatweb.top/fatweb-api:$JAR_VERSION -t hub.fatweb.top/fatweb-api:$JAR_VERSION-${BUILD_TIME} .
+ docker build -t hub.fatweb.top/oxygen-api:latest -t hub.fatweb.top/oxygen-api:$JAR_VERSION -t hub.fatweb.top/oxygen-api:$JAR_VERSION-${BUILD_TIME} .
cat "${KEYS_PATH}/docker.password" | docker login hub.fatweb.top -u jenkins --password-stdin
- docker push hub.fatweb.top/fatweb-api:latest
- docker push hub.fatweb.top/fatweb-api:$JAR_VERSION
- docker push hub.fatweb.top/fatweb-api:$JAR_VERSION-${BUILD_TIME}
+ docker push hub.fatweb.top/oxygen-api:latest
+ docker push hub.fatweb.top/oxygen-api:$JAR_VERSION
+ docker push hub.fatweb.top/oxygen-api:$JAR_VERSION-${BUILD_TIME}
fi
\ No newline at end of file
diff --git a/db/schema.sql b/db/schema.sql
deleted file mode 100644
index a1140fd..0000000
--- a/db/schema.sql
+++ /dev/null
@@ -1,12 +0,0 @@
-drop table if exists t_user;
-
-create table if not exists t_user
-(
- id bigint not null primary key,
- username varchar(20) not null comment '用户名',
- password char(70) not null comment '密码',
- enable int not null comment '启用',
- deleted bigint not null default 0,
- version int not null default 0,
- constraint t_user_unique unique (username, deleted)
-) comment '用户';
diff --git a/doc/database.drawio b/doc/database.drawio
new file mode 100644
index 0000000..007b0d0
--- /dev/null
+++ b/doc/database.drawio
@@ -0,0 +1,982 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/doc/permission.drawio b/doc/permission.drawio
new file mode 100644
index 0000000..f2f17a0
--- /dev/null
+++ b/doc/permission.drawio
@@ -0,0 +1,343 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/pom.xml b/pom.xml
index abe9e27..133a5d1 100644
--- a/pom.xml
+++ b/pom.xml
@@ -5,14 +5,28 @@
org.springframework.boot
spring-boot-starter-parent
- 3.1.4
+ 3.2.1
top.fatweb
api
0.0.1-SNAPSHOT
- fatweb-api
- fatweb-api
+ oxygen-api
+ oxygen-api
+
+
+
+ sonatype-oss-snapshots
+ sonatype-oss-snapshots
+ https://s01.oss.sonatype.org/content/repositories/snapshots
+
+ false
+
+
+ true
+
+
+
@@ -28,7 +42,7 @@
com.github.xiaoymin
knife4j-openapi3-jakarta-spring-boot-starter
- 4.3.0
+ 4.4.0
@@ -61,15 +75,12 @@
17
- 1.8.22
+ 1.9.21
${maven.build.timestamp}
yyyy-MM-dd'T'HH:mm:ss
+ 9.22.3
-
- org.springframework.boot
- spring-boot-starter-security
-
org.springframework.boot
spring-boot-starter-web
@@ -79,29 +90,27 @@
spring-boot-starter-validation
- com.fasterxml.jackson.module
- jackson-module-kotlin
+ org.springframework.boot
+ spring-boot-starter-actuator
- org.jetbrains.kotlin
- kotlin-reflect
+ org.springframework.boot
+ spring-boot-starter-aop
- org.jetbrains.kotlin
- kotlin-stdlib
+ org.springframework.boot
+ spring-boot-starter-security
+
+
+ org.springframework.boot
+ spring-boot-starter-mail
-
org.springframework.boot
spring-boot-devtools
runtime
true
-
- com.mysql
- mysql-connector-j
- runtime
-
org.springframework.boot
spring-boot-starter-test
@@ -112,51 +121,91 @@
spring-security-test
test
+
+ com.github.lianjiatech
+ retrofit-spring-boot-starter
+ 3.0.3
+
- com.baomidou
- mybatis-plus-boot-starter
- 3.5.3.2
+ org.jetbrains.kotlin
+ kotlin-reflect
- com.baomidou
- mybatis-plus-boot-starter-test
- 3.5.3.2
- test
+ org.jetbrains.kotlin
+ kotlin-stdlib
- com.alibaba
- druid-spring-boot-starter
- 1.2.19
+ com.fasterxml.jackson.module
+ jackson-module-kotlin
-
+
+ com.fasterxml.jackson.datatype
+ jackson-datatype-jsr310
+
+
org.apache.velocity
velocity-engine-core
2.3
+
+ com.mysql
+ mysql-connector-j
+ runtime
+
+
+ com.baomidou
+ mybatis-plus-spring-boot3-starter
+ 3.5.5
+
+
+ org.xerial
+ sqlite-jdbc
+ 3.44.1.0
+
+
+ com.baomidou
+ dynamic-datasource-spring-boot3-starter
+ 4.2.0
+
+
+ org.flywaydb
+ flyway-mysql
+ ${flyway.version}
+
org.springframework.boot
spring-boot-starter-data-redis
+
+ com.baomidou
+ mybatis-plus-spring-boot3-starter-test
+ 3.5.5
+ test
+
+
+
com.auth0
java-jwt
4.4.0
- org.springframework.boot
- spring-boot-starter-actuator
+ top.fatweb
+ avatar-generator
+ 1.1.0
- com.fasterxml.jackson.datatype
- jackson-datatype-jsr310
+ com.github.oshi
+ oshi-core
+ 6.4.9
@@ -202,6 +251,19 @@
+
+ org.jetbrains.dokka
+ dokka-maven-plugin
+ 1.9.10
+
+
+ pre-site
+
+ dokka
+
+
+
+
diff --git a/src/main/kotlin/top/fatweb/api/FatWebApiApplication.kt b/src/main/kotlin/top/fatweb/api/FatWebApiApplication.kt
deleted file mode 100644
index a2d2e01..0000000
--- a/src/main/kotlin/top/fatweb/api/FatWebApiApplication.kt
+++ /dev/null
@@ -1,36 +0,0 @@
-package top.fatweb.api
-
-import org.slf4j.LoggerFactory
-import org.springframework.boot.autoconfigure.SpringBootApplication
-import org.springframework.boot.runApplication
-import org.springframework.transaction.annotation.EnableTransactionManagement
-import java.io.File
-import java.util.*
-
-@SpringBootApplication
-@EnableTransactionManagement
-class FatWebApiApplication
-
-fun main(args: Array) {
- val logger = LoggerFactory.getLogger("main")
-
- if (!File("data").isDirectory) {
- if (!File("data").mkdir()) {
- logger.error("Can not create directory 'data', please try again later.")
- return
- }
- }
-
- if (File("application-config.yml").exists() || File("data/application-config.yml").exists()) {
- runApplication(*args)
- } else {
- logger.warn("File ‘application.yml’ cannot be found in the running path. The configuration file template 'application.example.yml' has been created in directory 'data'. Please change the configuration file content, rename it to 'application.yml', and then restart the server.")
- FatWebApiApplication::class.java.getResource("/application-config-template.yml")?.readText()?.let {
- File("data/application-config.example.yml").writeText(
- it.replace(
- "\$uuid\$", UUID.randomUUID().toString().replace("-", "")
- )
- )
- }
- }
-}
diff --git a/src/main/kotlin/top/fatweb/api/annotation/ApiVersion.kt b/src/main/kotlin/top/fatweb/api/annotation/ApiVersion.kt
deleted file mode 100644
index a0b064c..0000000
--- a/src/main/kotlin/top/fatweb/api/annotation/ApiVersion.kt
+++ /dev/null
@@ -1,11 +0,0 @@
-package top.fatweb.api.annotation
-
-import org.springframework.core.annotation.AliasFor
-
-@Target(AnnotationTarget.CLASS)
-@Retention(AnnotationRetention.RUNTIME)
-annotation class ApiVersion(
- @get:AliasFor("version") val value: Int = 1,
-
- @get:AliasFor("value") val version: Int = 1
-)
diff --git a/src/main/kotlin/top/fatweb/api/constant/SecurityConstants.kt b/src/main/kotlin/top/fatweb/api/constant/SecurityConstants.kt
deleted file mode 100644
index c2b1738..0000000
--- a/src/main/kotlin/top/fatweb/api/constant/SecurityConstants.kt
+++ /dev/null
@@ -1,25 +0,0 @@
-package top.fatweb.api.constant
-
-import org.springframework.boot.context.properties.ConfigurationProperties
-import org.springframework.stereotype.Component
-import java.util.concurrent.TimeUnit
-
-@Component
-@ConfigurationProperties("app.security")
-object SecurityConstants {
- var headerString = "Authorization"
-
- var tokenPrefix = "Bearer "
-
- var jwtTtl = 2L
-
- var jwtTtlUnit = TimeUnit.HOURS
-
- var jwtKey = "FatWeb"
-
- var jwtIssuer = "FatWeb"
-
- var redisTtl = 20L
-
- var redisTtlUnit = TimeUnit.MINUTES
-}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/constant/ServerConstants.kt b/src/main/kotlin/top/fatweb/api/constant/ServerConstants.kt
deleted file mode 100644
index 5f55621..0000000
--- a/src/main/kotlin/top/fatweb/api/constant/ServerConstants.kt
+++ /dev/null
@@ -1,18 +0,0 @@
-package top.fatweb.api.constant
-
-import org.springframework.boot.context.properties.ConfigurationProperties
-import org.springframework.stereotype.Component
-import java.time.LocalDateTime
-import java.time.ZoneId
-import java.time.ZonedDateTime
-
-@Component
-@ConfigurationProperties("app")
-object ServerConstants {
- lateinit var version: String
-
- lateinit var buildTime: String
-
- fun buildZoneDateTime(zoneId: ZoneId = ZoneId.systemDefault()): ZonedDateTime =
- LocalDateTime.parse(buildTime).atZone(ZoneId.of("UTC")).withZoneSameInstant(zoneId)
-}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/controller/UserController.kt b/src/main/kotlin/top/fatweb/api/controller/UserController.kt
deleted file mode 100644
index 188caf5..0000000
--- a/src/main/kotlin/top/fatweb/api/controller/UserController.kt
+++ /dev/null
@@ -1,17 +0,0 @@
-package top.fatweb.api.controller
-
-import org.springframework.web.bind.annotation.RequestMapping
-import org.springframework.web.bind.annotation.RestController
-
-/**
- *
- * 用户 前端控制器
- *
- *
- * @author FatttSnake
- * @since 2023-10-04
- */
-@RestController
-@RequestMapping("/api/user")
-class UserController
-
diff --git a/src/main/kotlin/top/fatweb/api/controller/permission/AuthenticationController.kt b/src/main/kotlin/top/fatweb/api/controller/permission/AuthenticationController.kt
deleted file mode 100644
index 2dd6960..0000000
--- a/src/main/kotlin/top/fatweb/api/controller/permission/AuthenticationController.kt
+++ /dev/null
@@ -1,45 +0,0 @@
-package top.fatweb.api.controller.permission
-
-import io.swagger.v3.oas.annotations.Operation
-import io.swagger.v3.oas.annotations.tags.Tag
-import jakarta.servlet.http.HttpServletRequest
-import jakarta.validation.Valid
-import org.springframework.web.bind.annotation.*
-import top.fatweb.api.annotation.ApiVersion
-import top.fatweb.api.converter.UserConverter
-import top.fatweb.api.entity.common.ResponseCode
-import top.fatweb.api.entity.common.ResponseResult
-import top.fatweb.api.param.LoginParam
-import top.fatweb.api.service.permission.IAuthenticationService
-import top.fatweb.api.util.WebUtil
-
-@Tag(name = "身份认证", description = "身份认证相关接口")
-@ApiVersion(2)
-@RestController
-class AuthenticationController(val authenticationService: IAuthenticationService, val userConverter: UserConverter) {
- @Operation(summary = "登录")
- @PostMapping("/login")
- fun login(@Valid @RequestBody loginParam: LoginParam) =
- ResponseResult.success(
- ResponseCode.SYSTEM_LOGIN_SUCCESS,
- "Login success",
- authenticationService.login(userConverter.loginParamToUser(loginParam))
- )
-
- @Operation(summary = "登出")
- @PostMapping("/logout")
- fun logout(request: HttpServletRequest) =
- when (authenticationService.logout(WebUtil.getToken(request))) {
- true -> ResponseResult.success(ResponseCode.SYSTEM_LOGOUT_SUCCESS, "Logout success", null)
- false -> ResponseResult.fail(ResponseCode.SYSTEM_LOGOUT_FAILED, "Logout failed", null)
- }
-
- @Operation(summary = "更新 Token")
- @GetMapping("/token")
- fun renewToken(request: HttpServletRequest) =
- ResponseResult.success(
- ResponseCode.SYSTEM_TOKEN_RENEW_SUCCESS,
- "Token renew success",
- authenticationService.renewToken(WebUtil.getToken(request))
- )
-}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/converter/UserConverter.kt b/src/main/kotlin/top/fatweb/api/converter/UserConverter.kt
deleted file mode 100644
index 1bfd381..0000000
--- a/src/main/kotlin/top/fatweb/api/converter/UserConverter.kt
+++ /dev/null
@@ -1,17 +0,0 @@
-package top.fatweb.api.converter
-
-import org.springframework.stereotype.Component
-import top.fatweb.api.entity.permission.User
-import top.fatweb.api.param.LoginParam
-
-@Component
-object UserConverter {
- fun loginParamToUser(loginParam: LoginParam): User {
- val user = User().apply {
- username = loginParam.username
- password = loginParam.password
- }
-
- return user
- }
-}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/entity/common/BusinessCode.kt b/src/main/kotlin/top/fatweb/api/entity/common/BusinessCode.kt
deleted file mode 100644
index 02178f5..0000000
--- a/src/main/kotlin/top/fatweb/api/entity/common/BusinessCode.kt
+++ /dev/null
@@ -1,6 +0,0 @@
-package top.fatweb.api.entity.common
-
-enum class BusinessCode(val code: Int) {
- SYSTEM(100),
- DATABASE(200)
-}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/entity/common/ResponseCode.kt b/src/main/kotlin/top/fatweb/api/entity/common/ResponseCode.kt
deleted file mode 100644
index f6095bb..0000000
--- a/src/main/kotlin/top/fatweb/api/entity/common/ResponseCode.kt
+++ /dev/null
@@ -1,24 +0,0 @@
-package top.fatweb.api.entity.common
-
-enum class ResponseCode(val code: Int) {
- SYSTEM_OK(BusinessCode.SYSTEM, 0),
- SYSTEM_LOGIN_SUCCESS(BusinessCode.SYSTEM, 20),
- SYSTEM_PASSWORD_CHANGE_SUCCESS(BusinessCode.SYSTEM, 21),
- SYSTEM_LOGOUT_SUCCESS(BusinessCode.SYSTEM, 22),
- SYSTEM_TOKEN_RENEW_SUCCESS(BusinessCode.SYSTEM, 23),
- SYSTEM_UNAUTHORIZED(BusinessCode.SYSTEM, 30),
- SYSTEM_USERNAME_NOT_FOUND(BusinessCode.SYSTEM, 31),
- SYSTEM_ACCESS_DENIED(BusinessCode.SYSTEM, 32),
- SYSTEM_USER_DISABLE(BusinessCode.SYSTEM, 33),
- SYSTEM_LOGIN_USERNAME_PASSWORD_ERROR(BusinessCode.SYSTEM, 34),
- SYSTEM_OLD_PASSWORD_NOT_MATCH(BusinessCode.SYSTEM, 35),
- SYSTEM_LOGOUT_FAILED(BusinessCode.SYSTEM, 36),
- SYSTEM_TOKEN_ILLEGAL(BusinessCode.SYSTEM, 37),
- SYSTEM_TOKEN_HAS_EXPIRED(BusinessCode.SYSTEM, 38),
- SYSTEM_REQUEST_ILLEGAL(BusinessCode.SYSTEM, 40),
- SYSTEM_ARGUMENT_NOT_VALID(BusinessCode.SYSTEM, 41),
- SYSTEM_ERROR(BusinessCode.SYSTEM, 50),
- SYSTEM_TIMEOUT(BusinessCode.SYSTEM, 51);
-
- constructor(businessCode: BusinessCode, code: Int) : this(businessCode.code * 100 + code)
-}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/entity/common/ResponseResult.kt b/src/main/kotlin/top/fatweb/api/entity/common/ResponseResult.kt
deleted file mode 100644
index 9559c1d..0000000
--- a/src/main/kotlin/top/fatweb/api/entity/common/ResponseResult.kt
+++ /dev/null
@@ -1,29 +0,0 @@
-package top.fatweb.api.entity.common
-
-import io.swagger.v3.oas.annotations.media.Schema
-import java.io.Serializable
-
-class ResponseResult private constructor(
- @Schema(description = "响应码", defaultValue = "200")
- val code: Int,
-
- @Schema(description = "是否调用成功")
- val success: Boolean,
-
- @Schema(description = "信息")
- val msg: String,
-
- @Schema(description = "数据")
- val data: T?
-) : Serializable {
- companion object {
- fun build(code: ResponseCode, success: Boolean, msg: String, data: T?) =
- ResponseResult(code.code, success, msg, data)
-
- fun success(code: ResponseCode = ResponseCode.SYSTEM_OK, msg: String = "success", data: T? = null) =
- build(code, true, msg, data)
-
- fun fail(code: ResponseCode = ResponseCode.SYSTEM_ERROR, msg: String = "fail", data: T? = null) =
- build(code, false, msg, data)
- }
-}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/entity/permission/LoginUser.kt b/src/main/kotlin/top/fatweb/api/entity/permission/LoginUser.kt
deleted file mode 100644
index 951d1e2..0000000
--- a/src/main/kotlin/top/fatweb/api/entity/permission/LoginUser.kt
+++ /dev/null
@@ -1,44 +0,0 @@
-package top.fatweb.api.entity.permission
-
-import com.fasterxml.jackson.annotation.JsonIgnore
-import com.fasterxml.jackson.annotation.JsonTypeInfo
-import org.springframework.security.core.GrantedAuthority
-import org.springframework.security.core.userdetails.UserDetails
-
-@JsonTypeInfo(use = JsonTypeInfo.Id.CLASS)
-class LoginUser() : UserDetails {
- lateinit var user: User
-
- @JsonIgnore
- private var authorities: List? = null
-
- constructor(user: User) : this() {
- this.user = user
- }
-
- @JsonIgnore
- override fun getAuthorities(): List {
- authorities?.let { return it }
- authorities = emptyList()
-
- return authorities as List
- }
-
- @JsonIgnore
- override fun getPassword(): String? = user.password
-
- @JsonIgnore
- override fun getUsername(): String? = user.username
-
- @JsonIgnore
- override fun isAccountNonExpired(): Boolean = true
-
- @JsonIgnore
- override fun isAccountNonLocked(): Boolean = true
-
- @JsonIgnore
- override fun isCredentialsNonExpired(): Boolean = true
-
- @JsonIgnore
- override fun isEnabled(): Boolean = user.enable == 1
-}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/entity/permission/User.kt b/src/main/kotlin/top/fatweb/api/entity/permission/User.kt
deleted file mode 100644
index bff63ab..0000000
--- a/src/main/kotlin/top/fatweb/api/entity/permission/User.kt
+++ /dev/null
@@ -1,54 +0,0 @@
-package top.fatweb.api.entity.permission
-
-import com.baomidou.mybatisplus.annotation.*
-import java.io.Serializable
-
-/**
- *
- * 用户
- *
- *
- * @author FatttSnake
- * @since 2023-10-04
- */
-@TableName("t_user")
-class User() : Serializable {
- constructor(username: String, password: String, enable: Boolean = true) : this() {
- this.username = username
- this.password = password
- this.enable = if (enable) 1 else 0
- }
-
- @TableId("id")
- var id: Long? = null
-
- /**
- * 用户名
- */
- @TableField("username")
- var username: String? = null
-
- /**
- * 密码
- */
- @TableField("password")
- var password: String? = null
-
- /**
- * 启用
- */
- @TableField("enable")
- var enable: Int? = null
-
- @TableField("deleted")
- @TableLogic
- var deleted: Long? = null
-
- @TableField("version")
- @Version
- var version: Int? = null
-
- override fun toString(): String {
- return "User{id=$id, username=$username, password=$password, enable=$enable, deleted=$deleted, version=$version}"
- }
-}
diff --git a/src/main/kotlin/top/fatweb/api/exception/TokenHasExpiredException.kt b/src/main/kotlin/top/fatweb/api/exception/TokenHasExpiredException.kt
deleted file mode 100644
index 2b0521f..0000000
--- a/src/main/kotlin/top/fatweb/api/exception/TokenHasExpiredException.kt
+++ /dev/null
@@ -1,3 +0,0 @@
-package top.fatweb.api.exception
-
-class TokenHasExpiredException : RuntimeException("Token has expired")
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/filter/JwtAuthenticationTokenFilter.kt b/src/main/kotlin/top/fatweb/api/filter/JwtAuthenticationTokenFilter.kt
deleted file mode 100644
index 048aa39..0000000
--- a/src/main/kotlin/top/fatweb/api/filter/JwtAuthenticationTokenFilter.kt
+++ /dev/null
@@ -1,46 +0,0 @@
-package top.fatweb.api.filter
-
-import jakarta.servlet.FilterChain
-import jakarta.servlet.http.HttpServletRequest
-import jakarta.servlet.http.HttpServletResponse
-import org.springframework.security.authentication.UsernamePasswordAuthenticationToken
-import org.springframework.security.core.context.SecurityContextHolder
-import org.springframework.stereotype.Component
-import org.springframework.util.StringUtils
-import org.springframework.web.filter.OncePerRequestFilter
-import top.fatweb.api.constant.SecurityConstants
-import top.fatweb.api.entity.permission.LoginUser
-import top.fatweb.api.exception.TokenHasExpiredException
-import top.fatweb.api.util.JwtUtil
-import top.fatweb.api.util.RedisUtil
-import top.fatweb.api.util.WebUtil
-
-@Component
-class JwtAuthenticationTokenFilter(private val redisUtil: RedisUtil) : OncePerRequestFilter() {
- override fun doFilterInternal(
- request: HttpServletRequest,
- response: HttpServletResponse,
- filterChain: FilterChain
- ) {
- val tokenWithPrefix = request.getHeader(SecurityConstants.headerString)
-
- if (!StringUtils.hasText(tokenWithPrefix) || "/error/thrown" == request.servletPath) {
- filterChain.doFilter(request, response)
- return
- }
-
- val token = WebUtil.getToken(tokenWithPrefix)
- JwtUtil.parseJwt(token)
-
- val redisKey = "${SecurityConstants.jwtIssuer}_login:" + token
- val loginUser = redisUtil.getObject(redisKey)
- loginUser ?: let { throw TokenHasExpiredException() }
-
- redisUtil.setExpire(redisKey, SecurityConstants.redisTtl, SecurityConstants.redisTtlUnit)
-
- val authenticationToken = UsernamePasswordAuthenticationToken(loginUser, null, loginUser.authorities)
- SecurityContextHolder.getContext().authentication = authenticationToken
-
- filterChain.doFilter(request, response)
- }
-}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/handler/ExceptionHandler.kt b/src/main/kotlin/top/fatweb/api/handler/ExceptionHandler.kt
deleted file mode 100644
index c4abedb..0000000
--- a/src/main/kotlin/top/fatweb/api/handler/ExceptionHandler.kt
+++ /dev/null
@@ -1,67 +0,0 @@
-package top.fatweb.api.handler
-
-import com.auth0.jwt.exceptions.JWTDecodeException
-import com.auth0.jwt.exceptions.SignatureVerificationException
-import org.slf4j.Logger
-import org.slf4j.LoggerFactory
-import org.springframework.http.converter.HttpMessageNotReadableException
-import org.springframework.security.authentication.BadCredentialsException
-import org.springframework.security.authentication.InsufficientAuthenticationException
-import org.springframework.security.authentication.InternalAuthenticationServiceException
-import org.springframework.web.bind.MethodArgumentNotValidException
-import org.springframework.web.bind.annotation.ExceptionHandler
-import org.springframework.web.bind.annotation.RestControllerAdvice
-import top.fatweb.api.entity.common.ResponseCode
-import top.fatweb.api.entity.common.ResponseResult
-import top.fatweb.api.exception.TokenHasExpiredException
-
-@RestControllerAdvice
-class ExceptionHandler {
- private val log: Logger = LoggerFactory.getLogger(this::class.java)
-
- @ExceptionHandler(value = [Exception::class])
- fun exceptionHandler(e: Exception): ResponseResult<*> {
- return when (e) {
- is InsufficientAuthenticationException -> {
- log.debug(e.localizedMessage, e)
- ResponseResult.fail(ResponseCode.SYSTEM_UNAUTHORIZED, e.localizedMessage, null)
- }
-
- is HttpMessageNotReadableException -> {
- log.debug(e.localizedMessage, e)
- ResponseResult.fail(ResponseCode.SYSTEM_REQUEST_ILLEGAL, e.localizedMessage.split(":")[0], null)
- }
-
- is MethodArgumentNotValidException -> {
- log.debug(e.localizedMessage, e)
- val errorMessage = e.allErrors.map { error -> error.defaultMessage }.joinToString(". ")
- ResponseResult.fail(ResponseCode.SYSTEM_ARGUMENT_NOT_VALID, errorMessage, null)
- }
-
- is InternalAuthenticationServiceException -> {
- log.debug(e.localizedMessage, e)
- ResponseResult.fail(ResponseCode.SYSTEM_USERNAME_NOT_FOUND, "Username not found", null)
- }
-
- is BadCredentialsException -> {
- log.debug(e.localizedMessage, e)
- ResponseResult.fail(ResponseCode.SYSTEM_LOGIN_USERNAME_PASSWORD_ERROR, e.localizedMessage, null)
- }
-
- is SignatureVerificationException, is JWTDecodeException -> {
- log.debug(e.localizedMessage, e)
- ResponseResult.fail(ResponseCode.SYSTEM_TOKEN_ILLEGAL, "Token illegal", null)
- }
-
- is TokenHasExpiredException -> {
- log.debug(e.localizedMessage, e)
- ResponseResult.fail(ResponseCode.SYSTEM_TOKEN_HAS_EXPIRED, e.localizedMessage, null)
- }
-
- else -> {
- log.error(e.localizedMessage, e)
- ResponseResult.fail(ResponseCode.SYSTEM_ERROR, data = null)
- }
- }
- }
-}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/mapper/UserMapper.kt b/src/main/kotlin/top/fatweb/api/mapper/UserMapper.kt
deleted file mode 100644
index 8b37df3..0000000
--- a/src/main/kotlin/top/fatweb/api/mapper/UserMapper.kt
+++ /dev/null
@@ -1,16 +0,0 @@
-package top.fatweb.api.mapper
-
-import com.baomidou.mybatisplus.core.mapper.BaseMapper
-import org.apache.ibatis.annotations.Mapper
-import top.fatweb.api.entity.permission.User
-
-/**
- *
- * 用户 Mapper 接口
- *
- *
- * @author FatttSnake
- * @since 2023-10-04
- */
-@Mapper
-interface UserMapper : BaseMapper
diff --git a/src/main/kotlin/top/fatweb/api/param/LoginParam.kt b/src/main/kotlin/top/fatweb/api/param/LoginParam.kt
deleted file mode 100644
index 701ab12..0000000
--- a/src/main/kotlin/top/fatweb/api/param/LoginParam.kt
+++ /dev/null
@@ -1,17 +0,0 @@
-package top.fatweb.api.param
-
-import io.swagger.v3.oas.annotations.media.Schema
-import jakarta.validation.constraints.NotBlank
-import java.io.Serializable
-
-@Schema(description = "登录请求参数")
-class LoginParam : Serializable {
-
- @Schema(description = "用户名", example = "test", required = true)
- @NotBlank(message = "Username can not be blank")
- val username: String? = null
-
- @Schema(description = "密码", example = "test123456", required = true)
- @NotBlank(message = "Password can not be blank")
- val password: String? = null
-}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/service/IUserService.kt b/src/main/kotlin/top/fatweb/api/service/IUserService.kt
deleted file mode 100644
index 7bc58e9..0000000
--- a/src/main/kotlin/top/fatweb/api/service/IUserService.kt
+++ /dev/null
@@ -1,14 +0,0 @@
-package top.fatweb.api.service
-
-import com.baomidou.mybatisplus.extension.service.IService
-import top.fatweb.api.entity.permission.User
-
-/**
- *
- * 用户 服务类
- *
- *
- * @author FatttSnake
- * @since 2023-10-04
- */
-interface IUserService : IService
diff --git a/src/main/kotlin/top/fatweb/api/service/impl/UserServiceImpl.kt b/src/main/kotlin/top/fatweb/api/service/impl/UserServiceImpl.kt
deleted file mode 100644
index e522f6b..0000000
--- a/src/main/kotlin/top/fatweb/api/service/impl/UserServiceImpl.kt
+++ /dev/null
@@ -1,18 +0,0 @@
-package top.fatweb.api.service.impl
-
-import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl
-import org.springframework.stereotype.Service
-import top.fatweb.api.entity.permission.User
-import top.fatweb.api.mapper.UserMapper
-import top.fatweb.api.service.IUserService
-
-/**
- *
- * 用户 服务实现类
- *
- *
- * @author FatttSnake
- * @since 2023-10-04
- */
-@Service
-class UserServiceImpl : ServiceImpl(), IUserService
diff --git a/src/main/kotlin/top/fatweb/api/service/permission/IAuthenticationService.kt b/src/main/kotlin/top/fatweb/api/service/permission/IAuthenticationService.kt
deleted file mode 100644
index 28becfc..0000000
--- a/src/main/kotlin/top/fatweb/api/service/permission/IAuthenticationService.kt
+++ /dev/null
@@ -1,13 +0,0 @@
-package top.fatweb.api.service.permission
-
-import top.fatweb.api.entity.permission.User
-import top.fatweb.api.vo.LoginVo
-import top.fatweb.api.vo.TokenVo
-
-interface IAuthenticationService {
- fun login(user: User): LoginVo
-
- fun logout(token: String): Boolean
-
- fun renewToken(token: String): TokenVo
-}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/service/permission/impl/AuthenticationServiceImpl.kt b/src/main/kotlin/top/fatweb/api/service/permission/impl/AuthenticationServiceImpl.kt
deleted file mode 100644
index d08bc10..0000000
--- a/src/main/kotlin/top/fatweb/api/service/permission/impl/AuthenticationServiceImpl.kt
+++ /dev/null
@@ -1,65 +0,0 @@
-package top.fatweb.api.service.permission.impl
-
-import org.springframework.security.authentication.AuthenticationManager
-import org.springframework.security.authentication.UsernamePasswordAuthenticationToken
-import org.springframework.stereotype.Service
-import top.fatweb.api.constant.SecurityConstants
-import top.fatweb.api.entity.permission.LoginUser
-import top.fatweb.api.entity.permission.User
-import top.fatweb.api.service.permission.IAuthenticationService
-import top.fatweb.api.util.JwtUtil
-import top.fatweb.api.util.RedisUtil
-import top.fatweb.api.util.WebUtil
-import top.fatweb.api.vo.LoginVo
-import top.fatweb.api.vo.TokenVo
-
-@Service
-class AuthenticationServiceImpl(
- private val authenticationManager: AuthenticationManager,
- private val redisUtil: RedisUtil
-) : IAuthenticationService {
- override fun login(user: User): LoginVo {
- val usernamePasswordAuthenticationToken = UsernamePasswordAuthenticationToken(user.username, user.password)
- val authentication = authenticationManager.authenticate(usernamePasswordAuthenticationToken)
- authentication ?: let {
- throw RuntimeException("Login failed")
- }
-
- val loginUser = authentication.principal as LoginUser
- loginUser.user.password = ""
- val userId = loginUser.user.id.toString()
- val jwt = JwtUtil.createJwt(userId)
-
- jwt ?: let {
- throw RuntimeException("Login failed")
- }
-
- val redisKey = "${SecurityConstants.jwtIssuer}_login:" + jwt
- redisUtil.setObject(redisKey, loginUser, SecurityConstants.redisTtl, SecurityConstants.redisTtlUnit)
-
- return LoginVo(jwt)
- }
-
- override fun logout(token: String): Boolean =
- redisUtil.delObject("${SecurityConstants.jwtIssuer}_login:" + token)
-
- override fun renewToken(token: String): TokenVo {
- val oldRedisKey = "${SecurityConstants.jwtIssuer}_login:" + token
- redisUtil.delObject(oldRedisKey)
- val jwt = JwtUtil.createJwt(WebUtil.getLoginUserId().toString())
-
- jwt ?: let {
- throw RuntimeException("Login failed")
- }
-
- val redisKey = "${SecurityConstants.jwtIssuer}_login:" + jwt
- redisUtil.setObject(
- redisKey,
- WebUtil.getLoginUser(),
- SecurityConstants.redisTtl,
- SecurityConstants.redisTtlUnit
- )
-
- return TokenVo(jwt)
- }
-}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/service/permission/impl/UserDetailsServiceImpl.kt b/src/main/kotlin/top/fatweb/api/service/permission/impl/UserDetailsServiceImpl.kt
deleted file mode 100644
index 6b78e76..0000000
--- a/src/main/kotlin/top/fatweb/api/service/permission/impl/UserDetailsServiceImpl.kt
+++ /dev/null
@@ -1,19 +0,0 @@
-package top.fatweb.api.service.permission.impl
-
-import com.baomidou.mybatisplus.extension.kotlin.KtQueryWrapper
-import org.springframework.security.core.userdetails.UserDetails
-import org.springframework.security.core.userdetails.UserDetailsService
-import org.springframework.stereotype.Service
-import top.fatweb.api.entity.permission.LoginUser
-import top.fatweb.api.entity.permission.User
-import top.fatweb.api.service.IUserService
-
-@Service
-class UserDetailsServiceImpl(val userService: IUserService) : UserDetailsService {
- override fun loadUserByUsername(username: String?): UserDetails {
- val user = userService.getOne(KtQueryWrapper(User()).eq(User::username, username))
- user ?: let { throw Exception("Username not found") }
-
- return LoginUser(user)
- }
-}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/util/ApiResponseMappingHandlerMapping.kt b/src/main/kotlin/top/fatweb/api/util/ApiResponseMappingHandlerMapping.kt
deleted file mode 100644
index 8dafc0e..0000000
--- a/src/main/kotlin/top/fatweb/api/util/ApiResponseMappingHandlerMapping.kt
+++ /dev/null
@@ -1,31 +0,0 @@
-package top.fatweb.api.util
-
-import org.springframework.web.bind.annotation.RequestMapping
-import org.springframework.web.servlet.mvc.condition.RequestCondition
-import org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping
-import top.fatweb.api.annotation.ApiVersion
-import java.lang.reflect.Method
-
-class ApiResponseMappingHandlerMapping : RequestMappingHandlerMapping() {
- private val versionFlag = "{apiVersion}"
-
- private fun createCondition(clazz: Class<*>): RequestCondition? {
- val classRequestMapping = clazz.getAnnotation(RequestMapping::class.java)
- classRequestMapping ?: let { return null }
- val mappingUrlBuilder = StringBuilder()
- if (classRequestMapping.value.isNotEmpty()) {
- mappingUrlBuilder.append(classRequestMapping.value[0])
- }
- val mappingUrl = mappingUrlBuilder.toString()
- if (!mappingUrl.contains(versionFlag)) {
- return null
- }
- val apiVersion = clazz.getAnnotation(ApiVersion::class.java)
-
- return if (apiVersion == null) ApiVersionCondition(1) else ApiVersionCondition(apiVersion.version)
- }
-
- override fun getCustomMethodCondition(method: Method): RequestCondition<*>? = createCondition(method.javaClass)
-
- override fun getCustomTypeCondition(handlerType: Class<*>): RequestCondition<*>? = createCondition(handlerType)
-}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/util/RedisUtil.kt b/src/main/kotlin/top/fatweb/api/util/RedisUtil.kt
deleted file mode 100644
index 35991a8..0000000
--- a/src/main/kotlin/top/fatweb/api/util/RedisUtil.kt
+++ /dev/null
@@ -1,183 +0,0 @@
-package top.fatweb.api.util
-
-import org.springframework.data.redis.core.BoundSetOperations
-import org.springframework.data.redis.core.RedisTemplate
-import org.springframework.stereotype.Component
-import java.util.concurrent.TimeUnit
-
-@Suppress("UNCHECKED_CAST")
-@Component
-class RedisUtil(private val redisTemplate: RedisTemplate) {
- /**
- * 设置有效时间
- *
- * @param key 缓存的键
- * @param timeout 超时时间
- * @param timeUnit 时间颗粒度
- * @return true=设置成功；false=设置失败
- */
- fun setExpire(key: String, timeout: Long, timeUnit: TimeUnit = TimeUnit.SECONDS) =
- redisTemplate.expire(key, timeout, timeUnit)
-
- /**
- * 获取有效时间
- *
- * @param key 缓存的键
- * @return 有效时间
- */
- fun getExpire(key: String, timeUnit: TimeUnit = TimeUnit.SECONDS) = redisTemplate.getExpire(key, timeUnit)
-
- /**
- * 判断 key 是否存在
- *
- * @param key 缓存的键
- * @return true=存在; false=不存在
- */
- fun hasKey(key: String) = redisTemplate.hasKey(key)
-
- /**
- * 获得缓存的基本对象列表
- *
- * @param pattern 字符串前缀
- * @return 对象列表
- */
- fun keys(pattern: String): Set = redisTemplate.keys(pattern)
-
- /**
- * 缓存基本的对象，Integer、String、实体类等
- *
- * @param key 缓存的键
- * @param value 缓存的值
- */
- fun setObject(key: String, value: Any) = redisTemplate.opsForValue().set(key, value)
-
- /**
- * 缓存基本的对象，Integer、String、实体类等
- *
- * @param key 缓存的键
- * @param value 缓存的值
- * @param timeout 超时时间
- * @param timeUnit 时间颗粒度
- */
- fun setObject(key: String, value: Any, timeout: Long, timeUnit: TimeUnit = TimeUnit.SECONDS) =
- redisTemplate.opsForValue().set(key, value, timeout, timeUnit)
-
-
- /**
- * 获得缓存的基本对象
- *
- * @param key 缓存的键
- * @return 缓存的值
- */
- fun getObject(key: String) = redisTemplate.opsForValue().get(key) as? T
-
- /**
- * 删除单个对象
- *
- * @param key 缓存的键
- * @return true=删除成功；false=删除失败
- */
- fun delObject(key: String) = redisTemplate.delete(key)
-
- /**
- * 删除对象集合
- *
- * @param collection 键集合
- * @return 删除个数
- */
- fun delObject(collection: Collection) = redisTemplate.delete(collection)
-
- /**
- * 缓存 List 数据
- *
- * @param key 缓存的键
- * @param dataList 缓存的 List 数据
- * @return 缓存的个数
- */
- fun setList(key: String, dataList: List) = redisTemplate.opsForList().rightPushAll(key, dataList)
-
- /**
- * 获得缓存的 List 数据
- *
- * @param key 缓存的键
- * @return 缓存的键对应的 List 数据
- */
- fun getList(key: String): List? = redisTemplate.opsForList().range(key, 0, -1) as? List
-
- /**
- * 缓存 Set 数据
- *
- * @param key 缓存的键
- * @param dataSet 缓存的 Set 数据
- * @return 缓存数据的对象
- */
- fun setSet(key: String, dataSet: Set): BoundSetOperations {
- val boundSetOps: BoundSetOperations = redisTemplate.boundSetOps(key)
- for (data in dataSet) {
- boundSetOps.add(data)
- }
- return boundSetOps
- }
-
- /**
- * 获得缓存的 Set 数据
- *
- * @param key 缓存的键
- * @return 缓存的键对应的 Set 数据
- */
- fun getSet(key: String): Set? = redisTemplate.opsForSet().members(key) as? Set
-
- /**
- * 缓存 Map 数据
- *
- * @param key 缓存的键
- * @param dataMap 缓存的 Map 数据
- */
- fun setMap(key: String, dataMap: Map) = redisTemplate.opsForHash().putAll(key, dataMap)
-
- /**
- * 获得缓存的 Map 数据
- *
- * @param key 缓存的键
- * @return 缓存的键对应的 Map 数据
- */
- fun getMap(key: String): Map? =
- redisTemplate.opsForHash().entries(key) as? Map
-
- /**
- * 往 Hash 中存入数据
- *
- * @param key Redis 键
- * @param hKey Hash 键
- * @param value 值
- */
- fun setMapValue(key: String, hKey: String, value: Any) =
- redisTemplate.opsForHash().put(key, hKey, value)
-
- /**
- * 获取 Hash 中的数据
- *
- * @param key Redis 键
- * @param hKey Hash 键
- * @return Hash 中的对象
- */
- fun getMapValue(key: String, hKey: String) = redisTemplate.opsForHash().get(key, hKey)
-
- /**
- * 删除 Hash 中的数据
- *
- * @param key Redis 键
- * @param hKey Hash 键
- */
- fun delMapValue(key: String, hKey: String) = redisTemplate.opsForHash().delete(key, hKey)
-
- /**
- * 获取多个 Hash 中的数据
- *
- * @param key Redis 键
- * @param hKeys Hash 键集合
- * @return Hash 对象集合
- */
- fun getMultiMapValue(key: String, hKeys: Collection): List =
- redisTemplate.opsForHash().multiGet(key, hKeys)
-}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/util/WebUtil.kt b/src/main/kotlin/top/fatweb/api/util/WebUtil.kt
deleted file mode 100644
index da37681..0000000
--- a/src/main/kotlin/top/fatweb/api/util/WebUtil.kt
+++ /dev/null
@@ -1,16 +0,0 @@
-package top.fatweb.api.util
-
-import jakarta.servlet.http.HttpServletRequest
-import org.springframework.security.core.context.SecurityContextHolder
-import top.fatweb.api.constant.SecurityConstants
-import top.fatweb.api.entity.permission.LoginUser
-
-object WebUtil {
- fun getLoginUser() = SecurityContextHolder.getContext().authentication.principal as LoginUser
-
- fun getLoginUserId() = getLoginUser().user.id
-
- fun getToken(tokenWithPrefix: String) = tokenWithPrefix.removePrefix(SecurityConstants.tokenPrefix)
-
- fun getToken(request: HttpServletRequest) = getToken(request.getHeader(SecurityConstants.headerString))
-}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/vo/LoginVo.kt b/src/main/kotlin/top/fatweb/api/vo/LoginVo.kt
deleted file mode 100644
index 8727d54..0000000
--- a/src/main/kotlin/top/fatweb/api/vo/LoginVo.kt
+++ /dev/null
@@ -1,11 +0,0 @@
-package top.fatweb.api.vo
-
-import io.swagger.v3.oas.annotations.media.Schema
-
-@Schema(description = "登录返回参数")
-data class LoginVo(
- @Schema(
- description = "Token",
- example = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJkYTllYjFkYmVmZDQ0OWRkOThlOGNjNzZlNzZkMDgyNSIsInN1YiI6IjE3MDk5ODYwNTg2Nzk5NzU5MzgiLCJpc3MiOiJGYXRXZWIiLCJpYXQiOjE2OTY1MjgxMTcsImV4cCI6MTY5NjUzNTMxN30.U2ZsyrGk7NbsP-DJfdz9xgWSfect5r2iKQnlEsscAA8"
- ) val token: String
-)
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/OxygenApiApplication.kt b/src/main/kotlin/top/fatweb/oxygen/api/OxygenApiApplication.kt
new file mode 100644
index 0000000..146c2fb
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/OxygenApiApplication.kt
@@ -0,0 +1,67 @@
+package top.fatweb.oxygen.api
+
+import org.slf4j.LoggerFactory
+import org.springframework.boot.autoconfigure.SpringBootApplication
+import org.springframework.boot.runApplication
+import org.springframework.scheduling.annotation.EnableScheduling
+import org.springframework.transaction.annotation.EnableTransactionManagement
+import java.io.File
+import java.util.*
+
+/**
+ * Application main class
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+@SpringBootApplication
+@EnableTransactionManagement
+@EnableScheduling
+class OxygenApiApplication
+
+/**
+ * Main function
+ *
+ * @param args
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+fun main(args: Array) {
+ val logger = LoggerFactory.getLogger("main")
+
+ if (!File("data").isDirectory) {
+ if (!File("data").mkdir()) {
+ logger.error("Can not create directory 'data', please try again later.")
+ return
+ }
+ }
+
+ if (!File("data/db").isDirectory) {
+ if (!File("data/db").mkdir()) {
+ logger.error("Can not create directory 'data/db', please try again later.")
+ return
+ }
+ }
+
+ if (!File("data/db/sqlite.db").isFile || File("data/db/sqlite.db").inputStream()
+ .use { it.readNBytes(15).toString(Charsets.UTF_8) != "SQLite format 3" }
+ ) {
+ logger.warn("The 'data/db/sqlite.db' database is lost or damaged, recreating...")
+ if (File("data/db/sqlite.db").exists() && !File("data/db/sqlite.db").delete()) {
+ logger.error("Can not recreate database 'data/db/sqlite.db', please try again later.")
+ }
+ }
+
+ if (File("application-config.yml").exists() || File("data/application-config.yml").exists()) {
+ runApplication(*args)
+ } else {
+ logger.warn("File 'application-config.yml' cannot be found in the running path or the data path. The configuration file template 'application-config.example.yml' has been created in directory 'data'. Please change the configuration file content, move it to the running path, rename it to 'application-config.yml', and then restart the server.")
+ OxygenApiApplication::class.java.getResource("/application-config-template.yml")?.readText()?.let {
+ File("data/application-config.example.yml").writeText(
+ it.replace(
+ "\$uuid\$", UUID.randomUUID().toString().replace("-", "")
+ )
+ )
+ }
+ }
+}
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/annotation/ApiController.kt b/src/main/kotlin/top/fatweb/oxygen/api/annotation/ApiController.kt
new file mode 100644
index 0000000..5805c4e
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/annotation/ApiController.kt
@@ -0,0 +1,32 @@
+package top.fatweb.oxygen.api.annotation
+
+import io.swagger.v3.oas.annotations.tags.Tag
+import org.springframework.core.annotation.AliasFor
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+/**
+ * API controller annotation
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see Tag
+ * @see RequestMapping
+ * @see RestController
+ */
+@Tag(name = "")
+@RequestMapping
+@RestController
+@Target(AnnotationTarget.CLASS)
+@Retention(AnnotationRetention.RUNTIME)
+annotation class ApiController(
+ val version: Int = 1,
+
+ @get:AliasFor(annotation = RestController::class, attribute = "value") val value: String = "",
+
+ @get:AliasFor(annotation = RequestMapping::class, attribute = "path") val path: Array = [""],
+
+ @get:AliasFor(annotation = Tag::class, attribute = "name") val name: String,
+
+ @get:AliasFor(annotation = Tag::class, attribute = "description") val description: String
+)
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/annotation/BaseController.kt b/src/main/kotlin/top/fatweb/oxygen/api/annotation/BaseController.kt
new file mode 100644
index 0000000..598555d
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/annotation/BaseController.kt
@@ -0,0 +1,27 @@
+package top.fatweb.oxygen.api.annotation
+
+import io.swagger.v3.oas.annotations.tags.Tag
+import org.springframework.core.annotation.AliasFor
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+/**
+ * Base controller annotation
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see RequestMapping
+ * @see RestController
+ */
+@Tag(name = "")
+@RequestMapping
+@RestController
+@Target(AnnotationTarget.CLASS)
+@Retention(AnnotationRetention.RUNTIME)
+annotation class BaseController(
+ @get:AliasFor(annotation = RequestMapping::class, attribute = "path") val path: Array = [""],
+
+ @get:AliasFor(annotation = Tag::class, attribute = "name") val name: String,
+
+ @get:AliasFor(annotation = Tag::class, attribute = "description") val description: String
+)
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/annotation/EventLogRecord.kt b/src/main/kotlin/top/fatweb/oxygen/api/annotation/EventLogRecord.kt
new file mode 100644
index 0000000..f0e023b
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/annotation/EventLogRecord.kt
@@ -0,0 +1,15 @@
+package top.fatweb.oxygen.api.annotation
+
+import top.fatweb.oxygen.api.entity.system.EventLog
+
+/**
+ * Event log record annotation
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+@Target(AnnotationTarget.FUNCTION)
+@Retention(AnnotationRetention.RUNTIME)
+annotation class EventLogRecord(
+ val event: EventLog.Event
+)
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/annotation/HiddenController.kt b/src/main/kotlin/top/fatweb/oxygen/api/annotation/HiddenController.kt
new file mode 100644
index 0000000..90287fb
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/annotation/HiddenController.kt
@@ -0,0 +1,24 @@
+package top.fatweb.oxygen.api.annotation
+
+import io.swagger.v3.oas.annotations.Hidden
+import org.springframework.core.annotation.AliasFor
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+/**
+ * Hidden controller annotation
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see Hidden
+ * @see RequestMapping
+ * @see RestController
+ */
+@Hidden
+@RequestMapping
+@RestController
+@Target(AnnotationTarget.CLASS)
+@Retention(AnnotationRetention.RUNTIME)
+annotation class HiddenController(
+ @get:AliasFor(annotation = RequestMapping::class, attribute = "path") val path: Array = [""]
+)
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/aop/EventLogAspect.kt b/src/main/kotlin/top/fatweb/oxygen/api/aop/EventLogAspect.kt
new file mode 100644
index 0000000..c9710e5
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/aop/EventLogAspect.kt
@@ -0,0 +1,58 @@
+package top.fatweb.oxygen.api.aop
+
+import org.aspectj.lang.JoinPoint
+import org.aspectj.lang.annotation.AfterReturning
+import org.aspectj.lang.annotation.Aspect
+import org.aspectj.lang.annotation.Pointcut
+import org.aspectj.lang.reflect.MethodSignature
+import org.springframework.stereotype.Component
+import top.fatweb.oxygen.api.annotation.EventLogRecord
+import top.fatweb.oxygen.api.service.system.IEventLogService
+import top.fatweb.oxygen.api.util.WebUtil
+import top.fatweb.oxygen.api.vo.permission.LoginVo
+import top.fatweb.oxygen.api.vo.permission.RegisterVo
+
+/**
+ * Event log record aspect
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IEventLogService
+ */
+@Aspect
+@Component
+class EventLogAspect(
+ private val eventLogService: IEventLogService
+) {
+ /**
+ * Event log record pointcut
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @Pointcut("@annotation(top.fatweb.oxygen.api.annotation.EventLogRecord)")
+ fun eventLogPointcut() {
+ }
+
+ /**
+ * Do after event log record pointcut
+ *
+ * @param joinPoint Join point
+ * @param retValue Return value
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see JoinPoint
+ */
+ @AfterReturning(value = "eventLogPointcut()", returning = "retValue")
+ fun doAfter(joinPoint: JoinPoint, retValue: Any?) {
+ val annotation = (joinPoint.signature as MethodSignature).method.getAnnotation(EventLogRecord::class.java)
+
+ val userId = WebUtil.getLoginUserId() ?: when (retValue) {
+ is LoginVo -> retValue.userId!!
+ is RegisterVo -> retValue.userId!!
+ else -> -1
+ }
+
+ eventLogService.saveEvent(annotation, userId)
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/config/DateFormatConfig.kt b/src/main/kotlin/top/fatweb/oxygen/api/config/DateFormatConfig.kt
new file mode 100644
index 0000000..2e908a8
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/config/DateFormatConfig.kt
@@ -0,0 +1,59 @@
+package top.fatweb.oxygen.api.config
+
+import com.fasterxml.jackson.databind.SerializationFeature
+import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateTimeSerializer
+import org.springframework.beans.factory.annotation.Value
+import org.springframework.boot.autoconfigure.jackson.Jackson2ObjectMapperBuilderCustomizer
+import org.springframework.boot.jackson.JsonComponent
+import org.springframework.context.annotation.Bean
+import java.text.DateFormat
+import java.text.SimpleDateFormat
+import java.time.LocalDateTime
+import java.time.format.DateTimeFormatter
+import java.util.*
+
+/**
+ * Date format configuration
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+@JsonComponent
+class DateFormatConfig {
+ /**
+ * The format of the time in response when request APIs
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @set:Value("\${spring.jackson.date-format}")
+ lateinit var dateFormat: String
+
+ /**
+ * The timezone of the time in response when request APIs
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see TimeZone
+ */
+ @set:Value("\${spring.jackson.time-zone}}")
+ lateinit var timeZone: TimeZone
+
+ @Bean
+ fun jackson2ObjectMapperBuilder() = Jackson2ObjectMapperBuilderCustomizer {
+ val tz = timeZone
+ val df: DateFormat = SimpleDateFormat(dateFormat)
+ df.timeZone = tz
+ it.failOnEmptyBeans(false).failOnUnknownProperties(false)
+ .featuresToDisable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS).dateFormat(df)
+ }
+
+ @Bean
+ fun jackson2ObjectMapperBuilderCustomizer() =
+ Jackson2ObjectMapperBuilderCustomizer {
+ it.serializerByType(
+ LocalDateTime::class.java, LocalDateTimeSerializer(DateTimeFormatter.ofPattern(dateFormat))
+ )
+ }
+
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/config/FilterConfig.kt b/src/main/kotlin/top/fatweb/oxygen/api/config/FilterConfig.kt
similarity index 74%
rename from src/main/kotlin/top/fatweb/api/config/FilterConfig.kt
rename to src/main/kotlin/top/fatweb/oxygen/api/config/FilterConfig.kt
index 71374f9..7b1883b 100644
--- a/src/main/kotlin/top/fatweb/api/config/FilterConfig.kt
+++ b/src/main/kotlin/top/fatweb/oxygen/api/config/FilterConfig.kt
@@ -1,10 +1,16 @@
-package top.fatweb.api.config
+package top.fatweb.oxygen.api.config
import org.springframework.boot.web.servlet.FilterRegistrationBean
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
-import top.fatweb.api.filter.ExceptionFilter
+import top.fatweb.oxygen.api.filter.ExceptionFilter
+/**
+ * Filter configuration
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
@Configuration
class FilterConfig {
@Bean
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/config/FlywayConfig.kt b/src/main/kotlin/top/fatweb/oxygen/api/config/FlywayConfig.kt
new file mode 100644
index 0000000..9e34385
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/config/FlywayConfig.kt
@@ -0,0 +1,43 @@
+package top.fatweb.oxygen.api.config
+
+import com.baomidou.dynamic.datasource.DynamicRoutingDataSource
+import jakarta.annotation.PostConstruct
+import org.flywaydb.core.Flyway
+import org.springframework.context.annotation.Configuration
+import org.springframework.context.annotation.DependsOn
+import top.fatweb.oxygen.api.properties.FlywayProperties
+import javax.sql.DataSource
+
+/**
+ * Flyway configuration
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+@DependsOn("flywayProperties")
+@Configuration
+class FlywayConfig(
+ private val dataSource: DataSource
+) {
+ @PostConstruct
+ fun migrateOrder() {
+ val ds = dataSource as DynamicRoutingDataSource
+ ds.dataSources.forEach { (k: String, v: DataSource?) ->
+ val flyway = Flyway.configure()
+ .dataSource(v)
+ .locations(*FlywayProperties.locations.map { "$it/$k" }.toTypedArray())
+ .baselineOnMigrate(FlywayProperties.baselineOnMigrate)
+ .table(FlywayProperties.table)
+ .outOfOrder(FlywayProperties.outOfOrder)
+ .validateOnMigrate(FlywayProperties.validateOnMigrate)
+ .encoding(FlywayProperties.encoding)
+ .sqlMigrationPrefix(FlywayProperties.sqlMigrationPrefix)
+ .sqlMigrationSeparator(FlywayProperties.sqlMigrationSeparator)
+ .sqlMigrationSuffixes(*FlywayProperties.sqlMigrationSuffixes.toTypedArray())
+ .baselineVersion(FlywayProperties.baselineVersion)
+ .load()
+ flyway.migrate()
+ }
+
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/config/InitConfig.kt b/src/main/kotlin/top/fatweb/oxygen/api/config/InitConfig.kt
new file mode 100644
index 0000000..7e4d123
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/config/InitConfig.kt
@@ -0,0 +1,69 @@
+package top.fatweb.oxygen.api.config
+
+import com.baomidou.mybatisplus.extension.kotlin.KtQueryWrapper
+import jakarta.annotation.PostConstruct
+import org.slf4j.Logger
+import org.slf4j.LoggerFactory
+import org.springframework.context.annotation.DependsOn
+import org.springframework.security.crypto.password.PasswordEncoder
+import org.springframework.stereotype.Component
+import top.fatweb.avatargenerator.GitHubAvatar
+import top.fatweb.oxygen.api.entity.permission.User
+import top.fatweb.oxygen.api.entity.permission.UserInfo
+import top.fatweb.oxygen.api.properties.AdminProperties
+import top.fatweb.oxygen.api.service.permission.IUserInfoService
+import top.fatweb.oxygen.api.service.permission.IUserService
+import top.fatweb.oxygen.api.util.StrUtil
+
+/**
+ * Application initialization configuration
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IUserService
+ * @see IUserInfoService
+ * @see PasswordEncoder
+ */
+@DependsOn("adminProperties")
+@Component
+class InitConfig(
+ private val userService: IUserService,
+ private val userInfoService: IUserInfoService,
+ private val passwordEncoder: PasswordEncoder
+) {
+ private val logger: Logger = LoggerFactory.getLogger(this::class.java)
+
+ @PostConstruct
+ fun init() {
+ if (!userService.exists(KtQueryWrapper(User()).eq(User::id, 0))) {
+ userInfoService.remove(KtQueryWrapper(UserInfo()).eq(UserInfo::userId, 0))
+
+ val rawPassword = AdminProperties.password ?: let {
+ logger.warn("No default administrator password is set, a randomly generated password will be used")
+ StrUtil.getRandomPassword(10)
+ }
+ val encodedPassword = passwordEncoder.encode(rawPassword)
+
+ val user = User().apply {
+ id = 0
+ username = AdminProperties.username
+ password = encodedPassword
+ locking = 0
+ enable = 1
+ }
+ val userInfo = UserInfo().apply {
+ userId = 0
+ nickname = AdminProperties.nickname
+ avatar =
+ GitHubAvatar.newAvatarBuilder().build().createAsBase64((Long.MIN_VALUE..Long.MAX_VALUE).random())
+ email = AdminProperties.email
+ }
+
+ if (userService.save(user) && userInfoService.save(userInfo)) {
+ logger.warn("First startup, create administrator - username: admin, password: $rawPassword")
+ logger.warn("This information will only be shown once. Please change your password promptly after logging in.")
+ }
+ }
+
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/config/JacksonConfig.kt b/src/main/kotlin/top/fatweb/oxygen/api/config/JacksonConfig.kt
new file mode 100644
index 0000000..b3518e0
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/config/JacksonConfig.kt
@@ -0,0 +1,28 @@
+package top.fatweb.oxygen.api.config
+
+import com.fasterxml.jackson.annotation.JsonInclude
+import com.fasterxml.jackson.databind.DeserializationFeature
+import com.fasterxml.jackson.databind.json.JsonMapper
+import org.springframework.context.annotation.Bean
+import org.springframework.context.annotation.Configuration
+import retrofit2.converter.jackson.JacksonConverterFactory
+
+/**
+ * Jackson configuration
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+@Configuration
+class JacksonConfig {
+ @Bean
+ fun jacksonConverterFactory(): JacksonConverterFactory {
+ val mapper = JsonMapper.builder()
+ .findAndAddModules()
+ .configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false)
+ .serializationInclusion(JsonInclude.Include.NON_NULL)
+ .build()
+
+ return JacksonConverterFactory.create(mapper)
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/config/MybatisPlusConfig.kt b/src/main/kotlin/top/fatweb/oxygen/api/config/MybatisPlusConfig.kt
similarity index 84%
rename from src/main/kotlin/top/fatweb/api/config/MybatisPlusConfig.kt
rename to src/main/kotlin/top/fatweb/oxygen/api/config/MybatisPlusConfig.kt
index 2ce739c..9d36fe0 100644
--- a/src/main/kotlin/top/fatweb/api/config/MybatisPlusConfig.kt
+++ b/src/main/kotlin/top/fatweb/oxygen/api/config/MybatisPlusConfig.kt
@@ -1,4 +1,4 @@
-package top.fatweb.api.config
+package top.fatweb.oxygen.api.config
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor
import com.baomidou.mybatisplus.extension.plugins.inner.OptimisticLockerInnerInterceptor
@@ -6,6 +6,12 @@ import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerIntercept
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
+/**
+ * Mybatis-plus configuration
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
@Configuration
class MybatisPlusConfig {
@Bean
@@ -16,5 +22,4 @@ class MybatisPlusConfig {
return mybatisPlusInterceptor
}
-
}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/config/RedisConfig.kt b/src/main/kotlin/top/fatweb/oxygen/api/config/RedisConfig.kt
similarity index 93%
rename from src/main/kotlin/top/fatweb/api/config/RedisConfig.kt
rename to src/main/kotlin/top/fatweb/oxygen/api/config/RedisConfig.kt
index 14d3ee0..b22b12f 100644
--- a/src/main/kotlin/top/fatweb/api/config/RedisConfig.kt
+++ b/src/main/kotlin/top/fatweb/oxygen/api/config/RedisConfig.kt
@@ -1,4 +1,4 @@
-package top.fatweb.api.config
+package top.fatweb.oxygen.api.config
import com.fasterxml.jackson.annotation.JsonAutoDetect
import com.fasterxml.jackson.annotation.JsonTypeInfo
@@ -12,6 +12,12 @@ import org.springframework.data.redis.core.RedisTemplate
import org.springframework.data.redis.serializer.Jackson2JsonRedisSerializer
import org.springframework.data.redis.serializer.StringRedisSerializer
+/**
+ * Redis configuration
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
@Configuration
class RedisConfig {
@Bean
diff --git a/src/main/kotlin/top/fatweb/api/config/SecurityConfig.kt b/src/main/kotlin/top/fatweb/oxygen/api/config/SecurityConfig.kt
similarity index 66%
rename from src/main/kotlin/top/fatweb/api/config/SecurityConfig.kt
rename to src/main/kotlin/top/fatweb/oxygen/api/config/SecurityConfig.kt
index 4ab79bc..c62c302 100644
--- a/src/main/kotlin/top/fatweb/api/config/SecurityConfig.kt
+++ b/src/main/kotlin/top/fatweb/oxygen/api/config/SecurityConfig.kt
@@ -1,4 +1,4 @@
-package top.fatweb.api.config
+package top.fatweb.oxygen.api.config
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
@@ -6,23 +6,31 @@ import org.springframework.security.authentication.AuthenticationManager
import org.springframework.security.config.annotation.authentication.configuration.AuthenticationConfiguration
import org.springframework.security.config.annotation.method.configuration.EnableMethodSecurity
import org.springframework.security.config.annotation.web.builders.HttpSecurity
-import org.springframework.security.config.annotation.web.configurers.*
import org.springframework.security.config.http.SessionCreationPolicy
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder
import org.springframework.security.web.SecurityFilterChain
import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter
import org.springframework.web.cors.CorsConfiguration
import org.springframework.web.cors.UrlBasedCorsConfigurationSource
-import top.fatweb.api.filter.JwtAuthenticationTokenFilter
-import top.fatweb.api.handler.JwtAccessDeniedHandler
-import top.fatweb.api.handler.JwtAuthenticationEntryPointHandler
+import top.fatweb.oxygen.api.filter.JwtAuthenticationTokenFilter
+import top.fatweb.oxygen.api.handler.JwtAccessDeniedHandler
+import top.fatweb.oxygen.api.handler.JwtAuthenticationEntryPointHandler
+/**
+ * Spring Security configuration
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see JwtAuthenticationTokenFilter
+ * @see JwtAuthenticationEntryPointHandler
+ * @see JwtAccessDeniedHandler
+ */
@Configuration
@EnableMethodSecurity
class SecurityConfig(
- val jwtAuthenticationTokenFilter: JwtAuthenticationTokenFilter,
- val authenticationEntryPointHandler: JwtAuthenticationEntryPointHandler,
- val accessDeniedHandler: JwtAccessDeniedHandler
+ private val jwtAuthenticationTokenFilter: JwtAuthenticationTokenFilter,
+ private val authenticationEntryPointHandler: JwtAuthenticationEntryPointHandler,
+ private val accessDeniedHandler: JwtAccessDeniedHandler
) {
@Bean
fun passwordEncoder() = BCryptPasswordEncoder()
@@ -47,43 +55,51 @@ class SecurityConfig(
@Bean
fun securityFilterChain(httpSecurity: HttpSecurity): SecurityFilterChain = httpSecurity
// Disable CSRF
- .csrf { csrfConfigurer: CsrfConfigurer -> csrfConfigurer.disable() }
+ .csrf {
+ it.disable()
+ }
// Do not get SecurityContent by Session
- .sessionManagement { sessionManagementConfigurer: SessionManagementConfigurer ->
- sessionManagementConfigurer.sessionCreationPolicy(
+ .sessionManagement {
+ it.sessionCreationPolicy(
SessionCreationPolicy.STATELESS
)
}
- .authorizeHttpRequests { authorizeHttpRequests: AuthorizeHttpRequestsConfigurer.AuthorizationManagerRequestMatcherRegistry ->
- authorizeHttpRequests
+ .authorizeHttpRequests {
+ it
// Allow anonymous access
.requestMatchers(
- "/login",
"/error/thrown",
"/doc.html",
"/swagger-ui/**",
"/webjars/**",
"/v3/**",
"/swagger-ui.html",
- "/favicon.ico"
+ "/favicon.ico",
+ "/login",
+ "/register",
+ "/forget",
+ "/retrieve"
).anonymous()
+ .requestMatchers("/tool/detail/**", "/tool/store", "/tool/store/*", "/system/user/info/*").permitAll()
// Authentication required
.anyRequest().authenticated()
}
- .logout { logoutConfigurer: LogoutConfigurer -> logoutConfigurer.disable() }
+ .logout {
+ it.disable()
+ }
- .exceptionHandling { exceptionHandlingConfigurer: ExceptionHandlingConfigurer ->
- exceptionHandlingConfigurer.authenticationEntryPoint(
+ .exceptionHandling {
+ it.authenticationEntryPoint(
authenticationEntryPointHandler
)
- exceptionHandlingConfigurer.accessDeniedHandler(
+ it.accessDeniedHandler(
accessDeniedHandler
)
}
- .cors { cors: CorsConfigurer ->
- cors.configurationSource(
+ .cors {
+ it.configurationSource(
corsConfigurationSource()
)
}
diff --git a/src/main/kotlin/top/fatweb/api/config/SwaggerConfig.kt b/src/main/kotlin/top/fatweb/oxygen/api/config/SwaggerConfig.kt
similarity index 54%
rename from src/main/kotlin/top/fatweb/api/config/SwaggerConfig.kt
rename to src/main/kotlin/top/fatweb/oxygen/api/config/SwaggerConfig.kt
index fde4588..af0ca61 100644
--- a/src/main/kotlin/top/fatweb/api/config/SwaggerConfig.kt
+++ b/src/main/kotlin/top/fatweb/oxygen/api/config/SwaggerConfig.kt
@@ -1,22 +1,27 @@
-package top.fatweb.api.config
+package top.fatweb.oxygen.api.config
import io.swagger.v3.oas.models.OpenAPI
import io.swagger.v3.oas.models.info.Contact
import io.swagger.v3.oas.models.info.Info
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
-import top.fatweb.api.constant.ServerConstants
+import top.fatweb.oxygen.api.properties.ServerProperties
+/**
+ * Swagger API doc configuration
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
@Configuration
class SwaggerConfig {
-
@Bean
fun customOpenAPI(): OpenAPI? {
- val contact = Contact().name("FatttSnake").url("https://fatweb.top").email("fatttsnake@fatweb.top")
+ val contact = Contact().name("FatttSnake").url("https://fatweb.top").email("fatttsnake@gmail.com")
return OpenAPI().info(
- Info().title("FatWeb API 文档").description("FatWeb 后端 API 文档，包含各个 Controller 调用信息")
+ Info().title("Oxygen API 文档").description("Oxygen 后端 API 文档，包含各个 Controller 调用信息")
.contact(contact).version(
- ServerConstants.version
+ ServerProperties.version
)
)
}
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/config/SysLogConfig.kt b/src/main/kotlin/top/fatweb/oxygen/api/config/SysLogConfig.kt
new file mode 100644
index 0000000..fbd40c3
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/config/SysLogConfig.kt
@@ -0,0 +1,24 @@
+package top.fatweb.oxygen.api.config
+
+import org.springframework.context.annotation.Configuration
+import org.springframework.web.servlet.config.annotation.InterceptorRegistry
+import org.springframework.web.servlet.config.annotation.WebMvcConfigurer
+import top.fatweb.oxygen.api.interceptor.SysLogInterceptor
+
+/**
+ * System log configuration
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see SysLogInterceptor
+ * @see WebMvcConfigurer
+ */
+@Configuration
+class SysLogConfig(
+ private val sysLogInterceptor: SysLogInterceptor
+) : WebMvcConfigurer {
+ override fun addInterceptors(registry: InterceptorRegistry) {
+ registry.addInterceptor(sysLogInterceptor).addPathPatterns("/**")
+ .excludePathPatterns("/error/thrown", "/webjars/**")
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/config/VelocityEngineConfig.kt b/src/main/kotlin/top/fatweb/oxygen/api/config/VelocityEngineConfig.kt
new file mode 100644
index 0000000..0995ada
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/config/VelocityEngineConfig.kt
@@ -0,0 +1,23 @@
+package top.fatweb.oxygen.api.config
+
+import org.apache.velocity.app.VelocityEngine
+import org.apache.velocity.runtime.RuntimeConstants
+import org.apache.velocity.runtime.resource.loader.ClasspathResourceLoader
+import org.springframework.context.annotation.Bean
+import org.springframework.context.annotation.Configuration
+
+/**
+ * Velocity engine configuration
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+@Configuration
+class VelocityEngineConfig {
+ @Bean
+ fun velocityEngine() = VelocityEngine().apply {
+ setProperty(RuntimeConstants.RESOURCE_LOADER, "classpath")
+ setProperty("classpath.resource.loader.class", ClasspathResourceLoader::class.java.name)
+ init()
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/config/WebMvcConfigurerConfig.kt b/src/main/kotlin/top/fatweb/oxygen/api/config/WebMvcConfigurerConfig.kt
new file mode 100644
index 0000000..604a8ab
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/config/WebMvcConfigurerConfig.kt
@@ -0,0 +1,21 @@
+package top.fatweb.oxygen.api.config
+
+import org.springframework.boot.autoconfigure.web.servlet.WebMvcRegistrations
+import org.springframework.context.annotation.Configuration
+import org.springframework.web.servlet.config.annotation.PathMatchConfigurer
+import org.springframework.web.servlet.config.annotation.WebMvcConfigurer
+import top.fatweb.oxygen.api.annotation.ApiController
+
+/**
+ * Web MVC configurer configuration
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see WebMvcRegistrations
+ */
+@Configuration
+class WebMvcConfigurerConfig : WebMvcConfigurer {
+ override fun configurePathMatch(configurer: PathMatchConfigurer) {
+ configurer.addPathPrefix("/api/{API_VERSION}") { it.isAnnotationPresent(ApiController::class.java) }
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/api/config/WebMvcRegistrationsConfig.kt b/src/main/kotlin/top/fatweb/oxygen/api/config/WebMvcRegistrationsConfig.kt
similarity index 63%
rename from src/main/kotlin/top/fatweb/api/config/WebMvcRegistrationsConfig.kt
rename to src/main/kotlin/top/fatweb/oxygen/api/config/WebMvcRegistrationsConfig.kt
index 1db6a0f..f65a30c 100644
--- a/src/main/kotlin/top/fatweb/api/config/WebMvcRegistrationsConfig.kt
+++ b/src/main/kotlin/top/fatweb/oxygen/api/config/WebMvcRegistrationsConfig.kt
@@ -1,10 +1,17 @@
-package top.fatweb.api.config
+package top.fatweb.oxygen.api.config
import org.springframework.boot.autoconfigure.web.servlet.WebMvcRegistrations
import org.springframework.context.annotation.Configuration
import org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping
-import top.fatweb.api.util.ApiResponseMappingHandlerMapping
+import top.fatweb.oxygen.api.util.ApiResponseMappingHandlerMapping
+/**
+ * Web MVC registrations configuration
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see WebMvcRegistrations
+ */
@Configuration
class WebMvcRegistrationsConfig : WebMvcRegistrations {
override fun getRequestMappingHandlerMapping(): RequestMappingHandlerMapping = ApiResponseMappingHandlerMapping()
diff --git a/src/main/kotlin/top/fatweb/api/controller/ExceptionController.kt b/src/main/kotlin/top/fatweb/oxygen/api/controller/ExceptionController.kt
similarity index 56%
rename from src/main/kotlin/top/fatweb/api/controller/ExceptionController.kt
rename to src/main/kotlin/top/fatweb/oxygen/api/controller/ExceptionController.kt
index e5dfad2..c61cceb 100644
--- a/src/main/kotlin/top/fatweb/api/controller/ExceptionController.kt
+++ b/src/main/kotlin/top/fatweb/oxygen/api/controller/ExceptionController.kt
@@ -1,13 +1,16 @@
-package top.fatweb.api.controller
+package top.fatweb.oxygen.api.controller
-import io.swagger.v3.oas.annotations.Hidden
import jakarta.servlet.http.HttpServletRequest
import org.springframework.web.bind.annotation.RequestMapping
-import org.springframework.web.bind.annotation.RestController
+import top.fatweb.oxygen.api.annotation.HiddenController
-@Hidden
-@RestController
-@RequestMapping("/error")
+/**
+ * Exception controller
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+@HiddenController(["/error"])
class ExceptionController {
@RequestMapping("/thrown")
fun thrown(request: HttpServletRequest) {
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/controller/api/v1/AvatarController.kt b/src/main/kotlin/top/fatweb/oxygen/api/controller/api/v1/AvatarController.kt
new file mode 100644
index 0000000..0747aff
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/controller/api/v1/AvatarController.kt
@@ -0,0 +1,204 @@
+package top.fatweb.oxygen.api.controller.api.v1
+
+import io.swagger.v3.oas.annotations.Operation
+import jakarta.validation.Valid
+import org.springframework.http.MediaType
+import org.springframework.web.bind.annotation.GetMapping
+import top.fatweb.oxygen.api.annotation.ApiController
+import top.fatweb.oxygen.api.entity.common.ResponseCode
+import top.fatweb.oxygen.api.entity.common.ResponseResult
+import top.fatweb.oxygen.api.param.api.v1.avatar.AvatarBaseParam
+import top.fatweb.oxygen.api.param.api.v1.avatar.AvatarGitHubParam
+import top.fatweb.oxygen.api.service.api.v1.IAvatarService
+import top.fatweb.oxygen.api.vo.api.v1.avatar.AvatarBase64Vo
+
+/**
+ * Avatar controller
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IAvatarService
+ */
+@ApiController(value = "avatarControllerV1", path = ["/avatar"], name = "随机头像 V1", description = "随机头像相关接口")
+class AvatarController(
+ private val avatarService: IAvatarService
+) {
+ /**
+ * Get random avatar
+ *
+ * @param avatarBaseParam Avatar base parameters
+ * @return Avatar byte array
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see AvatarBaseParam
+ * @see ByteArray
+ */
+ @Operation(summary = "获取随机头像")
+ @GetMapping(produces = [MediaType.IMAGE_PNG_VALUE])
+ fun getRandom(@Valid avatarBaseParam: AvatarBaseParam?): ByteArray =
+ avatarService.random(avatarBaseParam)
+
+ /**
+ * Get random avatar as base64
+ *
+ * @param avatarBaseParam Avatar base parameters
+ * @return Response object includes avatar base64 string
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see AvatarBaseParam
+ * @see ResponseResult
+ * @see AvatarBase64Vo
+ */
+ @Operation(summary = "获取随机头像 Base64")
+ @GetMapping("base64")
+ fun getRandomBase64(
+ @Valid avatarBaseParam: AvatarBaseParam?
+ ): ResponseResult =
+ ResponseResult.success(
+ ResponseCode.API_AVATAR_SUCCESS, data = avatarService.randomBase64(avatarBaseParam)
+ )
+
+ /**
+ * Get triangle avatar
+ *
+ * @param avatarBaseParam Avatar base parameters
+ * @return Avatar byte array
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see AvatarBaseParam
+ * @see ByteArray
+ */
+ @Operation(summary = "三角形头像")
+ @GetMapping("/triangle", produces = [MediaType.IMAGE_PNG_VALUE])
+ fun triangle(@Valid avatarBaseParam: AvatarBaseParam?): ByteArray =
+ avatarService.triangle(avatarBaseParam)
+
+ /**
+ * Get triangle avatar as base64
+ *
+ * @param avatarBaseParam Avatar base parameters
+ * @return Response object includes avatar base64 string
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see AvatarBaseParam
+ * @see ResponseResult
+ * @see AvatarBase64Vo
+ */
+ @Operation(summary = "三角形头像 Base64")
+ @GetMapping("/triangle/base64")
+ fun triangleBase64(
+ @Valid avatarBaseParam: AvatarBaseParam?
+ ): ResponseResult =
+ ResponseResult.success(
+ ResponseCode.API_AVATAR_SUCCESS,
+ data = avatarService.triangleBase64(avatarBaseParam)
+ )
+
+ /**
+ * Get square avatar
+ *
+ * @param avatarBaseParam Avatar base parameters
+ * @return Avatar byte array
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see AvatarBaseParam
+ * @see ByteArray
+ */
+ @Operation(summary = "正方形头像")
+ @GetMapping("/square", produces = [MediaType.IMAGE_PNG_VALUE])
+ fun square(@Valid avatarBaseParam: AvatarBaseParam?): ByteArray =
+ avatarService.square(avatarBaseParam)
+
+ /**
+ * Get square avatar as base64
+ *
+ * @param avatarBaseParam Avatar base parameters
+ * @return Response object includes avatar base64 string
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see AvatarBaseParam
+ * @see ResponseResult
+ * @see AvatarBase64Vo
+ */
+ @Operation(summary = "正方形头像 Base64")
+ @GetMapping("/square/base64")
+ fun squareBase64(
+ @Valid avatarBaseParam: AvatarBaseParam?
+ ): ResponseResult =
+ ResponseResult.success(
+ ResponseCode.API_AVATAR_SUCCESS,
+ data = avatarService.squareBase64(avatarBaseParam)
+ )
+
+ /**
+ * Get identicon avatar
+ *
+ * @param avatarBaseParam Avatar base parameters
+ * @return Avatar byte array
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see AvatarBaseParam
+ * @see ByteArray
+ */
+ @Operation(summary = "Identicon 头像")
+ @GetMapping("/identicon", produces = [MediaType.IMAGE_PNG_VALUE])
+ fun identicon(@Valid avatarBaseParam: AvatarBaseParam?): ByteArray =
+ avatarService.identicon(avatarBaseParam)
+
+ /**
+ * Get identicon avatar as base64
+ *
+ * @param avatarBaseParam Avatar base parameters
+ * @return Response object includes avatar base64 string
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see AvatarBaseParam
+ * @see ResponseResult
+ * @see AvatarBase64Vo
+ */
+ @Operation(summary = "Identicon 头像 Base64")
+ @GetMapping("/identicon/base64")
+ fun identiconBase64(
+ @Valid avatarBaseParam: AvatarBaseParam?
+ ): ResponseResult =
+ ResponseResult.success(
+ ResponseCode.API_AVATAR_SUCCESS,
+ data = avatarService.identiconBase64(avatarBaseParam)
+ )
+
+ /**
+ * Get GitHub avatar
+ *
+ * @param avatarGitHubParam Avatar base parameters
+ * @return Avatar byte array
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see AvatarGitHubParam
+ * @see ByteArray
+ */
+ @Operation(summary = "GitHub 头像")
+ @GetMapping("/github", produces = [MediaType.IMAGE_PNG_VALUE])
+ fun github(@Valid avatarGitHubParam: AvatarGitHubParam?): ByteArray =
+ avatarService.github(avatarGitHubParam)
+
+ /**
+ * Get GitHub avatar as base64
+ *
+ * @param avatarGitHubParam Avatar base parameters
+ * @return Response object includes avatar base64 string
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see AvatarGitHubParam
+ * @see ResponseResult
+ * @see AvatarBase64Vo
+ */
+ @Operation(summary = "GitHub 头像 Base64")
+ @GetMapping("/github/base64")
+ fun githubBase64(
+ @Valid avatarGitHubParam: AvatarGitHubParam?
+ ): ResponseResult =
+ ResponseResult.success(
+ ResponseCode.API_AVATAR_SUCCESS,
+ data = avatarService.githubBase64(avatarGitHubParam)
+ )
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/controller/permission/AuthenticationController.kt b/src/main/kotlin/top/fatweb/oxygen/api/controller/permission/AuthenticationController.kt
new file mode 100644
index 0000000..1d21a2c
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/controller/permission/AuthenticationController.kt
@@ -0,0 +1,187 @@
+package top.fatweb.oxygen.api.controller.permission
+
+import io.swagger.v3.oas.annotations.Operation
+import jakarta.servlet.http.HttpServletRequest
+import jakarta.validation.Valid
+import org.springframework.web.bind.annotation.GetMapping
+import org.springframework.web.bind.annotation.PostMapping
+import org.springframework.web.bind.annotation.RequestBody
+import top.fatweb.oxygen.api.annotation.BaseController
+import top.fatweb.oxygen.api.entity.common.ResponseCode
+import top.fatweb.oxygen.api.entity.common.ResponseResult
+import top.fatweb.oxygen.api.param.permission.*
+import top.fatweb.oxygen.api.service.permission.IAuthenticationService
+import top.fatweb.oxygen.api.util.WebUtil
+import top.fatweb.oxygen.api.vo.permission.LoginVo
+import top.fatweb.oxygen.api.vo.permission.RegisterVo
+import top.fatweb.oxygen.api.vo.permission.TokenVo
+
+/**
+ * Authentication controller
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IAuthenticationService
+ */
+@BaseController(name = "身份认证", description = "身份认证相关接口")
+class AuthenticationController(
+ private val authenticationService: IAuthenticationService
+) {
+ /**
+ * Register
+ *
+ * @param registerParam Register parameters
+ * @return Response object includes user ID
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see RegisterParam
+ * @see ResponseResult
+ * @see RegisterVo
+ */
+ @Operation(summary = "注册")
+ @PostMapping("/register")
+ fun register(
+ request: HttpServletRequest,
+ @Valid @RequestBody registerParam: RegisterParam
+ ): ResponseResult = ResponseResult.success(
+ ResponseCode.PERMISSION_REGISTER_SUCCESS,
+ data = authenticationService.register(request, registerParam)
+ )
+
+
+ /**
+ * Send verify email
+ *
+ * @return Response object includes resend result
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ */
+ @Operation(summary = "发送验证邮件")
+ @PostMapping("/resend")
+ fun resend(): ResponseResult {
+ authenticationService.resend()
+
+ return ResponseResult.success(ResponseCode.PERMISSION_RESEND_SUCCESS)
+ }
+
+ /**
+ * Verify email
+ *
+ * @param verifyParam Verify parameters
+ * @return Response object includes verify result
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see VerifyParam
+ * @see ResponseResult
+ */
+ @Operation(summary = "验证邮箱")
+ @PostMapping("/verify")
+ fun verify(@Valid @RequestBody verifyParam: VerifyParam): ResponseResult {
+ authenticationService.verify(verifyParam)
+
+ return ResponseResult.success(ResponseCode.PERMISSION_VERIFY_SUCCESS)
+ }
+
+ /**
+ * Forget password
+ *
+ * @param request
+ * @param forgetParam Forget parameters
+ * @return Response object includes forget result
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see HttpServletRequest
+ * @see ForgetParam
+ * @see ResponseResult
+ */
+ @Operation(summary = "忘记密码")
+ @PostMapping("/forget")
+ fun forget(request: HttpServletRequest, @Valid @RequestBody forgetParam: ForgetParam): ResponseResult {
+ authenticationService.forget(request, forgetParam)
+
+ return ResponseResult.success(ResponseCode.PERMISSION_FORGET_SUCCESS)
+ }
+
+ /**
+ * Retrieve password
+ *
+ * @param request
+ * @param retrieveParam Retrieve parameters
+ * @return Response object includes retrieve result
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see HttpServletRequest
+ * @see RetrieveParam
+ * @see ResponseResult
+ */
+ @Operation(summary = "找回密码")
+ @PostMapping("/retrieve")
+ fun retrieve(
+ request: HttpServletRequest,
+ @Valid @RequestBody retrieveParam: RetrieveParam
+ ): ResponseResult {
+ authenticationService.retrieve(request, retrieveParam)
+
+ return ResponseResult.success(ResponseCode.PERMISSION_RETRIEVE_SUCCESS)
+ }
+
+ /**
+ * Login
+ *
+ * @param request
+ * @param loginParam Login parameters
+ * @return Response object includes login result
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see HttpServletRequest
+ * @see LoginParam
+ * @see ResponseResult
+ * @see LoginVo
+ */
+ @Operation(summary = "登录")
+ @PostMapping("/login")
+ fun login(request: HttpServletRequest, @Valid @RequestBody loginParam: LoginParam): ResponseResult =
+ ResponseResult.success(
+ ResponseCode.PERMISSION_LOGIN_SUCCESS,
+ "Login success",
+ authenticationService.login(request, loginParam)
+ )
+
+ /**
+ * Logout
+ *
+ * @param request
+ * @return Response object includes logout result
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see HttpServletRequest
+ * @see ResponseResult
+ */
+ @Operation(summary = "登出")
+ @PostMapping("/logout")
+ fun logout(request: HttpServletRequest): ResponseResult =
+ when (authenticationService.logout(WebUtil.getToken(request))) {
+ true -> ResponseResult.success(ResponseCode.PERMISSION_LOGOUT_SUCCESS, "Logout success", null)
+ false -> ResponseResult.fail(ResponseCode.PERMISSION_LOGOUT_FAILED, "Logout failed", null)
+ }
+
+ /**
+ * Renew token
+ *
+ * @param request
+ * @return Response object includes new token
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see HttpServletRequest
+ * @see ResponseResult
+ * @see TokenVo
+ */
+ @Operation(summary = "更新 Token")
+ @GetMapping("/token")
+ fun renewToken(request: HttpServletRequest): ResponseResult = ResponseResult.success(
+ ResponseCode.PERMISSION_TOKEN_RENEW_SUCCESS,
+ "Token renew success",
+ authenticationService.renewToken(WebUtil.getToken(request))
+ )
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/controller/permission/GroupController.kt b/src/main/kotlin/top/fatweb/oxygen/api/controller/permission/GroupController.kt
new file mode 100644
index 0000000..664a928
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/controller/permission/GroupController.kt
@@ -0,0 +1,170 @@
+package top.fatweb.oxygen.api.controller.permission
+
+import io.swagger.v3.oas.annotations.Operation
+import jakarta.validation.Valid
+import org.springframework.security.access.prepost.PreAuthorize
+import org.springframework.web.bind.annotation.*
+import top.fatweb.oxygen.api.annotation.BaseController
+import top.fatweb.oxygen.api.entity.common.ResponseCode
+import top.fatweb.oxygen.api.entity.common.ResponseResult
+import top.fatweb.oxygen.api.param.permission.group.*
+import top.fatweb.oxygen.api.service.permission.IGroupService
+import top.fatweb.oxygen.api.vo.PageVo
+import top.fatweb.oxygen.api.vo.permission.GroupWithRoleVo
+import top.fatweb.oxygen.api.vo.permission.base.GroupVo
+
+/**
+ * Group management controller
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IGroupService
+ */
+@BaseController(path = ["/system/group"], name = "用户组管理", description = "用户组管理相关接口")
+class GroupController(
+ val groupService: IGroupService
+) {
+ /**
+ * Get group by ID
+ *
+ * @param id Group ID
+ * @return Response object includes group information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see GroupWithRoleVo
+ */
+ @Operation(summary = "获取单个用户组")
+ @GetMapping("/{id}")
+ @PreAuthorize("hasAnyAuthority('system:group:query:one')")
+ fun getOne(@PathVariable id: Long): ResponseResult =
+ ResponseResult.databaseSuccess(data = groupService.getOne(id))
+
+ /**
+ * Get group paging information
+ *
+ * @param groupGetParam Get group parameters
+ * @return Response object includes group paging information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see GroupGetParam
+ * @see ResponseResult
+ * @see PageVo
+ * @see GroupWithRoleVo
+ */
+ @Operation(summary = "获取用户组")
+ @GetMapping
+ @PreAuthorize("hasAnyAuthority('system:group:query:all')")
+ fun get(@Valid groupGetParam: GroupGetParam?): ResponseResult> =
+ ResponseResult.databaseSuccess(
+ data = groupService.getPage(groupGetParam)
+ )
+
+ /**
+ * Get group list
+ *
+ * @return Response object includes group list
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see GroupVo
+ */
+ @Operation(summary = "获取用户组列表")
+ @GetMapping("/list")
+ @PreAuthorize("hasAnyAuthority('system:group:query:list', 'system:user:add:one', 'system:user:modify:one')")
+ fun list(): ResponseResult> =
+ ResponseResult.databaseSuccess(
+ data = groupService.getList()
+ )
+
+ /**
+ * Add group
+ *
+ * @param groupAddParam Add group parameters
+ * @return Response object includes group information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see GroupAddParam
+ * @see ResponseResult
+ * @see GroupVo
+ */
+ @Operation(summary = "添加用户组")
+ @PostMapping
+ @PreAuthorize("hasAnyAuthority('system:group:add:one')")
+ fun add(@Valid @RequestBody groupAddParam: GroupAddParam): ResponseResult =
+ ResponseResult.databaseSuccess(
+ ResponseCode.DATABASE_INSERT_SUCCESS, data = groupService.add(groupAddParam)
+ )
+
+ /**
+ * Update group
+ *
+ * @param groupUpdateParam Update group parameters
+ * @return Response object includes group information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see GroupUpdateParam
+ * @see ResponseResult
+ * @see GroupVo
+ */
+ @Operation(summary = "修改用户组")
+ @PutMapping
+ @PreAuthorize("hasAnyAuthority('system:group:modify:one')")
+ fun update(@Valid @RequestBody groupUpdateParam: GroupUpdateParam): ResponseResult =
+ ResponseResult.databaseSuccess(
+ ResponseCode.DATABASE_UPDATE_SUCCESS, data = groupService.update(groupUpdateParam)
+ )
+
+ /**
+ * Update status of group
+ *
+ * @param groupUpdateStatusParam Update status of group parameters
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see GroupUpdateStatusParam
+ * @see ResponseResult
+ */
+ @Operation(summary = "修改用户组状态")
+ @PatchMapping
+ @PreAuthorize("hasAnyAuthority('system:group:modify:status')")
+ fun updateStatus(@Valid @RequestBody groupUpdateStatusParam: GroupUpdateStatusParam): ResponseResult {
+ groupService.status(groupUpdateStatusParam)
+ return ResponseResult.databaseSuccess(ResponseCode.DATABASE_UPDATE_SUCCESS)
+ }
+
+ /**
+ * Delete group by ID
+ *
+ * @param id Group ID
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ */
+ @Operation(summary = "删除用户组")
+ @DeleteMapping("/{id}")
+ @PreAuthorize("hasAnyAuthority('system:group:delete:one')")
+ fun delete(@PathVariable id: Long): ResponseResult {
+ groupService.deleteOne(id)
+ return ResponseResult.databaseSuccess(ResponseCode.DATABASE_DELETE_SUCCESS)
+ }
+
+ /**
+ * Delete group by list
+ *
+ * @param groupDeleteParam Delete group parameters
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see GroupDeleteParam
+ * @see ResponseResult
+ */
+ @Operation(summary = "批量删除用户组")
+ @DeleteMapping
+ @PreAuthorize("hasAnyAuthority('system:group:delete:multiple')")
+ fun deleteList(@Valid @RequestBody groupDeleteParam: GroupDeleteParam): ResponseResult {
+ groupService.delete(groupDeleteParam)
+ return ResponseResult.databaseSuccess(ResponseCode.DATABASE_DELETE_SUCCESS)
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/controller/permission/PowerController.kt b/src/main/kotlin/top/fatweb/oxygen/api/controller/permission/PowerController.kt
new file mode 100644
index 0000000..f4bbd0d
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/controller/permission/PowerController.kt
@@ -0,0 +1,35 @@
+package top.fatweb.oxygen.api.controller.permission
+
+import io.swagger.v3.oas.annotations.Operation
+import org.springframework.security.access.prepost.PreAuthorize
+import org.springframework.web.bind.annotation.GetMapping
+import top.fatweb.oxygen.api.annotation.BaseController
+import top.fatweb.oxygen.api.entity.common.ResponseResult
+import top.fatweb.oxygen.api.service.permission.IPowerService
+import top.fatweb.oxygen.api.vo.permission.PowerSetVo
+
+/**
+ * Power management controller
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IPowerService
+ */
+@BaseController(path = ["/system/power"], name = "权限管理", description = "权限管理相关接口")
+class PowerController(
+ private val powerService: IPowerService
+) {
+ /**
+ * Get power list
+ *
+ * @return Response object includes power list
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see PowerSetVo
+ */
+ @Operation(summary = "获取权限列表")
+ @GetMapping("/list")
+ @PreAuthorize("hasAnyAuthority('system:power:query:list', 'system:role:add:one', 'system:role:modify:one')")
+ fun getList(): ResponseResult = ResponseResult.databaseSuccess(data = powerService.getList())
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/controller/permission/RoleController.kt b/src/main/kotlin/top/fatweb/oxygen/api/controller/permission/RoleController.kt
new file mode 100644
index 0000000..77144e2
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/controller/permission/RoleController.kt
@@ -0,0 +1,170 @@
+package top.fatweb.oxygen.api.controller.permission
+
+import io.swagger.v3.oas.annotations.Operation
+import jakarta.validation.Valid
+import org.springframework.security.access.prepost.PreAuthorize
+import org.springframework.web.bind.annotation.*
+import top.fatweb.oxygen.api.annotation.BaseController
+import top.fatweb.oxygen.api.entity.common.ResponseCode
+import top.fatweb.oxygen.api.entity.common.ResponseResult
+import top.fatweb.oxygen.api.param.permission.role.*
+import top.fatweb.oxygen.api.service.permission.IRoleService
+import top.fatweb.oxygen.api.vo.PageVo
+import top.fatweb.oxygen.api.vo.permission.RoleWithPowerVo
+import top.fatweb.oxygen.api.vo.permission.base.RoleVo
+
+/**
+ * Role management controller
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IRoleService
+ */
+@BaseController(path = ["/system/role"], name = "角色管理", description = "角色管理相关接口")
+class RoleController(
+ private val roleService: IRoleService
+) {
+ /**
+ * Get role by ID
+ *
+ * @param id Role ID
+ * @return Response object includes role information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see RoleWithPowerVo
+ */
+ @Operation(summary = "获取单个角色")
+ @GetMapping("/{id}")
+ @PreAuthorize("hasAnyAuthority('system:role:query:one')")
+ fun getOne(@PathVariable id: Long): ResponseResult =
+ ResponseResult.databaseSuccess(data = roleService.getOne(id))
+
+ /**
+ * Get role paging information
+ *
+ * @param roleGetParam Get role parameters
+ * @return Response object includes role paging information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see RoleGetParam
+ * @see ResponseResult
+ * @see RoleWithPowerVo
+ */
+ @Operation(summary = "获取角色")
+ @GetMapping
+ @PreAuthorize("hasAnyAuthority('system:role:query:all')")
+ fun get(roleGetParam: RoleGetParam?): ResponseResult> =
+ ResponseResult.databaseSuccess(
+ data = roleService.getPage(roleGetParam)
+ )
+
+ /**
+ * Get role list
+ *
+ * @return Response object includes role list
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see RoleVo
+ */
+ @Operation(summary = "获取角色列表")
+ @GetMapping("/list")
+ @PreAuthorize("hasAnyAuthority('system:role:query:list', 'system:group:add:one', 'system:group:modify:one', 'system:user:add:one', 'system:user:modify:one')")
+ fun list(): ResponseResult> {
+ return ResponseResult.databaseSuccess(
+ data = roleService.getList()
+ )
+ }
+
+ /**
+ * Add role
+ *
+ * @param roleAddParam Add role parameters
+ * @return Response object includes role information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see RoleAddParam
+ * @see ResponseResult
+ * @see RoleVo
+ */
+ @Operation(summary = "添加角色")
+ @PostMapping
+ @PreAuthorize("hasAnyAuthority('system:role:add:one')")
+ fun add(@Valid @RequestBody roleAddParam: RoleAddParam): ResponseResult =
+ ResponseResult.databaseSuccess(
+ ResponseCode.DATABASE_INSERT_SUCCESS, data = roleService.add(roleAddParam)
+ )
+
+ /**
+ * Update role
+ *
+ * @param roleUpdateParam Update role parameters
+ * @return Response object includes role information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see RoleUpdateParam
+ * @see ResponseResult
+ * @see RoleVo
+ */
+ @Operation(summary = "修改角色")
+ @PutMapping
+ @PreAuthorize("hasAnyAuthority('system:role:modify:one')")
+ fun update(@Valid @RequestBody roleUpdateParam: RoleUpdateParam): ResponseResult =
+ ResponseResult.databaseSuccess(
+ ResponseCode.DATABASE_UPDATE_SUCCESS, data = roleService.update(roleUpdateParam)
+ )
+
+ /**
+ * Update status of role
+ *
+ * @param roleUpdateStatusParam Update status of role parameters
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see RoleUpdateStatusParam
+ * @see ResponseResult
+ */
+ @Operation(summary = "修改角色状态")
+ @PatchMapping
+ @PreAuthorize("hasAnyAuthority('system:role:modify:status')")
+ fun status(@Valid @RequestBody roleUpdateStatusParam: RoleUpdateStatusParam): ResponseResult {
+ roleService.status(roleUpdateStatusParam)
+ return ResponseResult.databaseSuccess(ResponseCode.DATABASE_UPDATE_SUCCESS)
+ }
+
+ /**
+ * Delete role by ID
+ *
+ * @param id
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ */
+ @Operation(summary = "删除角色")
+ @DeleteMapping("/{id}")
+ @PreAuthorize("hasAnyAuthority('system:role:delete:one')")
+ fun delete(@PathVariable id: Long): ResponseResult {
+ roleService.deleteOne(id)
+ return ResponseResult.databaseSuccess(ResponseCode.DATABASE_DELETE_SUCCESS)
+ }
+
+ /**
+ * Delete role by list
+ *
+ * @param roleDeleteParam Delete role parameters
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see RoleDeleteParam
+ * @see ResponseResult
+ */
+ @Operation(summary = "批量删除角色")
+ @DeleteMapping
+ @PreAuthorize("hasAnyAuthority('system:role:delete:multiple')")
+ fun deleteList(@Valid @RequestBody roleDeleteParam: RoleDeleteParam): ResponseResult {
+ roleService.delete(roleDeleteParam)
+ return ResponseResult.databaseSuccess(ResponseCode.DATABASE_DELETE_SUCCESS)
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/controller/permission/UserController.kt b/src/main/kotlin/top/fatweb/oxygen/api/controller/permission/UserController.kt
new file mode 100644
index 0000000..e7c4490
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/controller/permission/UserController.kt
@@ -0,0 +1,217 @@
+package top.fatweb.oxygen.api.controller.permission
+
+import io.swagger.v3.oas.annotations.Operation
+import jakarta.validation.Valid
+import org.springframework.security.access.prepost.PreAuthorize
+import org.springframework.web.bind.annotation.*
+import top.fatweb.oxygen.api.annotation.BaseController
+import top.fatweb.oxygen.api.entity.common.ResponseCode
+import top.fatweb.oxygen.api.entity.common.ResponseResult
+import top.fatweb.oxygen.api.param.permission.user.*
+import top.fatweb.oxygen.api.service.permission.IUserService
+import top.fatweb.oxygen.api.vo.PageVo
+import top.fatweb.oxygen.api.vo.permission.UserWithInfoVo
+import top.fatweb.oxygen.api.vo.permission.UserWithPasswordRoleInfoVo
+import top.fatweb.oxygen.api.vo.permission.UserWithPowerInfoVo
+import top.fatweb.oxygen.api.vo.permission.UserWithRoleInfoVo
+
+/**
+ * User management controller
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IUserService
+ */
+@BaseController(path = ["/system/user"], name = "用户管理", description = "用户管理相关接口")
+class UserController(
+ private val userService: IUserService
+) {
+ /**
+ * Get current user information
+ *
+ * @return Response object includes user information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see UserWithPowerInfoVo
+ */
+ @Operation(summary = "获取当前用户信息")
+ @GetMapping("/info")
+ fun getInfo(): ResponseResult =
+ ResponseResult.databaseSuccess(data = userService.getInfo())
+
+ /**
+ * Get basic user information
+ *
+ * @param username Username
+ * @return Response object includes user basic information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see UserWithPowerInfoVo
+ */
+ @Operation(summary = "获取指定用户基本信息")
+ @GetMapping("/info/{username}")
+ fun getBasicInfo(@PathVariable username: String): ResponseResult =
+ ResponseResult.databaseSuccess(data = userService.getBasicInfo(username))
+
+ /**
+ * Update current user information
+ *
+ * @param userInfoUpdateParam Update user information parameters
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see UserInfoUpdateParam
+ * @see ResponseResult
+ */
+ @Operation(summary = "更新当前用户信息")
+ @PatchMapping("info")
+ fun updateInfo(@RequestBody @Valid userInfoUpdateParam: UserInfoUpdateParam): ResponseResult =
+ if (userService.updateInfo(userInfoUpdateParam)) ResponseResult.databaseSuccess(ResponseCode.DATABASE_UPDATE_SUCCESS)
+ else ResponseResult.databaseSuccess(ResponseCode.DATABASE_UPDATE_FAILED)
+
+ /**
+ * Change password
+ *
+ * @param userChangePasswordParam User change password parameters
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see UserChangePasswordParam
+ * @see ResponseResult
+ */
+ @Operation(summary = "更改密码")
+ @PostMapping("info")
+ fun password(@RequestBody @Valid userChangePasswordParam: UserChangePasswordParam): ResponseResult {
+ userService.password(userChangePasswordParam)
+
+ return ResponseResult.databaseSuccess(ResponseCode.DATABASE_UPDATE_SUCCESS)
+ }
+
+ /**
+ * Get user by ID
+ *
+ * @param id User ID
+ * @return Response object includes user information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see UserWithRoleInfoVo
+ */
+ @Operation(summary = "获取单个用户")
+ @GetMapping("/{id}")
+ @PreAuthorize("hasAnyAuthority('system:user:query:one')")
+ fun getOne(@PathVariable id: Long): ResponseResult =
+ ResponseResult.databaseSuccess(data = userService.getOne(id))
+
+ /**
+ * Get user paging information
+ *
+ * @param userGetParam Get user parameters
+ * @return Response object includes user paging information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see UserGetParam
+ * @see ResponseResult
+ * @see UserWithRoleInfoVo
+ */
+ @Operation(summary = "获取用户")
+ @GetMapping
+ @PreAuthorize("hasAnyAuthority('system:user:query:all')")
+ fun get(@Valid userGetParam: UserGetParam?): ResponseResult> =
+ ResponseResult.databaseSuccess(
+ data = userService.getPage(userGetParam)
+ )
+
+ /**
+ * Add user
+ *
+ * @param userAddParam Add user parameters
+ * @return Response object includes user information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see UserAddParam
+ * @see ResponseResult
+ * @see UserWithPasswordRoleInfoVo
+ */
+ @Operation(summary = "添加用户")
+ @PostMapping
+ @PreAuthorize("hasAnyAuthority('system:user:add:one')")
+ fun add(@Valid @RequestBody userAddParam: UserAddParam): ResponseResult =
+ ResponseResult.databaseSuccess(
+ ResponseCode.DATABASE_INSERT_SUCCESS, data = userService.add(userAddParam)
+ )
+
+ /**
+ * Update user
+ *
+ * @param userUpdateParam Update user parameters
+ * @return Response object includes user information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see UserUpdateParam
+ * @see ResponseResult
+ * @see UserWithRoleInfoVo
+ */
+ @Operation(summary = "修改用户")
+ @PutMapping
+ @PreAuthorize("hasAnyAuthority('system:user:modify:one')")
+ fun update(@Valid @RequestBody userUpdateParam: UserUpdateParam): ResponseResult =
+ ResponseResult.databaseSuccess(
+ ResponseCode.DATABASE_UPDATE_SUCCESS, data = userService.update(userUpdateParam)
+ )
+
+ /**
+ * Update user password
+ *
+ * @param userUpdatePasswordParam Update user password parameters
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see UserUpdatePasswordParam
+ * @see ResponseResult
+ */
+ @Operation(summary = "修改密码")
+ @PatchMapping
+ @PreAuthorize("hasAnyAuthority('system:user:modify:password')")
+ fun password(@Valid @RequestBody userUpdatePasswordParam: UserUpdatePasswordParam): ResponseResult {
+ userService.password(userUpdatePasswordParam)
+ return ResponseResult.databaseSuccess(ResponseCode.DATABASE_UPDATE_SUCCESS)
+ }
+
+ /**
+ * Delete user by ID
+ *
+ * @param id User ID
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ */
+ @Operation(summary = "删除用户")
+ @DeleteMapping("/{id}")
+ @PreAuthorize("hasAnyAuthority('system:user:delete:one')")
+ fun delete(@PathVariable id: Long): ResponseResult {
+ userService.deleteOne(id)
+ return ResponseResult.databaseSuccess(ResponseCode.DATABASE_DELETE_SUCCESS)
+ }
+
+ /**
+ * Delete user by list
+ *
+ * @param userDeleteParam Delete user parameters
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see UserDeleteParam
+ * @see ResponseResult
+ */
+ @Operation(summary = "批量删除用户")
+ @DeleteMapping
+ @PreAuthorize("hasAnyAuthority('system:user:delete:multiple')")
+ fun deleteList(@Valid @RequestBody userDeleteParam: UserDeleteParam): ResponseResult {
+ userService.delete(userDeleteParam)
+ return ResponseResult.databaseSuccess(ResponseCode.DATABASE_DELETE_SUCCESS)
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/controller/system/SettingsController.kt b/src/main/kotlin/top/fatweb/oxygen/api/controller/system/SettingsController.kt
new file mode 100644
index 0000000..5d5c28b
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/controller/system/SettingsController.kt
@@ -0,0 +1,184 @@
+package top.fatweb.oxygen.api.controller.system
+
+import io.swagger.v3.oas.annotations.Operation
+import jakarta.validation.Valid
+import org.springframework.security.access.prepost.PreAuthorize
+import org.springframework.web.bind.annotation.DeleteMapping
+import org.springframework.web.bind.annotation.GetMapping
+import org.springframework.web.bind.annotation.PathVariable
+import org.springframework.web.bind.annotation.PostMapping
+import org.springframework.web.bind.annotation.PutMapping
+import org.springframework.web.bind.annotation.RequestBody
+import top.fatweb.oxygen.api.annotation.BaseController
+import top.fatweb.oxygen.api.entity.common.ResponseCode
+import top.fatweb.oxygen.api.entity.common.ResponseResult
+import top.fatweb.oxygen.api.param.system.*
+import top.fatweb.oxygen.api.service.system.ISensitiveWordService
+import top.fatweb.oxygen.api.service.system.ISettingsService
+import top.fatweb.oxygen.api.vo.system.BaseSettingsVo
+import top.fatweb.oxygen.api.vo.system.MailSettingsVo
+import top.fatweb.oxygen.api.vo.system.SensitiveWordVo
+
+/**
+ * System settings management controller
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ISettingsService
+ * @see ISensitiveWordService
+ */
+@BaseController(path = ["/system/settings"], name = "系统设置", description = "系统设置相关接口")
+class SettingsController(
+ private val settingsService: ISettingsService,
+ private val sensitiveWordService: ISensitiveWordService
+) {
+ /**
+ * Get base settings
+ *
+ * @return Response object includes base settings information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see BaseSettingsVo
+ */
+ @Operation(summary = "获取基础设置")
+ @GetMapping("/base")
+ @PreAuthorize("hasAnyAuthority('system:settings:query:base')")
+ fun getApp(): ResponseResult = ResponseResult.success(data = settingsService.getBase())
+
+ /**
+ * Update base settings
+ *
+ * @param baseSettingsParam Base settings parameters
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see BaseSettingsParam
+ * @see ResponseResult
+ */
+ @Operation(summary = "更新基础设置")
+ @PutMapping("/base")
+ @PreAuthorize("hasAnyAuthority('system:settings:modify:base')")
+ fun updateApp(@RequestBody baseSettingsParam: BaseSettingsParam): ResponseResult {
+ settingsService.updateBase(baseSettingsParam)
+ return ResponseResult.success()
+ }
+
+ /**
+ * Get mail settings
+ *
+ * @return Response object includes mail settings
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see MailSettingsVo
+ */
+ @Operation(summary = "获取邮件设置")
+ @GetMapping("/mail")
+ @PreAuthorize("hasAnyAuthority('system:settings:query:mail')")
+ fun getMail(): ResponseResult = ResponseResult.success(data = settingsService.getMail())
+
+ /**
+ * Update mail settings
+ *
+ * @param mailSettingsParam Mail settings parameters
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see MailSettingsParam
+ * @see ResponseResult
+ */
+ @Operation(summary = "更新邮件设置")
+ @PutMapping("/mail")
+ @PreAuthorize("hasAnyAuthority('system:settings:modify:mail')")
+ fun updateMail(@RequestBody mailSettingsParam: MailSettingsParam): ResponseResult {
+ settingsService.updateMail(mailSettingsParam)
+ return ResponseResult.success()
+ }
+
+ /**
+ * Send mail test
+ *
+ * @param mailSendParam Mail send parameters
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see MailSendParam
+ * @see ResponseResult
+ */
+ @Operation(summary = "邮件发送测试")
+ @PostMapping("/mail")
+ @PreAuthorize("hasAnyAuthority('system:settings:modify:mail')")
+ fun sendMail(@RequestBody @Valid mailSendParam: MailSendParam): ResponseResult {
+ settingsService.sendMail(mailSendParam)
+ return ResponseResult.success()
+ }
+
+ /**
+ * Get sensitive word settings
+ *
+ * @return Response object includes sensitive word settings information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see SensitiveWordVo
+ */
+ @Operation(summary = "获取敏感词配置")
+ @GetMapping("/sensitive")
+ @PreAuthorize("hasAnyAuthority('system:settings:query:sensitive')")
+ fun getSensitive(): ResponseResult> =
+ ResponseResult.databaseSuccess(ResponseCode.DATABASE_SELECT_SUCCESS, data = sensitiveWordService.get())
+
+ /**
+ * Add sensitive word
+ *
+ * @param sensitiveWordAddParam Add sensitive word settings parameters
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see SensitiveWordAddParam
+ * @see ResponseResult
+ */
+ @Operation(summary = "添加敏感词")
+ @PostMapping("/sensitive")
+ @PreAuthorize("hasAnyAuthority('system:settings:modify:sensitive')")
+ fun addSensitive(@RequestBody @Valid sensitiveWordAddParam: SensitiveWordAddParam): ResponseResult {
+ sensitiveWordService.add(sensitiveWordAddParam)
+ return ResponseResult.databaseSuccess(ResponseCode.DATABASE_INSERT_SUCCESS)
+ }
+
+ /**
+ * Update sensitive word
+ *
+ * @param sensitiveWordUpdateParam Update sensitive word settings parameters
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see SensitiveWordUpdateParam
+ * @see ResponseResult
+ */
+ @Operation(summary = "修改敏感词")
+ @PutMapping("/sensitive")
+ @PreAuthorize("hasAnyAuthority('system:settings:modify:sensitive')")
+ fun updateSensitive(@RequestBody sensitiveWordUpdateParam: SensitiveWordUpdateParam): ResponseResult {
+ sensitiveWordService.update(sensitiveWordUpdateParam)
+ return ResponseResult.databaseSuccess(ResponseCode.DATABASE_UPDATE_SUCCESS)
+ }
+
+ /**
+ * Delete sensitive word
+ *
+ * @see id Sensitive word ID
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ */
+ @Operation(summary = "删除敏感词")
+ @DeleteMapping("/sensitive/{id}")
+ @PreAuthorize("hasAnyAuthority('system:settings:modify:sensitive')")
+ fun deleteSensitive(@PathVariable id: Long): ResponseResult {
+ sensitiveWordService.delete(id)
+ return ResponseResult.databaseSuccess(ResponseCode.DATABASE_DELETE_SUCCESS)
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/controller/system/StatisticsController.kt b/src/main/kotlin/top/fatweb/oxygen/api/controller/system/StatisticsController.kt
new file mode 100644
index 0000000..a04d961
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/controller/system/StatisticsController.kt
@@ -0,0 +1,113 @@
+package top.fatweb.oxygen.api.controller.system
+
+import io.swagger.v3.oas.annotations.Operation
+import org.springframework.security.access.prepost.PreAuthorize
+import org.springframework.web.bind.annotation.GetMapping
+import top.fatweb.oxygen.api.annotation.BaseController
+import top.fatweb.oxygen.api.entity.common.ResponseResult
+import top.fatweb.oxygen.api.param.system.ActiveInfoGetParam
+import top.fatweb.oxygen.api.param.system.OnlineInfoGetParam
+import top.fatweb.oxygen.api.service.system.IStatisticsService
+import top.fatweb.oxygen.api.vo.system.*
+
+/**
+ * Statistics management controller
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IStatisticsService
+ */
+@BaseController(path = ["/system/statistics"], name = "统计接口", description = "系统信息统计相关接口")
+class StatisticsController(
+ private val statisticService: IStatisticsService
+) {
+ /**
+ * Get software information
+ *
+ * @return Response object includes software information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see SoftwareInfoVo
+ */
+ @Operation(summary = "获取软件信息")
+ @GetMapping("/software")
+ @PreAuthorize("hasAnyAuthority('system:statistics:query:base')")
+ fun software(): ResponseResult = ResponseResult.success(data = statisticService.software())
+
+ /**
+ * Get hardware information
+ *
+ * @return Response object includes hardware information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see HardwareInfoVo
+ */
+ @Operation(summary = "获取硬件信息")
+ @GetMapping("/hardware")
+ @PreAuthorize("hasAnyAuthority('system:statistics:query:base')")
+ fun hardware(): ResponseResult = ResponseResult.success(data = statisticService.hardware())
+
+ /**
+ * Get CPU information
+ *
+ * @return Response object includes CPU information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see CpuInfoVo
+ */
+ @Operation(summary = "获取 CPU 信息")
+ @GetMapping("/cpu")
+ @PreAuthorize("hasAnyAuthority('system:statistics:query:real')")
+ fun cpu(): ResponseResult = ResponseResult.success(data = statisticService.cpu())
+
+ /**
+ * Get storage information
+ *
+ * @return Response object includes storage information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see StorageInfoVo
+ */
+ @Operation(summary = "获取存储信息")
+ @GetMapping("/storage")
+ @PreAuthorize("hasAnyAuthority('system:statistics:query:real')")
+ fun storage(): ResponseResult = ResponseResult.success(data = statisticService.storage())
+
+ /**
+ * Get the history of online users information
+ *
+ * @param onlineInfoGetParam Get online information parameters
+ * @return Response object includes online user information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see OnlineInfoGetParam
+ * @see ResponseResult
+ * @see OnlineInfoVo
+ */
+ @Operation(summary = "获取在线用户数量信息")
+ @GetMapping("/online")
+ @PreAuthorize("hasAnyAuthority('system:statistics:query:usage')")
+ fun online(onlineInfoGetParam: OnlineInfoGetParam?): ResponseResult =
+ ResponseResult.success(data = statisticService.online(onlineInfoGetParam))
+
+ /**
+ * Get the history of active information
+ *
+ * @param activeInfoGetParam Get active information parameters
+ * @return Response object includes history of active information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ActiveInfoGetParam
+ * @see ResponseResult
+ * @see ActiveInfoVo
+ */
+ @Operation(summary = "获取用户活跃信息")
+ @GetMapping("/active")
+ @PreAuthorize("hasAnyAuthority('system:statistics:query:usage')")
+ fun active(activeInfoGetParam: ActiveInfoGetParam): ResponseResult =
+ ResponseResult.success(data = statisticService.active(activeInfoGetParam))
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/controller/system/SysLogController.kt b/src/main/kotlin/top/fatweb/oxygen/api/controller/system/SysLogController.kt
new file mode 100644
index 0000000..09c76e7
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/controller/system/SysLogController.kt
@@ -0,0 +1,45 @@
+package top.fatweb.oxygen.api.controller.system
+
+import io.swagger.v3.oas.annotations.Operation
+import jakarta.validation.Valid
+import org.springframework.security.access.prepost.PreAuthorize
+import org.springframework.web.bind.annotation.GetMapping
+import top.fatweb.oxygen.api.annotation.BaseController
+import top.fatweb.oxygen.api.entity.common.ResponseCode
+import top.fatweb.oxygen.api.entity.common.ResponseResult
+import top.fatweb.oxygen.api.param.system.SysLogGetParam
+import top.fatweb.oxygen.api.service.system.ISysLogService
+import top.fatweb.oxygen.api.vo.PageVo
+import top.fatweb.oxygen.api.vo.system.SysLogVo
+
+/**
+ * System log viewer controller
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ISysLogService
+ */
+@BaseController(path = ["/system/log"], name = "系统日志", description = "系统日志相关接口")
+class SysLogController(
+ private val sysLogService: ISysLogService
+) {
+ /**
+ * Get system log in page
+ *
+ * @param sysLogGetParam Get system log parameters
+ * @return Response object includes system log in page
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see SysLogGetParam
+ * @see ResponseResult
+ * @see SysLogVo
+ */
+ @Operation(summary = "获取")
+ @GetMapping
+ @PreAuthorize("hasAnyAuthority('system:log:query:all')")
+ fun get(@Valid sysLogGetParam: SysLogGetParam?): ResponseResult> {
+ return ResponseResult.success(
+ ResponseCode.DATABASE_SELECT_SUCCESS, data = sysLogService.getPage(sysLogGetParam)
+ )
+ }
+}
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/BaseController.kt b/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/BaseController.kt
new file mode 100644
index 0000000..f682fd3
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/BaseController.kt
@@ -0,0 +1,112 @@
+package top.fatweb.oxygen.api.controller.tool
+
+import io.swagger.v3.oas.annotations.Operation
+import jakarta.validation.Valid
+import org.springframework.security.access.prepost.PreAuthorize
+import org.springframework.web.bind.annotation.*
+import top.fatweb.oxygen.api.annotation.BaseController
+import top.fatweb.oxygen.api.entity.common.ResponseCode
+import top.fatweb.oxygen.api.entity.common.ResponseResult
+import top.fatweb.oxygen.api.param.tool.ToolBaseAddParam
+import top.fatweb.oxygen.api.param.tool.ToolBaseUpdateParam
+import top.fatweb.oxygen.api.service.tool.IToolBaseService
+import top.fatweb.oxygen.api.vo.tool.ToolBaseVo
+
+/**
+ * Tool base management controller
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IToolBaseService
+ */
+@BaseController(path = ["/system/tool/base"], name = "工具基板管理", description = "工具基板管理相关接口")
+class BaseController(
+ private val toolBaseService: IToolBaseService
+) {
+ /**
+ * Get tool base by ID
+ *
+ * @param id Tool base ID
+ * @return Response object includes tool base information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see ToolBaseVo
+ */
+ @Operation(summary = "获取单个基板")
+ @GetMapping("/{id}")
+ @PreAuthorize("hasAnyAuthority('system:tool:query:base')")
+ fun getOne(@PathVariable id: Long): ResponseResult =
+ ResponseResult.databaseSuccess(data = toolBaseService.getOne(id))
+
+ /**
+ * Get tool base list
+ *
+ * @return Response object includes tool base list
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see ToolBaseVo
+ */
+ @Operation(summary = "获取基板")
+ @GetMapping
+ @PreAuthorize("hasAnyAuthority('system:tool:query:base', 'system:tool:add:template', 'system:tool:modify:template')")
+ fun get(): ResponseResult> =
+ ResponseResult.databaseSuccess(data = toolBaseService.get())
+
+ /**
+ * Add tool base
+ *
+ * @param toolBaseAddParam Add tool base parameters
+ * @return Response object includes tool base information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolBaseAddParam
+ * @see ResponseResult
+ * @see ToolBaseVo
+ */
+ @Operation(summary = "新增基板")
+ @PostMapping
+ @PreAuthorize("hasAnyAuthority('system:tool:add:base')")
+ fun add(@RequestBody @Valid toolBaseAddParam: ToolBaseAddParam): ResponseResult =
+ ResponseResult.databaseSuccess(
+ ResponseCode.DATABASE_INSERT_SUCCESS,
+ data = toolBaseService.add(toolBaseAddParam)
+ )
+
+ /**
+ * Update tool base
+ *
+ * @param toolBaseUpdateParam Update tool base parameters
+ * @return Response object includes tool base information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolBaseUpdateParam
+ * @see ResponseResult
+ * @see ToolBaseVo
+ */
+ @Operation(summary = "更新基板")
+ @PutMapping
+ @PreAuthorize("hasAnyAuthority('system:tool:modify:base')")
+ fun update(@RequestBody @Valid toolBaseUpdateParam: ToolBaseUpdateParam): ResponseResult =
+ ResponseResult.databaseSuccess(
+ ResponseCode.DATABASE_UPDATE_SUCCESS,
+ data = toolBaseService.update(toolBaseUpdateParam)
+ )
+
+ /**
+ * Delete tool base by ID
+ *
+ * @param id Tool base ID
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ */
+ @Operation(summary = "删除基板")
+ @DeleteMapping("/{id}")
+ @PreAuthorize("hasAnyAuthority('system:tool:delete:base')")
+ fun delete(@PathVariable id: Long): ResponseResult =
+ if (toolBaseService.delete(id)) ResponseResult.databaseSuccess(ResponseCode.DATABASE_DELETE_SUCCESS)
+ else ResponseResult.databaseFail(ResponseCode.DATABASE_DELETE_FAILED)
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/CategoryController.kt b/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/CategoryController.kt
new file mode 100644
index 0000000..1872a39
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/CategoryController.kt
@@ -0,0 +1,112 @@
+package top.fatweb.oxygen.api.controller.tool
+
+import io.swagger.v3.oas.annotations.Operation
+import jakarta.validation.Valid
+import org.springframework.security.access.prepost.PreAuthorize
+import org.springframework.web.bind.annotation.*
+import top.fatweb.oxygen.api.annotation.BaseController
+import top.fatweb.oxygen.api.entity.common.ResponseCode
+import top.fatweb.oxygen.api.entity.common.ResponseResult
+import top.fatweb.oxygen.api.param.tool.ToolCategoryAddParam
+import top.fatweb.oxygen.api.param.tool.ToolCategoryUpdateParam
+import top.fatweb.oxygen.api.service.tool.IToolCategoryService
+import top.fatweb.oxygen.api.vo.tool.ToolCategoryVo
+
+/**
+ * Tool category management controller
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IToolCategoryService
+ */
+@BaseController(path = ["/system/tool/category"], name = "工具类别管理", description = "工具列别管理相关接口")
+class CategoryController(
+ private val toolCategoryService: IToolCategoryService
+) {
+ /**
+ * Get tool category by ID
+ *
+ * @param id Tool category ID
+ * @return Response object includes tool template information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see ToolCategoryVo
+ */
+ @Operation(summary = "获取单个类别")
+ @GetMapping("/{id}")
+ @PreAuthorize("hasAnyAuthority('system:tool:query:category')")
+ fun getOne(@PathVariable id: Long): ResponseResult =
+ ResponseResult.databaseSuccess(data = toolCategoryService.getOne(id))
+
+ /**
+ * Get tool category list
+ *
+ * @return Response object includes tool template list
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see ToolCategoryVo
+ */
+ @Operation(summary = "获取类别")
+ @GetMapping
+ @PreAuthorize("hasAnyAuthority('system:tool:query:category')")
+ fun get(): ResponseResult> =
+ ResponseResult.databaseSuccess(data = toolCategoryService.get())
+
+ /**
+ * Add tool category
+ *
+ * @param toolCategoryAddParam Add tool category parameters
+ * @return Response object includes tool category information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolCategoryAddParam
+ * @see ResponseResult
+ * @see ToolCategoryVo
+ */
+ @Operation(summary = "新增类别")
+ @PostMapping
+ @PreAuthorize("hasAnyAuthority('system:tool:add:category')")
+ fun add(@RequestBody @Valid toolCategoryAddParam: ToolCategoryAddParam): ResponseResult =
+ ResponseResult.databaseSuccess(
+ ResponseCode.DATABASE_INSERT_SUCCESS,
+ data = toolCategoryService.add(toolCategoryAddParam)
+ )
+
+ /**
+ * Update tool category
+ *
+ * @param toolCategoryUpdateParam Update tool category parameters
+ * @return Response object includes tool category information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolCategoryUpdateParam
+ * @see ResponseResult
+ * @see ToolCategoryVo
+ */
+ @Operation(summary = "更新类别")
+ @PutMapping
+ @PreAuthorize("hasAnyAuthority('system:tool:modify:category')")
+ fun update(@RequestBody @Valid toolCategoryUpdateParam: ToolCategoryUpdateParam): ResponseResult =
+ ResponseResult.databaseSuccess(
+ ResponseCode.DATABASE_UPDATE_SUCCESS,
+ data = toolCategoryService.update(toolCategoryUpdateParam)
+ )
+
+ /**
+ * Delete tool category
+ *
+ * @param id Tool category ID
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ */
+ @Operation(summary = "删除类别")
+ @DeleteMapping("/{id}")
+ @PreAuthorize("hasAnyAuthority('system:tool:delete:category')")
+ fun delete(@PathVariable id: Long): ResponseResult =
+ if (toolCategoryService.delete(id)) ResponseResult.databaseSuccess(ResponseCode.DATABASE_DELETE_SUCCESS)
+ else ResponseResult.databaseFail(ResponseCode.DATABASE_DELETE_FAILED)
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/EditController.kt b/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/EditController.kt
new file mode 100644
index 0000000..2e4863e
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/EditController.kt
@@ -0,0 +1,204 @@
+package top.fatweb.oxygen.api.controller.tool
+
+import io.swagger.v3.oas.annotations.Operation
+import jakarta.validation.Valid
+import org.springframework.web.bind.annotation.*
+import top.fatweb.oxygen.api.annotation.BaseController
+import top.fatweb.oxygen.api.entity.common.ResponseCode
+import top.fatweb.oxygen.api.entity.common.ResponseResult
+import top.fatweb.oxygen.api.param.tool.ToolCreateParam
+import top.fatweb.oxygen.api.param.tool.ToolUpdateParam
+import top.fatweb.oxygen.api.param.tool.ToolUpgradeParam
+import top.fatweb.oxygen.api.service.tool.IEditService
+import top.fatweb.oxygen.api.vo.tool.ToolCategoryVo
+import top.fatweb.oxygen.api.vo.tool.ToolTemplateVo
+import top.fatweb.oxygen.api.vo.tool.ToolVo
+
+/**
+ * Tool edit controller
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IEditService
+ */
+@BaseController(path = ["/tool"], name = "工具编辑", description = "工具编辑相关接口")
+class EditController(
+ private val editService: IEditService
+) {
+ /**
+ * Get tool template list
+ *
+ * @return Response object includes tool template list
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see ToolTemplateVo
+ */
+ @Operation(summary = "获取模板")
+ @GetMapping("/template")
+ fun getTemplate(): ResponseResult> =
+ ResponseResult.databaseSuccess(data = editService.getTemplate())
+
+ /**
+ * Get tool template by ID
+ *
+ * @param id ID
+ * @return Response object includes tool template information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see ToolTemplateVo
+ */
+ @Operation(summary = "获取单个模板")
+ @GetMapping("/template/{id}")
+ fun getTemplate(@PathVariable id: Long): ResponseResult =
+ ResponseResult.databaseSuccess(data = editService.getTemplate(id))
+
+ /**
+ * Get tool category list
+ *
+ * @return Response object includes tool category list
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see ToolCategoryVo
+ */
+ @Operation(summary = "获取类别")
+ @GetMapping("/category")
+ fun getCategory(): ResponseResult> =
+ ResponseResult.databaseSuccess(data = editService.getCategory())
+
+ /**
+ * Create tool
+ *
+ * @param toolCreateParam Create tool parameters
+ * @return Response object includes tool information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolCreateParam
+ * @see ResponseResult
+ * @see ToolVo
+ */
+ @Operation(summary = "创建工具")
+ @PostMapping
+ fun create(@RequestBody @Valid toolCreateParam: ToolCreateParam): ResponseResult =
+ ResponseResult.databaseSuccess(ResponseCode.DATABASE_INSERT_SUCCESS, data = editService.create(toolCreateParam))
+
+ /**
+ * Upgrade tool
+ *
+ * @param toolUpgradeParam Upgrade tool parameters
+ * @return Response object includes tool information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolUpgradeParam
+ * @see ResponseResult
+ * @see ToolVo
+ */
+ @Operation(summary = "升级工具")
+ @PatchMapping
+ fun upgrade(@RequestBody @Valid toolUpgradeParam: ToolUpgradeParam): ResponseResult =
+ ResponseResult.databaseSuccess(
+ ResponseCode.DATABASE_UPDATE_SUCCESS,
+ data = editService.upgrade(toolUpgradeParam)
+ )
+
+ /**
+ * Get personal tool
+ *
+ * @return Response object includes tool list
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see ToolVo
+ */
+ @Operation(summary = "获取个人工具")
+ @GetMapping
+ fun get(): ResponseResult> =
+ ResponseResult.databaseSuccess(ResponseCode.DATABASE_SELECT_SUCCESS, data = editService.get())
+
+ /**
+ * Get tool detail
+ *
+ * @param username Username
+ * @param toolId Tool ID
+ * @param ver Version
+ * @return Response object includes tool information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see ToolVo
+ */
+ @Operation(summary = "获取工具内容")
+ @GetMapping("/detail/{username}/{toolId}/{ver}")
+ fun detail(
+ @PathVariable username: String,
+ @PathVariable toolId: String,
+ @PathVariable ver: String
+ ): ResponseResult =
+ ResponseResult.databaseSuccess(
+ ResponseCode.DATABASE_SELECT_SUCCESS,
+ data = editService.detail(username, toolId, ver)
+ )
+
+ /**
+ * Update tool
+ *
+ * @param toolUpdateParam Update tool parameters
+ * @return Response object includes tool information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolUpdateParam
+ * @see ResponseResult
+ * @see ToolVo
+ */
+ @Operation(summary = "更新工具")
+ @PutMapping
+ fun update(@RequestBody @Valid toolUpdateParam: ToolUpdateParam): ResponseResult =
+ ResponseResult.databaseSuccess(ResponseCode.DATABASE_UPDATE_SUCCESS, data = editService.update(toolUpdateParam))
+
+ /**
+ * Submit tool review
+ *
+ * @param id Tool ID
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ */
+ @Operation(summary = "提交工具审核")
+ @PostMapping("/{id}")
+ fun submit(@PathVariable id: Long): ResponseResult =
+ if (editService.submit(id)) ResponseResult.success(ResponseCode.TOOL_SUBMIT_SUCCESS)
+ else ResponseResult.fail(ResponseCode.TOOL_SUBMIT_ERROR)
+
+ /**
+ * Cancel tool review
+ *
+ * @param id Tool ID
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ */
+ @Operation(summary = "取消工具审核")
+ @PutMapping("/{id}")
+ fun cancel(@PathVariable id: Long): ResponseResult =
+ if (editService.cancel(id)) ResponseResult.success(ResponseCode.TOOL_CANCEL_SUCCESS)
+ else ResponseResult.fail(ResponseCode.TOOL_CANCEL_ERROR)
+
+ /**
+ * Delete tool
+ *
+ * @param id Tool ID
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ */
+ @Operation(summary = "删除工具")
+ @DeleteMapping("/{id}")
+ fun delete(@PathVariable id: Long): ResponseResult =
+ if (editService.delete(id)) ResponseResult.databaseSuccess(ResponseCode.DATABASE_DELETE_SUCCESS)
+ else ResponseResult.databaseFail(ResponseCode.DATABASE_DELETE_FAILED)
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/ManagementController.kt b/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/ManagementController.kt
new file mode 100644
index 0000000..9bdff74
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/ManagementController.kt
@@ -0,0 +1,132 @@
+package top.fatweb.oxygen.api.controller.tool
+
+import io.swagger.v3.oas.annotations.Operation
+import jakarta.validation.Valid
+import org.springframework.security.access.prepost.PreAuthorize
+import org.springframework.web.bind.annotation.*
+import top.fatweb.oxygen.api.annotation.BaseController
+import top.fatweb.oxygen.api.entity.common.ResponseCode
+import top.fatweb.oxygen.api.entity.common.ResponseResult
+import top.fatweb.oxygen.api.param.tool.ToolManagementGetParam
+import top.fatweb.oxygen.api.param.tool.ToolManagementPassParam
+import top.fatweb.oxygen.api.service.tool.IManagementService
+import top.fatweb.oxygen.api.vo.PageVo
+import top.fatweb.oxygen.api.vo.tool.ToolVo
+
+/**
+ * Tool management controller
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IManagementService
+ */
+@BaseController(path = ["/system/tool"], name = "工具管理", description = "工具管理相关接口")
+class ManagementController(
+ private val managementService: IManagementService
+) {
+ /**
+ * Get tool by ID
+ *
+ * @param id Tool ID
+ * @return Response object includes tool information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see ToolVo
+ */
+ @Operation(summary = "获取单个工具")
+ @GetMapping("/{id}")
+ @PreAuthorize("hasAnyAuthority('system:tool:query:tool')")
+ fun getOne(@PathVariable id: Long): ResponseResult =
+ ResponseResult.databaseSuccess(data = managementService.getOne(id))
+
+ /**
+ * Get tool paging information
+ *
+ * @param toolManagementGetParam Get tool parameters in tool management
+ * @return Response object includes tool paging information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolManagementGetParam
+ * @see ResponseResult
+ * @see PageVo
+ * @see ToolVo
+ */
+ @Operation(summary = "获取工具")
+ @GetMapping
+ @PreAuthorize("hasAnyAuthority('system:tool:query:tool')")
+ fun get(toolManagementGetParam: ToolManagementGetParam): ResponseResult> =
+ ResponseResult.databaseSuccess(data = managementService.getPage(toolManagementGetParam))
+
+ /**
+ * Pass tool review
+ *
+ * @param id Tool ID
+ * @param toolManagementPassParam Pass tool parameters in tool management
+ * @return Response object includes tool information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolManagementPassParam
+ * @see ResponseResult
+ * @see ToolVo
+ */
+ @Operation(summary = "通过审核")
+ @PostMapping("/{id}")
+ @PreAuthorize("hasAnyAuthority('system:tool:modify:tool')")
+ fun pass(
+ @PathVariable id: Long,
+ @RequestBody @Valid toolManagementPassParam: ToolManagementPassParam
+ ): ResponseResult =
+ ResponseResult.databaseSuccess(
+ ResponseCode.DATABASE_UPDATE_SUCCESS,
+ data = managementService.pass(id, toolManagementPassParam)
+ )
+
+ /**
+ * Reject tool review
+ *
+ * @param id Tool ID
+ * @return Response object includes tool information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see ToolVo
+ */
+ @Operation(summary = "驳回审核")
+ @PutMapping("/{id}")
+ @PreAuthorize("hasAnyAuthority('system:tool:modify:tool')")
+ fun reject(@PathVariable id: Long): ResponseResult =
+ ResponseResult.databaseSuccess(ResponseCode.DATABASE_UPDATE_SUCCESS, data = managementService.reject(id))
+
+ /**
+ * Put off shelve
+ *
+ * @param id Tool ID
+ * @return Response object includes tool information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see ToolVo
+ */
+ @Operation(summary = "下架")
+ @PatchMapping("/{id}")
+ @PreAuthorize("hasAnyAuthority('system:tool:modify:tool')")
+ fun offShelve(@PathVariable id: Long): ResponseResult =
+ ResponseResult.databaseSuccess(ResponseCode.DATABASE_UPDATE_SUCCESS, data = managementService.offShelve(id))
+
+ /**
+ * Delete tool
+ *
+ * @param id Tool ID
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ */
+ @Operation(summary = "删除工具")
+ @DeleteMapping("/{id}")
+ @PreAuthorize("hasAnyAuthority('system:tool:delete:tool')")
+ fun delete(@PathVariable id: Long): ResponseResult =
+ if (managementService.delete(id)) ResponseResult.databaseSuccess(ResponseCode.DATABASE_DELETE_SUCCESS)
+ else ResponseResult.databaseFail(ResponseCode.DATABASE_DELETE_FAILED)
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/StoreController.kt b/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/StoreController.kt
new file mode 100644
index 0000000..3c18850
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/StoreController.kt
@@ -0,0 +1,57 @@
+package top.fatweb.oxygen.api.controller.tool
+
+import jakarta.validation.Valid
+import org.springframework.web.bind.annotation.GetMapping
+import org.springframework.web.bind.annotation.PathVariable
+import top.fatweb.oxygen.api.annotation.BaseController
+import top.fatweb.oxygen.api.entity.common.ResponseResult
+import top.fatweb.oxygen.api.param.PageSortParam
+import top.fatweb.oxygen.api.param.tool.ToolStoreGetParam
+import top.fatweb.oxygen.api.service.tool.IStoreService
+import top.fatweb.oxygen.api.vo.PageVo
+import top.fatweb.oxygen.api.vo.tool.ToolVo
+
+/**
+ * Tool store controller
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IStoreService
+ */
+@BaseController(path = ["/tool/store"], name = "工具商店", description = "工具商店相关接口")
+class StoreController(
+ private val storeService: IStoreService
+) {
+ /**
+ * Get store tool paging information
+ *
+ * @param toolStoreGetParam Get tool parameters in tool store
+ * @return Response object includes store tool paging information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolStoreGetParam
+ * @see ResponseResult
+ * @see PageVo
+ * @see ToolVo
+ */
+ @GetMapping
+ fun get(@Valid toolStoreGetParam: ToolStoreGetParam): ResponseResult> =
+ ResponseResult.databaseSuccess(data = storeService.getPage(toolStoreGetParam))
+
+ /**
+ * Get store tool paging information by username
+ *
+ * @param username Username
+ * @param pageSortParam Page sort parameters
+ * @return Response object includes store tool paging information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see PageSortParam
+ * @see ResponseResult
+ * @see PageVo
+ * @see ToolVo
+ */
+ @GetMapping("/{username}")
+ fun get(@PathVariable username: String, @Valid pageSortParam: PageSortParam): ResponseResult> =
+ ResponseResult.databaseSuccess(data = storeService.getPage(pageSortParam, username))
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/TemplateController.kt b/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/TemplateController.kt
new file mode 100644
index 0000000..ab7fe7e
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/controller/tool/TemplateController.kt
@@ -0,0 +1,112 @@
+package top.fatweb.oxygen.api.controller.tool
+
+import io.swagger.v3.oas.annotations.Operation
+import jakarta.validation.Valid
+import org.springframework.security.access.prepost.PreAuthorize
+import org.springframework.web.bind.annotation.*
+import top.fatweb.oxygen.api.annotation.BaseController
+import top.fatweb.oxygen.api.entity.common.ResponseCode
+import top.fatweb.oxygen.api.entity.common.ResponseResult
+import top.fatweb.oxygen.api.param.tool.ToolTemplateAddParam
+import top.fatweb.oxygen.api.param.tool.ToolTemplateUpdateParam
+import top.fatweb.oxygen.api.service.tool.IToolTemplateService
+import top.fatweb.oxygen.api.vo.tool.ToolTemplateVo
+
+/**
+ * Tool template management controller
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IToolTemplateService
+ */
+@BaseController(path = ["/system/tool/template"], name = "工具模板管理", description = "工具模板管理相关接口")
+class TemplateController(
+ private val toolTemplateService: IToolTemplateService
+) {
+ /**
+ * Get tool template by ID
+ *
+ * @param id Tool template ID
+ * @return Response object includes tool template information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see ToolTemplateVo
+ */
+ @Operation(summary = "获取单个模板")
+ @GetMapping("/{id}")
+ @PreAuthorize("hasAnyAuthority('system:tool:query:template')")
+ fun getOne(@PathVariable id: Long): ResponseResult =
+ ResponseResult.databaseSuccess(data = toolTemplateService.getOne(id))
+
+ /**
+ * Get tool template list
+ *
+ * @return Response object includes tool template list
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ * @see ToolTemplateVo
+ */
+ @Operation(summary = "获取模板")
+ @GetMapping
+ @PreAuthorize("hasAnyAuthority('system:tool:query:template')")
+ fun get(): ResponseResult> =
+ ResponseResult.databaseSuccess(data = toolTemplateService.get())
+
+ /**
+ * Add tool template
+ *
+ * @param toolTemplateAddParam Add tool template parameters
+ * @return Response object includes tool template information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolTemplateAddParam
+ * @see ResponseResult
+ * @see ToolTemplateVo
+ */
+ @Operation(summary = "添加模板")
+ @PostMapping
+ @PreAuthorize("hasAnyAuthority('system:tool:add:template')")
+ fun add(@RequestBody @Valid toolTemplateAddParam: ToolTemplateAddParam): ResponseResult =
+ ResponseResult.databaseSuccess(
+ ResponseCode.DATABASE_INSERT_SUCCESS,
+ data = toolTemplateService.add(toolTemplateAddParam)
+ )
+
+ /**
+ * Update tool template
+ *
+ * @param toolTemplateUpdateParam Update tool template parameters
+ * @return Response object includes tool template information
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolTemplateUpdateParam
+ * @see ResponseResult
+ * @see ToolTemplateVo
+ */
+ @Operation(summary = "更新模板")
+ @PutMapping
+ @PreAuthorize("hasAnyAuthority('system:tool:modify:template')")
+ fun update(@RequestBody @Valid toolTemplateUpdateParam: ToolTemplateUpdateParam): ResponseResult =
+ ResponseResult.databaseSuccess(
+ ResponseCode.DATABASE_UPDATE_SUCCESS,
+ data = toolTemplateService.update(toolTemplateUpdateParam)
+ )
+
+ /**
+ * Delete tool template
+ *
+ * @param id Tool template ID
+ * @return Response object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseResult
+ */
+ @Operation(summary = "删除模板")
+ @DeleteMapping("/{id}")
+ @PreAuthorize("hasAnyAuthority('system:tool:delete:template')")
+ fun delete(@PathVariable id: Long): ResponseResult =
+ if (toolTemplateService.delete(id)) ResponseResult.databaseSuccess(ResponseCode.DATABASE_DELETE_SUCCESS)
+ else ResponseResult.databaseFail(ResponseCode.DATABASE_DELETE_FAILED)
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/FuncConverter.kt b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/FuncConverter.kt
new file mode 100644
index 0000000..ed5c227
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/FuncConverter.kt
@@ -0,0 +1,29 @@
+package top.fatweb.oxygen.api.converter.permission
+
+import top.fatweb.oxygen.api.entity.permission.Func
+import top.fatweb.oxygen.api.vo.permission.base.FuncVo
+
+/**
+ * Function converter
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+object FuncConverter {
+ /**
+ * Convert Func object into FuncVo object
+ *
+ * @param func Func object
+ * @return FuncVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see Func
+ * @see FuncVo
+ */
+ fun funcToFuncVo(func: Func) = FuncVo(
+ id = func.id,
+ name = func.name,
+ parentId = func.parentId,
+ menuId = func.menuId
+ )
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/GroupConverter.kt b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/GroupConverter.kt
new file mode 100644
index 0000000..28cbbd6
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/GroupConverter.kt
@@ -0,0 +1,124 @@
+package top.fatweb.oxygen.api.converter.permission
+
+import com.baomidou.mybatisplus.core.metadata.IPage
+import top.fatweb.oxygen.api.entity.permission.Group
+import top.fatweb.oxygen.api.entity.permission.Role
+import top.fatweb.oxygen.api.param.permission.group.GroupAddParam
+import top.fatweb.oxygen.api.param.permission.group.GroupUpdateParam
+import top.fatweb.oxygen.api.param.permission.group.GroupUpdateStatusParam
+import top.fatweb.oxygen.api.vo.PageVo
+import top.fatweb.oxygen.api.vo.permission.GroupWithRoleVo
+import top.fatweb.oxygen.api.vo.permission.base.GroupVo
+
+/**
+ * Group converter
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+object GroupConverter {
+ /**
+ * Convert Group object into GroupVo object
+ *
+ * @param group Group object
+ * @return GroupVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see Group
+ * @see GroupVo
+ */
+ fun groupToGroupVo(group: Group) = GroupVo(
+ id = group.id,
+ name = group.name,
+ enable = group.enable == 1,
+ createTime = group.createTime,
+ updateTime = group.updateTime
+ )
+
+ /**
+ * Convert Group object into GroupWithRoleVo object
+ *
+ * @param group Group object
+ * @return GroupWithRoleVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see Group
+ * @see GroupWithRoleVo
+ */
+ fun groupToGroupWithRoleVo(group: Group) = GroupWithRoleVo(
+ id = group.id,
+ name = group.name,
+ enable = group.enable == 1,
+ createTime = group.createTime,
+ updateTime = group.updateTime,
+ roles = group.roles?.map(RoleConverter::roleToRoleVo)
+ )
+
+ /**
+ * Convert IPage object into PageVo object
+ *
+ * @param groupPage IPage object
+ * @return PageVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IPage
+ * @see Group
+ * @see PageVo
+ * @see GroupWithRoleVo
+ */
+ fun groupPageToGroupWithRolePageVo(groupPage: IPage) = PageVo(
+ total = groupPage.total,
+ pages = groupPage.pages,
+ size = groupPage.size,
+ current = groupPage.current,
+ records = groupPage.records.map(::groupToGroupWithRoleVo)
+ )
+
+ /**
+ * Convert GroupAddParam object into Group object
+ *
+ * @param groupAddParam GroupAddParam object
+ * @return Group object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see GroupAddParam
+ * @see Group
+ */
+ fun groupAddParamToGroup(groupAddParam: GroupAddParam) = Group().apply {
+ name = groupAddParam.name
+ enable = if (groupAddParam.enable) 1 else 0
+ roles = groupAddParam.roleIds?.map { Role().apply { id = it } }
+ }
+
+ /**
+ * Convert GroupUpdateParam object into Group object
+ *
+ * @param groupUpdateParam GroupUpdateParam object
+ * @return Group object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see GroupUpdateParam
+ * @see Group
+ */
+ fun groupUpdateParamToGroup(groupUpdateParam: GroupUpdateParam) = Group().apply {
+ id = groupUpdateParam.id
+ name = groupUpdateParam.name
+ enable = if (groupUpdateParam.enable) 1 else 0
+ roles = groupUpdateParam.roleIds?.map { Role().apply { id = it } }
+ }
+
+ /**
+ * Convert GroupUpdateStatusParam object into Group object
+ *
+ * @param groupUpdateStatusParam GroupUpdateStatusParam object
+ * @return Group object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see GroupUpdateStatusParam
+ * @see Group
+ */
+ fun groupUpdateStatusParamToGroup(groupUpdateStatusParam: GroupUpdateStatusParam) = Group().apply {
+ id = groupUpdateStatusParam.id
+ enable = if (groupUpdateStatusParam.enable) 1 else 0
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/MenuConverter.kt b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/MenuConverter.kt
new file mode 100644
index 0000000..ef573d1
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/MenuConverter.kt
@@ -0,0 +1,30 @@
+package top.fatweb.oxygen.api.converter.permission
+
+import top.fatweb.oxygen.api.entity.permission.Menu
+import top.fatweb.oxygen.api.vo.permission.base.MenuVo
+
+/**
+ * Menu converter
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+object MenuConverter {
+ /**
+ * Convert Menu object into MenuVo object
+ *
+ * @param menu Menu object
+ * @return MenuVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see Menu
+ * @see MenuVo
+ */
+ fun menuToMenuVo(menu: Menu) = MenuVo(
+ id = menu.id,
+ name = menu.name,
+ url = menu.url,
+ parentId = menu.parentId,
+ moduleId = menu.moduleId
+ )
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/ModuleConverter.kt b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/ModuleConverter.kt
new file mode 100644
index 0000000..4760c51
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/ModuleConverter.kt
@@ -0,0 +1,27 @@
+package top.fatweb.oxygen.api.converter.permission
+
+import top.fatweb.oxygen.api.entity.permission.Module
+import top.fatweb.oxygen.api.vo.permission.base.ModuleVo
+
+/**
+ * Module converter
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+object ModuleConverter {
+ /**
+ * Convert Module object into ModuleVo object
+ *
+ * @param module Module object
+ * @return ModuleVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see Module
+ * @see ModuleVo
+ */
+ fun moduleToModuleVo(module: Module) = ModuleVo(
+ id = module.id,
+ name = module.name
+ )
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/OperationConverter.kt b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/OperationConverter.kt
new file mode 100644
index 0000000..dd9f0b3
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/OperationConverter.kt
@@ -0,0 +1,29 @@
+package top.fatweb.oxygen.api.converter.permission
+
+import top.fatweb.oxygen.api.entity.permission.Operation
+import top.fatweb.oxygen.api.vo.permission.base.OperationVo
+
+/**
+ * Operation converter
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+object OperationConverter {
+ /**
+ * Convert Operation object into OperationVo object
+ *
+ * @param operation Operation object
+ * @return OperationVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see Operation
+ * @see OperationVo
+ */
+ fun operationToOperationVo(operation: Operation) = OperationVo(
+ id = operation.id,
+ name = operation.name,
+ code = operation.code,
+ funcId = operation.funcId
+ )
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/PowerConverter.kt b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/PowerConverter.kt
new file mode 100644
index 0000000..5fea079
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/PowerConverter.kt
@@ -0,0 +1,29 @@
+package top.fatweb.oxygen.api.converter.permission
+
+import top.fatweb.oxygen.api.entity.permission.PowerSet
+import top.fatweb.oxygen.api.vo.permission.PowerSetVo
+
+/**
+ * Power converter
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+object PowerConverter {
+ /**
+ * Convert PowerSet object into PowerSetVo object
+ *
+ * @param powerSet PowerSet object
+ * @return PowerSetVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see PowerSet
+ * @see PowerSetVo
+ */
+ fun powerSetToPowerSetVo(powerSet: PowerSet) = PowerSetVo(
+ moduleList = powerSet.moduleList?.map(ModuleConverter::moduleToModuleVo),
+ menuList = powerSet.menuList?.map(MenuConverter::menuToMenuVo),
+ funcList = powerSet.funcList?.map(FuncConverter::funcToFuncVo),
+ operationList = powerSet.operationList?.map(OperationConverter::operationToOperationVo)
+ )
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/RoleConverter.kt b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/RoleConverter.kt
new file mode 100644
index 0000000..98f7375
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/RoleConverter.kt
@@ -0,0 +1,127 @@
+package top.fatweb.oxygen.api.converter.permission
+
+import com.baomidou.mybatisplus.core.metadata.IPage
+import top.fatweb.oxygen.api.entity.permission.Power
+import top.fatweb.oxygen.api.entity.permission.Role
+import top.fatweb.oxygen.api.param.permission.role.RoleAddParam
+import top.fatweb.oxygen.api.param.permission.role.RoleUpdateParam
+import top.fatweb.oxygen.api.param.permission.role.RoleUpdateStatusParam
+import top.fatweb.oxygen.api.vo.PageVo
+import top.fatweb.oxygen.api.vo.permission.RoleWithPowerVo
+import top.fatweb.oxygen.api.vo.permission.base.RoleVo
+
+/**
+ * Role converter
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+object RoleConverter {
+ /**
+ * Convert Role object into RoleVo object
+ *
+ * @param role Role object
+ * @return RoleVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see Role
+ * @see RoleVo
+ */
+ fun roleToRoleVo(role: Role) = RoleVo(
+ id = role.id,
+ name = role.name,
+ enable = role.enable == 1,
+ createTime = role.createTime,
+ updateTime = role.updateTime
+ )
+
+ /**
+ * Convert Role object into RoleWithPowerVo object
+ *
+ * @param role Role object
+ * @return RoleWithPowerVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see Role
+ * @see RoleWithPowerVo
+ */
+ fun roleToRoleWithPowerVo(role: Role) = RoleWithPowerVo(
+ id = role.id,
+ name = role.name,
+ enable = role.enable == 1,
+ createTime = role.createTime,
+ updateTime = role.updateTime,
+ modules = role.modules?.map(ModuleConverter::moduleToModuleVo),
+ menus = role.menus?.map(MenuConverter::menuToMenuVo),
+ funcs = role.funcs?.map(FuncConverter::funcToFuncVo),
+ operations = role.operations?.map(OperationConverter::operationToOperationVo)
+ )
+
+ /**
+ * Convert IPage object into PageVo object
+ *
+ * @param rolePage IPage object
+ * @return PageVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IPage
+ * @see Role
+ * @see PageVo
+ * @see RoleWithPowerVo
+ */
+ fun rolePageToRoleWithPowerPageVo(rolePage: IPage) = PageVo(
+ total = rolePage.total,
+ pages = rolePage.pages,
+ size = rolePage.size,
+ current = rolePage.current,
+ records = rolePage.records.map(::roleToRoleWithPowerVo)
+ )
+
+ /**
+ * Convert RoleAddParam object into Role object
+ *
+ * @param roleAddParam RoleAddParam object
+ * @return Role object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see RoleAddParam
+ * @see Role
+ */
+ fun roleAddParamToRole(roleAddParam: RoleAddParam) = Role().apply {
+ name = roleAddParam.name
+ enable = if (roleAddParam.enable) 1 else 0
+ powers = roleAddParam.powerIds?.map { Power().apply { id = it } }
+ }
+
+ /**
+ * Convert RoleUpdateParam into Role object
+ *
+ * @param roleUpdateParam RoleUpdateParam object
+ * @return Role object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see RoleUpdateParam
+ * @see Role
+ */
+ fun roleUpdateParamToRole(roleUpdateParam: RoleUpdateParam) = Role().apply {
+ id = roleUpdateParam.id
+ name = roleUpdateParam.name
+ enable = if (roleUpdateParam.enable) 1 else 0
+ powers = roleUpdateParam.powerIds?.map { Power().apply { id = it } }
+ }
+
+ /**
+ * Convert RoleUpdateStatusParam object into Role object
+ *
+ * @param roleUpdateStatusParam RoleUpdateStatusParam object
+ * @return Role object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see RoleUpdateStatusParam
+ * @see Role
+ */
+ fun roleUpdateStatusParamToRole(roleUpdateStatusParam: RoleUpdateStatusParam) = Role().apply {
+ id = roleUpdateStatusParam.id
+ enable = if (roleUpdateStatusParam.enable) 1 else 0
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/UserConverter.kt b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/UserConverter.kt
new file mode 100644
index 0000000..9f299b7
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/UserConverter.kt
@@ -0,0 +1,213 @@
+package top.fatweb.oxygen.api.converter.permission
+
+import com.baomidou.mybatisplus.core.metadata.IPage
+import top.fatweb.avatargenerator.GitHubAvatar
+import top.fatweb.oxygen.api.entity.permission.Group
+import top.fatweb.oxygen.api.entity.permission.Role
+import top.fatweb.oxygen.api.entity.permission.User
+import top.fatweb.oxygen.api.entity.permission.UserInfo
+import top.fatweb.oxygen.api.param.permission.user.UserAddParam
+import top.fatweb.oxygen.api.param.permission.user.UserUpdateParam
+import top.fatweb.oxygen.api.vo.PageVo
+import top.fatweb.oxygen.api.vo.permission.UserWithInfoVo
+import top.fatweb.oxygen.api.vo.permission.UserWithPasswordRoleInfoVo
+import top.fatweb.oxygen.api.vo.permission.UserWithPowerInfoVo
+import top.fatweb.oxygen.api.vo.permission.UserWithRoleInfoVo
+
+/**
+ * User converter
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+object UserConverter {
+ /**
+ * Convert User object into UserWithPowerInfoVo object
+ *
+ * @param user User object
+ * @return UserWithPowerInfoVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see User
+ * @see UserWithPowerInfoVo
+ */
+ fun userToUserWithPowerInfoVo(user: User) = UserWithPowerInfoVo(
+ id = user.id,
+ username = user.username,
+ verified = user.verify.isNullOrBlank(),
+ locking = user.locking?.let { it == 1 },
+ expiration = user.expiration,
+ credentialsExpiration = user.credentialsExpiration,
+ enable = user.enable?.let { it == 1 },
+ currentLoginTime = user.currentLoginTime,
+ currentLoginIp = user.currentLoginIp,
+ lastLoginTime = user.lastLoginTime,
+ lastLoginIp = user.lastLoginIp,
+ createTime = user.createTime,
+ updateTime = user.updateTime,
+ userInfo = user.userInfo?.let(UserInfoConverter::userInfoToUserInfoVo),
+ modules = user.modules?.map(ModuleConverter::moduleToModuleVo),
+ menus = user.menus?.map(MenuConverter::menuToMenuVo),
+ funcs = user.funcs?.map(FuncConverter::funcToFuncVo),
+ operations = user.operations?.map(OperationConverter::operationToOperationVo)
+ )
+
+ /**
+ * Convert User object into UserWithRoleInfoVo object
+ *
+ * @param user User object
+ * @return UserWithRoleInfoVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see User
+ * @see UserWithRoleInfoVo
+ */
+ fun userToUserWithRoleInfoVo(user: User) = UserWithRoleInfoVo(
+ id = user.id,
+ username = user.username,
+ verify = user.verify,
+ locking = user.locking?.let { it == 1 },
+ expiration = user.expiration,
+ credentialsExpiration = user.credentialsExpiration,
+ enable = user.enable?.let { it == 1 },
+ currentLoginTime = user.currentLoginTime,
+ currentLoginIp = user.currentLoginIp,
+ lastLoginTime = user.lastLoginTime,
+ lastLoginIp = user.lastLoginIp,
+ createTime = user.createTime,
+ updateTime = user.updateTime,
+ userInfo = user.userInfo?.let(UserInfoConverter::userInfoToUserInfoVo),
+ roles = user.roles?.map(RoleConverter::roleToRoleVo),
+ groups = user.groups?.map(GroupConverter::groupToGroupVo)
+ )
+
+ /**
+ * Convert User object into UserWithInfoVo object
+ *
+ * @param user User object
+ * @return UserWithInfoVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see User
+ * @see UserWithInfoVo
+ */
+ fun userToUserWithInfoVo(user: User) = UserWithInfoVo(
+ id = user.id,
+ username = user.username,
+ verified = user.verify.isNullOrBlank(),
+ locking = user.locking?.let { it == 1 },
+ expiration = user.expiration,
+ credentialsExpiration = user.credentialsExpiration,
+ enable = user.enable?.let { it == 1 },
+ currentLoginTime = user.currentLoginTime,
+ currentLoginIp = user.currentLoginIp,
+ lastLoginTime = user.lastLoginTime,
+ lastLoginIp = user.lastLoginIp,
+ createTime = user.createTime,
+ updateTime = user.updateTime,
+ userInfo = user.userInfo?.let(UserInfoConverter::userInfoToUserInfoVo)
+ )
+
+ /**
+ * Convert User object into UserWithPasswordRoleInfoVo object
+ *
+ * @param user User object
+ * @return UserWithPasswordRoleInfoVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see User
+ * @see UserWithPasswordRoleInfoVo
+ */
+ fun userToUserWithPasswordRoleInfoVo(user: User) = UserWithPasswordRoleInfoVo(
+ id = user.id,
+ username = user.username,
+ password = user.password,
+ verify = user.verify,
+ locking = user.locking?.let { it == 1 },
+ expiration = user.expiration,
+ credentialsExpiration = user.credentialsExpiration,
+ enable = user.enable?.let { it == 1 },
+ currentLoginTime = user.currentLoginTime,
+ currentLoginIp = user.currentLoginIp,
+ lastLoginTime = user.lastLoginTime,
+ lastLoginIp = user.lastLoginIp,
+ createTime = user.createTime,
+ updateTime = user.updateTime,
+ userInfo = user.userInfo?.let(UserInfoConverter::userInfoToUserInfoVo),
+ roles = user.roles?.map(RoleConverter::roleToRoleVo),
+ groups = user.groups?.map(GroupConverter::groupToGroupVo)
+ )
+
+ /**
+ * Convert UserAddParam object into User object
+ *
+ * @param userAddParam UserAddParam object
+ * @return User object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see UserAddParam
+ * @see User
+ */
+ fun userAddParamToUser(userAddParam: UserAddParam) = User().apply {
+ username = userAddParam.username
+ password = userAddParam.password
+ locking = if (userAddParam.locking) 1 else 0
+ expiration = userAddParam.expiration
+ credentialsExpiration = userAddParam.credentialsExpiration
+ enable = if (userAddParam.enable) 1 else 0
+ userInfo = UserInfo().apply {
+ nickname = userAddParam.nickname ?: userAddParam.username
+ avatar = userAddParam.avatar ?: GitHubAvatar.newAvatarBuilder().build()
+ .createAsBase64((Long.MIN_VALUE..Long.MAX_VALUE).random())
+ email = userAddParam.email
+ }
+ roles = userAddParam.roleIds?.map { Role().apply { id = it } }
+ groups = userAddParam.groupIds?.map { Group().apply { id = it } }
+ }
+
+ /**
+ * Convert UserUpdateParam object into User object
+ *
+ * @param userUpdateParam UserUpdateParam object
+ * @return User object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see UserUpdateParam
+ * @see User
+ */
+ fun userUpdateParamToUser(userUpdateParam: UserUpdateParam) = User().apply {
+ id = userUpdateParam.id
+ username = userUpdateParam.username
+ locking = if (userUpdateParam.locking && userUpdateParam.id != 0L) 1 else 0
+ expiration = if (userUpdateParam.id != 0L) userUpdateParam.expiration else null
+ credentialsExpiration = userUpdateParam.credentialsExpiration
+ enable = if (userUpdateParam.enable || userUpdateParam.id == 0L) 1 else 0
+ userInfo = UserInfo().apply {
+ nickname = userUpdateParam.nickname
+ avatar = userUpdateParam.avatar
+ email = userUpdateParam.email
+ }
+ roles = if (userUpdateParam.id != 0L) userUpdateParam.roleIds?.map { Role().apply { id = it } } else null
+ groups = if (userUpdateParam.id != 0L) userUpdateParam.groupIds?.map { Group().apply { id = it } } else null
+ }
+
+ /**
+ * Convert IPage object into PageVo object
+ *
+ * @param userPage IPage object
+ * @return PageVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IPage
+ * @see User
+ * @see PageVo
+ * @see UserWithRoleInfoVo
+ */
+ fun userPageToUserWithRoleInfoPageVo(userPage: IPage) = PageVo(
+ total = userPage.total,
+ pages = userPage.pages,
+ size = userPage.size,
+ current = userPage.current,
+ records = userPage.records.map(::userToUserWithRoleInfoVo)
+ )
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/UserInfoConverter.kt b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/UserInfoConverter.kt
new file mode 100644
index 0000000..89bf651
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/converter/permission/UserInfoConverter.kt
@@ -0,0 +1,32 @@
+package top.fatweb.oxygen.api.converter.permission
+
+import top.fatweb.oxygen.api.entity.permission.UserInfo
+import top.fatweb.oxygen.api.vo.permission.base.UserInfoVo
+
+/**
+ * User information converter
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+object UserInfoConverter {
+ /**
+ * Convert UserInfo object into UserInfoVo object
+ *
+ * @param userInfo UserInfo object
+ * @return UserInfoVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see UserInfo
+ * @see UserInfoVo
+ */
+ fun userInfoToUserInfoVo(userInfo: UserInfo) = UserInfoVo(
+ id = userInfo.id,
+ userId = userInfo.userId,
+ nickname = userInfo.nickname,
+ avatar = userInfo.avatar,
+ email = userInfo.email,
+ createTime = userInfo.createTime,
+ updateTime = userInfo.updateTime
+ )
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/converter/system/SettingsConverter.kt b/src/main/kotlin/top/fatweb/oxygen/api/converter/system/SettingsConverter.kt
new file mode 100644
index 0000000..2d7f717
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/converter/system/SettingsConverter.kt
@@ -0,0 +1,46 @@
+package top.fatweb.oxygen.api.converter.system
+
+import top.fatweb.oxygen.api.entity.system.SensitiveWord
+import top.fatweb.oxygen.api.param.system.SensitiveWordAddParam
+import top.fatweb.oxygen.api.vo.system.SensitiveWordVo
+
+/**
+ * Settings converter
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+object SettingsConverter {
+ /**
+ * Convert SensitiveWord object into SensitiveWordVo object
+ *
+ * @param sensitiveWord SensitiveWord object
+ * @return SensitiveWordVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see SensitiveWord
+ * @see SensitiveWordVo
+ */
+ fun sensitiveWordToSensitiveWordVo(sensitiveWord: SensitiveWord) = SensitiveWordVo(
+ id = sensitiveWord.id,
+ word = sensitiveWord.word,
+ useFor = sensitiveWord.useFor?.map(SensitiveWord.Use::valueOf)?.toSet(),
+ enable = sensitiveWord.enable == 1
+ )
+
+ /**
+ * Convert SensitiveWordAddParam object into SensitiveWord object
+ *
+ * @param sensitiveWordAddParam SensitiveWordAddParam object
+ * @return SensitiveWord object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see SensitiveWordAddParam
+ * @see SensitiveWord
+ */
+ fun sensitiveWordAddParamToSensitiveWord(sensitiveWordAddParam: SensitiveWordAddParam) = SensitiveWord().apply {
+ word = sensitiveWordAddParam.word
+ useFor = sensitiveWordAddParam.useFor.map(SensitiveWord.Use::code).toSet()
+ enable = if (sensitiveWordAddParam.enable) 1 else 0
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/converter/system/SysLogConverter.kt b/src/main/kotlin/top/fatweb/oxygen/api/converter/system/SysLogConverter.kt
new file mode 100644
index 0000000..d94bd90
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/converter/system/SysLogConverter.kt
@@ -0,0 +1,53 @@
+package top.fatweb.oxygen.api.converter.system
+
+import com.baomidou.mybatisplus.core.metadata.IPage
+import top.fatweb.oxygen.api.entity.system.SysLog
+import top.fatweb.oxygen.api.vo.PageVo
+import top.fatweb.oxygen.api.vo.system.SysLogVo
+
+/**
+ * System log converter
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+object SysLogConverter {
+ /**
+ * Convert IPage object into PageVo object
+ *
+ * @param syslogPage IPage object
+ * @return PageVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see IPage
+ * @see SysLog
+ * @see PageVo
+ * @see SysLogVo
+ */
+ fun sysLogPageToSysLogPageVo(syslogPage: IPage) = PageVo(
+ syslogPage.total,
+ syslogPage.pages,
+ syslogPage.size,
+ syslogPage.current,
+ syslogPage.records.map {
+ SysLogVo(
+ id = it.id,
+ logType = it.logType,
+ operateUserId = it.operateUserId,
+ operateTime = it.operateTime,
+ requestUri = it.requestUri,
+ requestMethod = it.requestMethod,
+ requestParams = it.requestParams,
+ requestIp = it.requestIp,
+ requestServerAddress = it.requestServerAddress,
+ exception = it.exception == 1,
+ exceptionInfo = it.exceptionInfo,
+ startTime = it.startTime,
+ endTime = it.endTime,
+ executeTime = it.executeTime,
+ userAgent = it.userAgent,
+ operateUsername = it.operateUsername
+ )
+ })
+
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/converter/tool/ToolBaseConverter.kt b/src/main/kotlin/top/fatweb/oxygen/api/converter/tool/ToolBaseConverter.kt
new file mode 100644
index 0000000..1877c39
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/converter/tool/ToolBaseConverter.kt
@@ -0,0 +1,53 @@
+package top.fatweb.oxygen.api.converter.tool
+
+import top.fatweb.oxygen.api.entity.tool.ToolBase
+import top.fatweb.oxygen.api.vo.tool.ToolBaseVo
+import top.fatweb.oxygen.api.vo.tool.ToolDataVo
+
+/**
+ * Tool base converter
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+object ToolBaseConverter {
+ /**
+ * Convert ToolBase object into ToolBaseVo object
+ *
+ * @param toolBase ToolBase object
+ * @return ToolBaseVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolBase
+ * @see ToolBaseVo
+ */
+ fun toolBaseToToolBaseVo(toolBase: ToolBase) = ToolBaseVo(
+ id = toolBase.id,
+ name = toolBase.name,
+ source = toolBase.source?.let(ToolDataConverter::toolDataToToolDataVo),
+ dist = toolBase.dist?.let(ToolDataConverter::toolDataToToolDataVo),
+ compiled = toolBase.compiled == 1,
+ createTime = toolBase.createTime,
+ updateTime = toolBase.updateTime
+ )
+
+ /**
+ * Convert ToolBase object into ToolBaseVo object by get list
+ *
+ * @param toolBase ToolBase object
+ * @return ToolBaseVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolBase
+ * @see ToolBaseVo
+ */
+ fun toolBaseToToolBaseVoByGetList(toolBase: ToolBase) = ToolBaseVo(
+ id = toolBase.id,
+ name = toolBase.name,
+ source = ToolDataVo(id = toolBase.sourceId, data = null, createTime = null, updateTime = null),
+ dist = ToolDataVo(id = toolBase.distId, data = null, createTime = null, updateTime = null),
+ compiled = toolBase.compiled == 1,
+ createTime = toolBase.createTime,
+ updateTime = toolBase.updateTime
+ )
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/converter/tool/ToolCategoryConverter.kt b/src/main/kotlin/top/fatweb/oxygen/api/converter/tool/ToolCategoryConverter.kt
new file mode 100644
index 0000000..f01feb8
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/converter/tool/ToolCategoryConverter.kt
@@ -0,0 +1,63 @@
+package top.fatweb.oxygen.api.converter.tool
+
+import top.fatweb.oxygen.api.entity.tool.ToolCategory
+import top.fatweb.oxygen.api.param.tool.ToolCategoryAddParam
+import top.fatweb.oxygen.api.param.tool.ToolCategoryUpdateParam
+import top.fatweb.oxygen.api.vo.tool.ToolCategoryVo
+
+/**
+ * Tool category converter
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+object ToolCategoryConverter {
+ /**
+ * Convert ToolCategory object into ToolCategoryVo object
+ *
+ * @param toolCategory ToolCategory object
+ * @return ToolCategoryVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolCategory
+ * @see ToolCategoryVo
+ */
+ fun toolCategoryToToolCategoryVo(toolCategory: ToolCategory) = ToolCategoryVo(
+ id = toolCategory.id,
+ name = toolCategory.name,
+ enable = toolCategory.enable == 1,
+ createTime = toolCategory.createTime,
+ updateTime = toolCategory.updateTime
+ )
+
+ /**
+ * Convert ToolCategoryAddParam object into ToolCategory object
+ *
+ * @param toolCategoryAddParam ToolCategoryAddParam object
+ * @return ToolCateGory object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolCategoryAddParam
+ * @see ToolCategory
+ */
+ fun toolCategoryAddParamToToolCategory(toolCategoryAddParam: ToolCategoryAddParam) = ToolCategory().apply {
+ name = toolCategoryAddParam.name
+ enable = if (toolCategoryAddParam.enable) 1 else 0
+ }
+
+ /**
+ * Convert ToolCategoryUpdateParam object into ToolCategory object
+ *
+ * @param toolCategoryUpdateParam ToolCategoryUpdateParam object
+ * @return ToolCategory object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolCategoryUpdateParam
+ * @see ToolCategory
+ */
+ fun toolCategoryUpdateParamToToolCategory(toolCategoryUpdateParam: ToolCategoryUpdateParam) = ToolCategory().apply {
+ id = toolCategoryUpdateParam.id
+ name = toolCategoryUpdateParam.name
+ enable = toolCategoryUpdateParam.enable?. let { if (it) 1 else 0 }
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/converter/tool/ToolConverter.kt b/src/main/kotlin/top/fatweb/oxygen/api/converter/tool/ToolConverter.kt
new file mode 100644
index 0000000..b07c8bc
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/converter/tool/ToolConverter.kt
@@ -0,0 +1,65 @@
+package top.fatweb.oxygen.api.converter.tool
+
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page
+import top.fatweb.oxygen.api.converter.permission.UserConverter
+import top.fatweb.oxygen.api.entity.tool.Tool
+import top.fatweb.oxygen.api.vo.PageVo
+import top.fatweb.oxygen.api.vo.tool.ToolVo
+
+/**
+ * Tool converter
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+object ToolConverter {
+ /**
+ * Convert Tool object into ToolVo object
+ *
+ * @param tool Tool object
+ * @return ToolVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see Tool
+ * @see ToolVo
+ */
+ fun toolToToolVo(tool: Tool) = ToolVo(
+ id = tool.id,
+ name = tool.name,
+ toolId = tool.toolId,
+ icon = tool.icon,
+ description = tool.description,
+ base = tool.base?.let(ToolBaseConverter::toolBaseToToolBaseVo),
+ author = tool.author?.let(UserConverter::userToUserWithInfoVo),
+ ver = tool.ver,
+ keywords = tool.keywords,
+ categories = tool.categories?.map(ToolCategoryConverter::toolCategoryToToolCategoryVo),
+ source = tool.source?.let(ToolDataConverter::toolDataToToolDataVo),
+ dist = tool.dist?.let(ToolDataConverter::toolDataToToolDataVo),
+ entryPoint = tool.entryPoint,
+ publish = tool.publish,
+ review = tool.review,
+ createTime = tool.createTime,
+ updateTime = tool.updateTime
+ )
+
+ /**
+ * Convert Page object into PageVo object
+ *
+ * @param toolPage Page object
+ * @return PageVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see Page
+ * @see Tool
+ * @see PageVo
+ * @see ToolVo
+ */
+ fun toolPageToToolPageVo(toolPage: Page): PageVo = PageVo(
+ total = toolPage.total,
+ pages = toolPage.pages,
+ size = toolPage.size,
+ current = toolPage.current,
+ records = toolPage.records.map(::toolToToolVo)
+ )
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/converter/tool/ToolDataConverter.kt b/src/main/kotlin/top/fatweb/oxygen/api/converter/tool/ToolDataConverter.kt
new file mode 100644
index 0000000..117752d
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/converter/tool/ToolDataConverter.kt
@@ -0,0 +1,29 @@
+package top.fatweb.oxygen.api.converter.tool
+
+import top.fatweb.oxygen.api.entity.tool.ToolData
+import top.fatweb.oxygen.api.vo.tool.ToolDataVo
+
+/**
+ * Tool data converter
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+object ToolDataConverter {
+ /**
+ * Convert ToolData object into ToolDataVo object
+ *
+ * @param toolData ToolData object
+ * @return ToolDataVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolData
+ * @see ToolDataVo
+ */
+ fun toolDataToToolDataVo(toolData: ToolData) = ToolDataVo(
+ id = toolData.id,
+ data = toolData.data,
+ createTime = toolData.createTime,
+ updateTime = toolData.updateTime
+ )
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/converter/tool/ToolTemplateConverter.kt b/src/main/kotlin/top/fatweb/oxygen/api/converter/tool/ToolTemplateConverter.kt
new file mode 100644
index 0000000..e3243ce
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/converter/tool/ToolTemplateConverter.kt
@@ -0,0 +1,85 @@
+package top.fatweb.oxygen.api.converter.tool
+
+import top.fatweb.oxygen.api.entity.tool.ToolTemplate
+import top.fatweb.oxygen.api.vo.tool.ToolBaseVo
+import top.fatweb.oxygen.api.vo.tool.ToolDataVo
+import top.fatweb.oxygen.api.vo.tool.ToolTemplateVo
+
+/**
+ * Tool template converter
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+object ToolTemplateConverter {
+ /**
+ * Convert ToolTemplate object into ToolTemplateVo object
+ *
+ * @param toolTemplate ToolTemplate object
+ * @return ToolTemplateVo object
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ToolTemplate
+ * @see ToolTemplateVo
+ */
+ fun toolTemplateToToolTemplateVo(toolTemplate: ToolTemplate) = ToolTemplateVo(
+ id = toolTemplate.id,
+ name = toolTemplate.name,
+ base = toolTemplate.base?.let(ToolBaseConverter::toolBaseToToolBaseVo),
+ source = toolTemplate.source?.let(ToolDataConverter::toolDataToToolDataVo),
+ entryPoint = toolTemplate.entryPoint,
+ enable = toolTemplate.enable == 1,
+ createTime = toolTemplate.createTime,
+ updateTime = toolTemplate.updateTime
+ )
+
+ /**
+ * Convert ToolTemplate object into ToolTemplateVo object by list
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ fun toolTemplateToToolTemplateVoByList(toolTemplate: ToolTemplate) = ToolTemplateVo(
+ id = toolTemplate.id,
+ name = toolTemplate.name,
+ base = ToolBaseVo(
+ id = toolTemplate.baseId,
+ name = null,
+ source = null,
+ dist = null,
+ compiled = null,
+ createTime = null,
+ updateTime = null
+ ),
+ source = ToolDataVo(id = toolTemplate.sourceId, data = null, createTime = null, updateTime = null),
+ entryPoint = toolTemplate.entryPoint,
+ enable = toolTemplate.enable == 1,
+ createTime = toolTemplate.createTime,
+ updateTime = toolTemplate.updateTime
+ )
+
+ /**
+ * Convert ToolTemplate object into ToolTemplateVo object with base dist
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ fun toolTemplateToToolTemplateVoWithBaseDist(toolTemplate: ToolTemplate) = ToolTemplateVo(
+ id = toolTemplate.id,
+ name = toolTemplate.name,
+ base = ToolBaseVo(
+ id = toolTemplate.baseId,
+ name = toolTemplate.base?.name,
+ source = null,
+ dist = ToolDataVo(id = null, data = toolTemplate.base?.distData, createTime = null, updateTime = null),
+ compiled = null,
+ createTime = null,
+ updateTime = null
+ ),
+ source = toolTemplate.source?.let(ToolDataConverter::toolDataToToolDataVo),
+ entryPoint = toolTemplate.entryPoint,
+ enable = toolTemplate.enable == 1,
+ createTime = toolTemplate.createTime,
+ updateTime = toolTemplate.updateTime
+ )
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/cron/StatisticsCron.kt b/src/main/kotlin/top/fatweb/oxygen/api/cron/StatisticsCron.kt
new file mode 100644
index 0000000..e4b014f
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/cron/StatisticsCron.kt
@@ -0,0 +1,35 @@
+package top.fatweb.oxygen.api.cron
+
+import org.springframework.scheduling.annotation.Scheduled
+import org.springframework.stereotype.Component
+import top.fatweb.oxygen.api.entity.system.StatisticsLog
+import top.fatweb.oxygen.api.properties.SecurityProperties
+import top.fatweb.oxygen.api.service.system.IStatisticsLogService
+import top.fatweb.oxygen.api.util.RedisUtil
+
+/**
+ * Statistics scheduled tasks
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+@Component
+class StatisticsCron(
+ private val redisUtil: RedisUtil,
+ private val statisticsLogService: IStatisticsLogService
+) {
+ /**
+ * Auto record number of online users
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @Scheduled(cron = "0 * * * * *")
+ fun onlineUserCount() {
+ statisticsLogService.save(StatisticsLog().apply {
+ key = StatisticsLog.KeyItem.ONLINE_USERS_COUNT
+ value = redisUtil.keys("${SecurityProperties.jwtIssuer}_login_*")
+ .distinctBy { Regex("${SecurityProperties.jwtIssuer}_login_(.*):.*").matchEntire(it)?.groupValues?.getOrNull(1) }.size.toString()
+ })
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/entity/common/BusinessCode.kt b/src/main/kotlin/top/fatweb/oxygen/api/entity/common/BusinessCode.kt
new file mode 100644
index 0000000..5b1f363
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/entity/common/BusinessCode.kt
@@ -0,0 +1,49 @@
+package top.fatweb.oxygen.api.entity.common
+
+/**
+ * Business code entity
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+enum class BusinessCode(val code: Int) {
+ /**
+ * System
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ SYSTEM(100),
+
+ /**
+ * Permission
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ PERMISSION(200),
+
+ /**
+ * Database
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ DATABASE(300),
+
+ /**
+ * Tool
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ TOOL(400),
+
+ /**
+ * Avatar API
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ API_AVATAR(501)
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/entity/common/ResponseCode.kt b/src/main/kotlin/top/fatweb/oxygen/api/entity/common/ResponseCode.kt
new file mode 100644
index 0000000..83a3dfd
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/entity/common/ResponseCode.kt
@@ -0,0 +1,76 @@
+package top.fatweb.oxygen.api.entity.common
+
+/**
+ * Response code entity
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+enum class ResponseCode(val code: Int) {
+ SYSTEM_OK(BusinessCode.SYSTEM, 0),
+
+ SYSTEM_ERROR(BusinessCode.SYSTEM, 50),
+ SYSTEM_TIMEOUT(BusinessCode.SYSTEM, 51),
+ SYSTEM_REQUEST_ILLEGAL(BusinessCode.SYSTEM, 52),
+ SYSTEM_ARGUMENT_NOT_VALID(BusinessCode.SYSTEM, 53),
+ SYSTEM_INVALID_CAPTCHA_CODE(BusinessCode.SYSTEM, 54),
+ SYSTEM_REQUEST_TOO_FREQUENT(BusinessCode.SYSTEM, 55),
+ SYSTEM_MATCH_SENSITIVE_WORD(BusinessCode.SYSTEM, 56),
+
+ PERMISSION_LOGIN_SUCCESS(BusinessCode.PERMISSION, 0),
+ PERMISSION_PASSWORD_CHANGE_SUCCESS(BusinessCode.PERMISSION, 1),
+ PERMISSION_LOGOUT_SUCCESS(BusinessCode.PERMISSION, 2),
+ PERMISSION_TOKEN_RENEW_SUCCESS(BusinessCode.PERMISSION, 3),
+ PERMISSION_REGISTER_SUCCESS(BusinessCode.PERMISSION, 4),
+ PERMISSION_RESEND_SUCCESS(BusinessCode.PERMISSION, 5),
+ PERMISSION_VERIFY_SUCCESS(BusinessCode.PERMISSION, 6),
+ PERMISSION_FORGET_SUCCESS(BusinessCode.PERMISSION, 7),
+ PERMISSION_RETRIEVE_SUCCESS(BusinessCode.PERMISSION, 8),
+
+ PERMISSION_UNAUTHORIZED(BusinessCode.PERMISSION, 50),
+ PERMISSION_USERNAME_NOT_FOUND(BusinessCode.PERMISSION, 51),
+ PERMISSION_ACCESS_DENIED(BusinessCode.PERMISSION, 52),
+ PERMISSION_USER_LOCKED(BusinessCode.PERMISSION, 53),
+ PERMISSION_USER_EXPIRED(BusinessCode.PERMISSION, 54),
+ PERMISSION_USER_CREDENTIALS_EXPIRED(BusinessCode.PERMISSION, 55),
+ PERMISSION_USER_DISABLE(BusinessCode.PERMISSION, 56),
+ PERMISSION_LOGIN_USERNAME_PASSWORD_ERROR(BusinessCode.PERMISSION, 57),
+ PERMISSION_OLD_PASSWORD_NOT_MATCH(BusinessCode.PERMISSION, 58),
+ PERMISSION_LOGOUT_FAILED(BusinessCode.PERMISSION, 59),
+ PERMISSION_TOKEN_ILLEGAL(BusinessCode.PERMISSION, 60),
+ PERMISSION_TOKEN_HAS_EXPIRED(BusinessCode.PERMISSION, 61),
+ PERMISSION_NO_VERIFICATION_REQUIRED(BusinessCode.PERMISSION, 62),
+ PERMISSION_VERIFY_CODE_ERROR_OR_EXPIRED(BusinessCode.PERMISSION, 63),
+ PERMISSION_ACCOUNT_NEED_INIT(BusinessCode.PERMISSION, 64),
+ PERMISSION_USER_NOT_FOUND(BusinessCode.PERMISSION, 65),
+ PERMISSION_RETRIEVE_CODE_ERROR_OR_EXPIRED(BusinessCode.PERMISSION, 66),
+ PERMISSION_ACCOUNT_NEED_RESET_PASSWORD(BusinessCode.PERMISSION, 67),
+
+ DATABASE_SELECT_SUCCESS(BusinessCode.DATABASE, 0),
+ DATABASE_SELECT_FAILED(BusinessCode.DATABASE, 5),
+ DATABASE_INSERT_SUCCESS(BusinessCode.DATABASE, 10),
+ DATABASE_INSERT_FAILED(BusinessCode.DATABASE, 15),
+ DATABASE_UPDATE_SUCCESS(BusinessCode.DATABASE, 20),
+ DATABASE_UPDATE_FAILED(BusinessCode.DATABASE, 25),
+ DATABASE_DELETE_SUCCESS(BusinessCode.DATABASE, 30),
+ DATABASE_DELETE_FAILED(BusinessCode.DATABASE, 35),
+ DATABASE_EXECUTE_ERROR(BusinessCode.DATABASE, 50),
+ DATABASE_DUPLICATE_KEY(BusinessCode.DATABASE, 51),
+ DATABASE_NO_RECORD_FOUND(BusinessCode.DATABASE, 52),
+
+ TOOL_SUBMIT_SUCCESS(BusinessCode.TOOL, 10),
+ TOOL_CANCEL_SUCCESS(BusinessCode.TOOL, 11),
+ TOOL_ILLEGAL_VERSION(BusinessCode.TOOL, 50),
+ TOOL_UNDER_REVIEW(BusinessCode.TOOL, 51),
+ TOOL_NOT_UNDER_REVIEW(BusinessCode.TOOL, 52),
+ TOOL_HAS_UNPUBLISHED_VERSION(BusinessCode.TOOL, 53),
+ TOOL_HAS_NOT_BEEN_PUBLISHED(BusinessCode.TOOL, 54),
+ TOOL_HAS_BEEN_PUBLISHED(BusinessCode.TOOL, 55),
+ TOOL_SUBMIT_ERROR(BusinessCode.TOOL, 60),
+ TOOL_CANCEL_ERROR(BusinessCode.TOOL, 61),
+
+ API_AVATAR_SUCCESS(BusinessCode.API_AVATAR, 0),
+ API_AVATAR_ERROR(BusinessCode.API_AVATAR, 50);
+
+ constructor(businessCode: BusinessCode, code: Int) : this(businessCode.code * 100 + code)
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/entity/common/ResponseResult.kt b/src/main/kotlin/top/fatweb/oxygen/api/entity/common/ResponseResult.kt
new file mode 100644
index 0000000..7c866fe
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/entity/common/ResponseResult.kt
@@ -0,0 +1,103 @@
+package top.fatweb.oxygen.api.entity.common
+
+import io.swagger.v3.oas.annotations.media.Schema
+import java.io.Serializable
+
+/**
+ * Response result entity
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+class ResponseResult private constructor(
+ @Schema(description = "响应码", defaultValue = "200") val code: Int,
+
+ @Schema(description = "是否调用成功") val success: Boolean,
+
+ @Schema(description = "信息") val msg: String,
+
+ @Schema(description = "数据") val data: T?
+) : Serializable {
+ companion object {
+ /**
+ * Build response result object
+ *
+ * @param code Response code
+ * @param success Is successful
+ * @param msg Response message
+ * @param data Response data
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ fun build(code: Int, success: Boolean, msg: String, data: T?) =
+ ResponseResult(code, success, msg, data)
+
+ /**
+ * Build response result object
+ *
+ * @param code Response code object
+ * @param success Is successful
+ * @param msg Response message
+ * @param data Response data
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseCode
+ */
+ fun build(code: ResponseCode, success: Boolean, msg: String, data: T?) =
+ build(code.code, success, msg, data)
+
+ /**
+ * Build successful response result object
+ *
+ * @param code Response code object
+ * @param msg Response message
+ * @param data Response data
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseCode
+ */
+ fun success(code: ResponseCode = ResponseCode.SYSTEM_OK, msg: String = "success", data: T? = null) =
+ build(code, true, msg, data)
+
+ /**
+ * Build failure response result object
+ *
+ * @param code Response code object
+ * @param msg Response message
+ * @param data Response data
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseCode
+ */
+ fun fail(code: ResponseCode = ResponseCode.SYSTEM_ERROR, msg: String = "fail", data: T? = null) =
+ build(code, false, msg, data)
+
+ /**
+ * Build database successful response result object
+ *
+ * @param code Response code object
+ * @param msg Response message
+ * @param data Response data
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseCode
+ */
+ fun databaseSuccess(
+ code: ResponseCode = ResponseCode.DATABASE_SELECT_SUCCESS, msg: String = "success", data: T? = null
+ ) = build(code, true, msg, data)
+
+ /**
+ * Build database failure response result object
+ *
+ * @param code Response code object
+ * @param msg Response message
+ * @param data Response data
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see ResponseCode
+ */
+ fun databaseFail(
+ code: ResponseCode = ResponseCode.DATABASE_SELECT_FAILED, msg: String = "fail", data: T? = null
+ ) = build(code, false, msg, data)
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Func.kt b/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Func.kt
new file mode 100644
index 0000000..61fa701
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Func.kt
@@ -0,0 +1,55 @@
+package top.fatweb.oxygen.api.entity.permission
+
+import com.baomidou.mybatisplus.annotation.TableField
+import com.baomidou.mybatisplus.annotation.TableId
+import com.baomidou.mybatisplus.annotation.TableName
+import java.io.Serializable
+
+/**
+ * Function entity
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+@TableName("t_s_func")
+class Func : Serializable {
+ /**
+ * ID
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableId("id")
+ var id: Long? = null
+
+ /**
+ * Name
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableField("name")
+ var name: String? = null
+
+ /**
+ * Parent ID
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableField("parent_id")
+ var parentId: Long? = null
+
+ /**
+ * Menu ID
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableField("menu_id")
+ var menuId: Long? = null
+
+ override fun toString(): String {
+ return "Func(id=$id, name=$name, parentId=$parentId, menuId=$menuId)"
+ }
+}
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Group.kt b/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Group.kt
new file mode 100644
index 0000000..5d779ad
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Group.kt
@@ -0,0 +1,95 @@
+package top.fatweb.oxygen.api.entity.permission
+
+import com.baomidou.mybatisplus.annotation.*
+import java.io.Serializable
+import java.time.LocalDateTime
+
+/**
+ * Group entity
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+@TableName("t_s_group")
+class Group : Serializable {
+ /**
+ * ID
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableId("id")
+ var id: Long? = null
+
+ /**
+ * Name
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableField("name")
+ var name: String? = null
+
+ /**
+ * Enable
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableField("enable")
+ var enable: Int? = null
+
+ /**
+ * Create time
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see LocalDateTime
+ */
+ @TableField("create_time", fill = FieldFill.INSERT)
+ var createTime: LocalDateTime? = null
+
+ /**
+ * Update time
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see LocalDateTime
+ */
+ @TableField("update_time", fill = FieldFill.INSERT_UPDATE)
+ var updateTime: LocalDateTime? = null
+
+ /**
+ * Deleted
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableField("deleted")
+ @TableLogic
+ var deleted: Long? = null
+
+ /**
+ * Version
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableField("version")
+ @Version
+ var version: Int? = null
+
+ /**
+ * Role list
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see Role
+ */
+ @TableField(exist = false)
+ var roles: List? = null
+
+ override fun toString(): String {
+ return "Group(id=$id, name=$name, enable=$enable, createTime=$createTime, updateTime=$updateTime, deleted=$deleted, version=$version, roles=$roles)"
+ }
+}
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/LoginUser.kt b/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/LoginUser.kt
new file mode 100644
index 0000000..29fafce
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/LoginUser.kt
@@ -0,0 +1,67 @@
+package top.fatweb.oxygen.api.entity.permission
+
+import com.fasterxml.jackson.annotation.JsonIgnore
+import com.fasterxml.jackson.annotation.JsonTypeInfo
+import org.springframework.security.core.GrantedAuthority
+import org.springframework.security.core.authority.SimpleGrantedAuthority
+import org.springframework.security.core.userdetails.UserDetails
+import java.time.LocalDateTime
+import java.time.ZoneOffset
+
+/**
+ * Login user entity
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see UserDetails
+ */
+@JsonTypeInfo(use = JsonTypeInfo.Id.CLASS)
+class LoginUser() : UserDetails {
+ /**
+ * User object
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see User
+ */
+ lateinit var user: User
+
+ @JsonIgnore
+ private var authorities: List? = null
+
+ constructor(user: User) : this() {
+ this.user = user
+ }
+
+ @JsonIgnore
+ override fun getAuthorities(): List {
+ authorities?.let { return it }
+ authorities = user.operations?.map { SimpleGrantedAuthority(it.code) } ?: emptyList()
+
+ return authorities as List
+ }
+
+ @JsonIgnore
+ override fun getPassword() = user.password
+
+ @JsonIgnore
+ override fun getUsername() = user.username
+
+ @JsonIgnore
+ override fun isAccountNonExpired() =
+ user.expiration == null || user.expiration!!.isAfter(LocalDateTime.now(ZoneOffset.UTC))
+
+ @JsonIgnore
+ override fun isAccountNonLocked() = user.locking == 0
+
+ @JsonIgnore
+ override fun isCredentialsNonExpired() =
+ user.credentialsExpiration == null || user.credentialsExpiration!!.isAfter(LocalDateTime.now(ZoneOffset.UTC))
+
+ @JsonIgnore
+ override fun isEnabled() = user.enable == 1
+
+ override fun toString(): String {
+ return "LoginUser(user=$user, authorities=$authorities)"
+ }
+}
\ No newline at end of file
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Menu.kt b/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Menu.kt
new file mode 100644
index 0000000..d81e235
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Menu.kt
@@ -0,0 +1,64 @@
+package top.fatweb.oxygen.api.entity.permission
+
+import com.baomidou.mybatisplus.annotation.TableField
+import com.baomidou.mybatisplus.annotation.TableId
+import com.baomidou.mybatisplus.annotation.TableName
+import java.io.Serializable
+
+/**
+ * Menu entity
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+@TableName("t_s_menu")
+class Menu : Serializable {
+ /**
+ * ID
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableId("id")
+ var id: Long? = null
+
+ /**
+ * Name
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableField("name")
+ var name: String? = null
+
+ /**
+ * URL
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableField("url")
+ var url: String? = null
+
+ /**
+ * Parent ID
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableField("parent_id")
+ var parentId: Long? = null
+
+ /**
+ * Module ID
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableField("module_id")
+ var moduleId: Long? = null
+
+ override fun toString(): String {
+ return "Menu(id=$id, name=$name, url=$url, parentId=$parentId, moduleId=$moduleId)"
+ }
+}
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Module.kt b/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Module.kt
new file mode 100644
index 0000000..fa26a28
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Module.kt
@@ -0,0 +1,37 @@
+package top.fatweb.oxygen.api.entity.permission
+
+import com.baomidou.mybatisplus.annotation.TableField
+import com.baomidou.mybatisplus.annotation.TableId
+import com.baomidou.mybatisplus.annotation.TableName
+import java.io.Serializable
+
+/**
+ * Module Entity
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+@TableName("t_s_module")
+class Module : Serializable {
+ /**
+ * ID
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableId("id")
+ var id: Long? = null
+
+ /**
+ * Name
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableField("name")
+ var name: String? = null
+
+ override fun toString(): String {
+ return "Module(id=$id, name=$name)"
+ }
+}
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Operation.kt b/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Operation.kt
new file mode 100644
index 0000000..c111ce6
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Operation.kt
@@ -0,0 +1,55 @@
+package top.fatweb.oxygen.api.entity.permission
+
+import com.baomidou.mybatisplus.annotation.TableField
+import com.baomidou.mybatisplus.annotation.TableId
+import com.baomidou.mybatisplus.annotation.TableName
+import java.io.Serializable
+
+/**
+ * Operation entity
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+@TableName("t_s_operation")
+class Operation : Serializable {
+ /**
+ * ID
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableId("id")
+ var id: Long? = null
+
+ /**
+ * Name
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableField("name")
+ var name: String? = null
+
+ /**
+ * Code
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableField("code")
+ var code: String? = null
+
+ /**
+ * Function ID
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableField("func_id")
+ var funcId: Long? = null
+
+ override fun toString(): String {
+ return "Operation(id=$id, name=$name, code=$code, funcId=$funcId)"
+ }
+}
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Power.kt b/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Power.kt
new file mode 100644
index 0000000..4f1a7a0
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/Power.kt
@@ -0,0 +1,37 @@
+package top.fatweb.oxygen.api.entity.permission
+
+import com.baomidou.mybatisplus.annotation.TableField
+import com.baomidou.mybatisplus.annotation.TableId
+import com.baomidou.mybatisplus.annotation.TableName
+import java.io.Serializable
+
+/**
+ * Power entity
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+@TableName("t_s_power")
+class Power : Serializable {
+ /**
+ * ID
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableId("id")
+ var id: Long? = null
+
+ /**
+ * Type ID
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+ @TableField("type_id")
+ var typeId: Int? = null
+
+ override fun toString(): String {
+ return "Power(id=$id, typeId=$typeId)"
+ }
+}
diff --git a/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/PowerSet.kt b/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/PowerSet.kt
new file mode 100644
index 0000000..c99f5ae
--- /dev/null
+++ b/src/main/kotlin/top/fatweb/oxygen/api/entity/permission/PowerSet.kt
@@ -0,0 +1,51 @@
+package top.fatweb.oxygen.api.entity.permission
+
+import java.io.Serializable
+
+/**
+ * Set of power entity
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ */
+class PowerSet : Serializable {
+ /**
+ * Module list
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see Module
+ */
+ var moduleList: List? = null
+
+ /**
+ * Menu list
+ *
+ * @author FatttSnake, fatttsnake@gmail.com
+ * @since 1.0.0
+ * @see Menu
+ */
+ var menuList: List