📌 IIC2513 - Taskify Backend

💻 Cápsula 2: Introducción a Express

📖 Resumen

La Cápsula 2 es la introducción a Express, un framework rápido y minimalista para crear aplicaciones backend en Node.js.

Un backend es la parte de una aplicación que procesa peticiones (requests) desde el frontend y devuelve respuestas (responses), generalmente con información o resultados.

En Express, además de definir rutas, podemos usar middlewares, que son funciones que se ejecutan entre el request y la response para realizar tareas como autenticación, logging o manejo de errores.

---

⚙️ Requisitos previos

Antes de comenzar, asegúrate de tener instalado en tu entorno (ej. WSL si usas Windows):

• Node.js
• Yarn

---

📦 Instalación del proyecto

1. Inicializar un proyecto Node.js:

   yarn init -y
   

2. Instalar dependencias principales:

yarn add express
yarn add morgan       # Middleware para mostrar logs de requests
yarn add dotenv       # Manejo de variables de entorno

3. Instalar dependencias de desarrollo:

yarn add -D nodemon   # Reinicia el servidor automáticamente en cambios

4. Crear la carpeta principal:

src/
└── index.js

---

📜 Scripts de ejecución

En tu archivo package.json, agrega los siguientes scripts:

"scripts": {
  "start": "node src/index.js",
  "dev": "nodemon src/index.js"
}

• yarn start: inicia el servidor con Node.js.

• yarn dev: inicia el servidor con Nodemon (reinicia automáticamente al detectar cambios).

---

🚀 Creando tu primer servidor con Express

En src/index.js:

const express = require("express");
const app = express();

// Middleware de logging (ejemplo opcional)
const morgan = require("morgan");
app.use(morgan("dev")); // aquí se utiliza use para que pase obligatoriamente por ahí una vez se recibe el mensaje

// Ruta principal
app.get("/", (req, res) => {
  res.send("<h1>Hola mundo</h1>");
});

// Levantar el servidor
app.listen(3000, () => {
  console.log("Servidor corriendo en el puerto 3000");
});

---

🔑 Uso de variables de entorno

Para mantener credenciales seguras (ej: contraseñas, llaves de API, etc.), se utiliza un archivo .env.

En primer lugar, se debe instalar dotenv en consola:

yarn add dotenv

Luego, crear un archivo .env dentro de la raíz del proyecto (no dentro de src):

NOMBRE=Ignacio

Después se deberá modificar src/index.js:

require("dotenv").config();

const express = require("express");
const app = express();

const NOMBRE = process.env.NOMBRE;

app.get("/", (req, res) => {
  res.send(`<h1>Hola ${NOMBRE}</h1>`);
});

app.listen(3000, () => {
  console.log(`Servidor corriendo con ${NOMBRE} en el puerto 3000`);
});

---

📄 Buenas prácticas

• Siempre incluir .env y node_modules en .gitignore.

• Mantener src/ como la carpeta de código fuente.

• Usar middlewares para modularizar funcionalidades (ej: morgan, autenticación, validaciones).

Ejemplo de .gitignore:

node_modules/
.env

💻 Cápsula 3: Sequelize

Se integró Sequelize al proyecto.

Comandos útiles

📦 Comando: yarn sequelize db:create

Este comando crea la base de datos definida en tu archivo config/config.js (según el entorno especificado, por defecto development).

• ¿Qué hace?
  Ejecuta internamente la instrucción SQL CREATE DATABASE en tu motor (por ejemplo, PostgreSQL).
  Si la base ya existe, mostrará un error.

• ¿Cuándo usarlo?

  • La primera vez que configuras tu proyecto.
  • Cuando inicias un nuevo entorno (ej: en otra máquina o servidor).
  • Después de haber borrado la base de datos y necesitar recrearla.

  yarn sequelize db:create

  📦 Comando: yarn sequelize db:migrate

Este comando ejecuta todas las migraciones pendientes definidas en la carpeta migrations/.

• ¿Qué hace?
  Traduce tus archivos de migración a sentencias SQL (CREATE TABLE, ALTER TABLE, etc.) y las aplica a la base de datos.
  Lleva un registro en la tabla SequelizeMeta para saber qué migraciones ya se ejecutaron.

• ¿Cuándo usarlo?

  • Después de crear la base de datos (db:create).
  • Cada vez que agregas o modificas un modelo y generas nuevas migraciones.
  • Para mantener sincronizada la estructura de la base en todos los entornos.

