# anshuman2810/ai-ticketing-system architecture

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

- Interactive diagram: https://gitdiagram.com/anshuman2810/ai-ticketing-system
- Repository: https://github.com/anshuman2810/ai-ticketing-system

## Overview

##### Project Type and Purpose
- This is a full-stack web application composed of:
- A React-based frontend (located in the `frontend/` folder)
- A Node.js/Express backend (in `backend/`)
- An event-driven extensions layer using Inngest functions
- The app manages users and support tickets, triggering asynchronous workflows (e.g., sending emails, AI processing) on signup and ticket creation.

##### Main Components
a. Frontend (React + Vite + Tailwind)
b. Backend API (Express controller-route-model structure)
c. Database (e.g., MongoDB or SQL – implied by `models/`)
d. Inngest event bus and serverless functions
e. External services:
- Email service (via `utils/mailer.js`)
- AI service (via `utils/ai.js`)
- Any network calls (via `utils/network.js`)

##### Relationships and Data Flows
1. User/browser → Frontend UI
- Pages: login, signup, tickets list, ticket detail, admin
2. Frontend → Backend REST API
- Endpoints under `/user` and `/ticket` routes
- Auth middleware protects routes
3. Backend → Database
- `models/user.js` and `models/ticket.js` interact with DB
4. Backend → Inngest
- After database writes (signup or ticket creation), backend enqueues events to Inngest client
5. Inngest → Functions
- `on-signup.js` and `on-ticket-create.js` consume events
- Functions use AI and mailer utils to send emails or perform follow-up
6. External Services
- Mailer and AI utilities make outbound HTTP calls

##### Architectural Patterns and Design Principles
- MVC-style separation in backend:
- Models (`backend/models`)
- Controllers (`backend/controllers`)
- Routes (`backend/routes`)
- Middleware for authentication (`backend/middlewares/auth.js`)
- Event-driven asynchronous processing with Inngest (decouples side effects from core API)
- React component hierarchy with pages and shared components

