# mohit-hasan/journal-app-spring-boot architecture

> Architecture diagram of the GitHub repository mohit-hasan/journal-app-spring-boot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mohit-hasan/journal-app-spring-boot
- Repository: https://github.com/mohit-hasan/journal-app-spring-boot

## Overview

Journal App is a learning-focused Spring Boot REST API. Users authenticate, manage journal entries and account details, and can receive a weather-based greeting; administrators have separate endpoints. The backend also explores Google login, JWT security, Redis caching, scheduled sentiment summaries and email, and Kafka consumption. The map follows calls visible in excerpts or the source index; README-documented integrations are included where implementation wiring was not shown, with uncertain links dashed.

Main entry points: [`src/main/java/com/mohithasan/journalapp/service/WeatherService.java`](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/service/WeatherService.java) (Weather service), [`src/main/java/com/mohithasan/journalapp/repository/UserRepository.java`](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/repository/UserRepository.java) (User repository), [`src/main/java/com/mohithasan/journalapp/controller/JournalEntryController.java`](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/controller/JournalEntryController.java) (Journal API), [`src/main/java/com/mohithasan/journalapp/controller/UserController.java`](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/controller/UserController.java) (User API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API workflows"]
  node_journal_controller["Journal API"]
  node_user_controller["User API"]
  node_public_controller["Public API"]
  node_admin_controller["Admin API"]
end

subgraph group_identity["Identity and security"]
  node_google_auth["Google login"]
  node_security["Security rules"]
  node_jwt_filter["JWT filter<br/>[JwtFilter.java]"]
  node_jwt_util["JWT tokens<br/>[JwtUtil.java]"]
  node_auth_service["User auth"]
end

subgraph group_domain["Journal and users"]
  node_journal_service["Journal service"]
  node_user_service["User service<br/>[UserService.java]"]
  node_journal_repo["Journal repository"]
  node_user_repo["User repository"]
  node_user_repo_impl["Sentiment query"]
  node_journal_entity["Journal entry<br/>[JournalEntry.java]"]
  node_user_entity["User account<br/>[User.java]"]
  node_journal_dto["Journal DTO"]
  node_user_dto["User DTO<br/>[UserDTO.java]"]
  node_sentiment["Sentiment types<br/>[Sentiment.java]"]
end

subgraph group_integrations["Caching and integrations"]
  node_weather_service["Weather service"]
  node_weather_response["Weather response"]
  node_app_cache["Config cache<br/>[AppCache.java]"]
  node_config_repo["Config repository"]
  node_config_entity["App config"]
  node_redis_service["Redis service<br/>[RedisService.java]"]
end

subgraph group_async["Async and operations"]
  node_scheduler["Sentiment scheduler<br/>[UserScheduler.java]"]
  node_sentiment_consumer["Sentiment consumer"]
  node_sentiment_data["Sentiment event<br/>[SentimentData.java]"]
  node_email_service["Email service<br/>[EmailService.java]"]
end

node_client(("API client"))
node_weather_api["Weather provider"]
node_mongo[("MongoDB")]
node_kafka["Kafka"]
node_mail_provider["Mail provider"]

node_client -->|"requests"| node_journal_controller
node_client -->|"requests"| node_user_controller
node_client -.->|"requests"| node_public_controller
node_client -.->|"requests"| node_admin_controller
node_client -.->|"login"| node_google_auth
node_journal_controller -->|"delegates"| node_journal_service
node_journal_controller -->|"looks up user"| node_user_service
node_user_controller -->|"delegates"| node_user_service
node_user_controller -->|"gets weather"| node_weather_service
node_journal_service -->|"loads and saves"| node_user_service
node_journal_service -->|"persists entries"| node_journal_repo
node_journal_service -->|"maps data"| node_journal_dto
node_user_service -->|"persists users"| node_user_repo
node_journal_repo -->|"stores"| node_journal_entity
node_user_repo -->|"stores"| node_user_entity
node_journal_entity -->|"uses"| node_sentiment
node_journal_controller -->|"returns entries"| node_journal_entity
node_user_controller -->|"accepts updates"| node_user_dto
node_weather_service -->|"reads and writes"| node_redis_service
node_weather_service -->|"reads config"| node_app_cache
node_weather_service -->|"requests forecast"| node_weather_api
node_weather_service -->|"returns model"| node_weather_response
node_app_cache -->|"loads config"| node_config_repo
node_config_repo -->|"loads records"| node_config_entity
node_security -->|"registers filter"| node_jwt_filter
node_security -->|"configures auth"| node_auth_service
node_jwt_filter -->|"validates tokens"| node_jwt_util
node_auth_service -->|"loads account"| node_user_repo
node_google_auth -->|"issues token"| node_jwt_util
node_google_auth -->|"looks up account"| node_user_repo
node_scheduler -->|"queries recipients"| node_user_repo_impl
node_user_repo_impl -->|"queries"| node_user_entity
node_scheduler -->|"sends summaries"| node_email_service
node_sentiment_consumer -->|"processes event"| node_sentiment_data
node_sentiment_consumer -->|"sends results"| node_email_service
node_kafka -.->|"delivers events"| node_sentiment_consumer
node_email_service -->|"sends mail"| node_mail_provider
node_user_repo -.->|"uses MongoDB"| node_mongo
node_journal_repo -.->|"uses MongoDB"| node_mongo

click node_journal_controller "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/controller/JournalEntryController.java"
click node_user_controller "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/controller/UserController.java"
click node_public_controller "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/controller/PublicController.java"
click node_admin_controller "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/controller/AdminController.java"
click node_google_auth "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/controller/GoogleAuthController.java"
click node_security "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/config/SpringSecurity.java"
click node_jwt_filter "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/filter/JwtFilter.java"
click node_jwt_util "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/utilis/JwtUtil.java"
click node_auth_service "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/service/UserDetailsServiceAuth.java"
click node_journal_service "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/service/JournalEntryService.java"
click node_user_service "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/service/UserService.java"
click node_journal_repo "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/repository/JournalEntryRepository.java"
click node_user_repo "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/repository/UserRepository.java"
click node_user_repo_impl "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/repository/UserRepositoryImpl.java"
click node_journal_entity "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/entity/JournalEntry.java"
click node_user_entity "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/entity/User.java"
click node_journal_dto "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/dto/JournalEntryDTO.java"
click node_user_dto "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/dto/UserDTO.java"
click node_sentiment "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/enums/Sentiment.java"
click node_weather_service "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/service/WeatherService.java"
click node_weather_response "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/api/response/WeatherResponse.java"
click node_app_cache "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/cache/AppCache.java"
click node_config_repo "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/repository/ConfigJournalAppRepository.java"
click node_config_entity "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/entity/ConfigJournalAppEntity.java"
click node_redis_service "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/service/RedisService.java"
click node_scheduler "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/scheduler/UserScheduler.java"
click node_sentiment_consumer "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/service/SentimentConsumerService.java"
click node_sentiment_data "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/model/SentimentData.java"
click node_email_service "https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/service/EmailService.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_journal_controller,node_user_controller,node_public_controller,node_admin_controller,node_client toneBlue
class node_google_auth,node_security,node_jwt_filter,node_jwt_util,node_auth_service,node_mongo toneAmber
class node_journal_service,node_user_service,node_journal_repo,node_user_repo,node_user_repo_impl,node_journal_entity,node_user_entity,node_journal_dto,node_user_dto,node_sentiment toneMint
class node_weather_service,node_weather_response,node_app_cache,node_config_repo,node_config_entity,node_redis_service toneRose
class node_scheduler,node_sentiment_consumer,node_sentiment_data,node_email_service,node_weather_api,node_kafka,node_mail_provider toneIndigo
```

## Components

### API workflows

- [Journal API](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/controller/JournalEntryController.java): `src/main/java/com/mohithasan/journalapp/controller/JournalEntryController.java`
- [User API](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/controller/UserController.java): `src/main/java/com/mohithasan/journalapp/controller/UserController.java`
- [Public API](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/controller/PublicController.java): `src/main/java/com/mohithasan/journalapp/controller/PublicController.java`
- [Admin API](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/controller/AdminController.java): `src/main/java/com/mohithasan/journalapp/controller/AdminController.java`

### Identity and security

- [Google login](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/controller/GoogleAuthController.java): `src/main/java/com/mohithasan/journalapp/controller/GoogleAuthController.java`
- [Security rules](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/config/SpringSecurity.java): `src/main/java/com/mohithasan/journalapp/config/SpringSecurity.java`
- [JWT filter](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/filter/JwtFilter.java): `src/main/java/com/mohithasan/journalapp/filter/JwtFilter.java`
- [JWT tokens](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/utilis/JwtUtil.java): `src/main/java/com/mohithasan/journalapp/utilis/JwtUtil.java`
- [User auth](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/service/UserDetailsServiceAuth.java): `src/main/java/com/mohithasan/journalapp/service/UserDetailsServiceAuth.java`

### Journal and users

- [Journal service](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/service/JournalEntryService.java): `src/main/java/com/mohithasan/journalapp/service/JournalEntryService.java`
- [User service](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/service/UserService.java): `src/main/java/com/mohithasan/journalapp/service/UserService.java`
- [Journal repository](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/repository/JournalEntryRepository.java): `src/main/java/com/mohithasan/journalapp/repository/JournalEntryRepository.java`
- [User repository](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/repository/UserRepository.java): `src/main/java/com/mohithasan/journalapp/repository/UserRepository.java`
- [Sentiment query](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/repository/UserRepositoryImpl.java): `src/main/java/com/mohithasan/journalapp/repository/UserRepositoryImpl.java`
- [Journal entry](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/entity/JournalEntry.java): `src/main/java/com/mohithasan/journalapp/entity/JournalEntry.java`
- [User account](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/entity/User.java): `src/main/java/com/mohithasan/journalapp/entity/User.java`
- [Journal DTO](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/dto/JournalEntryDTO.java): `src/main/java/com/mohithasan/journalapp/dto/JournalEntryDTO.java`
- [User DTO](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/dto/UserDTO.java): `src/main/java/com/mohithasan/journalapp/dto/UserDTO.java`
- [Sentiment types](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/enums/Sentiment.java): `src/main/java/com/mohithasan/journalapp/enums/Sentiment.java`

### Caching and integrations

- [Weather service](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/service/WeatherService.java): `src/main/java/com/mohithasan/journalapp/service/WeatherService.java`
- [Weather response](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/api/response/WeatherResponse.java): `src/main/java/com/mohithasan/journalapp/api/response/WeatherResponse.java`
- [Config cache](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/cache/AppCache.java): `src/main/java/com/mohithasan/journalapp/cache/AppCache.java`
- [Config repository](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/repository/ConfigJournalAppRepository.java): `src/main/java/com/mohithasan/journalapp/repository/ConfigJournalAppRepository.java`
- [App config](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/entity/ConfigJournalAppEntity.java): `src/main/java/com/mohithasan/journalapp/entity/ConfigJournalAppEntity.java`
- [Redis service](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/service/RedisService.java): `src/main/java/com/mohithasan/journalapp/service/RedisService.java`

### Async and operations

- [Sentiment scheduler](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/scheduler/UserScheduler.java): `src/main/java/com/mohithasan/journalapp/scheduler/UserScheduler.java`
- [Sentiment consumer](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/service/SentimentConsumerService.java): `src/main/java/com/mohithasan/journalapp/service/SentimentConsumerService.java`
- [Sentiment event](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/model/SentimentData.java): `src/main/java/com/mohithasan/journalapp/model/SentimentData.java`
- [Email service](https://github.com/mohit-hasan/journal-app-spring-boot/blob/main/src/main/java/com/mohithasan/journalapp/service/EmailService.java): `src/main/java/com/mohithasan/journalapp/service/EmailService.java`

### Other components

- **API client**
- **Weather provider**
- **MongoDB**
- **Kafka**
- **Mail provider**

## Connections

- API client → Journal API: requests (evidence: `src/main/java/com/mohithasan/journalapp/controller/JournalEntryController.java`)
- API client → User API: requests (evidence: `src/main/java/com/mohithasan/journalapp/controller/UserController.java`)
- API client → Public API: requests (evidence: `README.md`)
- API client → Admin API: requests (evidence: `README.md`)
- API client → Google login: login (evidence: `README.md`)
- Journal API → Journal service: delegates (evidence: `src/main/java/com/mohithasan/journalapp/controller/JournalEntryController.java`)
- Journal API → User service: looks up user (evidence: `src/main/java/com/mohithasan/journalapp/controller/JournalEntryController.java`)
- User API → User service: delegates (evidence: `src/main/java/com/mohithasan/journalapp/controller/UserController.java`)
- User API → Weather service: gets weather (evidence: `src/main/java/com/mohithasan/journalapp/controller/UserController.java`)
- Journal service → User service: loads and saves (evidence: `src/main/java/com/mohithasan/journalapp/service/JournalEntryService.java`)
- Journal service → Journal repository: persists entries (evidence: `src/main/java/com/mohithasan/journalapp/service/JournalEntryService.java`)
- Journal service → Journal DTO: maps data (evidence: `src/main/java/com/mohithasan/journalapp/service/JournalEntryService.java`)
- User service → User repository: persists users (evidence: `src/main/java/com/mohithasan/journalapp/service/UserService.java`)
- Journal repository → Journal entry: stores (evidence: `src/main/java/com/mohithasan/journalapp/repository/JournalEntryRepository.java`)
- User repository → User account: stores (evidence: `src/main/java/com/mohithasan/journalapp/repository/UserRepository.java`)
- Journal entry → Sentiment types: uses (evidence: `src/main/java/com/mohithasan/journalapp/entity/JournalEntry.java`)
- Journal API → Journal entry: returns entries (evidence: `src/main/java/com/mohithasan/journalapp/controller/JournalEntryController.java`)
- User API → User DTO: accepts updates (evidence: `src/main/java/com/mohithasan/journalapp/controller/UserController.java`)
- Weather service → Redis service: reads and writes (evidence: `src/main/java/com/mohithasan/journalapp/service/WeatherService.java`)
- Weather service → Config cache: reads config (evidence: `src/main/java/com/mohithasan/journalapp/service/WeatherService.java`)
- Weather service → Weather provider: requests forecast (evidence: `src/main/java/com/mohithasan/journalapp/service/WeatherService.java`)
- Weather service → Weather response: returns model (evidence: `src/main/java/com/mohithasan/journalapp/service/WeatherService.java`)
- Config cache → Config repository: loads config (evidence: `src/main/java/com/mohithasan/journalapp/cache/AppCache.java`)
- Config repository → App config: loads records (evidence: `src/main/java/com/mohithasan/journalapp/repository/ConfigJournalAppRepository.java`)
- Security rules → JWT filter: registers filter (evidence: `src/main/java/com/mohithasan/journalapp/config/SpringSecurity.java`)
- Security rules → User auth: configures auth (evidence: `src/main/java/com/mohithasan/journalapp/config/SpringSecurity.java`)
- JWT filter → JWT tokens: validates tokens (evidence: `src/main/java/com/mohithasan/journalapp/filter/JwtFilter.java`)
- User auth → User repository: loads account (evidence: `src/main/java/com/mohithasan/journalapp/service/UserDetailsServiceAuth.java`)
- Google login → JWT tokens: issues token (evidence: `src/main/java/com/mohithasan/journalapp/controller/GoogleAuthController.java`)
- Google login → User repository: looks up account (evidence: `src/main/java/com/mohithasan/journalapp/controller/GoogleAuthController.java`)
- Sentiment scheduler → Sentiment query: queries recipients (evidence: `src/main/java/com/mohithasan/journalapp/scheduler/UserScheduler.java`)
- Sentiment query → User account: queries (evidence: `src/main/java/com/mohithasan/journalapp/repository/UserRepositoryImpl.java`)
- Sentiment scheduler → Email service: sends summaries (evidence: `src/main/java/com/mohithasan/journalapp/scheduler/UserScheduler.java`)
- Sentiment consumer → Sentiment event: processes event (evidence: `src/main/java/com/mohithasan/journalapp/service/SentimentConsumerService.java`)
- Sentiment consumer → Email service: sends results (evidence: `src/main/java/com/mohithasan/journalapp/service/SentimentConsumerService.java`)
- Kafka → Sentiment consumer: delivers events (evidence: `README.md`)
- Email service → Mail provider: sends mail (evidence: `src/main/java/com/mohithasan/journalapp/service/EmailService.java`)
- User repository → MongoDB: uses MongoDB (evidence: `README.md`)
- Journal repository → MongoDB: uses MongoDB (evidence: `README.md`)
