# noealarconb/control-gastos-backend architecture

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

- Interactive diagram: https://gitdiagram.com/noealarconb/control-gastos-backend
- Repository: https://github.com/noealarconb/control-gastos-backend

## Overview

Para guiar al principal software engineer en la confección de un diagrama de arquitectura preciso para el “Proyecto de Control de Gastos” (full-stack con React/Vite + Node.js/Express/Prisma), siga estos pasos:

##### Identificación del tipo de proyecto y propósito
- Según el README y la estructura, es una aplicación web full-stack:
- Frontend: React + Vite + TypeScript
- Backend: Node.js + Express + TypeScript + Prisma ORM
- Base de datos: PostgreSQL (configurada vía Prisma)
- Autenticación: JWT
- API Docs: Swagger UI

##### Análisis de la estructura de carpetas (backend mostrado)
- src/server.ts / src/app.ts → punto de entrada y configuración del servidor Express
- src/routes → definición de endpoints (authRoute, usuarioRoute, etc.)
- src/auth → middleware y lógica de JWT
- src/controllers → orquestación de request → delega en services
- src/services → lógica de negocio (operaciones CRUD agrupadas por entidad)
- src/mappers → transformación entre modelos de BD y DTOs
- src/models (interfaces/ clases de entidades)
- src/schemas → validaciones de request (Joi o Zod)
- prisma/schema.prisma → definición de modelo relacional y generación de cliente Prisma
- src/shared → utilitarios (bcrypt, responseModel, constans)

##### Elementos principales a plasmar en el diagrama
a. Frontend
- Vite Dev Server (dev) / Static Host (prod)
- React Components / State Management
- HTTP Client (fetch / Axios)
b. Backend
- Express Server
- Auth Middleware (JWT)
- Router Layer
- Controller Layer
- Service Layer
- Mapper Layer
- Prisma Client
c. Base de Datos
- PostgreSQL (diagramar tablas principales: Usuario, Categoría, CuentaBancaria, MétodoPago, Presupuesto, Transacción)
d. Documentación / Externos
- Swagger UI (mounted en /api-docs)
- Variables de entorno (.env)

##### Relaciones e interacciones
- El Frontend consume el API REST del Backend (flechas unidireccionales HTTP requests → responses)
- El Backend utiliza el middleware JWT para asegurar rutas privadas
- Controllers invocan servicios; servicios usan mappers para traducir a modelos de BD
- Prisma Client conecta con PostgreSQL
- Swagger UI se conecta al Express Server para exponer endpoints

##### Patrón y principios arquitectónicos
- Capas (Layered Architecture): Separación clara de responsabilidades (Routing → Controllers → Services → Data Access)
- Uso de DTOs / Mappers para desacoplar dominio de esquema de persistencia
- Principio de inyección de configuraciones via env.ts
- Autenticación basada en JWT (stateless)

##### Guía para dibujar el diagrama (full-stack)
- UI / Frontend (verde)
- API / Business (azul)
- Data / DB (naranja)
- Conecte con flechas direccionales:
- Usuario → Frontend → Backend (REST) → BD
- Backend → Swagger UI
- Añada etiquetas sobre cada flecha (GET /users, POST /login, etc.)
- Indique puertos (frontend: 5173; backend: 3000)
- Destaque el JWT-Auth Middleware en la ruta de las peticiones protegidas

##### Elementos imprescindibles en el diagrama
- Títulos y leyenda explicando colores/ formas
- Componentes etiquetados: “React App”, “Express Server”, “Prisma Client”, “PostgreSQL”
- Flechas con direcciones claras, indicando flujo de datos y dependencia
- Notas de configuración (.env) y montaje de Swagger UI

##### Conclusión
Todas las capas del backend, la interacción con la base de datos y la relación client-server. Use la separación frontend/backend, destaque el middleware de autenticación y los mappers que unen dominio con persistencia. Asegúrese de reflejar el uso de Prisma y la cobertura de Swagger UI como componente de documentación.

## Diagram (Mermaid)

