# hsadeveloper/spring-boot-apps architecture

> Architecture diagram of the GitHub repository hsadeveloper/spring-boot-apps, 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/hsadeveloper/spring-boot-apps
- Repository: https://github.com/hsadeveloper/spring-boot-apps

## Overview

This repository contains two Spring Boot services: a simple greeting endpoint and a MongoDB-backed user service with form-based security and startup data seeding. The user-facing flow is an HTTP request into the user service, where configured security loads credentials through a user-details service and repository; the signup handler shown currently returns a redirect and does not persist registrations. Source excerpts establish these internal calls, but do not show framework routing or database wiring, so those links are omitted.

Main entry points: [`userservice/src/main/java/userservice/entity/User.java`](https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/entity/User.java) (User Entity), [`userservice/src/main/java/userservice/repository/UserRepository.java`](https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/repository/UserRepository.java) (User Repository), [`userservice/src/main/java/userservice/entity/Role.java`](https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/entity/Role.java) (Role Entity), [`userservice/src/main/java/userservice/config/DataInitializer.java`](https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/config/DataInitializer.java) (Startup Seeder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_greeting["Greeting Service"]
  node_greet_app["Greeting App"]
  node_greet_endpoint["Greeting Endpoint"]
end

subgraph group_users["User Service"]
  node_user_app["User App"]
  node_user_api["User API"]
  node_security["Web Security"]
  node_details["User Details"]
  node_initializer["Startup Seeder"]
end

subgraph group_identity["Identity Data"]
  node_user_entity["User Entity<br/>[User.java]"]
  node_role_entity["Role Entity<br/>[Role.java]"]
  node_user_role["User-Role Link<br/>[UserRole.java]"]
  node_user_repo["User Repository"]
  node_role_repo["Role Repository"]
end

node_client(("HTTP Client"))

node_client -.->|"requests"| node_greet_endpoint
node_client -.->|"requests"| node_user_api
node_security -->|"loads users"| node_details
node_details -->|"finds username"| node_user_repo
node_initializer -->|"saves users"| node_user_repo
node_initializer -->|"seeds roles"| node_role_repo
node_user_repo -->|"stores"| node_user_entity
node_role_repo -->|"stores"| node_role_entity
node_user_entity -->|"holds roles"| node_role_entity
node_user_role -->|"references"| node_user_entity
node_user_role -->|"references"| node_role_entity

click node_greet_app "https://github.com/hsadeveloper/spring-boot-apps/blob/main/spring.observabiliy/src/main/java/spring_observability/SpringObservabilityApplication.java"
click node_greet_endpoint "https://github.com/hsadeveloper/spring-boot-apps/blob/main/spring.observabiliy/src/main/java/spring_observability/controller/GreetingController.java"
click node_user_app "https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/UserserviceApplication.java"
click node_user_api "https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/controller/UserController.java"
click node_security "https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/config/SecurityConfig.java"
click node_details "https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/service/CustomUserDetailsService.java"
click node_initializer "https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/config/DataInitializer.java"
click node_user_entity "https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/entity/User.java"
click node_role_entity "https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/entity/Role.java"
click node_user_role "https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/entity/UserRole.java"
click node_user_repo "https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/repository/UserRepository.java"
click node_role_repo "https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/repository/RoleRepository.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_greet_app,node_greet_endpoint,node_client toneBlue
class node_user_app,node_user_api,node_security,node_details,node_initializer toneAmber
class node_user_entity,node_role_entity,node_user_role,node_user_repo,node_role_repo toneMint
```

## Components

### Greeting Service

- [Greeting App](https://github.com/hsadeveloper/spring-boot-apps/blob/main/spring.observabiliy/src/main/java/spring_observability/SpringObservabilityApplication.java): `spring.observabiliy/src/main/java/spring_observability/SpringObservabilityApplication.java`
- [Greeting Endpoint](https://github.com/hsadeveloper/spring-boot-apps/blob/main/spring.observabiliy/src/main/java/spring_observability/controller/GreetingController.java): `spring.observabiliy/src/main/java/spring_observability/controller/GreetingController.java`

### User Service

- [User App](https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/UserserviceApplication.java): `userservice/src/main/java/userservice/UserserviceApplication.java`
- [User API](https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/controller/UserController.java): `userservice/src/main/java/userservice/controller/UserController.java`
- [Web Security](https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/config/SecurityConfig.java): `userservice/src/main/java/userservice/config/SecurityConfig.java`
- [User Details](https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/service/CustomUserDetailsService.java): `userservice/src/main/java/userservice/service/CustomUserDetailsService.java`
- [Startup Seeder](https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/config/DataInitializer.java): `userservice/src/main/java/userservice/config/DataInitializer.java`

### Identity Data

- [User Entity](https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/entity/User.java): `userservice/src/main/java/userservice/entity/User.java`
- [Role Entity](https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/entity/Role.java): `userservice/src/main/java/userservice/entity/Role.java`
- [User-Role Link](https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/entity/UserRole.java): `userservice/src/main/java/userservice/entity/UserRole.java`
- [User Repository](https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/repository/UserRepository.java): `userservice/src/main/java/userservice/repository/UserRepository.java`
- [Role Repository](https://github.com/hsadeveloper/spring-boot-apps/blob/main/userservice/src/main/java/userservice/repository/RoleRepository.java): `userservice/src/main/java/userservice/repository/RoleRepository.java`

### Other components

- **HTTP Client**

## Connections

- HTTP Client → Greeting Endpoint: requests (evidence: `spring.observabiliy/src/main/java/spring_observability/controller/GreetingController.java`)
- HTTP Client → User API: requests (evidence: `userservice/src/main/java/userservice/controller/UserController.java`)
- Web Security → User Details: loads users (evidence: `userservice/src/main/java/userservice/config/SecurityConfig.java`)
- User Details → User Repository: finds username (evidence: `userservice/src/main/java/userservice/service/CustomUserDetailsService.java`)
- Startup Seeder → User Repository: saves users (evidence: `userservice/src/main/java/userservice/config/DataInitializer.java`)
- Startup Seeder → Role Repository: seeds roles (evidence: `userservice/src/main/java/userservice/config/DataInitializer.java`)
- User Repository → User Entity: stores (evidence: `userservice/src/main/java/userservice/repository/UserRepository.java`)
- Role Repository → Role Entity: stores (evidence: `userservice/src/main/java/userservice/repository/RoleRepository.java`)
- User Entity → Role Entity: holds roles (evidence: `userservice/src/main/java/userservice/entity/User.java`)
- User-Role Link → User Entity: references (evidence: `userservice/src/main/java/userservice/entity/UserRole.java`)
- User-Role Link → Role Entity: references (evidence: `userservice/src/main/java/userservice/entity/UserRole.java`)
