# syadziy/java_boilerplate architecture

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

- Interactive diagram: https://gitdiagram.com/syadziy/java_boilerplate
- Repository: https://github.com/syadziy/java_boilerplate

## Overview

This is a Spring Boot task-management demo service. Its main workflow accepts a task through REST or Kafka, validates/maps it, persists it in PostgreSQL, and uses Redis as a best-effort cache; completion updates the task and projections. Separate insight endpoints provide SQL search, Elasticsearch search, dashboard summaries, and MongoDB audit history. The diagram preserves those documented capabilities and the sampled orchestration layers. Some repository implementations and wiring were not excerpted, so their documented relationships cite the README; unsampled details are not inferred.

Main entry points: [`src/main/java/com/mac/boilerplate/service/impl/TaskServiceImpl.java`](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/service/impl/TaskServiceImpl.java) (Task orchestration), [`src/main/java/com/mac/boilerplate/service/impl/TaskReportingServiceImpl.java`](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/service/impl/TaskReportingServiceImpl.java) (Reporting orchestration), [`src/main/java/com/mac/boilerplate/repository/impl/RedisTaskCacheRepository.java`](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/repository/impl/RedisTaskCacheRepository.java) (Task cache adapter), [`src/main/java/com/mac/boilerplate/service/impl/TaskProjectionSyncServiceImpl.java`](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/service/impl/TaskProjectionSyncServiceImpl.java) (Projection sync)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and ingestion"]
  node_task_api["Task API"]
  node_insights_api["Insights API"]
  node_event_listener["Create listener"]
end

subgraph group_task["Task lifecycle"]
  node_task_service["Task orchestration"]
  node_task_mapper["Task mapping<br/>[TaskMapper.java]"]
  node_task_model["Task model<br/>[Task.java]"]
  node_cleanup["Task cleanup"]
  node_task_properties["Task settings"]
end

subgraph group_insights["Insights and projections"]
  node_projection_sync["Projection sync"]
  node_report_service["Reporting orchestration"]
end

subgraph group_storage["Persistence and cache"]
  node_task_repo["Task repository"]
  node_postgres[("PostgreSQL")]
  node_cache_repo["Task cache adapter"]
  node_redis[("Redis")]
  node_audit_repo["Audit repository"]
  node_mongo[("MongoDB audit")]
  node_index_repo["Search index adapter"]
  node_elasticsearch[("Elasticsearch")]
  node_sql_search["SQL search"]
  node_report_cache["Report cache adapter"]
end

node_rest_user(("REST client"))
node_kafka(("Kafka producer"))

node_rest_user -->|"sends commands"| node_task_api
node_rest_user -->|"requests insights"| node_insights_api
node_kafka -->|"publishes create"| node_event_listener
node_task_api -->|"delegates"| node_task_service
node_event_listener -->|"creates task"| node_task_service
node_task_service -->|"maps request"| node_task_mapper
node_task_service -->|"persists task"| node_task_repo
node_task_service -->|"uses cache"| node_cache_repo
node_task_service -->|"syncs projections"| node_projection_sync
node_task_repo -->|"reads and writes"| node_postgres
node_cache_repo -->|"reads and writes"| node_redis
node_projection_sync -->|"writes audit"| node_audit_repo
node_projection_sync -->|"updates index"| node_index_repo
node_audit_repo -->|"stores documents"| node_mongo
node_index_repo -->|"indexes tasks"| node_elasticsearch
node_insights_api -->|"delegates queries"| node_report_service
node_report_service -->|"searches SQL"| node_sql_search
node_sql_search -->|"queries tasks"| node_postgres
node_report_service -->|"searches index"| node_index_repo
node_report_service -->|"loads audit"| node_audit_repo
node_report_service -->|"caches reports"| node_report_cache
node_report_cache -->|"stores reports"| node_redis
node_cleanup -->|"removes expired"| node_task_repo
node_cleanup -->|"clears cache"| node_cache_repo
node_task_properties -->|"sets cache TTL"| node_cache_repo

