# jennifertjen/partnerdashboardcekatai architecture

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

- Interactive diagram: https://gitdiagram.com/jennifertjen/partnerdashboardcekatai
- Repository: https://github.com/jennifertjen/partnerdashboardcekatai

## Overview

##### Project type and purpose
- This is a full-stack, serverless React dashboard built on Next.js (TypeScript) for “PartnerDashboardCekatAI.”
- It serves a multi-page admin UI (in `pages/…`) with localized content, Redux state management, and a small set of Next.js API routes (“backend for frontend”) that interact with a Supabase backend and external services (Facebook SDK, SMTP/email provider).

##### File structure
- Top‐level config: `.eslintrc.json`, `tsconfig.json`, `next.config.js`, `tailwind.config.js`, i18n config.
- `pages/`: all user-facing pages plus `pages/api/` routes (e.g. `add-agent.tsx`).
- `store/`: Redux Toolkit slices (`broadcastSlice.tsx`, `partnerSlice.tsx`, etc.) and central `store/index.tsx`.
- `utils/`: helper modules (`supabaseClient.ts`, `http.ts`, `auth.ts`, `FacebookSDK.ts`, etc.).
- `public/`: static assets (images, audio), translation JSONs, templates.
- `styles/`: global and third-party CSS.

##### README
- Confirms a deployed Vercel app, credentials for testing.

a. Main components
- Browser / Client
- Next.js Frontend (SSR/SSG/CSR pages)
- Redux Store (client-side state)
- Next.js API routes (BFF layer)
- Supabase (Auth + Database)
- External Services (Facebook SDK, SMTP/email provider)
- CDN / Vercel hosting for static assets

b. Relationships and interactions
- Browser ⇄ Next.js Frontend: page requests, client hydration
- Frontend → Redux Store → Async thunks → Next.js API → Supabase
- Frontend → utils/supabaseClient for direct DB reads (if any)
- Next.js API routes ⇄ Supabase for data mutations and auth
- Frontend loads Facebook SDK via `utils/FacebookSDK.ts`
- Frontend or API routes send emails via SMTP provider (wrapped in `smtpSlice`)
- Static assets & locale JSONs served from `public/` via CDN

c. Architectural patterns & principles
- JAMstack / serverless (Next.js pages + API routes on Vercel)
- Backend-for-Frontend (BFF) in `pages/api/`
- Hybrid rendering (SSG for public pages, SSR for authenticated sections, CSR for interactions)
- Redux Toolkit slices for modular state
- i18n via locale JSON files

