Sesión 5 Refactor de BD y API (SPs, códigos de salida y conexión Node)


Hora de inicio: 9:00pm
Hora de fin: 12:52 pm
Horas trabajadas: 3 h

Descripción de avances

Como el profe subió el archivo de estándares se hicieron los siguientes cambios:

  • Script database.sql: Unifiqué la base EmpresaDB, dejé la tabla Empleado, agregué DBErrors para errores de plataforma en el CATCH, y reescribí sp_list_empleados y sp_insert_empleado con parámetros @inNombre, @inSalario y salida @outResultCode (0 = OK, duplicado = -1 antes del TRY, errores raros mapeados a código > 50000 y registro en DBErrors).
  • Estándar de codificación SQL: Ajusté el script al formato del curso (palabras reservadas en mayúscula, comas al inicio en listas, SELECT/FROM/WHERE separados, alias en tablas, condiciones entre paréntesis).
  • Datos: Mantuvimos al menos 40 filas de prueba en Empleado.
  • Pruebas en SSMS: Las ejecuciones manuales las pasé a database.tests.sql para no dejar EXEC “sueltos” en el script principal.
  • Backend (Express): Los endpoints pasaron a usar inNombre, inSalario y a leer outResultCode desde la respuesta de execute(); así coincide con la firma nueva de los SPs.
  • Bug de inserción: Descubrimos que con node-mssql el valor del parámetro OUTPUT viene en result.output, no en request.parameters[...].value después del execute. Eso explicaba el mensaje genérico “Error desconocido al insertar…” aunque el SP estuviera bien.
  • Comentarios en el SQL: Añadí comentarios cortos al script para acordarme en revisiones qué hace cada bloque (sin tocar la lógica).

Problemas encontrados

  • Problema 1: Tras cambiar los SPs, la API seguía fallando en el insert o no interpretaba bien éxito / duplicado.
  • Problema 2: En un momento el nombre de la BD del script (EmpresaDB) no coincidía con el default del código o con el .env, lo que confunde si no se revisa.

Solución aplicada

  • Solución al problema 1: Actualizar el servidor SQL con el database.sql nuevo y, en Node, leer outResultCode desde result.output tras execute().
  • Solución al problema 2: Dejar documentado / unificado DB_DATABASE=EmpresaDB (y volver a ejecutar el script en la instancia que usa el equipo).

Próximos pasos

  • Probar en conjunto: GET lista, POST nuevo empleado, POST duplicado, y revisar si hay filas nuevas en DBErrors solo ante errores reales del motor.
  • Actualizar el análisis de resultados con la tabla de cumplimiento y las métricas si el profe las pide. 

Comentarios

Publicar un comentario

Entradas más populares de este blog

Bitácora de desarrollo #2 Sesión: Backend Node.js + Express + MSSQL

Autor: Santiago Villarreal Fecha: 17 de marzo de 2025 Hora de inicio: 14:00 Hora de fin: 17:00 Horas trabajadas: 3.5 h Descripción de avances En esta sesión se implementó el backend de la aplicación de empleados usando Node.js, TypeScript y Express, conectado a una base de datos Microsoft SQL Server en Docker. Trabajo realizado: - Base de datos: Se creó el procedimiento almacenado sp_insert_empleado en database.sql, que recibe @Nombre y @Salario, verifica duplicados y devuelve un código de resultado mediante un parámetro OUTPUT. - Estructura del backend: Se definió una arquitectura modular en proyecto-1/backend/ con carpetas para config, controllers, routes, types y utils. - Configuración: Se configuró el pool de conexiones MSSQL como singleton en db.ts, usando variables de entorno para credenciales. API REST: GET /empleados: Llama a sp_list_empleados y devuelve la lista ordenada por nombre. POST /empleados: Valida el body, llama a sp_insert_empleado y maneja el caso de nombre duplicad...
Leer más

Entrada sesión de prueba y error #1

Sesión 1 Configuración inicial del proyecto Hora de inicio: 11:00 pm Hora de fin: 12:00 AM Horas trabajadas: 1h Descripción de avances En esta primera sesión se trabajó en la documentación del proyecto: Formato del README: Se revisó y formateó el archivo README.md del proyecto para que cumpla con Markdown. Se corrigieron bloques de código SQL, se eliminaron etiquetas innecesarias y se organizaron encabezados, listas y viñetas. Enlace a la bitácora: Se añadió en el README el enlace a esta bitácora en la sección 6.1 (Bitácora de desarrollo), para que quede documentada la ubicación del registro de trabajo. Problemas encontrados El README original tenía etiquetas en todo el documento, probablemente de una exportación desde PDF. El bloque SQL del CREATE TABLE no estaba cerrado correctamente. El ejemplo de INSERT no estaba dentro de un bloque de código. Solución aplicada Se eliminaron todas las etiquetas [page:1]. Se cerraron correctamente los bloques de código con ```. Se aplicó una jerarqu...
Leer más

Bitácora de desarrollo #4 Sesión: Conexión backend con frontend y testing

Hora de inicio: 6:30pm Hora de fin: 8pm Horas trabajadas: 1h 30m Descripción de avances Se conectó el frontend con el backend, ahora hace API calls hacia el backend que realiza cosas en la base de datos. Elemento 1: Se arreglaron unos errores en el API relacionados a que faltaba el campo port en el archivo db.ts para la configuración de la conexión con la base de datos. Elemento 2: Se implementaron las API calls en el frontend hacia el backend, todo ya está funcional. Elemento 3: Se componetizó mejor, haciendo la tabla un componente por separado de la página principal. Elemento 4: Flujo probado y funciona satisfactoriamente Problemas encontrados: Problema 1: Se tuvo problemas con la conexión inicialmente del backend con el frontend, aunque todas las variables de entorno estuvieran seteadas. Solución: en el .env del frontend estaba el puerto 3000 y era el 3001. Próximos pasos: Hacer documentación.
Leer más