# harshitpg/mfc-recruitment-portal-fe architecture

> Architecture diagram of the GitHub repository harshitpg/mfc-recruitment-portal-fe, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harshitpg/mfc-recruitment-portal-fe
- Repository: https://github.com/harshitpg/mfc-recruitment-portal-fe

## Overview

##### Main Application Architecture Components

a) Frontend Layer
- Divide into sub-components:
- 3D Experience Module (based on /component3d directory)
- Core UI Components (/components directory)
- Application Sections (/sections directory)
- Layout Wrappers (/wrappers directory)

##### State Management & Context
- A store module (based on store.ts)
- Context providers (based on /context directory)
- Data flow patterns

##### Key Architectural Patterns to Highlight

a) Component Layer Structure:
**┌─ Application Shell**
- Wrappers (BaseWrapper, MainWrapper, NavWrapper)
- Core Components
- Navigation
- UI Components
- 3D Components
- Application Sections
- Context & State Management

b) 3D Integration Layer:
- Connection between the 3D experience components and the model assets
- Relationship between Experience.tsx, Fox.tsx, and the model files

##### Feature Modules

Sections into logical feature modules:
- Authentication (Signup, ForgotPassword, VerifyOTP)
- Task Management (various Task and TaskSubmission components)
- Application Status (TechApplicationStatus, ManagementApplicationStatus, etc.)
- Profile Management (Profile, ChangeProfile)

##### Technical Stack Indicators

- React + TypeScript (based on tsconfig)
- Vite (based on vite.config.ts)
- Tailwind CSS (based on configuration files)
- 3D rendering library (likely Three.js based on the 3D components)

##### Important Details

- Routing structure
- State management flow
- Entry points (main.tsx)
- Build/deployment configuration

**┌─ UI Layer**
- Components
- Sections
- Wrappers
- Business Logic Layer
- Context
- State Management
- 3D Rendering Layer
- Experience
- Models
- Animations
- Configuration Layer
- Build Tools
- Deployment

Remember to:
- Use consistent styling and spacing
- Notes for any complex interactions
- Build/deployment pipeline
- External dependencies and services

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "Application Entry"
        Entry["Main Entry Point"]:::entry
        App["App Container"]:::app
        Dashboard["Dashboard"]:::dashboard
    end

    subgraph "Layout Layer"
        BaseWrapper["Base Wrapper"]:::wrapper
        MainWrapper["Main Wrapper"]:::wrapper
        NavWrapper["Navigation Wrapper"]:::wrapper
    end

    subgraph "Core UI Layer"
        Navbar["Navigation Bar"]:::ui
        Header["Header"]:::ui
        Button["Common Button"]:::ui
        Input["Input Component"]:::ui
        Scene3D["3D Scene Component"]:::ui
    end

    subgraph "3D Experience Layer"
        Experience["Main Experience"]:::threeD
        Fox["Character Model"]:::threeD
        Interface["3D Interface"]:::threeD
        ModelAssets["Model Assets"]:::assets
    end

    subgraph "State Management"
        Store["Main Store"]:::state
        CharAnimation["Character Animation Context"]:::state
    end

    subgraph "Feature Modules"
        direction TB
        subgraph "Authentication"
            Signup["Signup"]:::auth
            ResetPassword["Password Reset"]:::auth
            VerifyOTP["OTP Verification"]:::auth
            ForgotPassword["Forgot Password"]:::auth
        end

        subgraph "Task Management"
            Task["General Tasks"]:::task
            TechTask["Tech Tasks"]:::task
            DesignTask["Design Tasks"]:::task
            ManagementTask["Management Tasks"]:::task
        end

        subgraph "Application Status"
            TechStatus["Tech Status"]:::status
            DesignStatus["Design Status"]:::status
            ManagementStatus["Management Status"]:::status
        end

        subgraph "Profile Management"
            Profile["Profile View"]:::profile
            ChangeProfile["Profile Update"]:::profile
        end
    end

    %% Relationships
    Entry --> App
    App --> Dashboard
    App --> BaseWrapper
    BaseWrapper --> MainWrapper
    MainWrapper --> NavWrapper
    NavWrapper --> Navbar
    NavWrapper --> Scene3D
    Scene3D --> Experience
    Experience --> Fox
    Experience --> Interface
    Fox --> ModelAssets
    Store --> App
    CharAnimation --> Fox

    %% Styling
    classDef entry fill:#f9f,stroke:#333
    classDef app fill:#ffd,stroke:#333
    classDef dashboard fill:#dfd,stroke:#333
    classDef wrapper fill:#e7d5e7,stroke:#333
    classDef ui fill:#9cf,stroke:#333
    classDef threeD fill:#90EE90,stroke:#333
    classDef assets fill:#FFB6C1,stroke:#333
    classDef state fill:#FFD700,stroke:#333
    classDef auth fill:#87CEEB,stroke:#333
    classDef task fill:#98FB98,stroke:#333
    classDef status fill:#DDA0DD,stroke:#333
    classDef profile fill:#F0E68C,stroke:#333

    %% Click Events
    click Entry "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/main.tsx"
    click App "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/App.tsx"
    click Dashboard "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/dashboard/Dashboard.tsx"
    click BaseWrapper "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/wrappers/BaseWrapper.tsx"
    click MainWrapper "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/wrappers/MainWrapper.tsx"
    click NavWrapper "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/wrappers/NavWrapper.tsx"
    click Navbar "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/components/Navbar.tsx"
    click Header "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/components/Header.tsx"
    click Button "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/components/Button.tsx"
    click Input "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/components/Input.tsx"
    click Scene3D "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/components/Scene3d.tsx"
    click Experience "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/component3d/Experience.tsx"
    click Fox "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/component3d/Fox.tsx"
    click Interface "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/component3d/Interface.tsx"
    click ModelAssets "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/public/model/fox1.gltf"
    click Store "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/store.ts"
    click CharAnimation "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/context/CharAnimation.tsx"
    click Signup "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/sections/Signup.tsx"
    click ResetPassword "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/sections/ResetPassword.tsx"
    click VerifyOTP "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/sections/VerifyOTP.tsx"
    click ForgotPassword "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/sections/ForgotPasswordStep1.tsx"
    click Task "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/sections/Task.tsx"
    click TechTask "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/sections/TechTask.tsx"
    click DesignTask "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/sections/DesignTask.tsx"
    click ManagementTask "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/sections/ManagementTask.tsx"
    click TechStatus "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/sections/TechApplicationStatus.tsx"
    click DesignStatus "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/sections/DesignApplicationStatus.tsx"
    click ManagementStatus "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/sections/ManagementApplicationStatus.tsx"
    click Profile "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/sections/Profile.tsx"
    click ChangeProfile "https://github.com/HarshitPG/MFC-Recruitment-Portal-FE/blob/main/src/sections/ChangeProfile.tsx"
```
