# sreearpita/makemybooking architecture

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

- Interactive diagram: https://gitdiagram.com/sreearpita/makemybooking
- Repository: https://github.com/sreearpita/makemybooking

## Overview

##### Project Type and Purpose
- BmsReplica is a full-stack booking management web application.
- Frontend: an Angular (v19.1.7) Single-Page Application with optional SSR (Angular Universal + Vite).
- Backend: Node.js/Express REST API with models for users, events, bookings and supporting scripts for DB migration, seeding, and data fixes.

##### File Structure Analysis
- Top-level:
- angular.json, tsconfig*.json – Angular build and TS config
- src/ – Angular source: components, services, routes, guards, interceptors, app module, server entrypoints
- public/ – static assets (favicon, robots.txt, etc.)
- backend/ – Express API: server.js, routes/, models/, middleware/, scripts/, .env
- Key patterns:
- src/app – feature modules (admin, booking, events, tickets, auth flows)
- src/main.ts & main.server.ts + src/server.ts – Angular Universal setup for SSR
- backend/models – Mongoose-style models (booking.model.js, event.model.js, user.model.js)
- backend/routes – REST endpoints: /auth, /bookings, /events
- backend/middleware/auth.js – JWT or session-based auth guard on Express
- backend/scripts – CLI utilities for DB migration, seeding, data corrections

##### README Insights
- Generated with Angular CLI
- Standard Angular dev/build/test workflow: ng serve, ng build, ng test, ng e2e

##### Diagramming the System Architecture
a. Main Components
1. Browser/Client (User’s web browser)
2. Angular Frontend
– Components & modules
– Services (auth.service, event.service, tickets.service, admin.service)
– Guards & interceptors (auth.guard, admin.guard, auth.interceptor)
– SSR layer (main.server.ts, server.ts)
3. Express API Server (backend/server.js)
– Middleware (auth.js)
– Route handlers (auth.js, bookings.js, events.js)
– Data-access via models (booking.model.js, event.model.js, user.model.js)
– Scripts for DB operations
4. Database
– Likely MongoDB (driven by .env credentials & Mongoose models)
5. Dev/Build Tools & Environments
– Angular CLI, Vite caching, Node package scripts, environment.ts/.env

b. Relationships & Interactions
- User → HTTP/HTTPS → Angular Universal SSR server (render initial HTML)
- User → static assets served (JS/CSS) → Angular SPA runtime
- Angular Services → HTTP calls → Express API endpoints
- Express routes → middleware auth → model layer → Database
- Backend scripts → direct DB connection → migration/seed/fix operations

c. Architectural Patterns & Design Principles
- Separation of concerns: Frontend UI vs Backend API
- Layered architecture: UI → Services → HTTP layer → Controllers → Models → DB
- Stateless RESTful API with JWT/session auth implemented in middleware
- Angular Universal for server-side pre-rendering improves SEO & performance
- Code scaffolding & feature modules for maintainability

d. Key Technologies & Frameworks
- Angular, Angular Universal, Vite (SSR build cache)
- Angular Material (UI components)
- Angular Router, Guards, Interceptors
- Node.js, Express.js
- Mongoose (implied), MongoDB (env var driven)
- Environment configs (.env, environment.ts)
- Build/test tools: Angular CLI, Karma

