# dru-o7/journalapp architecture

> Architecture diagram of the GitHub repository dru-o7/journalapp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dru-o7/journalapp
- Repository: https://github.com/dru-o7/journalapp

## Overview

Journal App is a Spring REST API for account registration/login, JWT-protected user and admin operations, and journal-entry CRUD. Its principal workflow carries journal requests from the controller through entry and user services into MongoDB-backed repositories; authentication is a separate request-security path. The user greeting also enriches its response with cached weather and quote data, while a scheduler supports sentiment-related email work. Relationships are limited to README statements and the supplied source excerpts or SOURCE INDEX; unsampled implementation details are not inferred.

Main entry points: [`src/main/java/net/engineeringdigest/journalApp/controller/UserController.java`](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/controller/UserController.java) (User API), [`src/main/java/net/engineeringdigest/journalApp/service/UserService.java`](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/service/UserService.java) (User Service), [`src/main/java/net/engineeringdigest/journalApp/repository/UserRepository.java`](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/repository/UserRepository.java) (User Repository), [`src/main/java/net/engineeringdigest/journalApp/controller/PublicController.java`](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/controller/PublicController.java) (Public API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_application["Spring Application"]
  node_public_api["Public API"]
  node_user_api["User API"]
  node_admin_api["Admin API"]
  node_journal_api["Journal API"]
end

subgraph group_identity["Identity and Access"]
  node_security["Security Config"]
  node_jwt_filter["JWT Filter<br/>[JwtFilter.java]"]
  node_jwt["JWT Utility<br/>[JWTUtil.java]"]
  node_details["User Details"]
  node_user_service["User Service<br/>[UserService.java]"]
  node_user_repo[("User Repository")]
  node_user_model["User Model<br/>[User.java]"]
end

subgraph group_journal["Journal Domain"]
  node_journal_service["Entry Service"]
  node_journal_repo[("Entry Repository")]
  node_entry_model["Entry Model<br/>[JournalEntry.java]"]
end

subgraph group_support["Integrations and Operations"]
  node_weather["Weather Service"]
  node_quote["Quote Service<br/>[QuoteService.java]"]
  node_app_cache["Config Cache<br/>[AppCache.java]"]
  node_config_repo[("Config Repository")]
  node_redis_service["Redis Service<br/>[RedisService.java]"]
  node_redis[("Redis")]
  node_scheduler["User Scheduler<br/>[UserScheduler.java]"]
  node_email["Email Service<br/>[EmailService.java]"]
end

node_client(("API Client"))
node_weather_api["Weather API"]
node_quote_api["Quote API"]
node_mongo[("MongoDB")]

node_client -->|"registers or logs in"| node_public_api
node_client -->|"manages account"| node_user_api
node_client -->|"manages entries"| node_journal_api
node_client -->|"requests admin actions"| node_admin_api
node_public_api -->|"registers user"| node_user_service
node_public_api -->|"loads identity"| node_details
node_public_api -->|"issues token"| node_jwt
node_security -->|"registers filter"| node_jwt_filter
node_security -->|"configures lookup"| node_details
node_jwt_filter -->|"validates token"| node_jwt
node_details -->|"loads user"| node_user_repo
node_user_api -->|"updates account"| node_user_service
node_user_api -->|"gets weather"| node_weather
node_user_api -->|"gets quote"| node_quote
node_user_api -->|"deletes account"| node_user_repo
node_admin_api -->|"manages users"| node_user_service
node_journal_api -->|"handles entries"| node_journal_service
node_journal_service -->|"loads and saves owner"| node_user_service
node_journal_service -->|"persists entries"| node_journal_repo
node_journal_service -->|"creates entries"| node_entry_model
node_user_service -->|"persists users"| node_user_repo
node_journal_repo -.->|"stores entries"| node_mongo
node_user_repo -.->|"stores users"| node_mongo
node_weather -->|"checks and caches"| node_redis_service
node_weather -->|"reads endpoint template"| node_app_cache
node_weather -.->|"fetches conditions"| node_weather_api
node_quote -->|"checks and caches"| node_redis_service
node_quote -->|"reads endpoint"| node_app_cache
node_quote -.->|"fetches quote"| node_quote_api
node_app_cache -->|"loads configuration"| node_config_repo
node_redis_service -.->|"reads and writes"| node_redis
node_scheduler -->|"sends email"| node_email
node_scheduler -.->|"queries users"| node_user_repo
node_scheduler -.->|"uses configuration"| node_app_cache

click node_application "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/JournalApplication.java"
click node_public_api "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/controller/PublicController.java"
click node_user_api "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/controller/UserController.java"
click node_admin_api "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/controller/AdminController.java"
click node_journal_api "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/controller/JournalEntryController.java"
click node_security "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/config/SpringSecurity.java"
click node_jwt_filter "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/filter/JwtFilter.java"
click node_jwt "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/utility/JWTUtil.java"
click node_details "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/service/UserDetailsServiceImpl.java"
click node_user_service "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/service/UserService.java"
click node_user_repo "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/repository/UserRepository.java"
click node_journal_service "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/service/JournalEntryService.java"
click node_journal_repo "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/repository/JournalEntryRepository.java"
click node_entry_model "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/entity/JournalEntry.java"
click node_user_model "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/entity/User.java"
click node_weather "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/service/WeatherService.java"
click node_quote "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/service/QuoteService.java"
click node_app_cache "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/cache/AppCache.java"
click node_config_repo "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/repository/ConfigJournalAppRepository.java"
click node_redis_service "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/service/RedisService.java"
click node_scheduler "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/scheduler/UserScheduler.java"
click node_email "https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/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_application,node_public_api,node_user_api,node_admin_api,node_journal_api,node_client toneBlue
class node_security,node_jwt_filter,node_jwt,node_details,node_user_service,node_user_repo,node_user_model,node_mongo toneAmber
class node_journal_service,node_journal_repo,node_entry_model,node_weather_api,node_quote_api toneMint
class node_weather,node_quote,node_app_cache,node_config_repo,node_redis_service,node_redis,node_scheduler,node_email toneRose
```

## Components

### REST API

- [Spring Application](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/JournalApplication.java): `src/main/java/net/engineeringdigest/journalApp/JournalApplication.java`
- [Public API](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/controller/PublicController.java): `src/main/java/net/engineeringdigest/journalApp/controller/PublicController.java`
- [User API](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/controller/UserController.java): `src/main/java/net/engineeringdigest/journalApp/controller/UserController.java`
- [Admin API](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/controller/AdminController.java): `src/main/java/net/engineeringdigest/journalApp/controller/AdminController.java`
- [Journal API](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/controller/JournalEntryController.java): `src/main/java/net/engineeringdigest/journalApp/controller/JournalEntryController.java`

### Identity and Access

- [Security Config](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/config/SpringSecurity.java): `src/main/java/net/engineeringdigest/journalApp/config/SpringSecurity.java`
- [JWT Filter](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/filter/JwtFilter.java): `src/main/java/net/engineeringdigest/journalApp/filter/JwtFilter.java`
- [JWT Utility](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/utility/JWTUtil.java): `src/main/java/net/engineeringdigest/journalApp/utility/JWTUtil.java`
- [User Details](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/service/UserDetailsServiceImpl.java): `src/main/java/net/engineeringdigest/journalApp/service/UserDetailsServiceImpl.java`
- [User Service](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/service/UserService.java): `src/main/java/net/engineeringdigest/journalApp/service/UserService.java`
- [User Repository](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/repository/UserRepository.java): `src/main/java/net/engineeringdigest/journalApp/repository/UserRepository.java`
- [User Model](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/entity/User.java): `src/main/java/net/engineeringdigest/journalApp/entity/User.java`

### Journal Domain

- [Entry Service](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/service/JournalEntryService.java): `src/main/java/net/engineeringdigest/journalApp/service/JournalEntryService.java`
- [Entry Repository](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/repository/JournalEntryRepository.java): `src/main/java/net/engineeringdigest/journalApp/repository/JournalEntryRepository.java`
- [Entry Model](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/entity/JournalEntry.java): `src/main/java/net/engineeringdigest/journalApp/entity/JournalEntry.java`

### Integrations and Operations

- [Weather Service](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/service/WeatherService.java): `src/main/java/net/engineeringdigest/journalApp/service/WeatherService.java`
- [Quote Service](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/service/QuoteService.java): `src/main/java/net/engineeringdigest/journalApp/service/QuoteService.java`
- [Config Cache](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/cache/AppCache.java): `src/main/java/net/engineeringdigest/journalApp/cache/AppCache.java`
- [Config Repository](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/repository/ConfigJournalAppRepository.java): `src/main/java/net/engineeringdigest/journalApp/repository/ConfigJournalAppRepository.java`
- [Redis Service](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/service/RedisService.java): `src/main/java/net/engineeringdigest/journalApp/service/RedisService.java`
- **Redis**
- [User Scheduler](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/scheduler/UserScheduler.java): `src/main/java/net/engineeringdigest/journalApp/scheduler/UserScheduler.java`
- [Email Service](https://github.com/dru-o7/journalapp/blob/main/src/main/java/net/engineeringdigest/journalApp/service/EmailService.java): `src/main/java/net/engineeringdigest/journalApp/service/EmailService.java`

### Other components

- **API Client**
- **Weather API**
- **Quote API**
- **MongoDB**

## Connections

- API Client → Public API: registers or logs in (evidence: `README.md`)
- API Client → User API: manages account (evidence: `README.md`)
- API Client → Journal API: manages entries (evidence: `README.md`)
- API Client → Admin API: requests admin actions (evidence: `README.md`)
- Public API → User Service: registers user (evidence: `src/main/java/net/engineeringdigest/journalApp/controller/PublicController.java`)
- Public API → User Details: loads identity (evidence: `src/main/java/net/engineeringdigest/journalApp/controller/PublicController.java`)
- Public API → JWT Utility: issues token (evidence: `src/main/java/net/engineeringdigest/journalApp/controller/PublicController.java`)
- Security Config → JWT Filter: registers filter (evidence: `src/main/java/net/engineeringdigest/journalApp/config/SpringSecurity.java`)
- Security Config → User Details: configures lookup (evidence: `src/main/java/net/engineeringdigest/journalApp/config/SpringSecurity.java`)
- JWT Filter → JWT Utility: validates token (evidence: `src/main/java/net/engineeringdigest/journalApp/filter/JwtFilter.java`)
- User Details → User Repository: loads user (evidence: `src/main/java/net/engineeringdigest/journalApp/service/UserDetailsServiceImpl.java`)
- User API → User Service: updates account (evidence: `src/main/java/net/engineeringdigest/journalApp/controller/UserController.java`)
- User API → Weather Service: gets weather (evidence: `src/main/java/net/engineeringdigest/journalApp/controller/UserController.java`)
- User API → Quote Service: gets quote (evidence: `src/main/java/net/engineeringdigest/journalApp/controller/UserController.java`)
- User API → User Repository: deletes account (evidence: `src/main/java/net/engineeringdigest/journalApp/controller/UserController.java`)
- Admin API → User Service: manages users (evidence: `src/main/java/net/engineeringdigest/journalApp/controller/AdminController.java`)
- Journal API → Entry Service: handles entries (evidence: `src/main/java/net/engineeringdigest/journalApp/controller/JournalEntryController.java`)
- Entry Service → User Service: loads and saves owner (evidence: `src/main/java/net/engineeringdigest/journalApp/service/JournalEntryService.java`)
- Entry Service → Entry Repository: persists entries (evidence: `src/main/java/net/engineeringdigest/journalApp/service/JournalEntryService.java`)
- Entry Service → Entry Model: creates entries (evidence: `src/main/java/net/engineeringdigest/journalApp/service/JournalEntryService.java`)
- User Service → User Repository: persists users (evidence: `src/main/java/net/engineeringdigest/journalApp/service/UserService.java`)
- Entry Repository → MongoDB: stores entries (evidence: `README.md`)
- User Repository → MongoDB: stores users (evidence: `README.md`)
- Weather Service → Redis Service: checks and caches (evidence: `src/main/java/net/engineeringdigest/journalApp/service/WeatherService.java`)
- Weather Service → Config Cache: reads endpoint template (evidence: `src/main/java/net/engineeringdigest/journalApp/service/WeatherService.java`)
- Weather Service → Weather API: fetches conditions
- Quote Service → Redis Service: checks and caches (evidence: `src/main/java/net/engineeringdigest/journalApp/service/QuoteService.java`)
- Quote Service → Config Cache: reads endpoint (evidence: `src/main/java/net/engineeringdigest/journalApp/service/QuoteService.java`)
- Quote Service → Quote API: fetches quote
- Config Cache → Config Repository: loads configuration (evidence: `src/main/java/net/engineeringdigest/journalApp/cache/AppCache.java`)
- Redis Service → Redis: reads and writes
- User Scheduler → Email Service: sends email (evidence: `src/main/java/net/engineeringdigest/journalApp/scheduler/UserScheduler.java`)
- User Scheduler → User Repository: queries users
- User Scheduler → Config Cache: uses configuration (evidence: `src/main/java/net/engineeringdigest/journalApp/scheduler/UserScheduler.java`)
