# nguyenvantai12/vkuroombooking architecture

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

- Interactive diagram: https://gitdiagram.com/nguyenvantai12/vkuroombooking
- Repository: https://github.com/nguyenvantai12/vkuroombooking

## Overview

VKU Room Booking is a React Native app for finding study rooms, checking availability, reserving time slots, and managing bookings. Users browse and filter rooms, open room details, choose a date and conflict-free time range, review the reservation, then view or cancel bookings. Room data is served through a simulated service and cached with TanStack Query; filters and persisted bookings use Zustand. README capabilities include dynamic availability, conflict prevention, responsive browsing, and animated booking-list interactions. Some screen implementations were not excerpted, so their documented or indexed connections are shown only where supported.

Main entry points: [`src/hooks/useRooms.ts`](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/hooks/useRooms.ts) (Room query and filters), [`src/store/useBookingStore.ts`](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/store/useBookingStore.ts) (Booking state), [`src/screens/BrowseRoomsScreen.tsx`](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/screens/BrowseRoomsScreen.tsx) (Browse rooms), [`src/screens/BookingScreen.tsx`](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/screens/BookingScreen.tsx) (Select time)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App navigation"]
  node_app["App entry<br/>[App.tsx]"]
  node_root_stack["Root stack<br/>[RootStack.tsx]"]
  node_main_tabs["Main tabs<br/>[MainTabs.tsx]"]
end

subgraph group_rooms["Room discovery"]
  node_browse["Browse rooms"]
  node_room_detail["Room details"]
  node_room_hook["Room query and filters<br/>[useRooms.ts]"]
end

subgraph group_reservations["Booking lifecycle"]
  node_booking_screen["Select time<br/>[BookingScreen.tsx]"]
  node_confirmation["Booking review"]
  node_my_bookings["My bookings"]
  node_profile["Profile<br/>[ProfileScreen.tsx]"]
end

subgraph group_state["Data and state"]
  node_query_provider["Query provider<br/>[QueryProvider.tsx]"]
  node_room_service["Room service<br/>[roomService.ts]"]
  node_room_data[("Room catalog<br/>[rooms.ts]")]
  node_filter_store["Filter state<br/>[useFilterStore.ts]"]
  node_booking_store[("Booking state<br/>[useBookingStore.ts]")]
end

subgraph group_shared["Shared UI and logic"]
  node_booking_rules["Booking rules<br/>[bookingUtils.ts]"]
  node_date_rules["Date and time rules<br/>[dateUtils.ts]"]
  node_room_components["Room cards and filters<br/>[RoomCard.tsx]"]
  node_loading_components["Loading indicators<br/>[SkeletonLoader.tsx]"]
  node_empty_error["Empty and error states<br/>[EmptyState.tsx]"]
  node_theme["Design tokens<br/>[index.ts]"]
end

node_user(("Room seeker"))
node_async_storage[("AsyncStorage")]

node_user -->|"opens"| node_app
node_app -->|"wraps"| node_query_provider
node_app -->|"renders"| node_root_stack
node_root_stack -->|"routes to"| node_main_tabs
node_root_stack -->|"routes to"| node_room_detail
node_root_stack -->|"routes to"| node_booking_screen
node_root_stack -->|"routes to"| node_confirmation
node_main_tabs -->|"routes to"| node_browse
node_main_tabs -->|"routes to"| node_my_bookings
node_main_tabs -->|"routes to"| node_profile
node_browse -->|"queries rooms"| node_room_hook
node_browse -->|"updates filters"| node_filter_store
node_browse -->|"renders"| node_room_components
node_browse -->|"renders"| node_loading_components
node_browse -->|"renders"| node_empty_error
node_room_detail -->|"loads room"| node_room_hook
node_room_detail -->|"renders"| node_loading_components
node_booking_screen -->|"loads room"| node_room_hook
node_booking_screen -->|"reads bookings"| node_booking_store
node_booking_screen -->|"checks conflicts"| node_booking_rules
node_booking_screen -->|"checks slot dates"| node_date_rules
node_booking_screen -->|"navigates to review"| node_confirmation
node_confirmation -->|"adds booking"| node_booking_store
node_confirmation -->|"checks conflicts"| node_booking_rules
node_confirmation -->|"formats dates"| node_date_rules
node_my_bookings -->|"reads and cancels"| node_booking_store
node_my_bookings -->|"loads room data"| node_room_hook
node_my_bookings -->|"derives status"| node_booking_rules
node_my_bookings -->|"renders empty state"| node_empty_error
node_profile -->|"reads bookings"| node_booking_store
node_profile -->|"derives status"| node_booking_rules
node_room_hook -->|"fetches rooms"| node_room_service
node_room_hook -->|"reads filters"| node_filter_store
node_room_hook -->|"reads bookings"| node_booking_store
node_room_hook -->|"derives availability"| node_booking_rules
node_room_hook -->|"gets current date"| node_date_rules
node_room_service -->|"loads catalog"| node_room_data
node_booking_store -->|"validates conflicts"| node_booking_rules
node_booking_store -->|"persists bookings"| node_async_storage

