# harshyadav812/nextjs-ecommerce-store architecture

> Architecture diagram of the GitHub repository harshyadav812/nextjs-ecommerce-store, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harshyadav812/nextjs-ecommerce-store
- Repository: https://github.com/harshyadav812/nextjs-ecommerce-store

## Overview

##### Project type and purpose
- This is a full-stack, multi-tenant e-commerce marketplace built with Next.js 15 (App Router), Payload CMS, tRPC, MongoDB, and Stripe.
- Vendors get isolated “stores” under subdomains; customers browse, add to cart, and checkout.

##### File structure
- src/app/(app): public storefront pages (home, auth, library, tenants’ store fronts)
- src/app/(payload): Payload CMS admin UI and GraphQL/REST playground under /admin and /api
- src/collections: Payload collection schemas (Users, Products, Orders, Tenants, etc.)
- src/modules: feature modules (auth, products, checkout, tenants, library, categories, reviews, tags) each exposing tRPC procedures and UI components
- src/trpc: tRPC server setup, client, routers, and initialization
- src/lib & src/hooks: shared utilities (Stripe helper, access control, custom hooks)
- API routes:
- /api/stripe/webhooks – Stripe webhook receiver
- /api/trpc – tRPC endpoint
- /api/graphql – Payload CMS GraphQL API
- Middleware.ts supports multi-tenant context and auth

##### README for additional insights
- Multi-tenancy with complete data isolation per vendor
- Type-safe API via tRPC, prefetching and SSR in Next.js, N+1 query optimization
- Stripe payment flow with platform fee and vendor payout
- Tech stack confirms Next.js (React), Payload CMS, tRPC, MongoDB, Stripe

a. Main components
- Web Client (Next.js App Router) – SSR & CSR, React components
- State & Data Layer – TanStack Query, Zustand
- API Layer –
◦ tRPC server (procedures in src/modules/*/server)
◦ Payload CMS API (collections in src/collections, payload.config.ts)
◦ Stripe Webhooks handler (/api/stripe/webhooks)
- Database – MongoDB
- External Services – Stripe (payments, webhooks)
- Admin Panel – Payload CMS UI under /admin
b. Relationships & interactions
- User → Next.js pages → data fetch via tRPC calls or direct Payload GraphQL/REST
- tRPC server → calls business logic (modules/*/server/procedures) → reads/writes MongoDB
- Checkout flow: Next.js client invokes Stripe Checkout Session → redirect to Stripe → success/failure → Stripe Webhook → Next.js API writes Order to DB and triggers notifications
- Admin user → Payload CMS UI → CRUD on collections → MongoDB
c. Architectural patterns & principles
- Multi-tenant isolation: context determined from subdomain/slug (middleware.ts)
- Modular monolith: feature-based modules with clear separation (auth, products, checkout, tenants, etc.)
- Type-safe end-to-end: shared types between frontend and tRPC backend
- Server Components for SSR, Client Components for interactive UI
d. Key technologies & frameworks
- Next.js App Router, React Server/Client Components
- tRPC 11 for API
- Payload CMS 3 for headless CMS and admin
- MongoDB for persistence
- Stripe for payments
- TanStack Query & Zustand for client-side state and caching
- Tailwind CSS for styling

