# yunmeiye/food-ordering-app architecture

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

- Interactive diagram: https://gitdiagram.com/yunmeiye/food-ordering-app
- Repository: https://github.com/yunmeiye/food-ordering-app

## Overview

##### Project type and purpose
- This is a full-stack food ordering web application (“Pizza Fiesta”) built with Next.js 14 (React), MongoDB, and Tailwind CSS.
- It provides a customer-facing menu/browsing and cart experience, user authentication (NextAuth), Stripe payments, plus an admin dashboard for managing users, orders, menu items, and categories.

##### File structure
- Top-level Next.js config files (next.config.js, tsconfig.json, tailwind.config.ts).
- “/src/app”: uses Next.js App Router. Contains:
- Pages under routes (e.g. /menu, /cart, /login, /register, /profile, /orders, /admin features).
- API routes in “/src/app/api/*” (auth, categories, menu-items, orders, checkout, register, upload, webhook, users, profile).
- Models (Category, MenuItem, Order, User) in “/src/app/models”.
- Shared globals.css and layout.tsx.
- Utility libraries in “/src/libs” (mongoConnect, datetime), types in “/src/types”, providers in “/src/util”.
- Package files declare dependencies: NextAuth, MongoDB driver, Stripe, EmailJS, Cloudinary, Tailwind, NextUI.

##### README for additional insights
- Features call out external integrations: NextAuth (Email & Google), Stripe, EmailJS, Cloudinary, MongoDB.
- Screenshots show customer UI and admin dashboard UI.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    subgraph "Client: React UI"
        style Client fill:#D0E8FF,stroke:#3B82F6
        Home["Home (page.tsx)"] 
        MenuPage["Menu (menu/page.tsx)"]
        CartPage["Cart (cart/page.tsx)"]
        LoginPage["Login (login/page.tsx)"]
        RegisterPage["Register (register/page.tsx)"]
        ProfilePage["Profile (profile/page.tsx)"]
        OrdersPage["Orders (orders/page.tsx)"]
        OrderDetail["Order Detail (orders/[id]/page.tsx)"]
        AdminUsers["Admin Users (admin/users/page.tsx)"]
        AdminMenuItems["Admin Menu Items (admin/menu-items/page.tsx)"]
    end

    %% Server Layer
    subgraph "Server: Next.js"
        style Server fill:#D1FAE5,stroke:#10B981
        subgraph "SSR/CSR (Next.js App Router)"
            SSR["SSR/CSR Rendering"]
        end
        subgraph "API Routes"
            AuthAPI["Auth (NextAuth)"] 
            RegisterAPI["Register"]
            ProfileAPI["Profile"]
            UsersAPI["Users"]
            CategoriesAPI["Categories"]
            MenuItemsAPI["Menu-Items"]
            OrdersAPI["Orders"]
            CheckoutAPI["Checkout"]
            UploadAPI["Upload"]
            WebhookAPI["Webhook"]
        end
    end

    %% Database Layer
    subgraph "Database: MongoDB"
        style DB fill:#F3F4F6,stroke:#9CA3AF
        MongoDB[(MongoDB Atlas)]
        subgraph "Models"
            UserModel["User.ts"]
            CategoryModel["Category.ts"]
            MenuItemModel["MenuItem.ts"]
            OrderModel["Order.ts"]
        end
    end

    %% External Services
    subgraph "External Services"
        style External fill:#FFEDD5,stroke:#F97316
        OAuth["Google OAuth / Email"]
        Stripe["Stripe Payments"]
        EmailJS["EmailJS"]
        Cloudinary["Cloudinary"]
    end

    %% Connections
    Home -->|renders via SSR| SSR
    MenuPage -->|navigates| SSR
    CartPage -->|navigates| SSR
    LoginPage -->|navigates| SSR
    RegisterPage -->|navigates| SSR
    ProfilePage -->|navigates| SSR
    OrdersPage -->|navigates| SSR
    OrderDetail -->|navigates| SSR
    AdminUsers -->|navigates| SSR
    AdminMenuItems -->|navigates| SSR

    SSR -->|fetch| AuthAPI
    SSR -->|fetch| RegisterAPI
    SSR -->|fetch| ProfileAPI
    SSR -->|fetch| UsersAPI
    SSR -->|fetch| CategoriesAPI
    SSR -->|fetch| MenuItemsAPI
    SSR -->|fetch| OrdersAPI
    SSR -->|fetch| CheckoutAPI
    SSR -->|fetch| UploadAPI

    AuthAPI -->|CRUD| MongoDB
    RegisterAPI -->|CRUD| MongoDB
    ProfileAPI -->|CRUD| MongoDB
    UsersAPI -->|CRUD| MongoDB
    CategoriesAPI -->|CRUD| MongoDB
    MenuItemsAPI -->|CRUD| MongoDB
    OrdersAPI -->|CRUD| MongoDB
    CheckoutAPI -->|read/write| MongoDB
    UploadAPI -->|read/write| MongoDB
    WebhookAPI -->|read/write| MongoDB

    AuthAPI -->|authenticate| OAuth
    CheckoutAPI -->|process payment| Stripe
    WebhookAPI -->|webhook events| Stripe
    RegisterAPI -->|send email| EmailJS
    ProfileAPI -->|upload image| Cloudinary
    UploadAPI -->|upload image| Cloudinary

    %% Model connections
    UserModel --> MongoDB
    CategoryModel --> MongoDB
    MenuItemModel --> MongoDB
    OrderModel --> MongoDB

    %% Click Events - Client Pages
    click Home "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/page.tsx"
    click MenuPage "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/menu/page.tsx"
    click CartPage "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/cart/page.tsx"
    click LoginPage "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/login/page.tsx"
    click RegisterPage "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/register/page.tsx"
    click ProfilePage "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/profile/page.tsx"
    click OrdersPage "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/orders/page.tsx"
    click OrderDetail "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/orders/[id]/page.tsx"
    click AdminUsers "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/users/page.tsx"
    click AdminMenuItems "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/menu-items/page.tsx"

    %% Click Events - API Routes
    click AuthAPI "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/api/auth/[...nextauth]/route.ts"
    click RegisterAPI "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/api/register/route.ts"
    click ProfileAPI "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/api/profile/route.ts"
    click UsersAPI "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/api/users/route.ts"
    click CategoriesAPI "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/api/categories/route.ts"
    click MenuItemsAPI "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/api/menu-items/route.ts"
    click OrdersAPI "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/api/orders/route.ts"
    click CheckoutAPI "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/api/checkout/route.ts"
    click UploadAPI "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/api/upload/route.ts"
    click WebhookAPI "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/api/webhook/route.ts"

    %% Click Events - Models
    click UserModel "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/models/User.ts"
    click CategoryModel "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/models/Category.ts"
    click MenuItemModel "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/models/MenuItem.ts"
    click OrderModel "https://github.com/yunmeiye/food-ordering-app/blob/main/src/app/models/Order.ts"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#3B82F6
    classDef backend fill:#D1FAE5,stroke:#10B981
    classDef db fill:#F3F4F6,stroke:#9CA3AF
    classDef external fill:#FFEDD5,stroke:#F97316

    class Client frontend
    class SSR,AuthAPI,RegisterAPI,ProfileAPI,UsersAPI,CategoriesAPI,MenuItemsAPI,OrdersAPI,CheckoutAPI,UploadAPI,WebhookAPI backend
    class MongoDB,UserModel,CategoryModel,MenuItemModel,OrderModel db
    class OAuth,Stripe,EmailJS,Cloudinary external
```
