# monish-shadow-ops/kanboard-gitops-project architecture

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

- Interactive diagram: https://gitdiagram.com/monish-shadow-ops/kanboard-gitops-project
- Repository: https://github.com/monish-shadow-ops/kanboard-gitops-project

## Overview

Kanboard is a self-hosted project-management application centered on Kanban boards. A user-facing workflow presents board and task views, while task models represent work and its status; filters, actions, and analytics support finding, automating, and measuring that work. The repository also includes authentication, API procedures, notifications, file storage, and extension points. Several domain subsystems are represented by their exact tree paths, but their runtime wiring was not sampled; those links are omitted or marked unverified rather than asserted as observed calls.

Main entry points: [`app/Model/TaskModel.php`](https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Model/TaskModel.php) (Task domain), [`libs/picodb/lib/PicoDb/Database.php`](https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/libs/picodb/lib/PicoDb/Database.php) (SQL database), [`app/Controller`](https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Controller) (Web controllers), [`app/Filter/TaskSearchFilter.php`](https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Filter/TaskSearchFilter.php) (Task search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_web["Web controllers"]
  node_api["API procedures"]
  node_templates["Board templates"]
end

subgraph group_work["Kanban work"]
  node_board["Board views"]
  node_task["Task domain<br/>[TaskModel.php]"]
  node_status["Task status"]
  node_actions["Task actions<br/>[ActionManager.php]"]
  node_search["Task search"]
  node_analytics["Analytics"]
end

subgraph group_platform["Platform services"]
  node_auth["Authentication"]
  node_db_auth["Database login<br/>[DatabaseAuth.php]"]
  node_database[("SQL database<br/>[Database.php]")]
  node_database_provider["Database setup"]
  node_statement["SQL execution"]
  node_events["Event subscribers"]
  node_notifications["Notifications"]
  node_file_provider["File setup"]
  node_file_storage["File storage<br/>[FileStorage.php]"]
end

subgraph group_extensions["Integrations"]
  node_plugins["Plugin system"]
  node_external_tasks["External tasks"]
  node_external_links["External links"]
end

node_user(("User"))

node_user -.->|"uses"| node_web
node_user -.->|"uses"| node_api
node_web -.->|"routes to"| node_board
node_board -.->|"renders"| node_templates
node_web -.->|"updates"| node_task
node_api -.->|"accesses"| node_task
node_task -->|"uses"| node_status
node_search -->|"filters"| node_task
node_search -->|"queries"| node_database
node_task -.->|"persists"| node_database
node_analytics -->|"measures"| node_task
node_web -.->|"authenticates"| node_auth
node_auth -.->|"selects provider"| node_db_auth
node_db_auth -->|"checks credentials"| node_database
node_database_provider -->|"creates"| node_database
node_database -->|"executes through"| node_statement
node_actions -.->|"automates"| node_task
node_task -.->|"emits events"| node_events
node_events -.->|"dispatches"| node_notifications
node_file_provider -->|"creates"| node_file_storage
node_plugins -.->|"registers"| node_external_tasks
node_plugins -.->|"registers"| node_external_links

click node_web "https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Controller"
click node_api "https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Api/Procedure"
click node_auth "https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Core/Security/AuthenticationManager.php"
click node_db_auth "https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Auth/DatabaseAuth.php"
click node_board "https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Controller/BoardViewController.php"
click node_task "https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Model/TaskModel.php"
click node_status "https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Model/TaskStatusModel.php"
click node_actions "https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Core/Action/ActionManager.php"
click node_search "https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Filter/TaskSearchFilter.php"
click node_analytics "https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Analytic"
click node_database "https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/libs/picodb/lib/PicoDb/Database.php"
click node_database_provider "https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/ServiceProvider/DatabaseProvider.php"
click node_statement "https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/libs/picodb/lib/PicoDb/StatementHandler.php"
click node_events "https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Subscriber"
click node_notifications "https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Notification"
click node_file_provider "https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/ServiceProvider/ObjectStorageProvider.php"
click node_file_storage "https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Core/ObjectStorage/FileStorage.php"
click node_plugins "https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Core/Plugin"
click node_external_tasks "https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Core/ExternalTask"
click node_external_links "https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Core/ExternalLink"
click node_templates "https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Template/board"

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_web,node_api,node_templates,node_user toneBlue
class node_board,node_task,node_status,node_actions,node_search,node_analytics toneAmber
class node_auth,node_db_auth,node_database,node_database_provider,node_statement,node_events,node_notifications,node_file_provider,node_file_storage toneMint
class node_plugins,node_external_tasks,node_external_links toneRose
```

## Components

### Application entry

- [Web controllers](https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Controller): `app/Controller`
- [API procedures](https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Api/Procedure): `app/Api/Procedure`
- [Board templates](https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Template/board): `app/Template/board`

### Kanban work

- [Board views](https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Controller/BoardViewController.php): `app/Controller/BoardViewController.php`
- [Task domain](https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Model/TaskModel.php): `app/Model/TaskModel.php`
- [Task status](https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Model/TaskStatusModel.php): `app/Model/TaskStatusModel.php`
- [Task actions](https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Core/Action/ActionManager.php): `app/Core/Action/ActionManager.php`
- [Task search](https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Filter/TaskSearchFilter.php): `app/Filter/TaskSearchFilter.php`
- [Analytics](https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Analytic): `app/Analytic`

### Platform services

- [Authentication](https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Core/Security/AuthenticationManager.php): `app/Core/Security/AuthenticationManager.php`
- [Database login](https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Auth/DatabaseAuth.php): `app/Auth/DatabaseAuth.php`
- [SQL database](https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/libs/picodb/lib/PicoDb/Database.php): `libs/picodb/lib/PicoDb/Database.php`
- [Database setup](https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/ServiceProvider/DatabaseProvider.php): `app/ServiceProvider/DatabaseProvider.php`
- [SQL execution](https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/libs/picodb/lib/PicoDb/StatementHandler.php): `libs/picodb/lib/PicoDb/StatementHandler.php`
- [Event subscribers](https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Subscriber): `app/Subscriber`
- [Notifications](https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Notification): `app/Notification`
- [File setup](https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/ServiceProvider/ObjectStorageProvider.php): `app/ServiceProvider/ObjectStorageProvider.php`
- [File storage](https://github.com/monish-shadow-ops/kanboard-gitops-project/blob/main/app/Core/ObjectStorage/FileStorage.php): `app/Core/ObjectStorage/FileStorage.php`

### Integrations

- [Plugin system](https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Core/Plugin): `app/Core/Plugin`
- [External tasks](https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Core/ExternalTask): `app/Core/ExternalTask`
- [External links](https://github.com/monish-shadow-ops/kanboard-gitops-project/tree/main/app/Core/ExternalLink): `app/Core/ExternalLink`

### Other components

- **User**

## Connections

- User → Web controllers: uses
- User → API procedures: uses
- Web controllers → Board views: routes to
- Board views → Board templates: renders
- Web controllers → Task domain: updates
- API procedures → Task domain: accesses
- Task domain → Task status: uses (evidence: `app/Model/TaskStatusModel.php`)
- Task search → Task domain: filters (evidence: `app/Filter/TaskSearchFilter.php`)
- Task search → SQL database: queries (evidence: `app/Filter/TaskSearchFilter.php`)
- Task domain → SQL database: persists
- Analytics → Task domain: measures (evidence: `app/Analytic/AverageTimeSpentColumnAnalytic.php`)
- Web controllers → Authentication: authenticates
- Authentication → Database login: selects provider
- Database login → SQL database: checks credentials (evidence: `app/Auth/DatabaseAuth.php`)
- Database setup → SQL database: creates (evidence: `app/ServiceProvider/DatabaseProvider.php`)
- SQL database → SQL execution: executes through (evidence: `libs/picodb/lib/PicoDb/Database.php`)
- Task actions → Task domain: automates
- Task domain → Event subscribers: emits events (evidence: `app/Subscriber/RecurringTaskSubscriber.php`)
- Event subscribers → Notifications: dispatches
- File setup → File storage: creates (evidence: `app/ServiceProvider/ObjectStorageProvider.php`)
- Plugin system → External tasks: registers
- Plugin system → External links: registers
