How alexjoker5/spring-boot-backend-template works
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: AccountRepository.java Account repository · BaseRepository.java Soft-delete queries · AccountController.java Account API · UserInfoServiceImpl.java User workflows
Components 21
REST entry points
- Health endpoint
src/main/java/com/larvae/backend_template/controller/HomeController.java - Account API
src/main/java/com/larvae/backend_template/features/auth/controller/AccountController.java - User API
src/main/java/com/larvae/backend_template/features/userInfo/controller/UserInfoController.java - Address API
src/main/java/com/larvae/backend_template/features/address/controller/AddressController.java
Business features
- Account workflows
src/main/java/com/larvae/backend_template/features/auth/service/impl/AccountServiceImpl.java - User workflows
src/main/java/com/larvae/backend_template/features/userInfo/service/impl/UserInfoServiceImpl.java - Address workflows
src/main/java/com/larvae/backend_template/features/address/service/impl/AddressServiceImpl.java
Identity and access
- JWT request filter
src/main/java/com/larvae/backend_template/security/jwt/JwtAuthenticationFilter.java - Account lookup
src/main/java/com/larvae/backend_template/security/service/CustomUserDetailsService.java - JWT utilities
src/main/java/com/larvae/backend_template/security/jwt/JwtUtil.java - Token blacklist
src/main/java/com/larvae/backend_template/security/jwt/JwtBlacklistService.java
Persistence foundation
- Account records
src/main/java/com/larvae/backend_template/entity/Account.java - User records
src/main/java/com/larvae/backend_template/entity/UserInfo.java - Account repository
src/main/java/com/larvae/backend_template/features/auth/repository/AccountRepository.java - User repository
src/main/java/com/larvae/backend_template/features/userInfo/repository/UserInfoRepository.java - Address repository
src/main/java/com/larvae/backend_template/features/address/repository/AddressRepository.java
Shared behavior
- Generic CRUD
src/main/java/com/larvae/backend_template/service/impl/BaseServiceImpl.java - Soft-delete queries
src/main/java/com/larvae/backend_template/repository/BaseRepository.java
Other components
- API client
- Redis
- PostgreSQL
Connections 28
- API client → Health endpoint: requests
README.md - API client → Account API: requests
README.md - API client → User API: requests
README.md - API client → Address API: requests
README.md - Account API → Account workflows: delegates to
src/main/java/com/larvae/backend_template/features/auth/controller/AccountController.java - User API → User workflows: delegates to
src/main/java/com/larvae/backend_template/features/userInfo/controller/UserInfoController.java - Address API → Address workflows: delegates to
src/main/java/com/larvae/backend_template/features/address/controller/AddressController.java - Account workflows → Generic CRUD: extends CRUD
src/main/java/com/larvae/backend_template/service/impl/BaseServiceImpl.java - User workflows → Generic CRUD: extends CRUD
src/main/java/com/larvae/backend_template/service/impl/BaseServiceImpl.java - Address workflows → Generic CRUD: extends CRUD
src/main/java/com/larvae/backend_template/service/impl/BaseServiceImpl.java - Account workflows → Account repository: persists accounts
src/main/java/com/larvae/backend_template/features/auth/service/impl/AccountServiceImpl.java - User workflows → User repository: persists users
src/main/java/com/larvae/backend_template/features/userInfo/service/impl/UserInfoServiceImpl.java - Address workflows → Address repository: persists addresses
src/main/java/com/larvae/backend_template/features/address/service/impl/AddressServiceImpl.java - User workflows → Account repository: links account
src/main/java/com/larvae/backend_template/features/userInfo/service/impl/UserInfoServiceImpl.java - Address workflows → User repository: resolves user
src/main/java/com/larvae/backend_template/features/address/service/impl/AddressServiceImpl.java - Account repository → Soft-delete queries: inherits queries
src/main/java/com/larvae/backend_template/features/auth/repository/AccountRepository.java - User repository → Soft-delete queries: inherits queries
src/main/java/com/larvae/backend_template/features/userInfo/repository/UserInfoRepository.java - Address repository → Soft-delete queries: inherits queries
src/main/java/com/larvae/backend_template/features/address/repository/AddressRepository.java - Account repository → Account records: stores
src/main/java/com/larvae/backend_template/features/auth/repository/AccountRepository.java - User repository → User records: stores
src/main/java/com/larvae/backend_template/features/userInfo/repository/UserInfoRepository.java - Generic CRUD → Soft-delete queries: reads and writes
src/main/java/com/larvae/backend_template/service/impl/BaseServiceImpl.java - Account API → JWT utilities: login tokens
src/main/java/com/larvae/backend_template/features/auth/controller/AccountController.java - Account API → Token blacklist: revokes token
src/main/java/com/larvae/backend_template/features/auth/controller/AccountController.java - Account lookup → Account repository: loads account
src/main/java/com/larvae/backend_template/security/service/CustomUserDetailsService.java - JWT request filter → JWT utilities: validates token
src/main/java/com/larvae/backend_template/security/jwt/JwtAuthenticationFilter.java - JWT request filter → Token blacklist: checks revocation
src/main/java/com/larvae/backend_template/security/jwt/JwtAuthenticationFilter.java - Token blacklist → Redis: stores revocations
src/main/java/com/larvae/backend_template/security/jwt/JwtBlacklistService.java - Soft-delete queries → PostgreSQL: JPA persistence
README.md