# devopshydclub/vprofile-project architecture

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

- Interactive diagram: https://gitdiagram.com/devopshydclub/vprofile-project
- Repository: https://github.com/devopshydclub/vprofile-project

## Overview

This is a Spring MVC account and profile web application. Users register and sign in, view or edit account profiles, and upload profile images; account data is persisted through JPA to MySQL. Separate features use Memcached for profile lookup, Elasticsearch for user indexing and document operations, and RabbitMQ for message production and consumption. The graph includes service/repository and configuration layers where the source index establishes their relationships. Consumer wiring and some infrastructure configuration were not sampled, so those connections are omitted rather than inferred.

Main entry points: [`src/main/java/com/visualpathit/account/controller/UserController.java`](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/controller/UserController.java) (Account routes), [`src/main/java/com/visualpathit/account/service/UserServiceImpl.java`](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/service/UserServiceImpl.java) (User service), [`src/main/java/com/visualpathit/account/controller/FileUploadController.java`](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/controller/FileUploadController.java) (Image upload), [`src/main/java/com/visualpathit/account/controller/ElasticSearchController.java`](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/controller/ElasticSearchController.java) (Search routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflows"]
  node_user_controller["Account routes"]
  node_upload_controller["Image upload"]
  node_search_controller["Search routes"]
end

subgraph group_accounts["Account domain"]
  node_user_service["User service"]
  node_user_validator["Registration validation<br/>[UserValidator.java]"]
  node_security_service["Security service"]
  node_user_details["Login user loading"]
  node_user_model["User profile<br/>[User.java]"]
  node_role_model["Role<br/>[Role.java]"]
  node_user_repo["User repository"]
  node_role_repo["Role repository"]
end

subgraph group_messaging["Messaging"]
  node_rabbit_producer["Message producer"]
  node_rabbit_consumer["Message consumer"]
  node_rabbit_util["RabbitMQ access<br/>[RabbitMqUtil.java]"]
end

subgraph group_integrations["External integrations"]
  node_mysql[("MySQL accounts")]
  node_cache_util["Memcached access"]
  node_memcached[("Memcached")]
  node_search_util["Elasticsearch client"]
  node_elasticsearch[("Elasticsearch")]
  node_rabbitmq["RabbitMQ"]
  node_image_files[("Profile image files")]
end

subgraph group_configuration["Configuration"]
  node_components["Integration settings<br/>[Components.java]"]
end

node_visitor(("Web user"))

node_visitor -->|"submits requests"| node_user_controller
node_visitor -->|"uploads image"| node_upload_controller
node_visitor -->|"requests search"| node_search_controller
node_user_controller -->|"validates registration"| node_user_validator
node_user_controller -->|"manages profiles"| node_user_service
node_user_controller -->|"autologs in"| node_security_service
node_user_controller -->|"checks profile cache"| node_cache_util
node_user_controller -->|"sends messages"| node_rabbit_producer
node_upload_controller -->|"loads and saves user"| node_user_service
node_upload_controller -->|"writes image"| node_image_files
node_search_controller -->|"loads user list"| node_user_service
node_search_controller -->|"indexes or retrieves"| node_search_util
node_user_service -->|"persists users"| node_user_repo
node_user_service -->|"loads roles"| node_role_repo
node_user_details -->|"loads account"| node_user_repo
node_user_repo -->|"maps records"| node_user_model
node_role_repo -->|"maps records"| node_role_model
node_user_model -->|"maps to tables"| node_mysql
node_role_model -->|"maps to tables"| node_mysql
node_cache_util -->|"reads and writes"| node_memcached
node_search_util -->|"connects to"| node_elasticsearch
node_rabbit_producer -->|"delegates sending"| node_rabbit_util
node_rabbit_util -->|"connects to"| node_rabbitmq
node_cache_util -->|"reads settings"| node_components
node_search_util -->|"reads settings"| node_components
node_rabbit_util -->|"reads settings"| node_components

click node_user_controller "https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/controller/UserController.java"
click node_upload_controller "https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/controller/FileUploadController.java"
click node_search_controller "https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/controller/ElasticSearchController.java"
click node_user_service "https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/service/UserServiceImpl.java"
click node_user_validator "https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/validator/UserValidator.java"
click node_security_service "https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/service/SecurityServiceImpl.java"
click node_user_details "https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/service/UserDetailsServiceImpl.java"
click node_user_model "https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/model/User.java"
click node_role_model "https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/model/Role.java"
click node_user_repo "https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/repository/UserRepository.java"
click node_role_repo "https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/repository/RoleRepository.java"
click node_cache_util "https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/utils/MemcachedUtils.java"
click node_search_util "https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/utils/ElasticsearchUtil.java"
click node_rabbit_producer "https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/service/ProducerServiceImpl.java"
click node_rabbit_consumer "https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/service/ConsumerServiceImpl.java"
click node_rabbit_util "https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/utils/RabbitMqUtil.java"
click node_components "https://github.com/devopshydclub/vprofile-project/blob/vp-rem/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_visitor toneBlue
class node_user_service,node_user_validator,node_security_service,node_user_details,node_user_model,node_role_model,node_user_repo,node_role_repo toneAmber
class node_rabbit_producer,node_rabbit_consumer,node_rabbit_util toneMint
class node_mysql,node_cache_util,node_memcached,node_search_util,node_elasticsearch,node_rabbitmq,node_image_files toneRose
class node_components toneIndigo
```

## Components

### Web workflows

- [Account routes](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/controller/UserController.java): `src/main/java/com/visualpathit/account/controller/UserController.java`
- [Image upload](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/controller/FileUploadController.java): `src/main/java/com/visualpathit/account/controller/FileUploadController.java`
- [Search routes](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/controller/ElasticSearchController.java): `src/main/java/com/visualpathit/account/controller/ElasticSearchController.java`

### Account domain

- [User service](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/service/UserServiceImpl.java): `src/main/java/com/visualpathit/account/service/UserServiceImpl.java`
- [Registration validation](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/validator/UserValidator.java): `src/main/java/com/visualpathit/account/validator/UserValidator.java`
- [Security service](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/service/SecurityServiceImpl.java): `src/main/java/com/visualpathit/account/service/SecurityServiceImpl.java`
- [Login user loading](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/service/UserDetailsServiceImpl.java): `src/main/java/com/visualpathit/account/service/UserDetailsServiceImpl.java`
- [User profile](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/model/User.java): `src/main/java/com/visualpathit/account/model/User.java`
- [Role](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/model/Role.java): `src/main/java/com/visualpathit/account/model/Role.java`
- [User repository](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/repository/UserRepository.java): `src/main/java/com/visualpathit/account/repository/UserRepository.java`
- [Role repository](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/repository/RoleRepository.java): `src/main/java/com/visualpathit/account/repository/RoleRepository.java`

### Messaging

- [Message producer](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/service/ProducerServiceImpl.java): `src/main/java/com/visualpathit/account/service/ProducerServiceImpl.java`
- [Message consumer](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/service/ConsumerServiceImpl.java): `src/main/java/com/visualpathit/account/service/ConsumerServiceImpl.java`
- [RabbitMQ access](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/utils/RabbitMqUtil.java): `src/main/java/com/visualpathit/account/utils/RabbitMqUtil.java`

### External integrations

- **MySQL accounts**
- [Memcached access](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/utils/MemcachedUtils.java): `src/main/java/com/visualpathit/account/utils/MemcachedUtils.java`
- **Memcached**
- [Elasticsearch client](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/utils/ElasticsearchUtil.java): `src/main/java/com/visualpathit/account/utils/ElasticsearchUtil.java`
- **Elasticsearch**
- **RabbitMQ**
- **Profile image files**

### Configuration

- [Integration settings](https://github.com/devopshydclub/vprofile-project/blob/vp-rem/src/main/java/com/visualpathit/account/beans/Components.java): `src/main/java/com/visualpathit/account/beans/Components.java`

### Other components

- **Web user**

## Connections

- Web user → Account routes: submits requests (evidence: `src/main/java/com/visualpathit/account/controller/UserController.java`)
- Web user → Image upload: uploads image (evidence: `src/main/java/com/visualpathit/account/controller/FileUploadController.java`)
- Web user → Search routes: requests search (evidence: `src/main/java/com/visualpathit/account/controller/ElasticSearchController.java`)
- Account routes → Registration validation: validates registration (evidence: `src/main/java/com/visualpathit/account/controller/UserController.java`)
- Account routes → User service: manages profiles (evidence: `src/main/java/com/visualpathit/account/controller/UserController.java`)
- Account routes → Security service: autologs in (evidence: `src/main/java/com/visualpathit/account/controller/UserController.java`)
- Account routes → Memcached access: checks profile cache (evidence: `src/main/java/com/visualpathit/account/controller/UserController.java`)
- Account routes → Message producer: sends messages (evidence: `src/main/java/com/visualpathit/account/controller/UserController.java`)
- Image upload → User service: loads and saves user (evidence: `src/main/java/com/visualpathit/account/controller/FileUploadController.java`)
- Image upload → Profile image files: writes image (evidence: `src/main/java/com/visualpathit/account/controller/FileUploadController.java`)
- Search routes → User service: loads user list (evidence: `src/main/java/com/visualpathit/account/controller/ElasticSearchController.java`)
- Search routes → Elasticsearch client: indexes or retrieves (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`)
- Login user loading → User repository: loads account (evidence: `src/main/java/com/visualpathit/account/service/UserDetailsServiceImpl.java`)
- User repository → User profile: maps records (evidence: `src/main/java/com/visualpathit/account/repository/UserRepository.java`)
- Role repository → Role: maps records (evidence: `src/main/java/com/visualpathit/account/repository/RoleRepository.java`)
- User profile → MySQL accounts: maps to tables (evidence: `src/main/java/com/visualpathit/account/model/User.java`)
- Role → MySQL accounts: maps to tables (evidence: `src/main/java/com/visualpathit/account/model/Role.java`)
- Memcached access → Memcached: reads and writes (evidence: `src/main/java/com/visualpathit/account/utils/MemcachedUtils.java`)
- Elasticsearch client → Elasticsearch: connects to (evidence: `src/main/java/com/visualpathit/account/utils/ElasticsearchUtil.java`)
- Message producer → RabbitMQ access: delegates sending (evidence: `src/main/java/com/visualpathit/account/service/ProducerServiceImpl.java`)
- RabbitMQ access → RabbitMQ: connects to (evidence: `src/main/java/com/visualpathit/account/utils/RabbitMqUtil.java`)
- Memcached access → Integration settings: reads settings (evidence: `src/main/java/com/visualpathit/account/utils/MemcachedUtils.java`)
- Elasticsearch client → Integration settings: reads settings (evidence: `src/main/java/com/visualpathit/account/utils/ElasticsearchUtil.java`)
- RabbitMQ access → Integration settings: reads settings (evidence: `src/main/java/com/visualpathit/account/utils/RabbitMqUtil.java`)
