# zubair-mallick/empower_hub architecture

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

- Interactive diagram: https://gitdiagram.com/zubair-mallick/empower_hub
- Repository: https://github.com/zubair-mallick/empower_hub

## Overview

##### Main Components
- User’s Device (Browser or Mobile App)
- Frontend (Next.js React App hosted on Vercel)
- Backend API (Node.js + Express.js server hosted on Render/other cloud)
- AI/LLM Service (Gemini AI or other model endpoints)
- Database (MongoDB or another persistence layer)
- External Resources (Third-party APIs for resources, authentication, rate limiting)

##### Architectural Patterns & Principles
- Layered Architecture – UI, API, Business Logic, Data Persistence
- Single Page Application – Next.js with SSR/CSR
- RESTful APIs – Clear endpoint structure under `/api/...`
- Modularity – Separate controllers, routes, schemas, and utilities
- Scalability – External AI service and database can scale independently

##### Key Technologies to Annotate
- Frontend: Next.js, React.js, TailwindCSS, React Query
- Backend: Node.js, Express.js, Middleware (rate limiter)
- AI & LLM: Gemini AI (modular connectors)
- Database: MongoDB (via `dbConnect`)
- Hosting: Vercel (Frontend), Render or Cloud Provider (Backend)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Main Flow
    UD["1. User Device"]:::ui
    FE["2. Frontend (Next.js on Vercel)"]:::ui
    BE["3. Backend API (Express on Render)"]:::api
    AIService["4. AI/LLM Service (Gemini AI)"]:::ai
    DB["5. Database (MongoDB)"]:::db
    External["6. External Resource APIs"]:::ext

    UD -->|"1"| FE
    FE -->|"2"| BE
    BE -->|"3"| AIService
    AIService -->|"4"| DB
    DB -->|"5"| External

    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        PagesAPI["Pages & API Routes"]:::ui
        Components["React Components"]:::ui
        subgraph "State & Data Fetching"
            direction TB
            RQ["React Query Provider"]:::ui
            Utils["Utility Functions"]:::ui
        end
        DBConnect["DB Connect Utility"]:::ui
        TypesSchemas["Types & Schemas"]:::ui
    end
    FE --> PagesAPI
    FE --> Components
    FE --> RQ
    FE --> Utils
    FE --> DBConnect
    FE --> TypesSchemas

    %% Backend Layer
    subgraph "Backend Layer"
        direction TB
        ServerJS["Server Entry Point"]:::api

        subgraph "Routes"
            direction TB
            RGuidanceRoutes["Career Guidance Routes"]:::api
            RRecommendationsRoutes["Career Recommendations Routes"]:::api
            ChatbotRoutes["Chatbot Response Routes"]:::api
            ResourcesRoutes["External Resources Routes"]:::api
            TreeDataRoutes["Roadmap/Steps Routes"]:::api
        end

        subgraph "Controllers"
            direction TB
            CGuidanceCtrl["Career Guidance Controller"]:::api
            CRecommendationsCtrl["Career Rec. Controller"]:::api
            ChatbotCtrl["Get Chatbot Controller"]:::api
            ResourcesCtrl["Resources Controller"]:::api
            TreeDataCtrl["Roadmap Controller"]:::api
        end

        Middleware["Request Limiter Middleware"]:::api

        subgraph "Response Schemas"
            direction TB
            SchemaResource["Resource Schema"]:::api
            SchemaGuidance["Guidance Schema"]:::api
            SchemaRecommendations["Recommendations Schema"]:::api
            SchemaSteps["Roadmap Steps Schema"]:::api
        end
    end
    BE --> ServerJS
    ServerJS --> RGuidanceRoutes
    ServerJS --> RRecommendationsRoutes
    ServerJS --> ChatbotRoutes
    ServerJS --> ResourcesRoutes
    ServerJS --> TreeDataRoutes
    RGuidanceRoutes --> CGuidanceCtrl
    RRecommendationsRoutes --> CRecommendationsCtrl
    ChatbotRoutes --> ChatbotCtrl
    ResourcesRoutes --> ResourcesCtrl
    TreeDataRoutes --> TreeDataCtrl
    CGuidanceCtrl --> Middleware
    CRecommendationsCtrl --> Middleware
    ChatbotCtrl --> Middleware
    ResourcesCtrl --> Middleware
    TreeDataCtrl --> Middleware
    CGuidanceCtrl --> SchemaGuidance
    CRecommendationsCtrl --> SchemaRecommendations
    ChatbotCtrl --> SchemaSteps
    ResourcesCtrl --> SchemaResource
    TreeDataCtrl --> SchemaSteps

    %% Click Events Frontend
    click FE "https://github.com/zubair-mallick/empower_hub/tree/main/frontend/"
    click PagesAPI "https://github.com/zubair-mallick/empower_hub/tree/main/frontend/src/app/"
    click Components "https://github.com/zubair-mallick/empower_hub/tree/main/frontend/src/components/"
    click RQ "https://github.com/zubair-mallick/empower_hub/blob/main/frontend/src/lib/ReactQueryProvider.tsx"
    click Utils "https://github.com/zubair-mallick/empower_hub/blob/main/frontend/src/lib/utils.ts"
    click DBConnect "https://github.com/zubair-mallick/empower_hub/blob/main/frontend/src/lib/dbConnect.ts"
    click TypesSchemas "https://github.com/zubair-mallick/empower_hub/tree/main/frontend/src/types/"

    %% Click Events Backend
    click ServerJS "https://github.com/zubair-mallick/empower_hub/blob/main/server/server.js"
    click RGuidanceRoutes "https://github.com/zubair-mallick/empower_hub/blob/main/server/routes/careerGuidance.routes.js"
    click RRecommendationsRoutes "https://github.com/zubair-mallick/empower_hub/blob/main/server/routes/careerRecommendations.routes.js"
    click ChatbotRoutes "https://github.com/zubair-mallick/empower_hub/blob/main/server/routes/CareerGuidanceResponseChatbot.routes.js"
    click ResourcesRoutes "https://github.com/zubair-mallick/empower_hub/blob/main/server/routes/resources.routes.js"
    click TreeDataRoutes "https://github.com/zubair-mallick/empower_hub/blob/main/server/routes/treeData.routes.js"
    click CGuidanceCtrl "https://github.com/zubair-mallick/empower_hub/blob/main/server/controllers/careerGuidance.controller.js"
    click CRecommendationsCtrl "https://github.com/zubair-mallick/empower_hub/blob/main/server/controllers/careerRecommendation.controller.js"
    click ChatbotCtrl "https://github.com/zubair-mallick/empower_hub/blob/main/server/controllers/getCareerGuidanceChatbot.controller.js"
    click ResourcesCtrl "https://github.com/zubair-mallick/empower_hub/blob/main/server/controllers/resources.controller.js"
    click TreeDataCtrl "https://github.com/zubair-mallick/empower_hub/blob/main/server/controllers/treeData.controller.js"
    click Middleware "https://github.com/zubair-mallick/empower_hub/blob/main/server/middleware/requestLimiter.js"
    click SchemaResource "https://github.com/zubair-mallick/empower_hub/blob/main/server/schemas/resonseSchemaResource.js"
    click SchemaGuidance "https://github.com/zubair-mallick/empower_hub/blob/main/server/schemas/responseSchemaCareerGuidance.js"
    click SchemaRecommendations "https://github.com/zubair-mallick/empower_hub/blob/main/server/schemas/responseSchemaCareerRecommendations.js"
    click SchemaSteps "https://github.com/zubair-mallick/empower_hub/blob/main/server/schemas/responseSchemaSteps.js"

    %% Styles
    classDef ui fill:#D0E8FF,stroke:#02457A,color:#02457A;
    classDef api fill:#DFFFE0,stroke:#3A5F0B,color:#3A5F0B;
    classDef ai fill:#FFE8B0,stroke:#A66E00,color:#A66E00;
    classDef db fill:#E8E8E8,stroke:#555,color:#555;
    classDef ext fill:#F0D0FF,stroke:#6A0175,color:#6A0175;
```
