# slavacom/taskmaster architecture

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

- Interactive diagram: https://gitdiagram.com/slavacom/taskmaster
- Repository: https://github.com/slavacom/taskmaster

## Overview

This repository is a multi-service project-management backend: users authenticate, create organizations and membership, then manage projects and tasks with collaboration features. Supporting services handle profiles, notifications, and file-storage URLs; a gateway and token service provide request security. The shown excerpts establish several internal calls and storage interactions, while many service boundaries and capabilities are visible only in the file tree. Dashed, uncited edges mark plausible entry points or integrations whose wiring was not shown.

Main entry points: [`Auth-service/src/main/java/com/slavacom/auth_service/service/AuthService.java`](https://github.com/slavacom/taskmaster/blob/master/Auth-service/src/main/java/com/slavacom/auth_service/service/AuthService.java) (Auth and tokens), [`UserService/src/main/java/com/slavacom/userservice/controller/UserController.java`](https://github.com/slavacom/taskmaster/blob/master/UserService/src/main/java/com/slavacom/userservice/controller/UserController.java) (User and profile API), [`OrganizationService/src/main/java/com/slavacom/organizationservice/invitation/InvitationService.kt`](https://github.com/slavacom/taskmaster/blob/master/OrganizationService/src/main/java/com/slavacom/organizationservice/invitation/InvitationService.kt) (Invitations), [`OrganizationService/src/main/java/com/slavacom/organizationservice/service/OrganizationService.kt`](https://github.com/slavacom/taskmaster/blob/master/OrganizationService/src/main/java/com/slavacom/organizationservice/service/OrganizationService.kt) (Organization service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["Gateway and authentication"]
  node_gateway["Request gateway<br/>[JwtAuthFilter.java]"]
end

subgraph group_identity["Identity and profiles"]
  node_auth["Authentication API"]
  node_authlogic["Auth and tokens<br/>[AuthService.java]"]
  node_authusers["User service client"]
  node_authstore[("Auth user store")]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_users["User and profile API"]
  node_profiles["Profile service"]
  node_userstore[("User repository")]
end

subgraph group_org["Organizations and projects"]
  node_orgapi["Organization API"]
  node_orglogic["Organization service"]
  node_employees["Membership service"]
  node_invitations["Invitations"]
  node_orgusers["User service client"]
  node_orgstore[("Organization data")]
end

subgraph group_work["Tasks and collaboration"]
  node_taskapi["Task API<br/>[TaskController.kt]"]
  node_tasks["Task service<br/>[TaskService.kt]"]
  node_taskstore[("Task repository<br/>[TaskRepository.kt]")]
  node_taskhistory["Task history"]
  node_comments["Comments and attachments<br/>[CommentService.kt]"]
end

subgraph group_infra["Notifications and files"]
  node_notificationapi["Notification API"]
  node_notifylogic["Notification dispatch"]
  node_senders["Channel senders"]
  node_s3api["File URL API<br/>[S3Controller.kt]"]
  node_s3service["S3 URL service"]
  node_s3[("S3 storage")]
end

node_user(("User"))

node_user -.->|"sends requests"| node_gateway
node_gateway -.->|"routes requests"| node_auth
node_user -.->|"authenticates"| node_auth
node_auth -.->|"delegates"| node_authlogic
node_authlogic -->|"fetches user data"| node_authusers
node_authlogic -->|"reads and saves"| node_authstore
node_authlogic -->|"issues and validates"| node_jwt
node_authusers -.->|"calls user service"| node_users
node_user -.->|"manages profile"| node_users
node_users -.->|"delegates profile work"| node_profiles
node_profiles -->|"reads and updates"| node_userstore
node_user -.->|"creates organization"| node_orgapi
node_orgapi -.->|"delegates"| node_orglogic
node_orglogic -->|"creates owner membership"| node_employees
node_orglogic -.->|"reads and saves"| node_orgstore
node_employees -->|"creates user profile"| node_orgusers
node_orgusers -.->|"calls user service"| node_users
node_invitations -->|"fetches invitee"| node_orgusers
node_invitations -->|"adds accepted member"| node_employees
node_user -.->|"manages tasks"| node_taskapi
node_taskapi -->|"delegates"| node_tasks
node_tasks -->|"queries and saves"| node_taskstore
node_tasks -->|"records changes"| node_taskhistory
node_user -.->|"collaborates"| node_comments
node_user -.->|"requests notification"| node_notificationapi
node_notificationapi -.->|"delegates"| node_notifylogic
node_notifylogic -->|"dispatches by channel"| node_senders
node_invitations -->|"sends invitation email"| node_notificationapi
node_user -.->|"requests file URLs"| node_s3api
node_s3api -.->|"delegates"| node_s3service
node_s3service -.->|"presigns object access"| node_s3

click node_gateway "https://github.com/slavacom/taskmaster/blob/master/Gateway-service/src/main/java/com/slavacom/gateway/filter/JwtAuthFilter.java"
click node_auth "https://github.com/slavacom/taskmaster/blob/master/Auth-service/src/main/java/com/slavacom/auth_service/controller/AuthController.java"
click node_authlogic "https://github.com/slavacom/taskmaster/blob/master/Auth-service/src/main/java/com/slavacom/auth_service/service/AuthService.java"
click node_authusers "https://github.com/slavacom/taskmaster/blob/master/Auth-service/src/main/java/com/slavacom/auth_service/client/UserServiceClient.java"
click node_authstore "https://github.com/slavacom/taskmaster/blob/master/Auth-service/src/main/java/com/slavacom/auth_service/repository/UserRepository.java"
click node_jwt "https://github.com/slavacom/taskmaster/blob/master/Auth-service/src/main/java/com/slavacom/auth_service/service/JwtService.java"
click node_users "https://github.com/slavacom/taskmaster/blob/master/UserService/src/main/java/com/slavacom/userservice/controller/UserController.java"
click node_profiles "https://github.com/slavacom/taskmaster/blob/master/UserService/src/main/java/com/slavacom/userservice/service/ProfileService.java"
click node_userstore "https://github.com/slavacom/taskmaster/blob/master/UserService/src/main/java/com/slavacom/userservice/repository/UserRepository.java"
click node_orgapi "https://github.com/slavacom/taskmaster/blob/master/OrganizationService/src/main/java/com/slavacom/organizationservice/controller/OrganizationController.kt"
click node_orglogic "https://github.com/slavacom/taskmaster/blob/master/OrganizationService/src/main/java/com/slavacom/organizationservice/service/OrganizationService.kt"
click node_employees "https://github.com/slavacom/taskmaster/blob/master/OrganizationService/src/main/java/com/slavacom/organizationservice/employees/EmployeesService.kt"
click node_invitations "https://github.com/slavacom/taskmaster/blob/master/OrganizationService/src/main/java/com/slavacom/organizationservice/invitation/InvitationService.kt"
click node_orgusers "https://github.com/slavacom/taskmaster/blob/master/OrganizationService/src/main/java/com/slavacom/organizationservice/client/UserServiceClient.kt"
click node_orgstore "https://github.com/slavacom/taskmaster/blob/master/OrganizationService/src/main/java/com/slavacom/organizationservice/repository/OrganizationRepository.kt"
click node_taskapi "https://github.com/slavacom/taskmaster/blob/master/TaskService/src/main/kotlin/com/slavacom/taskservice/controller/TaskController.kt"
click node_tasks "https://github.com/slavacom/taskmaster/blob/master/TaskService/src/main/kotlin/com/slavacom/taskservice/service/TaskService.kt"
click node_taskstore "https://github.com/slavacom/taskmaster/blob/master/TaskService/src/main/kotlin/com/slavacom/taskservice/repository/TaskRepository.kt"
click node_taskhistory "https://github.com/slavacom/taskmaster/blob/master/TaskService/src/main/kotlin/com/slavacom/taskservice/service/TaskHistoryService.kt"
click node_comments "https://github.com/slavacom/taskmaster/blob/master/TaskService/src/main/kotlin/com/slavacom/taskservice/service/CommentService.kt"
click node_notificationapi "https://github.com/slavacom/taskmaster/blob/master/NotificationService/src/main/kotlin/com/slavacom/notificationservice/controller/NotificationController.kt"
click node_notifylogic "https://github.com/slavacom/taskmaster/blob/master/NotificationService/src/main/kotlin/com/slavacom/notificationservice/service/NotificationService.kt"
click node_senders "https://github.com/slavacom/taskmaster/blob/master/NotificationService/src/main/kotlin/com/slavacom/notificationservice/service/sender/NotificationSender.kt"
click node_s3api "https://github.com/slavacom/taskmaster/blob/master/S3CloudeStorage/src/main/kotlin/com/slavacom/s3cloudestorage/controller/S3Controller.kt"
click node_s3service "https://github.com/slavacom/taskmaster/blob/master/S3CloudeStorage/src/main/kotlin/com/slavacom/s3cloudestorage/service/S3StorageService.kt"

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_gateway,node_user toneBlue
class node_auth,node_authlogic,node_authusers,node_authstore,node_jwt,node_users,node_profiles,node_userstore toneAmber
class node_orgapi,node_orglogic,node_employees,node_invitations,node_orgusers,node_orgstore toneMint
class node_taskapi,node_tasks,node_taskstore,node_taskhistory,node_comments toneRose
class node_notificationapi,node_notifylogic,node_senders,node_s3api,node_s3service,node_s3 toneIndigo
```

## Components

### Gateway and authentication

- [Request gateway](https://github.com/slavacom/taskmaster/blob/master/Gateway-service/src/main/java/com/slavacom/gateway/filter/JwtAuthFilter.java): `Gateway-service/src/main/java/com/slavacom/gateway/filter/JwtAuthFilter.java`

### Identity and profiles

- [Authentication API](https://github.com/slavacom/taskmaster/blob/master/Auth-service/src/main/java/com/slavacom/auth_service/controller/AuthController.java): `Auth-service/src/main/java/com/slavacom/auth_service/controller/AuthController.java`
- [Auth and tokens](https://github.com/slavacom/taskmaster/blob/master/Auth-service/src/main/java/com/slavacom/auth_service/service/AuthService.java): `Auth-service/src/main/java/com/slavacom/auth_service/service/AuthService.java`
- [User service client](https://github.com/slavacom/taskmaster/blob/master/Auth-service/src/main/java/com/slavacom/auth_service/client/UserServiceClient.java): `Auth-service/src/main/java/com/slavacom/auth_service/client/UserServiceClient.java`
- [Auth user store](https://github.com/slavacom/taskmaster/blob/master/Auth-service/src/main/java/com/slavacom/auth_service/repository/UserRepository.java): `Auth-service/src/main/java/com/slavacom/auth_service/repository/UserRepository.java`
- [JWT service](https://github.com/slavacom/taskmaster/blob/master/Auth-service/src/main/java/com/slavacom/auth_service/service/JwtService.java): `Auth-service/src/main/java/com/slavacom/auth_service/service/JwtService.java`
- [User and profile API](https://github.com/slavacom/taskmaster/blob/master/UserService/src/main/java/com/slavacom/userservice/controller/UserController.java): `UserService/src/main/java/com/slavacom/userservice/controller/UserController.java`
- [Profile service](https://github.com/slavacom/taskmaster/blob/master/UserService/src/main/java/com/slavacom/userservice/service/ProfileService.java): `UserService/src/main/java/com/slavacom/userservice/service/ProfileService.java`
- [User repository](https://github.com/slavacom/taskmaster/blob/master/UserService/src/main/java/com/slavacom/userservice/repository/UserRepository.java): `UserService/src/main/java/com/slavacom/userservice/repository/UserRepository.java`

### Organizations and projects

- [Organization API](https://github.com/slavacom/taskmaster/blob/master/OrganizationService/src/main/java/com/slavacom/organizationservice/controller/OrganizationController.kt): `OrganizationService/src/main/java/com/slavacom/organizationservice/controller/OrganizationController.kt`
- [Organization service](https://github.com/slavacom/taskmaster/blob/master/OrganizationService/src/main/java/com/slavacom/organizationservice/service/OrganizationService.kt): `OrganizationService/src/main/java/com/slavacom/organizationservice/service/OrganizationService.kt`
- [Membership service](https://github.com/slavacom/taskmaster/blob/master/OrganizationService/src/main/java/com/slavacom/organizationservice/employees/EmployeesService.kt): `OrganizationService/src/main/java/com/slavacom/organizationservice/employees/EmployeesService.kt`
- [Invitations](https://github.com/slavacom/taskmaster/blob/master/OrganizationService/src/main/java/com/slavacom/organizationservice/invitation/InvitationService.kt): `OrganizationService/src/main/java/com/slavacom/organizationservice/invitation/InvitationService.kt`
- [User service client](https://github.com/slavacom/taskmaster/blob/master/OrganizationService/src/main/java/com/slavacom/organizationservice/client/UserServiceClient.kt): `OrganizationService/src/main/java/com/slavacom/organizationservice/client/UserServiceClient.kt`
- [Organization data](https://github.com/slavacom/taskmaster/blob/master/OrganizationService/src/main/java/com/slavacom/organizationservice/repository/OrganizationRepository.kt): `OrganizationService/src/main/java/com/slavacom/organizationservice/repository/OrganizationRepository.kt`

### Tasks and collaboration

- [Task API](https://github.com/slavacom/taskmaster/blob/master/TaskService/src/main/kotlin/com/slavacom/taskservice/controller/TaskController.kt): `TaskService/src/main/kotlin/com/slavacom/taskservice/controller/TaskController.kt`
- [Task service](https://github.com/slavacom/taskmaster/blob/master/TaskService/src/main/kotlin/com/slavacom/taskservice/service/TaskService.kt): `TaskService/src/main/kotlin/com/slavacom/taskservice/service/TaskService.kt`
- [Task repository](https://github.com/slavacom/taskmaster/blob/master/TaskService/src/main/kotlin/com/slavacom/taskservice/repository/TaskRepository.kt): `TaskService/src/main/kotlin/com/slavacom/taskservice/repository/TaskRepository.kt`
- [Task history](https://github.com/slavacom/taskmaster/blob/master/TaskService/src/main/kotlin/com/slavacom/taskservice/service/TaskHistoryService.kt): `TaskService/src/main/kotlin/com/slavacom/taskservice/service/TaskHistoryService.kt`
- [Comments and attachments](https://github.com/slavacom/taskmaster/blob/master/TaskService/src/main/kotlin/com/slavacom/taskservice/service/CommentService.kt): `TaskService/src/main/kotlin/com/slavacom/taskservice/service/CommentService.kt`

### Notifications and files

- [Notification API](https://github.com/slavacom/taskmaster/blob/master/NotificationService/src/main/kotlin/com/slavacom/notificationservice/controller/NotificationController.kt): `NotificationService/src/main/kotlin/com/slavacom/notificationservice/controller/NotificationController.kt`
- [Notification dispatch](https://github.com/slavacom/taskmaster/blob/master/NotificationService/src/main/kotlin/com/slavacom/notificationservice/service/NotificationService.kt): `NotificationService/src/main/kotlin/com/slavacom/notificationservice/service/NotificationService.kt`
- [Channel senders](https://github.com/slavacom/taskmaster/blob/master/NotificationService/src/main/kotlin/com/slavacom/notificationservice/service/sender/NotificationSender.kt): `NotificationService/src/main/kotlin/com/slavacom/notificationservice/service/sender/NotificationSender.kt`
- [File URL API](https://github.com/slavacom/taskmaster/blob/master/S3CloudeStorage/src/main/kotlin/com/slavacom/s3cloudestorage/controller/S3Controller.kt): `S3CloudeStorage/src/main/kotlin/com/slavacom/s3cloudestorage/controller/S3Controller.kt`
- [S3 URL service](https://github.com/slavacom/taskmaster/blob/master/S3CloudeStorage/src/main/kotlin/com/slavacom/s3cloudestorage/service/S3StorageService.kt): `S3CloudeStorage/src/main/kotlin/com/slavacom/s3cloudestorage/service/S3StorageService.kt`
- **S3 storage**

### Other components

- **User**

## Connections

- User → Request gateway: sends requests
- Request gateway → Authentication API: routes requests
- User → Authentication API: authenticates
- Authentication API → Auth and tokens: delegates (evidence: `Auth-service/src/main/java/com/slavacom/auth_service/controller/AuthController.java`)
- Auth and tokens → User service client: fetches user data (evidence: `Auth-service/src/main/java/com/slavacom/auth_service/service/AuthService.java`)
- Auth and tokens → Auth user store: reads and saves (evidence: `Auth-service/src/main/java/com/slavacom/auth_service/service/AuthService.java`)
- Auth and tokens → JWT service: issues and validates (evidence: `Auth-service/src/main/java/com/slavacom/auth_service/service/AuthService.java`)
- User service client → User and profile API: calls user service
- User → User and profile API: manages profile
- User and profile API → Profile service: delegates profile work (evidence: `UserService/src/main/java/com/slavacom/userservice/controller/UserController.java`)
- Profile service → User repository: reads and updates (evidence: `UserService/src/main/java/com/slavacom/userservice/service/ProfileService.java`)
- User → Organization API: creates organization
- Organization API → Organization service: delegates
- Organization service → Membership service: creates owner membership (evidence: `OrganizationService/src/main/java/com/slavacom/organizationservice/service/OrganizationService.kt`)
- Organization service → Organization data: reads and saves (evidence: `OrganizationService/src/main/java/com/slavacom/organizationservice/service/OrganizationService.kt`)
- Membership service → User service client: creates user profile (evidence: `OrganizationService/src/main/java/com/slavacom/organizationservice/employees/EmployeesService.kt`)
- User service client → User and profile API: calls user service
- Invitations → User service client: fetches invitee (evidence: `OrganizationService/src/main/java/com/slavacom/organizationservice/invitation/InvitationService.kt`)
- Invitations → Membership service: adds accepted member (evidence: `OrganizationService/src/main/java/com/slavacom/organizationservice/invitation/InvitationService.kt`)
- User → Task API: manages tasks
- Task API → Task service: delegates (evidence: `TaskService/src/main/kotlin/com/slavacom/taskservice/controller/TaskController.kt`)
- Task service → Task repository: queries and saves (evidence: `TaskService/src/main/kotlin/com/slavacom/taskservice/service/TaskService.kt`)
- Task service → Task history: records changes (evidence: `TaskService/src/main/kotlin/com/slavacom/taskservice/service/TaskService.kt`)
- User → Comments and attachments: collaborates
- User → Notification API: requests notification
- Notification API → Notification dispatch: delegates (evidence: `NotificationService/src/main/kotlin/com/slavacom/notificationservice/controller/NotificationController.kt`)
- Notification dispatch → Channel senders: dispatches by channel (evidence: `NotificationService/src/main/kotlin/com/slavacom/notificationservice/service/NotificationService.kt`)
- Invitations → Notification API: sends invitation email (evidence: `OrganizationService/src/main/java/com/slavacom/organizationservice/invitation/InvitationService.kt`)
- User → File URL API: requests file URLs
- File URL API → S3 URL service: delegates (evidence: `S3CloudeStorage/src/main/kotlin/com/slavacom/s3cloudestorage/controller/S3Controller.kt`)
- S3 URL service → S3 storage: presigns object access
