# m-asadjaved/medsonline4u architecture

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

- Interactive diagram: https://gitdiagram.com/m-asadjaved/medsonline4u
- Repository: https://github.com/m-asadjaved/medsonline4u

## Overview

##### Project Type and Purpose
- This is a full-stack Next.js e-commerce application with two primary “domains”:
a. Public storefront (“home”) where customers browse products, add to cart, checkout, contact, etc.
b. Admin panel (“admin”) where site administrators manage products, orders, and images.
- The app also provides a set of built-in REST-style API routes (`src/app/api/...`) for data operations.

##### Key Architectural Components
a. Presentation Layer (Frontend)
- Next.js React pages and layout files under `src/app/(home)` and `src/app/(admin)`.
- Shared UI primitives in `src/components/ui`, high-level components in `src/components`.
- Cart context provider (`src/context/CartContext.js`) and custom React hooks (`src/hooks/use-mobile.js`).
b. API Layer (Backend endpoints)
- Next.js API routes in `src/app/api`, organized by domain (products, orders, auth, contact, admin/images).
- Each route implements CRUD or action logic under `/route.js`.
c. Business Logic & Data Access
- Utility and data-access modules in `src/lib`:
- `mysql.js` for MySQL connection and queries
- `redis.js` for caching/session management
- `limiter.js` / `ip.js` for rate-limiting and security
- `users.js` for authentication logic
d. Data Stores & External Services
- MySQL database as primary persistent store (products, orders, users).
- Redis for caching cart sessions or rate-limit counters.
- Cloud storage (S3 or Vercel’s built-in asset storage) for admin image uploads.
- Email/contact service or leads store for contact form submissions.
e. Hosting/Deployment
- Deployed on Vercel, leveraging serverless functions for API routes, automatic SSR/SSG.

##### Relationships and Data Flows
a. Browser → Next.js Frontend
- Users navigate public pages (SSR/SSG) or admin pages (protected via auth).
- UI components fetch data client-side via fetch/XHR to API routes.
b. Frontend ↔ API Layer
- REST calls to endpoints like `/api/products`, `/api/orders/new`, `/api/admin/products/save`.
- Auth route `/api/auth` issues tokens/cookies.
c. API Layer → Data Stores
- API logic invokes `src/lib/mysql.js` for SQL queries.
- Caching or session data via `src/lib/redis.js`.
- Image uploads handled by admin API routes writing to cloud storage.
d. Admin Panel → Image Storage & Admin APIs
- ImageManagerClient uploads images via `/api/admin/images/upload`, lists via `/list`, deletes via `/delete`.

