# thepowermisha/task-service architecture

> Architecture diagram of the GitHub repository thepowermisha/task-service, 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/thepowermisha/task-service
- Repository: https://github.com/thepowermisha/task-service

## Overview

Task Service exposes a REST API for task and user management. The main task workflow runs from HTTP requests through TaskController and TaskService, which validates relationships, persists changes, maps results to DTOs, and publishes creation or assignment events. UserService handles user lookup and creation separately. PostgreSQL is the documented data store and Kafka receives task events. Some connections are supported by the source index or README rather than full excerpts, so the graph avoids inferring unshown call details.

Main entry points: [`src/main/java/com/tpm/task_service/service/TaskService.java`](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/service/TaskService.java) (Task Service), [`src/main/java/com/tpm/task_service/controller/TaskController.java`](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/controller/TaskController.java) (Task Controller), [`src/main/java/com/tpm/task_service/service/UserService.java`](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/service/UserService.java) (User Service), [`src/main/java/com/tpm/task_service/mapper/TaskMapper.java`](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/mapper/TaskMapper.java) (Task Mapper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_task_controller["Task Controller"]
  node_user_controller["User Controller"]
  node_error_handler["Exception Handler"]
  node_response_dto["Response DTO<br/>[ResponseDto.java]"]
end

subgraph group_domain["Task And User Domain"]
  node_task_service["Task Service<br/>[TaskService.java]"]
  node_user_service["User Service<br/>[UserService.java]"]
  node_task_mapper["Task Mapper<br/>[TaskMapper.java]"]
  node_user_mapper["User Mapper<br/>[UserMapper.java]"]
  node_task_contracts["Task DTOs"]
  node_user_contracts["User DTOs"]
  node_task_status["Task Status<br/>[TaskStatus.java]"]
end

subgraph group_persistence["Persistence"]
  node_task_entity["Task Entity<br/>[Task.java]"]
  node_user_entity["User Entity<br/>[User.java]"]
  node_task_repository["Task Repository"]
  node_user_repository["User Repository"]
  node_postgres[("PostgreSQL")]
  node_schema["Liquibase Schema"]
end

subgraph group_events["Event Delivery"]
  node_event_producer["Task Event Producer"]
  node_kafka_config["Kafka Configuration<br/>[KafkaConfig.java]"]
  node_topic_properties["Topic Properties"]
  node_kafka["Kafka"]
end

node_client(("API Client"))

node_client -->|"sends requests"| node_task_controller
node_task_controller -->|"delegates to"| node_task_service
node_user_controller -->|"delegates to"| node_user_service
node_task_controller -->|"wraps results"| node_response_dto
node_error_handler -->|"returns errors"| node_response_dto
node_task_service -->|"reads and saves"| node_task_repository
node_task_service -->|"looks up users"| node_user_repository
node_task_service -->|"maps results"| node_task_mapper
node_user_service -->|"reads and saves"| node_user_repository
node_user_service -->|"maps results"| node_user_mapper
node_task_mapper -->|"maps entity"| node_task_entity
node_task_mapper -->|"builds DTO"| node_task_contracts
node_user_mapper -->|"maps entity"| node_user_entity
node_user_mapper -->|"builds DTO"| node_user_contracts
node_task_repository -->|"persists tasks"| node_postgres
node_user_repository -->|"persists users"| node_postgres
node_schema -.->|"defines schema"| node_postgres
node_task_entity -->|"references assignee"| node_user_entity
node_task_service -->|"sets status"| node_task_status
node_task_service -->|"publishes events"| node_event_producer
node_event_producer -->|"sends events"| node_kafka
node_event_producer -->|"uses topics"| node_topic_properties
node_kafka_config -->|"configures topics"| node_topic_properties

click node_task_controller "https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/controller/TaskController.java"
click node_user_controller "https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/controller/UserController.java"
click node_error_handler "https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/controller/GlobalExceptionHandler.java"
click node_response_dto "https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/dto/ResponseDto.java"
click node_task_service "https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/service/TaskService.java"
click node_user_service "https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/service/UserService.java"
click node_task_mapper "https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/mapper/TaskMapper.java"
click node_user_mapper "https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/mapper/UserMapper.java"
click node_task_contracts "https://github.com/thepowermisha/task-service/tree/master/src/main/java/com/tpm/task_service/dto"
click node_user_contracts "https://github.com/thepowermisha/task-service/tree/master/src/main/java/com/tpm/task_service/dto"
click node_task_entity "https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/entity/Task.java"
click node_user_entity "https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/entity/User.java"
click node_task_repository "https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/repository/TaskRepository.java"
click node_user_repository "https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/repository/UserRepository.java"
click node_schema "https://github.com/thepowermisha/task-service/tree/master/src/main/resources/db/changelog"
click node_task_status "https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/type/TaskStatus.java"
click node_event_producer "https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/event/producer/TaskEventProducer.java"
click node_kafka_config "https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/config/KafkaConfig.java"
click node_topic_properties "https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/config/KafkaTopicsProperties.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_controller,node_user_controller,node_error_handler,node_response_dto,node_client toneBlue
class node_task_service,node_user_service,node_task_mapper,node_user_mapper,node_task_contracts,node_user_contracts,node_task_status toneAmber
class node_task_entity,node_user_entity,node_task_repository,node_user_repository,node_postgres,node_schema toneMint
class node_event_producer,node_kafka_config,node_topic_properties,node_kafka toneRose
```

## Components

### REST API

- [Task Controller](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/controller/TaskController.java): `src/main/java/com/tpm/task_service/controller/TaskController.java`
- [User Controller](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/controller/UserController.java): `src/main/java/com/tpm/task_service/controller/UserController.java`
- [Exception Handler](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/controller/GlobalExceptionHandler.java): `src/main/java/com/tpm/task_service/controller/GlobalExceptionHandler.java`
- [Response DTO](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/dto/ResponseDto.java): `src/main/java/com/tpm/task_service/dto/ResponseDto.java`

### Task And User Domain

- [Task Service](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/service/TaskService.java): `src/main/java/com/tpm/task_service/service/TaskService.java`
- [User Service](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/service/UserService.java): `src/main/java/com/tpm/task_service/service/UserService.java`
- [Task Mapper](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/mapper/TaskMapper.java): `src/main/java/com/tpm/task_service/mapper/TaskMapper.java`
- [User Mapper](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/mapper/UserMapper.java): `src/main/java/com/tpm/task_service/mapper/UserMapper.java`
- [Task DTOs](https://github.com/thepowermisha/task-service/tree/master/src/main/java/com/tpm/task_service/dto): `src/main/java/com/tpm/task_service/dto`
- [User DTOs](https://github.com/thepowermisha/task-service/tree/master/src/main/java/com/tpm/task_service/dto): `src/main/java/com/tpm/task_service/dto`
- [Task Status](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/type/TaskStatus.java): `src/main/java/com/tpm/task_service/type/TaskStatus.java`

### Persistence

- [Task Entity](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/entity/Task.java): `src/main/java/com/tpm/task_service/entity/Task.java`
- [User Entity](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/entity/User.java): `src/main/java/com/tpm/task_service/entity/User.java`
- [Task Repository](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/repository/TaskRepository.java): `src/main/java/com/tpm/task_service/repository/TaskRepository.java`
- [User Repository](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/repository/UserRepository.java): `src/main/java/com/tpm/task_service/repository/UserRepository.java`
- **PostgreSQL**
- [Liquibase Schema](https://github.com/thepowermisha/task-service/tree/master/src/main/resources/db/changelog): `src/main/resources/db/changelog`

### Event Delivery

- [Task Event Producer](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/event/producer/TaskEventProducer.java): `src/main/java/com/tpm/task_service/event/producer/TaskEventProducer.java`
- [Kafka Configuration](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/config/KafkaConfig.java): `src/main/java/com/tpm/task_service/config/KafkaConfig.java`
- [Topic Properties](https://github.com/thepowermisha/task-service/blob/master/src/main/java/com/tpm/task_service/config/KafkaTopicsProperties.java): `src/main/java/com/tpm/task_service/config/KafkaTopicsProperties.java`
- **Kafka**

### Other components

- **API Client**

## Connections

- API Client → Task Controller: sends requests (evidence: `README.md`)
- Task Controller → Task Service: delegates to (evidence: `src/main/java/com/tpm/task_service/controller/TaskController.java`)
- User Controller → User Service: delegates to (evidence: `src/main/java/com/tpm/task_service/controller/UserController.java`)
- Task Controller → Response DTO: wraps results (evidence: `src/main/java/com/tpm/task_service/controller/TaskController.java`)
- Exception Handler → Response DTO: returns errors (evidence: `src/main/java/com/tpm/task_service/controller/GlobalExceptionHandler.java`)
- Task Service → Task Repository: reads and saves (evidence: `src/main/java/com/tpm/task_service/service/TaskService.java`)
- Task Service → User Repository: looks up users (evidence: `src/main/java/com/tpm/task_service/service/TaskService.java`)
- Task Service → Task Mapper: maps results (evidence: `src/main/java/com/tpm/task_service/service/TaskService.java`)
- User Service → User Repository: reads and saves (evidence: `src/main/java/com/tpm/task_service/service/UserService.java`)
- User Service → User Mapper: maps results (evidence: `src/main/java/com/tpm/task_service/service/UserService.java`)
- Task Mapper → Task Entity: maps entity (evidence: `src/main/java/com/tpm/task_service/mapper/TaskMapper.java`)
- Task Mapper → Task DTOs: builds DTO (evidence: `src/main/java/com/tpm/task_service/mapper/TaskMapper.java`)
- User Mapper → User Entity: maps entity (evidence: `src/main/java/com/tpm/task_service/mapper/UserMapper.java`)
- User Mapper → User DTOs: builds DTO (evidence: `src/main/java/com/tpm/task_service/mapper/UserMapper.java`)
- Task Repository → PostgreSQL: persists tasks (evidence: `README.md`)
- User Repository → PostgreSQL: persists users (evidence: `README.md`)
- Liquibase Schema → PostgreSQL: defines schema
- Task Entity → User Entity: references assignee (evidence: `src/main/java/com/tpm/task_service/entity/Task.java`)
- Task Service → Task Status: sets status (evidence: `src/main/java/com/tpm/task_service/service/TaskService.java`)
- Task Service → Task Event Producer: publishes events (evidence: `src/main/java/com/tpm/task_service/service/TaskService.java`)
- Task Event Producer → Kafka: sends events (evidence: `README.md`)
- Task Event Producer → Topic Properties: uses topics (evidence: `src/main/java/com/tpm/task_service/event/producer/TaskEventProducer.java`)
- Kafka Configuration → Topic Properties: configures topics (evidence: `src/main/java/com/tpm/task_service/config/KafkaConfig.java`)
