How noealarconb/control-gastos-backend works
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.