# itssammael/project_workspace architecture

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

- Interactive diagram: https://gitdiagram.com/itssammael/project_workspace
- Repository: https://github.com/itssammael/project_workspace

## Overview

This is a Laravel application for managing task boards and projects, with organizational administration, configurable access rules, dashboards, notifications, and support-function reports. The main workflow routes an authenticated user’s request to a controller, which loads or changes board, task, and subtask data and renders an Inertia page. Administration covers users, sections, departments, roles, workflows, and rules. The README is Laravel’s generic framework README, so product capabilities are inferred from the repository tree and sampled controller/model code; unsampled controller behavior is not asserted.

Main entry points: [`routes/web.php`](https://github.com/itssammael/project_workspace/blob/prod/routes/web.php) (Web routes), [`app/Http/Controllers/TaskBoardController.php`](https://github.com/itssammael/project_workspace/blob/prod/app/Http/Controllers/TaskBoardController.php) (Board controller), [`app/Models/TaskBoard.php`](https://github.com/itssammael/project_workspace/blob/prod/app/Models/TaskBoard.php) (Board and task models), [`app/Http/Controllers/AdminManagementController.php`](https://github.com/itssammael/project_workspace/blob/prod/app/Http/Controllers/AdminManagementController.php) (Admin management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web entry"]
  node_routes["Web routes<br/>[web.php]"]
end

subgraph group_work["Task management"]
  node_boards["Board controller"]
  node_tasks["Task controller<br/>[TaskController.php]"]
  node_boardmodels["Board and task models<br/>[TaskBoard.php]"]
  node_subtask["Subtask model<br/>[SubTask.php]"]
  node_attachments["Task attachments"]
  node_comments["Task comments<br/>[SubTaskComment.php]"]
end

subgraph group_org["Organization and policy"]
  node_admin["Admin management"]
  node_settings["Admin settings"]
  node_rules["Rule evaluation"]
  node_orgmodels["Organization models<br/>[Department.php]"]
  node_logs["System logs<br/>[SystemLog.php]"]
end

subgraph group_insight["Insights and messaging"]
  node_dashboard["Dashboard data"]
  node_notifications["Notifications"]
  node_reports["Support reports"]
end

subgraph group_identity["Identity"]
  node_auth["User identity<br/>[User.php]"]
  node_sso["SSO endpoints"]
end

node_user(("User"))

node_user -->|"sends request"| node_routes
node_routes -->|"routes board requests"| node_boards
node_routes -->|"routes task requests"| node_tasks
node_routes -->|"routes admin requests"| node_admin
node_routes -->|"routes settings requests"| node_settings
node_routes -->|"routes report requests"| node_reports
node_routes -->|"routes notification requests"| node_notifications
node_boards -->|"loads board data"| node_boardmodels
node_boards -->|"loads subtasks"| node_subtask
node_boards -->|"loads attachments"| node_attachments
node_boards -->|"loads comments"| node_comments
node_tasks -->|"loads task boards"| node_boardmodels
node_boardmodels -->|"has subtasks"| node_subtask
node_subtask -->|"has attachments"| node_attachments
node_subtask -->|"has comments"| node_comments
node_admin -->|"manages organization"| node_orgmodels
node_admin -->|"scopes access"| node_rules
node_settings -->|"manages rules"| node_rules
node_admin -->|"records changes"| node_logs
node_auth -->|"has member"| node_orgmodels
node_auth -.->|"supports SSO"| node_sso
node_dashboard -->|"reads board data"| node_boardmodels
node_dashboard -->|"uses access rules"| node_rules
node_notifications -->|"reads task context"| node_boardmodels
node_reports -.->|"uses organization data"| node_orgmodels

click node_routes "https://github.com/itssammael/project_workspace/blob/prod/routes/web.php"
click node_boards "https://github.com/itssammael/project_workspace/blob/prod/app/Http/Controllers/TaskBoardController.php"
click node_tasks "https://github.com/itssammael/project_workspace/blob/prod/app/Http/Controllers/TaskController.php"
click node_boardmodels "https://github.com/itssammael/project_workspace/blob/prod/app/Models/TaskBoard.php"
click node_subtask "https://github.com/itssammael/project_workspace/blob/prod/app/Models/SubTask.php"
click node_attachments "https://github.com/itssammael/project_workspace/blob/prod/app/Models/SubTaskAttachment.php"
click node_comments "https://github.com/itssammael/project_workspace/blob/prod/app/Models/SubTaskComment.php"
click node_admin "https://github.com/itssammael/project_workspace/blob/prod/app/Http/Controllers/AdminManagementController.php"
click node_settings "https://github.com/itssammael/project_workspace/blob/prod/app/Http/Controllers/AdminSettingsController.php"
click node_rules "https://github.com/itssammael/project_workspace/blob/prod/app/Services/SystemRuleEvaluator.php"
click node_orgmodels "https://github.com/itssammael/project_workspace/blob/prod/app/Models/Department.php"
click node_dashboard "https://github.com/itssammael/project_workspace/blob/prod/app/Services/DashboardDataService.php"
click node_notifications "https://github.com/itssammael/project_workspace/blob/prod/app/Services/NotificationService.php"
click node_reports "https://github.com/itssammael/project_workspace/blob/prod/app/Http/Controllers/SupportFunctionReportsController.php"
click node_logs "https://github.com/itssammael/project_workspace/blob/prod/app/Models/SystemLog.php"
click node_auth "https://github.com/itssammael/project_workspace/blob/prod/app/Models/User.php"
click node_sso "https://github.com/itssammael/project_workspace/blob/prod/app/Http/Controllers/SsoClientController.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_routes,node_user toneBlue
class node_boards,node_tasks,node_boardmodels,node_subtask,node_attachments,node_comments toneAmber
class node_admin,node_settings,node_rules,node_orgmodels,node_logs toneMint
class node_dashboard,node_notifications,node_reports toneRose
class node_auth,node_sso toneIndigo
```

## Components

### Web entry

- [Web routes](https://github.com/itssammael/project_workspace/blob/prod/routes/web.php): `routes/web.php`

### Task management

- [Board controller](https://github.com/itssammael/project_workspace/blob/prod/app/Http/Controllers/TaskBoardController.php): `app/Http/Controllers/TaskBoardController.php`
- [Task controller](https://github.com/itssammael/project_workspace/blob/prod/app/Http/Controllers/TaskController.php): `app/Http/Controllers/TaskController.php`
- [Board and task models](https://github.com/itssammael/project_workspace/blob/prod/app/Models/TaskBoard.php): `app/Models/TaskBoard.php`
- [Subtask model](https://github.com/itssammael/project_workspace/blob/prod/app/Models/SubTask.php): `app/Models/SubTask.php`
- [Task attachments](https://github.com/itssammael/project_workspace/blob/prod/app/Models/SubTaskAttachment.php): `app/Models/SubTaskAttachment.php`
- [Task comments](https://github.com/itssammael/project_workspace/blob/prod/app/Models/SubTaskComment.php): `app/Models/SubTaskComment.php`

### Organization and policy

- [Admin management](https://github.com/itssammael/project_workspace/blob/prod/app/Http/Controllers/AdminManagementController.php): `app/Http/Controllers/AdminManagementController.php`
- [Admin settings](https://github.com/itssammael/project_workspace/blob/prod/app/Http/Controllers/AdminSettingsController.php): `app/Http/Controllers/AdminSettingsController.php`
- [Rule evaluation](https://github.com/itssammael/project_workspace/blob/prod/app/Services/SystemRuleEvaluator.php): `app/Services/SystemRuleEvaluator.php`
- [Organization models](https://github.com/itssammael/project_workspace/blob/prod/app/Models/Department.php): `app/Models/Department.php`
- [System logs](https://github.com/itssammael/project_workspace/blob/prod/app/Models/SystemLog.php): `app/Models/SystemLog.php`

### Insights and messaging

- [Dashboard data](https://github.com/itssammael/project_workspace/blob/prod/app/Services/DashboardDataService.php): `app/Services/DashboardDataService.php`
- [Notifications](https://github.com/itssammael/project_workspace/blob/prod/app/Services/NotificationService.php): `app/Services/NotificationService.php`
- [Support reports](https://github.com/itssammael/project_workspace/blob/prod/app/Http/Controllers/SupportFunctionReportsController.php): `app/Http/Controllers/SupportFunctionReportsController.php`

### Identity

- [User identity](https://github.com/itssammael/project_workspace/blob/prod/app/Models/User.php): `app/Models/User.php`
- [SSO endpoints](https://github.com/itssammael/project_workspace/blob/prod/app/Http/Controllers/SsoClientController.php): `app/Http/Controllers/SsoClientController.php`

### Other components

- **User**

## Connections

- User → Web routes: sends request (evidence: `routes/web.php`)
- Web routes → Board controller: routes board requests (evidence: `routes/web.php`)
- Web routes → Task controller: routes task requests (evidence: `routes/web.php`)
- Web routes → Admin management: routes admin requests (evidence: `routes/web.php`)
- Web routes → Admin settings: routes settings requests (evidence: `routes/web.php`)
- Web routes → Support reports: routes report requests (evidence: `routes/web.php`)
- Web routes → Notifications: routes notification requests (evidence: `routes/web.php`)
- Board controller → Board and task models: loads board data (evidence: `app/Http/Controllers/TaskBoardController.php`)
- Board controller → Subtask model: loads subtasks (evidence: `app/Http/Controllers/TaskBoardController.php`)
- Board controller → Task attachments: loads attachments (evidence: `app/Http/Controllers/TaskBoardController.php`)
- Board controller → Task comments: loads comments (evidence: `app/Http/Controllers/TaskBoardController.php`)
- Task controller → Board and task models: loads task boards (evidence: `app/Http/Controllers/TaskController.php`)
- Board and task models → Subtask model: has subtasks (evidence: `app/Models/Task.php`)
- Subtask model → Task attachments: has attachments (evidence: `app/Models/SubTask.php`)
- Subtask model → Task comments: has comments (evidence: `app/Models/SubTask.php`)
- Admin management → Organization models: manages organization (evidence: `app/Http/Controllers/AdminManagementController.php`)
- Admin management → Rule evaluation: scopes access (evidence: `app/Http/Controllers/AdminManagementController.php`)
- Admin settings → Rule evaluation: manages rules (evidence: `app/Http/Controllers/AdminSettingsController.php`)
- Admin management → System logs: records changes (evidence: `app/Http/Controllers/AdminManagementController.php`)
- User identity → Organization models: has member (evidence: `app/Models/Member.php`)
- User identity → SSO endpoints: supports SSO
- Dashboard data → Board and task models: reads board data (evidence: `app/Services/DashboardDataService.php`)
- Dashboard data → Rule evaluation: uses access rules (evidence: `app/Services/DashboardDataService.php`)
- Notifications → Board and task models: reads task context (evidence: `app/Services/NotificationService.php`)
- Support reports → Organization models: uses organization data
