# mustafaal-kayyali/xenon architecture

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

- Interactive diagram: https://gitdiagram.com/mustafaal-kayyali/xenon
- Repository: https://github.com/mustafaal-kayyali/xenon

## Overview

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: [`backend/src/app.js`](https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/app.js) (API Application), [`ai/src/http/routes/recommendationRoutes.js`](https://github.com/mustafaal-kayyali/xenon/blob/main/ai/src/http/routes/recommendationRoutes.js) (Recommendation Endpoint), [`frontend/src/app/App.jsx`](https://github.com/mustafaal-kayyali/xenon/blob/main/frontend/src/app/App.jsx) (Web Portal), [`frontend/src/pages`](https://github.com/mustafaal-kayyali/xenon/tree/main/frontend/src/pages) (Role Dashboards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web Portal"]
  node_webapp["Web Portal<br/>[App.jsx]"]
  node_webui["Role Dashboards"]
  node_webapi["Web API Client<br/>[api.js]"]
  node_websession["Session Storage<br/>[storage.js]"]
end

subgraph group_backend["Platform Backend"]
  node_backendapp["API Application<br/>[app.js]"]
  node_authroutes["Authentication Routes<br/>[authRoutes.js]"]
  node_authcontroller["Account &amp; OTP<br/>[authController.js]"]
  node_authcore["Authentication Core<br/>[authCore.js]"]
  node_otpcore["OTP Core<br/>[otpCore.js]"]
  node_authmiddleware["Access Control<br/>[authMiddleware.js]"]
  node_booking["Booking Operations<br/>[bookingCore.js]"]
  node_bookingvalidation["Booking Validation"]
  node_payments["Payment Operations<br/>[paymentCore.js]"]
  node_paymentroutes["Payment Routes<br/>[PaymentRouter.js]"]
  node_reviewroutes["Review Routes<br/>[reviewRouter.js]"]
  node_reviewcontroller["Review Controller"]
  node_reviewcore["Review Operations<br/>[reviewCore.js]"]
  node_moderation["Admin Moderation<br/>[moderationCore.js]"]
  node_packages["Package &amp; Vendor APIs<br/>[packageRoutes.js]"]
  node_backendai["Backend AI Adapter<br/>[aiService.js]"]
end

subgraph group_ai["AI Advisor"]
  node_advisorroutes["Recommendation Endpoint"]
  node_advisor["Recommendation Engine<br/>[advisorService.js]"]
  node_preferences["Preference Analysis"]
  node_aivalidation["Request Validation<br/>[validation.js]"]
  node_airesponses["API Responses<br/>[respond.js]"]
  node_conversation["Conversation Context"]
  node_aiserver["AI Service Assembly<br/>[server.js]"]
end

subgraph group_mobile["Mobile App"]
  node_mobileapp["Traveler Mobile App<br/>[MainActivity.kt]"]
end

subgraph group_services["Data &amp; Integrations"]
  node_mongodb[("MongoDB")]
  node_cloudinary["Cloudinary"]
  node_weather["Weather Data<br/>[weatherService.js]"]
end

node_traveler(("Traveler"))
node_vendor(("Vendor"))
node_admin(("Administrator"))

node_traveler -->|"uses"| node_webapp
node_vendor -->|"uses"| node_webapp
node_admin -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_webui
node_webui -->|"requests data"| node_webapi
node_webui -->|"manages session"| node_websession
node_webapi -->|"calls platform API"| node_backendapp
node_traveler -->|"uses"| node_mobileapp
node_backendapp -->|"mounts"| node_authroutes
node_backendapp -->|"mounts"| node_packages
node_backendapp -->|"mounts"| node_paymentroutes
node_backendapp -->|"mounts"| node_reviewroutes
node_authroutes -->|"dispatches"| node_authcontroller
node_authcontroller -->|"delegates to"| node_authcore
node_authcontroller -->|"delegates to"| node_otpcore
node_authroutes -->|"protects routes"| node_authmiddleware
node_booking -->|"stores bookings"| node_mongodb
node_bookingvalidation -->|"validates input"| node_booking
node_paymentroutes -->|"routes payments"| node_payments
node_payments -->|"records payments"| node_mongodb
node_reviewroutes -->|"dispatches"| node_reviewcontroller
node_reviewcontroller -->|"delegates to"| node_reviewcore
node_reviewcore -->|"manages reviews"| node_mongodb
node_moderation -->|"moderates records"| node_mongodb
node_backendai -.->|"connects to advisor"| node_advisorroutes
node_aiserver -->|"assembles"| node_advisor
node_aiserver -->|"assembles"| node_preferences
node_advisorroutes -->|"validates query"| node_aivalidation
node_advisorroutes -->|"requests recommendations"| node_advisor
node_advisorroutes -->|"reads and writes context"| node_conversation
node_advisorroutes -->|"formats response"| node_airesponses
node_preferences -->|"uses live conditions"| node_weather
node_advisor -->|"queries package data"| node_mongodb
node_payments -.->|"uses file storage"| node_cloudinary

click node_webapp "https://github.com/mustafaal-kayyali/xenon/blob/main/frontend/src/app/App.jsx"
click node_webui "https://github.com/mustafaal-kayyali/xenon/tree/main/frontend/src/pages"
click node_webapi "https://github.com/mustafaal-kayyali/xenon/blob/main/frontend/src/services/api.js"
click node_websession "https://github.com/mustafaal-kayyali/xenon/blob/main/frontend/src/services/storage.js"
click node_mobileapp "https://github.com/mustafaal-kayyali/xenon/blob/main/GP/android/app/src/main/kotlin/com/xenon/gp/MainActivity.kt"
click node_backendapp "https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/app.js"
click node_authroutes "https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/Routes/authRoutes.js"
click node_authcontroller "https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/controllers/authController.js"
click node_authcore "https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/services/Core/authCore.js"
click node_otpcore "https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/services/Core/otpCore.js"
click node_authmiddleware "https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/middlewares/authMiddleware.js"
click node_booking "https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/services/Core/bookingCore.js"
click node_bookingvalidation "https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/validations/bookingValidation.js"
click node_payments "https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/services/Core/paymentCore.js"
click node_paymentroutes "https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/Routes/PaymentRouter.js"
click node_reviewroutes "https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/Routes/reviewRouter.js"
click node_reviewcontroller "https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/controllers/Client/reviewController.js"
click node_reviewcore "https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/services/Core/Client/reviewCore.js"
click node_moderation "https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/services/Core/Admin/moderationCore.js"
click node_packages "https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/Routes/packageRoutes.js"
click node_backendai "https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/services/Integration/aiService.js"
click node_advisorroutes "https://github.com/mustafaal-kayyali/xenon/blob/main/ai/src/http/routes/recommendationRoutes.js"
click node_advisor "https://github.com/mustafaal-kayyali/xenon/blob/main/ai/src/services/advisorService.js"
click node_preferences "https://github.com/mustafaal-kayyali/xenon/blob/main/ai/src/services/preferenceService.js"
click node_aivalidation "https://github.com/mustafaal-kayyali/xenon/blob/main/ai/src/http/validation.js"
click node_airesponses "https://github.com/mustafaal-kayyali/xenon/blob/main/ai/src/http/respond.js"
click node_conversation "https://github.com/mustafaal-kayyali/xenon/blob/main/ai/src/http/conversationStore.js"
click node_aiserver "https://github.com/mustafaal-kayyali/xenon/blob/main/ai/src/server.js"
click node_weather "https://github.com/mustafaal-kayyali/xenon/blob/main/ai/src/services/weatherService.js"

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_webui,node_webapi,node_websession toneBlue
class node_backendapp,node_authroutes,node_authcontroller,node_authcore,node_otpcore,node_authmiddleware,node_booking,node_bookingvalidation,node_payments,node_paymentroutes,node_reviewroutes,node_reviewcontroller,node_reviewcore,node_moderation,node_packages,node_backendai toneAmber
class node_advisorroutes,node_advisor,node_preferences,node_aivalidation,node_airesponses,node_conversation,node_aiserver toneMint
class node_mobileapp toneRose
class node_mongodb,node_cloudinary,node_weather,node_traveler,node_vendor,node_admin toneIndigo
```

## Components

### Web Portal

- [Web Portal](https://github.com/mustafaal-kayyali/xenon/blob/main/frontend/src/app/App.jsx): `frontend/src/app/App.jsx`
- [Role Dashboards](https://github.com/mustafaal-kayyali/xenon/tree/main/frontend/src/pages): `frontend/src/pages`
- [Web API Client](https://github.com/mustafaal-kayyali/xenon/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Session Storage](https://github.com/mustafaal-kayyali/xenon/blob/main/frontend/src/services/storage.js): `frontend/src/services/storage.js`

### Platform Backend

- [API Application](https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/app.js): `backend/src/app.js`
- [Authentication Routes](https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/Routes/authRoutes.js): `backend/src/Routes/authRoutes.js`
- [Account & OTP](https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/controllers/authController.js): `backend/src/controllers/authController.js`
- [Authentication Core](https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/services/Core/authCore.js): `backend/src/services/Core/authCore.js`
- [OTP Core](https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/services/Core/otpCore.js): `backend/src/services/Core/otpCore.js`
- [Access Control](https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/middlewares/authMiddleware.js): `backend/src/middlewares/authMiddleware.js`
- [Booking Operations](https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/services/Core/bookingCore.js): `backend/src/services/Core/bookingCore.js`
- [Booking Validation](https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/validations/bookingValidation.js): `backend/src/validations/bookingValidation.js`
- [Payment Operations](https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/services/Core/paymentCore.js): `backend/src/services/Core/paymentCore.js`
- [Payment Routes](https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/Routes/PaymentRouter.js): `backend/src/Routes/PaymentRouter.js`
- [Review Routes](https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/Routes/reviewRouter.js): `backend/src/Routes/reviewRouter.js`
- [Review Controller](https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/controllers/Client/reviewController.js): `backend/src/controllers/Client/reviewController.js`
- [Review Operations](https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/services/Core/Client/reviewCore.js): `backend/src/services/Core/Client/reviewCore.js`
- [Admin Moderation](https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/services/Core/Admin/moderationCore.js): `backend/src/services/Core/Admin/moderationCore.js`
- [Package & Vendor APIs](https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/Routes/packageRoutes.js): `backend/src/Routes/packageRoutes.js`
- [Backend AI Adapter](https://github.com/mustafaal-kayyali/xenon/blob/main/backend/src/services/Integration/aiService.js): `backend/src/services/Integration/aiService.js`

### AI Advisor

- [Recommendation Endpoint](https://github.com/mustafaal-kayyali/xenon/blob/main/ai/src/http/routes/recommendationRoutes.js): `ai/src/http/routes/recommendationRoutes.js`
- [Recommendation Engine](https://github.com/mustafaal-kayyali/xenon/blob/main/ai/src/services/advisorService.js): `ai/src/services/advisorService.js`
- [Preference Analysis](https://github.com/mustafaal-kayyali/xenon/blob/main/ai/src/services/preferenceService.js): `ai/src/services/preferenceService.js`
- [Request Validation](https://github.com/mustafaal-kayyali/xenon/blob/main/ai/src/http/validation.js): `ai/src/http/validation.js`
- [API Responses](https://github.com/mustafaal-kayyali/xenon/blob/main/ai/src/http/respond.js): `ai/src/http/respond.js`
- [Conversation Context](https://github.com/mustafaal-kayyali/xenon/blob/main/ai/src/http/conversationStore.js): `ai/src/http/conversationStore.js`
- [AI Service Assembly](https://github.com/mustafaal-kayyali/xenon/blob/main/ai/src/server.js): `ai/src/server.js`

### Mobile App

- [Traveler Mobile App](https://github.com/mustafaal-kayyali/xenon/blob/main/GP/android/app/src/main/kotlin/com/xenon/gp/MainActivity.kt): `GP/android/app/src/main/kotlin/com/xenon/gp/MainActivity.kt`

### Data & Integrations

- **MongoDB**
- **Cloudinary**
- [Weather Data](https://github.com/mustafaal-kayyali/xenon/blob/main/ai/src/services/weatherService.js): `ai/src/services/weatherService.js`

### Other components

- **Traveler**
- **Vendor**
- **Administrator**

## Connections

- Traveler → Web Portal: uses (evidence: `README.md`)
- Vendor → Web Portal: uses (evidence: `README.md`)
- Administrator → Web Portal: uses (evidence: `README.md`)
- Web Portal → Role Dashboards: routes to (evidence: `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 (evidence: `README.md`)
- Traveler → Traveler Mobile App: uses (evidence: `README.md`)
- API Application → Authentication Routes: mounts (evidence: `backend/src/app.js`)
- API Application → Package & Vendor APIs: mounts (evidence: `backend/src/app.js`)
- API Application → Payment Routes: mounts (evidence: `backend/src/app.js`)
- API Application → Review Routes: mounts (evidence: `backend/src/app.js`)
- Authentication Routes → Account & OTP: dispatches
- Account & OTP → Authentication Core: delegates to (evidence: `backend/src/controllers/authController.js`)
- Account & OTP → OTP Core: delegates to (evidence: `backend/src/controllers/authController.js`)
- Authentication Routes → Access Control: protects routes
- Booking Operations → MongoDB: stores bookings (evidence: `README.md`)
- Booking Validation → Booking Operations: validates input
- Payment Routes → Payment Operations: routes payments
- Payment Operations → MongoDB: records payments (evidence: `README.md`)
- Review Routes → Review Controller: dispatches (evidence: `backend/src/Routes/reviewRouter.js`)
- Review Controller → Review Operations: delegates to (evidence: `backend/src/controllers/Client/reviewController.js`)
- Review Operations → MongoDB: manages reviews (evidence: `README.md`)
- Admin Moderation → MongoDB: moderates records (evidence: `README.md`)
- Backend AI Adapter → Recommendation Endpoint: connects to advisor (evidence: `README.md`)
- AI Service Assembly → Recommendation Engine: assembles (evidence: `ai/src/server.js`)
- AI Service Assembly → Preference Analysis: assembles (evidence: `ai/src/server.js`)
- Recommendation Endpoint → Request Validation: validates query (evidence: `ai/src/http/routes/recommendationRoutes.js`)
- Recommendation Endpoint → Recommendation Engine: requests recommendations (evidence: `ai/src/http/routes/recommendationRoutes.js`)
- Recommendation Endpoint → Conversation Context: reads and writes context (evidence: `ai/src/http/routes/recommendationRoutes.js`)
- Recommendation Endpoint → API Responses: formats response (evidence: `ai/src/http/routes/recommendationRoutes.js`)
- Preference Analysis → Weather Data: uses live conditions (evidence: `README.md`)
- Recommendation Engine → MongoDB: queries package data (evidence: `README.md`)
- Payment Operations → Cloudinary: uses file storage
