# ismael548/sistema-educativo- architecture

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

- Interactive diagram: https://gitdiagram.com/ismael548/sistema-educativo-
- Repository: https://github.com/ismael548/sistema-educativo-

## Overview

Aether LMS is a web learning platform for students and instructors. Students enter a portal to browse lessons, resume learning, view linked course materials, track completion, submit practice work, chat, and join live classrooms; instructors manage lessons and review submissions. The graph follows documented routes and sampled imports/calls to Supabase and link utilities. The README documents Jitsi, Storage, and realtime capabilities, but their full wiring and the SQL schema were not sampled, so those details are represented only where documented.

Main entry points: [`src/lib/supabase/client.ts`](https://github.com/ismael548/sistema-educativo-/blob/main/src/lib/supabase/client.ts) (Supabase browser client), [`src/components/files/file-hub.tsx`](https://github.com/ismael548/sistema-educativo-/blob/main/src/components/files/file-hub.tsx) (Materials and submissions), [`src/components/providers/role-provider.tsx`](https://github.com/ismael548/sistema-educativo-/blob/main/src/components/providers/role-provider.tsx) (Role and progress state), [`src/app/(dashboard)/courses/[courseId]/lessons/[lessonId]/page.tsx`](https://github.com/ismael548/sistema-educativo-/blob/main/src/app/(dashboard)/courses/%5BcourseId%5D/lessons/%5BlessonId%5D/page.tsx) (Lesson experience)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and navigation"]
  node_landing["Landing and access<br/>[page.tsx]"]
  node_role["Role and progress state<br/>[role-provider.tsx]"]
  node_dashboard_shell["Dashboard shell<br/>[layout.tsx]"]
  node_navigation["Sidebar navigation<br/>[sidebar.tsx]"]
  node_topbar["Dashboard topbar<br/>[topbar.tsx]"]
end

subgraph group_learning["Courses and learning"]
  node_student_dashboard["Student portal<br/>[page.tsx]"]
  node_admin["Instructor management<br/>[page.tsx]"]
  node_lesson_page["Lesson experience<br/>[page.tsx]"]
  node_video["Lesson video player<br/>[VideoPlayer.tsx]"]
  node_video_alt["Course video player<br/>[video-player.tsx]"]
  node_drive["External link helpers<br/>[driveHelpers.ts]"]
  node_files_route["Files route<br/>[page.tsx]"]
  node_file_hub["Materials and submissions<br/>[file-hub.tsx]"]
  node_validation["File validation<br/>[file-validation.ts]"]
end

subgraph group_collab["Live and collaboration"]
  node_chat["Lesson chat<br/>[lesson-chat.tsx]"]
  node_live_route["Live room route<br/>[page.tsx]"]
  node_classroom["Virtual classroom"]
  node_jitsi["Jitsi Meet service"]
end

subgraph group_platform["Data and platform"]
  node_supabase_client["Supabase browser client<br/>[client.ts]"]
  node_supabase_server["Supabase server client<br/>[server.ts]"]
  node_types["Database types<br/>[types.ts]"]
  node_database[("Supabase database and storage<br/>[schema.sql]")]
end

node_learner(("Student or instructor"))

node_learner -->|"opens"| node_landing
node_landing -->|"uses role state"| node_role
node_learner -->|"enters portal"| node_student_dashboard
node_dashboard_shell -->|"renders"| node_navigation
node_dashboard_shell -->|"renders"| node_topbar
node_student_dashboard -->|"reads progress"| node_role
node_student_dashboard -->|"queries data"| node_supabase_client
node_admin -->|"manages lessons"| node_supabase_client
node_admin -->|"formats links"| node_drive
node_lesson_page -->|"loads lesson data"| node_supabase_client
node_lesson_page -->|"renders player"| node_video
node_lesson_page -->|"renders chat"| node_chat
node_lesson_page -->|"tracks progress"| node_role
node_video -->|"resolves media links"| node_drive
node_files_route -->|"renders hub"| node_file_hub
node_file_hub -->|"reads and writes"| node_supabase_client
node_file_hub -->|"validates links"| node_drive
node_file_hub -->|"uses user context"| node_role
node_chat -->|"loads and sends messages"| node_supabase_client
node_chat -->|"uses user context"| node_role
node_live_route -->|"renders room"| node_classroom
node_classroom -->|"uses client"| node_supabase_client
node_classroom -->|"uses chat"| node_chat
node_classroom -.->|"hosts live meeting"| node_jitsi
node_supabase_client -.->|"accesses data"| node_database
node_supabase_server -.->|"connects server-side"| node_database
node_validation -.->|"validates uploads"| node_file_hub
node_types -.->|"models records"| node_database

click node_landing "https://github.com/ismael548/sistema-educativo-/blob/main/src/app/page.tsx"
click node_role "https://github.com/ismael548/sistema-educativo-/blob/main/src/components/providers/role-provider.tsx"
click node_dashboard_shell "https://github.com/ismael548/sistema-educativo-/blob/main/src/app/(dashboard)/layout.tsx"
click node_navigation "https://github.com/ismael548/sistema-educativo-/blob/main/src/components/layout/sidebar.tsx"
click node_topbar "https://github.com/ismael548/sistema-educativo-/blob/main/src/components/layout/topbar.tsx"
click node_student_dashboard "https://github.com/ismael548/sistema-educativo-/blob/main/src/app/(dashboard)/student/page.tsx"
click node_admin "https://github.com/ismael548/sistema-educativo-/blob/main/src/app/(dashboard)/admin/page.tsx"
click node_lesson_page "https://github.com/ismael548/sistema-educativo-/blob/main/src/app/(dashboard)/courses/%5BcourseId%5D/lessons/%5BlessonId%5D/page.tsx"
click node_video "https://github.com/ismael548/sistema-educativo-/blob/main/src/components/VideoPlayer.tsx"
click node_video_alt "https://github.com/ismael548/sistema-educativo-/blob/main/src/components/courses/video-player.tsx"
click node_drive "https://github.com/ismael548/sistema-educativo-/blob/main/src/utils/driveHelpers.ts"
click node_files_route "https://github.com/ismael548/sistema-educativo-/blob/main/src/app/(dashboard)/files/page.tsx"
click node_file_hub "https://github.com/ismael548/sistema-educativo-/blob/main/src/components/files/file-hub.tsx"
click node_validation "https://github.com/ismael548/sistema-educativo-/blob/main/src/lib/security/file-validation.ts"
click node_chat "https://github.com/ismael548/sistema-educativo-/blob/main/src/components/chat/lesson-chat.tsx"
click node_live_route "https://github.com/ismael548/sistema-educativo-/blob/main/src/app/(dashboard)/live/%5BroomId%5D/page.tsx"
click node_classroom "https://github.com/ismael548/sistema-educativo-/blob/main/src/components/live/virtual-classroom.tsx"
click node_supabase_client "https://github.com/ismael548/sistema-educativo-/blob/main/src/lib/supabase/client.ts"
click node_supabase_server "https://github.com/ismael548/sistema-educativo-/blob/main/src/lib/supabase/server.ts"
click node_types "https://github.com/ismael548/sistema-educativo-/blob/main/src/lib/supabase/types.ts"
click node_database "https://github.com/ismael548/sistema-educativo-/blob/main/supabase/schema.sql"

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_landing,node_role,node_dashboard_shell,node_navigation,node_topbar toneBlue
class node_student_dashboard,node_admin,node_lesson_page,node_video,node_video_alt,node_drive,node_files_route,node_file_hub,node_validation toneAmber
class node_chat,node_live_route,node_classroom,node_jitsi toneMint
class node_supabase_client,node_supabase_server,node_types,node_database toneRose
class node_learner toneIndigo
```

## Components

### Entry and navigation

- [Landing and access](https://github.com/ismael548/sistema-educativo-/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Role and progress state](https://github.com/ismael548/sistema-educativo-/blob/main/src/components/providers/role-provider.tsx): `src/components/providers/role-provider.tsx`
- [Dashboard shell](https://github.com/ismael548/sistema-educativo-/blob/main/src/app/(dashboard)/layout.tsx): `src/app/(dashboard)/layout.tsx`
- [Sidebar navigation](https://github.com/ismael548/sistema-educativo-/blob/main/src/components/layout/sidebar.tsx): `src/components/layout/sidebar.tsx`
- [Dashboard topbar](https://github.com/ismael548/sistema-educativo-/blob/main/src/components/layout/topbar.tsx): `src/components/layout/topbar.tsx`

### Courses and learning

- [Student portal](https://github.com/ismael548/sistema-educativo-/blob/main/src/app/(dashboard)/student/page.tsx): `src/app/(dashboard)/student/page.tsx`
- [Instructor management](https://github.com/ismael548/sistema-educativo-/blob/main/src/app/(dashboard)/admin/page.tsx): `src/app/(dashboard)/admin/page.tsx`
- [Lesson experience](https://github.com/ismael548/sistema-educativo-/blob/main/src/app/(dashboard)/courses/%5BcourseId%5D/lessons/%5BlessonId%5D/page.tsx): `src/app/(dashboard)/courses/[courseId]/lessons/[lessonId]/page.tsx`
- [Lesson video player](https://github.com/ismael548/sistema-educativo-/blob/main/src/components/VideoPlayer.tsx): `src/components/VideoPlayer.tsx`
- [Course video player](https://github.com/ismael548/sistema-educativo-/blob/main/src/components/courses/video-player.tsx): `src/components/courses/video-player.tsx`
- [External link helpers](https://github.com/ismael548/sistema-educativo-/blob/main/src/utils/driveHelpers.ts): `src/utils/driveHelpers.ts`
- [Files route](https://github.com/ismael548/sistema-educativo-/blob/main/src/app/(dashboard)/files/page.tsx): `src/app/(dashboard)/files/page.tsx`
- [Materials and submissions](https://github.com/ismael548/sistema-educativo-/blob/main/src/components/files/file-hub.tsx): `src/components/files/file-hub.tsx`
- [File validation](https://github.com/ismael548/sistema-educativo-/blob/main/src/lib/security/file-validation.ts): `src/lib/security/file-validation.ts`

### Live and collaboration

- [Lesson chat](https://github.com/ismael548/sistema-educativo-/blob/main/src/components/chat/lesson-chat.tsx): `src/components/chat/lesson-chat.tsx`
- [Live room route](https://github.com/ismael548/sistema-educativo-/blob/main/src/app/(dashboard)/live/%5BroomId%5D/page.tsx): `src/app/(dashboard)/live/[roomId]/page.tsx`
- [Virtual classroom](https://github.com/ismael548/sistema-educativo-/blob/main/src/components/live/virtual-classroom.tsx): `src/components/live/virtual-classroom.tsx`
- **Jitsi Meet service**

### Data and platform

- [Supabase browser client](https://github.com/ismael548/sistema-educativo-/blob/main/src/lib/supabase/client.ts): `src/lib/supabase/client.ts`
- [Supabase server client](https://github.com/ismael548/sistema-educativo-/blob/main/src/lib/supabase/server.ts): `src/lib/supabase/server.ts`
- [Database types](https://github.com/ismael548/sistema-educativo-/blob/main/src/lib/supabase/types.ts): `src/lib/supabase/types.ts`
- [Supabase database and storage](https://github.com/ismael548/sistema-educativo-/blob/main/supabase/schema.sql): `supabase/schema.sql`

### Other components

- **Student or instructor**

## Connections

- Student or instructor → Landing and access: opens (evidence: `src/app/page.tsx`)
- Landing and access → Role and progress state: uses role state (evidence: `src/app/page.tsx`)
- Student or instructor → Student portal: enters portal (evidence: `README.md`)
- Dashboard shell → Sidebar navigation: renders (evidence: `src/app/(dashboard)/layout.tsx`)
- Dashboard shell → Dashboard topbar: renders (evidence: `src/app/(dashboard)/layout.tsx`)
- Student portal → Role and progress state: reads progress (evidence: `src/app/(dashboard)/student/page.tsx`)
- Student portal → Supabase browser client: queries data (evidence: `src/app/(dashboard)/student/page.tsx`)
- Instructor management → Supabase browser client: manages lessons (evidence: `src/app/(dashboard)/admin/page.tsx`)
- Instructor management → External link helpers: formats links (evidence: `src/app/(dashboard)/admin/page.tsx`)
- Lesson experience → Supabase browser client: loads lesson data (evidence: `src/app/(dashboard)/courses/[courseId]/lessons/[lessonId]/page.tsx`)
- Lesson experience → Lesson video player: renders player (evidence: `src/app/(dashboard)/courses/[courseId]/lessons/[lessonId]/page.tsx`)
- Lesson experience → Lesson chat: renders chat (evidence: `src/app/(dashboard)/courses/[courseId]/lessons/[lessonId]/page.tsx`)
- Lesson experience → Role and progress state: tracks progress (evidence: `src/app/(dashboard)/courses/[courseId]/lessons/[lessonId]/page.tsx`)
- Lesson video player → External link helpers: resolves media links (evidence: `src/components/VideoPlayer.tsx`)
- Files route → Materials and submissions: renders hub (evidence: `src/app/(dashboard)/files/page.tsx`)
- Materials and submissions → Supabase browser client: reads and writes (evidence: `src/components/files/file-hub.tsx`)
- Materials and submissions → External link helpers: validates links (evidence: `src/components/files/file-hub.tsx`)
- Materials and submissions → Role and progress state: uses user context (evidence: `src/components/files/file-hub.tsx`)
- Lesson chat → Supabase browser client: loads and sends messages (evidence: `src/components/chat/lesson-chat.tsx`)
- Lesson chat → Role and progress state: uses user context (evidence: `src/components/chat/lesson-chat.tsx`)
- Live room route → Virtual classroom: renders room (evidence: `src/app/(dashboard)/live/[roomId]/page.tsx`)
- Virtual classroom → Supabase browser client: uses client (evidence: `src/components/live/virtual-classroom.tsx`)
- Virtual classroom → Lesson chat: uses chat (evidence: `src/components/live/virtual-classroom.tsx`)
- Virtual classroom → Jitsi Meet service: hosts live meeting (evidence: `README.md`)
- Supabase browser client → Supabase database and storage: accesses data (evidence: `README.md`)
- Supabase server client → Supabase database and storage: connects server-side (evidence: `README.md`)
- File validation → Materials and submissions: validates uploads
- Database types → Supabase database and storage: models records
