# gompyk/task-manager architecture

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

## Overview

This is a Symfony task-management API organized around boards, columns, tasks, and folders, with supporting users and groups. The visible request flow starts at HTTP controllers, which construct commands or queries and submit them to shared buses; query handlers and repositories provide some of the application’s read-side behavior. The tree documents additional task timers, board views and ratings, and group membership. Several handlers and bus implementations were not sampled, so their dispatch and persistence links are not asserted.

Main entry points: [`src/Boards/Infrastructure/Controller/BoardController.php`](https://github.com/gompyk/task-manager/blob/main/src/Boards/Infrastructure/Controller/BoardController.php) (Board endpoints), [`src/Shared/Application/Command/CommandBusInterface.php`](https://github.com/gompyk/task-manager/blob/main/src/Shared/Application/Command/CommandBusInterface.php) (Command bus), [`src/Shared/Application/Query/QueryBusInterface.php`](https://github.com/gompyk/task-manager/blob/main/src/Shared/Application/Query/QueryBusInterface.php) (Query bus), [`src/Tasks/Infrastructure/Controller/TaskController.php`](https://github.com/gompyk/task-manager/blob/main/src/Tasks/Infrastructure/Controller/TaskController.php) (Task endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_board_api["Board endpoints"]
  node_task_api["Task endpoints<br/>[TaskController.php]"]
  node_timer_api["Timer endpoints"]
  node_folder_api["Folder endpoints"]
  node_group_api["Group endpoints"]
  node_user_api["Current user<br/>[GetMeAction.php]"]
end

subgraph group_work["Board and Work"]
  node_board_ops["Board operations"]
  node_board_domain["Board model<br/>[Board.php]"]
  node_board_store["Board repository"]
  node_task_ops["Task operations"]
  node_task_domain["Task and timers<br/>[Task.php]"]
  node_task_store["Task repository<br/>[TaskRepository.php]"]
  node_folder_ops["Folder operations"]
  node_folder_domain["Folder model<br/>[Folder.php]"]
  node_folder_store["Folder repository"]
end

subgraph group_identity["Users and Groups"]
  node_group_ops["Group operations"]
  node_group_domain["Group model<br/>[Group.php]"]
  node_group_store["Group repository"]
  node_user_ops["User operations"]
  node_user_domain["User model<br/>[User.php]"]
  node_user_store["User repository<br/>[UserRepository.php]"]
end

subgraph group_shared["Application Core"]
  node_command_bus["Command bus"]
  node_query_bus["Query bus"]
  node_query_runtime["Query bus runtime<br/>[QueryBus.php]"]
  node_user_fetch["Authenticated user access"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_board_api
node_client -->|"sends requests"| node_task_api
node_client -->|"sends requests"| node_timer_api
node_client -->|"sends requests"| node_folder_api
node_client -->|"sends requests"| node_group_api
node_client -.->|"sends requests"| node_user_api
node_board_api -->|"submits commands"| node_command_bus
node_board_api -->|"submits queries"| node_query_bus
node_board_api -->|"checks board"| node_board_store
node_board_api -->|"fetches user"| node_user_fetch
node_task_api -->|"submits commands"| node_command_bus
node_task_api -->|"submits queries"| node_query_bus
node_timer_api -->|"submits commands"| node_command_bus
node_folder_api -->|"submits commands"| node_command_bus
node_folder_api -->|"submits queries"| node_query_bus
node_group_api -->|"submits commands"| node_command_bus
node_query_runtime -->|"implements"| node_query_bus
node_user_domain -->|"persisted through"| node_user_store
node_task_domain -->|"persisted through"| node_task_store
node_folder_domain -->|"persisted through"| node_folder_store
node_group_domain -->|"persisted through"| node_group_store

click node_board_api "https://github.com/gompyk/task-manager/blob/main/src/Boards/Infrastructure/Controller/BoardController.php"
click node_task_api "https://github.com/gompyk/task-manager/blob/main/src/Tasks/Infrastructure/Controller/TaskController.php"
click node_timer_api "https://github.com/gompyk/task-manager/blob/main/src/Tasks/Infrastructure/Controller/TaskTimerController.php"
click node_folder_api "https://github.com/gompyk/task-manager/blob/main/src/Folders/Infrastructure/Controller/FolderController.php"
click node_group_api "https://github.com/gompyk/task-manager/blob/main/src/Groups/Infrastructure/Controller/GroupController.php"
click node_user_api "https://github.com/gompyk/task-manager/blob/main/src/Users/Infrastructure/Controller/GetMeAction.php"
click node_board_ops "https://github.com/gompyk/task-manager/tree/main/src/Boards/Application"
click node_board_domain "https://github.com/gompyk/task-manager/blob/main/src/Boards/Domain/Entity/Board.php"
click node_board_store "https://github.com/gompyk/task-manager/blob/main/src/Boards/Infrastructure/Repository/BoardRepository.php"
click node_task_ops "https://github.com/gompyk/task-manager/tree/main/src/Tasks/Application"
click node_task_domain "https://github.com/gompyk/task-manager/blob/main/src/Tasks/Domain/Entity/Task.php"
click node_task_store "https://github.com/gompyk/task-manager/blob/main/src/Tasks/Infrastructure/Repository/TaskRepository.php"
click node_folder_ops "https://github.com/gompyk/task-manager/tree/main/src/Folders/Application"
click node_folder_domain "https://github.com/gompyk/task-manager/blob/main/src/Folders/Domain/Entity/Folder.php"
click node_folder_store "https://github.com/gompyk/task-manager/blob/main/src/Folders/Infrastructure/Repository/FolderRepository.php"
click node_group_ops "https://github.com/gompyk/task-manager/tree/main/src/Groups/Application"
click node_group_domain "https://github.com/gompyk/task-manager/blob/main/src/Groups/Domain/Entity/Group.php"
click node_group_store "https://github.com/gompyk/task-manager/blob/main/src/Groups/Infrastructure/Repository/GroupRepository.php"
click node_user_ops "https://github.com/gompyk/task-manager/tree/main/src/Users/Application"
click node_user_domain "https://github.com/gompyk/task-manager/blob/main/src/Users/Domain/Entity/User.php"
click node_user_store "https://github.com/gompyk/task-manager/blob/main/src/Users/Infrastructure/Repository/UserRepository.php"
click node_command_bus "https://github.com/gompyk/task-manager/blob/main/src/Shared/Application/Command/CommandBusInterface.php"
click node_query_bus "https://github.com/gompyk/task-manager/blob/main/src/Shared/Application/Query/QueryBusInterface.php"
click node_query_runtime "https://github.com/gompyk/task-manager/blob/main/src/Shared/Infrastructure/Bus/QueryBus.php"
click node_user_fetch "https://github.com/gompyk/task-manager/blob/main/src/Shared/Domain/Security/UserFetcherInterface.php"

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_board_api,node_task_api,node_timer_api,node_folder_api,node_group_api,node_user_api,node_client toneBlue
class node_board_ops,node_board_domain,node_board_store,node_task_ops,node_task_domain,node_task_store,node_folder_ops,node_folder_domain,node_folder_store toneAmber
class node_group_ops,node_group_domain,node_group_store,node_user_ops,node_user_domain,node_user_store toneMint
class node_command_bus,node_query_bus,node_query_runtime,node_user_fetch toneRose
```

## Components

### HTTP API

- [Board endpoints](https://github.com/gompyk/task-manager/blob/main/src/Boards/Infrastructure/Controller/BoardController.php): `src/Boards/Infrastructure/Controller/BoardController.php`
- [Task endpoints](https://github.com/gompyk/task-manager/blob/main/src/Tasks/Infrastructure/Controller/TaskController.php): `src/Tasks/Infrastructure/Controller/TaskController.php`
- [Timer endpoints](https://github.com/gompyk/task-manager/blob/main/src/Tasks/Infrastructure/Controller/TaskTimerController.php): `src/Tasks/Infrastructure/Controller/TaskTimerController.php`
- [Folder endpoints](https://github.com/gompyk/task-manager/blob/main/src/Folders/Infrastructure/Controller/FolderController.php): `src/Folders/Infrastructure/Controller/FolderController.php`
- [Group endpoints](https://github.com/gompyk/task-manager/blob/main/src/Groups/Infrastructure/Controller/GroupController.php): `src/Groups/Infrastructure/Controller/GroupController.php`
- [Current user](https://github.com/gompyk/task-manager/blob/main/src/Users/Infrastructure/Controller/GetMeAction.php): `src/Users/Infrastructure/Controller/GetMeAction.php`

### Board and Work

- [Board operations](https://github.com/gompyk/task-manager/tree/main/src/Boards/Application): `src/Boards/Application`
- [Board model](https://github.com/gompyk/task-manager/blob/main/src/Boards/Domain/Entity/Board.php): `src/Boards/Domain/Entity/Board.php`
- [Board repository](https://github.com/gompyk/task-manager/blob/main/src/Boards/Infrastructure/Repository/BoardRepository.php): `src/Boards/Infrastructure/Repository/BoardRepository.php`
- [Task operations](https://github.com/gompyk/task-manager/tree/main/src/Tasks/Application): `src/Tasks/Application`
- [Task and timers](https://github.com/gompyk/task-manager/blob/main/src/Tasks/Domain/Entity/Task.php): `src/Tasks/Domain/Entity/Task.php`
- [Task repository](https://github.com/gompyk/task-manager/blob/main/src/Tasks/Infrastructure/Repository/TaskRepository.php): `src/Tasks/Infrastructure/Repository/TaskRepository.php`
- [Folder operations](https://github.com/gompyk/task-manager/tree/main/src/Folders/Application): `src/Folders/Application`
- [Folder model](https://github.com/gompyk/task-manager/blob/main/src/Folders/Domain/Entity/Folder.php): `src/Folders/Domain/Entity/Folder.php`
- [Folder repository](https://github.com/gompyk/task-manager/blob/main/src/Folders/Infrastructure/Repository/FolderRepository.php): `src/Folders/Infrastructure/Repository/FolderRepository.php`

### Users and Groups

- [Group operations](https://github.com/gompyk/task-manager/tree/main/src/Groups/Application): `src/Groups/Application`
- [Group model](https://github.com/gompyk/task-manager/blob/main/src/Groups/Domain/Entity/Group.php): `src/Groups/Domain/Entity/Group.php`
- [Group repository](https://github.com/gompyk/task-manager/blob/main/src/Groups/Infrastructure/Repository/GroupRepository.php): `src/Groups/Infrastructure/Repository/GroupRepository.php`
- [User operations](https://github.com/gompyk/task-manager/tree/main/src/Users/Application): `src/Users/Application`
- [User model](https://github.com/gompyk/task-manager/blob/main/src/Users/Domain/Entity/User.php): `src/Users/Domain/Entity/User.php`
- [User repository](https://github.com/gompyk/task-manager/blob/main/src/Users/Infrastructure/Repository/UserRepository.php): `src/Users/Infrastructure/Repository/UserRepository.php`

### Application Core

- [Command bus](https://github.com/gompyk/task-manager/blob/main/src/Shared/Application/Command/CommandBusInterface.php): `src/Shared/Application/Command/CommandBusInterface.php`
- [Query bus](https://github.com/gompyk/task-manager/blob/main/src/Shared/Application/Query/QueryBusInterface.php): `src/Shared/Application/Query/QueryBusInterface.php`
- [Query bus runtime](https://github.com/gompyk/task-manager/blob/main/src/Shared/Infrastructure/Bus/QueryBus.php): `src/Shared/Infrastructure/Bus/QueryBus.php`
- [Authenticated user access](https://github.com/gompyk/task-manager/blob/main/src/Shared/Domain/Security/UserFetcherInterface.php): `src/Shared/Domain/Security/UserFetcherInterface.php`

### Other components

- **API client**

## Connections

- API client → Board endpoints: sends requests (evidence: `src/Boards/Infrastructure/Controller/BoardController.php`)
- API client → Task endpoints: sends requests (evidence: `src/Tasks/Infrastructure/Controller/TaskController.php`)
- API client → Timer endpoints: sends requests (evidence: `src/Tasks/Infrastructure/Controller/TaskTimerController.php`)
- API client → Folder endpoints: sends requests (evidence: `src/Folders/Infrastructure/Controller/FolderController.php`)
- API client → Group endpoints: sends requests (evidence: `src/Groups/Infrastructure/Controller/GroupController.php`)
- API client → Current user: sends requests
- Board endpoints → Command bus: submits commands (evidence: `src/Boards/Infrastructure/Controller/BoardController.php`)
- Board endpoints → Query bus: submits queries (evidence: `src/Boards/Infrastructure/Controller/BoardController.php`)
- Board endpoints → Board repository: checks board (evidence: `src/Boards/Infrastructure/Controller/BoardController.php`)
- Board endpoints → Authenticated user access: fetches user (evidence: `src/Boards/Infrastructure/Controller/BoardController.php`)
- Task endpoints → Command bus: submits commands (evidence: `src/Tasks/Infrastructure/Controller/TaskController.php`)
- Task endpoints → Query bus: submits queries (evidence: `src/Tasks/Infrastructure/Controller/TaskController.php`)
- Timer endpoints → Command bus: submits commands (evidence: `src/Tasks/Infrastructure/Controller/TaskTimerController.php`)
- Folder endpoints → Command bus: submits commands (evidence: `src/Folders/Infrastructure/Controller/FolderController.php`)
- Folder endpoints → Query bus: submits queries (evidence: `src/Folders/Infrastructure/Controller/FolderController.php`)
- Group endpoints → Command bus: submits commands (evidence: `src/Groups/Infrastructure/Controller/GroupController.php`)
- Query bus runtime → Query bus: implements (evidence: `src/Shared/Infrastructure/Bus/QueryBus.php`)
- User model → User repository: persisted through (evidence: `src/Users/Infrastructure/Repository/UserRepository.php`)
- Task and timers → Task repository: persisted through (evidence: `src/Tasks/Infrastructure/Repository/TaskRepository.php`)
- Folder model → Folder repository: persisted through (evidence: `src/Folders/Infrastructure/Repository/FolderRepository.php`)
- Group model → Group repository: persisted through (evidence: `src/Groups/Infrastructure/Repository/GroupRepository.php`)
