refactor: reorganize project into a pragmatic modular monolith

backend/build.gradle.kts

@@ -6,7 +6,7 @@ plugins {
     kotlin("plugin.jpa") version "2.1.21"
 }
 
-group = "io.github.devcavin"
+group = "io.github.devcavin.gatelog"
 version = "0.0.1-SNAPSHOT"
 description = "backend"
 

backend/src/main/kotlin/io/github/devcavin/backend/BackendApplication.kt → backend/src/main/kotlin/io/github/devcavin/gatelog/backend/BackendApplication.kt

@@ -1,11 +1,13 @@
-package io.github.devcavin.backend
+package io.github.devcavin.gatelog.backend
 
 import org.springframework.boot.autoconfigure.SpringBootApplication
 import org.springframework.boot.context.properties.ConfigurationPropertiesScan
 import org.springframework.boot.runApplication
+import org.springframework.data.web.config.EnableSpringDataWebSupport
 
 @SpringBootApplication
 @ConfigurationPropertiesScan
+@EnableSpringDataWebSupport(pageSerializationMode = EnableSpringDataWebSupport.PageSerializationMode.VIA_DTO)
 class BackendApplication
 
 fun main(args: Array<String>) {

backend/src/main/kotlin/io/github/devcavin/backend/web/controller/AuthController.kt → backend/src/main/kotlin/io/github/devcavin/gatelog/backend/auth/AuthController.kt

@@ -1,9 +1,8 @@
-package io.github.devcavin.backend.web.controller
+package io.github.devcavin.gatelog.backend.auth
 
-import io.github.devcavin.backend.service.AuthService
-import io.github.devcavin.backend.web.dto.auth.AuthResponse
-import io.github.devcavin.backend.web.dto.auth.LoginRequest
-import io.github.devcavin.backend.web.dto.auth.RefreshTokenRequest
+import io.github.devcavin.gatelog.backend.auth.dto.AuthResponse
+import io.github.devcavin.gatelog.backend.auth.dto.LoginRequest
+import io.github.devcavin.gatelog.backend.auth.dto.RefreshTokenRequest
 import jakarta.validation.Valid
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.PostMapping

backend/src/main/kotlin/io/github/devcavin/backend/service/AuthService.kt → backend/src/main/kotlin/io/github/devcavin/gatelog/backend/auth/AuthService.kt

@@ -1,15 +1,11 @@
-package io.github.devcavin.backend.service
-
-import io.github.devcavin.backend.common.exception.AccountDisabledException
-import io.github.devcavin.backend.common.exception.InvalidCredentialsException
-import io.github.devcavin.backend.common.exception.InvalidRefreshTokenException
-import io.github.devcavin.backend.domain.model.RefreshToken
-import io.github.devcavin.backend.domain.repository.RefreshTokenRepository
-import io.github.devcavin.backend.domain.repository.UserRepository
-import io.github.devcavin.backend.security.JwtProperties
-import io.github.devcavin.backend.security.JwtTokenProvider
-import io.github.devcavin.backend.web.dto.auth.AuthResponse
-import io.github.devcavin.backend.web.dto.auth.LoginRequest
+package io.github.devcavin.gatelog.backend.auth
+
+import io.github.devcavin.gatelog.backend.auth.dto.AuthResponse
+import io.github.devcavin.gatelog.backend.auth.dto.LoginRequest
+import io.github.devcavin.gatelog.backend.common.exception.AccountDisabledException
+import io.github.devcavin.gatelog.backend.common.exception.InvalidCredentialsException
+import io.github.devcavin.gatelog.backend.common.exception.InvalidRefreshTokenException
+import io.github.devcavin.gatelog.backend.users.UserRepository
 import org.springframework.security.crypto.password.PasswordEncoder
 import org.springframework.stereotype.Service
 import org.springframework.transaction.annotation.Transactional

backend/src/main/kotlin/io/github/devcavin/backend/security/JwtAuthenticationFilter.kt → backend/src/main/kotlin/io/github/devcavin/gatelog/backend/auth/JwtAuthenticationFilter.kt

@@ -1,6 +1,6 @@
-package io.github.devcavin.backend.security
+package io.github.devcavin.gatelog.backend.auth
 
-import io.github.devcavin.backend.domain.repository.UserRepository
+import io.github.devcavin.gatelog.backend.users.UserRepository
 import jakarta.servlet.FilterChain
 import jakarta.servlet.http.HttpServletRequest
 import jakarta.servlet.http.HttpServletResponse

backend/src/main/kotlin/io/github/devcavin/backend/security/JwtProperties.kt → backend/src/main/kotlin/io/github/devcavin/gatelog/backend/auth/JwtProperties.kt

@@ -1,4 +1,4 @@
-package io.github.devcavin.backend.security
+package io.github.devcavin.gatelog.backend.auth
 
 import org.springframework.boot.context.properties.ConfigurationProperties
 import org.springframework.stereotype.Component

backend/src/main/kotlin/io/github/devcavin/backend/security/JwtTokenProvider.kt → backend/src/main/kotlin/io/github/devcavin/gatelog/backend/auth/JwtTokenProvider.kt

@@ -1,4 +1,4 @@
-package io.github.devcavin.backend.security
+package io.github.devcavin.gatelog.backend.auth
 
 import io.jsonwebtoken.Claims
 import io.jsonwebtoken.JwtException

backend/src/main/kotlin/io/github/devcavin/backend/domain/model/RefreshToken.kt → backend/src/main/kotlin/io/github/devcavin/gatelog/backend/auth/RefreshToken.kt

@@ -1,5 +1,7 @@
-package io.github.devcavin.backend.domain.model
+package io.github.devcavin.gatelog.backend.auth
 
+import io.github.devcavin.gatelog.backend.common.persistence.BaseEntity
+import io.github.devcavin.gatelog.backend.users.User
 import jakarta.persistence.Column
 import jakarta.persistence.Entity
 import jakarta.persistence.FetchType

backend/src/main/kotlin/io/github/devcavin/backend/domain/repository/RefreshTokenRepository.kt → backend/src/main/kotlin/io/github/devcavin/gatelog/backend/auth/RefreshTokenRepository.kt

@@ -1,6 +1,5 @@
-package io.github.devcavin.backend.domain.repository
+package io.github.devcavin.gatelog.backend.auth
 
-import io.github.devcavin.backend.domain.model.RefreshToken
 import org.springframework.data.jpa.repository.JpaRepository
 import org.springframework.data.jpa.repository.Modifying
 import org.springframework.data.jpa.repository.Query

backend/src/main/kotlin/io/github/devcavin/backend/security/UserDetailsServiceImpl.kt → backend/src/main/kotlin/io/github/devcavin/gatelog/backend/auth/UserDetailsServiceImpl.kt

@@ -1,6 +1,6 @@
-package io.github.devcavin.backend.security
+package io.github.devcavin.gatelog.backend.auth
 
-import io.github.devcavin.backend.domain.repository.UserRepository
+import io.github.devcavin.gatelog.backend.users.UserRepository
 import org.springframework.security.core.authority.SimpleGrantedAuthority
 import org.springframework.security.core.userdetails.User
 import org.springframework.security.core.userdetails.UserDetails

backend/src/main/kotlin/io/github/devcavin/gatelog/backend/auth/dto/AuthDtos.kt

@@ -0,0 +1,11 @@
+package io.github.devcavin.gatelog.backend.auth.dto
+
+import java.util.UUID
+
+data class AuthenticatedUser(
+    val id: UUID,
+    val name: String,
+    val email: String,
+    val role: String,
+    val siteId: UUID
+)

backend/src/main/kotlin/io/github/devcavin/backend/web/dto/auth/AuthDTOs.kt → backend/src/main/kotlin/io/github/devcavin/gatelog/backend/auth/dto/AuthRequests.kt

@@ -1,8 +1,7 @@
-package io.github.devcavin.backend.web.dto.auth
+package io.github.devcavin.gatelog.backend.auth.dto
 
 import jakarta.validation.constraints.Email
 import jakarta.validation.constraints.NotBlank
-import java.util.UUID
 
 data class LoginRequest(
     @field:Email
@@ -16,17 +15,4 @@ data class LoginRequest(
 data class RefreshTokenRequest(
     @field:NotBlank
     val token: String
-)
-
-data class AuthenticatedUser(
-    val id: UUID,
-    val name: String,
-    val email: String,
-    val role: String,
-    val siteId: UUID
-)
-
-data class AuthResponse(
-    val accessToken: String,
-    val refreshToken: String
-)
+)

backend/src/main/kotlin/io/github/devcavin/gatelog/backend/auth/dto/AuthResponses.kt

@@ -0,0 +1,6 @@
+package io.github.devcavin.gatelog.backend.auth.dto
+
+data class AuthResponse(
+    val accessToken: String,
+    val refreshToken: String
+)

backend/src/main/kotlin/io/github/devcavin/gatelog/backend/common/exception/DomainExceptions.kt

@@ -0,0 +1,27 @@
+package io.github.devcavin.gatelog.backend.common.exception
+
+import org.springframework.security.authentication.BadCredentialsException
+
+// base type
+sealed class DomainException(message: String) : RuntimeException(message)
+
+// 401 — bad credentials or invalid/expired tokens
+sealed class UnauthorizedException(message: String): io.github.devcavin.gatelog.backend.common.exception.DomainException(message)
+
+class InvalidCredentialsException : BadCredentialsException("Invalid username or password")
+
+class InvalidRefreshTokenException : BadCredentialsException("Invalid or expired refresh token")
+
+// 403 - authenticated but !permitted
+class AccountDisabledException : io.github.devcavin.gatelog.backend.common.exception.DomainException("Account is disabled")
+
+// 404 - resource !found
+class ResourceNotFoundException(resource: String, id: Any) : io.github.devcavin.gatelog.backend.common.exception.DomainException("Resource $resource not found: $id")
+
+// 409 - conflicts with existing state/resources, etc...
+class ConflictException(message: String) : io.github.devcavin.gatelog.backend.common.exception.DomainException(message)
+
+// 422 - semantically invalid request (e.g. checking out already checked out visitor)
+class InvalidStateException(message: String) : io.github.devcavin.gatelog.backend.common.exception.DomainException(message)
+
+class AccessDeniedException(message: String) : RuntimeException(message)

backend/src/main/kotlin/io/github/devcavin/backend/web/error/ErrorResponse.kt → backend/src/main/kotlin/io/github/devcavin/gatelog/backend/common/exception/ErrorResponse.kt

@@ -1,4 +1,4 @@
-package io.github.devcavin.backend.web.error
+package io.github.devcavin.gatelog.backend.common.exception
 
 import java.time.OffsetDateTime
 

backend/src/main/kotlin/io/github/devcavin/backend/web/error/GlobalExceptionHandler.kt → backend/src/main/kotlin/io/github/devcavin/gatelog/backend/common/exception/GlobalExceptionHandler.kt

@@ -1,6 +1,5 @@
-package io.github.devcavin.backend.web.error
+package io.github.devcavin.gatelog.backend.common.exception
 
-import io.github.devcavin.backend.common.exception.*
 import jakarta.servlet.http.HttpServletRequest
 import org.slf4j.LoggerFactory
 import org.springframework.http.HttpStatus
@@ -49,13 +48,15 @@ class GlobalExceptionHandler {
 
         return ResponseEntity
             .status(HttpStatus.BAD_REQUEST)
-            .body(ErrorResponse(
-                status = HttpStatus.BAD_REQUEST.value(),
-                error = HttpStatus.BAD_REQUEST.reasonPhrase,
-                message = "Validation failed",
-                path = request.requestURI,
-                fieldErrors = fieldErrors
-            ))
+            .body(
+                ErrorResponse(
+                    status = HttpStatus.BAD_REQUEST.value(),
+                    error = HttpStatus.BAD_REQUEST.reasonPhrase,
+                    message = "Validation failed",
+                    path = request.requestURI,
+                    fieldErrors = fieldErrors
+                )
+            )
     }
 
     @ExceptionHandler(BadCredentialsException::class)

backend/src/main/kotlin/io/github/devcavin/backend/domain/model/BaseEntity.kt → backend/src/main/kotlin/io/github/devcavin/gatelog/backend/common/persistence/BaseEntity.kt

@@ -1,4 +1,4 @@
-package io.github.devcavin.backend.domain.model
+package io.github.devcavin.gatelog.backend.common.persistence
 
 import jakarta.persistence.MappedSuperclass
 import java.util.UUID

backend/src/main/kotlin/io/github/devcavin/backend/security/SecurityConfig.kt → backend/src/main/kotlin/io/github/devcavin/gatelog/backend/config/SecurityConfig.kt

@@ -1,5 +1,6 @@
-package io.github.devcavin.backend.security
+package io.github.devcavin.gatelog.backend.config
 
+import io.github.devcavin.gatelog.backend.auth.JwtAuthenticationFilter
 import org.springframework.boot.context.properties.ConfigurationProperties
 import org.springframework.context.annotation.Bean
 import org.springframework.context.annotation.Configuration