# hkhcoder/vprofile-project architecture

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

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

## Overview

This is a Spring MVC account/profile web application. Users register or log in, then view and update profiles; the application validates and persists account data, with optional cache, file-upload, RabbitMQ, and Elasticsearch features. The source excerpts show controller-to-service and integration calls, while several implementation details and configuration wiring are not shown; those relationships are omitted where evidence is insufficient.

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

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflows"]
  node_user_controller["Account controller"]
  node_upload_controller["File upload"]
  node_search_controller["Search controller"]
  node_rabbit_controller["Messaging controller"]
  node_jsp_views["JSP views"]
end

subgraph group_accounts["Accounts and security"]
  node_user_service["User service"]
  node_user_repository["User repository"]
  node_account_model["User and role model<br/>[User.java]"]
  node_validator["Registration validator<br/>[UserValidator.java]"]
  node_security_service["Login service"]
  node_mysql[("MySQL database")]
end

subgraph group_integrations["Integrations"]
  node_memcached[("Memcached cache")]
  node_cache_util["Cache utility"]
  node_file_system[("Uploaded files")]
  node_elasticsearch[("Elasticsearch")]
  node_elasticsearch_util["Search client utility"]
  node_rabbitmq["RabbitMQ broker"]
  node_producer["Message producer"]
  node_consumer["Message consumer"]
end

subgraph group_config["Runtime configuration"]
  node_components["Integration settings<br/>[Components.java]"]
  node_rabbit_util["Broker settings utility<br/>[RabbitMqUtil.java]"]
end

node_visitor(("Browser user"))

node_visitor -->|"submits requests"| node_user_controller
node_user_controller -->|"validates registration"| node_validator
node_user_controller -->|"saves and finds users"| node_user_service
node_user_controller -->|"autologs in"| node_security_service
node_user_controller -->|"reads and writes cache"| node_cache_util
node_user_controller -->|"returns view names"| node_jsp_views
node_user_service -->|"uses repository"| node_user_repository
node_user_repository -->|"persists entities"| node_account_model
node_validator -->|"validates user"| node_account_model
node_user_controller -.-> node_upload_controller
node_upload_controller -->|"updates profile"| node_user_service
node_upload_controller -->|"writes uploaded file"| node_file_system
node_search_controller -->|"loads users"| node_user_service
node_search_controller -->|"creates client"| node_elasticsearch_util
node_search_controller -->|"indexes and queries"| node_elasticsearch
node_rabbit_controller -->|"reads broker settings"| node_rabbit_util
node_producer -->|"reads broker settings"| node_rabbit_util
node_components -->|"configures endpoint"| node_elasticsearch_util
node_components -->|"provides settings"| node_rabbit_util
node_producer -.->|"publishes messages"| node_rabbitmq
node_consumer -.->|"consumes messages"| node_rabbitmq
node_user_repository -.->|"database access"| node_mysql
node_cache_util -.->|"cache access"| node_memcached

