# uhrinandor/restaurant-orders architecture

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

- Interactive diagram: https://gitdiagram.com/uhrinandor/restaurant-orders
- Repository: https://github.com/uhrinandor/restaurant-orders

## Overview

##### Project type and purpose
- This is a full-stack “Restaurant Order” system comprising:
- An Admin web client (Next.js + Apollo + NextAuth)
- A GraphQL API (NestJS + Prisma)
- Multiple MySQL schemas (main, analytics, static)
- Redis cache
- Docker-Compose orchestration
- Purpose: let restaurant owners manage resources (tables, waiters, categories, products, orders) and view analytics.

##### File structure
- Top-level:
- docker-compose.yaml & init/db/init.sql → container orchestration & initial DB seed
- admin/ → Next.js Admin UI
- server/ → NestJS GraphQL API + Prisma + modules + tests
- Admin subdivides into an Apollo layer, Auth pages, Dashboard pages (resources: categories, tables, waiters), shared components.
- Server subdivides into GraphQL modules: resources (address, category, meal, order, etc.), analytics (income, product, waiter), auth, cache, filter, interceptors, Prisma clients for each DB, tests.

##### Extract README insights
- GraphQL API built with NestJS, documented via SpectQL
- Database is MySQL (three schemas), cache is Redis
- Fully containerized; environment variables control DB URLs, Redis URL, JWT secret, CORS domain, API port

a. Admin Client
- Next.js / React App
- Apollo Client + NextAuth → GraphQL endpoint
b. API Server
- NestJS GraphQL Gateway
- Modules / Resolvers / Services
- Guards (JWT, role), Pipes, Filters, Interceptors
c. Data Layer
- Prisma Clients → three MySQL schemas (main, analytics, static)
- Redis Cache service
d. Infrastructure
- Docker-Compose orchestrates:
– MySQL container (init via init.sql)
– Redis container
– NestJS API container
– (Optionally) Prisma migrations container
e. External / Cross-cutting
- Environment Variables (DB URLs, JWT_SECRET, ADMIN_DOMAIN)
- CORS configuration
- SpectQL docs

##### Relationships & interactions
- Admin UI → (HTTP + WebSocket) → GraphQL API
- GraphQL requests pass through Guards → Resolvers → Services → Prisma → MySQL
- Some queries use Redis via Cache Service / Interceptor
- Analytics module reads/writes to analytics DB; core resources use main DB; static data use static DB
- Prisma migrations use the shadow DB URLs
- Docker-Compose links DB & Redis to API container by network

##### Architectural patterns & principles
- Modular monolith in the API: each domain (resources, analytics, auth) is isolated in its own NestJS module
- Separation of concerns: Guards, Pipes, Interceptors handle cross-cutting concerns (auth, validation, caching)
- Repository pattern via Prisma service modules
- Frontend-backend separation: Next.js handles UI; API does business logic & data persistence

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% UI Layer
    subgraph "UI Layer" 
        direction TB
        Admin["Admin Client (Next.js)"]:::ui
        Apollo["Apollo Client"]:::ui
        NextAuth["NextAuth"]:::ui
    end

    Admin -->|"uses"| Apollo
    Admin -->|"auth via"| NextAuth
    Apollo -->|"GraphQL requests"| API

    %% API Layer
    subgraph "API Layer (NestJS)" 
        direction TB
        API["GraphQL API (NestJS Gateway)"]:::api
        AuthModule["Auth Module"]:::api
        ResourcesModule["Resources Modules"]:::api
        AnalyticsModule["Analytics Modules"]:::api
        CacheModule["Cache Service & Interceptor"]:::api
        CrossCut["Pipes/Filters/Interceptors"]:::cross
    end

    API -->|"handles auth"| AuthModule
    API -->|"handles resources"| ResourcesModule
    API -->|"handles analytics"| AnalyticsModule
    API -->|"cache ops"| CacheModule
    API -->|"validation & filters"| CrossCut

    %% Data Layer
    subgraph "Data Layer" 
        direction TB
        PrismaMain["Prisma Client → MySQL (main)"]:::data
        PrismaAnalytics["Prisma Client → MySQL (analytics)"]:::data
        PrismaStatic["Prisma Client → MySQL (static)"]:::data
        Redis["Redis Cache"]:::data
    end

    CacheModule -->|"reads/writes"| Redis
    ResourcesModule -->|"uses"| PrismaMain
    AnalyticsModule -->|"uses"| PrismaAnalytics
    ResourcesModule -->|"static data"| PrismaStatic

    %% Infrastructure
    subgraph "Infrastructure" 
        direction TB
        DockerCompose["Docker-Compose"]:::infra
        DBInit["DB Init Script"]:::infra
        Env["Env Variables & Config"]:::infra
    end

    DockerCompose --> DBInit
    DockerCompose --> Redis
    DockerCompose -->|"networks"| API
    DockerCompose -->|"networks"| PrismaMain
    DockerCompose -->|"networks"| PrismaAnalytics
    DockerCompose -->|"networks"| PrismaStatic
    Env -.->|config for| DockerCompose
    Env -.->|config for| API
    Env -.->|config for| Redis

    %% Click Events
    click Admin "https://github.com/uhrinandor/restaurant-orders/tree/main/admin/src"
    click Apollo "https://github.com/uhrinandor/restaurant-orders/blob/main/admin/src/apollo/index.ts"
    click NextAuth "https://github.com/uhrinandor/restaurant-orders/blob/main/admin/src/app/api/auth/[...nextauth]/route.ts"
    click API "https://github.com/uhrinandor/restaurant-orders/blob/main/server/src/main.ts"
    click AuthModule "https://github.com/uhrinandor/restaurant-orders/blob/main/server/src/auth/auth.module.ts"
    click ResourcesModule "https://github.com/uhrinandor/restaurant-orders/blob/main/server/src/resources/resources.module.ts"
    click AnalyticsModule "https://github.com/uhrinandor/restaurant-orders/blob/main/server/src/analytics/analytics.module.ts"
    click CacheModule "https://github.com/uhrinandor/restaurant-orders/blob/main/server/src/cache/cache.module.ts"
    click CrossCut "https://github.com/uhrinandor/restaurant-orders/blob/main/server/src/pipes/array.pipe.ts"
    click PrismaMain "https://github.com/uhrinandor/restaurant-orders/blob/main/server/src/prisma/main/prisma.main.module.ts"
    click PrismaAnalytics "https://github.com/uhrinandor/restaurant-orders/blob/main/server/src/prisma/analytics/prisma.analytics.module.ts"
    click PrismaStatic "https://github.com/uhrinandor/restaurant-orders/blob/main/server/src/prisma/static/prisma.static.module.ts"
    click Redis "https://github.com/uhrinandor/restaurant-orders/blob/main/docker-compose.yaml"
    click DockerCompose "https://github.com/uhrinandor/restaurant-orders/blob/main/docker-compose.yaml"
    click DBInit "https://github.com/uhrinandor/restaurant-orders/blob/main/init/db/init.sql"
    click Env "https://github.com/uhrinandor/restaurant-orders/blob/main/server/src/config/index.ts"

    %% Styles
    classDef ui fill:#D0E8FF,stroke:#0366d6,color:#0366d6
    classDef api fill:#DFFFE0,stroke:#28a745,color:#28a745
    classDef data fill:#FFF1E0,stroke:#e67700,color:#e67700
    classDef infra fill:#E0E0E0,stroke:#6a737d,color:#6a737d
    classDef cross fill:#F0E0FF,stroke:#6f42c1,color:#6f42c1
```
