# selcanagabalayeva/ecohubbac architecture

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

- Interactive diagram: https://gitdiagram.com/selcanagabalayeva/ecohubbac
- Repository: https://github.com/selcanagabalayeva/ecohubbac

## Overview

Ecohub backend provides public project, news, partner, contact, and volunteer endpoints alongside admin management and JWT login. Public callers enter through controllers; sampled news and project flows delegate to services that query repositories and map domain records to response DTOs. The tree also shows partner, contact, volunteer, category, and dashboard capabilities, but their implementations were not sampled; their internal links are therefore omitted. No README description was supplied, so product scope is based on the source tree and excerpts.

Main entry points: [`src/main/java/com/ecohub/ecohubbac/service/impl/NewsServiceImpl.java`](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/service/impl/NewsServiceImpl.java) (News operations), [`src/main/java/com/ecohub/ecohubbac/service/impl/ProjectServiceImpl.java`](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/service/impl/ProjectServiceImpl.java) (Project operations), [`src/main/java/com/ecohub/ecohubbac/controller/dashboard`](https://github.com/selcanagabalayeva/ecohubbac/tree/master/src/main/java/com/ecohub/ecohubbac/controller/dashboard) (Admin management), [`src/main/java/com/ecohub/ecohubbac/controller/AuthController.java`](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/controller/AuthController.java) (Admin login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and security"]
  node_auth["Admin login"]
  node_jwt["JWT utilities<br/>[JwtUtils.java]"]
end

subgraph group_public["Public content"]
  node_news_api["News API"]
  node_news_service["News operations"]
  node_project_api["Project API"]
  node_project_service["Project operations"]
  node_partner_api["Partner API"]
  node_volunteer_api["Volunteer API"]
  node_contact_api["Contact intake"]
end

subgraph group_admin["Administration"]
  node_admin_apis["Admin management"]
  node_news_admin["News admin"]
  node_project_admin["Project admin"]
end

subgraph group_data["Domain and persistence"]
  node_news_store[("News records<br/>[News.java]")]
  node_news_categories[("News categories<br/>[NewsCategory.java]")]
  node_project_store[("Project records<br/>[Project.java]")]
  node_project_categories[("Project categories<br/>[Category.java]")]
  node_news_repo["News repository"]
  node_news_cat_repo["News category repository"]
  node_project_repo["Project repository"]
  node_category_repo["Category repository"]
end

node_visitor(("API caller"))

node_visitor -->|"submits login"| node_auth
node_auth -->|"generates token"| node_jwt
node_visitor -->|"requests news"| node_news_api
node_news_api -->|"delegates queries"| node_news_service
node_news_service -->|"queries and saves"| node_news_repo
node_news_service -->|"loads categories"| node_news_cat_repo
node_news_service -->|"maps records"| node_news_store
node_news_service -->|"maps category data"| node_news_categories
node_visitor -->|"requests projects"| node_project_api
node_project_api -->|"delegates queries"| node_project_service
node_project_service -->|"queries and saves"| node_project_repo
node_project_service -->|"loads categories"| node_category_repo
node_project_service -->|"maps records"| node_project_store
node_project_service -->|"maps category data"| node_project_categories
node_visitor -->|"uses partner API"| node_partner_api
node_visitor -->|"submits application"| node_volunteer_api
node_visitor -.->|"sends message"| node_contact_api
node_visitor -.->|"manages content"| node_admin_apis
node_admin_apis -.->|"includes news"| node_news_admin
node_admin_apis -.->|"includes projects"| node_project_admin
node_news_admin -->|"delegates operations"| node_news_service
node_project_admin -->|"delegates operations"| node_project_service

click node_auth "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/controller/AuthController.java"
click node_jwt "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/security/JwtUtils.java"
click node_news_api "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/controller/NewsController.java"
click node_news_service "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/service/impl/NewsServiceImpl.java"
click node_project_api "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/controller/ProjectController.java"
click node_project_service "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/service/impl/ProjectServiceImpl.java"
click node_partner_api "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/controller/PartnerController.java"
click node_volunteer_api "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/controller/VolunteerController.java"
click node_contact_api "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/controller/ContactController.java"
click node_admin_apis "https://github.com/selcanagabalayeva/ecohubbac/tree/master/src/main/java/com/ecohub/ecohubbac/controller/dashboard"
click node_news_admin "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/controller/dashboard/NewsDashController.java"
click node_project_admin "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/controller/dashboard/ProjectDashController.java"
click node_news_store "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/entity/News.java"
click node_news_categories "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/entity/NewsCategory.java"
click node_project_store "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/entity/Project.java"
click node_project_categories "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/entity/Category.java"
click node_news_repo "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/repository/NewsRepository.java"
click node_news_cat_repo "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/repository/NewsCategoryRepository.java"
click node_project_repo "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/repository/ProjectRepository.java"
click node_category_repo "https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/repository/CategoryRepository.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_auth,node_jwt toneBlue
class node_news_api,node_news_service,node_project_api,node_project_service,node_partner_api,node_volunteer_api,node_contact_api toneAmber
class node_admin_apis,node_news_admin,node_project_admin,node_visitor toneMint
class node_news_store,node_news_categories,node_project_store,node_project_categories,node_news_repo,node_news_cat_repo,node_project_repo,node_category_repo toneRose
```

## Components

### Access and security

- [Admin login](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/controller/AuthController.java): `src/main/java/com/ecohub/ecohubbac/controller/AuthController.java`
- [JWT utilities](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/security/JwtUtils.java): `src/main/java/com/ecohub/ecohubbac/security/JwtUtils.java`

### Public content

- [News API](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/controller/NewsController.java): `src/main/java/com/ecohub/ecohubbac/controller/NewsController.java`
- [News operations](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/service/impl/NewsServiceImpl.java): `src/main/java/com/ecohub/ecohubbac/service/impl/NewsServiceImpl.java`
- [Project API](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/controller/ProjectController.java): `src/main/java/com/ecohub/ecohubbac/controller/ProjectController.java`
- [Project operations](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/service/impl/ProjectServiceImpl.java): `src/main/java/com/ecohub/ecohubbac/service/impl/ProjectServiceImpl.java`
- [Partner API](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/controller/PartnerController.java): `src/main/java/com/ecohub/ecohubbac/controller/PartnerController.java`
- [Volunteer API](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/controller/VolunteerController.java): `src/main/java/com/ecohub/ecohubbac/controller/VolunteerController.java`
- [Contact intake](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/controller/ContactController.java): `src/main/java/com/ecohub/ecohubbac/controller/ContactController.java`

### Administration

- [Admin management](https://github.com/selcanagabalayeva/ecohubbac/tree/master/src/main/java/com/ecohub/ecohubbac/controller/dashboard): `src/main/java/com/ecohub/ecohubbac/controller/dashboard`
- [News admin](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/controller/dashboard/NewsDashController.java): `src/main/java/com/ecohub/ecohubbac/controller/dashboard/NewsDashController.java`
- [Project admin](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/controller/dashboard/ProjectDashController.java): `src/main/java/com/ecohub/ecohubbac/controller/dashboard/ProjectDashController.java`

### Domain and persistence

- [News records](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/entity/News.java): `src/main/java/com/ecohub/ecohubbac/entity/News.java`
- [News categories](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/entity/NewsCategory.java): `src/main/java/com/ecohub/ecohubbac/entity/NewsCategory.java`
- [Project records](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/entity/Project.java): `src/main/java/com/ecohub/ecohubbac/entity/Project.java`
- [Project categories](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/entity/Category.java): `src/main/java/com/ecohub/ecohubbac/entity/Category.java`
- [News repository](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/repository/NewsRepository.java): `src/main/java/com/ecohub/ecohubbac/repository/NewsRepository.java`
- [News category repository](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/repository/NewsCategoryRepository.java): `src/main/java/com/ecohub/ecohubbac/repository/NewsCategoryRepository.java`
- [Project repository](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/repository/ProjectRepository.java): `src/main/java/com/ecohub/ecohubbac/repository/ProjectRepository.java`
- [Category repository](https://github.com/selcanagabalayeva/ecohubbac/blob/master/src/main/java/com/ecohub/ecohubbac/repository/CategoryRepository.java): `src/main/java/com/ecohub/ecohubbac/repository/CategoryRepository.java`

### Other components

- **API caller**

## Connections

- API caller → Admin login: submits login (evidence: `src/main/java/com/ecohub/ecohubbac/controller/AuthController.java`)
- Admin login → JWT utilities: generates token (evidence: `src/main/java/com/ecohub/ecohubbac/controller/AuthController.java`)
- API caller → News API: requests news (evidence: `src/main/java/com/ecohub/ecohubbac/controller/NewsController.java`)
- News API → News operations: delegates queries (evidence: `src/main/java/com/ecohub/ecohubbac/controller/NewsController.java`)
- News operations → News repository: queries and saves (evidence: `src/main/java/com/ecohub/ecohubbac/service/impl/NewsServiceImpl.java`)
- News operations → News category repository: loads categories (evidence: `src/main/java/com/ecohub/ecohubbac/service/impl/NewsServiceImpl.java`)
- News operations → News records: maps records (evidence: `src/main/java/com/ecohub/ecohubbac/service/impl/NewsServiceImpl.java`)
- News operations → News categories: maps category data (evidence: `src/main/java/com/ecohub/ecohubbac/service/impl/NewsServiceImpl.java`)
- API caller → Project API: requests projects (evidence: `src/main/java/com/ecohub/ecohubbac/controller/ProjectController.java`)
- Project API → Project operations: delegates queries (evidence: `src/main/java/com/ecohub/ecohubbac/controller/ProjectController.java`)
- Project operations → Project repository: queries and saves (evidence: `src/main/java/com/ecohub/ecohubbac/service/impl/ProjectServiceImpl.java`)
- Project operations → Category repository: loads categories (evidence: `src/main/java/com/ecohub/ecohubbac/service/impl/ProjectServiceImpl.java`)
- Project operations → Project records: maps records (evidence: `src/main/java/com/ecohub/ecohubbac/service/impl/ProjectServiceImpl.java`)
- Project operations → Project categories: maps category data (evidence: `src/main/java/com/ecohub/ecohubbac/service/impl/ProjectServiceImpl.java`)
- API caller → Partner API: uses partner API (evidence: `src/main/java/com/ecohub/ecohubbac/controller/PartnerController.java`)
- API caller → Volunteer API: submits application (evidence: `src/main/java/com/ecohub/ecohubbac/controller/VolunteerController.java`)
- API caller → Contact intake: sends message
- API caller → Admin management: manages content
- Admin management → News admin: includes news
- Admin management → Project admin: includes projects
- News admin → News operations: delegates operations (evidence: `src/main/java/com/ecohub/ecohubbac/controller/dashboard/NewsDashController.java`)
- Project admin → Project operations: delegates operations (evidence: `src/main/java/com/ecohub/ecohubbac/controller/dashboard/ProjectDashController.java`)