yarn sequelize db:migrate

---

📦 Comando: yarn sequelize db:seed:all

Este comando ejecuta todos los seeders definidos en la carpeta seeders/.

• ¿Qué hace?
  Inserta datos iniciales o de prueba en tus tablas (usuarios de demo, tareas de ejemplo, etc.).
  Usa internamente bulkInsert para poblar los registros.

• ¿Cuándo usarlo?

  • Para poblar la base de datos la primera vez que la levantas.
  • Cuando necesitas cargar datos de prueba en desarrollo.
  • Para dejar listas tablas con configuraciones base (roles, estados, etc.).

yarn sequelize db:seed:all

💻 Cápsula 4: Routing y CRUDs

📖 Introducción a los Endpoints RESTful

🗂️ Creación de la carpeta routes/

Se creó la carpeta routes/ para organizar los endpoints de manera modular, en esta se creo Users y Tasks para crear los endpoints.

🌐 Métodos HTTP y su significado

Método	Significado	Función
GET	Obtener	Recuperar información (READ)
POST	Crear	Enviar nueva información (CREATE)
PATCH	Actualizar	Modificar parcialmente (UPDATE)
DELETE	Eliminar	Borrar recurso (DELETE)

🎯 Ejemplo de códigos de estado HTTP

✅ Códigos 200 (Éxito)

• 200 OK: Solicitud exitosa
• 201 Created: Recurso creado

⚠️ Códigos 400 (Error cliente)

• 400 Bad Request: Solicitud mal formada
• 404 Not Found: Recurso no existe

🔴 Códigos 500 (Error servidor)

• 500 Internal Error: Error interno del servidor

📋 Ejemplo Real: Endpoint PATCH /api/tasks/:id

router.patch('/:id', async (req, res) => {
  try {
    const { id } = req.params;
    const { title, description, status, userId } = req.body;
    
    if (!userId) {
      return res.status(400).json({ error: "userId es requerido" });
    }
    
    const task = await Task.findOne({ where: { id, userId } });
    
    if (!task) {
      return res.status(404).json({ error: "Task not found" });
    }
    if (title !== undefined) task.title = title;
    if (description !== undefined) task.description = description;
    if (status !== undefined) task.status = status;
    await task.save();
    if (status === 'COMPLETED' && task.status !== 'COMPLETED') {
      await addExperience(userId, 10);
    }
    res.status(200).json(task);
    
  } catch (error) {
    res.status(500).json({ 
      error: "Error interno del servidor",
      details: error.message 
    });
  }
});

🎯 Escenarios de Respuesta

{
  "id": 1,
  "title": "Tarea completada",
  "status": "COMPLETED",
  "userId": 1
}

{
  "error": "userId es requerido"
}

{
  "error": "Task not found"
}

{
  "error": "Error interno del servidor",
  "details": "Cannot read property 'save' of null"
}

📊 Lógica de Experiencia

• +10 XP por cada tarea completada
• Fórmula: nivel_actual * 100 XP para subir de nivel
• Experiencia acumulativa entre niveles

async function addExperience(userId, xp) {
  const user = await User.findByPk(userId);
  const newExperience = user.experience + xp;
  const xpForNextLevel = user.level * 100;
  
  if (newExperience >= xpForNextLevel) {
    user.level += 1;
    user.experience = newExperience - xpForNextLevel;
  } else {
    user.experience = newExperience;
  }
  await user.save();
}

🎯 Buenas prácticas implementadas

1. Manejo completo de errores (400s, 404s, 500s)
2. Validación de datos y existencia
3. Lógica de experiencia integrada
4. Respuestas consistentes

💻 Cápsula 5: Conexión a la API

Se realiza la conexión de los endpoints del backend con la lógica del frontend

Se hicieron dos cosas principales:

Instalar Morgan: Librería de Node.js que se usa en Express para registrar las solicitudes HTTP que llegan al servidor, mostrando información como método, URL, código de estado y tiempo de respuesta.

yarn add morgan

GET /api/tasks/13 200 3.456 ms

Instalar libreria CORS: librería de Node.js que permite configurar qué orígenes pueden acceder a tu servidor, facilitando el manejo de la política de seguridad Cross-Origin Resource Sharing en aplicaciones web.

yarn add cors

Se agregan ambas a app.js

const morgan = require("morgan");    <------
const cors = require("cors");    <------
const app = express();

// Middlewares
app.use(cors());    <------
app.use(express.json());  
app.use(morgan("dev"));    <------