# dhuome/brain-box-api architecture

> Architecture diagram of the GitHub repository dhuome/brain-box-api, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dhuome/brain-box-api
- Repository: https://github.com/dhuome/brain-box-api

## Overview

Brain Box is a REST API for account creation and login, article publishing and browsing, comments, likes/dislikes, article moderation, and article images. The README documents these user-facing capabilities and endpoints, but no source excerpts were provided, so internal controller-to-service and service-to-storage relationships are shown only as unverified dashed links. The graph includes the main API, domain services, persistence, security, and image-storage layers without assuming their precise call paths.

Main entry points: [`src/main/java/com/example/brainBox/services/ArticleService.java`](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/services/ArticleService.java) (Article service), [`src/main/java/com/example/brainBox/controllers`](https://github.com/dhuome/brain-box-api/tree/master/src/main/java/com/example/brainBox/controllers) (REST controllers), [`src/main/java/com/example/brainBox/services/UserService.java`](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/services/UserService.java) (User service), [`src/main/java/com/example/brainBox/services/AuthService.java`](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/services/AuthService.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_controllers["REST controllers"]
end

subgraph group_content["Content workflows"]
  node_article_service["Article service"]
  node_article_specs["Article filtering"]
  node_comment_model["Comments<br/>[Comment.java]"]
  node_interaction_model["Article reactions<br/>[Interaction.java]"]
  node_article_model["Articles<br/>[Article.java]"]
end

subgraph group_identity["Identity and security"]
  node_user_service["User service<br/>[UserService.java]"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_user_details["User details"]
  node_privilege_service["Privileges"]
  node_security["Security config"]
  node_jwt_filter["JWT filter<br/>[JwtFilter.java]"]
  node_jwt_util["JWT utilities<br/>[JwtUtil.java]"]
end

subgraph group_data["Persistence and media"]
  node_article_repository["Article repository"]
  node_comment_repository["Comment repository"]
  node_interaction_repository["Interaction repository"]
  node_user_repository["User repository"]
  node_privilege_repository["Privilege repository"]
  node_image_service["Image storage"]
  node_minio["MinIO configuration<br/>[MinioConfig.java]"]
end

node_users(("API users"))

node_users -->|"uses API"| node_controllers
node_controllers -.->|"likely delegates"| node_article_service
node_controllers -.->|"likely delegates"| node_user_service
node_controllers -.->|"likely delegates"| node_auth_service
node_article_service -.->|"likely persists"| node_article_repository
node_article_service -.->|"may filter"| node_article_specs
node_article_service -.->|"may manage comments"| node_comment_repository
node_article_service -.->|"may manage reactions"| node_interaction_repository
node_article_service -.->|"may handle images"| node_image_service
node_user_service -.->|"likely persists"| node_user_repository
node_auth_service -.->|"likely authenticates"| node_user_details
node_user_details -.->|"likely loads users"| node_user_repository
node_privilege_service -.->|"likely loads privileges"| node_privilege_repository
node_security -.->|"may register"| node_jwt_filter
node_jwt_filter -.->|"may validate tokens"| node_jwt_util
node_image_service -.->|"may use"| node_minio

click node_controllers "https://github.com/dhuome/brain-box-api/tree/master/src/main/java/com/example/brainBox/controllers"
click node_article_service "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/services/ArticleService.java"
click node_article_specs "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/specifications/ArticleSpecifications.java"
click node_comment_model "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/entities/Comment.java"
click node_interaction_model "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/entities/Interaction.java"
click node_user_service "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/services/UserService.java"
click node_auth_service "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/services/AuthService.java"
click node_user_details "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/services/UserDetailsServiceImpl.java"
click node_privilege_service "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/services/PrivilegeService.java"
click node_security "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/configuration/security/SecurityConfig.java"
click node_jwt_filter "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/configuration/security/JwtFilter.java"
click node_jwt_util "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/util/JwtUtil.java"
click node_article_repository "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/repositories/ArticleRepository.java"
click node_comment_repository "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/repositories/CommentRepository.java"
click node_interaction_repository "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/repositories/InteractionRepository.java"
click node_user_repository "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/repositories/UserRepository.java"
click node_privilege_repository "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/repositories/PrivilegeRepository.java"
click node_image_service "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/services/ImageStorageService.java"
click node_minio "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/configuration/MinioConfig.java"
click node_article_model "https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/entities/Article.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_controllers,node_users toneBlue
class node_article_service,node_article_specs,node_comment_model,node_interaction_model,node_article_model toneAmber
class node_user_service,node_auth_service,node_user_details,node_privilege_service,node_security,node_jwt_filter,node_jwt_util toneMint
class node_article_repository,node_comment_repository,node_interaction_repository,node_user_repository,node_privilege_repository,node_image_service,node_minio toneRose
```

## Components

### API and access

- [REST controllers](https://github.com/dhuome/brain-box-api/tree/master/src/main/java/com/example/brainBox/controllers): `src/main/java/com/example/brainBox/controllers`

### Content workflows

- [Article service](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/services/ArticleService.java): `src/main/java/com/example/brainBox/services/ArticleService.java`
- [Article filtering](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/specifications/ArticleSpecifications.java): `src/main/java/com/example/brainBox/specifications/ArticleSpecifications.java`
- [Comments](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/entities/Comment.java): `src/main/java/com/example/brainBox/entities/Comment.java`
- [Article reactions](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/entities/Interaction.java): `src/main/java/com/example/brainBox/entities/Interaction.java`
- [Articles](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/entities/Article.java): `src/main/java/com/example/brainBox/entities/Article.java`

### Identity and security

- [User service](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/services/UserService.java): `src/main/java/com/example/brainBox/services/UserService.java`
- [Authentication](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/services/AuthService.java): `src/main/java/com/example/brainBox/services/AuthService.java`
- [User details](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/services/UserDetailsServiceImpl.java): `src/main/java/com/example/brainBox/services/UserDetailsServiceImpl.java`
- [Privileges](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/services/PrivilegeService.java): `src/main/java/com/example/brainBox/services/PrivilegeService.java`
- [Security config](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/configuration/security/SecurityConfig.java): `src/main/java/com/example/brainBox/configuration/security/SecurityConfig.java`
- [JWT filter](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/configuration/security/JwtFilter.java): `src/main/java/com/example/brainBox/configuration/security/JwtFilter.java`
- [JWT utilities](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/util/JwtUtil.java): `src/main/java/com/example/brainBox/util/JwtUtil.java`

### Persistence and media

- [Article repository](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/repositories/ArticleRepository.java): `src/main/java/com/example/brainBox/repositories/ArticleRepository.java`
- [Comment repository](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/repositories/CommentRepository.java): `src/main/java/com/example/brainBox/repositories/CommentRepository.java`
- [Interaction repository](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/repositories/InteractionRepository.java): `src/main/java/com/example/brainBox/repositories/InteractionRepository.java`
- [User repository](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/repositories/UserRepository.java): `src/main/java/com/example/brainBox/repositories/UserRepository.java`
- [Privilege repository](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/repositories/PrivilegeRepository.java): `src/main/java/com/example/brainBox/repositories/PrivilegeRepository.java`
- [Image storage](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/services/ImageStorageService.java): `src/main/java/com/example/brainBox/services/ImageStorageService.java`
- [MinIO configuration](https://github.com/dhuome/brain-box-api/blob/master/src/main/java/com/example/brainBox/configuration/MinioConfig.java): `src/main/java/com/example/brainBox/configuration/MinioConfig.java`

### Other components

- **API users**

## Connections

- API users → REST controllers: uses API (evidence: `README.md`)
- REST controllers → Article service: likely delegates
- REST controllers → User service: likely delegates
- REST controllers → Authentication: likely delegates
- Article service → Article repository: likely persists
- Article service → Article filtering: may filter
- Article service → Comment repository: may manage comments
- Article service → Interaction repository: may manage reactions
- Article service → Image storage: may handle images
- User service → User repository: likely persists
- Authentication → User details: likely authenticates
- User details → User repository: likely loads users
- Privileges → Privilege repository: likely loads privileges
- Security config → JWT filter: may register
- JWT filter → JWT utilities: may validate tokens
- Image storage → MinIO configuration: may use
