# nicoriver9/mercadopago-suscriptions-managment architecture

> Architecture diagram of the GitHub repository nicoriver9/mercadopago-suscriptions-managment, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nicoriver9/mercadopago-suscriptions-managment
- Repository: https://github.com/nicoriver9/mercadopago-suscriptions-managment

## Overview

##### Project type and purpose
- This is a full-stack web application for managing subscriptions and donations via the MercadoPago platform.
- Frontend: React single-page application (SPA) built with Vite, Tailwind CSS, and React Router.
- Backend: Node.js + Express REST API using Sequelize for ORM and JWT-based authentication.

##### File structure
- Top-level folders:
- frontend/ – React code, public assets, config files, routes, components, auth and donate feature modules.
- backend/ – Express server, config, controllers, routes, models, helpers, middlewares, plus a public folder hosting the compiled React build.
- Patterns:
- Frontend is organized by feature (auth, donate, ui, router) using custom hooks, helpers, pages, and components.
- Backend follows MVC (models, controllers, routes), layered with config, helpers, middlewares, and a public static asset folder.
- Infrastructure files:
- frontend/vite.config.js, tailwind.config.js
- backend/package.json, vercel.json, example.env for environment variables

##### README for additional insights
- Core features: user login, admin management, subscription/donation processing.
- Tech stack: Node 14+, npm, React, Express, MercadoPago SDK, Sequelize, Jest suggested for testing.
- Deployment hints: dev servers on localhost:3000 (frontend) and default Express port for backend; .env setup.