##### Architectural Patterns and Principles
- Separation of Concerns: clear split between UI components, API endpoints, and data-access layers.
- Modular React Components & composition via `src/components/ui`.
- Domain-driven API route organization (products, orders, auth, shipping, contact).
- Serverless Functions pattern: each Next.js API route is its own micro-endpoint.
- Context API for global state (shopping cart).
- Rate limiting and security at edge (lib/limiter, ip).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    subgraph "Client (Browser)"
        direction TB
        Browser["Browser"]:::client
        PublicStore["Public Storefront\n(SSR/SSG, React Pages)"]:::client
        AdminPanel["Admin Panel\n(SSR/SSG, React Pages)"]:::client
        UIPrimitives["UI Primitives\n(src/components/ui)"]:::client
        SharedComponents["Shared Components\n(src/components)"]:::client
        CartContext["Cart Context\n(src/context/CartContext.js)"]:::client
        UseMobile["useMobile Hook\n(src/hooks/use-mobile.js)"]:::client
    end

    %% Serverless API Layer
    subgraph "Serverless API Layer"
        direction TB
        %% Public APIs
        subgraph "Public APIs" 
            direction TB
            ProductsAPI["Products API\n(src/app/api/products)"]:::api
            SingleProductAPI["Product Detail API\n(src/app/api/products/[slug]/route.js)"]:::api
            CartAPI["Cart API\n(src/app/api/products/cart/route.js)"]:::api
            SearchAPI["Product Search API\n(src/app/api/products/search/route.js)"]:::api
            ShopAPI["Shop Pagination API\n(src/app/api/products/shop)"]:::api
            OrdersAPI["Orders API\n(src/app/api/orders)"]:::api
            NewOrderAPI["New Order API\n(src/app/api/orders/new/route.js)"]:::api
            CategoriesAPI["Categories API\n(src/app/api/categories/route.js)"]:::api
            ContactAPI["Contact API\n(src/app/api/contact/route.js)"]:::api
            LeadsAPI["Leads API\n(src/app/api/contact/leads/route.js)"]:::api
            AuthAPI["Auth API\n(src/app/api/auth/route.js)"]:::api
        end
        %% Admin APIs
        subgraph "Admin APIs"
            direction TB
            ImgUploadAPI["Image Upload API\n(src/app/api/admin/images/upload/route.js)"]:::api
            ImgListAPI["Image List API\n(src/app/api/admin/images/list/route.js)"]:::api
            ImgDeleteAPI["Image Delete API\n(src/app/api/admin/images/delete/route.js)"]:::api
            AdminProdAPI["Admin Products API\n(src/app/api/admin/products/route.js)"]:::api
            AdminProdSaveAPI["Save Product API\n(src/app/api/admin/products/save/route.js)"]:::api
            AdminProdDelAPI["Delete Product API\n(src/app/api/admin/products/delete/[id]/route.js)"]:::api
            AdminProdVerAPI["Verify Product API\n(src/app/api/admin/products/verify/[slug]/route.js)"]:::api
            AdminOrdersAPI["Admin Orders API\n(src/app/api/admin/orders/route.js)"]:::api
        end
        %% Data Access Modules
        subgraph "Data Access & Logic\n(src/lib)"
            direction TB
            MySQLMod["MySQL Module\n(src/lib/mysql.js)"]:::logic
            RedisMod["Redis Module\n(src/lib/redis.js)"]:::logic
            LimiterMod["Rate Limiter\n(src/lib/limiter.js)"]:::logic
            IPMod["IP Security\n(src/lib/ip.js)"]:::logic
            UsersMod["User Auth Logic\n(src/lib/users.js)"]:::logic
            UtilsMod["Utilities\n(src/lib/utils.js)"]:::logic
        end
    end

    %% Data Stores
    subgraph "Data Stores"
        direction TB
        MySQLDB["MySQL Database"]:::db
        RedisCache["Redis Cache"]:::db
    end

    %% External Services
    subgraph "External Services"
        direction TB
        CloudStorage["Cloud Storage\n(S3/Vercel Assets)"]:::external
        EmailService["Email/Contact Service"]:::external
    end

    %% Connections - Client to Frontend
    Browser -->|SSR/SSG| PublicStore
    Browser -->|SSR/SSG| AdminPanel
    PublicStore -->|uses| UIPrimitives
    PublicStore -->|uses| SharedComponents
    PublicStore -->|wraps with| CartContext
    PublicStore -->|uses| UseMobile
    AdminPanel -->|uses| UIPrimitives
    AdminPanel -->|uses| SharedComponents

    %% Client to API
    PublicStore -->|fetch /api/products etc.| ProductsAPI
    PublicStore -->|fetch /api/orders/new| NewOrderAPI
    AdminPanel -->|fetch /api/admin/...| ImgUploadAPI
    AdminPanel -->|fetch /api/admin/...| AdminProdAPI

    %% API to Data Access
    subgraph _API2Logic_
        ProductsAPI --> MySQLMod
        SingleProductAPI --> MySQLMod
        CartAPI --> RedisMod
        SearchAPI --> MySQLMod
        ShopAPI --> MySQLMod
        OrdersAPI --> MySQLMod
        NewOrderAPI --> MySQLMod
        CategoriesAPI --> MySQLMod
        ContactAPI --> UsersMod
        LeadsAPI --> UsersMod
        AuthAPI --> UsersMod
        ImgUploadAPI --> UtilsMod
        ImgListAPI --> UtilsMod
        ImgDeleteAPI --> UtilsMod
        AdminProdAPI --> MySQLMod
        AdminProdSaveAPI --> MySQLMod
        AdminProdDelAPI --> MySQLMod
        AdminProdVerAPI --> MySQLMod
        AdminOrdersAPI --> MySQLMod
    end

    %% Data Access to Data Stores
    MySQLMod --> MySQLDB
    RedisMod --> RedisCache
    %% External flows
    ImgUploadAPI -->|uploads| CloudStorage
    ContactAPI -->|sends emails| EmailService

    %% Click Events
    click PublicStore "https://github.com/m-asadjaved/medsonline4u/tree/master/src/app/(home)"
    click AdminPanel "https://github.com/m-asadjaved/medsonline4u/tree/master/src/app/(admin)"
    click UIPrimitives "https://github.com/m-asadjaved/medsonline4u/tree/master/src/components/ui"
    click SharedComponents "https://github.com/m-asadjaved/medsonline4u/tree/master/src/components"
    click CartContext "https://github.com/m-asadjaved/medsonline4u/blob/master/src/context/CartContext.js"
    click UseMobile "https://github.com/m-asadjaved/medsonline4u/blob/master/src/hooks/use-mobile.js"
    click ProductsAPI "https://github.com/m-asadjaved/medsonline4u/tree/master/src/app/api/products"
    click SingleProductAPI "https://github.com/m-asadjaved/medsonline4u/blob/master/src/app/api/products/[slug]/route.js"
    click CartAPI "https://github.com/m-asadjaved/medsonline4u/blob/master/src/app/api/products/cart/route.js"
    click SearchAPI "https://github.com/m-asadjaved/medsonline4u/blob/master/src/app/api/products/search/route.js"
    click ShopAPI "https://github.com/m-asadjaved/medsonline4u/tree/master/src/app/api/products/shop"
    click OrdersAPI "https://github.com/m-asadjaved/medsonline4u/tree/master/src/app/api/orders"
    click NewOrderAPI "https://github.com/m-asadjaved/medsonline4u/blob/master/src/app/api/orders/new/route.js"
    click CategoriesAPI "https://github.com/m-asadjaved/medsonline4u/blob/master/src/app/api/categories/route.js"
    click ContactAPI "https://github.com/m-asadjaved/medsonline4u/blob/master/src/app/api/contact/route.js"
    click LeadsAPI "https://github.com/m-asadjaved/medsonline4u/blob/master/src/app/api/contact/leads/route.js"
    click AuthAPI "https://github.com/m-asadjaved/medsonline4u/blob/master/src/app/api/auth/route.js"
    click ImgUploadAPI "https://github.com/m-asadjaved/medsonline4u/blob/master/src/app/api/admin/images/upload/route.js"
    click ImgListAPI "https://github.com/m-asadjaved/medsonline4u/blob/master/src/app/api/admin/images/list/route.js"
    click ImgDeleteAPI "https://github.com/m-asadjaved/medsonline4u/blob/master/src/app/api/admin/images/delete/route.js"
    click AdminProdAPI "https://github.com/m-asadjaved/medsonline4u/blob/master/src/app/api/admin/products/route.js"
    click AdminProdSaveAPI "https://github.com/m-asadjaved/medsonline4u/blob/master/src/app/api/admin/products/save/route.js"
    click AdminProdDelAPI "https://github.com/m-asadjaved/medsonline4u/blob/master/src/app/api/admin/products/delete/[id]/route.js"
    click AdminProdVerAPI "https://github.com/m-asadjaved/medsonline4u/blob/master/src/app/api/admin/products/verify/[slug]/route.js"
    click AdminOrdersAPI "https://github.com/m-asadjaved/medsonline4u/blob/master/src/app/api/admin/orders/route.js"
    click MySQLMod "https://github.com/m-asadjaved/medsonline4u/blob/master/src/lib/mysql.js"
    click RedisMod "https://github.com/m-asadjaved/medsonline4u/blob/master/src/lib/redis.js"
    click LimiterMod "https://github.com/m-asadjaved/medsonline4u/blob/master/src/lib/limiter.js"
    click IPMod "https://github.com/m-asadjaved/medsonline4u/blob/master/src/lib/ip.js"
    click UsersMod "https://github.com/m-asadjaved/medsonline4u/blob/master/src/lib/users.js"
    click UtilsMod "https://github.com/m-asadjaved/medsonline4u/blob/master/src/lib/utils.js"

    %% Styles
    classDef client fill:#d4f7d4,stroke:#4caf50,stroke-width:1px
    classDef api fill:#d0e8ff,stroke:#2196f3,stroke-width:1px
    classDef logic fill:#f0f0f0,stroke:#9e9e9e,stroke-width:1px
    classDef db fill:#eeeeee,stroke:#616161,stroke-width:1px,stroke-dasharray: 2 2
    classDef external fill:#fff3e0,stroke:#ff9800,stroke-width:1px
```
