# ningelschlingel/pragmatic-clean-architecture architecture

> Architecture diagram of the GitHub repository ningelschlingel/pragmatic-clean-architecture, 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/ningelschlingel/pragmatic-clean-architecture
- Repository: https://github.com/ningelschlingel/pragmatic-clean-architecture

## Overview

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: [`src/main/java/io/ningelschlingel/pca/post/core/port/out/PostRepository.java`](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/post/core/port/out/PostRepository.java) (Post and like ports), [`src/main/java/io/ningelschlingel/pca/userauth/core/application/RegisterUseCase.java`](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userauth/core/application/RegisterUseCase.java) (Auth use cases), [`src/main/java/io/ningelschlingel/pca/post/infrastructure/web/PostController.java`](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/post/infrastructure/web/PostController.java) (Post API), [`src/main/java/io/ningelschlingel/pca/post/core/application`](https://github.com/ningelschlingel/pragmatic-clean-architecture/tree/main/src/main/java/io/ningelschlingel/pca/post/core/application) (Post use cases)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_posts["Post slice"]
  node_post_api["Post API"]
  node_post_actions["Post use cases"]
  node_post_model["Post and like model<br/>[Post.java]"]
  node_post_ports["Post and like ports"]
end

subgraph group_identity["Identity slices"]
  node_auth_api["Auth API"]
  node_auth_actions["Auth use cases"]
  node_auth_model["Auth domain<br/>[UserAuth.java]"]
  node_auth_port["Auth repository port"]
  node_profile_actions["Profile use cases"]
  node_profile_model["Profile domain<br/>[UserProfile.java]"]
  node_profile_port["Profile repository port"]
end

subgraph group_security["Shared security"]
  node_shared_ids["Shared user identity<br/>[UserId.java]"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_jwt_filter["JWT filter<br/>[JwtFilter.java]"]
end

subgraph group_persistence["Persistence adapters"]
  node_post_store[("Post JPA adapters")]
  node_like_store[("Like JPA adapters")]
  node_auth_store[("Auth JPA adapter")]
  node_profile_store[("Profile JPA adapter")]
end

node_visitor(("API user"))

node_visitor -->|"sends requests"| node_post_api
node_post_api -->|"dispatches to"| node_post_actions
node_post_actions -->|"uses contracts"| node_post_ports
node_post_ports -->|"implemented by"| node_post_store
node_post_ports -->|"implemented by"| node_like_store
node_visitor -.->|"sends requests"| node_auth_api
node_auth_api -->|"dispatches to"| node_auth_actions
node_auth_actions -->|"uses contracts"| node_auth_port
node_auth_port -->|"implemented by"| node_auth_store
node_auth_actions -.->|"requests profile sync"| node_profile_actions
node_profile_actions -->|"uses contracts"| node_profile_port
node_profile_port -->|"implemented by"| node_profile_store
node_jwt -->|"creates identities"| node_shared_ids
node_jwt_filter -.->|"verifies tokens"| node_jwt
node_post_store -->|"maps domain data"| node_post_model
node_like_store -->|"maps domain data"| node_post_model
node_auth_store -->|"maps domain data"| node_auth_model
node_profile_store -->|"maps domain data"| node_profile_model

click node_post_api "https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/post/infrastructure/web/PostController.java"
click node_post_actions "https://github.com/ningelschlingel/pragmatic-clean-architecture/tree/main/src/main/java/io/ningelschlingel/pca/post/core/application"
click node_post_model "https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/post/core/domain/Post.java"
click node_post_ports "https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/post/core/port/out/PostRepository.java"
click node_auth_api "https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userauth/infrastructure/web/UserAuthController.java"
click node_auth_actions "https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userauth/core/application/RegisterUseCase.java"
click node_auth_model "https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userauth/core/domain/UserAuth.java"
click node_auth_port "https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userauth/core/port/out/UserAuthRepository.java"
click node_profile_actions "https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userprofile/core/application/CreateUserProfileUseCase.java"
click node_profile_model "https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userprofile/core/domain/UserProfile.java"
click node_profile_port "https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userprofile/core/port/out/UserRepository.java"
click node_shared_ids "https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/shared/core/domain/UserId.java"
click node_jwt "https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/shared/infrastructure/security/JwtService.java"
click node_jwt_filter "https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/shared/infrastructure/security/JwtFilter.java"
click node_post_store "https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/post/infrastructure/persistence/JpaPostRepository.java"
click node_like_store "https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/post/infrastructure/persistence/JpaLikeRepository.java"
click node_auth_store "https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userauth/infrastructure/persistence/JpaUserAuthRepository.java"
click node_profile_store "https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userprofile/infrastructure/persistence/JpaUserRepository.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_post_api,node_post_actions,node_post_model,node_post_ports,node_visitor toneBlue
class node_auth_api,node_auth_actions,node_auth_model,node_auth_port,node_profile_actions,node_profile_model,node_profile_port toneAmber
class node_shared_ids,node_jwt,node_jwt_filter toneMint
class node_post_store,node_like_store,node_auth_store,node_profile_store toneRose
```

## Components

### Post slice

- [Post API](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/post/infrastructure/web/PostController.java): `src/main/java/io/ningelschlingel/pca/post/infrastructure/web/PostController.java`
- [Post use cases](https://github.com/ningelschlingel/pragmatic-clean-architecture/tree/main/src/main/java/io/ningelschlingel/pca/post/core/application): `src/main/java/io/ningelschlingel/pca/post/core/application`
- [Post and like model](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/post/core/domain/Post.java): `src/main/java/io/ningelschlingel/pca/post/core/domain/Post.java`
- [Post and like ports](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/post/core/port/out/PostRepository.java): `src/main/java/io/ningelschlingel/pca/post/core/port/out/PostRepository.java`

### Identity slices

- [Auth API](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userauth/infrastructure/web/UserAuthController.java): `src/main/java/io/ningelschlingel/pca/userauth/infrastructure/web/UserAuthController.java`
- [Auth use cases](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userauth/core/application/RegisterUseCase.java): `src/main/java/io/ningelschlingel/pca/userauth/core/application/RegisterUseCase.java`
- [Auth domain](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userauth/core/domain/UserAuth.java): `src/main/java/io/ningelschlingel/pca/userauth/core/domain/UserAuth.java`
- [Auth repository port](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userauth/core/port/out/UserAuthRepository.java): `src/main/java/io/ningelschlingel/pca/userauth/core/port/out/UserAuthRepository.java`
- [Profile use cases](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userprofile/core/application/CreateUserProfileUseCase.java): `src/main/java/io/ningelschlingel/pca/userprofile/core/application/CreateUserProfileUseCase.java`
- [Profile domain](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userprofile/core/domain/UserProfile.java): `src/main/java/io/ningelschlingel/pca/userprofile/core/domain/UserProfile.java`
- [Profile repository port](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userprofile/core/port/out/UserRepository.java): `src/main/java/io/ningelschlingel/pca/userprofile/core/port/out/UserRepository.java`

### Shared security

- [Shared user identity](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/shared/core/domain/UserId.java): `src/main/java/io/ningelschlingel/pca/shared/core/domain/UserId.java`
- [JWT service](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/shared/infrastructure/security/JwtService.java): `src/main/java/io/ningelschlingel/pca/shared/infrastructure/security/JwtService.java`
- [JWT filter](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/shared/infrastructure/security/JwtFilter.java): `src/main/java/io/ningelschlingel/pca/shared/infrastructure/security/JwtFilter.java`

### Persistence adapters

- [Post JPA adapters](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/post/infrastructure/persistence/JpaPostRepository.java): `src/main/java/io/ningelschlingel/pca/post/infrastructure/persistence/JpaPostRepository.java`
- [Like JPA adapters](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/post/infrastructure/persistence/JpaLikeRepository.java): `src/main/java/io/ningelschlingel/pca/post/infrastructure/persistence/JpaLikeRepository.java`
- [Auth JPA adapter](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userauth/infrastructure/persistence/JpaUserAuthRepository.java): `src/main/java/io/ningelschlingel/pca/userauth/infrastructure/persistence/JpaUserAuthRepository.java`
- [Profile JPA adapter](https://github.com/ningelschlingel/pragmatic-clean-architecture/blob/main/src/main/java/io/ningelschlingel/pca/userprofile/infrastructure/persistence/JpaUserRepository.java): `src/main/java/io/ningelschlingel/pca/userprofile/infrastructure/persistence/JpaUserRepository.java`

### Other components

- **API user**

## Connections

- API user → Post API: sends requests (evidence: `src/main/java/io/ningelschlingel/pca/post/infrastructure/web/PostController.java`)
- Post API → Post use cases: dispatches to (evidence: `src/main/java/io/ningelschlingel/pca/post/infrastructure/web/PostController.java`)
- Post use cases → Post and like ports: uses contracts (evidence: `README.md`)
- Post and like ports → Post JPA adapters: implemented by (evidence: `src/main/java/io/ningelschlingel/pca/post/infrastructure/persistence/JpaPostRepository.java`)
- Post and like ports → Like JPA adapters: implemented by (evidence: `src/main/java/io/ningelschlingel/pca/post/infrastructure/persistence/JpaLikeRepository.java`)
- API user → Auth API: sends requests (evidence: `src/main/java/io/ningelschlingel/pca/userauth/infrastructure/web/UserAuthController.java`)
- Auth API → Auth use cases: dispatches to (evidence: `src/main/java/io/ningelschlingel/pca/userauth/infrastructure/web/UserAuthController.java`)
- Auth use cases → Auth repository port: uses contracts (evidence: `README.md`)
- Auth repository port → Auth JPA adapter: implemented by (evidence: `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 (evidence: `README.md`)
- Profile repository port → Profile JPA adapter: implemented by (evidence: `src/main/java/io/ningelschlingel/pca/userprofile/infrastructure/persistence/JpaUserRepository.java`)
- JWT service → Shared user identity: creates identities (evidence: `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 (evidence: `src/main/java/io/ningelschlingel/pca/post/infrastructure/persistence/JpaPostRepository.java`)
- Like JPA adapters → Post and like model: maps domain data (evidence: `src/main/java/io/ningelschlingel/pca/post/infrastructure/persistence/JpaLikeRepository.java`)
- Auth JPA adapter → Auth domain: maps domain data (evidence: `src/main/java/io/ningelschlingel/pca/userauth/infrastructure/persistence/JpaUserAuthRepository.java`)
- Profile JPA adapter → Profile domain: maps domain data (evidence: `src/main/java/io/ningelschlingel/pca/userprofile/infrastructure/persistence/JpaUserRepository.java`)
