# manikanta000001/yogastories architecture

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

- Interactive diagram: https://gitdiagram.com/manikanta000001/yogastories
- Repository: https://github.com/manikanta000001/yogastories

## Overview

YogaPT combines a public yoga discovery and booking site with backend APIs and trainer-facing administration. The principal flow is practice selection, future-date/session availability, client details, booking submission, and payment handling; bookings update client/session records and trigger notifications. Administrative capabilities include class and session management, booking/client oversight, dashboard analytics, and announcements. The README documents the public booking stages and class/session experience; source excerpts and the SOURCE INDEX expose only selected implementation wiring, so uncertain links are omitted or marked dashed.

Main entry points: [`Backend/src/routes`](https://github.com/manikanta000001/yogastories/tree/main/Backend/src/routes) (API routes), [`Backend/src/controllers/bookingController.js`](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/bookingController.js) (Booking operations), [`Backend/src/controllers/classController.js`](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/classController.js) (Class operations), [`Backend/src/controllers/sessionController.js`](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/sessionController.js) (Session operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public experience"]
  node_site["Public website<br/>[App.jsx]"]
  node_practice["Practice discovery"]
  node_booking_ui["Booking flow<br/>[BookingModal.jsx]"]
  node_api["Frontend API client<br/>[api.js]"]
end

subgraph group_booking["Booking and records"]
  node_server["Backend API server<br/>[server.js]"]
  node_routes["API routes"]
  node_booking_logic["Booking operations"]
  node_class_logic["Class operations<br/>[classController.js]"]
  node_session_logic["Session operations"]
  node_booking_store[("Booking records<br/>[Booking.js]")]
  node_class_store[("Class records<br/>[Class.js]")]
  node_session_store[("Session records<br/>[Session.js]")]
  node_client_store[("Client records<br/>[Client.js]")]
end

subgraph group_admin["Trainer administration"]
  node_admin_ui["Admin pages"]
  node_admin_layout["Admin layout<br/>[AdminLayout.jsx]"]
  node_dashboard["Dashboard analytics"]
  node_client_logic["Client management"]
  node_announcement_logic["Announcements"]
end

subgraph group_payments["Payments"]
  node_payu["PayU handling<br/>[payuController.js]"]
  node_cashfree["Cashfree handling"]
end

subgraph group_notify["Notifications"]
  node_notifications["Booking notifications"]
  node_email["Email delivery<br/>[emailService.js]"]
  node_whatsapp["WhatsApp delivery<br/>[whatsappService.js]"]
end

node_student(("Student"))
node_payment_provider["Payment provider"]

node_student -->|"explores"| node_site
node_site -->|"renders"| node_practice
node_practice -->|"opens booking"| node_booking_ui
node_booking_ui -->|"requests data"| node_api
node_api -.->|"calls API"| node_server
node_server -->|"mounts routes"| node_routes
node_routes -->|"routes requests"| node_booking_logic
node_routes -->|"routes requests"| node_class_logic
node_routes -->|"routes requests"| node_session_logic
node_routes -->|"routes requests"| node_client_logic
node_routes -->|"routes requests"| node_dashboard
node_routes -->|"routes requests"| node_announcement_logic
node_booking_logic -->|"reads and writes"| node_booking_store
node_booking_logic -->|"reads and writes"| node_client_store
node_booking_logic -->|"reads and updates"| node_session_store
node_booking_logic -->|"reads"| node_class_store
node_class_logic -->|"manages"| node_class_store
node_class_logic -->|"uses"| node_session_store
node_class_logic -->|"checks bookings"| node_booking_store
node_session_logic -->|"manages"| node_session_store
node_session_logic -->|"uses"| node_class_store
node_session_logic -->|"checks bookings"| node_booking_store
node_admin_ui -->|"uses layout"| node_admin_layout
node_admin_ui -->|"requests admin data"| node_api
node_admin_ui -->|"manages sessions"| node_api
node_client_logic -->|"reads and updates"| node_client_store
node_client_logic -->|"reads"| node_booking_store
node_client_logic -->|"reads"| node_session_store
node_booking_logic -->|"notifies"| node_notifications
node_notifications -->|"sends email"| node_email
node_notifications -->|"sends WhatsApp"| node_whatsapp
node_booking_ui -.->|"starts payment"| node_payu
node_payu -.->|"submits payment"| node_payment_provider
node_cashfree -.->|"handles payment"| node_payment_provider
node_routes -->|"routes callbacks"| node_payu
node_routes -->|"routes callbacks"| node_cashfree

click node_site "https://github.com/manikanta000001/yogastories/blob/main/Frontend/src/App.jsx"
click node_practice "https://github.com/manikanta000001/yogastories/tree/main/Frontend/src/components/practice"
click node_booking_ui "https://github.com/manikanta000001/yogastories/blob/main/Frontend/src/components/modals/BookingModal.jsx"
click node_api "https://github.com/manikanta000001/yogastories/blob/main/Frontend/src/services/api.js"
click node_server "https://github.com/manikanta000001/yogastories/blob/main/Backend/src/server.js"
click node_routes "https://github.com/manikanta000001/yogastories/tree/main/Backend/src/routes"
click node_booking_logic "https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/bookingController.js"
click node_class_logic "https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/classController.js"
click node_session_logic "https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/sessionController.js"
click node_booking_store "https://github.com/manikanta000001/yogastories/blob/main/Backend/src/models/Booking.js"
click node_class_store "https://github.com/manikanta000001/yogastories/blob/main/Backend/src/models/Class.js"
click node_session_store "https://github.com/manikanta000001/yogastories/blob/main/Backend/src/models/Session.js"
click node_client_store "https://github.com/manikanta000001/yogastories/blob/main/Backend/src/models/Client.js"
click node_admin_ui "https://github.com/manikanta000001/yogastories/tree/main/Frontend/src/pages/admin"
click node_admin_layout "https://github.com/manikanta000001/yogastories/blob/main/Frontend/src/components/admin/layout/AdminLayout.jsx"
click node_dashboard "https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/dashboardController.js"
click node_client_logic "https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/clientController.js"
click node_announcement_logic "https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/announcementController.js"
click node_payu "https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/payuController.js"
click node_cashfree "https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/cashfreeController.js"
click node_notifications "https://github.com/manikanta000001/yogastories/blob/main/Backend/src/services/notificationService.js"
click node_email "https://github.com/manikanta000001/yogastories/blob/main/Backend/src/services/emailService.js"
click node_whatsapp "https://github.com/manikanta000001/yogastories/blob/main/Backend/src/services/whatsappService.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_site,node_practice,node_booking_ui,node_api toneBlue
class node_server,node_routes,node_booking_logic,node_class_logic,node_session_logic,node_booking_store,node_class_store,node_session_store,node_client_store toneAmber
class node_admin_ui,node_admin_layout,node_dashboard,node_client_logic,node_announcement_logic toneMint
class node_payu,node_cashfree toneRose
class node_notifications,node_email,node_whatsapp,node_student,node_payment_provider toneIndigo
```

## Components

### Public experience

- [Public website](https://github.com/manikanta000001/yogastories/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Practice discovery](https://github.com/manikanta000001/yogastories/tree/main/Frontend/src/components/practice): `Frontend/src/components/practice`
- [Booking flow](https://github.com/manikanta000001/yogastories/blob/main/Frontend/src/components/modals/BookingModal.jsx): `Frontend/src/components/modals/BookingModal.jsx`
- [Frontend API client](https://github.com/manikanta000001/yogastories/blob/main/Frontend/src/services/api.js): `Frontend/src/services/api.js`

### Booking and records

- [Backend API server](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/server.js): `Backend/src/server.js`
- [API routes](https://github.com/manikanta000001/yogastories/tree/main/Backend/src/routes): `Backend/src/routes`
- [Booking operations](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/bookingController.js): `Backend/src/controllers/bookingController.js`
- [Class operations](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/classController.js): `Backend/src/controllers/classController.js`
- [Session operations](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/sessionController.js): `Backend/src/controllers/sessionController.js`
- [Booking records](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/models/Booking.js): `Backend/src/models/Booking.js`
- [Class records](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/models/Class.js): `Backend/src/models/Class.js`
- [Session records](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/models/Session.js): `Backend/src/models/Session.js`
- [Client records](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/models/Client.js): `Backend/src/models/Client.js`

### Trainer administration

- [Admin pages](https://github.com/manikanta000001/yogastories/tree/main/Frontend/src/pages/admin): `Frontend/src/pages/admin`
- [Admin layout](https://github.com/manikanta000001/yogastories/blob/main/Frontend/src/components/admin/layout/AdminLayout.jsx): `Frontend/src/components/admin/layout/AdminLayout.jsx`
- [Dashboard analytics](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/dashboardController.js): `Backend/src/controllers/dashboardController.js`
- [Client management](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/clientController.js): `Backend/src/controllers/clientController.js`
- [Announcements](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/announcementController.js): `Backend/src/controllers/announcementController.js`

### Payments

- [PayU handling](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/payuController.js): `Backend/src/controllers/payuController.js`
- [Cashfree handling](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/controllers/cashfreeController.js): `Backend/src/controllers/cashfreeController.js`

### Notifications

- [Booking notifications](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/services/notificationService.js): `Backend/src/services/notificationService.js`
- [Email delivery](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/services/emailService.js): `Backend/src/services/emailService.js`
- [WhatsApp delivery](https://github.com/manikanta000001/yogastories/blob/main/Backend/src/services/whatsappService.js): `Backend/src/services/whatsappService.js`

### Other components

- **Student**
- **Payment provider**

## Connections

- Student → Public website: explores (evidence: `README.md`)
- Public website → Practice discovery: renders (evidence: `Frontend/src/App.jsx`)
- Practice discovery → Booking flow: opens booking (evidence: `Frontend/src/App.jsx`)
- Booking flow → Frontend API client: requests data (evidence: `Frontend/src/components/modals/BookingModal.jsx`)
- Frontend API client → Backend API server: calls API
- Backend API server → API routes: mounts routes (evidence: `Backend/src/server.js`)
- API routes → Booking operations: routes requests (evidence: `Backend/src/routes/bookingRoutes.js`)
- API routes → Class operations: routes requests (evidence: `Backend/src/routes/classRoutes.js`)
- API routes → Session operations: routes requests (evidence: `Backend/src/routes/sessionRoutes.js`)
- API routes → Client management: routes requests (evidence: `Backend/src/routes/clientRoutes.js`)
- API routes → Dashboard analytics: routes requests (evidence: `Backend/src/routes/dashboardRoutes.js`)
- API routes → Announcements: routes requests (evidence: `Backend/src/routes/announcementRoutes.js`)
- Booking operations → Booking records: reads and writes (evidence: `Backend/src/controllers/bookingController.js`)
- Booking operations → Client records: reads and writes (evidence: `Backend/src/controllers/bookingController.js`)
- Booking operations → Session records: reads and updates (evidence: `Backend/src/controllers/bookingController.js`)
- Booking operations → Class records: reads (evidence: `Backend/src/controllers/bookingController.js`)
- Class operations → Class records: manages (evidence: `Backend/src/controllers/classController.js`)
- Class operations → Session records: uses (evidence: `Backend/src/controllers/classController.js`)
- Class operations → Booking records: checks bookings (evidence: `Backend/src/controllers/classController.js`)
- Session operations → Session records: manages (evidence: `Backend/src/controllers/sessionController.js`)
- Session operations → Class records: uses (evidence: `Backend/src/controllers/sessionController.js`)
- Session operations → Booking records: checks bookings (evidence: `Backend/src/controllers/sessionController.js`)
- Admin pages → Admin layout: uses layout (evidence: `Frontend/src/pages/admin/Clients.jsx`)
- Admin pages → Frontend API client: requests admin data (evidence: `Frontend/src/pages/admin/Clients.jsx`)
- Admin pages → Frontend API client: manages sessions (evidence: `Frontend/src/pages/admin/Sessions.jsx`)
- Client management → Client records: reads and updates (evidence: `Backend/src/controllers/clientController.js`)
- Client management → Booking records: reads (evidence: `Backend/src/controllers/clientController.js`)
- Client management → Session records: reads (evidence: `Backend/src/controllers/clientController.js`)
- Booking operations → Booking notifications: notifies (evidence: `Backend/src/controllers/bookingController.js`)
- Booking notifications → Email delivery: sends email (evidence: `Backend/src/services/notificationService.js`)
- Booking notifications → WhatsApp delivery: sends WhatsApp (evidence: `Backend/src/services/notificationService.js`)
- Booking flow → PayU handling: starts payment
- PayU handling → Payment provider: submits payment
- Cashfree handling → Payment provider: handles payment
- API routes → PayU handling: routes callbacks (evidence: `Backend/src/routes/payuRoutes.js`)
- API routes → Cashfree handling: routes callbacks (evidence: `Backend/src/routes/cashfreeRoutes.js`)
