# mangila4k/apphiraya architecture

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

- Interactive diagram: https://gitdiagram.com/mangila4k/apphiraya
- Repository: https://github.com/mangila4k/apphiraya

## Overview

This is an Expo Router school-management app. Users can submit enrollment applications, while authenticated role-based portals expose administration, registrar, teacher, student, and parent workflows. Sampled screens show direct Supabase queries; the teacher portal also includes face attendance. The README describes only the Expo starter, so these product capabilities are inferred from the route tree and sampled files. Most routes were not sampled, so their internal relationships are omitted rather than assumed.

Main entry points: [`src/lib/supabase/client.ts`](https://github.com/mangila4k/apphiraya/blob/main/src/lib/supabase/client.ts) (Supabase client), [`src/app/(dashboard)/teacher/face-attendance.tsx`](https://github.com/mangila4k/apphiraya/blob/main/src/app/(dashboard)/teacher/face-attendance.tsx) (Face attendance), [`src/app/(auth)/login.tsx`](https://github.com/mangila4k/apphiraya/blob/main/src/app/(auth)/login.tsx) (Sign in), [`src/app/(tabs)/enrollment/index.tsx`](https://github.com/mangila4k/apphiraya/blob/main/src/app/(tabs)/enrollment/index.tsx) (Enrollment application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and enrollment"]
  node_login["Sign in<br/>[login.tsx]"]
  node_public_enrollment["Enrollment application<br/>[index.tsx]"]
end

subgraph group_operations["School operations"]
  node_admin_enrollment["Admin enrollments<br/>[enrollments.tsx]"]
  node_enrollment_detail["Enrollment detail"]
  node_admin_workflows["Admin management"]
  node_registrar_enrollment["Registrar enrollments<br/>[enrollments.tsx]"]
  node_registrar_workflows["Registrar workflows"]
end

subgraph group_portals["Role portals"]
  node_teacher_workflows["Teacher workflows"]
  node_face_attendance["Face attendance"]
  node_student_workflows["Student portal"]
  node_parent_workflows["Parent portal"]
end

subgraph group_services["Shared services"]
  node_auth_hook["Auth session<br/>[useAuth.ts]"]
  node_supabase_client["Supabase client<br/>[client.ts]"]
  node_face_fingerprint["Face fingerprinting<br/>[faceFingerprint.ts]"]
  node_theme["Theme preferences<br/>[themecontext.tsx]"]
end

node_public_user(("Public user"))
node_async_storage[("AsyncStorage")]
node_supabase[("Supabase service")]

node_public_user -.->|"signs in"| node_login
node_public_user -.->|"submits application"| node_public_enrollment
node_login -->|"queries auth"| node_supabase_client
node_public_enrollment -->|"queries enrollment"| node_supabase_client
node_admin_enrollment -->|"manages records"| node_supabase_client
node_enrollment_detail -->|"loads details"| node_supabase_client
node_registrar_enrollment -->|"updates records"| node_supabase_client
node_auth_hook -->|"reads session"| node_supabase_client
node_supabase_client -->|"connects to"| node_supabase
node_theme -->|"persists preferences"| node_async_storage
node_face_attendance -->|"uses fingerprinting"| node_face_fingerprint
node_face_attendance -->|"accesses records"| node_supabase_client
node_teacher_workflows -->|"accesses records"| node_supabase_client
node_student_workflows -->|"accesses records"| node_supabase_client
node_parent_workflows -->|"accesses records"| node_supabase_client
node_admin_workflows -.->|"uses data service"| node_supabase_client
node_registrar_workflows -.->|"uses data service"| node_supabase_client

click node_login "https://github.com/mangila4k/apphiraya/blob/main/src/app/(auth)/login.tsx"
click node_public_enrollment "https://github.com/mangila4k/apphiraya/blob/main/src/app/(tabs)/enrollment/index.tsx"
click node_admin_enrollment "https://github.com/mangila4k/apphiraya/blob/main/src/app/(dashboard)/admin/enrollments.tsx"
click node_enrollment_detail "https://github.com/mangila4k/apphiraya/blob/main/src/app/(dashboard)/admin/view-enrollment.tsx"
click node_admin_workflows "https://github.com/mangila4k/apphiraya/tree/main/src/app/(dashboard)/admin"
click node_registrar_enrollment "https://github.com/mangila4k/apphiraya/blob/main/src/app/(dashboard)/registrar/enrollments.tsx"
click node_registrar_workflows "https://github.com/mangila4k/apphiraya/tree/main/src/app/(dashboard)/registrar"
click node_teacher_workflows "https://github.com/mangila4k/apphiraya/tree/main/src/app/(dashboard)/teacher"
click node_face_attendance "https://github.com/mangila4k/apphiraya/blob/main/src/app/(dashboard)/teacher/face-attendance.tsx"
click node_student_workflows "https://github.com/mangila4k/apphiraya/tree/main/src/app/(dashboard)/student"
click node_parent_workflows "https://github.com/mangila4k/apphiraya/tree/main/src/app/(dashboard)/parent"
click node_auth_hook "https://github.com/mangila4k/apphiraya/blob/main/src/lib/supabase/hooks/useAuth.ts"
click node_supabase_client "https://github.com/mangila4k/apphiraya/blob/main/src/lib/supabase/client.ts"
click node_face_fingerprint "https://github.com/mangila4k/apphiraya/blob/main/src/lib/utils/faceFingerprint.ts"
click node_theme "https://github.com/mangila4k/apphiraya/blob/main/src/app/_context/themecontext.tsx"

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_login,node_public_enrollment,node_public_user toneBlue
class node_admin_enrollment,node_enrollment_detail,node_admin_workflows,node_registrar_enrollment,node_registrar_workflows,node_async_storage,node_supabase toneAmber
class node_teacher_workflows,node_face_attendance,node_student_workflows,node_parent_workflows toneMint
class node_auth_hook,node_supabase_client,node_face_fingerprint,node_theme toneRose
```

## Components

### Entry and enrollment

- [Sign in](https://github.com/mangila4k/apphiraya/blob/main/src/app/(auth)/login.tsx): `src/app/(auth)/login.tsx`
- [Enrollment application](https://github.com/mangila4k/apphiraya/blob/main/src/app/(tabs)/enrollment/index.tsx): `src/app/(tabs)/enrollment/index.tsx`

### School operations

- [Admin enrollments](https://github.com/mangila4k/apphiraya/blob/main/src/app/(dashboard)/admin/enrollments.tsx): `src/app/(dashboard)/admin/enrollments.tsx`
- [Enrollment detail](https://github.com/mangila4k/apphiraya/blob/main/src/app/(dashboard)/admin/view-enrollment.tsx): `src/app/(dashboard)/admin/view-enrollment.tsx`
- [Admin management](https://github.com/mangila4k/apphiraya/tree/main/src/app/(dashboard)/admin): `src/app/(dashboard)/admin`
- [Registrar enrollments](https://github.com/mangila4k/apphiraya/blob/main/src/app/(dashboard)/registrar/enrollments.tsx): `src/app/(dashboard)/registrar/enrollments.tsx`
- [Registrar workflows](https://github.com/mangila4k/apphiraya/tree/main/src/app/(dashboard)/registrar): `src/app/(dashboard)/registrar`

### Role portals

- [Teacher workflows](https://github.com/mangila4k/apphiraya/tree/main/src/app/(dashboard)/teacher): `src/app/(dashboard)/teacher`
- [Face attendance](https://github.com/mangila4k/apphiraya/blob/main/src/app/(dashboard)/teacher/face-attendance.tsx): `src/app/(dashboard)/teacher/face-attendance.tsx`
- [Student portal](https://github.com/mangila4k/apphiraya/tree/main/src/app/(dashboard)/student): `src/app/(dashboard)/student`
- [Parent portal](https://github.com/mangila4k/apphiraya/tree/main/src/app/(dashboard)/parent): `src/app/(dashboard)/parent`

### Shared services

- [Auth session](https://github.com/mangila4k/apphiraya/blob/main/src/lib/supabase/hooks/useAuth.ts): `src/lib/supabase/hooks/useAuth.ts`
- [Supabase client](https://github.com/mangila4k/apphiraya/blob/main/src/lib/supabase/client.ts): `src/lib/supabase/client.ts`
- [Face fingerprinting](https://github.com/mangila4k/apphiraya/blob/main/src/lib/utils/faceFingerprint.ts): `src/lib/utils/faceFingerprint.ts`
- [Theme preferences](https://github.com/mangila4k/apphiraya/blob/main/src/app/_context/themecontext.tsx): `src/app/_context/themecontext.tsx`

### Other components

- **Public user**
- **AsyncStorage**
- **Supabase service**

## Connections

- Public user → Sign in: signs in
- Public user → Enrollment application: submits application
- Sign in → Supabase client: queries auth (evidence: `src/app/(auth)/login.tsx`)
- Enrollment application → Supabase client: queries enrollment (evidence: `src/app/(tabs)/enrollment/index.tsx`)
- Admin enrollments → Supabase client: manages records (evidence: `src/app/(dashboard)/admin/enrollments.tsx`)
- Enrollment detail → Supabase client: loads details (evidence: `src/app/(dashboard)/admin/view-enrollment.tsx`)
- Registrar enrollments → Supabase client: updates records (evidence: `src/app/(dashboard)/registrar/enrollments.tsx`)
- Auth session → Supabase client: reads session (evidence: `src/lib/supabase/hooks/useAuth.ts`)
- Supabase client → Supabase service: connects to (evidence: `src/lib/supabase/client.ts`)
- Theme preferences → AsyncStorage: persists preferences (evidence: `src/app/_context/themecontext.tsx`)
- Face attendance → Face fingerprinting: uses fingerprinting (evidence: `src/app/(dashboard)/teacher/face-attendance.tsx`)
- Face attendance → Supabase client: accesses records (evidence: `src/app/(dashboard)/teacher/face-attendance.tsx`)
- Teacher workflows → Supabase client: accesses records (evidence: `src/app/(dashboard)/teacher/index.tsx`)
- Student portal → Supabase client: accesses records (evidence: `src/app/(dashboard)/student/index.tsx`)
- Parent portal → Supabase client: accesses records (evidence: `src/app/(dashboard)/parent/index.tsx`)
- Admin management → Supabase client: uses data service (evidence: `src/app/(dashboard)/admin/enrollments.tsx`)
- Registrar workflows → Supabase client: uses data service (evidence: `src/app/(dashboard)/registrar/enrollments.tsx`)
