# joshhh22/trac architecture

> Architecture diagram of the GitHub repository joshhh22/trac, 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/joshhh22/trac
- Repository: https://github.com/joshhh22/trac

## Overview

TRAC appears to be an Android app for user accounts and school-facility reports, with report, notification, and admin screens. The likely user journey is account access followed by browsing or creating a report, but the supplied material contains no README and no app-source excerpts, so the actual navigation, calls, and data flow cannot be verified. The graph maps the named runtime components without inventing relationships; implementation details for unsampled files remain uncertain.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity"]
  node_login["Login<br/>[LoginTracScreen.kt]"]
  node_register["Registration"]
  node_identity_edit["Edit identity"]
  node_terms["Terms<br/>[TermsTracScreen.kt]"]
end

subgraph group_reports["Reports"]
  node_report_list["Report list"]
  node_report_create["Create report"]
  node_report_detail["Report detail"]
  node_admin["Admin dashboard"]
end

subgraph group_app_ui["App Screens"]
  node_home["Home<br/>[HomeTracScreen.kt]"]
  node_splash["Splash"]
  node_settings["Settings"]
  node_notifications["Notifications"]
  node_activity["Activity entry<br/>[MainActivity.kt]"]
end

subgraph group_services["Data And State"]
  node_auth_vm["Auth state<br/>[AuthViewModel.kt]"]
  node_report_vm["Report state<br/>[ReportViewModel.kt]"]
  node_auth_repo["Auth repository<br/>[AuthRepository.kt]"]
  node_report_repo["Report repository"]
  node_supabase["Supabase client<br/>[SupabaseClient.kt]"]
  node_session["Session preferences"]
  node_report_data["Report data<br/>[ReportData.kt]"]
  node_staff["Staff member<br/>[StaffMember.kt]"]
  node_facility_data["Facility master data"]
  node_image_utils["Image utilities<br/>[ImageUtils.kt]"]
end

subgraph group_shared_ui["Shared UI"]
  node_banner["In-app banner<br/>[InAppBanner.kt]"]
  node_sidebar["Profile sidebar"]
  node_bottom_nav["Bottom navigation"]
end

node_user(("App user"))

