How syadziy/java_boilerplate works
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: TaskServiceImpl.java Task orchestration · TaskReportingServiceImpl.java Reporting orchestration · RedisTaskCacheRepository.java Task cache adapter · TaskProjectionSyncServiceImpl.java Projection sync
Components 22
API and ingestion
- Task API
src/main/java/com/mac/boilerplate/controller/TaskController.java - Insights API
src/main/java/com/mac/boilerplate/controller/TaskInsightsController.java - Create listener
src/main/java/com/mac/boilerplate/subscriber/TaskEventSubscriber.java
Task lifecycle
- Task orchestration
src/main/java/com/mac/boilerplate/service/impl/TaskServiceImpl.java - Task mapping
src/main/java/com/mac/boilerplate/entities/mapper/TaskMapper.java - Task model
src/main/java/com/mac/boilerplate/entities/model/Task.java - Task cleanup
src/main/java/com/mac/boilerplate/job/TaskCleanupJob.java - Task settings
src/main/java/com/mac/boilerplate/config/properties/TaskProperties.java
Insights and projections
- Projection sync
src/main/java/com/mac/boilerplate/service/impl/TaskProjectionSyncServiceImpl.java - Reporting orchestration
src/main/java/com/mac/boilerplate/service/impl/TaskReportingServiceImpl.java
Persistence and cache
- Task repository
src/main/java/com/mac/boilerplate/repository/impl/JdbcTaskRepository.java - PostgreSQL
- Task cache adapter
src/main/java/com/mac/boilerplate/repository/impl/RedisTaskCacheRepository.java - Redis
- Audit repository
src/main/java/com/mac/boilerplate/repository/TaskAuditRepository.java - MongoDB audit
- Search index adapter
src/main/java/com/mac/boilerplate/repository/TaskSearchIndexRepository.java - Elasticsearch
- SQL search
src/main/java/com/mac/boilerplate/repository/impl/JdbcTaskSearchRepository.java - Report cache adapter
src/main/java/com/mac/boilerplate/repository/impl/RedisTaskReportCacheRepository.java
Other components
- REST client
- Kafka producer
Connections 25
- REST client → Task API: sends commands
README.md - REST client → Insights API: requests insights
README.md - Kafka producer → Create listener: publishes create
README.md - Task API → Task orchestration: delegates
src/main/java/com/mac/boilerplate/controller/TaskController.java - Create listener → Task orchestration: creates task
README.md - Task orchestration → Task mapping: maps request
src/main/java/com/mac/boilerplate/service/impl/TaskServiceImpl.java - Task orchestration → Task repository: persists task
src/main/java/com/mac/boilerplate/service/impl/TaskServiceImpl.java - Task orchestration → Task cache adapter: uses cache
src/main/java/com/mac/boilerplate/service/impl/TaskServiceImpl.java - Task orchestration → Projection sync: syncs projections
src/main/java/com/mac/boilerplate/service/impl/TaskServiceImpl.java - Task repository → PostgreSQL: reads and writes
README.md - Task cache adapter → Redis: reads and writes
README.md - Projection sync → Audit repository: writes audit
src/main/java/com/mac/boilerplate/service/impl/TaskProjectionSyncServiceImpl.java - Projection sync → Search index adapter: updates index
src/main/java/com/mac/boilerplate/service/impl/TaskProjectionSyncServiceImpl.java - Audit repository → MongoDB audit: stores documents
README.md - Search index adapter → Elasticsearch: indexes tasks
README.md - Insights API → Reporting orchestration: delegates queries
src/main/java/com/mac/boilerplate/controller/TaskInsightsController.java - Reporting orchestration → SQL search: searches SQL
src/main/java/com/mac/boilerplate/service/impl/TaskReportingServiceImpl.java - SQL search → PostgreSQL: queries tasks
README.md - Reporting orchestration → Search index adapter: searches index
src/main/java/com/mac/boilerplate/service/impl/TaskReportingServiceImpl.java - Reporting orchestration → Audit repository: loads audit
src/main/java/com/mac/boilerplate/service/impl/TaskReportingServiceImpl.java - Reporting orchestration → Report cache adapter: caches reports
src/main/java/com/mac/boilerplate/service/impl/TaskReportingServiceImpl.java - Report cache adapter → Redis: stores reports
README.md - Task cleanup → Task repository: removes expired
README.md - Task cleanup → Task cache adapter: clears cache
README.md - Task settings → Task cache adapter: sets cache TTL
README.md