# heangdev/ai-reantask architecture

> Architecture diagram of the GitHub repository heangdev/ai-reantask, 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/heangdev/ai-reantask
- Repository: https://github.com/heangdev/ai-reantask

## Overview

This repository combines an education-management frontend—covering classes, students, assignments, tasks, dashboards, reports, and account administration—with a Laravel backend that currently appears to be a framework scaffold. The visible user-facing flow is navigation through the React application into role-specific feature areas; global search builds selectable page, assignment, task, and settings actions. Backend request handling is wired through Laravel’s bootstrap and web routes. Evidence is limited: the README is empty and most feature implementations were not sampled, so unverified frontend routing and feature-to-feature calls are not drawn.

Main entry points: [`app/src/features/search/hooks/useSearchItems.tsx`](https://github.com/heangdev/ai-reantask/blob/master/app/src/features/search/hooks/useSearchItems.tsx) (Global search), [`api/bootstrap/app.php`](https://github.com/heangdev/ai-reantask/blob/master/api/bootstrap/app.php) (Laravel bootstrap), [`api/app/Models/User.php`](https://github.com/heangdev/ai-reantask/blob/master/api/app/Models/User.php) (User model), [`api/public/index.php`](https://github.com/heangdev/ai-reantask/blob/master/api/public/index.php) (HTTP entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend shell"]
  node_app_shell["App shell<br/>[App.tsx]"]
  node_router["App router<br/>[router.tsx]"]
  node_search["Global search<br/>[useSearchItems.tsx]"]
end

subgraph group_learning["Learning management"]
  node_assignments["Assignments"]
  node_classes["Classes"]
  node_students["Students"]
  node_tasks["Tasks"]
  node_dashboard["Dashboards"]
  node_reports["Score reports"]
end

subgraph group_admin["Administration"]
  node_auth["Authentication"]
  node_account["Account"]
  node_teachers["Teachers"]
  node_subjects["Subjects"]
  node_users["User administration"]
  node_integrations["Integrations"]
  node_notifications["Notifications"]
  node_settings["Settings"]
end

subgraph group_backend["Laravel backend"]
  node_laravel_entry["HTTP entry<br/>[index.php]"]
  node_laravel_boot["Laravel bootstrap<br/>[app.php]"]
  node_web_routes["Web routes<br/>[web.php]"]
  node_user_model["User model<br/>[User.php]"]
  node_user_factory["User factory<br/>[UserFactory.php]"]
  node_seeder["Database seeder<br/>[DatabaseSeeder.php]"]
  node_service_provider["App provider"]
end

node_user(("User"))

node_laravel_entry -->|"boots"| node_laravel_boot
node_laravel_boot -->|"registers routes"| node_web_routes
node_user_factory -->|"creates"| node_user_model
node_seeder -->|"seeds"| node_user_model
node_search -->|"reads assignments"| node_assignments
node_search -->|"scopes classes"| node_classes
node_search -->|"lists tasks"| node_tasks
node_search -->|"reads session"| node_auth

click node_app_shell "https://github.com/heangdev/ai-reantask/blob/master/app/src/app/App.tsx"
click node_router "https://github.com/heangdev/ai-reantask/blob/master/app/src/app/router.tsx"
click node_search "https://github.com/heangdev/ai-reantask/blob/master/app/src/features/search/hooks/useSearchItems.tsx"
click node_assignments "https://github.com/heangdev/ai-reantask/tree/master/app/src/features/assignments"
click node_classes "https://github.com/heangdev/ai-reantask/tree/master/app/src/features/classes"
click node_students "https://github.com/heangdev/ai-reantask/tree/master/app/src/features/students"
click node_tasks "https://github.com/heangdev/ai-reantask/tree/master/app/src/features/tasks"
click node_dashboard "https://github.com/heangdev/ai-reantask/tree/master/app/src/features/dashboard"
click node_reports "https://github.com/heangdev/ai-reantask/tree/master/app/src/features/reports"
click node_auth "https://github.com/heangdev/ai-reantask/tree/master/app/src/features/auth"
click node_account "https://github.com/heangdev/ai-reantask/tree/master/app/src/features/account"
click node_teachers "https://github.com/heangdev/ai-reantask/tree/master/app/src/features/teachers"
click node_subjects "https://github.com/heangdev/ai-reantask/tree/master/app/src/features/subjects"
click node_users "https://github.com/heangdev/ai-reantask/tree/master/app/src/features/users"
click node_integrations "https://github.com/heangdev/ai-reantask/tree/master/app/src/features/integrations"
click node_notifications "https://github.com/heangdev/ai-reantask/tree/master/app/src/features/notifications"
click node_settings "https://github.com/heangdev/ai-reantask/tree/master/app/src/features/settings"
click node_laravel_entry "https://github.com/heangdev/ai-reantask/blob/master/api/public/index.php"
click node_laravel_boot "https://github.com/heangdev/ai-reantask/blob/master/api/bootstrap/app.php"
click node_web_routes "https://github.com/heangdev/ai-reantask/blob/master/api/routes/web.php"
click node_user_model "https://github.com/heangdev/ai-reantask/blob/master/api/app/Models/User.php"
click node_user_factory "https://github.com/heangdev/ai-reantask/blob/master/api/database/factories/UserFactory.php"
click node_seeder "https://github.com/heangdev/ai-reantask/blob/master/api/database/seeders/DatabaseSeeder.php"
click node_service_provider "https://github.com/heangdev/ai-reantask/blob/master/api/app/Providers/AppServiceProvider.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_app_shell,node_router,node_search,node_user toneBlue
class node_assignments,node_classes,node_students,node_tasks,node_dashboard,node_reports toneAmber
class node_auth,node_account,node_teachers,node_subjects,node_users,node_integrations,node_notifications,node_settings toneMint
class node_laravel_entry,node_laravel_boot,node_web_routes,node_user_model,node_user_factory,node_seeder,node_service_provider toneRose
```

## Components

### Frontend shell

- [App shell](https://github.com/heangdev/ai-reantask/blob/master/app/src/app/App.tsx): `app/src/app/App.tsx`
- [App router](https://github.com/heangdev/ai-reantask/blob/master/app/src/app/router.tsx): `app/src/app/router.tsx`
- [Global search](https://github.com/heangdev/ai-reantask/blob/master/app/src/features/search/hooks/useSearchItems.tsx): `app/src/features/search/hooks/useSearchItems.tsx`

### Learning management

- [Assignments](https://github.com/heangdev/ai-reantask/tree/master/app/src/features/assignments): `app/src/features/assignments`
- [Classes](https://github.com/heangdev/ai-reantask/tree/master/app/src/features/classes): `app/src/features/classes`
- [Students](https://github.com/heangdev/ai-reantask/tree/master/app/src/features/students): `app/src/features/students`
- [Tasks](https://github.com/heangdev/ai-reantask/tree/master/app/src/features/tasks): `app/src/features/tasks`
- [Dashboards](https://github.com/heangdev/ai-reantask/tree/master/app/src/features/dashboard): `app/src/features/dashboard`
- [Score reports](https://github.com/heangdev/ai-reantask/tree/master/app/src/features/reports): `app/src/features/reports`

### Administration

- [Authentication](https://github.com/heangdev/ai-reantask/tree/master/app/src/features/auth): `app/src/features/auth`
- [Account](https://github.com/heangdev/ai-reantask/tree/master/app/src/features/account): `app/src/features/account`
- [Teachers](https://github.com/heangdev/ai-reantask/tree/master/app/src/features/teachers): `app/src/features/teachers`
- [Subjects](https://github.com/heangdev/ai-reantask/tree/master/app/src/features/subjects): `app/src/features/subjects`
- [User administration](https://github.com/heangdev/ai-reantask/tree/master/app/src/features/users): `app/src/features/users`
- [Integrations](https://github.com/heangdev/ai-reantask/tree/master/app/src/features/integrations): `app/src/features/integrations`
- [Notifications](https://github.com/heangdev/ai-reantask/tree/master/app/src/features/notifications): `app/src/features/notifications`
- [Settings](https://github.com/heangdev/ai-reantask/tree/master/app/src/features/settings): `app/src/features/settings`

### Laravel backend

- [HTTP entry](https://github.com/heangdev/ai-reantask/blob/master/api/public/index.php): `api/public/index.php`
- [Laravel bootstrap](https://github.com/heangdev/ai-reantask/blob/master/api/bootstrap/app.php): `api/bootstrap/app.php`
- [Web routes](https://github.com/heangdev/ai-reantask/blob/master/api/routes/web.php): `api/routes/web.php`
- [User model](https://github.com/heangdev/ai-reantask/blob/master/api/app/Models/User.php): `api/app/Models/User.php`
- [User factory](https://github.com/heangdev/ai-reantask/blob/master/api/database/factories/UserFactory.php): `api/database/factories/UserFactory.php`
- [Database seeder](https://github.com/heangdev/ai-reantask/blob/master/api/database/seeders/DatabaseSeeder.php): `api/database/seeders/DatabaseSeeder.php`
- [App provider](https://github.com/heangdev/ai-reantask/blob/master/api/app/Providers/AppServiceProvider.php): `api/app/Providers/AppServiceProvider.php`

### Other components

- **User**

## Connections

- HTTP entry → Laravel bootstrap: boots (evidence: `api/public/index.php`)
- Laravel bootstrap → Web routes: registers routes (evidence: `api/bootstrap/app.php`)
- User factory → User model: creates (evidence: `api/database/factories/UserFactory.php`)
- Database seeder → User model: seeds (evidence: `api/database/seeders/DatabaseSeeder.php`)
- Global search → Assignments: reads assignments (evidence: `app/src/features/search/hooks/useSearchItems.tsx`)
- Global search → Classes: scopes classes (evidence: `app/src/features/search/hooks/useSearchItems.tsx`)
- Global search → Tasks: lists tasks (evidence: `app/src/features/search/hooks/useSearchItems.tsx`)
- Global search → Authentication: reads session (evidence: `app/src/features/search/hooks/useSearchItems.tsx`)