click node_login "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/LoginTracScreen.kt"
click node_register "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/RegisterTracScreen.kt"
click node_identity_edit "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/EditIdentityTracScreen.kt"
click node_terms "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/TermsTracScreen.kt"
click node_home "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/HomeTracScreen.kt"
click node_splash "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/SplashTracScreen.kt"
click node_settings "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/SettingsTracScreen.kt"
click node_notifications "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/NotificationsTracScreen.kt"
click node_report_list "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/ReportListTracScreen.kt"
click node_report_create "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/CreateReportTracScreen.kt"
click node_report_detail "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/ReportDetailTracScreen.kt"
click node_admin "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/AdminDashboardTracScreen.kt"
click node_activity "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/MainActivity.kt"
click node_auth_vm "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/viewmodel/AuthViewModel.kt"
click node_report_vm "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/viewmodel/ReportViewModel.kt"
click node_auth_repo "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/data/AuthRepository.kt"
click node_report_repo "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/data/ReportRepository.kt"
click node_supabase "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/data/SupabaseClient.kt"
click node_session "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/data/SessionPreferences.kt"
click node_report_data "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/data/ReportData.kt"
click node_staff "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/data/StaffMember.kt"
click node_facility_data "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/data/SchoolFacilityMasterData.kt"
click node_image_utils "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/util/ImageUtils.kt"
click node_banner "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/components/InAppBanner.kt"
click node_sidebar "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/components/ProfileSidebarDrawer.kt"
click node_bottom_nav "https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/components/TracBottomNavBar.kt"

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_register,node_identity_edit,node_terms,node_user toneBlue
class node_report_list,node_report_create,node_report_detail,node_admin toneAmber
class node_home,node_splash,node_settings,node_notifications,node_activity toneMint
class node_auth_vm,node_report_vm,node_auth_repo,node_report_repo,node_supabase,node_session,node_report_data,node_staff,node_facility_data,node_image_utils toneRose
class node_banner,node_sidebar,node_bottom_nav toneIndigo
```

## Components

### Identity

- [Login](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/LoginTracScreen.kt): `app/src/main/java/com/example/trac/LoginTracScreen.kt`
- [Registration](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/RegisterTracScreen.kt): `app/src/main/java/com/example/trac/RegisterTracScreen.kt`
- [Edit identity](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/EditIdentityTracScreen.kt): `app/src/main/java/com/example/trac/EditIdentityTracScreen.kt`
- [Terms](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/TermsTracScreen.kt): `app/src/main/java/com/example/trac/TermsTracScreen.kt`

### Reports

- [Report list](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/ReportListTracScreen.kt): `app/src/main/java/com/example/trac/ReportListTracScreen.kt`
- [Create report](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/CreateReportTracScreen.kt): `app/src/main/java/com/example/trac/CreateReportTracScreen.kt`
- [Report detail](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/ReportDetailTracScreen.kt): `app/src/main/java/com/example/trac/ReportDetailTracScreen.kt`
- [Admin dashboard](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/AdminDashboardTracScreen.kt): `app/src/main/java/com/example/trac/AdminDashboardTracScreen.kt`

### App Screens

- [Home](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/HomeTracScreen.kt): `app/src/main/java/com/example/trac/HomeTracScreen.kt`
- [Splash](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/SplashTracScreen.kt): `app/src/main/java/com/example/trac/SplashTracScreen.kt`
- [Settings](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/SettingsTracScreen.kt): `app/src/main/java/com/example/trac/SettingsTracScreen.kt`
- [Notifications](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/NotificationsTracScreen.kt): `app/src/main/java/com/example/trac/NotificationsTracScreen.kt`
- [Activity entry](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/MainActivity.kt): `app/src/main/java/com/example/trac/MainActivity.kt`

### Data And State

- [Auth state](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/viewmodel/AuthViewModel.kt): `app/src/main/java/com/example/trac/viewmodel/AuthViewModel.kt`
- [Report state](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/viewmodel/ReportViewModel.kt): `app/src/main/java/com/example/trac/viewmodel/ReportViewModel.kt`
- [Auth repository](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/data/AuthRepository.kt): `app/src/main/java/com/example/trac/data/AuthRepository.kt`
- [Report repository](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/data/ReportRepository.kt): `app/src/main/java/com/example/trac/data/ReportRepository.kt`
- [Supabase client](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/data/SupabaseClient.kt): `app/src/main/java/com/example/trac/data/SupabaseClient.kt`
- [Session preferences](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/data/SessionPreferences.kt): `app/src/main/java/com/example/trac/data/SessionPreferences.kt`
- [Report data](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/data/ReportData.kt): `app/src/main/java/com/example/trac/data/ReportData.kt`
- [Staff member](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/data/StaffMember.kt): `app/src/main/java/com/example/trac/data/StaffMember.kt`
- [Facility master data](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/data/SchoolFacilityMasterData.kt): `app/src/main/java/com/example/trac/data/SchoolFacilityMasterData.kt`
- [Image utilities](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/util/ImageUtils.kt): `app/src/main/java/com/example/trac/util/ImageUtils.kt`

### Shared UI

- [In-app banner](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/components/InAppBanner.kt): `app/src/main/java/com/example/trac/components/InAppBanner.kt`
- [Profile sidebar](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/components/ProfileSidebarDrawer.kt): `app/src/main/java/com/example/trac/components/ProfileSidebarDrawer.kt`
- [Bottom navigation](https://github.com/joshhh22/trac/blob/main/app/src/main/java/com/example/trac/components/TracBottomNavBar.kt): `app/src/main/java/com/example/trac/components/TracBottomNavBar.kt`

### Other components

- **App user**
