# khanhtrinh301103/nutrigen_bot architecture

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

- Interactive diagram: https://gitdiagram.com/khanhtrinh301103/nutrigen_bot
- Repository: https://github.com/khanhtrinh301103/nutrigen_bot

## Overview

##### Project Type & Purpose
- Full-stack web application (“NutriGen_Bot”) with a Next.js/React frontend, Firebase Functions backend, Firestore/Auth/Storage, plus a small GraphQL “dataconnect” microservice.
- User-facing features: recipe search, nutrition analysis, chat, blog posts, profile management.
- Admin UI: dashboards, analytics, user/chat/post management.

##### High-level File-Structure & Architectural Clues
Frontend (Next.js + Tailwind + Vercel)
– src/pages: page-level entry points (SSR/SSG)
– src/components & ui: reusable UI primitives (buttons, dialogs, cards)
– src/api: client wrappers for authentication (Firebase Auth), recipeService, chatService, blogService, adminAPI, etc.
Backend (Firebase Functions + dataconnect)
– functions/: Firebase Cloud Functions handlers (index.js registers HTTPS endpoints: searchRecipe, getRecipeDetails, uploadImage, chat, adminStats, etc.)
– dataconnect/: a small GraphQL microservice configured via connector.yaml + .gql files, used to fetch/enhance recipe data.
– src/: server-side business logic (recipeScorer, nutritionSearchProcessor, conflictDetector).
Infra config
– firebase.json & .firebaserc: Firebase project config
– vercel.json & next.config.mjs: Vercel/Next.js deployment

##### Key System Components
A. Clients
- Web browsers (Users & Admins) running Next.js pages (CSR/SSR)
- Components call `frontend/src/api/*` services under the hood
B. Presentation & BFF (Next.js)
- Page routes (e.g. /recipes, /profile, /adminUI)
- Server-side functions (getServerSideProps) & API routes proxying to Firebase Functions or direct calls to Firebase services
C. API Layer (Firebase Functions)
- HTTPS endpoints for recipes, nutrition profile, chat, image upload, admin analytics
- Invoke business logic in backend/src, call dataconnect GraphQL or external recipe APIs via public keys
D. GraphQL Microservice (dataconnect)
- Connector definitions + schema in backend/dataconnect
- Exposes a GraphQL endpoint that Functions can query/mutate for data enrichment or search enhancements
E. Authentication & Data Stores (Firebase)
- Firebase Auth for user identity
- Firestore for user profiles, chats, posts, search history
- Firebase Storage for uploaded images (chat photos, post images)
F. External Recipe/Nutrition APIs
- Called from Functions (getRecipeDetails.js, enhanceSearchRecipe.js) using public API keys

##### Interactions & Data Flow
1. User visits a page → Next.js SSR/CSR
2. Client calls a service in `frontend/src/api` → either Next.js API route or directly an HTTPS trigger on Firebase Functions
3. Firebase Function executes →
a. Optional: call dataconnect GraphQL endpoint for enriched search/queries
b. Optional: call external recipe APIs using public keys
c. Execute business logic in backend/src (scoring, conflict detection)
d. Read/write Firestore or Storage
e. Return JSON to frontend
4. Frontend displays results (recipes, nutrition profile, chat thread, dashboards)

##### Architectural Patterns & Principles
- “Backend-for-Frontend” with Next.js as both UI and API proxy
- Microservices in Functions & GraphQL “dataconnect”
- Separation of concerns: UI vs API vs business logic vs data layer
- Serverless & BaaS (Firebase Auth, Firestore, Storage, Functions)
- CI/CD via Vercel and Firebase CLI

