# t-glonk/24ct1-tran_quoc_trung architecture

> Architecture diagram of the GitHub repository t-glonk/24ct1-tran_quoc_trung, 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/t-glonk/24ct1-tran_quoc_trung
- Repository: https://github.com/t-glonk/24ct1-tran_quoc_trung

## Overview

Alobo Sport is a badminton-court booking and management system: customers discover courts, book and pay, while staff administer bookings, courts, customers, services, transactions, and reports. The mobile app uses shared context and API clients to reach an Express backend; the backend persists domain data in a file-backed store. The README also documents map, favorites, membership, POS, and reporting capabilities. Some links below reflect README-level capabilities because their implementing source was not sampled; a legacy root-level screen set is shown separately rather than assumed to be part of the modular app.

Main entry points: [`backend/src/routes/index.js`](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/routes/index.js) (REST routes), [`frontend/src/navigation/AppNavigator.js`](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/navigation/AppNavigator.js) (Screen navigation), [`frontend/src/context/AppContext.js`](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/context/AppContext.js) (App state), [`frontend/src/api/apiClient.js`](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/api/apiClient.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Mobile app"]
  node_app["App shell<br/>[App.js]"]
  node_context["App state<br/>[AppContext.js]"]
  node_navigation["Screen navigation<br/>[AppNavigator.js]"]
  node_api["API client<br/>[apiClient.js]"]
  node_authapi["Auth API<br/>[authApi.js]"]
  node_bookingapi["Booking API<br/>[bookingApi.js]"]
  node_courtapi["Court API<br/>[courtApi.js]"]
  node_serviceapi["Service API<br/>[serviceApi.js]"]
  node_reportapi["Report API<br/>[reportApi.js]"]
end

subgraph group_booking["Customer booking"]
  node_auth["Sign in / register<br/>[LoginScreen.js]"]
  node_discovery["Court discovery<br/>[HomeScreen.js]"]
  node_bookingflow["Booking and payment<br/>[BookingScreen.js]"]
  node_customeraccount["Customer account<br/>[AccountScreen.js]"]
  node_map["Court map<br/>[MapScreen.js]"]
end

subgraph group_admin["Admin operations"]
  node_adminscreens["Admin modules"]
  node_pos["Service POS"]
end

subgraph group_backend["Backend API"]
  node_server["Express server<br/>[server.js]"]
  node_routes["REST routes<br/>[index.js]"]
  node_bookingctrl["Booking handling"]
  node_courtctrl["Court handling<br/>[courtController.js]"]
  node_customerctrl["Customer handling"]
  node_servicectrl["Service handling"]
  node_authctrl["Authentication<br/>[authController.js]"]
  node_reportctrl["Reports"]
  node_transactionctrl["Transactions"]
end

subgraph group_storage["Persistence"]
  node_store[("File-backed store<br/>[db.js]")]
  node_seeds["Seed records<br/>[courts.js]"]
end

subgraph group_legacy["Legacy screens"]
  node_legacycustomer["Legacy customer screens<br/>[CustomerScreens.js]"]
  node_legacyadmin["Legacy admin screens<br/>[AdminScreens.js]"]
  node_legacydata["Legacy sample data<br/>[data.js]"]
  node_legacy_map["Legacy map<br/>[MapScreen.js]"]
end

node_customer(("Customer"))
node_staff(("Admin staff"))

node_customer -->|"opens"| node_app
node_staff -->|"opens"| node_app
node_app -->|"provides state"| node_context
node_app -->|"renders"| node_navigation
node_navigation -->|"routes to"| node_auth
node_navigation -->|"routes to"| node_discovery
node_navigation -->|"routes to"| node_bookingflow
node_navigation -->|"routes to"| node_customeraccount
node_navigation -->|"routes to"| node_map
node_navigation -->|"routes to"| node_adminscreens
node_context -->|"calls"| node_authapi
node_context -->|"calls"| node_bookingapi
node_context -->|"calls"| node_courtapi
node_context -->|"calls"| node_serviceapi
node_context -->|"calls"| node_reportapi
node_pos -->|"checks out"| node_serviceapi
node_authapi -->|"requests through"| node_api
node_bookingapi -->|"requests through"| node_api
node_courtapi -->|"requests through"| node_api
node_serviceapi -->|"requests through"| node_api
node_api -->|"HTTP requests"| node_server
node_server -->|"mounts"| node_routes
node_routes -->|"dispatches"| node_bookingctrl
node_routes -->|"dispatches"| node_courtctrl
node_routes -->|"dispatches"| node_customerctrl
node_routes -->|"dispatches"| node_authctrl
node_routes -->|"dispatches"| node_servicectrl
node_routes -->|"dispatches"| node_reportctrl
node_routes -->|"dispatches"| node_transactionctrl
node_bookingctrl -->|"reads and writes"| node_store
node_courtctrl -->|"uses"| node_store
node_customerctrl -->|"uses"| node_store
node_servicectrl -->|"uses"| node_store
node_store -->|"loads seeds"| node_seeds
node_legacycustomer -->|"uses"| node_legacydata
node_legacycustomer -->|"uses"| node_legacy_map
node_legacyadmin -->|"uses"| node_legacydata
node_legacy_map -->|"uses"| node_legacydata

click node_app "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/App.js"
click node_context "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/context/AppContext.js"
click node_navigation "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/navigation/AppNavigator.js"
click node_auth "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/screens/auth/LoginScreen.js"
click node_discovery "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/screens/customer/HomeScreen.js"
click node_bookingflow "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/screens/customer/BookingScreen.js"
click node_customeraccount "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/screens/customer/AccountScreen.js"
click node_map "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/screens/map/MapScreen.js"
click node_adminscreens "https://github.com/t-glonk/24ct1-tran_quoc_trung/tree/main/frontend/src/screens/admin"
click node_pos "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/screens/admin/AdminServicesScreen.js"
click node_api "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/api/apiClient.js"
click node_authapi "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/api/authApi.js"
click node_bookingapi "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/api/bookingApi.js"
click node_courtapi "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/api/courtApi.js"
click node_serviceapi "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/api/serviceApi.js"
click node_reportapi "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/api/reportApi.js"
click node_server "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/server.js"
click node_routes "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/routes/index.js"
click node_bookingctrl "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/controllers/bookingController.js"
click node_courtctrl "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/controllers/courtController.js"
click node_customerctrl "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/controllers/customerController.js"
click node_servicectrl "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/controllers/serviceController.js"
click node_authctrl "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/controllers/authController.js"
click node_reportctrl "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/controllers/reportController.js"
click node_transactionctrl "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/controllers/transactionController.js"
click node_store "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/config/db.js"
click node_seeds "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/data/courts.js"
click node_legacycustomer "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/src/CustomerScreens.js"
click node_legacyadmin "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/src/AdminScreens.js"
click node_legacydata "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/src/data.js"
click node_legacy_map "https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/src/MapScreen.js"

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_app,node_context,node_navigation,node_api,node_authapi,node_bookingapi,node_courtapi,node_serviceapi,node_reportapi toneBlue
class node_auth,node_discovery,node_bookingflow,node_customeraccount,node_map toneAmber
class node_adminscreens,node_pos toneMint
class node_server,node_routes,node_bookingctrl,node_courtctrl,node_customerctrl,node_servicectrl,node_authctrl,node_reportctrl,node_transactionctrl toneRose
class node_store,node_seeds,node_customer,node_staff toneIndigo
class node_legacycustomer,node_legacyadmin,node_legacydata,node_legacy_map toneTeal
```

## Components

### Mobile app

- [App shell](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/App.js): `frontend/App.js`
- [App state](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/context/AppContext.js): `frontend/src/context/AppContext.js`
- [Screen navigation](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/navigation/AppNavigator.js): `frontend/src/navigation/AppNavigator.js`
- [API client](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/api/apiClient.js): `frontend/src/api/apiClient.js`
- [Auth API](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/api/authApi.js): `frontend/src/api/authApi.js`
- [Booking API](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/api/bookingApi.js): `frontend/src/api/bookingApi.js`
- [Court API](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/api/courtApi.js): `frontend/src/api/courtApi.js`
- [Service API](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/api/serviceApi.js): `frontend/src/api/serviceApi.js`
- [Report API](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/api/reportApi.js): `frontend/src/api/reportApi.js`

### Customer booking

- [Sign in / register](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/screens/auth/LoginScreen.js): `frontend/src/screens/auth/LoginScreen.js`
- [Court discovery](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/screens/customer/HomeScreen.js): `frontend/src/screens/customer/HomeScreen.js`
- [Booking and payment](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/screens/customer/BookingScreen.js): `frontend/src/screens/customer/BookingScreen.js`
- [Customer account](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/screens/customer/AccountScreen.js): `frontend/src/screens/customer/AccountScreen.js`
- [Court map](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/screens/map/MapScreen.js): `frontend/src/screens/map/MapScreen.js`

### Admin operations

- [Admin modules](https://github.com/t-glonk/24ct1-tran_quoc_trung/tree/main/frontend/src/screens/admin): `frontend/src/screens/admin`
- [Service POS](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/frontend/src/screens/admin/AdminServicesScreen.js): `frontend/src/screens/admin/AdminServicesScreen.js`

### Backend API

- [Express server](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/server.js): `backend/src/server.js`
- [REST routes](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/routes/index.js): `backend/src/routes/index.js`
- [Booking handling](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/controllers/bookingController.js): `backend/src/controllers/bookingController.js`
- [Court handling](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/controllers/courtController.js): `backend/src/controllers/courtController.js`
- [Customer handling](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/controllers/customerController.js): `backend/src/controllers/customerController.js`
- [Service handling](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/controllers/serviceController.js): `backend/src/controllers/serviceController.js`
- [Authentication](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/controllers/authController.js): `backend/src/controllers/authController.js`
- [Reports](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/controllers/reportController.js): `backend/src/controllers/reportController.js`
- [Transactions](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/controllers/transactionController.js): `backend/src/controllers/transactionController.js`

### Persistence

- [File-backed store](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/config/db.js): `backend/src/config/db.js`
- [Seed records](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/backend/src/data/courts.js): `backend/src/data/courts.js`

### Legacy screens

- [Legacy customer screens](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/src/CustomerScreens.js): `src/CustomerScreens.js`
- [Legacy admin screens](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/src/AdminScreens.js): `src/AdminScreens.js`
- [Legacy sample data](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/src/data.js): `src/data.js`
- [Legacy map](https://github.com/t-glonk/24ct1-tran_quoc_trung/blob/main/src/MapScreen.js): `src/MapScreen.js`

### Other components

- **Customer**
- **Admin staff**

## Connections

- Customer → App shell: opens (evidence: `README.md`)
- Admin staff → App shell: opens (evidence: `README.md`)
- App shell → App state: provides state (evidence: `frontend/App.js`)
- App shell → Screen navigation: renders (evidence: `frontend/App.js`)
- Screen navigation → Sign in / register: routes to (evidence: `frontend/src/navigation/AppNavigator.js`)
- Screen navigation → Court discovery: routes to (evidence: `frontend/src/navigation/AppNavigator.js`)
- Screen navigation → Booking and payment: routes to (evidence: `frontend/src/navigation/AppNavigator.js`)
- Screen navigation → Customer account: routes to (evidence: `frontend/src/navigation/AppNavigator.js`)
- Screen navigation → Court map: routes to (evidence: `frontend/src/navigation/AppNavigator.js`)
- Screen navigation → Admin modules: routes to (evidence: `frontend/src/navigation/AppNavigator.js`)
- App state → Auth API: calls (evidence: `frontend/src/context/AppContext.js`)
- App state → Booking API: calls (evidence: `frontend/src/context/AppContext.js`)
- App state → Court API: calls (evidence: `frontend/src/context/AppContext.js`)
- App state → Service API: calls (evidence: `frontend/src/context/AppContext.js`)
- App state → Report API: calls (evidence: `frontend/src/context/AppContext.js`)
- Service POS → Service API: checks out (evidence: `frontend/src/screens/admin/AdminServicesScreen.js`)
- Auth API → API client: requests through (evidence: `frontend/src/api/authApi.js`)
- Booking API → API client: requests through (evidence: `frontend/src/api/bookingApi.js`)
- Court API → API client: requests through (evidence: `frontend/src/api/courtApi.js`)
- Service API → API client: requests through (evidence: `frontend/src/api/serviceApi.js`)
- API client → Express server: HTTP requests (evidence: `README.md`)
- Express server → REST routes: mounts (evidence: `backend/src/server.js`)
- REST routes → Booking handling: dispatches
- REST routes → Court handling: dispatches
- REST routes → Customer handling: dispatches
- REST routes → Authentication: dispatches (evidence: `README.md`)
- REST routes → Service handling: dispatches (evidence: `README.md`)
- REST routes → Reports: dispatches (evidence: `README.md`)
- REST routes → Transactions: dispatches (evidence: `README.md`)
- Booking handling → File-backed store: reads and writes (evidence: `backend/src/controllers/bookingController.js`)
- Court handling → File-backed store: uses (evidence: `backend/src/controllers/courtController.js`)
- Customer handling → File-backed store: uses (evidence: `backend/src/controllers/customerController.js`)
- Service handling → File-backed store: uses (evidence: `backend/src/controllers/serviceController.js`)
- File-backed store → Seed records: loads seeds (evidence: `backend/src/config/db.js`)
- Legacy customer screens → Legacy sample data: uses (evidence: `src/CustomerScreens.js`)
- Legacy customer screens → Legacy map: uses (evidence: `src/CustomerScreens.js`)
- Legacy admin screens → Legacy sample data: uses (evidence: `src/AdminScreens.js`)
- Legacy map → Legacy sample data: uses (evidence: `src/MapScreen.js`)