click node_app "https://github.com/nguyenvantai12/vkuroombooking/blob/main/App.tsx"
click node_query_provider "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/providers/QueryProvider.tsx"
click node_root_stack "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/navigation/RootStack.tsx"
click node_main_tabs "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/navigation/MainTabs.tsx"
click node_browse "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/screens/BrowseRoomsScreen.tsx"
click node_room_detail "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/screens/RoomDetailScreen.tsx"
click node_booking_screen "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/screens/BookingScreen.tsx"
click node_confirmation "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/screens/BookingConfirmationScreen.tsx"
click node_my_bookings "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/screens/MyBookingsScreen.tsx"
click node_profile "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/screens/ProfileScreen.tsx"
click node_room_hook "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/hooks/useRooms.ts"
click node_room_service "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/services/roomService.ts"
click node_room_data "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/data/rooms.ts"
click node_filter_store "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/store/useFilterStore.ts"
click node_booking_store "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/store/useBookingStore.ts"
click node_booking_rules "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/utils/bookingUtils.ts"
click node_date_rules "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/utils/dateUtils.ts"
click node_room_components "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/components/RoomCard.tsx"
click node_loading_components "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/components/SkeletonLoader.tsx"
click node_empty_error "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/components/EmptyState.tsx"
click node_theme "https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/theme/index.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_app,node_root_stack,node_main_tabs toneBlue
class node_browse,node_room_detail,node_room_hook,node_async_storage toneAmber
class node_booking_screen,node_confirmation,node_my_bookings,node_profile toneMint
class node_query_provider,node_room_service,node_room_data,node_filter_store,node_booking_store toneRose
class node_booking_rules,node_date_rules,node_room_components,node_loading_components,node_empty_error,node_theme,node_user toneIndigo
```

## Components

### App navigation

- [App entry](https://github.com/nguyenvantai12/vkuroombooking/blob/main/App.tsx): `App.tsx`
- [Root stack](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/navigation/RootStack.tsx): `src/navigation/RootStack.tsx`
- [Main tabs](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/navigation/MainTabs.tsx): `src/navigation/MainTabs.tsx`

### Room discovery

- [Browse rooms](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/screens/BrowseRoomsScreen.tsx): `src/screens/BrowseRoomsScreen.tsx`
- [Room details](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/screens/RoomDetailScreen.tsx): `src/screens/RoomDetailScreen.tsx`
- [Room query and filters](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/hooks/useRooms.ts): `src/hooks/useRooms.ts`

### Booking lifecycle

- [Select time](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/screens/BookingScreen.tsx): `src/screens/BookingScreen.tsx`
- [Booking review](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/screens/BookingConfirmationScreen.tsx): `src/screens/BookingConfirmationScreen.tsx`
- [My bookings](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/screens/MyBookingsScreen.tsx): `src/screens/MyBookingsScreen.tsx`
- [Profile](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/screens/ProfileScreen.tsx): `src/screens/ProfileScreen.tsx`

### Data and state

- [Query provider](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/providers/QueryProvider.tsx): `src/providers/QueryProvider.tsx`
- [Room service](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/services/roomService.ts): `src/services/roomService.ts`
- [Room catalog](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/data/rooms.ts): `src/data/rooms.ts`
- [Filter state](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/store/useFilterStore.ts): `src/store/useFilterStore.ts`
- [Booking state](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/store/useBookingStore.ts): `src/store/useBookingStore.ts`

### Shared UI and logic

- [Booking rules](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/utils/bookingUtils.ts): `src/utils/bookingUtils.ts`
- [Date and time rules](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/utils/dateUtils.ts): `src/utils/dateUtils.ts`
- [Room cards and filters](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/components/RoomCard.tsx): `src/components/RoomCard.tsx`
- [Loading indicators](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/components/SkeletonLoader.tsx): `src/components/SkeletonLoader.tsx`
- [Empty and error states](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/components/EmptyState.tsx): `src/components/EmptyState.tsx`
- [Design tokens](https://github.com/nguyenvantai12/vkuroombooking/blob/main/src/theme/index.ts): `src/theme/index.ts`

### Other components

- **Room seeker**
- **AsyncStorage**

## Connections

- Room seeker → App entry: opens
- App entry → Query provider: wraps (evidence: `App.tsx`)
- App entry → Root stack: renders (evidence: `App.tsx`)
- Root stack → Main tabs: routes to (evidence: `src/navigation/RootStack.tsx`)
- Root stack → Room details: routes to (evidence: `src/navigation/RootStack.tsx`)
- Root stack → Select time: routes to (evidence: `src/navigation/RootStack.tsx`)
- Root stack → Booking review: routes to (evidence: `src/navigation/RootStack.tsx`)
- Main tabs → Browse rooms: routes to (evidence: `src/navigation/MainTabs.tsx`)
- Main tabs → My bookings: routes to (evidence: `src/navigation/MainTabs.tsx`)
- Main tabs → Profile: routes to (evidence: `src/navigation/MainTabs.tsx`)
- Browse rooms → Room query and filters: queries rooms (evidence: `src/screens/BrowseRoomsScreen.tsx`)
- Browse rooms → Filter state: updates filters (evidence: `src/screens/BrowseRoomsScreen.tsx`)
- Browse rooms → Room cards and filters: renders (evidence: `src/screens/BrowseRoomsScreen.tsx`)
- Browse rooms → Loading indicators: renders (evidence: `src/screens/BrowseRoomsScreen.tsx`)
- Browse rooms → Empty and error states: renders (evidence: `src/screens/BrowseRoomsScreen.tsx`)
- Room details → Room query and filters: loads room (evidence: `src/screens/RoomDetailScreen.tsx`)
- Room details → Loading indicators: renders (evidence: `src/screens/RoomDetailScreen.tsx`)
- Select time → Room query and filters: loads room (evidence: `src/screens/BookingScreen.tsx`)
- Select time → Booking state: reads bookings (evidence: `src/screens/BookingScreen.tsx`)
- Select time → Booking rules: checks conflicts (evidence: `src/screens/BookingScreen.tsx`)
- Select time → Date and time rules: checks slot dates (evidence: `src/screens/BookingScreen.tsx`)
- Select time → Booking review: navigates to review (evidence: `src/screens/BookingScreen.tsx`)
- Booking review → Booking state: adds booking (evidence: `src/screens/BookingConfirmationScreen.tsx`)
- Booking review → Booking rules: checks conflicts (evidence: `src/screens/BookingConfirmationScreen.tsx`)
- Booking review → Date and time rules: formats dates (evidence: `src/screens/BookingConfirmationScreen.tsx`)
- My bookings → Booking state: reads and cancels (evidence: `src/screens/MyBookingsScreen.tsx`)
- My bookings → Room query and filters: loads room data (evidence: `src/screens/MyBookingsScreen.tsx`)
- My bookings → Booking rules: derives status (evidence: `src/screens/MyBookingsScreen.tsx`)
- My bookings → Empty and error states: renders empty state (evidence: `src/screens/MyBookingsScreen.tsx`)
- Profile → Booking state: reads bookings (evidence: `src/screens/ProfileScreen.tsx`)
- Profile → Booking rules: derives status (evidence: `src/screens/ProfileScreen.tsx`)
- Room query and filters → Room service: fetches rooms (evidence: `src/hooks/useRooms.ts`)
- Room query and filters → Filter state: reads filters (evidence: `src/hooks/useRooms.ts`)
- Room query and filters → Booking state: reads bookings (evidence: `src/hooks/useRooms.ts`)
- Room query and filters → Booking rules: derives availability (evidence: `src/hooks/useRooms.ts`)
- Room query and filters → Date and time rules: gets current date (evidence: `src/hooks/useRooms.ts`)
- Room service → Room catalog: loads catalog (evidence: `src/services/roomService.ts`)
- Booking state → Booking rules: validates conflicts (evidence: `src/store/useBookingStore.ts`)
- Booking state → AsyncStorage: persists bookings (evidence: `src/store/useBookingStore.ts`)
