# monika-kompal/task-queue architecture

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

- Interactive diagram: https://gitdiagram.com/monika-kompal/task-queue
- Repository: https://github.com/monika-kompal/task-queue

## Overview

Task Queue is a job-scheduling service: clients submit jobs through an HTTP API, which persists them and publishes work for asynchronous processing; clients can query job status. The worker updates job state and sends failed work to a dead-letter topic. Shared DTOs and job types/statuses define the API and event vocabulary. The README excerpt only documents PVC cleanup, so broader deployment and monitoring capabilities are not established here. Edges reflect shown calls or source-index references; unverified Kafka consumption is dashed.

Main entry points: [`job-worker/src/main/java/com/monika/job_worker/processor/JobProcessor.java`](https://github.com/monika-kompal/task-queue/blob/main/job-worker/src/main/java/com/monika/job_worker/processor/JobProcessor.java) (Job processor), [`job-api/src/main/java/com/monika/job_api/service/JobService.java`](https://github.com/monika-kompal/task-queue/blob/main/job-api/src/main/java/com/monika/job_api/service/JobService.java) (Job service), [`job-api/src/main/java/com/monika/job_api/controller/JobController.java`](https://github.com/monika-kompal/task-queue/blob/main/job-api/src/main/java/com/monika/job_api/controller/JobController.java) (Job controller), [`job-api/src/main/java/com/monika/job_api/service/JobProducer.java`](https://github.com/monika-kompal/task-queue/blob/main/job-api/src/main/java/com/monika/job_api/service/JobProducer.java) (Job producer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Job API"]
  node_controller["Job controller<br/>[JobController.java]"]
  node_service["Job service<br/>[JobService.java]"]
  node_api_repo["API repository<br/>[JobRepository.java]"]
  node_producer["Job producer<br/>[JobProducer.java]"]
end

subgraph group_contracts["Shared Contracts"]
  node_request["Job request<br/>[JobRequest.java]"]
  node_response["Job response<br/>[JobResponse.java]"]
  node_event["Job event<br/>[JobEvent.java]"]
  node_job["Job entity<br/>[Job.java]"]
  node_enums["Job enums"]
end

subgraph group_worker["Job Worker"]
  node_consumer["Job consumer<br/>[JobConsumer.java]"]
  node_processor["Job processor<br/>[JobProcessor.java]"]
  node_worker_repo["Worker repository<br/>[JobRepository.java]"]
  node_dlq_consumer["DLQ consumer<br/>[DlqConsumer.java]"]
  node_async_config["Async config<br/>[AsyncConfig.java]"]
end

subgraph group_messaging["Messaging"]
  node_broker["Kafka broker"]
  node_topic_config["Kafka topic config"]
end

node_client(("API client"))

node_client -->|"submits or queries"| node_controller
node_controller -->|"calls"| node_service
node_controller -->|"accepts"| node_request
node_service -->|"returns"| node_response
node_service -->|"saves and reads"| node_api_repo
node_service -->|"publishes event"| node_producer
node_service -->|"creates"| node_event
node_api_repo -->|"stores"| node_job
node_producer -.->|"publishes"| node_broker
node_producer -->|"sends"| node_event
node_broker -.->|"delivers jobs"| node_consumer
node_consumer -->|"dispatches"| node_processor
node_processor -->|"reads and updates"| node_worker_repo
node_worker_repo -->|"stores"| node_job
node_processor -->|"processes"| node_event
node_processor -->|"sends failed jobs"| node_broker
node_broker -.->|"delivers dead letters"| node_dlq_consumer
node_dlq_consumer -.->|"references processor"| node_processor
node_topic_config -.->|"configures topics"| node_broker
node_async_config -.->|"configures execution"| node_processor

click node_controller "https://github.com/monika-kompal/task-queue/blob/main/job-api/src/main/java/com/monika/job_api/controller/JobController.java"
click node_service "https://github.com/monika-kompal/task-queue/blob/main/job-api/src/main/java/com/monika/job_api/service/JobService.java"
click node_api_repo "https://github.com/monika-kompal/task-queue/blob/main/job-api/src/main/java/com/monika/job_api/repository/JobRepository.java"
click node_producer "https://github.com/monika-kompal/task-queue/blob/main/job-api/src/main/java/com/monika/job_api/service/JobProducer.java"
click node_request "https://github.com/monika-kompal/task-queue/blob/main/job-common/src/main/java/com/monika/dto/JobRequest.java"
click node_response "https://github.com/monika-kompal/task-queue/blob/main/job-common/src/main/java/com/monika/dto/JobResponse.java"
click node_event "https://github.com/monika-kompal/task-queue/blob/main/job-common/src/main/java/com/monika/dto/JobEvent.java"
click node_job "https://github.com/monika-kompal/task-queue/blob/main/job-common/src/main/java/com/monika/entity/Job.java"
click node_enums "https://github.com/monika-kompal/task-queue/tree/main/job-common/src/main/java/com/monika/enums"
click node_consumer "https://github.com/monika-kompal/task-queue/blob/main/job-worker/src/main/java/com/monika/job_worker/service/JobConsumer.java"
click node_processor "https://github.com/monika-kompal/task-queue/blob/main/job-worker/src/main/java/com/monika/job_worker/processor/JobProcessor.java"
click node_worker_repo "https://github.com/monika-kompal/task-queue/blob/main/job-worker/src/main/java/com/monika/job_worker/repository/JobRepository.java"
click node_dlq_consumer "https://github.com/monika-kompal/task-queue/blob/main/job-worker/src/main/java/com/monika/job_worker/service/DlqConsumer.java"
click node_topic_config "https://github.com/monika-kompal/task-queue/blob/main/job-api/src/main/java/com/monika/job_api/config/KafkaTopicConfig.java"
click node_async_config "https://github.com/monika-kompal/task-queue/blob/main/job-worker/src/main/java/com/monika/job_worker/config/AsyncConfig.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_controller,node_service,node_api_repo,node_producer,node_client toneBlue
class node_request,node_response,node_event,node_job,node_enums toneAmber
class node_consumer,node_processor,node_worker_repo,node_dlq_consumer,node_async_config toneMint
class node_broker,node_topic_config toneRose
```

## Components

### Job API

- [Job controller](https://github.com/monika-kompal/task-queue/blob/main/job-api/src/main/java/com/monika/job_api/controller/JobController.java): `job-api/src/main/java/com/monika/job_api/controller/JobController.java`
- [Job service](https://github.com/monika-kompal/task-queue/blob/main/job-api/src/main/java/com/monika/job_api/service/JobService.java): `job-api/src/main/java/com/monika/job_api/service/JobService.java`
- [API repository](https://github.com/monika-kompal/task-queue/blob/main/job-api/src/main/java/com/monika/job_api/repository/JobRepository.java): `job-api/src/main/java/com/monika/job_api/repository/JobRepository.java`
- [Job producer](https://github.com/monika-kompal/task-queue/blob/main/job-api/src/main/java/com/monika/job_api/service/JobProducer.java): `job-api/src/main/java/com/monika/job_api/service/JobProducer.java`

### Shared Contracts

- [Job request](https://github.com/monika-kompal/task-queue/blob/main/job-common/src/main/java/com/monika/dto/JobRequest.java): `job-common/src/main/java/com/monika/dto/JobRequest.java`
- [Job response](https://github.com/monika-kompal/task-queue/blob/main/job-common/src/main/java/com/monika/dto/JobResponse.java): `job-common/src/main/java/com/monika/dto/JobResponse.java`
- [Job event](https://github.com/monika-kompal/task-queue/blob/main/job-common/src/main/java/com/monika/dto/JobEvent.java): `job-common/src/main/java/com/monika/dto/JobEvent.java`
- [Job entity](https://github.com/monika-kompal/task-queue/blob/main/job-common/src/main/java/com/monika/entity/Job.java): `job-common/src/main/java/com/monika/entity/Job.java`
- [Job enums](https://github.com/monika-kompal/task-queue/tree/main/job-common/src/main/java/com/monika/enums): `job-common/src/main/java/com/monika/enums`

### Job Worker

- [Job consumer](https://github.com/monika-kompal/task-queue/blob/main/job-worker/src/main/java/com/monika/job_worker/service/JobConsumer.java): `job-worker/src/main/java/com/monika/job_worker/service/JobConsumer.java`
- [Job processor](https://github.com/monika-kompal/task-queue/blob/main/job-worker/src/main/java/com/monika/job_worker/processor/JobProcessor.java): `job-worker/src/main/java/com/monika/job_worker/processor/JobProcessor.java`
- [Worker repository](https://github.com/monika-kompal/task-queue/blob/main/job-worker/src/main/java/com/monika/job_worker/repository/JobRepository.java): `job-worker/src/main/java/com/monika/job_worker/repository/JobRepository.java`
- [DLQ consumer](https://github.com/monika-kompal/task-queue/blob/main/job-worker/src/main/java/com/monika/job_worker/service/DlqConsumer.java): `job-worker/src/main/java/com/monika/job_worker/service/DlqConsumer.java`
- [Async config](https://github.com/monika-kompal/task-queue/blob/main/job-worker/src/main/java/com/monika/job_worker/config/AsyncConfig.java): `job-worker/src/main/java/com/monika/job_worker/config/AsyncConfig.java`

### Messaging

- **Kafka broker**
- [Kafka topic config](https://github.com/monika-kompal/task-queue/blob/main/job-api/src/main/java/com/monika/job_api/config/KafkaTopicConfig.java): `job-api/src/main/java/com/monika/job_api/config/KafkaTopicConfig.java`

### Other components

- **API client**

## Connections

- API client → Job controller: submits or queries (evidence: `job-api/src/main/java/com/monika/job_api/controller/JobController.java`)
- Job controller → Job service: calls (evidence: `job-api/src/main/java/com/monika/job_api/controller/JobController.java`)
- Job controller → Job request: accepts (evidence: `job-api/src/main/java/com/monika/job_api/controller/JobController.java`)
- Job service → Job response: returns (evidence: `job-api/src/main/java/com/monika/job_api/service/JobService.java`)
- Job service → API repository: saves and reads (evidence: `job-api/src/main/java/com/monika/job_api/service/JobService.java`)
- Job service → Job producer: publishes event (evidence: `job-api/src/main/java/com/monika/job_api/service/JobService.java`)
- Job service → Job event: creates (evidence: `job-api/src/main/java/com/monika/job_api/service/JobService.java`)
- API repository → Job entity: stores (evidence: `job-api/src/main/java/com/monika/job_api/repository/JobRepository.java`)
- Job producer → Kafka broker: publishes
- Job producer → Job event: sends (evidence: `job-api/src/main/java/com/monika/job_api/service/JobProducer.java`)
- Kafka broker → Job consumer: delivers jobs
- Job consumer → Job processor: dispatches (evidence: `job-worker/src/main/java/com/monika/job_worker/service/JobConsumer.java`)
- Job processor → Worker repository: reads and updates (evidence: `job-worker/src/main/java/com/monika/job_worker/processor/JobProcessor.java`)
- Worker repository → Job entity: stores (evidence: `job-worker/src/main/java/com/monika/job_worker/repository/JobRepository.java`)
- Job processor → Job event: processes (evidence: `job-worker/src/main/java/com/monika/job_worker/processor/JobProcessor.java`)
- Job processor → Kafka broker: sends failed jobs (evidence: `job-worker/src/main/java/com/monika/job_worker/processor/JobProcessor.java`)
- Kafka broker → DLQ consumer: delivers dead letters
- DLQ consumer → Job processor: references processor (evidence: `job-worker/src/main/java/com/monika/job_worker/service/DlqConsumer.java`)
- Kafka topic config → Kafka broker: configures topics
- Async config → Job processor: configures execution