##### Essential Elements to Capture
- Initial request flow: Client → SSR server → Client receives HTML+assets
- SPA runtime: Client → API (middleware → controllers → models → DB)
- Auth handshake: login API → JWT cookie/header → interceptor attaches token
- Admin flow: auth.guard → admin.guard → admin-dashboard routes/services
- Lifecycle of a booking: UI booking-dialog → event-service → /api/bookings → booking.model → DB

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client
    Client["Browser (User)"]:::external

    %% Frontend Layer
    subgraph "Frontend Layer" 
        direction TB
        SSRServer["SSR Server<br>(server.ts)"]:::frontend
        MainServer["SSR Entry<br>(main.server.ts)"]:::frontend
        MainClient["SPA Entry<br>(main.ts)"]:::frontend
        AppModule["App Module<br>(app.module.ts)"]:::frontend
        AppRoutes["App Routes<br>(app.routes.ts)"]:::frontend

        subgraph "Feature Modules & Components"
            direction TB
            Home["Home Page<br>(home.component.ts)"]:::frontend
            Login["Login Component<br>(login.component.ts)"]:::frontend
            Register["Register Component<br>(register.component.ts)"]:::frontend
            AdminDash["Admin Dashboard<br>(admin-dashboard.component.ts)"]:::frontend
            BookingDialog["Booking Dialog<br>(booking-dialog.component.ts)"]:::frontend
            BookingConf["Booking Confirmation<br>(booking-confirmation.component.ts)"]:::frontend
            EventDetails["Event Details<br>(event-details.component.ts)"]:::frontend
            Tickets["Tickets View<br>(tickets.component.ts)"]:::frontend
        end

        subgraph "Services"
            direction TB
            AuthService["Auth Service<br>(auth.service.ts)"]:::frontend
            EventService["Event Service<br>(event.service.ts)"]:::frontend
            TicketsService["Tickets Service<br>(tickets.service.ts)"]:::frontend
            AdminService["Admin Service<br>(admin.service.ts)"]:::frontend
        end

        subgraph "Guards & Interceptors"
            direction TB
            AuthGuard["Auth Guard<br>(auth.guard.ts)"]:::frontend
            AdminGuard["Admin Guard<br>(admin.guard.ts)"]:::frontend
            AuthInterceptor["Auth Interceptor<br>(auth.interceptor.ts)"]:::frontend
        end

        subgraph "Environment Configs"
            EnvDev["environment.ts"]:::frontend
            EnvProd["environment.prod.ts"]:::frontend
        end

        PublicAssets["public/"]:::frontend
    end

    %% Backend API Layer
    subgraph "Backend/API Layer"
        direction TB
        Server["Express Server<br>(server.js)"]:::backend
        Middleware["Auth Middleware<br>(auth.js)"]:::backend

        subgraph "Routes"
            direction TB
            AuthRoute["/api/auth<br>(auth.js)"]:::backend
            BookingRoute["/api/bookings<br>(bookings.js)"]:::backend
            EventRoute["/api/events<br>(events.js)"]:::backend
        end

        subgraph "Models"
            direction TB
            UserModel["User Model<br>(user.model.js)"]:::backend
            EventModel["Event Model<br>(event.model.js)"]:::backend
            BookingModel["Booking Model<br>(booking.model.js)"]:::backend
        end

        subgraph "Scripts"
            direction TB
            SeedDb["Seed DB<br>(seedDb.js)"]:::backend
            Migrate["Migrate Bookings<br>(migrateBookings.js)"]:::backend
            FixBookings["Fix Bookings<br>(fixBookings.js)"]:::backend
            DirectFix["Direct Fix<br>(directFix.js)"]:::backend
            UpdateAll["Update All<br>(updateAllBookings.js)"]:::backend
        end

        EnvBackend[".env"]:::backend
    end

    %% Database
    Database["MongoDB"]:::db

    %% Dev & Build Tools
    subgraph "Dev & Build Tools"
        direction TB
        AngularConfig["angular.json"]:::tooling
        TSConfig["tsconfig*.json"]:::tooling
        PackageConfig["package.json<br>package-lock.json"]:::tooling
    end

    %% Connections
    Client -->|HTTPS| SSRServer
    SSRServer -->|renders HTML+assets| Client
    Client -->|loads JS/CSS| PublicAssets
    Client -->|bootstrap SPA| MainClient
    MainClient --> AppModule
    AppModule --> AppRoutes
    AppModule --> Home
    AppModule --> Login
    AppModule --> Register
    AppModule --> AdminDash
    AppModule --> BookingDialog
    AppModule --> BookingConf
    AppModule --> EventDetails
    AppModule --> Tickets
    AppModule --> AuthService
    AppModule --> EventService
    AppModule --> TicketsService
    AppModule --> AdminService
    AppRoutes --> AuthGuard
    AppRoutes --> AdminGuard
    AuthInterceptor --> AuthService

    AuthService -->|HTTP JSON| AuthRoute
    EventService -->|HTTP JSON| EventRoute
    TicketsService -->|HTTP JSON| BookingRoute
    AdminService -->|HTTP JSON| BookingRoute

    AuthRoute --> Middleware
    BookingRoute --> Middleware
    EventRoute --> Middleware
    Middleware --> UserModel
    Middleware --> EventModel
    Middleware --> BookingModel

    UserModel --> Database
    EventModel --> Database
    BookingModel --> Database

    SeedDb --> Database
    Migrate --> Database
    FixBookings --> Database
    DirectFix --> Database
    UpdateAll --> Database

    AngularConfig --> MainClient
    TSConfig --> MainClient
    MainServer --> SSRServer
    Server --> AuthRoute
    Server --> BookingRoute
    Server --> EventRoute
    Server --> Middleware
    PackageConfig --> Server

    %% Click Events
    click AngularConfig "https://github.com/sreearpita/makemybooking/blob/main/angular.json"
    click TSConfig "https://github.com/sreearpita/makemybooking/blob/main/tsconfig.json"
    click TSConfig "https://github.com/sreearpita/makemybooking/blob/main/tsconfig.app.json"
    click MainClient "https://github.com/sreearpita/makemybooking/blob/main/src/main.ts"
    click MainServer "https://github.com/sreearpita/makemybooking/blob/main/src/main.server.ts"
    click SSRServer "https://github.com/sreearpita/makemybooking/blob/main/src/server.ts"
    click AppModule "https://github.com/sreearpita/makemybooking/blob/main/src/app/app.module.ts"
    click AppRoutes "https://github.com/sreearpita/makemybooking/blob/main/src/app/app.routes.ts"
    click AuthService "https://github.com/sreearpita/makemybooking/blob/main/src/app/services/auth.service.ts"
    click EventService "https://github.com/sreearpita/makemybooking/blob/main/src/app/services/event.service.ts"
    click TicketsService "https://github.com/sreearpita/makemybooking/blob/main/src/app/services/tickets.service.ts"
    click AdminService "https://github.com/sreearpita/makemybooking/blob/main/src/app/services/admin.service.ts"
    click AuthGuard "https://github.com/sreearpita/makemybooking/blob/main/src/app/guards/auth.guard.ts"
    click AdminGuard "https://github.com/sreearpita/makemybooking/blob/main/src/app/guards/admin.guard.ts"
    click AuthInterceptor "https://github.com/sreearpita/makemybooking/blob/main/src/app/interceptors/auth.interceptor.ts"
    click EnvDev "https://github.com/sreearpita/makemybooking/blob/main/src/environments/environment.ts"
    click EnvProd "https://github.com/sreearpita/makemybooking/blob/main/src/environments/environment.prod.ts"
    click PublicAssets "https://github.com/sreearpita/makemybooking/tree/main/public/"
    click Server "https://github.com/sreearpita/makemybooking/blob/main/backend/server.js"
    click AuthRoute "https://github.com/sreearpita/makemybooking/blob/main/backend/routes/auth.js"
    click BookingRoute "https://github.com/sreearpita/makemybooking/blob/main/backend/routes/bookings.js"
    click EventRoute "https://github.com/sreearpita/makemybooking/blob/main/backend/routes/events.js"
    click Middleware "https://github.com/sreearpita/makemybooking/blob/main/backend/middleware/auth.js"
    click UserModel "https://github.com/sreearpita/makemybooking/blob/main/backend/models/user.model.js"
    click EventModel "https://github.com/sreearpita/makemybooking/blob/main/backend/models/event.model.js"
    click BookingModel "https://github.com/sreearpita/makemybooking/blob/main/backend/models/booking.model.js"
    click SeedDb "https://github.com/sreearpita/makemybooking/blob/main/backend/scripts/seedDb.js"
    click Migrate "https://github.com/sreearpita/makemybooking/blob/main/backend/scripts/migrateBookings.js"
    click FixBookings "https://github.com/sreearpita/makemybooking/blob/main/backend/scripts/fixBookings.js"
    click DirectFix "https://github.com/sreearpita/makemybooking/blob/main/backend/scripts/directFix.js"
    click UpdateAll "https://github.com/sreearpita/makemybooking/blob/main/backend/scripts/updateAllBookings.js"
    click EnvBackend "https://github.com/sreearpita/makemybooking/blob/main/backend/.env"
    click PackageConfig "https://github.com/sreearpita/makemybooking/blob/main/package.json"

    %% Styles
    classDef frontend fill:#E3F2FD,stroke:#90CAF9,color:#0D47A1
    classDef backend fill:#E8F5E9,stroke:#A5D6A7,color:#1B5E20
    classDef db fill:#FFF3E0,stroke:#FFCC80,color:#E65100
    classDef tooling fill:#ECEFF1,stroke:#B0BEC5,color:#37474F
    classDef external fill:#F3E5F5,stroke:#CE93D8,color:#4A148C
```