a. Main components
- Client (Browser SPA)
- API Gateway / Express Server
- Authentication service (JWT issuance & verification)
- Subscription & Donation service (controllers, business logic)
- Database (PostgreSQL or MySQL via Sequelize)
- External service: MercadoPago REST API
- Static content host (serving React assets)
b. Relationships & interactions
- Browser ↔ Express REST endpoints (HTTP/HTTPS)
- Express ↔ Database (ORM queries)
- Express ↔ MercadoPago API (SDK calls for payments, subscriptions)
- Static asset requests served from backend public folder (or CDN)
c. Architectural patterns & design principles
- Layered MVC on backend:
- Models: Sequelize definitions
- Controllers: business logic & response formatting
- Routes: HTTP endpoint definitions
- Middlewares: JWT authentication, error handling
- Feature-based modularity on frontend (auth, donate, ui)
- Token-based stateless authentication (JWT)
d. Key technologies/frameworks
- Frontend: React, Vite, Tailwind CSS, React Router, custom hooks
- Backend: Node.js, Express, Sequelize, MercadoPago SDK, jsonwebtoken
- Deployment: Vercel config for serverless or container hosting, environment variables

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    subgraph "Client Layer"
        direction TB
        FE["Client (Browser SPA)"]:::client

        subgraph "frontend/src"
            direction TB
            Main["main.jsx"]:::client
            Router["AppRouter.jsx"]:::client

            subgraph "Auth Module"
                direction TB
                AuthIndex["index.js"]:::client
                AuthHooks["useFetchToken.jsx"]:::client
                AuthHelpers["fetchToken.js"]:::client
                AuthPage["LoginPages.jsx"]:::client
            end

            subgraph "Donate Module"
                direction TB
                DonateIndex["index.js"]:::client
                DonateRoutes["DonateRoutes.jsx"]:::client
                DonatePages["pages"]:::client
                DonateComponents["components"]:::client
                DonateHooks["useFetchData.jsx"]:::client
                DonateHelpers["fetchDataDonations.js"]:::client
            end

            subgraph "UI Components"
                direction TB
                Nav["Navbar.jsx"]:::client
                UIIndex["index.js"]:::client
            end

            Shared["VideoBackground.jsx"]:::client

            subgraph "Config & Styling"
                direction TB
                Vite["vite.config.js"]:::client
                Tailwind["tailwind.config.js"]:::client
                PostCSS["postcss.config.js"]:::client
                Styles["styles.css"]:::client
            end
        end
    end

    %% API Layer
    subgraph "API Layer (Express Server)" 
        direction TB
        APIEntry["index.js"]:::api

        subgraph "Configuration"
            direction TB
            Config["config.js"]:::api
            SequelizeConfig["sequelize.js"]:::api
            EnvExample["example.env"]:::api
        end

        subgraph "Routing Layer"
            direction TB
            AuthRoutes["auth.routes.js"]:::api
            UserRoutes["users.routes.js"]:::api
            SubRoutes["subscripcion.routes.js"]:::api
        end

        subgraph "Controllers"
            direction TB
            AuthCtrl["auth.js"]:::api
            UserCtrl["users.controller.js"]:::api
            SubCtrl["subscripcion.controller.js"]:::api
        end

        subgraph "Middlewares & Helpers"
            direction TB
            JWTMiddleware["authenticate.js"]:::api
            CreateToken["createToken.js"]:::api
            VerifyToken["verifyToken.js"]:::api
            MPConfig["mercadopago.config.js"]:::api
            DateFormat["formatDateMercadopago.js"]:::api
        end

        subgraph "Static Content Host"
            direction TB
            PublicFolder["public"]:::api
            HTML["index.html"]:::api
            Assets["assets"]:::api
        end
    end

    %% Data Layer
    subgraph "Data Layer (Sequelize Models)"
        direction TB
        Models["models"]:::data
    end

    %% External Services
    subgraph "External Services"
        direction TB
        MP["MercadoPago API"]:::external
    end

    %% Relationships
    FE -->|"Load SPA"| PublicFolder
    FE -->|"API HTTP"| APIEntry
    APIEntry --> Config
    APIEntry --> RoutingLayer
    RoutingLayer --> Controllers
    APIEntry --> JWTMiddleware
    Controllers --> Models
    Controllers --> MP
    APIEntry --> PublicFolder

    %% Click Events
    click Main "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/frontend/src/main.jsx"
    click Router "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/frontend/src/router/AppRouter.jsx"
    click AuthIndex "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/frontend/src/auth/index.js"
    click AuthHooks "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/frontend/src/auth/hooks/useFetchToken.jsx"
    click AuthHelpers "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/frontend/src/auth/helpers/fetchToken.js"
    click AuthPage "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/frontend/src/auth/pages/LoginPages.jsx"
    click DonateIndex "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/frontend/src/donate/index.js"
    click DonateRoutes "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/frontend/src/donate/routes/DonateRoutes.jsx"
    click DonatePages "https://github.com/nicoriver9/mercadopago-suscriptions-managment/tree/main/frontend/src/donate/pages"
    click DonateComponents "https://github.com/nicoriver9/mercadopago-suscriptions-managment/tree/main/frontend/src/donate/components"
    click DonateHooks "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/frontend/src/donate/hooks/useFetchData.jsx"
    click DonateHelpers "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/frontend/src/donate/helpers/fetchDataDonations.js"
    click Nav "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/frontend/src/ui/components/Navbar.jsx"
    click UIIndex "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/frontend/src/ui/index.js"
    click Shared "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/frontend/src/components/VideoBackground.jsx"
    click Vite "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/frontend/vite.config.js"
    click Tailwind "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/frontend/tailwind.config.js"
    click PostCSS "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/frontend/postcss.config.js"
    click Styles "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/frontend/src/styles.css"
    click APIEntry "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/backend/src/index.js"
    click Config "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/backend/src/config.js"
    click SequelizeConfig "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/backend/src/config/sequelize.js"
    click EnvExample "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/backend/example.env"
    click AuthRoutes "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/backend/src/routes/auth.routes.js"
    click UserRoutes "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/backend/src/routes/users.routes.js"
    click SubRoutes "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/backend/src/routes/subscripcion.routes.js"
    click AuthCtrl "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/backend/src/controllers/auth.js"
    click UserCtrl "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/backend/src/controllers/users.controller.js"
    click SubCtrl "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/backend/src/controllers/subscripcion.controller.js"
    click JWTMiddleware "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/backend/src/middlewares/authenticate.js"
    click CreateToken "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/backend/src/helpers/createToken.js"
    click VerifyToken "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/backend/src/helpers/verifyToken.js"
    click MPConfig "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/backend/src/helpers/mercadopago.config.js"
    click DateFormat "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/backend/src/helpers/formatDateMercadopago.js"
    click PublicFolder "https://github.com/nicoriver9/mercadopago-suscriptions-managment/tree/main/backend/src/public"
    click HTML "https://github.com/nicoriver9/mercadopago-suscriptions-managment/blob/main/backend/src/public/index.html"
    click Assets "https://github.com/nicoriver9/mercadopago-suscriptions-managment/tree/main/backend/src/public/assets"
    click Models "https://github.com/nicoriver9/mercadopago-suscriptions-managment/tree/main/backend/src/models"

    %% Styles
    classDef client fill:#D0E7FF,stroke:#1E90FF
    classDef api fill:#DDF5DD,stroke:#228B22
    classDef data fill:#FFE5B4,stroke:#FFA500
    classDef external fill:#FFCCCC,stroke:#DC143C
```
