# britisheducationimmigration-glitch/sangaria-website architecture

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

- Interactive diagram: https://gitdiagram.com/britisheducationimmigration-glitch/sangaria-website
- Repository: https://github.com/britisheducationimmigration-glitch/sangaria-website

## Overview

British Education & Immigration is a public study-abroad guidance and coaching site with server-backed enquiries and a role-restricted admin workspace. Visitors explore destination and visa guidance, check preliminary eligibility, and submit an enquiry; admins manage its follow-up alongside editable content and site settings. The repository also contains a substantial employee attendance and payroll subsystem. Several edges reflect explicit README descriptions; where source excerpts do not show internal route wiring, the graph avoids asserting it.

Main entry points: [`src/routes/admin.tsx`](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/routes/admin.tsx) (Admin dashboard), [`src/lib/admin-functions.ts`](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/lib/admin-functions.ts) (Admin functions), [`src/lib/attendance-functions.ts`](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/lib/attendance-functions.ts) (Attendance functions), [`src/components/EnquiryForm.tsx`](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/components/EnquiryForm.tsx) (Enquiry form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public guidance"]
  node_home["Homepage<br/>[index.tsx]"]
  node_destination["Destination guides"]
  node_visa["Visa services<br/>[visas.tsx]"]
  node_eligibility["Eligibility check<br/>[eligibility.tsx]"]
  node_coaching["IELTS and PTE<br/>[coaching.tsx]"]
  node_published["Published content"]
  node_guidance["Guidance defaults<br/>[fixtures.ts]"]
  node_visa_rules["Visa guidance<br/>[visa-guidance.ts]"]
end

subgraph group_leads["Enquiry workflow"]
  node_enquiry_form["Enquiry form<br/>[EnquiryForm.tsx]"]
  node_lead_service["Public server functions"]
end

subgraph group_admin["Admin workspace"]
  node_admin_route["Admin dashboard<br/>[admin.tsx]"]
  node_admin_service["Admin functions<br/>[admin-functions.ts]"]
  node_auth["Role-based auth<br/>[auth.server.ts]"]
  node_admin_panels["Content panels<br/>[StoryEditor.tsx]"]
  node_certificates["Certificate management"]
  node_policy["Policy watch"]
  node_db_layer["Database access<br/>[db.server.ts]"]
end

subgraph group_workforce["Attendance and payroll"]
  node_attendance_portal["Attendance portal"]
  node_attendance_service["Attendance functions"]
  node_attendance_rules["Attendance calculations"]
  node_attendance_admin["Attendance panel"]
  node_payroll["Payroll ledger<br/>[PayrollLedger.tsx]"]
end

node_visitor(("Visitor"))
node_mysql[("MySQL database")]
node_admin_user(("Authorised staff"))
node_employee(("Employee"))

node_visitor -->|"browses"| node_home
node_visitor -->|"browses"| node_destination
node_visitor -->|"browses"| node_visa
node_visitor -->|"completes checklist"| node_eligibility
node_visitor -->|"explores"| node_coaching
node_visitor -->|"reads"| node_published
node_destination -.->|"uses defaults"| node_guidance
node_visa -.->|"uses guidance"| node_visa_rules
node_visitor -->|"submits details"| node_enquiry_form
node_home -->|"renders"| node_enquiry_form
node_enquiry_form -->|"submits enquiry"| node_lead_service
node_lead_service -->|"persists leads"| node_mysql
node_admin_user -->|"signs in"| node_admin_route
node_admin_route -->|"calls functions"| node_admin_service
node_admin_service -->|"checks roles"| node_auth
node_admin_service -->|"reads and writes"| node_db_layer
node_db_layer -->|"queries"| node_mysql
node_admin_route -->|"renders"| node_admin_panels
node_admin_route -->|"renders"| node_certificates
node_admin_route -->|"renders"| node_policy
node_employee -->|"marks attendance"| node_attendance_portal
node_attendance_portal -->|"calls functions"| node_attendance_service
node_attendance_service -->|"queries"| node_db_layer
node_attendance_service -->|"uses calculations"| node_attendance_rules
node_admin_route -->|"renders"| node_attendance_admin
node_attendance_admin -->|"uses ledger"| node_payroll

click node_home "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/routes/index.tsx"
click node_destination "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/routes/countries.%24slug.tsx"
click node_visa "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/routes/visas.tsx"
click node_eligibility "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/routes/eligibility.tsx"
click node_coaching "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/routes/coaching.tsx"
click node_published "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/routes/success-stories.tsx"
click node_guidance "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/data/fixtures.ts"
click node_visa_rules "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/data/visa-guidance.ts"
click node_enquiry_form "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/components/EnquiryForm.tsx"
click node_lead_service "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/lib/public-functions.ts"
click node_admin_route "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/routes/admin.tsx"
click node_admin_service "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/lib/admin-functions.ts"
click node_auth "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/lib/auth.server.ts"
click node_admin_panels "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/components/admin/StoryEditor.tsx"
click node_certificates "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/components/admin/CertificatePanel.tsx"
click node_policy "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/components/admin/PolicyWatchPanel.tsx"
click node_attendance_portal "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/routes/attendance.%24token.tsx"
click node_attendance_service "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/lib/attendance-functions.ts"
click node_attendance_rules "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/lib/attendance-calculations.ts"
click node_attendance_admin "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/components/admin/AttendancePanel.tsx"
click node_payroll "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/components/admin/PayrollLedger.tsx"
click node_db_layer "https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/lib/db.server.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_home,node_destination,node_visa,node_eligibility,node_coaching,node_published,node_guidance,node_visa_rules toneBlue
class node_enquiry_form,node_lead_service,node_mysql toneAmber
class node_admin_route,node_admin_service,node_auth,node_admin_panels,node_certificates,node_policy,node_db_layer toneMint
class node_attendance_portal,node_attendance_service,node_attendance_rules,node_attendance_admin,node_payroll toneRose
class node_visitor,node_admin_user,node_employee toneIndigo
```

## Components

### Public guidance

- [Homepage](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/routes/index.tsx): `src/routes/index.tsx`
- [Destination guides](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/routes/countries.%24slug.tsx): `src/routes/countries.$slug.tsx`
- [Visa services](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/routes/visas.tsx): `src/routes/visas.tsx`
- [Eligibility check](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/routes/eligibility.tsx): `src/routes/eligibility.tsx`
- [IELTS and PTE](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/routes/coaching.tsx): `src/routes/coaching.tsx`
- [Published content](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/routes/success-stories.tsx): `src/routes/success-stories.tsx`
- [Guidance defaults](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/data/fixtures.ts): `src/data/fixtures.ts`
- [Visa guidance](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/data/visa-guidance.ts): `src/data/visa-guidance.ts`

### Enquiry workflow

- [Enquiry form](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/components/EnquiryForm.tsx): `src/components/EnquiryForm.tsx`
- [Public server functions](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/lib/public-functions.ts): `src/lib/public-functions.ts`

### Admin workspace

- [Admin dashboard](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/routes/admin.tsx): `src/routes/admin.tsx`
- [Admin functions](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/lib/admin-functions.ts): `src/lib/admin-functions.ts`
- [Role-based auth](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/lib/auth.server.ts): `src/lib/auth.server.ts`
- [Content panels](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/components/admin/StoryEditor.tsx): `src/components/admin/StoryEditor.tsx`
- [Certificate management](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/components/admin/CertificatePanel.tsx): `src/components/admin/CertificatePanel.tsx`
- [Policy watch](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/components/admin/PolicyWatchPanel.tsx): `src/components/admin/PolicyWatchPanel.tsx`
- [Database access](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/lib/db.server.ts): `src/lib/db.server.ts`

### Attendance and payroll

- [Attendance portal](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/routes/attendance.%24token.tsx): `src/routes/attendance.$token.tsx`
- [Attendance functions](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/lib/attendance-functions.ts): `src/lib/attendance-functions.ts`
- [Attendance calculations](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/lib/attendance-calculations.ts): `src/lib/attendance-calculations.ts`
- [Attendance panel](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/components/admin/AttendancePanel.tsx): `src/components/admin/AttendancePanel.tsx`
- [Payroll ledger](https://github.com/britisheducationimmigration-glitch/sangaria-website/blob/main/src/components/admin/PayrollLedger.tsx): `src/components/admin/PayrollLedger.tsx`

### Other components

- **Visitor**
- **MySQL database**
- **Authorised staff**
- **Employee**

## Connections

- Visitor → Homepage: browses
- Visitor → Destination guides: browses
- Visitor → Visa services: browses
- Visitor → Eligibility check: completes checklist
- Visitor → IELTS and PTE: explores
- Visitor → Published content: reads
- Destination guides → Guidance defaults: uses defaults
- Visa services → Visa guidance: uses guidance
- Visitor → Enquiry form: submits details
- Homepage → Enquiry form: renders (evidence: `src/routes/index.tsx`)
- Enquiry form → Public server functions: submits enquiry (evidence: `src/components/EnquiryForm.tsx`)
- Public server functions → MySQL database: persists leads
- Authorised staff → Admin dashboard: signs in
- Admin dashboard → Admin functions: calls functions (evidence: `src/routes/admin.tsx`)
- Admin functions → Role-based auth: checks roles (evidence: `src/lib/admin-functions.ts`)
- Admin functions → Database access: reads and writes (evidence: `src/lib/admin-functions.ts`)
- Database access → MySQL database: queries (evidence: `src/lib/db.server.ts`)
- Admin dashboard → Content panels: renders (evidence: `src/routes/admin.tsx`)
- Admin dashboard → Certificate management: renders (evidence: `src/routes/admin.tsx`)
- Admin dashboard → Policy watch: renders (evidence: `src/routes/admin.tsx`)
- Employee → Attendance portal: marks attendance
- Attendance portal → Attendance functions: calls functions (evidence: `src/routes/attendance.$token.tsx`)
- Attendance functions → Database access: queries (evidence: `src/lib/attendance-functions.ts`)
- Attendance functions → Attendance calculations: uses calculations
- Admin dashboard → Attendance panel: renders (evidence: `src/routes/admin.tsx`)
- Attendance panel → Payroll ledger: uses ledger (evidence: `src/components/admin/AttendancePanel.tsx`)
