# kpirabaharan/e-commerce-admin-dashboard architecture

> Architecture diagram of the GitHub repository kpirabaharan/e-commerce-admin-dashboard, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kpirabaharan/e-commerce-admin-dashboard
- Repository: https://github.com/kpirabaharan/e-commerce-admin-dashboard

## Overview

##### Project Type and Purpose
- This is a full-stack, single-page admin dashboard built with Next.js (app router), designed to manage multiple e-commerce stores.

##### File Structure Analysis
- “src/app”: Next.js app-router routes, broken into route groups:
- (auth): sign-in/sign-up pages and components.
- (root): public landing page.
- api: Next.js serverless API routes mirroring the dashboard paths.
- “src/components”: shared UI components (modals, tables, forms, navigation).
- “src/lib”: infrastructure clients (Prisma DB, AWS S3 client, Stripe, email, utility functions).
- “src/prisma”: database schema and seed scripts.
- “src/hooks” & “src/providers”: React custom hooks and context providers for UI state (modal, theme, toast).
- Configuration files: Dockerfile, next.config.js, tsconfig.json, tailwind.config.js, Prisma schema.

##### Key Architecture Insights from README
- Next.js handles SSR/SSG and serverless API routes in the same codebase.
- Authentication through Clerk with OAuth2 and email/password.
- PostgreSQL managed via AWS RDS, accessed via Prisma ORM.
- AWS S3 stores image assets.
- Stripe manages payments, and a custom email service sends order confirmations.
- Tailwind and Shadcn UI for styling.

