# ashwin-r2/smartstay architecture

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

- Interactive diagram: https://gitdiagram.com/ashwin-r2/smartstay
- Repository: https://github.com/ashwin-r2/smartstay

## Overview

StaySmart AI is a vacation-rental platform for guests, hosts, and administrators. Users browse or smart-search properties, book stays, and review completed bookings; hosts manage listings and availability, while administrators manage platform resources and inspect analytics. The React app routes users to these experiences and calls a Spring REST API; backend services enforce domain rules and persist platform data. AI capabilities include chat, recommendations, trip and budget planning, review summaries, listing descriptions, and smart search. Some feature wiring is documented but its implementation was not sampled, so those links use README evidence.

Main entry points: [`frontend/src/App.tsx`](https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/App.tsx) (React app), [`backend/src/main/java/com/staysmart/property/service/PropertyService.java`](https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/property/service/PropertyService.java) (Property catalog), [`frontend/src/api/client.ts`](https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/api/client.ts) (API client), [`backend/src/main/java/com/staysmart/review/service/ReviewService.java`](https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/review/service/ReviewService.java) (Reviews and ratings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web experience"]
  node_webapp["React app<br/>[App.tsx]"]
  node_websearch["Browse and search<br/>[SearchResults.tsx]"]
  node_webproperty["Property details"]
  node_webauth["Login and register<br/>[Login.tsx]"]
  node_webhost["Host tools<br/>[PropertyForm.tsx]"]
  node_webguest["Guest tools<br/>[MyBookings.tsx]"]
  node_webadmin["Admin dashboard<br/>[AdminDashboard.tsx]"]
  node_apiclient["API client<br/>[client.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_users["User profiles<br/>[UserService.java]"]
  node_jwt["JWT handling<br/>[JwtService.java]"]
end

subgraph group_rental["Rental operations"]
  node_properties["Property catalog"]
  node_propertydata["Property records<br/>[Property.java]"]
  node_bookings["Booking lifecycle"]
  node_reviews["Reviews and ratings<br/>[ReviewService.java]"]
  node_imagestore["Image storage"]
  node_database[("PostgreSQL")]
end

subgraph group_intelligence["AI assistance"]
  node_smartsearch["Smart search"]
  node_aifeatures["AI features"]
end

subgraph group_operations["Platform operations"]
  node_adminops["Administration<br/>[AdminService.java]"]
  node_analytics["AI usage analytics<br/>[AiUsageLogger.java]"]
end

node_guest(("Guest"))
node_host(("Host"))
node_admin(("Administrator"))
node_openai{{"OpenAI API"}}

node_guest -->|"uses"| node_webapp
node_host -->|"uses"| node_webapp
node_admin -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_websearch
node_webapp -->|"routes to"| node_webproperty
node_webapp -->|"routes to"| node_webauth
node_webapp -->|"routes to"| node_webhost
node_webapp -->|"routes to"| node_webguest
node_webapp -->|"routes to"| node_webadmin
node_websearch -.->|"uses"| node_apiclient
node_webproperty -.->|"uses"| node_apiclient
node_webauth -.->|"uses"| node_apiclient
node_webhost -.->|"uses"| node_apiclient
node_webguest -.->|"uses"| node_apiclient
node_webadmin -.->|"uses"| node_apiclient
node_apiclient -.->|"calls API"| node_auth
node_webauth -.->|"supports sign-in"| node_auth
node_auth -->|"issues tokens"| node_jwt
node_auth -->|"uses accounts"| node_users
node_websearch -.->|"offers smart search"| node_smartsearch
node_smartsearch -->|"searches"| node_properties
node_smartsearch -.->|"parses query"| node_openai
node_properties -.->|"manages"| node_propertydata
node_webproperty -.->|"starts booking"| node_bookings
node_bookings -->|"checks availability"| node_properties
node_bookings -->|"checks guest"| node_users
node_bookings -.->|"persists bookings"| node_database
node_webguest -.->|"submits review"| node_reviews
node_reviews -->|"validates completed stay"| node_bookings
node_reviews -->|"refreshes rating"| node_properties
node_reviews -->|"stores images"| node_imagestore
node_properties -.->|"stores images"| node_imagestore
node_properties -.->|"persists listings"| node_database
node_reviews -.->|"persists reviews"| node_database
node_webguest -.->|"uses trip and budget tools"| node_aifeatures
node_webapp -.->|"offers AI tools"| node_aifeatures
node_aifeatures -.->|"requests AI results"| node_openai
node_webadmin -.->|"manages platform"| node_adminops
node_adminops -.->|"manages users"| node_users
node_adminops -.->|"manages listings"| node_properties
node_webadmin -.->|"views usage stats"| node_analytics

click node_webapp "https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/App.tsx"
click node_websearch "https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/pages/SearchResults.tsx"
click node_webproperty "https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/pages/PropertyDetails.tsx"
click node_webauth "https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/pages/Login.tsx"
click node_webhost "https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/pages/host/PropertyForm.tsx"
click node_webguest "https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/pages/guest/MyBookings.tsx"
click node_webadmin "https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/pages/admin/AdminDashboard.tsx"
click node_apiclient "https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/api/client.ts"
click node_auth "https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/user/service/AuthService.java"
click node_users "https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/user/service/UserService.java"
click node_jwt "https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/security/JwtService.java"
click node_properties "https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/property/service/PropertyService.java"
click node_propertydata "https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/property/entity/Property.java"
click node_bookings "https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/booking/service/BookingService.java"
click node_reviews "https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/review/service/ReviewService.java"
click node_imagestore "https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/property/service/ImageStorageService.java"
click node_smartsearch "https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/ai/service/SmartSearchAiService.java"
click node_aifeatures "https://github.com/ashwin-r2/smartstay/tree/master/backend/src/main/java/com/staysmart/ai/service"
click node_adminops "https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/admin/service/AdminService.java"
click node_analytics "https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/ai/service/AiUsageLogger.java"

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_webapp,node_websearch,node_webproperty,node_webauth,node_webhost,node_webguest,node_webadmin,node_apiclient toneBlue
class node_auth,node_users,node_jwt toneAmber
class node_properties,node_propertydata,node_bookings,node_reviews,node_imagestore,node_database,node_openai toneMint
class node_smartsearch,node_aifeatures toneRose
class node_adminops,node_analytics,node_guest,node_host,node_admin toneIndigo
```

## Components

### Web experience

- [React app](https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Browse and search](https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/pages/SearchResults.tsx): `frontend/src/pages/SearchResults.tsx`
- [Property details](https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/pages/PropertyDetails.tsx): `frontend/src/pages/PropertyDetails.tsx`
- [Login and register](https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/pages/Login.tsx): `frontend/src/pages/Login.tsx`
- [Host tools](https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/pages/host/PropertyForm.tsx): `frontend/src/pages/host/PropertyForm.tsx`
- [Guest tools](https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/pages/guest/MyBookings.tsx): `frontend/src/pages/guest/MyBookings.tsx`
- [Admin dashboard](https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/pages/admin/AdminDashboard.tsx): `frontend/src/pages/admin/AdminDashboard.tsx`
- [API client](https://github.com/ashwin-r2/smartstay/blob/master/frontend/src/api/client.ts): `frontend/src/api/client.ts`

### Identity and access

- [Authentication](https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/user/service/AuthService.java): `backend/src/main/java/com/staysmart/user/service/AuthService.java`
- [User profiles](https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/user/service/UserService.java): `backend/src/main/java/com/staysmart/user/service/UserService.java`
- [JWT handling](https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/security/JwtService.java): `backend/src/main/java/com/staysmart/security/JwtService.java`

### Rental operations

- [Property catalog](https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/property/service/PropertyService.java): `backend/src/main/java/com/staysmart/property/service/PropertyService.java`
- [Property records](https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/property/entity/Property.java): `backend/src/main/java/com/staysmart/property/entity/Property.java`
- [Booking lifecycle](https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/booking/service/BookingService.java): `backend/src/main/java/com/staysmart/booking/service/BookingService.java`
- [Reviews and ratings](https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/review/service/ReviewService.java): `backend/src/main/java/com/staysmart/review/service/ReviewService.java`
- [Image storage](https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/property/service/ImageStorageService.java): `backend/src/main/java/com/staysmart/property/service/ImageStorageService.java`
- **PostgreSQL**

### AI assistance

- [Smart search](https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/ai/service/SmartSearchAiService.java): `backend/src/main/java/com/staysmart/ai/service/SmartSearchAiService.java`
- [AI features](https://github.com/ashwin-r2/smartstay/tree/master/backend/src/main/java/com/staysmart/ai/service): `backend/src/main/java/com/staysmart/ai/service`

### Platform operations

- [Administration](https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/admin/service/AdminService.java): `backend/src/main/java/com/staysmart/admin/service/AdminService.java`
- [AI usage analytics](https://github.com/ashwin-r2/smartstay/blob/master/backend/src/main/java/com/staysmart/ai/service/AiUsageLogger.java): `backend/src/main/java/com/staysmart/ai/service/AiUsageLogger.java`

### Other components

- **Guest**
- **Host**
- **Administrator**
- **OpenAI API**

## Connections

- Guest → React app: uses (evidence: `README.md`)
- Host → React app: uses (evidence: `README.md`)
- Administrator → React app: uses (evidence: `README.md`)
- React app → Browse and search: routes to (evidence: `frontend/src/App.tsx`)
- React app → Property details: routes to (evidence: `frontend/src/App.tsx`)
- React app → Login and register: routes to (evidence: `frontend/src/App.tsx`)
- React app → Host tools: routes to (evidence: `frontend/src/App.tsx`)
- React app → Guest tools: routes to (evidence: `frontend/src/App.tsx`)
- React app → Admin dashboard: routes to (evidence: `frontend/src/App.tsx`)
- Browse and search → API client: uses (evidence: `frontend/src/pages/SearchResults.tsx`)
- Property details → API client: uses
- Login and register → API client: uses
- Host tools → API client: uses
- Guest tools → API client: uses
- Admin dashboard → API client: uses
- API client → Authentication: calls API (evidence: `README.md`)
- Login and register → Authentication: supports sign-in (evidence: `README.md`)
- Authentication → JWT handling: issues tokens (evidence: `backend/src/main/java/com/staysmart/user/service/AuthService.java`)
- Authentication → User profiles: uses accounts (evidence: `backend/src/main/java/com/staysmart/user/service/AuthService.java`)
- Browse and search → Smart search: offers smart search (evidence: `README.md`)
- Smart search → Property catalog: searches (evidence: `backend/src/main/java/com/staysmart/ai/service/SmartSearchAiService.java`)
- Smart search → OpenAI API: parses query (evidence: `README.md`)
- Property catalog → Property records: manages (evidence: `backend/src/main/java/com/staysmart/property/service/PropertyService.java`)
- Property details → Booking lifecycle: starts booking (evidence: `README.md`)
- Booking lifecycle → Property catalog: checks availability (evidence: `backend/src/main/java/com/staysmart/booking/service/BookingService.java`)
- Booking lifecycle → User profiles: checks guest (evidence: `backend/src/main/java/com/staysmart/booking/service/BookingService.java`)
- Booking lifecycle → PostgreSQL: persists bookings (evidence: `README.md`)
- Guest tools → Reviews and ratings: submits review (evidence: `README.md`)
- Reviews and ratings → Booking lifecycle: validates completed stay (evidence: `backend/src/main/java/com/staysmart/review/service/ReviewService.java`)
- Reviews and ratings → Property catalog: refreshes rating (evidence: `backend/src/main/java/com/staysmart/review/service/ReviewService.java`)
- Reviews and ratings → Image storage: stores images (evidence: `backend/src/main/java/com/staysmart/review/service/ReviewService.java`)
- Property catalog → Image storage: stores images (evidence: `backend/src/main/java/com/staysmart/property/service/PropertyService.java`)
- Property catalog → PostgreSQL: persists listings (evidence: `README.md`)
- Reviews and ratings → PostgreSQL: persists reviews (evidence: `README.md`)
- Guest tools → AI features: uses trip and budget tools (evidence: `README.md`)
- React app → AI features: offers AI tools (evidence: `README.md`)
- AI features → OpenAI API: requests AI results (evidence: `README.md`)
- Admin dashboard → Administration: manages platform (evidence: `README.md`)
- Administration → User profiles: manages users (evidence: `README.md`)
- Administration → Property catalog: manages listings (evidence: `README.md`)
- Admin dashboard → AI usage analytics: views usage stats (evidence: `README.md`)
