# bevia/authmicroservice architecture

> Architecture diagram of the GitHub repository bevia/authmicroservice, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bevia/authmicroservice
- Repository: https://github.com/bevia/authmicroservice

## Overview

##### Project Type and Purpose
- Type: A standalone Spring Boot microservice whose sole responsibility is authentication and authorization via JWTs.
- Purpose:
– Expose REST endpoints for user signup/login
– Issue signed JWTs (via JJWT)
– Serve user/role data to downstream services
– Allow stateless validation of tokens by other microservices

##### File Structure
Top-level:
- pom.xml, mvnw/* – Maven build & wrapper
- src/main/java/org/example/authmicroservice
– AuthMicroservice.java (entry point)
– controller/AuthController.java (REST API)
– jwt/JwtUtils.java (token generation/validation)
– security/WebSecurityConfig.java (Spring Security setup)
– service/UserDetailsServiceImpl.java, UserDetailsImpl.java (user lookup & principal)
– model/{User,Role,ERole} (JPA entities & enums)
– repository/{UserRepository, RoleRepository}
– payload/request + payload/response DTOs
- src/main/resources/application.properties (DB & JWT secret)
- src/test/... – unit tests

##### README Insights
- Core responsibilities: user management, credential verification, JWT issuance.
- Key tech: Spring Security, Spring Web, Spring Data JPA, JJWT, BCrypt, in-memory H2 (dev).
- JWT is stateless; optionally an introspection endpoint can be added.
- Downstream services (Order, Payment) validate tokens using shared secret & custom filter.

A. System Context (Highest Level)
– Actors:
- Client (e.g. Web/Mobile UI or API Gateway)
- Downstream Microservices (Order Service, Payment Service, etc.)
– System: Authentication Microservice
– External Dependencies:
- Relational Database (H2/MySQL/PostgreSQL)
- (Optional) API Gateway or Service Registry

1. REST API Layer
- AuthController
2. Security Layer
- WebSecurityConfig (filter chain config)
- JwtAuthenticationFilter (custom OncePerRequestFilter)
3. Service Layer
- UserDetailsServiceImpl / UserDetailsImpl
- JwtUtils
4. Persistence Layer
- Spring Data JPA Repositories (UserRepository, RoleRepository)
- JPA Entities (User, Role, ERole)
5. Data Store
- Relational DB

Client → AuthController → Security Filter → Service → Repository → DB
Service → JwtUtils → (signs token) → AuthController → Client

If desired, break out components such as:
- JwtUtils: methods generateToken(), validateToken(), parseClaims()
- WebSecurityConfig: chain of filters, password encoder bean
- AuthController: endpoints /api/auth/signup, /api/auth/signin
- DTO layer: request/response payloads

##### Relationships & Interactions
- Client calls /signup or /signin.
- AuthController delegates to AuthenticationManager (Spring Security) & UserDetailsServiceImpl.
- On success, JwtUtils builds a JWT, returned in JwtResponse.
- Client stores JWT and uses it for subsequent requests to other services.
- Downstream services independently validate JWT via their own filter using shared secret.
- (Optional) Downstream calls GET /users/{id} on Auth Service for enriched user data.

##### Architectural Patterns & Design Principles
- Layered Architecture (Controller → Service → Repository)
- Microservice (single‐responsibility, stateless)
- JWT as stateless token format
- Dependency Injection (Spring)
- Externalized configuration (application.properties)
- Secure password hashing (BCrypt)
- Use of interfaces for extensibility (UserDetailsService)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Actors and External Systems
    Client([Client]):::external
    OrderService([Order Service]):::external
    PaymentService([Payment Service]):::external
    DB[(Relational Database)]:::external

    %% System Container
    subgraph "Authentication Microservice"
        direction TB

        AuthApp["AuthMicroservice"]:::app
        subgraph "REST API Layer"
            direction TB
            AuthController["AuthController"]:::controller
        end

        subgraph "Security Layer"
            direction TB
            WebSecurityConfig["WebSecurityConfig"]:::security
            JwtAuthenticationFilter["JwtAuthenticationFilter"]:::security
        end

        subgraph "Service Layer"
            direction TB
            UserDetailsServiceImpl["UserDetailsServiceImpl"]:::service
            UserDetailsImpl["UserDetailsImpl"]:::service
            JwtUtils["JwtUtils"]:::service
        end

        subgraph "Persistence Layer"
            direction TB
            UserRepository["UserRepository"]:::persistence
            RoleRepository["RoleRepository"]:::persistence
            UserEntity["User"]:::persistence
            RoleEntity["Role"]:::persistence
            ERoleEnum["ERole"]:::persistence
        end

        AuthApp --> AuthController
        AuthController -->|intercepts| JwtAuthenticationFilter
        JwtAuthenticationFilter -->|loads user| UserDetailsServiceImpl
        UserDetailsServiceImpl -->|uses| UserRepository
        UserDetailsServiceImpl -->|uses| RoleRepository
        UserRepository --> DB
        RoleRepository --> DB
        UserDetailsServiceImpl --> UserDetailsImpl
        AuthController -->|on success| JwtUtils
        JwtUtils --> AuthController
    end

    %% Downstream token validation
    Client -->|uses JWT| OrderService
    Client -->|uses JWT| PaymentService
    OrderService -->|validates token| JwtUtils
    PaymentService -->|validates token| JwtUtils

    %% Click Events
    click AuthApp "https://github.com/bevia/authmicroservice/blob/main/src/main/java/org/example/authmicroservice/AuthMicroservice.java"
    click AuthController "https://github.com/bevia/authmicroservice/blob/main/src/main/java/org/example/authmicroservice/controller/AuthController.java"
    click WebSecurityConfig "https://github.com/bevia/authmicroservice/blob/main/src/main/java/org/example/authmicroservice/security/WebSecurityConfig.java"
    click JwtUtils "https://github.com/bevia/authmicroservice/blob/main/src/main/java/org/example/authmicroservice/jwt/JwtUtils.java"
    click UserDetailsServiceImpl "https://github.com/bevia/authmicroservice/blob/main/src/main/java/org/example/authmicroservice/service/UserDetailsServiceImpl.java"
    click UserDetailsImpl "https://github.com/bevia/authmicroservice/blob/main/src/main/java/org/example/authmicroservice/service/UserDetailsImpl.java"
    click UserRepository "https://github.com/bevia/authmicroservice/blob/main/src/main/java/org/example/authmicroservice/repository/UserRepository.java"
    click RoleRepository "https://github.com/bevia/authmicroservice/blob/main/src/main/java/org/example/authmicroservice/repository/RoleRepository.java"
    click UserEntity "https://github.com/bevia/authmicroservice/blob/main/src/main/java/org/example/authmicroservice/model/User.java"
    click RoleEntity "https://github.com/bevia/authmicroservice/blob/main/src/main/java/org/example/authmicroservice/model/Role.java"
    click ERoleEnum "https://github.com/bevia/authmicroservice/blob/main/src/main/java/org/example/authmicroservice/model/ERole.java"
    click SignupRequest "https://github.com/bevia/authmicroservice/blob/main/src/main/java/org/example/authmicroservice/payload/request/SignupRequest.java"
    click LoginRequest "https://github.com/bevia/authmicroservice/blob/main/src/main/java/org/example/authmicroservice/payload/request/LoginRequest.java"
    click JwtResponse "https://github.com/bevia/authmicroservice/blob/main/src/main/java/org/example/authmicroservice/payload/response/JwtResponse.java"
    click MessageResponse "https://github.com/bevia/authmicroservice/blob/main/src/main/java/org/example/authmicroservice/payload/response/MessageResponse.java"
    click application.properties "https://github.com/bevia/authmicroservice/blob/main/src/main/resources/application.properties"
    click pom.xml "https://github.com/bevia/authmicroservice/blob/main/pom.xml"

    %% Styles
    classDef controller fill:#D0E7FF,stroke:#0366D6,color:#0366D6;
    classDef security fill:#FFE5B4,stroke:#FF8C00,color:#FF8C00;
    classDef service fill:#E2FFD8,stroke:#228B22,color:#228B22;
    classDef persistence fill:#F0E6FF,stroke:#6A0DAD,color:#6A0DAD;
    classDef external fill:#F2F2F2,stroke:#999999,color:#333333;
    classDef app fill:#CCE5FF,stroke:#004080,color:#004080;
```
