# omarkhan56/musebot architecture

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

- Interactive diagram: https://gitdiagram.com/omarkhan56/musebot
- Repository: https://github.com/omarkhan56/musebot

## Overview

Museum Chatbot supports conversational and form-based museum ticket booking, payment, ticket delivery and administration. The evidenced main flow is visitor chat → booking creation → ticket and QR generation, with an email notification; a booking page also leads into payment. Admin views cover bookings and analytics, while ticket lookup/use and language selection are additional product areas. The README is empty, and some UI, payment-verification and language implementations were not sampled, so their connections are left unverified rather than inferred.

Main entry points: [`app/api/chat/route.ts`](https://github.com/omarkhan56/musebot/blob/main/app/api/chat/route.ts) (Chat Booking), [`app/api/booking/route.ts`](https://github.com/omarkhan56/musebot/blob/main/app/api/booking/route.ts) (Booking API), [`lib/models/Booking.ts`](https://github.com/omarkhan56/musebot/blob/main/lib/models/Booking.ts) (Booking Records), [`lib/mongodb.ts`](https://github.com/omarkhan56/musebot/blob/main/lib/mongodb.ts) (MongoDB Connection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_visitor["Visitor Experience"]
  node_home["Museum Home<br/>[page.tsx]"]
  node_chat_ui["Chat Assistant<br/>[ChatWidget.tsx]"]
  node_chat_page["Chat Page<br/>[page.tsx]"]
  node_booking_form["Booking Form<br/>[page.tsx]"]
  node_language["Language Selection"]
end

subgraph group_booking["Booking and Tickets"]
  node_chat_api["Chat Booking<br/>[route.ts]"]
  node_booking_api["Booking API<br/>[route.ts]"]
  node_booking_view["Booking Details<br/>[page.tsx]"]
  node_ticket_api["Ticket API<br/>[route.ts]"]
  node_ticket_view["Ticket Display<br/>[page.tsx]"]
  node_ticket_card["Ticket Card<br/>[TicketCard.tsx]"]
  node_qr["QR Generator"]
end

subgraph group_payments["Payments"]
  node_payment_button["Payment Button<br/>[PaymentButton.tsx]"]
  node_create_order["Create Payment Order<br/>[route.ts]"]
  node_verify_payment["Verify Payment<br/>[route.ts]"]
end

subgraph group_operations["Museum Operations"]
  node_admin_login["Admin Login<br/>[page.tsx]"]
  node_admin_login_api["Login API<br/>[route.ts]"]
  node_admin["Admin Dashboard<br/>[page.tsx]"]
  node_admin_bookings["Booking Administration<br/>[route.ts]"]
  node_analytics_ui["Analytics Dashboard"]
  node_analytics_api["Analytics API<br/>[route.ts]"]
end

subgraph group_shared["Data and Integrations"]
  node_booking_model[("Booking Records<br/>[Booking.ts]")]
  node_ticket_model[("Ticket Records<br/>[Ticket.ts]")]
  node_analytics_model[("Analytics Events<br/>[Analytics.ts]")]
  node_mongodb["MongoDB Connection<br/>[mongodb.ts]"]
  node_groq["Groq Chat Service<br/>[groq.ts]"]
  node_email["Ticket Email<br/>[email.ts]"]
  node_razorpay["Razorpay Client<br/>[razorpay.ts]"]
end

node_visitor(("Visitor"))

node_visitor -.->|"uses"| node_chat_ui
node_chat_page -.->|"renders"| node_chat_ui
node_chat_ui -->|"sends messages"| node_chat_api
node_chat_api -->|"requests chat"| node_groq
node_chat_api -->|"connects"| node_mongodb
node_chat_api -->|"creates booking"| node_booking_model
node_chat_api -->|"creates tickets"| node_ticket_model
node_chat_api -->|"logs event"| node_analytics_model
node_chat_api -->|"sends ticket"| node_email
node_booking_form -.->|"submits booking"| node_booking_api
node_booking_api -->|"connects"| node_mongodb
node_booking_api -->|"creates and reads"| node_booking_model
node_booking_api -->|"creates and reads"| node_ticket_model
node_booking_api -->|"logs event"| node_analytics_model
node_booking_api -->|"sends ticket"| node_email
node_chat_api -->|"returns booking ID"| node_booking_view
node_booking_view -->|"renders"| node_payment_button
node_booking_view -.->|"fetches booking"| node_booking_model
node_payment_button -.->|"requests order"| node_create_order
node_create_order -->|"connects"| node_mongodb
node_create_order -->|"reads and saves"| node_booking_model
node_create_order -->|"creates order"| node_razorpay
node_payment_button -.->|"verifies payment"| node_verify_payment
node_ticket_api -->|"connects"| node_mongodb
node_ticket_api -->|"reads and updates"| node_ticket_model
node_ticket_api -->|"reads booking"| node_booking_model
node_ticket_api -->|"logs ticket use"| node_analytics_model
node_ticket_view -.->|"loads ticket"| node_ticket_api
node_ticket_view -.->|"displays ticket"| node_ticket_card
node_admin -->|"fetches bookings"| node_admin_bookings
node_admin -->|"renders"| node_analytics_ui
node_admin_bookings -->|"connects"| node_mongodb
node_admin_bookings -->|"reads bookings"| node_booking_model
node_analytics_ui -.->|"loads metrics"| node_analytics_api
node_analytics_api -->|"connects"| node_mongodb
node_analytics_api -->|"aggregates bookings"| node_booking_model
node_admin_login -.->|"submits credentials"| node_admin_login_api

click node_home "https://github.com/omarkhan56/musebot/blob/main/app/page.tsx"
click node_chat_ui "https://github.com/omarkhan56/musebot/blob/main/components/ChatWidget.tsx"
click node_chat_page "https://github.com/omarkhan56/musebot/blob/main/app/chat/page.tsx"
click node_booking_form "https://github.com/omarkhan56/musebot/blob/main/app/booking-simple/page.tsx"
click node_language "https://github.com/omarkhan56/musebot/blob/main/components/LanguageSelector.tsx"
click node_chat_api "https://github.com/omarkhan56/musebot/blob/main/app/api/chat/route.ts"
click node_booking_api "https://github.com/omarkhan56/musebot/blob/main/app/api/booking/route.ts"
click node_booking_view "https://github.com/omarkhan56/musebot/blob/main/app/booking/%5Bid%5D/page.tsx"
click node_ticket_api "https://github.com/omarkhan56/musebot/blob/main/app/api/tickets/route.ts"
click node_ticket_view "https://github.com/omarkhan56/musebot/blob/main/app/ticket/%5Bid%5D/page.tsx"
click node_ticket_card "https://github.com/omarkhan56/musebot/blob/main/components/TicketCard.tsx"
click node_qr "https://github.com/omarkhan56/musebot/blob/main/components/QRCodeGenerator.tsx"
click node_payment_button "https://github.com/omarkhan56/musebot/blob/main/components/PaymentButton.tsx"
click node_create_order "https://github.com/omarkhan56/musebot/blob/main/app/api/payment/create-order/route.ts"
click node_verify_payment "https://github.com/omarkhan56/musebot/blob/main/app/api/payment/verify/route.ts"
click node_admin_login "https://github.com/omarkhan56/musebot/blob/main/app/admin-login/page.tsx"
click node_admin_login_api "https://github.com/omarkhan56/musebot/blob/main/app/api/admin/login/route.ts"
click node_admin "https://github.com/omarkhan56/musebot/blob/main/app/admin/page.tsx"
click node_admin_bookings "https://github.com/omarkhan56/musebot/blob/main/app/api/admin/bookings/route.ts"
click node_analytics_ui "https://github.com/omarkhan56/musebot/blob/main/components/AnalyticsDashboard.tsx"
click node_analytics_api "https://github.com/omarkhan56/musebot/blob/main/app/api/analytics/route.ts"
click node_booking_model "https://github.com/omarkhan56/musebot/blob/main/lib/models/Booking.ts"
click node_ticket_model "https://github.com/omarkhan56/musebot/blob/main/lib/models/Ticket.ts"
click node_analytics_model "https://github.com/omarkhan56/musebot/blob/main/lib/models/Analytics.ts"
click node_mongodb "https://github.com/omarkhan56/musebot/blob/main/lib/mongodb.ts"
click node_groq "https://github.com/omarkhan56/musebot/blob/main/lib/groq.ts"
click node_email "https://github.com/omarkhan56/musebot/blob/main/lib/email.ts"
click node_razorpay "https://github.com/omarkhan56/musebot/blob/main/lib/razorpay.ts"

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_home,node_chat_ui,node_chat_page,node_booking_form,node_language toneBlue
class node_chat_api,node_booking_api,node_booking_view,node_ticket_api,node_ticket_view,node_ticket_card,node_qr toneAmber
class node_payment_button,node_create_order,node_verify_payment toneMint
class node_admin_login,node_admin_login_api,node_admin,node_admin_bookings,node_analytics_ui,node_analytics_api toneRose
class node_booking_model,node_ticket_model,node_analytics_model,node_mongodb,node_groq,node_email,node_razorpay,node_visitor toneIndigo
```

## Components

### Visitor Experience

- [Museum Home](https://github.com/omarkhan56/musebot/blob/main/app/page.tsx): `app/page.tsx`
- [Chat Assistant](https://github.com/omarkhan56/musebot/blob/main/components/ChatWidget.tsx): `components/ChatWidget.tsx`
- [Chat Page](https://github.com/omarkhan56/musebot/blob/main/app/chat/page.tsx): `app/chat/page.tsx`
- [Booking Form](https://github.com/omarkhan56/musebot/blob/main/app/booking-simple/page.tsx): `app/booking-simple/page.tsx`
- [Language Selection](https://github.com/omarkhan56/musebot/blob/main/components/LanguageSelector.tsx): `components/LanguageSelector.tsx`

### Booking and Tickets

- [Chat Booking](https://github.com/omarkhan56/musebot/blob/main/app/api/chat/route.ts): `app/api/chat/route.ts`
- [Booking API](https://github.com/omarkhan56/musebot/blob/main/app/api/booking/route.ts): `app/api/booking/route.ts`
- [Booking Details](https://github.com/omarkhan56/musebot/blob/main/app/booking/%5Bid%5D/page.tsx): `app/booking/[id]/page.tsx`
- [Ticket API](https://github.com/omarkhan56/musebot/blob/main/app/api/tickets/route.ts): `app/api/tickets/route.ts`
- [Ticket Display](https://github.com/omarkhan56/musebot/blob/main/app/ticket/%5Bid%5D/page.tsx): `app/ticket/[id]/page.tsx`
- [Ticket Card](https://github.com/omarkhan56/musebot/blob/main/components/TicketCard.tsx): `components/TicketCard.tsx`
- [QR Generator](https://github.com/omarkhan56/musebot/blob/main/components/QRCodeGenerator.tsx): `components/QRCodeGenerator.tsx`

### Payments

- [Payment Button](https://github.com/omarkhan56/musebot/blob/main/components/PaymentButton.tsx): `components/PaymentButton.tsx`
- [Create Payment Order](https://github.com/omarkhan56/musebot/blob/main/app/api/payment/create-order/route.ts): `app/api/payment/create-order/route.ts`
- [Verify Payment](https://github.com/omarkhan56/musebot/blob/main/app/api/payment/verify/route.ts): `app/api/payment/verify/route.ts`

### Museum Operations

- [Admin Login](https://github.com/omarkhan56/musebot/blob/main/app/admin-login/page.tsx): `app/admin-login/page.tsx`
- [Login API](https://github.com/omarkhan56/musebot/blob/main/app/api/admin/login/route.ts): `app/api/admin/login/route.ts`
- [Admin Dashboard](https://github.com/omarkhan56/musebot/blob/main/app/admin/page.tsx): `app/admin/page.tsx`
- [Booking Administration](https://github.com/omarkhan56/musebot/blob/main/app/api/admin/bookings/route.ts): `app/api/admin/bookings/route.ts`
- [Analytics Dashboard](https://github.com/omarkhan56/musebot/blob/main/components/AnalyticsDashboard.tsx): `components/AnalyticsDashboard.tsx`
- [Analytics API](https://github.com/omarkhan56/musebot/blob/main/app/api/analytics/route.ts): `app/api/analytics/route.ts`

### Data and Integrations

- [Booking Records](https://github.com/omarkhan56/musebot/blob/main/lib/models/Booking.ts): `lib/models/Booking.ts`
- [Ticket Records](https://github.com/omarkhan56/musebot/blob/main/lib/models/Ticket.ts): `lib/models/Ticket.ts`
- [Analytics Events](https://github.com/omarkhan56/musebot/blob/main/lib/models/Analytics.ts): `lib/models/Analytics.ts`
- [MongoDB Connection](https://github.com/omarkhan56/musebot/blob/main/lib/mongodb.ts): `lib/mongodb.ts`
- [Groq Chat Service](https://github.com/omarkhan56/musebot/blob/main/lib/groq.ts): `lib/groq.ts`
- [Ticket Email](https://github.com/omarkhan56/musebot/blob/main/lib/email.ts): `lib/email.ts`
- [Razorpay Client](https://github.com/omarkhan56/musebot/blob/main/lib/razorpay.ts): `lib/razorpay.ts`

### Other components

- **Visitor**

## Connections

- Visitor → Chat Assistant: uses
- Chat Page → Chat Assistant: renders (evidence: `app/chat/page.tsx`)
- Chat Assistant → Chat Booking: sends messages (evidence: `components/ChatWidget.tsx`)
- Chat Booking → Groq Chat Service: requests chat (evidence: `app/api/chat/route.ts`)
- Chat Booking → MongoDB Connection: connects (evidence: `app/api/chat/route.ts`)
- Chat Booking → Booking Records: creates booking (evidence: `app/api/chat/route.ts`)
- Chat Booking → Ticket Records: creates tickets (evidence: `app/api/chat/route.ts`)
- Chat Booking → Analytics Events: logs event (evidence: `app/api/chat/route.ts`)
- Chat Booking → Ticket Email: sends ticket (evidence: `app/api/chat/route.ts`)
- Booking Form → Booking API: submits booking
- Booking API → MongoDB Connection: connects (evidence: `app/api/booking/route.ts`)
- Booking API → Booking Records: creates and reads (evidence: `app/api/booking/route.ts`)
- Booking API → Ticket Records: creates and reads (evidence: `app/api/booking/route.ts`)
- Booking API → Analytics Events: logs event (evidence: `app/api/booking/route.ts`)
- Booking API → Ticket Email: sends ticket (evidence: `app/api/booking/route.ts`)
- Chat Booking → Booking Details: returns booking ID (evidence: `app/api/chat/route.ts`)
- Booking Details → Payment Button: renders (evidence: `app/booking/[id]/page.tsx`)
- Booking Details → Booking Records: fetches booking
- Payment Button → Create Payment Order: requests order
- Create Payment Order → MongoDB Connection: connects (evidence: `app/api/payment/create-order/route.ts`)
- Create Payment Order → Booking Records: reads and saves (evidence: `app/api/payment/create-order/route.ts`)
- Create Payment Order → Razorpay Client: creates order (evidence: `app/api/payment/create-order/route.ts`)
- Payment Button → Verify Payment: verifies payment
- Ticket API → MongoDB Connection: connects (evidence: `app/api/tickets/route.ts`)
- Ticket API → Ticket Records: reads and updates (evidence: `app/api/tickets/route.ts`)
- Ticket API → Booking Records: reads booking (evidence: `app/api/tickets/route.ts`)
- Ticket API → Analytics Events: logs ticket use (evidence: `app/api/tickets/route.ts`)
- Ticket Display → Ticket API: loads ticket
- Ticket Display → Ticket Card: displays ticket
- Admin Dashboard → Booking Administration: fetches bookings (evidence: `app/admin/page.tsx`)
- Admin Dashboard → Analytics Dashboard: renders (evidence: `app/admin/page.tsx`)
- Booking Administration → MongoDB Connection: connects (evidence: `app/api/admin/bookings/route.ts`)
- Booking Administration → Booking Records: reads bookings (evidence: `app/api/admin/bookings/route.ts`)
- Analytics Dashboard → Analytics API: loads metrics
- Analytics API → MongoDB Connection: connects (evidence: `app/api/analytics/route.ts`)
- Analytics API → Booking Records: aggregates bookings (evidence: `app/api/analytics/route.ts`)
- Admin Login → Login API: submits credentials
