# debdas5110/bank_management_system architecture

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

- Interactive diagram: https://gitdiagram.com/debdas5110/bank_management_system
- Repository: https://github.com/debdas5110/bank_management_system

## Overview

##### Project type and purpose
- This is a full-stack Bank Management System, with a React/TypeScript frontend and Supabase as a backend-as-a-service (database, auth, file storage). It’s deployed on Vercel for hosting and CDN.

##### File structure
- Top-level: package.json, Vite config, Tailwind config, supabase/ (config + migrations).
- src/: contains App.tsx, pages/, components/, contexts/, hooks/, integrations/, utils/.
- components/ is subdivided into admin, auth, dashboard, ui.
- integrations/supabase holds the client setup and types.
- supabase/ folder contains the database config and schema migration SQL files.

##### README for additional insights
- Confirms usage of Vite, React, TypeScript, Tailwind CSS, shadcn-ui.
- Hosted on Vercel, GitHub → Vercel CI/CD pipeline.
- Supabase provides Auth and Postgres DB.

##### Elements
- Clear labels for each component (e.g., “React App”, “Supabase Auth”, “Postgres DB”)
- Static asset fetch (Browser ← Vercel)
- API/auth calls (Browser ↔ Supabase)
- File uploads (Browser → Supabase Storage)
- Green for BaaS components (Supabase Auth, DB, Storage)
- Orange for external services (Vercel, GitHub)

##### Detail
- Every Supabase migration and config file as part of the “Database Schema” block
- “src/integrations/supabase/client.ts” as the bridge between UI and backend
- How “contexts” and “hooks” modules manage and expose data across UI layers

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "User"
        User("End User")
    end

    subgraph "Client"
        Browser("Browser/Mobile"):::external
    end

    User --> Browser

    subgraph "Frontend"
        ReactApp("React App"):::frontend
        subgraph "Structure"
            Pages("Pages"):::frontend
            Components("Components"):::frontend
            subgraph "Components"
                UIComponents("UI Components"):::frontend
                AdminComponents("Admin Components"):::frontend
                DashboardComponents("Dashboard Components"):::frontend
                AuthComponents("Auth Components"):::frontend
            end
            Contexts("Contexts"):::frontend
            Hooks("Hooks"):::frontend
            Integrations("Supabase Client"):::frontend
            Utils("Utilities"):::frontend
        end
    end

    Browser --> ReactApp
    ReactApp --> Pages
    ReactApp --> Components
    Pages -->|routes| AuthComponents
    Pages -->|routes| DashboardComponents
    Pages -->|routes| AdminComponents
    Components --> UIComponents
    Components --> AdminComponents
    Components --> DashboardComponents
    Components --> AuthComponents
    ReactApp --> Contexts
    ReactApp --> Hooks
    ReactApp --> Integrations
    ReactApp --> Utils

    subgraph "Supabase BaaS"
        SupabaseAuth("Supabase Auth"):::baas
        SupabaseDB("Postgres Database"):::baas
        SupabaseStorage("Storage"):::baas
    end

    Integrations --> SupabaseAuth
    Integrations --> SupabaseDB
    Integrations --> SupabaseStorage
    ReactApp -->|auth/data API| SupabaseAuth
    ReactApp -->|CRUD API| SupabaseDB
    ReactApp -->|file uploads| SupabaseStorage

    subgraph "CI/CD & Hosting"
        GitHub("GitHub Repo"):::external
        Vercel("Vercel Hosting/CDN"):::external
    end

    GitHub -->|push triggers| Vercel
    Vercel -->|serves assets| Browser
    ReactApp -->|deploy| Vercel

    click ReactApp "https://github.com/debdas5110/bank_management_system/blob/main/src/main.tsx"
    click ReactApp "https://github.com/debdas5110/bank_management_system/blob/main/src/App.tsx"
    click ReactApp "https://github.com/debdas5110/bank_management_system/blob/main/index.html"
    click ReactApp "https://github.com/debdas5110/bank_management_system/blob/main/src/index.css"
    click UIComponents "https://github.com/debdas5110/bank_management_system/tree/main/src/components/ui/"
    click AdminComponents "https://github.com/debdas5110/bank_management_system/tree/main/src/components/admin/"
    click DashboardComponents "https://github.com/debdas5110/bank_management_system/tree/main/src/components/dashboard/"
    click AuthComponents "https://github.com/debdas5110/bank_management_system/tree/main/src/components/auth/"
    click Pages "https://github.com/debdas5110/bank_management_system/tree/main/src/pages/"
    click Contexts "https://github.com/debdas5110/bank_management_system/tree/main/src/contexts/"
    click Hooks "https://github.com/debdas5110/bank_management_system/tree/main/src/hooks/"
    click Integrations "https://github.com/debdas5110/bank_management_system/blob/main/src/integrations/supabase/client.ts"
    click Integrations "https://github.com/debdas5110/bank_management_system/blob/main/src/integrations/supabase/types.ts"
    click SupabaseDB "https://github.com/debdas5110/bank_management_system/blob/main/supabase/config.toml"
    click SupabaseStorage "https://github.com/debdas5110/bank_management_system/tree/main/public/lovable-uploads/"
    click Utils "https://github.com/debdas5110/bank_management_system/blob/main/src/lib/utils.ts"
    click Utils "https://github.com/debdas5110/bank_management_system/blob/main/src/utils/backgroundRemoval.ts"

    classDef frontend fill:#E0F7FA,stroke:#006064,color:#000;
    classDef baas fill:#E8F5E9,stroke:#2E7D32,color:#000;
    classDef external fill:#FFF3E0,stroke:#EF6C00,color:#000;
```
