ABP7 - API Gestión de Usuarios

REST API desarrollada con Node.js + Express y PostgreSQL usando Sequelize.
Proyecto del Módulo 7 - Backend.

Tecnologías

• Node.js + Express
• Sequelize ORM + PostgreSQL
• dotenv
• Nodemon

Instalación

git clone https://github.com/mvmv1428/ABP7.git
cd ABP7
npm install

Copia y configura el archivo de entorno:

cp .env.example .env

Edita .env con tus datos de PostgreSQL y luego inicia el servidor:

npm run dev

La API estará disponible en http://localhost:3000

Endpoints principales

Usuarios

• GET /usuarios → Listar (ORM)
• GET /usuarios-sql → Listar (SQL puro)
• POST /usuarios → Crear
• PUT /usuarios/:id → Actualizar
• DELETE /usuarios/:id → Eliminar

Historial y Transacción

• POST /usuarios/historial → Crear usuario + historial (transacción)
• GET /usuarios/historial → Usuarios con historial

Otros

• GET / → Página de inicio
• GET /status → Estado del servidor

Estructura del proyecto

• config/ → Conexión BD
• controllers/ → Lógica
• models/ → User y Historial (relación 1:N)
• routes/ → Rutas
• public/ → Archivos estáticos
• middlewares/ → Logger

Scripts

npm run dev     # Desarrollo con nodemon
npm start       # Producción

Notas

• En desarrollo se reinician las tablas (force: true).
• Proyecto listo para presentar.
• Mejoras pendientes: validaciones, errores globales y autenticación.

Comparación ORM vs SQL

El uso de ORM como Sequelize facilita el desarrollo al abstraer las consultas SQL, permitiendo trabajar con objetos en lugar de escribir queries manuales. Esto reduce errores, mejora la mantenibilidad del código y protege contra vulnerabilidades como SQL Injection. Sin embargo, el SQL manual ofrece mayor control y puede ser más eficiente en consultas complejas. En este proyecto, el ORM permitió implementar rápidamente las operaciones CRUD con menor complejidad.

---

📦 Estructura del Proyecto

Se utilizó una arquitectura modular basada en Node.js + Express + Sequelize (ORM) para separar responsabilidades y facilitar el mantenimiento y escalabilidad.

Justificación:
Esta estructura permite mantener el código organizado, desacoplado y fácil de escalar, separando claramente la lógica de negocio, acceso a datos y rutas.

---

🔗 Relaciones ORM

• Un User tiene muchos Historial
• Un Historial pertenece a un User

Se implementa usando hasMany, belongsTo y consultas con include para obtener datos relacionados en una sola query.

---

✅ Validaciones

• Validación de campos obligatorios (allowNull: false)
• Definición de tipos de datos en los modelos
• Validación de parámetros en rutas (ej: id)
• Manejo de errores con try/catch
• Uso de foreign keys para asegurar integridad relacional

Justificación:
Las validaciones aseguran consistencia de datos, previenen errores en runtime y garantizan que las relaciones entre tablas se mantengan correctas.

Drive

https://drive.google.com/drive/folders/134IpvXVCiutyVj-Ut_kbScQeOq2rPAjB?usp=sharing