# jacobtorr/fresh_coffee_nextjs_typescript architecture

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

- Interactive diagram: https://gitdiagram.com/jacobtorr/fresh_coffee_nextjs_typescript
- Repository: https://github.com/jacobtorr/fresh_coffee_nextjs_typescript

## Overview

##### Project type and purpose
- This is a full-stack e-commerce/ordering application built with Next.js (App Router).
- It provides two main user interfaces:
- Public ordering interface under `/app/order` and `/app/orders`
- Admin dashboard under `/app/admin` for product and order management
- It uses Prisma ORM for database access, Tailwind CSS for styling, and Next.js Server Actions & API Routes for server logic.

##### File structure
- Top-level:
- `app/` – Next.js App Router directory containing layouts, pages, nested routes, and API endpoints
- `components/` – React UI components organized by domain (admin, order, products, ui)
- `actions/` – Next.js Server Actions for create/update/delete operations (e.g., `create-order-action.ts`)
- `prisma/` – Database schema (`schema.prisma`), migrations, seed data
- `src/lib/` – Shared libraries (`prisma.ts` for Prisma client, `store.ts` for Zustand store)
- `public/` – Static assets (product images)
- Config files: `next.config.mjs`, ESLint, Tailwind, TypeScript, environment (`.env`)
- Patterns & conventions:
- App Router nested layouts for admin vs. public views
- Server Actions under `actions/` for in-place mutation logic
- API Routes under `app/.../api/route.ts` for REST endpoints
- Prisma client instantiated once and shared via `src/lib/prisma.ts`

##### Additional README insights
- Standard Next.js bootstrap README; no custom architecture docs included.

a. Main components
1. Browser (Client)
2. Next.js Server (App Router + React SSR/SSG + Server Actions + API Routes)
3. Prisma ORM layer
4. Relational Database (PostgreSQL/MySQL)
5. Static Asset Store (public folder)
6. Optional: Vercel (deployment)
b. Relationships & interactions
- User → Next.js Server:
- HTTP GET page requests → SSR or SSG via App Router
- HTTP POST/PUT/DELETE via Server Actions or API Routes
- Next.js Server → Prisma Client: query/mutate DB
- Prisma Client → Database: SQL queries
- Next.js Server → Assets: serve static files from `public/`
c. Architectural patterns
- Separation of concerns: UI components (React) vs. server logic (Server Actions & API Routes)
- Nested routing/layouts in App Router for role-based access (admin vs. public)
- Centralized DB access via Prisma client instance
d. Key technologies
- Next.js 13 App Router, React 18
- Server Actions (TypeScript)
- API Routes (`route.ts`)
- Prisma ORM + migrations/seed
- Tailwind CSS
- Zustand (optional store in `src/lib/store.ts`)
- Deployment on Vercel (implied)

