How mustafaal-kayyali/xenon works
Xenon is a tourism platform spanning a web portal, traveler mobile app, Node.js backend, and a separate AI travel-advisor service. Travelers discover packages, get personalized recommendations, and manage bookings and payments; vendors manage offerings, while administrators oversee platform operations. The backend provides shared APIs and MongoDB-backed business capabilities, and the AI service combines package knowledge with preference, weather, and currency inputs. The README documents mobile capabilities, but the supplied tree exposes only platform runners, not Flutter feature code; links beyond documented architecture are omitted.
Main entry points: app.js API Application · recommendationRoutes.js Recommendation Endpoint · App.jsx Web Portal · pages Role Dashboards
Components 34
Web Portal
- Web Portal
frontend/src/app/App.jsx - Role Dashboards
frontend/src/pages - Web API Client
frontend/src/services/api.js - Session Storage
frontend/src/services/storage.js
Platform Backend
- API Application
backend/src/app.js - Authentication Routes
backend/src/Routes/authRoutes.js - Account & OTP
backend/src/controllers/authController.js - Authentication Core
backend/src/services/Core/authCore.js - OTP Core
backend/src/services/Core/otpCore.js - Access Control
backend/src/middlewares/authMiddleware.js - Booking Operations
backend/src/services/Core/bookingCore.js - Booking Validation
backend/src/validations/bookingValidation.js - Payment Operations
backend/src/services/Core/paymentCore.js - Payment Routes
backend/src/Routes/PaymentRouter.js - Review Routes
backend/src/Routes/reviewRouter.js - Review Controller
backend/src/controllers/Client/reviewController.js - Review Operations
backend/src/services/Core/Client/reviewCore.js - Admin Moderation
backend/src/services/Core/Admin/moderationCore.js - Package & Vendor APIs
backend/src/Routes/packageRoutes.js - Backend AI Adapter
backend/src/services/Integration/aiService.js
AI Advisor
- Recommendation Endpoint
ai/src/http/routes/recommendationRoutes.js - Recommendation Engine
ai/src/services/advisorService.js - Preference Analysis
ai/src/services/preferenceService.js - Request Validation
ai/src/http/validation.js - API Responses
ai/src/http/respond.js - Conversation Context
ai/src/http/conversationStore.js - AI Service Assembly
ai/src/server.js
Mobile App
- Traveler Mobile App
GP/android/app/src/main/kotlin/com/xenon/gp/MainActivity.kt
Data & Integrations
- MongoDB
- Cloudinary
- Weather Data
ai/src/services/weatherService.js
Other components
- Traveler
- Vendor
- Administrator
Connections 34
- Traveler → Web Portal: uses
README.md - Vendor → Web Portal: uses
README.md - Administrator → Web Portal: uses
README.md - Web Portal → Role Dashboards: routes to
frontend/src/app/App.jsx - Role Dashboards → Web API Client: requests data
- Role Dashboards → Session Storage: manages session
- Web API Client → API Application: calls platform API
README.md - Traveler → Traveler Mobile App: uses
README.md - API Application → Authentication Routes: mounts
backend/src/app.js - API Application → Package & Vendor APIs: mounts
backend/src/app.js - API Application → Payment Routes: mounts
backend/src/app.js - API Application → Review Routes: mounts
backend/src/app.js - Authentication Routes → Account & OTP: dispatches
- Account & OTP → Authentication Core: delegates to
backend/src/controllers/authController.js - Account & OTP → OTP Core: delegates to
backend/src/controllers/authController.js - Authentication Routes → Access Control: protects routes
- Booking Operations → MongoDB: stores bookings
README.md - Booking Validation → Booking Operations: validates input
- Payment Routes → Payment Operations: routes payments
- Payment Operations → MongoDB: records payments
README.md - Review Routes → Review Controller: dispatches
backend/src/Routes/reviewRouter.js - Review Controller → Review Operations: delegates to
backend/src/controllers/Client/reviewController.js - Review Operations → MongoDB: manages reviews
README.md - Admin Moderation → MongoDB: moderates records
README.md - Backend AI Adapter → Recommendation Endpoint: connects to advisor
README.md - AI Service Assembly → Recommendation Engine: assembles
ai/src/server.js - AI Service Assembly → Preference Analysis: assembles
ai/src/server.js - Recommendation Endpoint → Request Validation: validates query
ai/src/http/routes/recommendationRoutes.js - Recommendation Endpoint → Recommendation Engine: requests recommendations
ai/src/http/routes/recommendationRoutes.js - Recommendation Endpoint → Conversation Context: reads and writes context
ai/src/http/routes/recommendationRoutes.js - Recommendation Endpoint → API Responses: formats response
ai/src/http/routes/recommendationRoutes.js - Preference Analysis → Weather Data: uses live conditions
README.md - Recommendation Engine → MongoDB: queries package data
README.md - Payment Operations → Cloudinary: uses file storage