# alexjoker5/spring-boot-backend-template architecture

> Architecture diagram of the GitHub repository alexjoker5/spring-boot-backend-template, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/alexjoker5/spring-boot-backend-template
- Repository: https://github.com/alexjoker5/spring-boot-backend-template

## Overview

This Spring Boot template exposes public health and login/logout endpoints alongside authenticated account, user-information, and address CRUD APIs. Requests enter through REST controllers, pass to feature services for validation, mapping, and business rules, then use repositories and JPA-backed entities; the shared base service supplies paging and soft-delete behavior. JWT authentication loads accounts, protects requests, and supports token revocation through Redis. The README documents PostgreSQL and API capabilities, but several security and configuration implementations were not sampled, so those links are documented rather than source-verified.

Main entry points: [`src/main/java/com/larvae/backend_template/features/auth/repository/AccountRepository.java`](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/auth/repository/AccountRepository.java) (Account repository), [`src/main/java/com/larvae/backend_template/repository/BaseRepository.java`](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/repository/BaseRepository.java) (Soft-delete queries), [`src/main/java/com/larvae/backend_template/features/auth/controller/AccountController.java`](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/auth/controller/AccountController.java) (Account API), [`src/main/java/com/larvae/backend_template/features/userInfo/service/impl/UserInfoServiceImpl.java`](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/userInfo/service/impl/UserInfoServiceImpl.java) (User workflows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["REST entry points"]
  node_home["Health endpoint"]
  node_account_api["Account API"]
  node_user_api["User API"]
  node_address_api["Address API"]
end

subgraph group_features["Business features"]
  node_account_service["Account workflows"]
  node_user_service["User workflows"]
  node_address_service["Address workflows"]
end

subgraph group_security["Identity and access"]
  node_jwt_filter["JWT request filter"]
  node_user_details["Account lookup"]
  node_jwt_util["JWT utilities<br/>[JwtUtil.java]"]
  node_blacklist["Token blacklist"]
end

subgraph group_persistence["Persistence foundation"]
  node_account_model["Account records<br/>[Account.java]"]
  node_user_model["User records<br/>[UserInfo.java]"]
  node_account_repo[("Account repository")]
  node_user_repo[("User repository")]
  node_address_repo[("Address repository")]
end

subgraph group_shared["Shared behavior"]
  node_base_service["Generic CRUD"]
  node_base_repo[("Soft-delete queries")]
end

node_client(("API client"))
node_redis[("Redis")]
node_postgres[("PostgreSQL")]

node_client -->|"requests"| node_home
node_client -->|"requests"| node_account_api
node_client -->|"requests"| node_user_api
node_client -->|"requests"| node_address_api
node_account_api -->|"delegates to"| node_account_service
node_user_api -->|"delegates to"| node_user_service
node_address_api -->|"delegates to"| node_address_service
node_account_service -->|"extends CRUD"| node_base_service
node_user_service -->|"extends CRUD"| node_base_service
node_address_service -->|"extends CRUD"| node_base_service
node_account_service -->|"persists accounts"| node_account_repo
node_user_service -->|"persists users"| node_user_repo
node_address_service -->|"persists addresses"| node_address_repo
node_user_service -->|"links account"| node_account_repo
node_address_service -->|"resolves user"| node_user_repo
node_account_repo -->|"inherits queries"| node_base_repo
node_user_repo -->|"inherits queries"| node_base_repo
node_address_repo -->|"inherits queries"| node_base_repo
node_account_repo -->|"stores"| node_account_model
node_user_repo -->|"stores"| node_user_model
node_base_service -->|"reads and writes"| node_base_repo
node_account_api -->|"login tokens"| node_jwt_util
node_account_api -->|"revokes token"| node_blacklist
node_user_details -->|"loads account"| node_account_repo
node_jwt_filter -.->|"validates token"| node_jwt_util
node_jwt_filter -.->|"checks revocation"| node_blacklist
node_blacklist -->|"stores revocations"| node_redis
node_base_repo -.->|"JPA persistence"| node_postgres

click node_home "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/controller/HomeController.java"
click node_account_api "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/auth/controller/AccountController.java"
click node_user_api "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/userInfo/controller/UserInfoController.java"
click node_address_api "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/address/controller/AddressController.java"
click node_account_service "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/auth/service/impl/AccountServiceImpl.java"
click node_user_service "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/userInfo/service/impl/UserInfoServiceImpl.java"
click node_address_service "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/address/service/impl/AddressServiceImpl.java"
click node_account_model "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/entity/Account.java"
click node_user_model "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/entity/UserInfo.java"
click node_account_repo "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/auth/repository/AccountRepository.java"
click node_user_repo "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/userInfo/repository/UserInfoRepository.java"
click node_address_repo "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/address/repository/AddressRepository.java"
click node_base_service "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/service/impl/BaseServiceImpl.java"
click node_base_repo "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/repository/BaseRepository.java"
click node_jwt_filter "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/security/jwt/JwtAuthenticationFilter.java"
click node_user_details "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/security/service/CustomUserDetailsService.java"
click node_jwt_util "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/security/jwt/JwtUtil.java"
click node_blacklist "https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/security/jwt/JwtBlacklistService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_account_api,node_user_api,node_address_api,node_client toneBlue
class node_account_service,node_user_service,node_address_service,node_redis,node_postgres toneAmber
class node_jwt_filter,node_user_details,node_jwt_util,node_blacklist toneMint
class node_account_model,node_user_model,node_account_repo,node_user_repo,node_address_repo toneRose
class node_base_service,node_base_repo toneIndigo
```

## Components

### REST entry points

- [Health endpoint](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/controller/HomeController.java): `src/main/java/com/larvae/backend_template/controller/HomeController.java`
- [Account API](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/auth/controller/AccountController.java): `src/main/java/com/larvae/backend_template/features/auth/controller/AccountController.java`
- [User API](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/userInfo/controller/UserInfoController.java): `src/main/java/com/larvae/backend_template/features/userInfo/controller/UserInfoController.java`
- [Address API](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/address/controller/AddressController.java): `src/main/java/com/larvae/backend_template/features/address/controller/AddressController.java`

### Business features

- [Account workflows](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/auth/service/impl/AccountServiceImpl.java): `src/main/java/com/larvae/backend_template/features/auth/service/impl/AccountServiceImpl.java`
- [User workflows](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/userInfo/service/impl/UserInfoServiceImpl.java): `src/main/java/com/larvae/backend_template/features/userInfo/service/impl/UserInfoServiceImpl.java`
- [Address workflows](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/address/service/impl/AddressServiceImpl.java): `src/main/java/com/larvae/backend_template/features/address/service/impl/AddressServiceImpl.java`

### Identity and access

- [JWT request filter](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/security/jwt/JwtAuthenticationFilter.java): `src/main/java/com/larvae/backend_template/security/jwt/JwtAuthenticationFilter.java`
- [Account lookup](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/security/service/CustomUserDetailsService.java): `src/main/java/com/larvae/backend_template/security/service/CustomUserDetailsService.java`
- [JWT utilities](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/security/jwt/JwtUtil.java): `src/main/java/com/larvae/backend_template/security/jwt/JwtUtil.java`
- [Token blacklist](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/security/jwt/JwtBlacklistService.java): `src/main/java/com/larvae/backend_template/security/jwt/JwtBlacklistService.java`

### Persistence foundation

- [Account records](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/entity/Account.java): `src/main/java/com/larvae/backend_template/entity/Account.java`
- [User records](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/entity/UserInfo.java): `src/main/java/com/larvae/backend_template/entity/UserInfo.java`
- [Account repository](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/auth/repository/AccountRepository.java): `src/main/java/com/larvae/backend_template/features/auth/repository/AccountRepository.java`
- [User repository](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/userInfo/repository/UserInfoRepository.java): `src/main/java/com/larvae/backend_template/features/userInfo/repository/UserInfoRepository.java`
- [Address repository](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/features/address/repository/AddressRepository.java): `src/main/java/com/larvae/backend_template/features/address/repository/AddressRepository.java`

### Shared behavior

- [Generic CRUD](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/service/impl/BaseServiceImpl.java): `src/main/java/com/larvae/backend_template/service/impl/BaseServiceImpl.java`
- [Soft-delete queries](https://github.com/alexjoker5/spring-boot-backend-template/blob/develop/src/main/java/com/larvae/backend_template/repository/BaseRepository.java): `src/main/java/com/larvae/backend_template/repository/BaseRepository.java`

### Other components

- **API client**
- **Redis**
- **PostgreSQL**

## Connections

- API client → Health endpoint: requests (evidence: `README.md`)
- API client → Account API: requests (evidence: `README.md`)
- API client → User API: requests (evidence: `README.md`)
- API client → Address API: requests (evidence: `README.md`)
- Account API → Account workflows: delegates to (evidence: `src/main/java/com/larvae/backend_template/features/auth/controller/AccountController.java`)
- User API → User workflows: delegates to (evidence: `src/main/java/com/larvae/backend_template/features/userInfo/controller/UserInfoController.java`)
- Address API → Address workflows: delegates to (evidence: `src/main/java/com/larvae/backend_template/features/address/controller/AddressController.java`)
- Account workflows → Generic CRUD: extends CRUD (evidence: `src/main/java/com/larvae/backend_template/service/impl/BaseServiceImpl.java`)
- User workflows → Generic CRUD: extends CRUD (evidence: `src/main/java/com/larvae/backend_template/service/impl/BaseServiceImpl.java`)
- Address workflows → Generic CRUD: extends CRUD (evidence: `src/main/java/com/larvae/backend_template/service/impl/BaseServiceImpl.java`)
- Account workflows → Account repository: persists accounts (evidence: `src/main/java/com/larvae/backend_template/features/auth/service/impl/AccountServiceImpl.java`)
- User workflows → User repository: persists users (evidence: `src/main/java/com/larvae/backend_template/features/userInfo/service/impl/UserInfoServiceImpl.java`)
- Address workflows → Address repository: persists addresses (evidence: `src/main/java/com/larvae/backend_template/features/address/service/impl/AddressServiceImpl.java`)
- User workflows → Account repository: links account (evidence: `src/main/java/com/larvae/backend_template/features/userInfo/service/impl/UserInfoServiceImpl.java`)
- Address workflows → User repository: resolves user (evidence: `src/main/java/com/larvae/backend_template/features/address/service/impl/AddressServiceImpl.java`)
- Account repository → Soft-delete queries: inherits queries (evidence: `src/main/java/com/larvae/backend_template/features/auth/repository/AccountRepository.java`)
- User repository → Soft-delete queries: inherits queries (evidence: `src/main/java/com/larvae/backend_template/features/userInfo/repository/UserInfoRepository.java`)
- Address repository → Soft-delete queries: inherits queries (evidence: `src/main/java/com/larvae/backend_template/features/address/repository/AddressRepository.java`)
- Account repository → Account records: stores (evidence: `src/main/java/com/larvae/backend_template/features/auth/repository/AccountRepository.java`)
- User repository → User records: stores (evidence: `src/main/java/com/larvae/backend_template/features/userInfo/repository/UserInfoRepository.java`)
- Generic CRUD → Soft-delete queries: reads and writes (evidence: `src/main/java/com/larvae/backend_template/service/impl/BaseServiceImpl.java`)
- Account API → JWT utilities: login tokens (evidence: `src/main/java/com/larvae/backend_template/features/auth/controller/AccountController.java`)
- Account API → Token blacklist: revokes token (evidence: `src/main/java/com/larvae/backend_template/features/auth/controller/AccountController.java`)
- Account lookup → Account repository: loads account (evidence: `src/main/java/com/larvae/backend_template/security/service/CustomUserDetailsService.java`)
- JWT request filter → JWT utilities: validates token (evidence: `src/main/java/com/larvae/backend_template/security/jwt/JwtAuthenticationFilter.java`)
- JWT request filter → Token blacklist: checks revocation (evidence: `src/main/java/com/larvae/backend_template/security/jwt/JwtAuthenticationFilter.java`)
- Token blacklist → Redis: stores revocations (evidence: `src/main/java/com/larvae/backend_template/security/jwt/JwtBlacklistService.java`)
- Soft-delete queries → PostgreSQL: JPA persistence (evidence: `README.md`)