a. Main Components
- Browser/Client (Admin UI)
- Next.js App (Front-end pages & layouts)
- Next.js API Routes (serverless functions under src/app/api)
- Authentication Service (Clerk)
- PostgreSQL Database (AWS RDS via Prisma)
- Object Storage (AWS S3 via aws-client)
- Payment Gateway (Stripe via stripe.ts)
- Email Service (e.g. AWS SES via sendEmail.ts)
b. Interactions
- User → Admin UI (React pages)
- Admin UI ↔ Clerk (auth flows)
- Admin UI → API Routes (CRUD, data-fetching actions)
- API Routes → Prisma Client → PostgreSQL
- API Routes → AWS S3 for image upload/download
- API Routes → Stripe for payment operations
- API Routes → Email Service for order confirmation
c. Architectural Patterns
- Next.js app router with nested route groups for logical separation (Auth vs Dashboard).
- Serverless functions pattern for each resource (billboards, categories, etc.).
- MVC-style separation:
Model → Prisma + schema.prisma
View → React components (pages & shared UI)
Controller → API route handlers (route.ts files + action functions)
- Context providers for theme, modal, toast (React Context pattern).
d. Technologies & Frameworks
- Next.js (React, app router, serverless API)
- Clerk (authentication)
- Prisma + PostgreSQL (data layer)
- AWS S3 (asset storage)
- Stripe (payments)
- Tailwind CSS + Shadcn UI (styling/components)
- Recharts (charts/data visualization)

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Client (Browser)"
        AdminUI["Admin UI (Next.js Pages & Layouts)"]:::frontend
        PublicLanding["Public Landing Page"]:::frontend
        AuthUI["Authentication UI (Clerk Sign-In/Sign-Up)"]:::frontend
        ClerkButton["Clerk Integration Button"]:::frontend
        SharedUI["Shared UI Components"]:::frontend
        Modals["Shared Modals"]:::frontend
        DataComps["Data Tables & Alerts"]:::frontend
        Nav["Store Switcher & Navigation"]:::frontend
        Providers["Context Providers (Theme, Modal, Toast)"]:::frontend
        Hooks["Custom Hooks"]:::frontend
        DashboardPages["Dashboard Pages (per-store routes)"]:::frontend
    end

    subgraph "Server (Next.js Runtime)"
        Pages["Next.js Pages & Layouts"]:::backend
        APIRoutes["Next.js API Routes"]:::backend
        PrismaClient["Prisma Client"]:::backend
        AWSClient["AWS S3 Client"]:::backend
        StripeLib["Stripe Integration"]:::backend
        EmailLib["Email Service"]:::backend
        Utils["Utility Functions"]:::backend
    end

    subgraph "Services"
        Clerk["Clerk Auth Service"]:::external
        Postgres["AWS RDS (PostgreSQL)"]:::database
        S3["AWS S3 (Image Storage)"]:::database
        StripeSrv["Stripe (Payment)"]:::external
        EmailSrv["Email Service"]:::external
    end

    AdminUI --> Pages
    DashboardPages --> Pages
    AuthUI --> Pages
    Pages --> APIRoutes
    AdminUI --> APIRoutes
    Providers --> AdminUI
    Hooks --> AdminUI
    SharedUI --> AdminUI
    Modals --> AdminUI
    DataComps --> AdminUI
    Nav --> AdminUI

    AuthUI -->|auth flow| Clerk
    ClerkButton --> Clerk

    APIRoutes --> PrismaClient
    PrismaClient --> Postgres

    APIRoutes --> AWSClient
    AWSClient --> S3

    APIRoutes --> StripeLib
    StripeLib --> StripeSrv

    APIRoutes --> EmailLib
    EmailLib --> EmailSrv

    click AdminUI "https://github.com/kpirabaharan/e-commerce-admin-dashboard/tree/master/src/app"
    click PublicLanding "https://github.com/kpirabaharan/e-commerce-admin-dashboard/blob/master/src/app/(root)/page.tsx"
    click AuthUI "https://github.com/kpirabaharan/e-commerce-admin-dashboard/tree/master/src/app/(auth)"
    click ClerkButton "https://github.com/kpirabaharan/e-commerce-admin-dashboard/blob/master/src/components/ClerkButton.tsx"
    click SharedUI "https://github.com/kpirabaharan/e-commerce-admin-dashboard/tree/master/src/components/ui"
    click Modals "https://github.com/kpirabaharan/e-commerce-admin-dashboard/tree/master/src/components/modals"
    click DataComps "https://github.com/kpirabaharan/e-commerce-admin-dashboard/blob/master/src/components/DataTable.tsx"
    click Nav "https://github.com/kpirabaharan/e-commerce-admin-dashboard/blob/master/src/components/StoreSwitcher.tsx"
    click Providers "https://github.com/kpirabaharan/e-commerce-admin-dashboard/blob/master/src/providers/ModalProvider.tsx"
    click Hooks "https://github.com/kpirabaharan/e-commerce-admin-dashboard/blob/master/src/hooks/useAlertModal.ts"
    click DashboardPages "https://github.com/kpirabaharan/e-commerce-admin-dashboard/tree/master/src/app/(dashboard)/[storeId]"
    click Pages "https://github.com/kpirabaharan/e-commerce-admin-dashboard/tree/master/src/app"
    click APIRoutes "https://github.com/kpirabaharan/e-commerce-admin-dashboard/tree/master/src/app/api"
    click PrismaClient "https://github.com/kpirabaharan/e-commerce-admin-dashboard/blob/master/src/lib/prismadb.ts"
    click AWSClient "https://github.com/kpirabaharan/e-commerce-admin-dashboard/blob/master/src/lib/aws-client.ts"
    click StripeLib "https://github.com/kpirabaharan/e-commerce-admin-dashboard/blob/master/src/lib/stripe.ts"
    click EmailLib "https://github.com/kpirabaharan/e-commerce-admin-dashboard/blob/master/src/lib/sendEmail.ts"

    classDef frontend fill:#d0e6ff,stroke:#0366d6,color:#000;
    classDef backend fill:#d4f8d4,stroke:#2f6627,color:#000;
    classDef database fill:#ffe4b3,stroke:#c47f00,color:#000;
    classDef external fill:#f0e0ff,stroke:#803c99,color:#000;
```
