# lordherohero/nasugbu-roots architecture

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

- Interactive diagram: https://gitdiagram.com/lordherohero/nasugbu-roots
- Repository: https://github.com/lordherohero/nasugbu-roots

## Overview

Nasugbu Roots is a tourism-discovery and booking product, represented by an Android app and a separate Kotlin console implementation. The Android user workflow runs from account registration/sign-in to browsing and viewing spots, booking, managing bookings, and reviewing a visit. The README also documents guide, owner, and manager workflows; their console action modules are shown as distinct capabilities. Source excerpts establish selected Android calls and Firebase access, but do not expose all screen routing or console dispatch, so those links are omitted rather than inferred.

Main entry points: [`app/src/main/java/com/mygroup/nasugburoots/ui/HomeScreen.kt`](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/HomeScreen.kt) (Explore home), [`app/src/main/java/com/mygroup/nasugburoots/data/Repository.kt`](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/data/Repository.kt) (Tourism repository), [`app/src/main/java/com/mygroup/nasugburoots/ui/auth/AuthenticationNavigation.kt`](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/auth/AuthenticationNavigation.kt) (Auth navigation), [`app/src/main/java/com/mygroup/nasugburoots/data/ReviewRepository.kt`](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/data/ReviewRepository.kt) (Review repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_android["Android experience"]
  node_activity["App entry<br/>[MainActivity.kt]"]
  node_home["Explore home<br/>[HomeScreen.kt]"]
  node_spot_list["Spot browsing<br/>[SpotListScreen.kt]"]
  node_spot_details["Spot details"]
  node_map["Spot map"]
  node_booking_form["Booking form"]
  node_my_bookings["My bookings"]
  node_review_form["Review form"]
  node_theme["Theme colors<br/>[Color.kt]"]
end

subgraph group_identity["Identity"]
  node_auth_nav["Auth navigation"]
  node_auth_screen["Sign-in"]
  node_role_screen["Role registration"]
end

subgraph group_services["Data services"]
  node_user_repo["User accounts<br/>[UserRepository.kt]"]
  node_current_user["Current user<br/>[CurrentUser.kt]"]
  node_repository["Tourism repository<br/>[Repository.kt]"]
  node_review_repo["Review repository"]
end

subgraph group_domain["Tourism domain"]
  node_booking["Booking model<br/>[Booking.kt]"]
  node_guide["Guide model<br/>[Guide.kt]"]
  node_review["Review model<br/>[Review.kt]"]
  node_spot["Tourist spot<br/>[TouristSpot.kt]"]
end

subgraph group_console["Console roles"]
  node_console_main["Console entry<br/>[Main.kt]"]
  node_console_login["Console accounts<br/>[Login.kt]"]
  node_tourist_actions["Tourist actions<br/>[Touristactions.kt]"]
  node_guide_actions["Guide actions<br/>[Guideactions.kt]"]
  node_owner_actions["Owner actions<br/>[Owneractions.kt]"]
  node_manager_actions["Manager actions<br/>[Manageractions.kt]"]
  node_console_store[("Console datastore<br/>[Datastore.kt]")]
end

node_traveler(("Traveler"))
node_firestore[("Cloud Firestore")]

node_traveler -.->|"opens"| node_activity
node_activity -.->|"starts"| node_home
node_home -->|"opens"| node_booking_form
node_home -->|"opens"| node_spot_details
node_home -->|"renders"| node_spot_list
node_home -->|"routes"| node_map
node_home -->|"routes"| node_my_bookings
node_home -->|"saves booking"| node_repository
node_auth_nav -->|"routes"| node_auth_screen
node_auth_nav -->|"routes"| node_role_screen
node_auth_nav -->|"authenticates"| node_user_repo
node_auth_nav -->|"sets identity"| node_current_user
node_user_repo -.->|"reads/writes"| node_firestore
node_repository -->|"reads/writes"| node_firestore
node_review_repo -->|"reads/writes"| node_firestore
node_review_repo -->|"stores"| node_review
node_repository -->|"stores"| node_booking
node_repository -->|"loads"| node_spot
node_repository -->|"loads"| node_guide
node_review_form -->|"creates"| node_review

click node_activity "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/MainActivity.kt"
click node_home "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/HomeScreen.kt"
click node_spot_list "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/SpotListScreen.kt"
click node_spot_details "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/DestinationDetailsScreen.kt"
click node_map "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/NasugbuMapScreen.kt"
click node_booking_form "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/BookingFormScreen.kt"
click node_my_bookings "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/MyBookingsScreen.kt"
click node_review_form "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/ReviewFormScreen.kt"
click node_auth_nav "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/auth/AuthenticationNavigation.kt"
click node_auth_screen "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/auth/AuthenticationScreen.kt"
click node_role_screen "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/auth/AuthenticationRoleScreen.kt"
click node_user_repo "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/data/UserRepository.kt"
click node_current_user "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/data/CurrentUser.kt"
click node_repository "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/data/Repository.kt"
click node_review_repo "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/data/ReviewRepository.kt"
click node_booking "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/model/Booking.kt"
click node_guide "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/model/Guide.kt"
click node_review "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/model/Review.kt"
click node_spot "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/model/TouristSpot.kt"
click node_theme "https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/theme/Color.kt"
click node_console_main "https://github.com/lordherohero/nasugbu-roots/blob/master/src/Main.kt"
click node_console_login "https://github.com/lordherohero/nasugbu-roots/blob/master/src/Login.kt"
click node_tourist_actions "https://github.com/lordherohero/nasugbu-roots/blob/master/src/Touristactions.kt"
click node_guide_actions "https://github.com/lordherohero/nasugbu-roots/blob/master/src/Guideactions.kt"
click node_owner_actions "https://github.com/lordherohero/nasugbu-roots/blob/master/src/Owneractions.kt"
click node_manager_actions "https://github.com/lordherohero/nasugbu-roots/blob/master/src/Manageractions.kt"
click node_console_store "https://github.com/lordherohero/nasugbu-roots/blob/master/src/Datastore.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_activity,node_home,node_spot_list,node_spot_details,node_map,node_booking_form,node_my_bookings,node_review_form,node_theme toneBlue
class node_auth_nav,node_auth_screen,node_role_screen,node_firestore toneAmber
class node_user_repo,node_current_user,node_repository,node_review_repo toneMint
class node_booking,node_guide,node_review,node_spot toneRose
class node_console_main,node_console_login,node_tourist_actions,node_guide_actions,node_owner_actions,node_manager_actions,node_console_store,node_traveler toneIndigo
```

## Components

### Android experience

- [App entry](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/MainActivity.kt): `app/src/main/java/com/mygroup/nasugburoots/MainActivity.kt`
- [Explore home](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/HomeScreen.kt): `app/src/main/java/com/mygroup/nasugburoots/ui/HomeScreen.kt`
- [Spot browsing](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/SpotListScreen.kt): `app/src/main/java/com/mygroup/nasugburoots/ui/SpotListScreen.kt`
- [Spot details](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/DestinationDetailsScreen.kt): `app/src/main/java/com/mygroup/nasugburoots/ui/DestinationDetailsScreen.kt`
- [Spot map](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/NasugbuMapScreen.kt): `app/src/main/java/com/mygroup/nasugburoots/ui/NasugbuMapScreen.kt`
- [Booking form](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/BookingFormScreen.kt): `app/src/main/java/com/mygroup/nasugburoots/ui/BookingFormScreen.kt`
- [My bookings](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/MyBookingsScreen.kt): `app/src/main/java/com/mygroup/nasugburoots/ui/MyBookingsScreen.kt`
- [Review form](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/ReviewFormScreen.kt): `app/src/main/java/com/mygroup/nasugburoots/ui/ReviewFormScreen.kt`
- [Theme colors](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/theme/Color.kt): `app/src/main/java/com/mygroup/nasugburoots/ui/theme/Color.kt`

### Identity

- [Auth navigation](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/auth/AuthenticationNavigation.kt): `app/src/main/java/com/mygroup/nasugburoots/ui/auth/AuthenticationNavigation.kt`
- [Sign-in](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/auth/AuthenticationScreen.kt): `app/src/main/java/com/mygroup/nasugburoots/ui/auth/AuthenticationScreen.kt`
- [Role registration](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/ui/auth/AuthenticationRoleScreen.kt): `app/src/main/java/com/mygroup/nasugburoots/ui/auth/AuthenticationRoleScreen.kt`

### Data services

- [User accounts](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/data/UserRepository.kt): `app/src/main/java/com/mygroup/nasugburoots/data/UserRepository.kt`
- [Current user](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/data/CurrentUser.kt): `app/src/main/java/com/mygroup/nasugburoots/data/CurrentUser.kt`
- [Tourism repository](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/data/Repository.kt): `app/src/main/java/com/mygroup/nasugburoots/data/Repository.kt`
- [Review repository](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/data/ReviewRepository.kt): `app/src/main/java/com/mygroup/nasugburoots/data/ReviewRepository.kt`

### Tourism domain

- [Booking model](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/model/Booking.kt): `app/src/main/java/com/mygroup/nasugburoots/model/Booking.kt`
- [Guide model](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/model/Guide.kt): `app/src/main/java/com/mygroup/nasugburoots/model/Guide.kt`
- [Review model](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/model/Review.kt): `app/src/main/java/com/mygroup/nasugburoots/model/Review.kt`
- [Tourist spot](https://github.com/lordherohero/nasugbu-roots/blob/master/app/src/main/java/com/mygroup/nasugburoots/model/TouristSpot.kt): `app/src/main/java/com/mygroup/nasugburoots/model/TouristSpot.kt`

### Console roles

- [Console entry](https://github.com/lordherohero/nasugbu-roots/blob/master/src/Main.kt): `src/Main.kt`
- [Console accounts](https://github.com/lordherohero/nasugbu-roots/blob/master/src/Login.kt): `src/Login.kt`
- [Tourist actions](https://github.com/lordherohero/nasugbu-roots/blob/master/src/Touristactions.kt): `src/Touristactions.kt`
- [Guide actions](https://github.com/lordherohero/nasugbu-roots/blob/master/src/Guideactions.kt): `src/Guideactions.kt`
- [Owner actions](https://github.com/lordherohero/nasugbu-roots/blob/master/src/Owneractions.kt): `src/Owneractions.kt`
- [Manager actions](https://github.com/lordherohero/nasugbu-roots/blob/master/src/Manageractions.kt): `src/Manageractions.kt`
- [Console datastore](https://github.com/lordherohero/nasugbu-roots/blob/master/src/Datastore.kt): `src/Datastore.kt`

### Other components

- **Traveler**
- **Cloud Firestore**

## Connections

- Traveler → App entry: opens
- App entry → Explore home: starts
- Explore home → Booking form: opens (evidence: `app/src/main/java/com/mygroup/nasugburoots/ui/HomeScreen.kt`)
- Explore home → Spot details: opens (evidence: `app/src/main/java/com/mygroup/nasugburoots/ui/HomeScreen.kt`)
- Explore home → Spot browsing: renders (evidence: `app/src/main/java/com/mygroup/nasugburoots/ui/HomeScreen.kt`)
- Explore home → Spot map: routes (evidence: `app/src/main/java/com/mygroup/nasugburoots/ui/HomeScreen.kt`)
- Explore home → My bookings: routes (evidence: `app/src/main/java/com/mygroup/nasugburoots/ui/HomeScreen.kt`)
- Explore home → Tourism repository: saves booking (evidence: `app/src/main/java/com/mygroup/nasugburoots/ui/HomeScreen.kt`)
- Auth navigation → Sign-in: routes (evidence: `app/src/main/java/com/mygroup/nasugburoots/ui/auth/AuthenticationNavigation.kt`)
- Auth navigation → Role registration: routes (evidence: `app/src/main/java/com/mygroup/nasugburoots/ui/auth/AuthenticationNavigation.kt`)
- Auth navigation → User accounts: authenticates (evidence: `app/src/main/java/com/mygroup/nasugburoots/ui/auth/AuthenticationNavigation.kt`)
- Auth navigation → Current user: sets identity (evidence: `app/src/main/java/com/mygroup/nasugburoots/ui/auth/AuthenticationNavigation.kt`)
- User accounts → Cloud Firestore: reads/writes
- Tourism repository → Cloud Firestore: reads/writes (evidence: `app/src/main/java/com/mygroup/nasugburoots/data/Repository.kt`)
- Review repository → Cloud Firestore: reads/writes (evidence: `app/src/main/java/com/mygroup/nasugburoots/data/ReviewRepository.kt`)
- Review repository → Review model: stores (evidence: `app/src/main/java/com/mygroup/nasugburoots/data/ReviewRepository.kt`)
- Tourism repository → Booking model: stores (evidence: `app/src/main/java/com/mygroup/nasugburoots/data/Repository.kt`)
- Tourism repository → Tourist spot: loads (evidence: `app/src/main/java/com/mygroup/nasugburoots/data/Repository.kt`)
- Tourism repository → Guide model: loads (evidence: `app/src/main/java/com/mygroup/nasugburoots/data/Repository.kt`)
- Review form → Review model: creates (evidence: `app/src/main/java/com/mygroup/nasugburoots/ui/ReviewFormScreen.kt`)
