# diego-nav05/checker-web architecture

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

- Interactive diagram: https://gitdiagram.com/diego-nav05/checker-web
- Repository: https://github.com/diego-nav05/checker-web

## Overview

Checker is a React attendance app for students and teachers. Users enter through a role-aware home screen; students register, scan session QR codes, and review attendance, while teachers manage classes and run attendance sessions. Supabase provides authentication and the application’s persistent data interface. The source excerpts establish the main routing and several database interactions; unsampled screen logic is represented by its component without inferring additional links.

Main entry points: [`src/App.tsx`](https://github.com/diego-nav05/checker-web/blob/main/src/App.tsx) (Home and routing), [`src/supabase.ts`](https://github.com/diego-nav05/checker-web/blob/main/src/supabase.ts) (Supabase client), [`src/PantallaProfesor.tsx`](https://github.com/diego-nav05/checker-web/blob/main/src/PantallaProfesor.tsx) (Teacher classroom), [`src/PantallaAlumno.tsx`](https://github.com/diego-nav05/checker-web/blob/main/src/PantallaAlumno.tsx) (Student attendance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_bootstrap["React bootstrap<br/>[main.tsx]"]
  node_app["Home and routing<br/>[App.tsx]"]
end

subgraph group_identity["Identity and access"]
  node_registration["Registration and login"]
end

subgraph group_attendance["Attendance workflows"]
  node_student["Student attendance<br/>[PantallaAlumno.tsx]"]
  node_teacher["Teacher classroom"]
  node_management["Teacher management"]
end

subgraph group_shared["Shared services"]
  node_sharing["Share and join QR<br/>[BotonCompartir.tsx]"]
  node_device["Device identity helper<br/>[device.ts]"]
  node_types["Domain types<br/>[types.ts]"]
  node_client["Supabase client<br/>[supabase.ts]"]
end

node_user(("Student or teacher"))
node_supabase[("Supabase backend")]

node_user -->|"opens app"| node_bootstrap
node_bootstrap -->|"renders"| node_app
node_app -->|"routes to"| node_registration
node_app -->|"routes to"| node_student
node_app -->|"routes to"| node_teacher
node_app -->|"routes to"| node_management
node_app -->|"authenticates with"| node_client
node_registration -->|"authenticates and stores profiles"| node_client
node_student -->|"reads and updates attendance"| node_client
node_teacher -->|"manages sessions and attendance"| node_client
node_management -->|"manages class data"| node_client
node_teacher -->|"renders"| node_sharing
node_management -->|"renders"| node_sharing
node_app -->|"renders"| node_sharing
node_client -->|"connects to"| node_supabase
node_student -->|"uses domain types"| node_types
node_teacher -->|"uses domain types"| node_types

click node_bootstrap "https://github.com/diego-nav05/checker-web/blob/main/src/main.tsx"
click node_app "https://github.com/diego-nav05/checker-web/blob/main/src/App.tsx"
click node_registration "https://github.com/diego-nav05/checker-web/blob/main/src/PantallaRegistro.tsx"
click node_student "https://github.com/diego-nav05/checker-web/blob/main/src/PantallaAlumno.tsx"
click node_teacher "https://github.com/diego-nav05/checker-web/blob/main/src/PantallaProfesor.tsx"
click node_management "https://github.com/diego-nav05/checker-web/blob/main/src/PantallaGestionDocente.tsx"
click node_sharing "https://github.com/diego-nav05/checker-web/blob/main/src/BotonCompartir.tsx"
click node_device "https://github.com/diego-nav05/checker-web/blob/main/src/device.ts"
click node_types "https://github.com/diego-nav05/checker-web/blob/main/src/types.ts"
click node_client "https://github.com/diego-nav05/checker-web/blob/main/src/supabase.ts"

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_bootstrap,node_app toneBlue
class node_registration,node_supabase toneAmber
class node_student,node_teacher,node_management toneMint
class node_sharing,node_device,node_types,node_client toneRose
class node_user toneIndigo
```

## Components

### App entry

- [React bootstrap](https://github.com/diego-nav05/checker-web/blob/main/src/main.tsx): `src/main.tsx`
- [Home and routing](https://github.com/diego-nav05/checker-web/blob/main/src/App.tsx): `src/App.tsx`

### Identity and access

- [Registration and login](https://github.com/diego-nav05/checker-web/blob/main/src/PantallaRegistro.tsx): `src/PantallaRegistro.tsx`

### Attendance workflows

- [Student attendance](https://github.com/diego-nav05/checker-web/blob/main/src/PantallaAlumno.tsx): `src/PantallaAlumno.tsx`
- [Teacher classroom](https://github.com/diego-nav05/checker-web/blob/main/src/PantallaProfesor.tsx): `src/PantallaProfesor.tsx`
- [Teacher management](https://github.com/diego-nav05/checker-web/blob/main/src/PantallaGestionDocente.tsx): `src/PantallaGestionDocente.tsx`

### Shared services

- [Share and join QR](https://github.com/diego-nav05/checker-web/blob/main/src/BotonCompartir.tsx): `src/BotonCompartir.tsx`
- [Device identity helper](https://github.com/diego-nav05/checker-web/blob/main/src/device.ts): `src/device.ts`
- [Domain types](https://github.com/diego-nav05/checker-web/blob/main/src/types.ts): `src/types.ts`
- [Supabase client](https://github.com/diego-nav05/checker-web/blob/main/src/supabase.ts): `src/supabase.ts`

### Other components

- **Student or teacher**
- **Supabase backend**

## Connections

- Student or teacher → React bootstrap: opens app
- React bootstrap → Home and routing: renders (evidence: `src/main.tsx`)
- Home and routing → Registration and login: routes to (evidence: `src/App.tsx`)
- Home and routing → Student attendance: routes to (evidence: `src/App.tsx`)
- Home and routing → Teacher classroom: routes to (evidence: `src/App.tsx`)
- Home and routing → Teacher management: routes to (evidence: `src/App.tsx`)
- Home and routing → Supabase client: authenticates with (evidence: `src/App.tsx`)
- Registration and login → Supabase client: authenticates and stores profiles (evidence: `src/PantallaRegistro.tsx`)
- Student attendance → Supabase client: reads and updates attendance (evidence: `src/PantallaAlumno.tsx`)
- Teacher classroom → Supabase client: manages sessions and attendance (evidence: `src/PantallaProfesor.tsx`)
- Teacher management → Supabase client: manages class data (evidence: `src/PantallaGestionDocente.tsx`)
- Teacher classroom → Share and join QR: renders (evidence: `src/PantallaProfesor.tsx`)
- Teacher management → Share and join QR: renders (evidence: `src/PantallaGestionDocente.tsx`)
- Home and routing → Share and join QR: renders (evidence: `src/App.tsx`)
- Supabase client → Supabase backend: connects to (evidence: `src/supabase.ts`)
- Student attendance → Domain types: uses domain types (evidence: `src/PantallaAlumno.tsx`)
- Teacher classroom → Domain types: uses domain types (evidence: `src/PantallaProfesor.tsx`)
