# crispyrinux/it-rush architecture

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

- Interactive diagram: https://gitdiagram.com/crispyrinux/it-rush
- Repository: https://github.com/crispyrinux/it-rush

## Overview

SIGNIFY is a web learning platform for inclusive communication and environmental literacy. Its main learner flow is to choose BISINDO or Braille practice, interact with lessons or quizzes, and track learning progress; BISINDO practice can also classify alphabet gestures from camera or simulated video. The graph includes the documented learning, game, progress, and environmental-literacy branches. Source excerpts do not show every page’s wiring, so uncertain links are omitted; the Python model-development modules are shown only where the source index identifies their dependencies.

Main entry points: [`app/bisindo/page.tsx`](https://github.com/crispyrinux/it-rush/blob/main/app/bisindo/page.tsx) (BISINDO Lessons), [`components/WordCameraSlot.tsx`](https://github.com/crispyrinux/it-rush/blob/main/components/WordCameraSlot.tsx) (Word Camera Practice), [`lib/storage/useProgress.ts`](https://github.com/crispyrinux/it-rush/blob/main/lib/storage/useProgress.ts) (Progress Hook), [`components/CameraSlot.tsx`](https://github.com/crispyrinux/it-rush/blob/main/components/CameraSlot.tsx) (Letter Camera Practice)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning Experience"]
  node_bisindo_page["BISINDO Lessons<br/>[page.tsx]"]
  node_letter_practice["Letter Camera Practice<br/>[CameraSlot.tsx]"]
  node_word_practice["Word Camera Practice<br/>[WordCameraSlot.tsx]"]
  node_guess_game["Guess the Sign<br/>[GuessTheSign.tsx]"]
  node_sign_gallery["Sign Gallery<br/>[SignGallery.tsx]"]
  node_bisindo_data["BISINDO Curriculum<br/>[bisindo.ts]"]
  node_braille_page["Braille Lessons<br/>[page.tsx]"]
  node_braille_cell["Braille Cell<br/>[BrailleCell.tsx]"]
  node_braille_logic["Braille Exercises<br/>[braille.ts]"]
  node_audio["Speech Feedback<br/>[audio.ts]"]
end

subgraph group_vision["BISINDO Vision"]
  node_hand_detection["Hand Detection"]
  node_pose_detection["Pose Detection"]
  node_landmark_features["Landmark Features"]
  node_alphabet_model["Alphabet Classifier"]
  node_word_model["Word Classifier<br/>[wordClassifier.ts]"]
end

subgraph group_progress["Progress and Accounts"]
  node_progress_page["Progress Dashboard<br/>[page.tsx]"]
  node_login_page["Login and Signup<br/>[page.tsx]"]
  node_progress_hook["Progress Hook<br/>[useProgress.ts]"]
  node_progress_repo[("Progress Repository")]
  node_badges["Badge Rules<br/>[badges.ts]"]
  node_supabase_client["Supabase Client<br/>[client.ts]"]
end

subgraph group_literacy["Environmental Literacy"]
  node_landing["Landing Page<br/>[page.tsx]"]
  node_environmental_content["Environmental Literacy"]
end

subgraph group_models["Model Development"]
  node_python_model["BISINDO Model<br/>[model.py]"]
  node_python_features["Training Features<br/>[features.py]"]
  node_word_pipeline["Word-Level Pipeline<br/>[word_level.py]"]
  node_python_landmarks["Training Landmarks<br/>[landmarks.py]"]
end

node_learner(("Learner"))
node_supabase_service[("Supabase")]

node_learner -->|"opens lessons"| node_bisindo_page
node_learner -->|"opens lessons"| node_braille_page
node_learner -->|"checks progress"| node_progress_page
node_bisindo_page -->|"renders practice"| node_letter_practice
node_bisindo_page -->|"renders practice"| node_word_practice
node_bisindo_page -->|"renders game"| node_guess_game
node_bisindo_page -->|"uses gallery"| node_sign_gallery
node_bisindo_page -->|"uses curriculum"| node_bisindo_data
node_braille_page -->|"renders cells"| node_braille_cell
node_braille_page -->|"uses exercises"| node_braille_logic
node_braille_page -->|"speaks feedback"| node_audio
node_letter_practice -->|"detects hands"| node_hand_detection
node_letter_practice -->|"classifies gestures"| node_alphabet_model
node_letter_practice -->|"records learning"| node_progress_hook
node_word_practice -->|"detects hands"| node_hand_detection
node_word_practice -->|"detects pose"| node_pose_detection
node_word_practice -->|"classifies sequences"| node_word_model
node_hand_detection -->|"normalizes landmarks"| node_landmark_features
node_pose_detection -->|"uses landmarks"| node_landmark_features
node_word_model -->|"uses features"| node_landmark_features
node_word_practice -->|"records learning"| node_progress_hook
node_progress_page -->|"reads progress"| node_progress_hook
node_login_page -->|"uses account state"| node_progress_hook
node_progress_hook -->|"subscribes to"| node_progress_repo
node_progress_repo -->|"evaluates badges"| node_badges
node_progress_repo -->|"calls account APIs"| node_supabase_client
node_supabase_client -->|"reads and writes"| node_supabase_service
node_learner -->|"views overview"| node_landing
node_landing -->|"presents literacy"| node_environmental_content
node_python_model -->|"uses features"| node_python_features
node_word_pipeline -->|"uses landmarks"| node_python_landmarks
node_word_pipeline -->|"uses model"| node_python_model

click node_bisindo_page "https://github.com/crispyrinux/it-rush/blob/main/app/bisindo/page.tsx"
click node_letter_practice "https://github.com/crispyrinux/it-rush/blob/main/components/CameraSlot.tsx"
click node_word_practice "https://github.com/crispyrinux/it-rush/blob/main/components/WordCameraSlot.tsx"
click node_guess_game "https://github.com/crispyrinux/it-rush/blob/main/components/GuessTheSign.tsx"
click node_sign_gallery "https://github.com/crispyrinux/it-rush/blob/main/components/SignGallery.tsx"
click node_bisindo_data "https://github.com/crispyrinux/it-rush/blob/main/lib/bisindo.ts"
click node_braille_page "https://github.com/crispyrinux/it-rush/blob/main/app/braille/page.tsx"
click node_braille_cell "https://github.com/crispyrinux/it-rush/blob/main/components/BrailleCell.tsx"
click node_braille_logic "https://github.com/crispyrinux/it-rush/blob/main/lib/braille.ts"
click node_audio "https://github.com/crispyrinux/it-rush/blob/main/lib/audio.ts"
click node_hand_detection "https://github.com/crispyrinux/it-rush/blob/main/lib/cv/handLandmarkerClient.ts"
click node_pose_detection "https://github.com/crispyrinux/it-rush/blob/main/lib/cv/poseLandmarkerClient.ts"
click node_landmark_features "https://github.com/crispyrinux/it-rush/blob/main/lib/cv/normalizeLandmarks.ts"
click node_alphabet_model "https://github.com/crispyrinux/it-rush/blob/main/lib/cv/alphabetClassifier.ts"
click node_word_model "https://github.com/crispyrinux/it-rush/blob/main/lib/cv/wordClassifier.ts"
click node_progress_page "https://github.com/crispyrinux/it-rush/blob/main/app/progress/page.tsx"
click node_login_page "https://github.com/crispyrinux/it-rush/blob/main/app/login/page.tsx"
click node_progress_hook "https://github.com/crispyrinux/it-rush/blob/main/lib/storage/useProgress.ts"
click node_progress_repo "https://github.com/crispyrinux/it-rush/blob/main/lib/storage/progressRepository.ts"
click node_badges "https://github.com/crispyrinux/it-rush/blob/main/lib/badges.ts"
click node_supabase_client "https://github.com/crispyrinux/it-rush/blob/main/lib/supabase/client.ts"
click node_landing "https://github.com/crispyrinux/it-rush/blob/main/app/page.tsx"
click node_environmental_content "https://github.com/crispyrinux/it-rush/blob/main/components/landing/EnvironmentalSection.tsx"
click node_python_model "https://github.com/crispyrinux/it-rush/blob/main/src/bisindo/model.py"
click node_python_features "https://github.com/crispyrinux/it-rush/blob/main/src/bisindo/features.py"
click node_word_pipeline "https://github.com/crispyrinux/it-rush/blob/main/src/bisindo/word_level.py"
click node_python_landmarks "https://github.com/crispyrinux/it-rush/blob/main/src/bisindo/landmarks.py"

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_bisindo_page,node_letter_practice,node_word_practice,node_guess_game,node_sign_gallery,node_bisindo_data,node_braille_page,node_braille_cell,node_braille_logic,node_audio toneBlue
class node_hand_detection,node_pose_detection,node_landmark_features,node_alphabet_model,node_word_model,node_supabase_service toneAmber
class node_progress_page,node_login_page,node_progress_hook,node_progress_repo,node_badges,node_supabase_client toneMint
class node_landing,node_environmental_content toneRose
class node_python_model,node_python_features,node_word_pipeline,node_python_landmarks,node_learner toneIndigo
```

## Components

### Learning Experience

- [BISINDO Lessons](https://github.com/crispyrinux/it-rush/blob/main/app/bisindo/page.tsx): `app/bisindo/page.tsx`
- [Letter Camera Practice](https://github.com/crispyrinux/it-rush/blob/main/components/CameraSlot.tsx): `components/CameraSlot.tsx`
- [Word Camera Practice](https://github.com/crispyrinux/it-rush/blob/main/components/WordCameraSlot.tsx): `components/WordCameraSlot.tsx`
- [Guess the Sign](https://github.com/crispyrinux/it-rush/blob/main/components/GuessTheSign.tsx): `components/GuessTheSign.tsx`
- [Sign Gallery](https://github.com/crispyrinux/it-rush/blob/main/components/SignGallery.tsx): `components/SignGallery.tsx`
- [BISINDO Curriculum](https://github.com/crispyrinux/it-rush/blob/main/lib/bisindo.ts): `lib/bisindo.ts`
- [Braille Lessons](https://github.com/crispyrinux/it-rush/blob/main/app/braille/page.tsx): `app/braille/page.tsx`
- [Braille Cell](https://github.com/crispyrinux/it-rush/blob/main/components/BrailleCell.tsx): `components/BrailleCell.tsx`
- [Braille Exercises](https://github.com/crispyrinux/it-rush/blob/main/lib/braille.ts): `lib/braille.ts`
- [Speech Feedback](https://github.com/crispyrinux/it-rush/blob/main/lib/audio.ts): `lib/audio.ts`

### BISINDO Vision

- [Hand Detection](https://github.com/crispyrinux/it-rush/blob/main/lib/cv/handLandmarkerClient.ts): `lib/cv/handLandmarkerClient.ts`
- [Pose Detection](https://github.com/crispyrinux/it-rush/blob/main/lib/cv/poseLandmarkerClient.ts): `lib/cv/poseLandmarkerClient.ts`
- [Landmark Features](https://github.com/crispyrinux/it-rush/blob/main/lib/cv/normalizeLandmarks.ts): `lib/cv/normalizeLandmarks.ts`
- [Alphabet Classifier](https://github.com/crispyrinux/it-rush/blob/main/lib/cv/alphabetClassifier.ts): `lib/cv/alphabetClassifier.ts`
- [Word Classifier](https://github.com/crispyrinux/it-rush/blob/main/lib/cv/wordClassifier.ts): `lib/cv/wordClassifier.ts`

### Progress and Accounts

- [Progress Dashboard](https://github.com/crispyrinux/it-rush/blob/main/app/progress/page.tsx): `app/progress/page.tsx`
- [Login and Signup](https://github.com/crispyrinux/it-rush/blob/main/app/login/page.tsx): `app/login/page.tsx`
- [Progress Hook](https://github.com/crispyrinux/it-rush/blob/main/lib/storage/useProgress.ts): `lib/storage/useProgress.ts`
- [Progress Repository](https://github.com/crispyrinux/it-rush/blob/main/lib/storage/progressRepository.ts): `lib/storage/progressRepository.ts`
- [Badge Rules](https://github.com/crispyrinux/it-rush/blob/main/lib/badges.ts): `lib/badges.ts`
- [Supabase Client](https://github.com/crispyrinux/it-rush/blob/main/lib/supabase/client.ts): `lib/supabase/client.ts`

### Environmental Literacy

- [Landing Page](https://github.com/crispyrinux/it-rush/blob/main/app/page.tsx): `app/page.tsx`
- [Environmental Literacy](https://github.com/crispyrinux/it-rush/blob/main/components/landing/EnvironmentalSection.tsx): `components/landing/EnvironmentalSection.tsx`

### Model Development

- [BISINDO Model](https://github.com/crispyrinux/it-rush/blob/main/src/bisindo/model.py): `src/bisindo/model.py`
- [Training Features](https://github.com/crispyrinux/it-rush/blob/main/src/bisindo/features.py): `src/bisindo/features.py`
- [Word-Level Pipeline](https://github.com/crispyrinux/it-rush/blob/main/src/bisindo/word_level.py): `src/bisindo/word_level.py`
- [Training Landmarks](https://github.com/crispyrinux/it-rush/blob/main/src/bisindo/landmarks.py): `src/bisindo/landmarks.py`

### Other components

- **Learner**
- **Supabase**

## Connections

- Learner → BISINDO Lessons: opens lessons
- Learner → Braille Lessons: opens lessons
- Learner → Progress Dashboard: checks progress
- BISINDO Lessons → Letter Camera Practice: renders practice (evidence: `app/bisindo/page.tsx`)
- BISINDO Lessons → Word Camera Practice: renders practice (evidence: `app/bisindo/page.tsx`)
- BISINDO Lessons → Guess the Sign: renders game (evidence: `app/bisindo/page.tsx`)
- BISINDO Lessons → Sign Gallery: uses gallery (evidence: `app/bisindo/page.tsx`)
- BISINDO Lessons → BISINDO Curriculum: uses curriculum (evidence: `app/bisindo/page.tsx`)
- Braille Lessons → Braille Cell: renders cells (evidence: `app/braille/page.tsx`)
- Braille Lessons → Braille Exercises: uses exercises (evidence: `app/braille/page.tsx`)
- Braille Lessons → Speech Feedback: speaks feedback (evidence: `app/braille/page.tsx`)
- Letter Camera Practice → Hand Detection: detects hands (evidence: `components/CameraSlot.tsx`)
- Letter Camera Practice → Alphabet Classifier: classifies gestures (evidence: `components/CameraSlot.tsx`)
- Letter Camera Practice → Progress Hook: records learning (evidence: `components/CameraSlot.tsx`)
- Word Camera Practice → Hand Detection: detects hands (evidence: `components/WordCameraSlot.tsx`)
- Word Camera Practice → Pose Detection: detects pose (evidence: `components/WordCameraSlot.tsx`)
- Word Camera Practice → Word Classifier: classifies sequences (evidence: `components/WordCameraSlot.tsx`)
- Hand Detection → Landmark Features: normalizes landmarks (evidence: `lib/cv/handLandmarkerClient.ts`)
- Pose Detection → Landmark Features: uses landmarks (evidence: `lib/cv/poseLandmarkerClient.ts`)
- Word Classifier → Landmark Features: uses features (evidence: `lib/cv/wordClassifier.ts`)
- Word Camera Practice → Progress Hook: records learning (evidence: `components/WordCameraSlot.tsx`)
- Progress Dashboard → Progress Hook: reads progress (evidence: `app/progress/page.tsx`)
- Login and Signup → Progress Hook: uses account state (evidence: `app/login/page.tsx`)
- Progress Hook → Progress Repository: subscribes to (evidence: `lib/storage/useProgress.ts`)
- Progress Repository → Badge Rules: evaluates badges (evidence: `lib/storage/progressRepository.ts`)
- Progress Repository → Supabase Client: calls account APIs (evidence: `lib/storage/progressRepository.ts`)
- Supabase Client → Supabase: reads and writes (evidence: `lib/supabase/client.ts`)
- Learner → Landing Page: views overview
- Landing Page → Environmental Literacy: presents literacy (evidence: `app/page.tsx`)
- BISINDO Model → Training Features: uses features (evidence: `src/bisindo/model.py`)
- Word-Level Pipeline → Training Landmarks: uses landmarks (evidence: `src/bisindo/word_level.py`)
- Word-Level Pipeline → BISINDO Model: uses model (evidence: `src/bisindo/word_level.py`)