d. Key technologies & frameworks
- Next.js (SSR/SSG/CSR)
- React & TypeScript
- Redux Toolkit
- Supabase (Auth, Postgres)
- Tailwind CSS & PostCSS
- next-i18next or custom i18n loader
- Vercel (hosting & CDN)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    subgraph "Client (Browser)"
        A["Browser"]:::frontend
    end

    %% Frontend UI Layer
    subgraph "Next.js Frontend (UI Pages)" 
        B["UI Pages (pages/)"]:::frontend
        C["UI Component Library (components/)"]:::frontend
        D["Layout System (components/Layouts/)"]:::frontend
        E["Localization (public/locales/, i18n.config)"]:::frontend
        F["Global Styles (styles/, tailwind.config.js)"]:::frontend
    end

    %% State Management
    subgraph "Redux Store & State Management"
        G1["Store Setup (store/index.tsx)"]:::frontend
        G2["broadcastSlice"]:::frontend
        G3["partnerSlice"]:::frontend
        G4["smtpSlice"]:::frontend
        G5["emailTemplateSlice"]:::frontend
        G6["themeConfigSlice"]:::frontend
    end

    %% Utils
    subgraph "Client Utilities"
        H1["Supabase Client (utils/supabaseClient.ts)"]:::frontend
        H2["HTTP Helper (utils/http.ts)"]:::frontend
        H3["Auth Utils (utils/auth.ts)"]:::frontend
        H4["useAuth Hook (utils/useAuth.ts)"]:::frontend
        H5["Facebook SDK (utils/FacebookSDK.ts)"]:::external
    end

    %% BFF Layer
    subgraph "Next.js API Routes (BFF Layer)"
        I["API Routes (pages/api/)"]:::backend
    end

    %% Data Layer
    subgraph "Data & Auth"
        J["Supabase (Auth & Database)"]:::datastore
    end

    %% External Services
    subgraph "External Services"
        K["SMTP/Email Provider"]:::external
    end

    %% Hosting & CDN
    subgraph "Hosting & CDN"
        L["Vercel & CDN"]:::external
        M["Static Assets & Templates (public/assets/, public/templates/)"]:::external
    end

    %% Config & Build
    subgraph "Project Configuration & Build"
        N1["next.config.js"]:::config
        N2["tsconfig.json"]:::config
        N3[".eslintrc.json"]:::config
        N4["postcss.config.js"]:::config
        N5["middleware.ts"]:::config
    end

    %% Connections
    A -->|"loads"| B
    B -->|"uses components"| C
    B -->|"uses layouts"| D
    B -->|"loads locales"| E
    B -->|"loads styles"| F
    B -->|"dispatches actions"| G1
    G1 -->|"includes slices"| G2 & G3 & G4 & G5 & G6
    G1 -->|"calls utils"| H1 & H2 & H3 & H4
    B -->|"loads Facebook SDK"| H5
    G1 -->|"calls API"| I
    H1 -->|"connects to"| J
    I -->|"queries/mutates"| J
    I -->|"sends email via"| K
    L -->|"serves static assets"| M
    L -->|"hosts frontend/API"| B & I
    J -->|"auth flows via"| H3
    N1 & N2 & N3 & N4 & N5 --> B & I

    %% Click Events
    click B "https://github.com/jennifertjen/partnerdashboardcekatai/tree/main/pages/"
    click I "https://github.com/jennifertjen/partnerdashboardcekatai/tree/main/pages/api/"
    click G1 "https://github.com/jennifertjen/partnerdashboardcekatai/blob/main/store/index.tsx"
    click G2 "https://github.com/jennifertjen/partnerdashboardcekatai/blob/main/store/broadcastSlice.tsx"
    click G3 "https://github.com/jennifertjen/partnerdashboardcekatai/blob/main/store/partnerSlice.tsx"
    click G4 "https://github.com/jennifertjen/partnerdashboardcekatai/blob/main/store/smtpSlice.tsx"
    click G5 "https://github.com/jennifertjen/partnerdashboardcekatai/blob/main/store/emailTemplateSlice.tsx"
    click G6 "https://github.com/jennifertjen/partnerdashboardcekatai/blob/main/store/themeConfigSlice.tsx"
    click H1 "https://github.com/jennifertjen/partnerdashboardcekatai/blob/main/utils/supabaseClient.ts"
    click H2 "https://github.com/jennifertjen/partnerdashboardcekatai/blob/main/utils/http.ts"
    click H3 "https://github.com/jennifertjen/partnerdashboardcekatai/blob/main/utils/auth.ts"
    click H4 "https://github.com/jennifertjen/partnerdashboardcekatai/blob/main/utils/useAuth.ts"
    click H5 "https://github.com/jennifertjen/partnerdashboardcekatai/blob/main/utils/FacebookSDK.ts"

    %% Styles
    classDef frontend fill:#cce5ff,stroke:#004085,color:#004085;
    classDef backend fill:#d4edda,stroke:#155724,color:#155724;
    classDef external fill:#fff3cd,stroke:#856404,color:#856404;
    classDef datastore fill:#e2e3e5,stroke:#383d41,color:#383d41;
    classDef config fill:#f8d7da,stroke:#721c24,color:#721c24;
```