```mermaid
flowchart TB
  %% Frontend Layer
  subgraph "Frontend Layer"
    direction TB
    User["User Browser"]:::frontend
    ReactApp["React App"]:::frontend
    Vite["Vite Dev Server (5173)"]:::frontend
    HTTPClient["HTTP Client (Axios/fetch)"]:::frontend
  end

  %% Backend Layer
  subgraph "Backend Layer"
    direction TB
    ExpressServer["Express Server (3000)"]:::backend
    EnvConfig["Configuration (.env / env.ts)"]:::config
    SwaggerUI["Swagger UI (/api-docs)"]:::docs

    subgraph "Auth"
      direction TB
      AuthMiddleware["JWT Auth Middleware"]:::backend
      AuthService["Auth Service"]:::backend
      AuthController["Auth Controller"]:::backend
    end

    subgraph "Routing"
      direction TB
      AuthRoute["authRoute"]:::backend
      UsuarioRoute["usuarioRoute"]:::backend
      CategoriaRoute["categoriaRoute"]:::backend
      CuentaRoute["cuentaBancariaRoute"]:::backend
      MetodoRoute["metodoPagoRoute"]:::backend
      PresupuestoRoute["presupuestoRoute"]:::backend
      TransaccionRoute["transaccionRoute"]:::backend
    end

    subgraph "Controllers"
      direction TB
      UsuarioController["usuarioController"]:::backend
      CategoriaController["categoriaController"]:::backend
      CuentaController["cuentaBancariaController"]:::backend
      MetodoController["metodoPagoController"]:::backend
      PresupuestoController["presupuestoController"]:::backend
      TransaccionController["transaccionController"]:::backend
    end

    subgraph "Services"
      direction TB
      UsuarioService["usuarioService"]:::backend
      CategoriaService["categoriaService"]:::backend
      CuentaService["cuentaBancariaServices"]:::backend
      MetodoService["metodoPagoService"]:::backend
      PresupuestoService["presupuestoService"]:::backend
      TransaccionService["transaccionService"]:::backend
    end

    subgraph "Mappers"
      direction TB
      UsuarioMapper["usuario.mapper"]:::backend
      CategoriaMapper["categoria.mapper"]:::backend
      CuentaMapper["cuentaBancaria.mapper"]:::backend
      MetodoMapper["metodoPago.mapper"]:::backend
      PresupuestoMapper["presupuesto.mapper"]:::backend
      TransaccionMapper["transaccion.mapper"]:::backend
    end

    PrismaClient["Prisma Client"]:::db
  end

  %% Database Layer
  subgraph "Database"
    direction TB
    Postgres["PostgreSQL"]:::db
  end

  %% Connections
  User -->|"interacts"| ReactApp
  ReactApp -->|"served by"| Vite
  ReactApp -->|"HTTP requests"| HTTPClient
  HTTPClient -->|"/api/*"| ExpressServer
  ExpressServer -->|"uses env"| EnvConfig
  ExpressServer -->|"mounts"| SwaggerUI
  ExpressServer -->|"auth check"| AuthMiddleware
  AuthMiddleware --> AuthRoute
  AuthRoute --> AuthController
  AuthController --> AuthService
  AuthController --> AuthMiddleware
  AuthService --> UsuarioService
  AuthService --> CategoriaService
  AuthService --> CuentaService
  AuthService --> MetodoService
  AuthService --> PresupuestoService
  AuthService --> TransaccionService

  AuthRoute --> UsuarioController
  UsuarioController --> UsuarioService
  UsuarioService --> UsuarioMapper
  UsuarioMapper --> PrismaClient

  CategoriaRoute --> CategoriaController
  CategoriaController --> CategoriaService
  CategoriaService --> CategoriaMapper
  CategoriaMapper --> PrismaClient

  CuentaRoute --> CuentaController
  CuentaController --> CuentaService
  CuentaService --> CuentaMapper
  CuentaMapper --> PrismaClient

  MetodoRoute --> MetodoController
  MetodoController --> MetodoService
  MetodoService --> MetodoMapper
  MetodoMapper --> PrismaClient

  PresupuestoRoute --> PresupuestoController
  PresupuestoController --> PresupuestoService
  PresupuestoService --> PresupuestoMapper
  PresupuestoMapper --> PrismaClient

  TransaccionRoute --> TransaccionController
  TransaccionController --> TransaccionService
  TransaccionService --> TransaccionMapper
  TransaccionMapper --> PrismaClient

  PrismaClient --> Postgres

  %% Click Events
  click ExpressServer "https://github.com/noealarconb/control-gastos-backend/blob/main/src/server.ts"
  click ExpressServer "https://github.com/noealarconb/control-gastos-backend/blob/main/src/app.ts"
  click AuthMiddleware "https://github.com/noealarconb/control-gastos-backend/blob/main/src/auth/auth.middleware.ts"
  click AuthService "https://github.com/noealarconb/control-gastos-backend/blob/main/src/auth/auth.service.ts"
  click AuthController "https://github.com/noealarconb/control-gastos-backend/blob/main/src/auth/auth.controller.ts"
  click AuthRoute "https://github.com/noealarconb/control-gastos-backend/blob/main/src/routes/authRoute.ts"
  click UsuarioRoute "https://github.com/noealarconb/control-gastos-backend/blob/main/src/routes/usuarioRoute.ts"
  click CategoriaRoute "https://github.com/noealarconb/control-gastos-backend/blob/main/src/routes/categoriaRoute.ts"
  click CuentaRoute "https://github.com/noealarconb/control-gastos-backend/blob/main/src/routes/cuentaBancariaRoute.ts"
  click MetodoRoute "https://github.com/noealarconb/control-gastos-backend/blob/main/src/routes/metodoPagoRoute.ts"
  click PresupuestoRoute "https://github.com/noealarconb/control-gastos-backend/blob/main/src/routes/presupuestoRoute.ts"
  click TransaccionRoute "https://github.com/noealarconb/control-gastos-backend/blob/main/src/routes/transaccionRoute.ts"
  click UsuarioController "https://github.com/noealarconb/control-gastos-backend/blob/main/src/controllers/usuarioController.ts"
  click CategoriaController "https://github.com/noealarconb/control-gastos-backend/blob/main/src/controllers/categoriaController.ts"
  click CuentaController "https://github.com/noealarconb/control-gastos-backend/blob/main/src/controllers/cuentaBancariaController.ts"
  click MetodoController "https://github.com/noealarconb/control-gastos-backend/blob/main/src/controllers/metodoPagoController.ts"
  click PresupuestoController "https://github.com/noealarconb/control-gastos-backend/blob/main/src/controllers/presupuestoController.ts"
  click TransaccionController "https://github.com/noealarconb/control-gastos-backend/blob/main/src/controllers/transaccionController.ts"
  click UsuarioService "https://github.com/noealarconb/control-gastos-backend/blob/main/src/services/usuarioService.ts"
  click CategoriaService "https://github.com/noealarconb/control-gastos-backend/blob/main/src/services/categoriaService.ts"
  click CuentaService "https://github.com/noealarconb/control-gastos-backend/blob/main/src/services/cuentaBancariaServices.ts"
  click MetodoService "https://github.com/noealarconb/control-gastos-backend/blob/main/src/services/metodoPagoService.ts"
  click PresupuestoService "https://github.com/noealarconb/control-gastos-backend/blob/main/src/services/presupuestoService.ts"
  click TransaccionService "https://github.com/noealarconb/control-gastos-backend/blob/main/src/services/transaccionService.ts"
  click UsuarioMapper "https://github.com/noealarconb/control-gastos-backend/blob/main/src/mappers/usuario.mapper.ts"
  click CategoriaMapper "https://github.com/noealarconb/control-gastos-backend/blob/main/src/mappers/categoria.mapper.ts"
  click CuentaMapper "https://github.com/noealarconb/control-gastos-backend/blob/main/src/mappers/cuentaBancaria.mapper.ts"
  click MetodoMapper "https://github.com/noealarconb/control-gastos-backend/blob/main/src/mappers/metodoPago.mapper.ts"
  click PresupuestoMapper "https://github.com/noealarconb/control-gastos-backend/blob/main/src/mappers/presupuesto.mapper.ts"
  click TransaccionMapper "https://github.com/noealarconb/control-gastos-backend/blob/main/src/mappers/transaccion.mapper.ts"
  click PrismaClient "https://github.com/noealarconb/control-gastos-backend/blob/main/prisma/schema.prisma"
  click EnvConfig "https://github.com/noealarconb/control-gastos-backend/blob/main/src/config/env.ts"
  click SwaggerUI "https://github.com/noealarconb/control-gastos-backend/blob/main/src/app.ts"

  %% Styles
  classDef frontend fill:#e0f7e9,stroke:#333,stroke-width:1px
  classDef backend fill:#d0e1f9,stroke:#333,stroke-width:1px
  classDef db fill:#ffe0b2,stroke:#333,stroke-width:1px
  classDef docs fill:#e0e0e0,stroke:#333,stroke-width:1px
  classDef config fill:#f3e5f5,stroke:#333,stroke-width:1px
```
