# easymoneydunker/java-plus-graduation architecture

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

- Interactive diagram: https://gitdiagram.com/easymoneydunker/java-plus-graduation
- Repository: https://github.com/easymoneydunker/java-plus-graduation

## Overview

ExploreWithMe is a microservice application for discovering and organizing events, managing participation, and receiving activity-based recommendations. Its main user workflow is to browse an event, record a view, and retrieve recommendations; event creation/moderation and participation requests form related domain capabilities. The graph includes documented platform services and the statistics/recommendation stages. Several services are represented at their implementation-directory level because their source was not excerpted; their internal links are omitted where evidence does not establish calls.

Main entry points: [`core/event-service/src/main/java/ru/practicum/event/controller/PublicEventController.java`](https://github.com/easymoneydunker/java-plus-graduation/blob/main/core/event-service/src/main/java/ru/practicum/event/controller/PublicEventController.java) (Event endpoints), [`core/event-service/src/main/java/ru/practicum/event/service/EventServiceImpl.java`](https://github.com/easymoneydunker/java-plus-graduation/blob/main/core/event-service/src/main/java/ru/practicum/event/service/EventServiceImpl.java) (Event management), [`core/request-service/src/main/java/ru/practicum/controller/RequestController.java`](https://github.com/easymoneydunker/java-plus-graduation/blob/main/core/request-service/src/main/java/ru/practicum/controller/RequestController.java) (Request endpoints), [`stats/analyzer/src/main/java/ru/practicum`](https://github.com/easymoneydunker/java-plus-graduation/tree/main/stats/analyzer/src/main/java/ru/practicum) (Action analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_event["Event discovery"]
  node_eventapi["Event endpoints"]
  node_eventservice["Event management"]
  node_categories["Categories"]
  node_compilations["Event compilations"]
  node_eventstore[("Event data")]
  node_comments["Event comments"]
  node_contracts["Shared API contracts"]
end

subgraph group_participation["Participation services"]
  node_requestapi["Request endpoints"]
  node_requestservice["Request management"]
  node_requeststore[("Participation data")]
  node_users["User management"]
end

subgraph group_recommendation["Activity recommendations"]
  node_collectorclient["Stats client"]
  node_collector["Action collection"]
  node_aggregator["Similarity aggregation"]
  node_kafka["Kafka messaging<br/>[KafkaClient.java]"]
  node_analyzer["Action analysis"]
  node_actiondata[("User actions")]
  node_similaritydata[("Event similarities")]
  node_recommendations["Recommendation API"]
end

subgraph group_platform["Service platform"]
  node_gateway["API gateway<br/>[GatewayServer.java]"]
  node_config["Configuration server<br/>[ConfigServer.java]"]
  node_discovery["Service discovery"]
end

node_visitor(("User"))
node_postgres[("PostgreSQL")]

node_visitor -.->|"sends requests"| node_gateway
node_gateway -.->|"routes requests"| node_eventapi
node_visitor -->|"browses events"| node_eventapi
node_eventapi -->|"delegates"| node_eventservice
node_eventservice -.->|"queries events"| node_eventstore
node_eventservice -.->|"uses categories"| node_categories
node_eventservice -.->|"supports curation"| node_compilations
node_eventapi -->|"sends view action"| node_collectorclient
node_visitor -.->|"manages requests"| node_requestapi
node_requestapi -->|"delegates"| node_requestservice
node_requestservice -.->|"persists requests"| node_requeststore
node_visitor -.->|"comments on events"| node_comments
node_visitor -.->|"manages account"| node_users
node_collectorclient -.->|"submits activity"| node_collector
node_collector -.->|"publishes actions"| node_kafka
node_aggregator -.->|"publishes similarities"| node_kafka
node_kafka -.->|"delivers messages"| node_analyzer
node_analyzer -.->|"stores actions"| node_actiondata
node_analyzer -.->|"stores similarities"| node_similaritydata
node_recommendations -->|"reads actions"| node_actiondata
node_recommendations -->|"reads similarities"| node_similaritydata
node_eventapi -.->|"requests suggestions"| node_recommendations
node_eventapi -->|"returns event DTOs"| node_contracts
node_requestapi -->|"uses request DTOs"| node_contracts
node_config -.->|"supports services"| node_discovery
node_gateway -.->|"uses discovery"| node_discovery
node_eventstore -.->|"stores data"| node_postgres
node_requeststore -.->|"stores data"| node_postgres

click node_gateway "https://github.com/easymoneydunker/java-plus-graduation/blob/main/infra/gateway-server/src/main/java/ru/practicum/GatewayServer.java"
click node_eventapi "https://github.com/easymoneydunker/java-plus-graduation/blob/main/core/event-service/src/main/java/ru/practicum/event/controller/PublicEventController.java"
click node_eventservice "https://github.com/easymoneydunker/java-plus-graduation/blob/main/core/event-service/src/main/java/ru/practicum/event/service/EventServiceImpl.java"
click node_categories "https://github.com/easymoneydunker/java-plus-graduation/tree/main/core/event-service/src/main/java/ru/practicum/categories"
click node_compilations "https://github.com/easymoneydunker/java-plus-graduation/tree/main/core/event-service/src/main/java/ru/practicum/compilation"
click node_eventstore "https://github.com/easymoneydunker/java-plus-graduation/blob/main/core/event-service/src/main/java/ru/practicum/event/repository/EventRepository.java"
click node_comments "https://github.com/easymoneydunker/java-plus-graduation/tree/main/core/comment-service/src/main/java/ru/practicum"
click node_contracts "https://github.com/easymoneydunker/java-plus-graduation/tree/main/core/interaction-api/src/main/java/ru/practicum/dto"
click node_requestapi "https://github.com/easymoneydunker/java-plus-graduation/blob/main/core/request-service/src/main/java/ru/practicum/controller/RequestController.java"
click node_requestservice "https://github.com/easymoneydunker/java-plus-graduation/blob/main/core/request-service/src/main/java/ru/practicum/service/RequestServiceImpl.java"
click node_requeststore "https://github.com/easymoneydunker/java-plus-graduation/blob/main/core/request-service/src/main/java/ru/practicum/repository/RequestRepository.java"
click node_users "https://github.com/easymoneydunker/java-plus-graduation/tree/main/core/user-service/src/main/java/ru/practicum"
click node_collectorclient "https://github.com/easymoneydunker/java-plus-graduation/blob/main/stats/stats-client/src/main/java/ru/practicum/CollectorClient.java"
click node_collector "https://github.com/easymoneydunker/java-plus-graduation/tree/main/stats/collector/src/main/java/ru/practicum"
click node_aggregator "https://github.com/easymoneydunker/java-plus-graduation/tree/main/stats/aggregator/src/main/java/ru/practicum/service"
click node_kafka "https://github.com/easymoneydunker/java-plus-graduation/blob/main/stats/analyzer/src/main/java/ru/practicum/kafka/KafkaClient.java"
click node_analyzer "https://github.com/easymoneydunker/java-plus-graduation/tree/main/stats/analyzer/src/main/java/ru/practicum"
click node_actiondata "https://github.com/easymoneydunker/java-plus-graduation/blob/main/stats/analyzer/src/main/java/ru/practicum/repository/UserActionRepository.java"
click node_similaritydata "https://github.com/easymoneydunker/java-plus-graduation/blob/main/stats/analyzer/src/main/java/ru/practicum/repository/EventSimilarityRepository.java"
click node_recommendations "https://github.com/easymoneydunker/java-plus-graduation/blob/main/stats/analyzer/src/main/java/ru/practicum/controller/RecommendationsController.java"
click node_config "https://github.com/easymoneydunker/java-plus-graduation/blob/main/infra/config-server/src/main/java/ru/practicum/ConfigServer.java"
click node_discovery "https://github.com/easymoneydunker/java-plus-graduation/blob/main/infra/discovery-server/src/main/java/ru/practicum/DiscoveryServer.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_eventapi,node_eventservice,node_categories,node_compilations,node_eventstore,node_comments,node_contracts,node_visitor toneBlue
class node_requestapi,node_requestservice,node_requeststore,node_users,node_postgres toneAmber
class node_collectorclient,node_collector,node_aggregator,node_kafka,node_analyzer,node_actiondata,node_similaritydata,node_recommendations toneMint
class node_gateway,node_config,node_discovery toneRose
```

## Components

### Event discovery

- [Event endpoints](https://github.com/easymoneydunker/java-plus-graduation/blob/main/core/event-service/src/main/java/ru/practicum/event/controller/PublicEventController.java): `core/event-service/src/main/java/ru/practicum/event/controller/PublicEventController.java`
- [Event management](https://github.com/easymoneydunker/java-plus-graduation/blob/main/core/event-service/src/main/java/ru/practicum/event/service/EventServiceImpl.java): `core/event-service/src/main/java/ru/practicum/event/service/EventServiceImpl.java`
- [Categories](https://github.com/easymoneydunker/java-plus-graduation/tree/main/core/event-service/src/main/java/ru/practicum/categories): `core/event-service/src/main/java/ru/practicum/categories`
- [Event compilations](https://github.com/easymoneydunker/java-plus-graduation/tree/main/core/event-service/src/main/java/ru/practicum/compilation): `core/event-service/src/main/java/ru/practicum/compilation`
- [Event data](https://github.com/easymoneydunker/java-plus-graduation/blob/main/core/event-service/src/main/java/ru/practicum/event/repository/EventRepository.java): `core/event-service/src/main/java/ru/practicum/event/repository/EventRepository.java`
- [Event comments](https://github.com/easymoneydunker/java-plus-graduation/tree/main/core/comment-service/src/main/java/ru/practicum): `core/comment-service/src/main/java/ru/practicum`
- [Shared API contracts](https://github.com/easymoneydunker/java-plus-graduation/tree/main/core/interaction-api/src/main/java/ru/practicum/dto): `core/interaction-api/src/main/java/ru/practicum/dto`

### Participation services

- [Request endpoints](https://github.com/easymoneydunker/java-plus-graduation/blob/main/core/request-service/src/main/java/ru/practicum/controller/RequestController.java): `core/request-service/src/main/java/ru/practicum/controller/RequestController.java`
- [Request management](https://github.com/easymoneydunker/java-plus-graduation/blob/main/core/request-service/src/main/java/ru/practicum/service/RequestServiceImpl.java): `core/request-service/src/main/java/ru/practicum/service/RequestServiceImpl.java`
- [Participation data](https://github.com/easymoneydunker/java-plus-graduation/blob/main/core/request-service/src/main/java/ru/practicum/repository/RequestRepository.java): `core/request-service/src/main/java/ru/practicum/repository/RequestRepository.java`
- [User management](https://github.com/easymoneydunker/java-plus-graduation/tree/main/core/user-service/src/main/java/ru/practicum): `core/user-service/src/main/java/ru/practicum`

### Activity recommendations

- [Stats client](https://github.com/easymoneydunker/java-plus-graduation/blob/main/stats/stats-client/src/main/java/ru/practicum/CollectorClient.java): `stats/stats-client/src/main/java/ru/practicum/CollectorClient.java`
- [Action collection](https://github.com/easymoneydunker/java-plus-graduation/tree/main/stats/collector/src/main/java/ru/practicum): `stats/collector/src/main/java/ru/practicum`
- [Similarity aggregation](https://github.com/easymoneydunker/java-plus-graduation/tree/main/stats/aggregator/src/main/java/ru/practicum/service): `stats/aggregator/src/main/java/ru/practicum/service`
- [Kafka messaging](https://github.com/easymoneydunker/java-plus-graduation/blob/main/stats/analyzer/src/main/java/ru/practicum/kafka/KafkaClient.java): `stats/analyzer/src/main/java/ru/practicum/kafka/KafkaClient.java`
- [Action analysis](https://github.com/easymoneydunker/java-plus-graduation/tree/main/stats/analyzer/src/main/java/ru/practicum): `stats/analyzer/src/main/java/ru/practicum`
- [User actions](https://github.com/easymoneydunker/java-plus-graduation/blob/main/stats/analyzer/src/main/java/ru/practicum/repository/UserActionRepository.java): `stats/analyzer/src/main/java/ru/practicum/repository/UserActionRepository.java`
- [Event similarities](https://github.com/easymoneydunker/java-plus-graduation/blob/main/stats/analyzer/src/main/java/ru/practicum/repository/EventSimilarityRepository.java): `stats/analyzer/src/main/java/ru/practicum/repository/EventSimilarityRepository.java`
- [Recommendation API](https://github.com/easymoneydunker/java-plus-graduation/blob/main/stats/analyzer/src/main/java/ru/practicum/controller/RecommendationsController.java): `stats/analyzer/src/main/java/ru/practicum/controller/RecommendationsController.java`

### Service platform

- [API gateway](https://github.com/easymoneydunker/java-plus-graduation/blob/main/infra/gateway-server/src/main/java/ru/practicum/GatewayServer.java): `infra/gateway-server/src/main/java/ru/practicum/GatewayServer.java`
- [Configuration server](https://github.com/easymoneydunker/java-plus-graduation/blob/main/infra/config-server/src/main/java/ru/practicum/ConfigServer.java): `infra/config-server/src/main/java/ru/practicum/ConfigServer.java`
- [Service discovery](https://github.com/easymoneydunker/java-plus-graduation/blob/main/infra/discovery-server/src/main/java/ru/practicum/DiscoveryServer.java): `infra/discovery-server/src/main/java/ru/practicum/DiscoveryServer.java`

### Other components

- **User**
- **PostgreSQL**

## Connections

- User → API gateway: sends requests
- API gateway → Event endpoints: routes requests
- User → Event endpoints: browses events (evidence: `core/event-service/src/main/java/ru/practicum/event/controller/PublicEventController.java`)
- Event endpoints → Event management: delegates (evidence: `core/event-service/src/main/java/ru/practicum/event/controller/PublicEventController.java`)
- Event management → Event data: queries events
- Event management → Categories: uses categories
- Event management → Event compilations: supports curation
- Event endpoints → Stats client: sends view action (evidence: `core/event-service/src/main/java/ru/practicum/event/controller/PublicEventController.java`)
- User → Request endpoints: manages requests
- Request endpoints → Request management: delegates (evidence: `core/request-service/src/main/java/ru/practicum/controller/RequestController.java`)
- Request management → Participation data: persists requests
- User → Event comments: comments on events
- User → User management: manages account
- Stats client → Action collection: submits activity
- Action collection → Kafka messaging: publishes actions
- Similarity aggregation → Kafka messaging: publishes similarities
- Kafka messaging → Action analysis: delivers messages
- Action analysis → User actions: stores actions (evidence: `stats/analyzer/src/main/java/ru/practicum/handler/RecommendationsHandler.java`)
- Action analysis → Event similarities: stores similarities (evidence: `stats/analyzer/src/main/java/ru/practicum/handler/RecommendationsHandler.java`)
- Recommendation API → User actions: reads actions
- Recommendation API → Event similarities: reads similarities
- Event endpoints → Recommendation API: requests suggestions
- Event endpoints → Shared API contracts: returns event DTOs (evidence: `core/event-service/src/main/java/ru/practicum/event/controller/PublicEventController.java`)
- Request endpoints → Shared API contracts: uses request DTOs (evidence: `core/request-service/src/main/java/ru/practicum/controller/RequestController.java`)
- Configuration server → Service discovery: supports services
- API gateway → Service discovery: uses discovery
- Event data → PostgreSQL: stores data
- Participation data → PostgreSQL: stores data
