# hossamfatahalla/hprofile architecture

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

- Interactive diagram: https://gitdiagram.com/hossamfatahalla/hprofile
- Repository: https://github.com/hossamfatahalla/hprofile

## Overview

This is a Spring MVC account-management application. Users register, log in, view and update profiles, and upload profile images; the controllers delegate account operations to services and repositories. Separate features index account data in Elasticsearch, cache individual-user lookups in Memcached, and publish RabbitMQ messages. The graph reflects the controllers and service relationships visible in excerpts or the source index; configuration and several implementations were not sampled, so those connections are omitted where evidence is insufficient.

Main entry points: [`src/main/java/com/visualpathit/account/controller/UserController.java`](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/controller/UserController.java) (Account controller), [`src/main/java/com/visualpathit/account/service/UserServiceImpl.java`](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/service/UserServiceImpl.java) (User service), [`src/main/java/com/visualpathit/account/controller/ElasticSearchController.java`](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/controller/ElasticSearchController.java) (Search controller), [`src/main/java/com/visualpathit/account/utils/ElasticsearchUtil.java`](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/utils/ElasticsearchUtil.java) (Elasticsearch helper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflows"]
  node_user_controller["Account controller"]
  node_upload_controller["Image upload"]
  node_search_controller["Search controller"]
  node_views["JSP views"]
end

subgraph group_accounts["Account domain"]
  node_user_service["User service"]
  node_user_repository["User repository"]
  node_role_repository["Role repository"]
  node_user_model["User profile<br/>[User.java]"]
  node_role_model["Role model<br/>[Role.java]"]
  node_validator["Registration validator<br/>[UserValidator.java]"]
  node_mysql[("MySQL")]
end

subgraph group_integrations["External integrations"]
  node_memcached["Memcached helper"]
  node_memcached_service[("Memcached")]
  node_producer_service["Message producer"]
  node_rabbit_util["RabbitMQ helper<br/>[RabbitMqUtil.java]"]
  node_rabbitmq["RabbitMQ"]
  node_elasticsearch_util["Elasticsearch helper"]
  node_components["Integration settings<br/>[Components.java]"]
  node_elasticsearch[("Elasticsearch")]
end

subgraph group_security["Authentication"]
  node_security_service["Security service"]
  node_user_details["User details loader"]
end

node_visitor(("User"))

node_visitor -->|"submits requests"| node_user_controller
node_user_controller -->|"validates registration"| node_validator
node_user_controller -->|"manages accounts"| node_user_service
node_user_controller -->|"logs in"| node_security_service
node_user_controller -->|"checks cache"| node_memcached
node_user_controller -->|"publishes messages"| node_producer_service
node_user_controller -->|"selects views"| node_views
node_upload_controller -->|"updates profile"| node_user_service
node_upload_controller -->|"selects upload view"| node_views
node_search_controller -->|"loads users"| node_user_service
node_search_controller -->|"runs index queries"| node_elasticsearch_util
node_search_controller -->|"selects results view"| node_views
node_user_service -->|"persists users"| node_user_repository
node_user_service -->|"loads roles"| node_role_repository
node_user_repository -->|"stores profiles"| node_mysql
node_user_details -->|"loads user records"| node_user_repository
node_user_model -->|"maps user roles"| node_role_model
node_memcached -->|"reads and writes"| node_memcached_service
node_producer_service -->|"delegates publishing"| node_rabbit_util
node_rabbit_util -->|"sends messages"| node_rabbitmq
node_elasticsearch_util -->|"reads settings"| node_components
node_elasticsearch_util -->|"connects to cluster"| node_elasticsearch

click node_user_controller "https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/controller/UserController.java"
click node_upload_controller "https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/controller/FileUploadController.java"
click node_search_controller "https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/controller/ElasticSearchController.java"
click node_views "https://github.com/hossamfatahalla/hprofile/tree/main/src/main/webapp/WEB-INF/views"
click node_user_service "https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/service/UserServiceImpl.java"
click node_user_repository "https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/repository/UserRepository.java"
click node_role_repository "https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/repository/RoleRepository.java"
click node_user_model "https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/model/User.java"
click node_role_model "https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/model/Role.java"
click node_validator "https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/validator/UserValidator.java"
click node_security_service "https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/service/SecurityServiceImpl.java"
click node_user_details "https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/service/UserDetailsServiceImpl.java"
click node_memcached "https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/utils/MemcachedUtils.java"
click node_producer_service "https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/service/ProducerServiceImpl.java"
click node_rabbit_util "https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/utils/RabbitMqUtil.java"
click node_elasticsearch_util "https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/utils/ElasticsearchUtil.java"
click node_components "https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/beans/Components.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_user_controller,node_upload_controller,node_search_controller,node_views,node_visitor toneBlue
class node_user_service,node_user_repository,node_role_repository,node_user_model,node_role_model,node_validator,node_mysql toneAmber
class node_memcached,node_memcached_service,node_producer_service,node_rabbit_util,node_rabbitmq,node_elasticsearch_util,node_components,node_elasticsearch toneMint
class node_security_service,node_user_details toneRose
```

## Components

### Web workflows

- [Account controller](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/controller/UserController.java): `src/main/java/com/visualpathit/account/controller/UserController.java`
- [Image upload](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/controller/FileUploadController.java): `src/main/java/com/visualpathit/account/controller/FileUploadController.java`
- [Search controller](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/controller/ElasticSearchController.java): `src/main/java/com/visualpathit/account/controller/ElasticSearchController.java`
- [JSP views](https://github.com/hossamfatahalla/hprofile/tree/main/src/main/webapp/WEB-INF/views): `src/main/webapp/WEB-INF/views`

### Account domain

- [User service](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/service/UserServiceImpl.java): `src/main/java/com/visualpathit/account/service/UserServiceImpl.java`
- [User repository](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/repository/UserRepository.java): `src/main/java/com/visualpathit/account/repository/UserRepository.java`
- [Role repository](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/repository/RoleRepository.java): `src/main/java/com/visualpathit/account/repository/RoleRepository.java`
- [User profile](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/model/User.java): `src/main/java/com/visualpathit/account/model/User.java`
- [Role model](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/model/Role.java): `src/main/java/com/visualpathit/account/model/Role.java`
- [Registration validator](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/validator/UserValidator.java): `src/main/java/com/visualpathit/account/validator/UserValidator.java`
- **MySQL**

### External integrations

- [Memcached helper](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/utils/MemcachedUtils.java): `src/main/java/com/visualpathit/account/utils/MemcachedUtils.java`
- **Memcached**
- [Message producer](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/service/ProducerServiceImpl.java): `src/main/java/com/visualpathit/account/service/ProducerServiceImpl.java`
- [RabbitMQ helper](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/utils/RabbitMqUtil.java): `src/main/java/com/visualpathit/account/utils/RabbitMqUtil.java`
- **RabbitMQ**
- [Elasticsearch helper](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/utils/ElasticsearchUtil.java): `src/main/java/com/visualpathit/account/utils/ElasticsearchUtil.java`
- [Integration settings](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/beans/Components.java): `src/main/java/com/visualpathit/account/beans/Components.java`
- **Elasticsearch**

### Authentication

- [Security service](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/service/SecurityServiceImpl.java): `src/main/java/com/visualpathit/account/service/SecurityServiceImpl.java`
- [User details loader](https://github.com/hossamfatahalla/hprofile/blob/main/src/main/java/com/visualpathit/account/service/UserDetailsServiceImpl.java): `src/main/java/com/visualpathit/account/service/UserDetailsServiceImpl.java`

### Other components

- **User**

## Connections

- User → Account controller: submits requests (evidence: `src/main/java/com/visualpathit/account/controller/UserController.java`)
- Account controller → Registration validator: validates registration (evidence: `src/main/java/com/visualpathit/account/controller/UserController.java`)
- Account controller → User service: manages accounts (evidence: `src/main/java/com/visualpathit/account/controller/UserController.java`)
- Account controller → Security service: logs in (evidence: `src/main/java/com/visualpathit/account/controller/UserController.java`)
- Account controller → Memcached helper: checks cache (evidence: `src/main/java/com/visualpathit/account/controller/UserController.java`)
- Account controller → Message producer: publishes messages (evidence: `src/main/java/com/visualpathit/account/controller/UserController.java`)
- Account controller → JSP views: selects views (evidence: `src/main/java/com/visualpathit/account/controller/UserController.java`)
- Image upload → User service: updates profile (evidence: `src/main/java/com/visualpathit/account/controller/FileUploadController.java`)
- Image upload → JSP views: selects upload view (evidence: `src/main/java/com/visualpathit/account/controller/FileUploadController.java`)
- Search controller → User service: loads users (evidence: `src/main/java/com/visualpathit/account/controller/ElasticSearchController.java`)
- Search controller → Elasticsearch helper: runs index queries (evidence: `src/main/java/com/visualpathit/account/controller/ElasticSearchController.java`)
- Search controller → JSP views: selects results view (evidence: `src/main/java/com/visualpathit/account/controller/ElasticSearchController.java`)
- User service → User repository: persists users (evidence: `src/main/java/com/visualpathit/account/service/UserServiceImpl.java`)
- User service → Role repository: loads roles (evidence: `src/main/java/com/visualpathit/account/service/UserServiceImpl.java`)
- User repository → MySQL: stores profiles (evidence: `README.md`)
- User details loader → User repository: loads user records (evidence: `src/main/java/com/visualpathit/account/service/UserDetailsServiceImpl.java`)
- User profile → Role model: maps user roles (evidence: `src/main/java/com/visualpathit/account/model/User.java`)
- Memcached helper → Memcached: reads and writes (evidence: `src/main/java/com/visualpathit/account/utils/MemcachedUtils.java`)
- Message producer → RabbitMQ helper: delegates publishing (evidence: `src/main/java/com/visualpathit/account/service/ProducerServiceImpl.java`)
- RabbitMQ helper → RabbitMQ: sends messages (evidence: `src/main/java/com/visualpathit/account/utils/RabbitMqUtil.java`)
- Elasticsearch helper → Integration settings: reads settings (evidence: `src/main/java/com/visualpathit/account/utils/ElasticsearchUtil.java`)
- Elasticsearch helper → Elasticsearch: connects to cluster (evidence: `src/main/java/com/visualpathit/account/utils/ElasticsearchUtil.java`)
