# cortadai/spring-security-poc architecture

> Architecture diagram of the GitHub repository cortadai/spring-security-poc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cortadai/spring-security-poc
- Repository: https://github.com/cortadai/spring-security-poc

## Overview

##### Project type and purpose
- This is a full-stack banking PoC comprising two subprojects:
- bank-app-ui (Angular SPA)
- bank-app-api (Spring Boot REST)
- Purpose: demonstrate secure authentication (JWT + CSRF), session management, token refresh, and basic banking operations (accounts, balances, cards, loans, contacts, notices).

##### File structure
- Top level:
- bank-app-ui/ → Angular 15+ frontend
- bank-app-api/ → Spring Boot backend
- readme.md → high-level overview
- bank-app-ui:
- src/app/components → feature UIs (login, dashboard, account, balance, etc.)
- src/app/services → HTTP wrappers including auth, login, dashboard, logout
- src/app/interceptors → request interceptor adding JWT & CSRF tokens
- src/app/routeguards → protects routes based on auth state
- bank-app-api:
- src/main/java/com/entelgy/bank/config → Spring Security (filters, providers, TokenProvider, RedisConfig)
- controller, service, repository, model, dto, exception layers → classic layered MVC
- src/main/resources/sql/scripts.sql → DB schema
- RedisConfig & TokenRepository → central token store in Redis

##### README
- Each subproject’s README details tech stacks and install steps, but overall architecture is not diagrammed; we’ll fill that gap.

##### Detail
- Don’t lump everything into “backend”—break out the security filters, token provider, controllers, service logic, and data store interactions.
- On the UI, separate route guards, interceptors, and feature modules.

## Diagram (Mermaid)

```mermaid
flowchart LR
    %% Client Side
    subgraph "Client Side"
        direction TB
        Browser["User's Browser"]:::frontend
        SPA["Angular SPA"]:::frontend
        AppModule["App Module & Routing"]:::frontend
        Components["Angular Components"]:::frontend
        Services["Angular Services"]:::frontend
        Interceptor["HTTP Interceptor"]:::frontend
        RouteGuards["Route Guards"]:::frontend
        Models["Angular Models"]:::frontend
    end

    %% Server Side
    subgraph "Server Side"
        direction TB
        Entry["Spring Boot Application"]:::backend
        Filters["Security Filters"]:::filter
        AuthProvider["Auth Provider & UserDetailsService"]:::backend
        TokenProv["JWT Token Provider"]:::backend
        RedisCfg["Redis Configuration"]:::backend
        Controllers["REST Controllers"]:::backend
        ServicesBE["Service Layer"]:::backend
        Repos["Repository Layer"]:::backend
        ModelsBE["Domain Models"]:::backend
        DTOs["DTOs"]:::backend
        Exceptions["Exception Handling"]:::backend
        SQLDB["SQL Database"]:::db
        RedisDB["Redis Token Store"]:::redis
    end

    %% Client Flow
    Browser --> SPA
    SPA --> AppModule
    AppModule --> Components
    AppModule --> Services
    AppModule --> Interceptor
    AppModule --> RouteGuards
    AppModule --> Models
    Services --> Interceptor
    Interceptor -->|"HTTPS Requests"| Controllers
    Interceptor -.->|409/401 triggers| Services

    %% Server Flow
    Entry --> Filters
    Filters --> Controllers
    Filters -->|validate JWT| TokenProv
    TokenProv --> RedisDB
    Filters -->|auth logic| AuthProvider
    AuthProvider --> RedisDB
    Filters -->|csrf cookie| RedisCfg
    Controllers --> ServicesBE
    ServicesBE --> Repos
    Repos --> SQLDB
    ServicesBE --> RedisDB

    %% Click Events
    click SPA "https://github.com/cortadai/spring-security-poc/tree/main/bank-app-ui/"
    click Components "https://github.com/cortadai/spring-security-poc/tree/main/bank-app-ui/src/app/components/"
    click Services "https://github.com/cortadai/spring-security-poc/tree/main/bank-app-ui/src/app/services/"
    click Interceptor "https://github.com/cortadai/spring-security-poc/blob/main/bank-app-ui/src/app/interceptors/app.request.interceptor.ts"
    click RouteGuards "https://github.com/cortadai/spring-security-poc/blob/main/bank-app-ui/src/app/routeguards/auth.routeguard.ts"
    click Models "https://github.com/cortadai/spring-security-poc/tree/main/bank-app-ui/src/app/model/"
    click AppModule "https://github.com/cortadai/spring-security-poc/blob/main/bank-app-ui/src/app/app.module.ts"
    click AppModule "https://github.com/cortadai/spring-security-poc/blob/main/bank-app-ui/src/app/app-routing.module.ts"
    click Entry "https://github.com/cortadai/spring-security-poc/blob/main/bank-app-api/src/main/java/com/entelgy/bank/BankAppApiApplication.java"
    click Filters "https://github.com/cortadai/spring-security-poc/blob/main/bank-app-api/src/main/java/com/entelgy/bank/filter/CsrfCookieFilter.java"
    click Filters "https://github.com/cortadai/spring-security-poc/blob/main/bank-app-api/src/main/java/com/entelgy/bank/filter/JWTTokenValidatorFilter.java"
    click Filters "https://github.com/cortadai/spring-security-poc/blob/main/bank-app-api/src/main/java/com/entelgy/bank/filter/JWTTokenGeneratorFilter.java"
    click TokenProv "https://github.com/cortadai/spring-security-poc/blob/main/bank-app-api/src/main/java/com/entelgy/bank/config/TokenProvider.java"
    click RedisCfg "https://github.com/cortadai/spring-security-poc/blob/main/bank-app-api/src/main/java/com/entelgy/bank/config/RedisConfig.java"
    click AuthProvider "https://github.com/cortadai/spring-security-poc/blob/main/bank-app-api/src/main/java/com/entelgy/bank/config/BankUsernamePwdAuthenticationProvider.java"
    click AuthProvider "https://github.com/cortadai/spring-security-poc/blob/main/bank-app-api/src/main/java/com/entelgy/bank/config/BankUserDetailsService.java"
    click Controllers "https://github.com/cortadai/spring-security-poc/tree/main/bank-app-api/src/main/java/com/entelgy/bank/controller/"
    click ServicesBE "https://github.com/cortadai/spring-security-poc/blob/main/bank-app-api/src/main/java/com/entelgy/bank/service/AuthService.java"
    click Repos "https://github.com/cortadai/spring-security-poc/tree/main/bank-app-api/src/main/java/com/entelgy/bank/repository/"
    click ModelsBE "https://github.com/cortadai/spring-security-poc/tree/main/bank-app-api/src/main/java/com/entelgy/bank/model/"
    click DTOs "https://github.com/cortadai/spring-security-poc/tree/main/bank-app-api/src/main/java/com/entelgy/bank/dto/"
    click Exceptions "https://github.com/cortadai/spring-security-poc/tree/main/bank-app-api/src/main/java/com/entelgy/bank/exception/"
    click SQLDB "https://github.com/cortadai/spring-security-poc/blob/main/bank-app-api/src/main/resources/sql/scripts.sql"

    %% Styles
    classDef frontend fill:#BBDEFB,stroke:#0D47A1,color:#0D47A1
    classDef backend fill:#C8E6C9,stroke:#1B5E20,color:#1B5E20
    classDef db fill:#FFE0B2,stroke:#E65100,color:#E65100
    classDef redis fill:#FFECB3,stroke:#FF6F00,color:#FF6F00
    classDef filter fill:#E1BEE7,stroke:#4A148C,color:#4A148C
    class Interceptor async
    class Services async
```