click node_user_controller "https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/controller/UserController.java"
click node_upload_controller "https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/controller/FileUploadController.java"
click node_search_controller "https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/controller/ElasticSearchController.java"
click node_rabbit_controller "https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/controller/RabbitMqController.java"
click node_jsp_views "https://github.com/hkhcoder/vprofile-project/tree/local/src/main/webapp/WEB-INF/views"
click node_user_service "https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/service/UserServiceImpl.java"
click node_user_repository "https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/repository/UserRepository.java"
click node_account_model "https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/model/User.java"
click node_validator "https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/validator/UserValidator.java"
click node_security_service "https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/service/SecurityServiceImpl.java"
click node_cache_util "https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/utils/MemcachedUtils.java"
click node_elasticsearch_util "https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/utils/ElasticsearchUtil.java"
click node_producer "https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/service/ProducerServiceImpl.java"
click node_consumer "https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/service/ConsumerServiceImpl.java"
click node_components "https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/beans/Components.java"
click node_rabbit_util "https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/utils/RabbitMqUtil.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_rabbit_controller,node_jsp_views,node_visitor toneBlue
class node_user_service,node_user_repository,node_account_model,node_validator,node_security_service,node_mysql toneAmber
class node_memcached,node_cache_util,node_file_system,node_elasticsearch,node_elasticsearch_util,node_rabbitmq,node_producer,node_consumer toneMint
class node_components,node_rabbit_util toneRose
```

## Components

### Web workflows

- [Account controller](https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/controller/UserController.java): `src/main/java/com/visualpathit/account/controller/UserController.java`
- [File upload](https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/controller/FileUploadController.java): `src/main/java/com/visualpathit/account/controller/FileUploadController.java`
- [Search controller](https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/controller/ElasticSearchController.java): `src/main/java/com/visualpathit/account/controller/ElasticSearchController.java`
- [Messaging controller](https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/controller/RabbitMqController.java): `src/main/java/com/visualpathit/account/controller/RabbitMqController.java`
- [JSP views](https://github.com/hkhcoder/vprofile-project/tree/local/src/main/webapp/WEB-INF/views): `src/main/webapp/WEB-INF/views`

### Accounts and security

- [User service](https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/service/UserServiceImpl.java): `src/main/java/com/visualpathit/account/service/UserServiceImpl.java`
- [User repository](https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/repository/UserRepository.java): `src/main/java/com/visualpathit/account/repository/UserRepository.java`
- [User and role model](https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/model/User.java): `src/main/java/com/visualpathit/account/model/User.java`
- [Registration validator](https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/validator/UserValidator.java): `src/main/java/com/visualpathit/account/validator/UserValidator.java`
- [Login service](https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/service/SecurityServiceImpl.java): `src/main/java/com/visualpathit/account/service/SecurityServiceImpl.java`
- **MySQL database**

### Integrations

- **Memcached cache**
- [Cache utility](https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/utils/MemcachedUtils.java): `src/main/java/com/visualpathit/account/utils/MemcachedUtils.java`
- **Uploaded files**
- **Elasticsearch**
- [Search client utility](https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/utils/ElasticsearchUtil.java): `src/main/java/com/visualpathit/account/utils/ElasticsearchUtil.java`
- **RabbitMQ broker**
- [Message producer](https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/service/ProducerServiceImpl.java): `src/main/java/com/visualpathit/account/service/ProducerServiceImpl.java`
- [Message consumer](https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/service/ConsumerServiceImpl.java): `src/main/java/com/visualpathit/account/service/ConsumerServiceImpl.java`

### Runtime configuration

- [Integration settings](https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/beans/Components.java): `src/main/java/com/visualpathit/account/beans/Components.java`
- [Broker settings utility](https://github.com/hkhcoder/vprofile-project/blob/local/src/main/java/com/visualpathit/account/utils/RabbitMqUtil.java): `src/main/java/com/visualpathit/account/utils/RabbitMqUtil.java`

### Other components

- **Browser user**

## Connections

- Browser 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: saves and finds users (evidence: `src/main/java/com/visualpathit/account/controller/UserController.java`)
- Account controller → Login service: autologs in (evidence: `src/main/java/com/visualpathit/account/controller/UserController.java`)
- Account controller → Cache utility: reads and writes cache (evidence: `src/main/java/com/visualpathit/account/controller/UserController.java`)
- Account controller → JSP views: returns view names (evidence: `src/main/java/com/visualpathit/account/controller/UserController.java`)
- User service → User repository: uses repository (evidence: `src/main/java/com/visualpathit/account/service/UserServiceImpl.java`)
- User repository → User and role model: persists entities (evidence: `src/main/java/com/visualpathit/account/repository/UserRepository.java`)
- Registration validator → User and role model: validates user (evidence: `src/main/java/com/visualpathit/account/validator/UserValidator.java`)
- Account controller → File upload
- File upload → User service: updates profile (evidence: `src/main/java/com/visualpathit/account/controller/FileUploadController.java`)
- File upload → Uploaded files: writes uploaded file (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 → Search client utility: creates client (evidence: `src/main/java/com/visualpathit/account/controller/ElasticSearchController.java`)
- Search controller → Elasticsearch: indexes and queries (evidence: `src/main/java/com/visualpathit/account/controller/ElasticSearchController.java`)
- Messaging controller → Broker settings utility: reads broker settings (evidence: `src/main/java/com/visualpathit/account/controller/RabbitMqController.java`)
- Message producer → Broker settings utility: reads broker settings (evidence: `src/main/java/com/visualpathit/account/service/ProducerServiceImpl.java`)
- Integration settings → Search client utility: configures endpoint (evidence: `src/main/java/com/visualpathit/account/utils/ElasticsearchUtil.java`)
- Integration settings → Broker settings utility: provides settings (evidence: `src/main/java/com/visualpathit/account/utils/RabbitMqUtil.java`)
- Message producer → RabbitMQ broker: publishes messages
- Message consumer → RabbitMQ broker: consumes messages
- User repository → MySQL database: database access
- Cache utility → Memcached cache: cache access
