How ningelschlingel/pragmatic-clean-architecture works
This repository is a Spring Boot architectural showcase for a small social application, organized as post, user-authentication, and user-profile feature slices. Users register or log in, then authenticated users can create, retrieve, delete, and like posts; authentication and profile management are separate domain stages. The README documents the general controller-to-use-case-to-port flow, while sampled source confirms several specific routes and persistence adapters. Some use cases, security wiring, and integrations were not sampled, so their internal links are omitted or marked unverified.
Main entry points: PostRepository.java Post and like ports · RegisterUseCase.java Auth use cases · PostController.java Post API · application Post use cases
Components 19
Post slice
- Post API
src/main/java/io/ningelschlingel/pca/post/infrastructure/web/PostController.java - Post use cases
src/main/java/io/ningelschlingel/pca/post/core/application - Post and like model
src/main/java/io/ningelschlingel/pca/post/core/domain/Post.java - Post and like ports
src/main/java/io/ningelschlingel/pca/post/core/port/out/PostRepository.java
Identity slices
- Auth API
src/main/java/io/ningelschlingel/pca/userauth/infrastructure/web/UserAuthController.java - Auth use cases
src/main/java/io/ningelschlingel/pca/userauth/core/application/RegisterUseCase.java - Auth domain
src/main/java/io/ningelschlingel/pca/userauth/core/domain/UserAuth.java - Auth repository port
src/main/java/io/ningelschlingel/pca/userauth/core/port/out/UserAuthRepository.java - Profile use cases
src/main/java/io/ningelschlingel/pca/userprofile/core/application/CreateUserProfileUseCase.java - Profile domain
src/main/java/io/ningelschlingel/pca/userprofile/core/domain/UserProfile.java - Profile repository port
src/main/java/io/ningelschlingel/pca/userprofile/core/port/out/UserRepository.java
Shared security
- Shared user identity
src/main/java/io/ningelschlingel/pca/shared/core/domain/UserId.java - JWT service
src/main/java/io/ningelschlingel/pca/shared/infrastructure/security/JwtService.java - JWT filter
src/main/java/io/ningelschlingel/pca/shared/infrastructure/security/JwtFilter.java
Persistence adapters
- Post JPA adapters
src/main/java/io/ningelschlingel/pca/post/infrastructure/persistence/JpaPostRepository.java - Like JPA adapters
src/main/java/io/ningelschlingel/pca/post/infrastructure/persistence/JpaLikeRepository.java - Auth JPA adapter
src/main/java/io/ningelschlingel/pca/userauth/infrastructure/persistence/JpaUserAuthRepository.java - Profile JPA adapter
src/main/java/io/ningelschlingel/pca/userprofile/infrastructure/persistence/JpaUserRepository.java
Other components
- API user
Connections 18
- API user → Post API: sends requests
src/main/java/io/ningelschlingel/pca/post/infrastructure/web/PostController.java - Post API → Post use cases: dispatches to
src/main/java/io/ningelschlingel/pca/post/infrastructure/web/PostController.java - Post use cases → Post and like ports: uses contracts
README.md - Post and like ports → Post JPA adapters: implemented by
src/main/java/io/ningelschlingel/pca/post/infrastructure/persistence/JpaPostRepository.java - Post and like ports → Like JPA adapters: implemented by
src/main/java/io/ningelschlingel/pca/post/infrastructure/persistence/JpaLikeRepository.java - API user → Auth API: sends requests
src/main/java/io/ningelschlingel/pca/userauth/infrastructure/web/UserAuthController.java - Auth API → Auth use cases: dispatches to
src/main/java/io/ningelschlingel/pca/userauth/infrastructure/web/UserAuthController.java - Auth use cases → Auth repository port: uses contracts
README.md - Auth repository port → Auth JPA adapter: implemented by
src/main/java/io/ningelschlingel/pca/userauth/infrastructure/persistence/JpaUserAuthRepository.java - Auth use cases → Profile use cases: requests profile sync
- Profile use cases → Profile repository port: uses contracts
README.md - Profile repository port → Profile JPA adapter: implemented by
src/main/java/io/ningelschlingel/pca/userprofile/infrastructure/persistence/JpaUserRepository.java - JWT service → Shared user identity: creates identities
src/main/java/io/ningelschlingel/pca/shared/infrastructure/security/JwtService.java - JWT filter → JWT service: verifies tokens
- Post JPA adapters → Post and like model: maps domain data
src/main/java/io/ningelschlingel/pca/post/infrastructure/persistence/JpaPostRepository.java - Like JPA adapters → Post and like model: maps domain data
src/main/java/io/ningelschlingel/pca/post/infrastructure/persistence/JpaLikeRepository.java - Auth JPA adapter → Auth domain: maps domain data
src/main/java/io/ningelschlingel/pca/userauth/infrastructure/persistence/JpaUserAuthRepository.java - Profile JPA adapter → Profile domain: maps domain data
src/main/java/io/ningelschlingel/pca/userprofile/infrastructure/persistence/JpaUserRepository.java