##### Detail
- Break the server layer into sub-components:
- App Router (layouts, pages)
- Server Actions (`actions/`)
- API Routes (`app/.../api/route.ts`)
- Nested routing for admin vs. order flows.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Clients
    PublicUser["Public User (Browser)"]:::frontend
    AdminUser["Admin User (Browser)"]:::frontend

    %% Next.js Server Layer
    subgraph "Next.js Server" 
        direction TB
        subgraph "App Router (SSR/SSG)" 
            direction TB
            ORiderLayout["app/order/layout.tsx"]:::server
            CategoryPage["app/order/[category]/page.tsx"]:::server
            OrdersPage["app/orders/page.tsx"]:::server
            AdminLayout["app/admin/layout.tsx"]:::server
            AdminOrdersPage["app/admin/orders/page.tsx"]:::server
            AdminProductsPage["app/admin/products/page.tsx"]:::server
            NewProductPage["app/admin/products/new/page.tsx"]:::server
            EditProductPage["app/admin/products/[id]/edit/page.tsx"]:::server
        end

        subgraph "API Routes" 
            direction TB
            OrdersApi["app/orders/api/route.tsx"]:::api
            AdminOrdersApi["app/admin/orders/api/route.ts"]:::api
        end

        subgraph "Server Actions" 
            direction TB
            CreateOrder["actions/create-order-action.ts"]:::server
            CompleteOrder["actions/complete-order-action.ts"]:::server
            CreateProduct["actions/create-product-action.ts"]:::server
            UpdateProduct["actions/update-product-action.ts"]:::server
            DeleteProduct["actions/delete-product-action.ts"]:::server
        end

        subgraph "Prisma ORM Layer" 
            direction TB
            PrismaClient["src/lib/prisma.ts"]:::server
            Schema["prisma/schema.prisma"]:::db
            Migrations["prisma/migrations/"]:::db
            Seed["prisma/seed.ts"]:::db
        end

        StaticAssets["public/products/"]:::assets
    end

    %% UI Components
    subgraph "UI Components" 
        direction TB
        OrderSidebar["components/order/OrderSidebar.tsx"]:::components
        OrderSummary["components/order/OrderSummary.tsx"]:::components
        LatestOrderItem["components/order/LatestOrderItem.tsx"]:::components
        ProductDetails["components/order/ProductDetails.tsx"]:::components
        AdminSidebar["components/admin/AdminSidebar.tsx"]:::components
        OrderCard["components/admin/OrderCard.tsx"]:::components
        AdminRoute["components/admin/AdminRoute.tsx"]:::components
        ProductCard["components/products/ProductCard.tsx"]:::components
        AddProductForm["components/products/AddProductForm.tsx"]:::components
        EditProductForm["components/products/EditProductForm.tsx"]:::components
        CategoryIcon["components/ui/CategoryIcon.tsx"]:::components
        Logo["components/ui/Logo.tsx"]:::components
        GoBackButton["components/ui/GoBackButton.tsx"]:::components
        Heading["components/ui/Heading.tsx"]:::components
        ToastNotification["components/ui/ToastNotification.tsx"]:::components
    end

    %% Database
    Database["Relational Database"]:::db

    %% Connections
    PublicUser -->|GET/POST requests| ORiderLayout
    PublicUser -->|GET requests| OrdersPage
    AdminUser -->|GET/POST requests| AdminLayout
    ORiderLayout -->|"renders pages"| CategoryPage
    AdminLayout -->|"renders pages"| AdminOrdersPage
    AdminLayout -->|"renders pages"| AdminProductsPage
    AdminLayout -->|"renders pages"| NewProductPage
    AdminLayout -->|"renders pages"| EditProductPage

    OrdersPage -->|fetch via API| OrdersApi
    AdminOrdersPage -->|fetch via API| AdminOrdersApi

    CategoryPage -->|calls Server Actions| CreateOrder
    AdminProductsPage -->|calls Server Actions| CreateProduct
    NewProductPage -->|calls Server Actions| CreateProduct
    EditProductPage -->|calls Server Actions| UpdateProduct
    AdminProductsPage -->|calls Server Actions| DeleteProduct
    AdminOrdersPage -->|calls Server Actions| CompleteOrder

    ORiderLayout -->|"uses components"| OrderSidebar
    ORiderLayout --> OrderSummary
    ORiderLayout --> LatestOrderItem
    ORiderLayout --> ProductDetails
    AdminLayout --> AdminSidebar
    AdminLayout --> OrderCard
    AdminLayout --> AdminRoute
    AdminProductsPage --> ProductCard
    AdminProductsPage --> AddProductForm
    EditProductPage --> EditProductForm
    ORiderLayout --> CategoryIcon
    ORiderLayout --> Logo
    ORiderLayout --> GoBackButton
    ORiderLayout --> Heading
    ORiderLayout --> ToastNotification

    OrdersApi --> PrismaClient
    AdminOrdersApi --> PrismaClient
    CreateOrder --> PrismaClient
    CompleteOrder --> PrismaClient
    CreateProduct --> PrismaClient
    UpdateProduct --> PrismaClient
    DeleteProduct --> PrismaClient

    PrismaClient -->|executes SQL| Database
    StaticAssets -->|serves files| PublicUser
    StaticAssets -->|serves files| AdminUser

    %% Click Events
    click ORiderLayout "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/app/order/layout.tsx"
    click CategoryPage "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/app/order/[category]/page.tsx"
    click OrdersPage "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/app/orders/page.tsx"
    click OrdersApi "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/app/orders/api/route.tsx"
    click AdminLayout "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/app/admin/layout.tsx"
    click AdminOrdersPage "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/app/admin/orders/page.tsx"
    click AdminOrdersApi "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/app/admin/orders/api/route.ts"
    click AdminProductsPage "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/app/admin/products/page.tsx"
    click NewProductPage "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/app/admin/products/new/page.tsx"
    click EditProductPage "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/app/admin/products/[id]/edit/page.tsx"
    click CreateOrder "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/actions/create-order-action.ts"
    click CompleteOrder "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/actions/complete-order-action.ts"
    click CreateProduct "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/actions/create-product-action.ts"
    click UpdateProduct "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/actions/update-product-action.ts"
    click DeleteProduct "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/actions/delete-product-action.ts"
    click PrismaClient "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/src/lib/prisma.ts"
    click Schema "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/prisma/schema.prisma"
    click Migrations "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/tree/main/prisma/migrations/"
    click Seed "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/prisma/seed.ts"
    click StaticAssets "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/tree/main/public/products/"
    click OrderSidebar "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/components/order/OrderSidebar.tsx"
    click OrderSummary "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/components/order/OrderSummary.tsx"
    click LatestOrderItem "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/components/order/LatestOrderItem.tsx"
    click ProductDetails "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/components/order/ProductDetails.tsx"
    click AdminSidebar "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/components/admin/AdminSidebar.tsx"
    click OrderCard "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/components/admin/OrderCard.tsx"
    click AdminRoute "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/components/admin/AdminRoute.tsx"
    click ProductCard "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/components/products/ProductCard.tsx"
    click AddProductForm "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/components/products/AddProductForm.tsx"
    click EditProductForm "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/components/products/EditProductForm.tsx"
    click CategoryIcon "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/components/ui/CategoryIcon.tsx"
    click Logo "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/components/ui/Logo.tsx"
    click GoBackButton "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/components/ui/GoBackButton.tsx"
    click Heading "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/components/ui/Heading.tsx"
    click ToastNotification "https://github.com/jacobtorr/fresh_coffee_nextjs_typescript/blob/main/components/ui/ToastNotification.tsx"

    %% Styles
    classDef frontend fill:#E3F2FD,stroke:#90CAF9,color:#0D47A1;
    classDef server fill:#E8F5E9,stroke:#A5D6A7,color:#1B5E20;
    classDef api fill:#FFF3E0,stroke:#FFCC80,color:#E65100;
    classDef db fill:#F3E5F5,stroke:#CE93D8,color:#4A148C;
    classDef assets fill:#FBE9E7,stroke:#FFAB91,color:#BF360C;
    classDef components fill:#ECEFF1,stroke:#B0BEC5,color:#37474F;
```