##### Elements
- Admin panel separately under “Payload CMS UI”

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Client Side (Next.js)"
        FS["Public Storefront"]:::frontend
        AuthSignIn["Sign-In Page"]:::frontend
        AuthSignUp["Sign-Up Page"]:::frontend
        HomeCat["Home & Category"]:::frontend
        Library["Library Pages"]:::frontend
        TenantSF["Tenant Storefront & Checkout"]:::frontend
    end

    subgraph "API Layer"
        Middleware["middleware.ts (Tenant Context)"]:::middleware
        TRPCClient["tRPC Client"]:::api
        TRPCServer["tRPC Server"]:::api
        PayloadAPI["Payload CMS API"]:::api
        StripeWebhook["Stripe Webhook Handler"]:::api
        AdminUI["Payload CMS UI"]:::api
        CMSConfig["Payload Config & Types"]:::api
    end

    DB["MongoDB"]:::db
    Stripe["Stripe (Payments)"]:::external

    FS -->|"fetch data via tRPC"| TRPCClient
    AuthSignIn -->|"call auth"| TRPCClient
    AuthSignUp -->|"call auth"| TRPCClient
    HomeCat -->|"fetchProducts()"| TRPCClient
    Library -->|"fetchLibrary()"| TRPCClient
    TenantSF -->|"createCheckoutSession()"| TRPCClient

    TRPCClient -->|forward requests| Middleware
    Middleware --> TRPCServer
    TRPCServer -->|"invoke procedures"| DB

    FS -->|"fetch content"| PayloadAPI
    PayloadAPI -->|"CRUD operations"| DB
    AdminUI -->|"manage content"| PayloadAPI

    TenantSF -->|redirect to Stripe Checkout| Stripe
    Stripe -->|webhook event| StripeWebhook
    StripeWebhook -->|"recordOrder()"| DB

    classDef frontend fill:#D0E8FF,stroke:#81BFFF
    classDef api fill:#DFF7DF,stroke:#76CF8F
    classDef db fill:#EFEFEF,stroke:#CCCCCC,stroke-width:2px
    classDef external fill:#FFE6CC,stroke:#FFB366
    classDef middleware fill:#FFF4E6,stroke:#FFD699,stroke-dasharray:5 5

    click FS "https://github.com/harshyadav812/nextjs-ecommerce-store/tree/main/src/app/(app)"
    click AuthSignIn "https://github.com/harshyadav812/nextjs-ecommerce-store/blob/main/src/app/(app)/(auth)/sign-in/page.tsx"
    click AuthSignUp "https://github.com/harshyadav812/nextjs-ecommerce-store/blob/main/src/app/(app)/(auth)/sign-up/page.tsx"
    click HomeCat "https://github.com/harshyadav812/nextjs-ecommerce-store/tree/main/src/app/(app)/(home)"
    click Library "https://github.com/harshyadav812/nextjs-ecommerce-store/tree/main/src/app/(app)/(library)"
    click TenantSF "https://github.com/harshyadav812/nextjs-ecommerce-store/tree/main/src/app/(app)/(tenants)/tenants/[slug]"

    click TRPCServer "https://github.com/harshyadav812/nextjs-ecommerce-store/blob/main/src/trpc/server.tsx"
    click TRPCServer "https://github.com/harshyadav812/nextjs-ecommerce-store/blob/main/src/trpc/routers/_app.ts"
    click TRPCServer "https://github.com/harshyadav812/nextjs-ecommerce-store/blob/main/src/trpc/init.ts"
    click TRPCClient "https://github.com/harshyadav812/nextjs-ecommerce-store/blob/main/src/trpc/client.tsx"
    click TRPCClient "https://github.com/harshyadav812/nextjs-ecommerce-store/blob/main/src/trpc/query-client.ts"
    click StripeWebhook "https://github.com/harshyadav812/nextjs-ecommerce-store/blob/main/src/app/(app)/api/stripe/webhooks/route.ts"
    click PayloadAPI "https://github.com/harshyadav812/nextjs-ecommerce-store/blob/main/src/app/(payload)/api/[...slug]/route.ts"
    click PayloadAPI "https://github.com/harshyadav812/nextjs-ecommerce-store/blob/main/src/app/(payload)/api/graphql/route.ts"
    click PayloadAPI "https://github.com/harshyadav812/nextjs-ecommerce-store/blob/main/src/app/(payload)/api/graphql-playground/route.ts"
    click AdminUI "https://github.com/harshyadav812/nextjs-ecommerce-store/blob/main/src/app/(payload)/admin/[[...segments]]/page.tsx"
    click CMSConfig "https://github.com/harshyadav812/nextjs-ecommerce-store/blob/main/src/payload.config.ts"
    click CMSConfig "https://github.com/harshyadav812/nextjs-ecommerce-store/blob/main/src/payload-types.ts"
```
