# tedysuwega/yat-app architecture

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

- Interactive diagram: https://gitdiagram.com/tedysuwega/yat-app
- Repository: https://github.com/tedysuwega/yat-app

## Overview

YoloTrips is a travel-discovery and booking application with destination and open-trip listings, a multi-step booking experience, payment integration, and an admin dashboard. The documented customer journey runs from browsing destinations and trip schedules through destination details and seat selection to a booking confirmation. The repository also exposes SQLite-backed booking, catalog, and trip APIs, plus admin authentication and booking management. The README describes local persistence for demos, while the sampled API code shows SQLite persistence. Some UI-to-API wiring was not shown, so those connections are omitted.

Main entry points: [`lib/db.ts`](https://github.com/tedysuwega/yat-app/blob/main/lib/db.ts) (SQLite database), [`app/api/bookings/route.ts`](https://github.com/tedysuwega/yat-app/blob/main/app/api/bookings/route.ts) (Booking API), [`lib/auth.ts`](https://github.com/tedysuwega/yat-app/blob/main/lib/auth.ts) (Admin authorization), [`lib/mappers.ts`](https://github.com/tedysuwega/yat-app/blob/main/lib/mappers.ts) (Data mappers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Trip discovery"]
  node_homepage["Trip homepage<br/>[page.tsx]"]
  node_destination_data["Destination catalog<br/>[destinations.ts]"]
  node_destination_detail["Destination details<br/>[page.tsx]"]
  node_trip_api["Open-trip API<br/>[route.ts]"]
  node_destination_api["Destination API<br/>[route.ts]"]
end

subgraph group_booking["Booking and payments"]
  node_booking_page["Booking flow<br/>[page.tsx]"]
  node_booking_api["Booking API<br/>[route.ts]"]
  node_booking_status_api["Booking status API<br/>[route.ts]"]
  node_payment_api["Payment transaction API<br/>[route.ts]"]
  node_payment_notify["Payment notifications<br/>[route.ts]"]
  node_email["Confirmation email<br/>[email.ts]"]
end

subgraph group_operations["Admin operations"]
  node_admin_dashboard["Admin dashboard<br/>[page.tsx]"]
  node_login_page["Admin login page<br/>[page.tsx]"]
  node_login_api["Login API<br/>[route.ts]"]
  node_logout_api["Logout API<br/>[route.ts]"]
  node_middleware["Route middleware<br/>[middleware.ts]"]
end

subgraph group_platform["Application shell"]
  node_layout["App layout<br/>[layout.tsx]"]
  node_navbar["Navigation bar<br/>[Navbar.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
end

subgraph group_data["Data and security"]
  node_sqlite[("SQLite database<br/>[db.ts]")]
  node_mappers["Data mappers<br/>[mappers.ts]"]
  node_validation["Request validation<br/>[validations.ts]"]
  node_auth["Admin authorization<br/>[auth.ts]"]
  node_session["Session configuration<br/>[session.ts]"]
end

node_traveler(("Traveler"))
node_midtrans["Midtrans"]

node_traveler -->|"browses trips"| node_homepage
node_homepage -->|"loads catalog"| node_destination_data
node_traveler -->|"views destination"| node_destination_detail
node_destination_detail -->|"loads details"| node_destination_data
node_traveler -->|"starts booking"| node_booking_page
node_booking_page -->|"loads trip data"| node_destination_data
node_traveler -.->|"requests schedules"| node_trip_api
node_traveler -.->|"requests destinations"| node_destination_api
node_destination_api -->|"queries catalog"| node_sqlite
node_destination_api -->|"maps results"| node_mappers
node_trip_api -->|"queries trips"| node_sqlite
node_trip_api -->|"maps results"| node_mappers
node_booking_api -->|"validates input"| node_validation
node_booking_api -->|"writes bookings"| node_sqlite
node_booking_api -->|"maps admin results"| node_mappers
node_booking_api -->|"checks admin"| node_auth
node_booking_api -->|"sends confirmation"| node_email
node_booking_status_api -->|"validates status"| node_validation
node_booking_status_api -->|"updates bookings"| node_sqlite
node_booking_status_api -->|"maps updated booking"| node_mappers
node_booking_status_api -->|"checks admin"| node_auth
node_payment_api -->|"loads booking"| node_sqlite
node_payment_api -->|"maps booking"| node_mappers
node_payment_api -.->|"creates transaction"| node_midtrans
node_payment_notify -.->|"updates payment data"| node_sqlite
node_traveler -.->|"requests payment"| node_payment_api
node_admin_dashboard -.->|"manages bookings"| node_traveler
node_login_page -.->|"submits credentials"| node_login_api
node_login_api -->|"checks admin"| node_sqlite
node_login_api -->|"validates credentials"| node_validation
node_login_api -->|"creates session"| node_auth
node_logout_api -->|"clears session"| node_auth
node_middleware -->|"reads session"| node_session
node_auth -->|"configures session"| node_session
node_layout -->|"renders"| node_navbar
node_layout -->|"renders"| node_footer

click node_homepage "https://github.com/tedysuwega/yat-app/blob/main/app/page.tsx"
click node_destination_data "https://github.com/tedysuwega/yat-app/blob/main/app/data/destinations.ts"
click node_destination_detail "https://github.com/tedysuwega/yat-app/blob/main/app/destination/%255Bid%255D/page.tsx"
click node_trip_api "https://github.com/tedysuwega/yat-app/blob/main/app/api/trips/route.ts"
click node_destination_api "https://github.com/tedysuwega/yat-app/blob/main/app/api/destinations/route.ts"
click node_booking_page "https://github.com/tedysuwega/yat-app/blob/main/app/book/%255Bid%255D/page.tsx"
click node_booking_api "https://github.com/tedysuwega/yat-app/blob/main/app/api/bookings/route.ts"
click node_booking_status_api "https://github.com/tedysuwega/yat-app/blob/main/app/api/bookings/%5Bid%5D/route.ts"
click node_payment_api "https://github.com/tedysuwega/yat-app/blob/main/app/api/payment/create-transaction/route.ts"
click node_payment_notify "https://github.com/tedysuwega/yat-app/blob/main/app/api/payment/notification/route.ts"
click node_email "https://github.com/tedysuwega/yat-app/blob/main/lib/email.ts"
click node_admin_dashboard "https://github.com/tedysuwega/yat-app/blob/main/app/admin/page.tsx"
click node_login_page "https://github.com/tedysuwega/yat-app/blob/main/app/login/page.tsx"
click node_login_api "https://github.com/tedysuwega/yat-app/blob/main/app/api/auth/login/route.ts"
click node_logout_api "https://github.com/tedysuwega/yat-app/blob/main/app/api/auth/logout/route.ts"
click node_middleware "https://github.com/tedysuwega/yat-app/blob/main/middleware.ts"
click node_layout "https://github.com/tedysuwega/yat-app/blob/main/app/layout.tsx"
click node_navbar "https://github.com/tedysuwega/yat-app/blob/main/app/components/Navbar.tsx"
click node_footer "https://github.com/tedysuwega/yat-app/blob/main/app/components/Footer.tsx"
click node_sqlite "https://github.com/tedysuwega/yat-app/blob/main/lib/db.ts"
click node_mappers "https://github.com/tedysuwega/yat-app/blob/main/lib/mappers.ts"
click node_validation "https://github.com/tedysuwega/yat-app/blob/main/lib/validations.ts"
click node_auth "https://github.com/tedysuwega/yat-app/blob/main/lib/auth.ts"
click node_session "https://github.com/tedysuwega/yat-app/blob/main/lib/session.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_homepage,node_destination_data,node_destination_detail,node_trip_api,node_destination_api toneBlue
class node_booking_page,node_booking_api,node_booking_status_api,node_payment_api,node_payment_notify,node_email toneAmber
class node_admin_dashboard,node_login_page,node_login_api,node_logout_api,node_middleware toneMint
class node_layout,node_navbar,node_footer toneRose
class node_sqlite,node_mappers,node_validation,node_auth,node_session,node_traveler,node_midtrans toneIndigo
```

## Components

### Trip discovery

- [Trip homepage](https://github.com/tedysuwega/yat-app/blob/main/app/page.tsx): `app/page.tsx`
- [Destination catalog](https://github.com/tedysuwega/yat-app/blob/main/app/data/destinations.ts): `app/data/destinations.ts`
- [Destination details](https://github.com/tedysuwega/yat-app/blob/main/app/destination/%255Bid%255D/page.tsx): `app/destination/%5Bid%5D/page.tsx`
- [Open-trip API](https://github.com/tedysuwega/yat-app/blob/main/app/api/trips/route.ts): `app/api/trips/route.ts`
- [Destination API](https://github.com/tedysuwega/yat-app/blob/main/app/api/destinations/route.ts): `app/api/destinations/route.ts`

### Booking and payments

- [Booking flow](https://github.com/tedysuwega/yat-app/blob/main/app/book/%255Bid%255D/page.tsx): `app/book/%5Bid%5D/page.tsx`
- [Booking API](https://github.com/tedysuwega/yat-app/blob/main/app/api/bookings/route.ts): `app/api/bookings/route.ts`
- [Booking status API](https://github.com/tedysuwega/yat-app/blob/main/app/api/bookings/%5Bid%5D/route.ts): `app/api/bookings/[id]/route.ts`
- [Payment transaction API](https://github.com/tedysuwega/yat-app/blob/main/app/api/payment/create-transaction/route.ts): `app/api/payment/create-transaction/route.ts`
- [Payment notifications](https://github.com/tedysuwega/yat-app/blob/main/app/api/payment/notification/route.ts): `app/api/payment/notification/route.ts`
- [Confirmation email](https://github.com/tedysuwega/yat-app/blob/main/lib/email.ts): `lib/email.ts`

### Admin operations

- [Admin dashboard](https://github.com/tedysuwega/yat-app/blob/main/app/admin/page.tsx): `app/admin/page.tsx`
- [Admin login page](https://github.com/tedysuwega/yat-app/blob/main/app/login/page.tsx): `app/login/page.tsx`
- [Login API](https://github.com/tedysuwega/yat-app/blob/main/app/api/auth/login/route.ts): `app/api/auth/login/route.ts`
- [Logout API](https://github.com/tedysuwega/yat-app/blob/main/app/api/auth/logout/route.ts): `app/api/auth/logout/route.ts`
- [Route middleware](https://github.com/tedysuwega/yat-app/blob/main/middleware.ts): `middleware.ts`

### Application shell

- [App layout](https://github.com/tedysuwega/yat-app/blob/main/app/layout.tsx): `app/layout.tsx`
- [Navigation bar](https://github.com/tedysuwega/yat-app/blob/main/app/components/Navbar.tsx): `app/components/Navbar.tsx`
- [Footer](https://github.com/tedysuwega/yat-app/blob/main/app/components/Footer.tsx): `app/components/Footer.tsx`

### Data and security

- [SQLite database](https://github.com/tedysuwega/yat-app/blob/main/lib/db.ts): `lib/db.ts`
- [Data mappers](https://github.com/tedysuwega/yat-app/blob/main/lib/mappers.ts): `lib/mappers.ts`
- [Request validation](https://github.com/tedysuwega/yat-app/blob/main/lib/validations.ts): `lib/validations.ts`
- [Admin authorization](https://github.com/tedysuwega/yat-app/blob/main/lib/auth.ts): `lib/auth.ts`
- [Session configuration](https://github.com/tedysuwega/yat-app/blob/main/lib/session.ts): `lib/session.ts`

### Other components

- **Traveler**
- **Midtrans**

## Connections

- Traveler → Trip homepage: browses trips (evidence: `README.md`)
- Trip homepage → Destination catalog: loads catalog (evidence: `app/page.tsx`)
- Traveler → Destination details: views destination (evidence: `README.md`)
- Destination details → Destination catalog: loads details (evidence: `app/destination/%5Bid%5D/page.tsx`)
- Traveler → Booking flow: starts booking (evidence: `README.md`)
- Booking flow → Destination catalog: loads trip data (evidence: `app/book/%5Bid%5D/page.tsx`)
- Traveler → Open-trip API: requests schedules
- Traveler → Destination API: requests destinations
- Destination API → SQLite database: queries catalog (evidence: `app/api/destinations/route.ts`)
- Destination API → Data mappers: maps results (evidence: `app/api/destinations/route.ts`)
- Open-trip API → SQLite database: queries trips (evidence: `app/api/trips/route.ts`)
- Open-trip API → Data mappers: maps results (evidence: `app/api/trips/route.ts`)
- Booking API → Request validation: validates input (evidence: `app/api/bookings/route.ts`)
- Booking API → SQLite database: writes bookings (evidence: `app/api/bookings/route.ts`)
- Booking API → Data mappers: maps admin results (evidence: `app/api/bookings/route.ts`)
- Booking API → Admin authorization: checks admin (evidence: `app/api/bookings/route.ts`)
- Booking API → Confirmation email: sends confirmation (evidence: `app/api/bookings/route.ts`)
- Booking status API → Request validation: validates status (evidence: `app/api/bookings/[id]/route.ts`)
- Booking status API → SQLite database: updates bookings (evidence: `app/api/bookings/[id]/route.ts`)
- Booking status API → Data mappers: maps updated booking (evidence: `app/api/bookings/[id]/route.ts`)
- Booking status API → Admin authorization: checks admin (evidence: `app/api/bookings/[id]/route.ts`)
- Payment transaction API → SQLite database: loads booking (evidence: `app/api/payment/create-transaction/route.ts`)
- Payment transaction API → Data mappers: maps booking (evidence: `app/api/payment/create-transaction/route.ts`)
- Payment transaction API → Midtrans: creates transaction (evidence: `app/api/payment/create-transaction/route.ts`)
- Payment notifications → SQLite database: updates payment data (evidence: `app/api/payment/notification/route.ts`)
- Traveler → Payment transaction API: requests payment
- Admin dashboard → Traveler: manages bookings
- Admin login page → Login API: submits credentials
- Login API → SQLite database: checks admin (evidence: `app/api/auth/login/route.ts`)
- Login API → Request validation: validates credentials (evidence: `app/api/auth/login/route.ts`)
- Login API → Admin authorization: creates session (evidence: `app/api/auth/login/route.ts`)
- Logout API → Admin authorization: clears session (evidence: `app/api/auth/logout/route.ts`)
- Route middleware → Session configuration: reads session (evidence: `middleware.ts`)
- Admin authorization → Session configuration: configures session (evidence: `lib/auth.ts`)
- App layout → Navigation bar: renders (evidence: `app/layout.tsx`)
- App layout → Footer: renders (evidence: `app/layout.tsx`)
