How dhuome/brain-box-api works
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: ArticleService.java Article service · controllers REST controllers · UserService.java User service · AuthService.java Authentication
Components 21
API and access
- REST controllers
src/main/java/com/example/brainBox/controllers
Content workflows
- Article service
src/main/java/com/example/brainBox/services/ArticleService.java - Article filtering
src/main/java/com/example/brainBox/specifications/ArticleSpecifications.java - Comments
src/main/java/com/example/brainBox/entities/Comment.java - Article reactions
src/main/java/com/example/brainBox/entities/Interaction.java - Articles
src/main/java/com/example/brainBox/entities/Article.java
Identity and security
- User service
src/main/java/com/example/brainBox/services/UserService.java - Authentication
src/main/java/com/example/brainBox/services/AuthService.java - User details
src/main/java/com/example/brainBox/services/UserDetailsServiceImpl.java - Privileges
src/main/java/com/example/brainBox/services/PrivilegeService.java - Security config
src/main/java/com/example/brainBox/configuration/security/SecurityConfig.java - JWT filter
src/main/java/com/example/brainBox/configuration/security/JwtFilter.java - JWT utilities
src/main/java/com/example/brainBox/util/JwtUtil.java
Persistence and media
- Article repository
src/main/java/com/example/brainBox/repositories/ArticleRepository.java - Comment repository
src/main/java/com/example/brainBox/repositories/CommentRepository.java - Interaction repository
src/main/java/com/example/brainBox/repositories/InteractionRepository.java - User repository
src/main/java/com/example/brainBox/repositories/UserRepository.java - Privilege repository
src/main/java/com/example/brainBox/repositories/PrivilegeRepository.java - Image storage
src/main/java/com/example/brainBox/services/ImageStorageService.java - MinIO configuration
src/main/java/com/example/brainBox/configuration/MinioConfig.java
Other components
- API users
Connections 16
- API users → REST controllers: uses API
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