# tumbichi/belumont-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/tumbichi/belumont-frontend
- Repository: https://github.com/tumbichi/belumont-frontend

## Overview

##### Project type and purpose
- This is a full‑stack Next.js application (App Router) that serves both the UI and API endpoints.
- Purpose: an e‑commerce‑style storefront with product listings, purchase flow (via MercadoPago), email notifications (via Resend), and metadata fetching from Instagram. It persists orders, users, payments, and products in Supabase.

##### File structure
- Top‑level “src/app”: Next.js App Router pages and API routes
- src/app/page.tsx, detalle‑de‑compra/page.tsx, pago/exitoso/page.tsx, etc.
- src/app/api/*: meta/instagram, payment, payment/webhook, resend/send‑email.
- “src/core”: shared utilities, UI components, data layer, hooks, i18n, formatting, email templates.
- “src/modules”: feature folders (payments, products) containing UI components, schemas, layouts.
- Data layer structure:
- core/data/instagram, mercadopago, resend, supabase (orders, payments, products, users)
- Each has client.ts, repository.ts, and services/*.
- Config & tooling: ESLint, Prettier, Tailwind, Vercel CI workflows.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend Layer" 
        direction TB
        Browser["Browser"]:::external
        subgraph "Next.js Frontend Pages" 
            direction TB
            ProductList["Page: / (Product List)"]:::frontend
            click ProductList "https://github.com/tumbichi/belumont-frontend/blob/main/src/app/page.tsx"
            ProductDetail["Page: /recetarios/[pathname]"]:::frontend
            click ProductDetail "https://github.com/tumbichi/belumont-frontend/blob/main/src/app/recetarios/[pathname]/page.tsx"
            PurchaseDetail["Page: /detalle-de-compra"]:::frontend
            click PurchaseDetail "https://github.com/tumbichi/belumont-frontend/blob/main/src/app/detalle-de-compra/page.tsx"
            Checkout["Page: /pago"]:::frontend
            click Checkout "https://github.com/tumbichi/belumont-frontend/blob/main/src/app/pago/page.tsx"
            Success["Page: /pago/exitoso"]:::frontend
            click Success "https://github.com/tumbichi/belumont-frontend/blob/main/src/app/pago/exitoso/page.tsx"
        end
        Browser -->|"View Pages"| ProductList
        Browser --> ProductDetail
        Browser --> PurchaseDetail
        Browser --> Checkout
        Browser --> Success
    end

    %% Backend Layer
    subgraph "Backend Layer (Next.js API Routes & Business Logic)"
        direction TB
        subgraph "API Routes" 
            direction TB
            API_Instagram["API: /api/meta/instagram"]:::api
            click API_Instagram "https://github.com/tumbichi/belumont-frontend/blob/main/src/app/api/meta/instagram/route.ts"
            API_Payment["API: /api/payment"]:::api
            click API_Payment "https://github.com/tumbichi/belumont-frontend/blob/main/src/app/api/payment/route.ts"
            API_Webhook["API: /api/payment/webhook"]:::api
            click API_Webhook "https://github.com/tumbichi/belumont-frontend/blob/main/src/app/api/payment/webhook/route.ts"
            API_Resend["API: /api/resend/send-email-product"]:::api
            click API_Resend "https://github.com/tumbichi/belumont-frontend/blob/main/src/app/api/resend/send-email-product/route.ts"
        end

        subgraph "Core Data Client" 
            DataClient["client.ts"]:::api
            click DataClient "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/client.ts"
        end

        subgraph "Instagram Data Layer"
            direction TB
            IG_Client["instagram/client.ts"]:::api
            click IG_Client "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/instagram/client.ts"
            IG_Repo["instagram.repository.ts"]:::api
            click IG_Repo "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/instagram/instagram.repository.ts"
            IG_Service["services/replyComment.ts"]:::api
            click IG_Service "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/instagram/services/replyComment.ts"
        end

        subgraph "MercadoPago Data Layer"
            direction TB
            MP_Client["mercadopago/client.ts"]:::api
            click MP_Client "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/mercadopago/client.ts"
            MP_Repo["mercadopago.repository.ts"]:::api
            click MP_Repo "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/mercadopago/mercadopago.repository.ts"
            MP_Service1["services/generatePaymentUrl.ts"]:::api
            click MP_Service1 "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/mercadopago/services/generatePaymentUrl.ts"
            MP_Service2["services/getPaymentById.ts"]:::api
            click MP_Service2 "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/mercadopago/services/getPaymentById.ts"
        end

        subgraph "Resend Data Layer"
            direction TB
            RE_Client["resend/client.ts"]:::api
            click RE_Client "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/resend/client.ts"
            RE_Repo["resend.repository.ts"]:::api
            click RE_Repo "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/resend/resend.repository.ts"
            RE_Service["services/sendEmail.ts"]:::api
            click RE_Service "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/resend/services/sendEmail.ts"
        end

        subgraph "Supabase Data Layer"
            direction TB
            SB_CoreRepo["supabase.repository.ts"]:::api
            click SB_CoreRepo "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/supabase/supabase.repository.ts"
            subgraph "Orders"
                direction TB
                SB_OrderRepo["orders.repository.ts"]:::api
                click SB_OrderRepo "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/supabase/orders/orders.repository.ts"
                SB_OrderCreate["services/createOrder.ts"]:::api
                click SB_OrderCreate "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/supabase/orders/services/createOrder.ts"
                SB_OrderGet["services/getOrderById.ts"]:::api
                click SB_OrderGet "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/supabase/orders/services/getOrderById.ts"
                SB_OrderUpdate["services/updateOrderStatus.ts"]:::api
                click SB_OrderUpdate "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/supabase/orders/services/updateOrderStatus.ts"
            end
            subgraph "Payments"
                direction TB
                SB_PayRepo["payments.repository.ts"]:::api
                click SB_PayRepo "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/supabase/payments/payments.repository.ts"
                SB_PayCreate["services/createPayment.ts"]:::api
                click SB_PayCreate "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/supabase/payments/services/createPayment.ts"
                SB_PayUpdate["services/updatePaymentStatus.ts"]:::api
                click SB_PayUpdate "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/supabase/payments/services/updatePaymentStatus.ts"
            end
            subgraph "Products"
                direction TB
                SB_ProdRepo["products.repository.ts"]:::api
                click SB_ProdRepo "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/supabase/products/products.repository.ts"
                SB_GetAllProd["services/getAllProducts.ts"]:::api
                click SB_GetAllProd "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/supabase/products/services/getAllProducts.ts"
                SB_GetProdById["services/getProductById.ts"]:::api
                click SB_GetProdById "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/supabase/products/services/getProductById.ts"
                SB_GetProdByPath["services/getProductByPathname.ts"]:::api
                click SB_GetProdByPath "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/supabase/products/services/getProductByPathname.ts"
            end
            subgraph "Users"
                direction TB
                SB_UserRepo["users.repository.ts"]:::api
                click SB_UserRepo "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/supabase/users/users.repository.ts"
                SB_CreateUser["services/createUser.ts"]:::api
                click SB_CreateUser "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/supabase/users/services/createUser.ts"
                SB_GetUserEmail["services/getUserByEmail.ts"]:::api
                click SB_GetUserEmail "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/supabase/users/services/getUserByEmail.ts"
                SB_GetUserId["services/getUserById.ts"]:::api
                click SB_GetUserId "https://github.com/tumbichi/belumont-frontend/blob/main/src/core/data/supabase/users/services/getUserById.ts"
            end
        end

        %% API to Data Layer Connections
        API_Instagram --> DataClient
        DataClient --> IG_Client --> IG_Repo --> IG_Service
        API_Payment --> DataClient
        DataClient --> MP_Client --> MP_Repo --> MP_Service1 & MP_Service2
        API_Webhook --> DataClient
        DataClient --> SB_CoreRepo --> SB_PayRepo --> SB_PayCreate & SB_PayUpdate
        API_Resend --> DataClient
        DataClient --> RE_Client --> RE_Repo --> RE_Service

        %% Supabase DB
        SupabaseDB[(Supabase Database)]:::datastore
        SB_CoreRepo --> SupabaseDB

        %% External Services
        InstagramAPI[(Instagram Graph API)]:::external
        MercadoPagoAPI[(MercadoPago API)]:::external
        ResendAPI[(Resend Email API)]:::external

        IG_Client --> InstagramAPI
        MP_Client --> MercadoPagoAPI
        RE_Client --> ResendAPI
    end

    classDef frontend fill:#D0E8FF,stroke:#0366d6,color:#0366d6
    classDef api fill:#E0F7E9,stroke:#059669,color:#065f46
    classDef datastore fill:#FFEDD5,stroke:#FB923C,color:#B45309
    classDef external fill:#F5E9FF,stroke:#8B5CF6,color:#5B21B6
```
