# ivanzoizi/keenay-education architecture

> Architecture diagram of the GitHub repository ivanzoizi/keenay-education, 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/ivanzoizi/keenay-education
- Repository: https://github.com/ivanzoizi/keenay-education

## Overview

This Java application appears to support a pet-services marketplace: users can create tasks and advertisements, respond to advertisements, and manage related profiles and services. The principal workflow is an authenticated HTTP request into a controller implementation and its service layer; tasks and advertisements are distinct domain stages, with responses forming a separate capability. The tree also shows chat, support, email, image, and caching subsystems. Evidence is limited: the README is empty and only selected sources were excerpted, so unverified subsystem links are omitted or marked dashed.

Main entry points: [`src/main/java/keenay/education/controllers/http`](https://github.com/ivanzoizi/keenay-education/tree/master/src/main/java/keenay/education/controllers/http) (HTTP API), [`src/main/java/keenay/education/service/TaskService.java`](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/TaskService.java) (Task service), [`src/main/java/keenay/education/service/email/EmailCreateApplicationService.java`](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/email/EmailCreateApplicationService.java) (Email requests), [`src/main/java/keenay/education/service/email/EmailListenerService.java`](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/email/EmailListenerService.java) (Email delivery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_identityservice["Registration and login<br/>[UserService.java]"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_security["Security configuration"]
end

subgraph group_marketplace["Marketplace workflow"]
  node_http["HTTP API"]
  node_taskapi["Task endpoints"]
  node_taskhandler["Task handler"]
  node_taskservice["Task service<br/>[TaskService.java]"]
  node_taskdata["Task records<br/>[Tasks.java]"]
  node_ads["Advertisements"]
  node_responses["Ad responses"]
  node_pets["Pet profiles<br/>[PetsService.java]"]
  node_skills["Skills<br/>[SkillsService.java]"]
end

subgraph group_community["Communication and support"]
  node_chat["Chat and messages<br/>[ChatService.java]"]
  node_support["Support tickets"]
  node_emailcreate["Email requests"]
  node_emailworker["Email delivery"]
  node_emailstore[("Email records")]
end

subgraph group_infrastructure["Runtime integrations"]
  node_rabbit["RabbitMQ"]
  node_images["Image storage<br/>[ImageService.java]"]
  node_cache[("Tarantool cache")]
  node_jpa[("JPA persistence")]
end

node_user(("User"))

node_user -->|"submits request"| node_taskapi
node_taskapi -->|"routes to"| node_taskhandler
node_taskhandler -->|"invokes"| node_taskservice
node_taskservice -->|"uses task model"| node_taskdata
node_taskservice -.->|"links advertisement"| node_ads
node_user -.->|"uses API"| node_http
node_http -.->|"routes marketplace actions"| node_ads
node_http -.->|"routes response actions"| node_responses
node_http -.->|"routes pet actions"| node_pets
node_http -.->|"routes skill actions"| node_skills
node_user -.->|"registers or signs in"| node_identityservice
node_identityservice -.->|"issues token"| node_jwt
node_security -.->|"validates tokens"| node_jwt
node_http -.->|"routes chat actions"| node_chat
node_http -.->|"routes support actions"| node_support
node_emailcreate -->|"saves email record"| node_emailstore
node_emailcreate -->|"queues email"| node_rabbit
node_emailworker -->|"consumes and retries"| node_rabbit
node_emailworker -->|"updates delivery status"| node_emailstore
node_cache -.->|"backs user features"| node_jpa
node_http -.->|"uploads images"| node_images

click node_http "https://github.com/ivanzoizi/keenay-education/tree/master/src/main/java/keenay/education/controllers/http"
click node_taskapi "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/controllers/http/TaskController.java"
click node_taskhandler "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/controllers/http/impl/TasksControllerImpl.java"
click node_taskservice "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/TaskService.java"
click node_taskdata "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/entity/Tasks.java"
click node_ads "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/AdvertisementService.java"
click node_responses "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/AdvertisementResponseService.java"
click node_pets "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/PetsService.java"
click node_skills "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/SkillsService.java"
click node_identityservice "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/UserService.java"
click node_jwt "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/security/jwt/JwtService.java"
click node_security "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/config/SecurityConfig.java"
click node_chat "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/ChatService.java"
click node_support "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/SupportService.java"
click node_emailcreate "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/email/EmailCreateApplicationService.java"
click node_emailworker "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/email/EmailListenerService.java"
click node_emailstore "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/repository/jpa/EmailsUserRepository.java"
click node_rabbit "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/config/RabbitMqConfig.java"
click node_images "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/image/ImageService.java"
click node_cache "https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/cache/TarantoolCacheManager.java"
click node_jpa "https://github.com/ivanzoizi/keenay-education/tree/master/src/main/java/keenay/education/repository/jpa"

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_identityservice,node_jwt,node_security,node_user toneBlue
class node_http,node_taskapi,node_taskhandler,node_taskservice,node_taskdata,node_ads,node_responses,node_pets,node_skills toneAmber
class node_chat,node_support,node_emailcreate,node_emailworker,node_emailstore toneMint
class node_rabbit,node_images,node_cache,node_jpa toneRose
```

## Components

### Identity and access

- [Registration and login](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/UserService.java): `src/main/java/keenay/education/service/UserService.java`
- [JWT service](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/security/jwt/JwtService.java): `src/main/java/keenay/education/security/jwt/JwtService.java`
- [Security configuration](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/config/SecurityConfig.java): `src/main/java/keenay/education/config/SecurityConfig.java`

### Marketplace workflow

- [HTTP API](https://github.com/ivanzoizi/keenay-education/tree/master/src/main/java/keenay/education/controllers/http): `src/main/java/keenay/education/controllers/http`
- [Task endpoints](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/controllers/http/TaskController.java): `src/main/java/keenay/education/controllers/http/TaskController.java`
- [Task handler](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/controllers/http/impl/TasksControllerImpl.java): `src/main/java/keenay/education/controllers/http/impl/TasksControllerImpl.java`
- [Task service](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/TaskService.java): `src/main/java/keenay/education/service/TaskService.java`
- [Task records](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/entity/Tasks.java): `src/main/java/keenay/education/entity/Tasks.java`
- [Advertisements](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/AdvertisementService.java): `src/main/java/keenay/education/service/AdvertisementService.java`
- [Ad responses](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/AdvertisementResponseService.java): `src/main/java/keenay/education/service/AdvertisementResponseService.java`
- [Pet profiles](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/PetsService.java): `src/main/java/keenay/education/service/PetsService.java`
- [Skills](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/SkillsService.java): `src/main/java/keenay/education/service/SkillsService.java`

### Communication and support

- [Chat and messages](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/ChatService.java): `src/main/java/keenay/education/service/ChatService.java`
- [Support tickets](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/SupportService.java): `src/main/java/keenay/education/service/SupportService.java`
- [Email requests](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/email/EmailCreateApplicationService.java): `src/main/java/keenay/education/service/email/EmailCreateApplicationService.java`
- [Email delivery](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/email/EmailListenerService.java): `src/main/java/keenay/education/service/email/EmailListenerService.java`
- [Email records](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/repository/jpa/EmailsUserRepository.java): `src/main/java/keenay/education/repository/jpa/EmailsUserRepository.java`

### Runtime integrations

- [RabbitMQ](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/config/RabbitMqConfig.java): `src/main/java/keenay/education/config/RabbitMqConfig.java`
- [Image storage](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/service/image/ImageService.java): `src/main/java/keenay/education/service/image/ImageService.java`
- [Tarantool cache](https://github.com/ivanzoizi/keenay-education/blob/master/src/main/java/keenay/education/cache/TarantoolCacheManager.java): `src/main/java/keenay/education/cache/TarantoolCacheManager.java`
- [JPA persistence](https://github.com/ivanzoizi/keenay-education/tree/master/src/main/java/keenay/education/repository/jpa): `src/main/java/keenay/education/repository/jpa`

### Other components

- **User**

## Connections

- User → Task endpoints: submits request (evidence: `src/main/java/keenay/education/controllers/http/TaskController.java`)
- Task endpoints → Task handler: routes to (evidence: `src/main/java/keenay/education/controllers/http/impl/TasksControllerImpl.java`)
- Task handler → Task service: invokes (evidence: `src/main/java/keenay/education/controllers/http/impl/TasksControllerImpl.java`)
- Task service → Task records: uses task model (evidence: `src/main/java/keenay/education/service/TaskService.java`)
- Task service → Advertisements: links advertisement
- User → HTTP API: uses API
- HTTP API → Advertisements: routes marketplace actions (evidence: `src/main/java/keenay/education/controllers/http/impl/AdvertisementControllerImpl.java`)
- HTTP API → Ad responses: routes response actions (evidence: `src/main/java/keenay/education/controllers/http/impl/AdvertisementResponseControllerImpl.java`)
- HTTP API → Pet profiles: routes pet actions
- HTTP API → Skills: routes skill actions
- User → Registration and login: registers or signs in
- Registration and login → JWT service: issues token
- Security configuration → JWT service: validates tokens
- HTTP API → Chat and messages: routes chat actions
- HTTP API → Support tickets: routes support actions
- Email requests → Email records: saves email record (evidence: `src/main/java/keenay/education/service/email/EmailCreateApplicationService.java`)
- Email requests → RabbitMQ: queues email (evidence: `src/main/java/keenay/education/service/email/EmailCreateApplicationService.java`)
- Email delivery → RabbitMQ: consumes and retries (evidence: `src/main/java/keenay/education/service/email/EmailListenerService.java`)
- Email delivery → Email records: updates delivery status (evidence: `src/main/java/keenay/education/service/email/EmailListenerService.java`)
- Tarantool cache → JPA persistence: backs user features
- HTTP API → Image storage: uploads images