##### Final Checklist
- Clear labels on each component (e.g. “Next.js SSR”, “searchRecipe HTTPS Function”, “dataconnect GraphQL”)
- Critical config points (firebase.json, next.config.mjs, public API keys)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend (Browser & Next.js App)"
        direction TB
        Browser["Web Browser (User/Admin)"]:::frontend
        NextSSR["Next.js SSR/CSR"]:::frontend
        Pages["Page Routes"]:::frontend
        UIPrims["UI Primitives"]:::frontend
        APIWrappers["API Wrappers"]:::frontend
        AdminPages["Admin UI Pages"]:::frontend
    end

    %% BFF/API Layer
    subgraph "BFF/API Layer"
        direction TB
        NextApiRoutes["Next.js API Routes"]:::api
        subgraph "Firebase Functions"
            direction TB
            SR["searchRecipe HTTPS Function"]:::api
            GRD["getRecipeDetails HTTPS Function"]:::api
            ChatF["chat HTTPS Function"]:::api
            UploadChat["uploadChatPhoto Function"]:::api
            UploadPost["uploadPostImage Function"]:::api
            UploadImg["uploadImage Function"]:::api
            AdminF["adminStats & management Functions"]:::api
            Enhance["enhanceSearchRecipe Function"]:::api
        end
    end

    %% GraphQL Microservice
    subgraph "GraphQL Microservice" 
        direction TB
        Dataconn["dataconnect GraphQL Endpoint"]:::graphql
    end

    %% Server-side Business Logic
    subgraph "Business Logic" 
        direction TB
        Logic["recipeScorer, nutritionSearchProcessor, conflictDetector"]:::business
    end

    %% Firebase Services
    subgraph "Firebase Services"
        direction TB
        Auth["Firebase Auth"]:::firebase
        Firestore["Firestore (Profiles, Chats, Posts)"]:::firebase
        Storage["Storage (Images)"]:::firebase
    end

    %% External APIs
    subgraph "External APIs"
        direction TB
        ExtRecipe["Recipe API"]:::external
        ExtNutrition["Nutrition API"]:::external
    end

    %% Infra Config
    subgraph "Infrastructure Config"
        direction TB
        FirebaseCfg["firebase.json & .firebaserc"]:::infra
        VercelCfg["next.config.mjs & vercel.json"]:::infra
    end

    %% Connections
    Browser -->|"HTTP/SSR or CSR"| NextSSR
    NextSSR -->|"renders with"| Pages
    NextSSR -->|"uses UI"| UIPrims
    Pages -->|"calls"| APIWrappers
    AdminPages -->|"calls"| APIWrappers
    APIWrappers -->|"REST/HTTPS"| NextApiRoutes

    NextApiRoutes -->|"POST /searchRecipe"| SR
    NextApiRoutes -->|"POST /getRecipeDetails"| GRD
    NextApiRoutes -->|"POST /chat"| ChatF
    NextApiRoutes -->|"POST /uploadChatPhoto"| UploadChat
    NextApiRoutes -->|"POST /uploadPostImage"| UploadPost
    NextApiRoutes -->|"POST /uploadImage"| UploadImg
    NextApiRoutes -->|"GET/POST /adminStats"| AdminF
    SR -->|"GraphQL query"| Dataconn
    Enhance -->|"GraphQL query"| Dataconn
    SR -->|"invoke business logic"| Logic
    GRD -->|"invoke business logic"| Logic
    AdminF -->|"invoke business logic"| Logic
    ChatF -->|"read/write"| Firestore
    UploadChat -->|"store image"| Storage
    UploadPost -->|"store image"| Storage
    UploadImg -->|"store image"| Storage

    Logic -->|"read/write"| Firestore
    Logic -->|"use keys"| ExtRecipe
    Logic -->|"use keys"| ExtNutrition
    NextApiRoutes -->|"validate|Auth"| Auth

    %% Click Events
    click Pages "https://github.com/khanhtrinh301103/nutrigen_bot/tree/main/frontend/src/pages"
    click UIPrims "https://github.com/khanhtrinh301103/nutrigen_bot/tree/main/frontend/src/components/ui"
    click APIWrappers "https://github.com/khanhtrinh301103/nutrigen_bot/tree/main/frontend/src/api"
    click AdminPages "https://github.com/khanhtrinh301103/nutrigen_bot/tree/main/frontend/src/pages/adminUI"
    click SR "https://github.com/khanhtrinh301103/nutrigen_bot/blob/main/backend/functions/searchRecipe.js"
    click GRD "https://github.com/khanhtrinh301103/nutrigen_bot/blob/main/backend/functions/getRecipeDetails.js"
    click ChatF "https://github.com/khanhtrinh301103/nutrigen_bot/blob/main/backend/functions/chat.js"
    click UploadChat "https://github.com/khanhtrinh301103/nutrigen_bot/blob/main/backend/functions/uploadChatPhoto.js"
    click UploadPost "https://github.com/khanhtrinh301103/nutrigen_bot/blob/main/backend/functions/uploadPostImage.js"
    click UploadImg "https://github.com/khanhtrinh301103/nutrigen_bot/blob/main/backend/functions/uploadImage.js"
    click AdminF "https://github.com/khanhtrinh301103/nutrigen_bot/blob/main/backend/functions/admin/index.js"
    click Enhance "https://github.com/khanhtrinh301103/nutrigen_bot/blob/main/backend/functions/enhanceSearchRecipe.js"
    click Dataconn "https://github.com/khanhtrinh301103/nutrigen_bot/tree/main/backend/dataconnect"
    click Logic "https://github.com/khanhtrinh301103/nutrigen_bot/tree/main/backend/src"
    click FirebaseCfg "https://github.com/khanhtrinh301103/nutrigen_bot/blob/main/backend/firebase.json"
    click VercelCfg "https://github.com/khanhtrinh301103/nutrigen_bot/blob/main/frontend/next.config.mjs"

    %% Styles
    classDef frontend fill:#cce5ff,stroke:#004085,color:#004085;
    classDef api fill:#ffe5b4,stroke:#cc8400,color:#cc8400;
    classDef graphql fill:#d4edda,stroke:#155724,color:#155724;
    classDef business fill:#fff3cd,stroke:#856404,color:#856404;
    classDef firebase fill:#e2e3e5,stroke:#6c757d,color:#6c757d;
    classDef external fill:#f8d7da,stroke:#721c24,color:#721c24;
    classDef infra fill:#e9ecef,stroke:#343a40,color:#343a40;
```