4. Inside Backend, subdivide into:
– Routes layer (`user.js`, `ticket.js`)
– Controllers (`user.js`, `ticket.js`)
– Models (`user.js`, `ticket.js`)
– Middleware (auth)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User and Frontend Layer
    User["User / Browser"]:::user
    subgraph "Frontend Application"
        FE_main["Entry: main.jsx"]:::frontend
        FE_login["Login Page"]:::frontend
        FE_signup["Signup Page"]:::frontend
        FE_tickets["Tickets List Page"]:::frontend
        FE_ticket["Ticket Detail Page"]:::frontend
        FE_admin["Admin Page"]:::frontend
        FE_check["Check Auth Component"]:::frontend
        FE_nav["Navbar Component"]:::frontend
    end

    User --> FE_main
    FE_main --> FE_login
    FE_main --> FE_signup
    FE_main --> FE_tickets
    FE_main --> FE_ticket
    FE_main --> FE_admin
    FE_main --> FE_check
    FE_main --> FE_nav
    FE_main -->|"HTTP REST"| BE_index

    %% Backend API Layer
    subgraph "Backend API (Express)"
        BE_index["Bootstrap: index.js"]:::backend
        BE_user_route["User Routes"]:::backend
        BE_ticket_route["Ticket Routes"]:::backend
        BE_auth["Auth Middleware"]:::backend
        BE_user_ctrl["User Controller"]:::backend
        BE_ticket_ctrl["Ticket Controller"]:::backend
        BE_user_model["User Model"]:::model
        BE_ticket_model["Ticket Model"]:::model
    end

    FE_main -->|"HTTP REST"| BE_index
    BE_index --> BE_user_route
    BE_index --> BE_ticket_route
    BE_user_route -->|"uses"| BE_auth
    BE_user_route -->|"calls"| BE_user_ctrl
    BE_ticket_route -->|"uses"| BE_auth
    BE_ticket_route -->|"calls"| BE_ticket_ctrl
    BE_user_ctrl -->|"reads/writes"| BE_user_model
    BE_ticket_ctrl -->|"reads/writes"| BE_ticket_model

    %% Database
    subgraph "Database"
        DB["Database"]:::db
    end
    BE_user_model -->|"DB"| DB
    BE_ticket_model -->|"DB"| DB

    %% Inngest Event Bus and Functions
    subgraph "Inngest Event Bus"
        IB_client["Inngest Client"]:::event
    end
    BE_user_ctrl -.->|"enqueue signup event"| IB_client
    BE_ticket_ctrl -.->|"enqueue ticket event"| IB_client

    subgraph "Inngest Functions"
        F_signup["on-signup"]:::func
        F_ticket["on-ticket-create"]:::func
    end
    IB_client -.-> F_signup
    IB_client -.-> F_ticket

    %% External Services
    subgraph "External Services"
        Mailer["Mailer Service"]:::ext
        AI["AI Service"]:::ext
        Network["Network Utility"]:::ext
    end
    F_signup -->|"uses"| Mailer
    F_signup -->|"uses"| AI
    F_ticket -->|"uses"| Mailer
    F_ticket -->|"uses"| AI
    Mailer -->|"HTTP Call"| Network
    AI -->|"HTTP Call"| Network

    %% Click Events
    click FE_main "https://github.com/anshuman2810/ai-ticketing-system/blob/main/frontend/src/main.jsx"
    click FE_login "https://github.com/anshuman2810/ai-ticketing-system/blob/main/frontend/src/pages/login.jsx"
    click FE_signup "https://github.com/anshuman2810/ai-ticketing-system/blob/main/frontend/src/pages/signup.jsx"
    click FE_tickets "https://github.com/anshuman2810/ai-ticketing-system/blob/main/frontend/src/pages/tickets.jsx"
    click FE_ticket "https://github.com/anshuman2810/ai-ticketing-system/blob/main/frontend/src/pages/ticket.jsx"
    click FE_admin "https://github.com/anshuman2810/ai-ticketing-system/blob/main/frontend/src/pages/admin.jsx"
    click FE_check "https://github.com/anshuman2810/ai-ticketing-system/blob/main/frontend/src/components/check-auth.jsx"
    click FE_nav "https://github.com/anshuman2810/ai-ticketing-system/blob/main/frontend/src/components/navbar.jsx"
    click BE_index "https://github.com/anshuman2810/ai-ticketing-system/blob/main/backend/index.js"
    click BE_user_route "https://github.com/anshuman2810/ai-ticketing-system/blob/main/backend/routes/user.js"
    click BE_ticket_route "https://github.com/anshuman2810/ai-ticketing-system/blob/main/backend/routes/ticket.js"
    click BE_auth "https://github.com/anshuman2810/ai-ticketing-system/blob/main/backend/middlewares/auth.js"
    click BE_user_ctrl "https://github.com/anshuman2810/ai-ticketing-system/blob/main/backend/controllers/user.js"
    click BE_ticket_ctrl "https://github.com/anshuman2810/ai-ticketing-system/blob/main/backend/controllers/ticket.js"
    click BE_user_model "https://github.com/anshuman2810/ai-ticketing-system/blob/main/backend/models/user.js"
    click BE_ticket_model "https://github.com/anshuman2810/ai-ticketing-system/blob/main/backend/models/ticket.js"
    click IB_client "https://github.com/anshuman2810/ai-ticketing-system/blob/main/backend/inngest/client.js"
    click F_signup "https://github.com/anshuman2810/ai-ticketing-system/blob/main/backend/inngest/functions/on-signup.js"
    click F_ticket "https://github.com/anshuman2810/ai-ticketing-system/blob/main/backend/inngest/functions/on-ticket-create.js"
    click Mailer "https://github.com/anshuman2810/ai-ticketing-system/blob/main/backend/utils/mailer.js"
    click AI "https://github.com/anshuman2810/ai-ticketing-system/blob/main/backend/utils/ai.js"
    click Network "https://github.com/anshuman2810/ai-ticketing-system/blob/main/backend/utils/network.js"

    %% Styles
    classDef user fill:#E3F2FD,stroke:#90CAF9
    classDef frontend fill:#BBDEFB,stroke:#2196F3
    classDef backend fill:#C8E6C9,stroke:#4CAF50
    classDef model fill:#A5D6A7,stroke:#388E3C
    classDef db fill:#F8BBD0,stroke:#D81B60,stroke-width:2px
    classDef event fill:#FFF9C4,stroke:#FBC02D
    classDef func fill:#FFCCBC,stroke:#E64A19
    classDef ext fill:#FFE0B2,stroke:#FB8C00
```
