# kinneth-kun/to-do-system architecture

> Architecture diagram of the GitHub repository kinneth-kun/to-do-system, 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/kinneth-kun/to-do-system
- Repository: https://github.com/kinneth-kun/to-do-system

## Overview

This appears to be a Laravel project and task management application: users work with projects, tasks, updates and collaborators, while administrators manage users, settings and oversight views. The graph follows the documented route-to-controller dispatch and sampled controller/service relationships. The README describes Laravel generally rather than this product, and several subsystems are represented by paths or imports in the SOURCE INDEX rather than inspected implementation, so those links are omitted where their caller is not evidenced.

Main entry points: [`routes/web.php`](https://github.com/kinneth-kun/to-do-system/blob/main/routes/web.php) (Web routes), [`app/Services/TaskService.php`](https://github.com/kinneth-kun/to-do-system/blob/main/app/Services/TaskService.php) (Task operations), [`app/Services/ProjectService.php`](https://github.com/kinneth-kun/to-do-system/blob/main/app/Services/ProjectService.php) (Project operations), [`app/Services/ProjectHealthService.php`](https://github.com/kinneth-kun/to-do-system/blob/main/app/Services/ProjectHealthService.php) (Health evaluation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry and workspace"]
  node_routes["Web routes<br/>[web.php]"]
  node_middleware["Web middleware<br/>[app.php]"]
  node_auth["Sign-in"]
  node_workspace["Workspace views<br/>[app.blade.php]"]
  node_dashboard["Dashboard"]
  node_calendar["Calendar"]
  node_search["Search"]
  node_notifications_ui["Notification inbox"]
  node_lookup["Lookups and quick create"]
end

subgraph group_work["Project and task work"]
  node_projects["Project workflow"]
  node_project_domain["Project domain<br/>[Project.php]"]
  node_tasks["Task workflow<br/>[TaskController.php]"]
  node_task_domain["Task domain<br/>[Task.php]"]
  node_task_updates["Task history<br/>[TaskUpdate.php]"]
  node_attachments["Attachments"]
end

subgraph group_services["Workflow services"]
  node_task_service["Task operations<br/>[TaskService.php]"]
  node_project_service["Project operations<br/>[ProjectService.php]"]
  node_health["Health evaluation"]
  node_notifications["Notifications"]
  node_activity["Activity logging<br/>[ActivityLogger.php]"]
  node_settings["Settings<br/>[Settings.php]"]
  node_briefing["AI briefing"]
  node_digest["Daily digest"]
end

subgraph group_admin["Administration and insights"]
  node_admin_users["User administration<br/>[UserController.php]"]
  node_executive["Executive dashboard"]
  node_admin_settings["Settings administration"]
  node_activity_log["Activity log"]
end

node_user(("User"))

node_user -.->|"sends requests"| node_routes
node_routes -->|"runs through"| node_middleware
node_routes -->|"dispatches to"| node_auth
node_routes -->|"dispatches to"| node_dashboard
node_routes -->|"dispatches to"| node_calendar
node_routes -->|"dispatches to"| node_search
node_routes -->|"dispatches to"| node_projects
node_routes -->|"dispatches to"| node_tasks
node_routes -->|"dispatches to"| node_admin_users
node_routes -->|"dispatches to"| node_executive
node_routes -->|"dispatches to"| node_admin_settings
node_routes -->|"dispatches to"| node_activity_log
node_routes -->|"dispatches to"| node_notifications_ui
node_routes -->|"dispatches to"| node_lookup
node_routes -->|"dispatches to"| node_attachments
node_workspace -->|"reads settings"| node_settings
node_projects -->|"delegates to"| node_project_service
node_projects -->|"queries"| node_project_domain
node_project_service -->|"manages"| node_project_domain
node_project_service -->|"sends notifications"| node_notifications
node_project_service -->|"records activity"| node_activity
node_project_service -->|"refreshes health"| node_health
node_tasks -->|"delegates to"| node_task_service
node_tasks -->|"queries"| node_task_domain
node_task_service -->|"updates"| node_task_domain
node_task_service -->|"records history"| node_task_updates
node_task_service -->|"records activity"| node_activity
node_task_service -->|"sends notifications"| node_notifications
node_task_service -->|"refreshes health"| node_health
node_task_service -->|"reads settings"| node_settings
node_task_domain -->|"belongs to"| node_project_domain
node_health -->|"evaluates"| node_project_domain
node_health -->|"reads thresholds"| node_settings
node_notifications_ui -.->|"returns responses"| node_routes
node_admin_users -->|"records changes"| node_activity
node_admin_settings -->|"records changes"| node_activity
node_admin_settings -->|"updates"| node_settings
node_executive -->|"uses health"| node_health
node_executive -->|"queries"| node_project_domain
node_activity_log -.->|"reads records"| node_activity
node_digest -.->|"uses summary"| node_briefing
node_briefing -->|"reads settings"| node_settings

click node_routes "https://github.com/kinneth-kun/to-do-system/blob/main/routes/web.php"
click node_middleware "https://github.com/kinneth-kun/to-do-system/blob/main/bootstrap/app.php"
click node_auth "https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/Auth/LoginController.php"
click node_workspace "https://github.com/kinneth-kun/to-do-system/blob/main/resources/views/components/layouts/app.blade.php"
click node_dashboard "https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/DashboardController.php"
click node_calendar "https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/CalendarController.php"
click node_search "https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/SearchController.php"
click node_projects "https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/ProjectController.php"
click node_project_domain "https://github.com/kinneth-kun/to-do-system/blob/main/app/Models/Project.php"
click node_tasks "https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/TaskController.php"
click node_task_domain "https://github.com/kinneth-kun/to-do-system/blob/main/app/Models/Task.php"
click node_task_updates "https://github.com/kinneth-kun/to-do-system/blob/main/app/Models/TaskUpdate.php"
click node_task_service "https://github.com/kinneth-kun/to-do-system/blob/main/app/Services/TaskService.php"
click node_project_service "https://github.com/kinneth-kun/to-do-system/blob/main/app/Services/ProjectService.php"
click node_health "https://github.com/kinneth-kun/to-do-system/blob/main/app/Services/ProjectHealthService.php"
click node_notifications "https://github.com/kinneth-kun/to-do-system/blob/main/app/Services/NotificationService.php"
click node_activity "https://github.com/kinneth-kun/to-do-system/blob/main/app/Services/ActivityLogger.php"
click node_settings "https://github.com/kinneth-kun/to-do-system/blob/main/app/Services/Settings.php"
click node_briefing "https://github.com/kinneth-kun/to-do-system/blob/main/app/Services/AI/BriefingService.php"
click node_digest "https://github.com/kinneth-kun/to-do-system/blob/main/app/Console/Commands/SendDailyDigest.php"
click node_admin_users "https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/Admin/UserController.php"
click node_executive "https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/Admin/ExecutiveDashboardController.php"
click node_admin_settings "https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/Admin/SettingController.php"
click node_activity_log "https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/Admin/ActivityLogController.php"
click node_notifications_ui "https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/NotificationController.php"
click node_lookup "https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/LookupController.php"
click node_attachments "https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/AttachmentController.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_middleware,node_auth,node_workspace,node_dashboard,node_calendar,node_search,node_notifications_ui,node_lookup,node_user toneBlue
class node_projects,node_project_domain,node_tasks,node_task_domain,node_task_updates,node_attachments toneAmber
class node_task_service,node_project_service,node_health,node_notifications,node_activity,node_settings,node_briefing,node_digest toneMint
class node_admin_users,node_executive,node_admin_settings,node_activity_log toneRose
```

## Components

### Web entry and workspace

- [Web routes](https://github.com/kinneth-kun/to-do-system/blob/main/routes/web.php): `routes/web.php`
- [Web middleware](https://github.com/kinneth-kun/to-do-system/blob/main/bootstrap/app.php): `bootstrap/app.php`
- [Sign-in](https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/Auth/LoginController.php): `app/Http/Controllers/Auth/LoginController.php`
- [Workspace views](https://github.com/kinneth-kun/to-do-system/blob/main/resources/views/components/layouts/app.blade.php): `resources/views/components/layouts/app.blade.php`
- [Dashboard](https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/DashboardController.php): `app/Http/Controllers/DashboardController.php`
- [Calendar](https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/CalendarController.php): `app/Http/Controllers/CalendarController.php`
- [Search](https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/SearchController.php): `app/Http/Controllers/SearchController.php`
- [Notification inbox](https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/NotificationController.php): `app/Http/Controllers/NotificationController.php`
- [Lookups and quick create](https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/LookupController.php): `app/Http/Controllers/LookupController.php`

### Project and task work

- [Project workflow](https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/ProjectController.php): `app/Http/Controllers/ProjectController.php`
- [Project domain](https://github.com/kinneth-kun/to-do-system/blob/main/app/Models/Project.php): `app/Models/Project.php`
- [Task workflow](https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/TaskController.php): `app/Http/Controllers/TaskController.php`
- [Task domain](https://github.com/kinneth-kun/to-do-system/blob/main/app/Models/Task.php): `app/Models/Task.php`
- [Task history](https://github.com/kinneth-kun/to-do-system/blob/main/app/Models/TaskUpdate.php): `app/Models/TaskUpdate.php`
- [Attachments](https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/AttachmentController.php): `app/Http/Controllers/AttachmentController.php`

### Workflow services

- [Task operations](https://github.com/kinneth-kun/to-do-system/blob/main/app/Services/TaskService.php): `app/Services/TaskService.php`
- [Project operations](https://github.com/kinneth-kun/to-do-system/blob/main/app/Services/ProjectService.php): `app/Services/ProjectService.php`
- [Health evaluation](https://github.com/kinneth-kun/to-do-system/blob/main/app/Services/ProjectHealthService.php): `app/Services/ProjectHealthService.php`
- [Notifications](https://github.com/kinneth-kun/to-do-system/blob/main/app/Services/NotificationService.php): `app/Services/NotificationService.php`
- [Activity logging](https://github.com/kinneth-kun/to-do-system/blob/main/app/Services/ActivityLogger.php): `app/Services/ActivityLogger.php`
- [Settings](https://github.com/kinneth-kun/to-do-system/blob/main/app/Services/Settings.php): `app/Services/Settings.php`
- [AI briefing](https://github.com/kinneth-kun/to-do-system/blob/main/app/Services/AI/BriefingService.php): `app/Services/AI/BriefingService.php`
- [Daily digest](https://github.com/kinneth-kun/to-do-system/blob/main/app/Console/Commands/SendDailyDigest.php): `app/Console/Commands/SendDailyDigest.php`

### Administration and insights

- [User administration](https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/Admin/UserController.php): `app/Http/Controllers/Admin/UserController.php`
- [Executive dashboard](https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/Admin/ExecutiveDashboardController.php): `app/Http/Controllers/Admin/ExecutiveDashboardController.php`
- [Settings administration](https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/Admin/SettingController.php): `app/Http/Controllers/Admin/SettingController.php`
- [Activity log](https://github.com/kinneth-kun/to-do-system/blob/main/app/Http/Controllers/Admin/ActivityLogController.php): `app/Http/Controllers/Admin/ActivityLogController.php`

### Other components

- **User**

## Connections

- User → Web routes: sends requests
- Web routes → Web middleware: runs through (evidence: `bootstrap/app.php`)
- Web routes → Sign-in: dispatches to (evidence: `routes/web.php`)
- Web routes → Dashboard: dispatches to (evidence: `routes/web.php`)
- Web routes → Calendar: dispatches to (evidence: `routes/web.php`)
- Web routes → Search: dispatches to (evidence: `routes/web.php`)
- Web routes → Project workflow: dispatches to (evidence: `routes/web.php`)
- Web routes → Task workflow: dispatches to (evidence: `routes/web.php`)
- Web routes → User administration: dispatches to (evidence: `routes/web.php`)
- Web routes → Executive dashboard: dispatches to (evidence: `routes/web.php`)
- Web routes → Settings administration: dispatches to (evidence: `routes/web.php`)
- Web routes → Activity log: dispatches to (evidence: `routes/web.php`)
- Web routes → Notification inbox: dispatches to (evidence: `routes/web.php`)
- Web routes → Lookups and quick create: dispatches to (evidence: `routes/web.php`)
- Web routes → Attachments: dispatches to (evidence: `routes/web.php`)
- Workspace views → Settings: reads settings (evidence: `resources/views/components/layouts/app.blade.php`)
- Project workflow → Project operations: delegates to (evidence: `app/Http/Controllers/ProjectController.php`)
- Project workflow → Project domain: queries (evidence: `app/Http/Controllers/ProjectController.php`)
- Project operations → Project domain: manages (evidence: `app/Services/ProjectService.php`)
- Project operations → Notifications: sends notifications (evidence: `app/Services/ProjectService.php`)
- Project operations → Activity logging: records activity (evidence: `app/Services/ProjectService.php`)
- Project operations → Health evaluation: refreshes health (evidence: `app/Services/ProjectService.php`)
- Task workflow → Task operations: delegates to (evidence: `app/Http/Controllers/TaskController.php`)
- Task workflow → Task domain: queries (evidence: `app/Http/Controllers/TaskController.php`)
- Task operations → Task domain: updates (evidence: `app/Services/TaskService.php`)
- Task operations → Task history: records history (evidence: `app/Services/TaskService.php`)
- Task operations → Activity logging: records activity (evidence: `app/Services/TaskService.php`)
- Task operations → Notifications: sends notifications (evidence: `app/Services/TaskService.php`)
- Task operations → Health evaluation: refreshes health (evidence: `app/Services/TaskService.php`)
- Task operations → Settings: reads settings (evidence: `app/Services/TaskService.php`)
- Task domain → Project domain: belongs to (evidence: `app/Models/Task.php`)
- Health evaluation → Project domain: evaluates (evidence: `app/Services/ProjectHealthService.php`)
- Health evaluation → Settings: reads thresholds (evidence: `app/Services/ProjectHealthService.php`)
- Notification inbox → Web routes: returns responses (evidence: `routes/web.php`)
- User administration → Activity logging: records changes (evidence: `app/Http/Controllers/Admin/UserController.php`)
- Settings administration → Activity logging: records changes (evidence: `app/Http/Controllers/Admin/SettingController.php`)
- Settings administration → Settings: updates (evidence: `app/Http/Controllers/Admin/SettingController.php`)
- Executive dashboard → Health evaluation: uses health (evidence: `app/Http/Controllers/Admin/ExecutiveDashboardController.php`)
- Executive dashboard → Project domain: queries (evidence: `app/Http/Controllers/Admin/ExecutiveDashboardController.php`)
- Activity log → Activity logging: reads records
- Daily digest → AI briefing: uses summary
- AI briefing → Settings: reads settings (evidence: `app/Services/AI/BriefingService.php`)