click node_task_api "https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/controller/TaskController.java"
click node_insights_api "https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/controller/TaskInsightsController.java"
click node_event_listener "https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/subscriber/TaskEventSubscriber.java"
click node_task_service "https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/service/impl/TaskServiceImpl.java"
click node_task_mapper "https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/entities/mapper/TaskMapper.java"
click node_task_model "https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/entities/model/Task.java"
click node_task_repo "https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/repository/impl/JdbcTaskRepository.java"
click node_cache_repo "https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/repository/impl/RedisTaskCacheRepository.java"
click node_projection_sync "https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/service/impl/TaskProjectionSyncServiceImpl.java"
click node_audit_repo "https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/repository/TaskAuditRepository.java"
click node_index_repo "https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/repository/TaskSearchIndexRepository.java"
click node_report_service "https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/service/impl/TaskReportingServiceImpl.java"
click node_sql_search "https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/repository/impl/JdbcTaskSearchRepository.java"
click node_report_cache "https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/repository/impl/RedisTaskReportCacheRepository.java"
click node_cleanup "https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/job/TaskCleanupJob.java"
click node_task_properties "https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/config/properties/TaskProperties.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_task_api,node_insights_api,node_event_listener,node_rest_user toneBlue
class node_task_service,node_task_mapper,node_task_model,node_cleanup,node_task_properties toneAmber
class node_projection_sync,node_report_service toneMint
class node_task_repo,node_postgres,node_cache_repo,node_redis,node_audit_repo,node_mongo,node_index_repo,node_elasticsearch,node_sql_search,node_report_cache toneRose
class node_kafka toneIndigo
```

## Components

### API and ingestion

- [Task API](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/controller/TaskController.java): `src/main/java/com/mac/boilerplate/controller/TaskController.java`
- [Insights API](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/controller/TaskInsightsController.java): `src/main/java/com/mac/boilerplate/controller/TaskInsightsController.java`
- [Create listener](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/subscriber/TaskEventSubscriber.java): `src/main/java/com/mac/boilerplate/subscriber/TaskEventSubscriber.java`

### Task lifecycle

- [Task orchestration](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/service/impl/TaskServiceImpl.java): `src/main/java/com/mac/boilerplate/service/impl/TaskServiceImpl.java`
- [Task mapping](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/entities/mapper/TaskMapper.java): `src/main/java/com/mac/boilerplate/entities/mapper/TaskMapper.java`
- [Task model](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/entities/model/Task.java): `src/main/java/com/mac/boilerplate/entities/model/Task.java`
- [Task cleanup](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/job/TaskCleanupJob.java): `src/main/java/com/mac/boilerplate/job/TaskCleanupJob.java`
- [Task settings](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/config/properties/TaskProperties.java): `src/main/java/com/mac/boilerplate/config/properties/TaskProperties.java`

### Insights and projections

- [Projection sync](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/service/impl/TaskProjectionSyncServiceImpl.java): `src/main/java/com/mac/boilerplate/service/impl/TaskProjectionSyncServiceImpl.java`
- [Reporting orchestration](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/service/impl/TaskReportingServiceImpl.java): `src/main/java/com/mac/boilerplate/service/impl/TaskReportingServiceImpl.java`

### Persistence and cache

- [Task repository](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/repository/impl/JdbcTaskRepository.java): `src/main/java/com/mac/boilerplate/repository/impl/JdbcTaskRepository.java`
- **PostgreSQL**
- [Task cache adapter](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/repository/impl/RedisTaskCacheRepository.java): `src/main/java/com/mac/boilerplate/repository/impl/RedisTaskCacheRepository.java`
- **Redis**
- [Audit repository](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/repository/TaskAuditRepository.java): `src/main/java/com/mac/boilerplate/repository/TaskAuditRepository.java`
- **MongoDB audit**
- [Search index adapter](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/repository/TaskSearchIndexRepository.java): `src/main/java/com/mac/boilerplate/repository/TaskSearchIndexRepository.java`
- **Elasticsearch**
- [SQL search](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/repository/impl/JdbcTaskSearchRepository.java): `src/main/java/com/mac/boilerplate/repository/impl/JdbcTaskSearchRepository.java`
- [Report cache adapter](https://github.com/syadziy/java_boilerplate/blob/main/src/main/java/com/mac/boilerplate/repository/impl/RedisTaskReportCacheRepository.java): `src/main/java/com/mac/boilerplate/repository/impl/RedisTaskReportCacheRepository.java`

### Other components

- **REST client**
- **Kafka producer**

## Connections

- REST client → Task API: sends commands (evidence: `README.md`)
- REST client → Insights API: requests insights (evidence: `README.md`)
- Kafka producer → Create listener: publishes create (evidence: `README.md`)
- Task API → Task orchestration: delegates (evidence: `src/main/java/com/mac/boilerplate/controller/TaskController.java`)
- Create listener → Task orchestration: creates task (evidence: `README.md`)
- Task orchestration → Task mapping: maps request (evidence: `src/main/java/com/mac/boilerplate/service/impl/TaskServiceImpl.java`)
- Task orchestration → Task repository: persists task (evidence: `src/main/java/com/mac/boilerplate/service/impl/TaskServiceImpl.java`)
- Task orchestration → Task cache adapter: uses cache (evidence: `src/main/java/com/mac/boilerplate/service/impl/TaskServiceImpl.java`)
- Task orchestration → Projection sync: syncs projections (evidence: `src/main/java/com/mac/boilerplate/service/impl/TaskServiceImpl.java`)
- Task repository → PostgreSQL: reads and writes (evidence: `README.md`)
- Task cache adapter → Redis: reads and writes (evidence: `README.md`)
- Projection sync → Audit repository: writes audit (evidence: `src/main/java/com/mac/boilerplate/service/impl/TaskProjectionSyncServiceImpl.java`)
- Projection sync → Search index adapter: updates index (evidence: `src/main/java/com/mac/boilerplate/service/impl/TaskProjectionSyncServiceImpl.java`)
- Audit repository → MongoDB audit: stores documents (evidence: `README.md`)
- Search index adapter → Elasticsearch: indexes tasks (evidence: `README.md`)
- Insights API → Reporting orchestration: delegates queries (evidence: `src/main/java/com/mac/boilerplate/controller/TaskInsightsController.java`)
- Reporting orchestration → SQL search: searches SQL (evidence: `src/main/java/com/mac/boilerplate/service/impl/TaskReportingServiceImpl.java`)
- SQL search → PostgreSQL: queries tasks (evidence: `README.md`)
- Reporting orchestration → Search index adapter: searches index (evidence: `src/main/java/com/mac/boilerplate/service/impl/TaskReportingServiceImpl.java`)
- Reporting orchestration → Audit repository: loads audit (evidence: `src/main/java/com/mac/boilerplate/service/impl/TaskReportingServiceImpl.java`)
- Reporting orchestration → Report cache adapter: caches reports (evidence: `src/main/java/com/mac/boilerplate/service/impl/TaskReportingServiceImpl.java`)
- Report cache adapter → Redis: stores reports (evidence: `README.md`)
- Task cleanup → Task repository: removes expired (evidence: `README.md`)
- Task cleanup → Task cache adapter: clears cache (evidence: `README.md`)
- Task settings → Task cache adapter: sets cache TTL (evidence: `README.md`)
