How ashwin-r2/smartstay works
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: App.tsx React app · PropertyService.java Property catalog · client.ts API client · ReviewService.java Reviews and ratings
Components 25
Web experience
- React app
frontend/src/App.tsx - Browse and search
frontend/src/pages/SearchResults.tsx - Property details
frontend/src/pages/PropertyDetails.tsx - Login and register
frontend/src/pages/Login.tsx - Host tools
frontend/src/pages/host/PropertyForm.tsx - Guest tools
frontend/src/pages/guest/MyBookings.tsx - Admin dashboard
frontend/src/pages/admin/AdminDashboard.tsx - API client
frontend/src/api/client.ts
Identity and access
- Authentication
backend/src/main/java/com/staysmart/user/service/AuthService.java - User profiles
backend/src/main/java/com/staysmart/user/service/UserService.java - JWT handling
backend/src/main/java/com/staysmart/security/JwtService.java
Rental operations
- Property catalog
backend/src/main/java/com/staysmart/property/service/PropertyService.java - Property records
backend/src/main/java/com/staysmart/property/entity/Property.java - Booking lifecycle
backend/src/main/java/com/staysmart/booking/service/BookingService.java - Reviews and ratings
backend/src/main/java/com/staysmart/review/service/ReviewService.java - Image storage
backend/src/main/java/com/staysmart/property/service/ImageStorageService.java - PostgreSQL
AI assistance
- Smart search
backend/src/main/java/com/staysmart/ai/service/SmartSearchAiService.java - AI features
backend/src/main/java/com/staysmart/ai/service
Platform operations
- Administration
backend/src/main/java/com/staysmart/admin/service/AdminService.java - AI usage analytics
backend/src/main/java/com/staysmart/ai/service/AiUsageLogger.java
Other components
- Guest
- Host
- Administrator
- OpenAI API
Connections 41
- Guest → React app: uses
README.md - Host → React app: uses
README.md - Administrator → React app: uses
README.md - React app → Browse and search: routes to
frontend/src/App.tsx - React app → Property details: routes to
frontend/src/App.tsx - React app → Login and register: routes to
frontend/src/App.tsx - React app → Host tools: routes to
frontend/src/App.tsx - React app → Guest tools: routes to
frontend/src/App.tsx - React app → Admin dashboard: routes to
frontend/src/App.tsx - Browse and search → API client: uses
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
README.md - Login and register → Authentication: supports sign-in
README.md - Authentication → JWT handling: issues tokens
backend/src/main/java/com/staysmart/user/service/AuthService.java - Authentication → User profiles: uses accounts
backend/src/main/java/com/staysmart/user/service/AuthService.java - Browse and search → Smart search: offers smart search
README.md - Smart search → Property catalog: searches
backend/src/main/java/com/staysmart/ai/service/SmartSearchAiService.java - Smart search → OpenAI API: parses query
README.md - Property catalog → Property records: manages
backend/src/main/java/com/staysmart/property/service/PropertyService.java - Property details → Booking lifecycle: starts booking
README.md - Booking lifecycle → Property catalog: checks availability
backend/src/main/java/com/staysmart/booking/service/BookingService.java - Booking lifecycle → User profiles: checks guest
backend/src/main/java/com/staysmart/booking/service/BookingService.java - Booking lifecycle → PostgreSQL: persists bookings
README.md - Guest tools → Reviews and ratings: submits review
README.md - Reviews and ratings → Booking lifecycle: validates completed stay
backend/src/main/java/com/staysmart/review/service/ReviewService.java - Reviews and ratings → Property catalog: refreshes rating
backend/src/main/java/com/staysmart/review/service/ReviewService.java - Reviews and ratings → Image storage: stores images
backend/src/main/java/com/staysmart/review/service/ReviewService.java - Property catalog → Image storage: stores images
backend/src/main/java/com/staysmart/property/service/PropertyService.java - Property catalog → PostgreSQL: persists listings
README.md - Reviews and ratings → PostgreSQL: persists reviews
README.md - Guest tools → AI features: uses trip and budget tools
README.md - React app → AI features: offers AI tools
README.md - AI features → OpenAI API: requests AI results
README.md - Admin dashboard → Administration: manages platform
README.md - Administration → User profiles: manages users
README.md - Administration → Property catalog: manages listings
README.md - Admin dashboard → AI usage analytics: views usage stats
README.md