Stored Procedures: empleados y movimientos (DB)

Bitácora de desarrollo Control de Vacaciones


Sesión 1 Implementación completa de DB, API y Web (empleados y movimientos)


Fecha: 25-26 de abril de 2026


Hora de inicio: 09:00 pm


Hora de fin: 12:21 am


Horas trabajadas: 3h


Descripción de avances

- Stored Procedures DB: Se implementaron los SP de empleados (`spEmployee_GetAll`, `spEmployee_Insert`, `spEmployee_Update`, `spEmployee_DeleteLogical`, `spEmployee_GetById`) y movimientos (`spMovement_GetByEmployee`, `spMovement_Insert`) siguiendo el estándar del curso, con trazabilidad, `BEGIN TRY/CATCH`, `@outResultCode` y validación de saldo negativo.

- Fix seed UTF-8: Se corrigió `seed_xml.sql` para resolver problemas de codificación con tildes y ñ al cargar datos desde XML.

- DatabaseService y JWT Guard: Se agregaron los métodos del `DatabaseService` en NestJS para invocar cada SP, y se creó `jwt.guard.ts` para proteger los endpoints con validación de token Bearer.

- CRUD empleados y movimientos (API): Se implementaron controladores, servicios y DTOs (`CreateEmployeeDto`, `UpdateEmployeeDto`, `CreateMovimientoDto`) con validaciones de entrada y extracción de usuario autenticado e IP para trazabilidad completa.

- Cliente API y login (Web): Se centralizó la comunicación HTTP en `apps/web/lib/api.ts` con manejo automático del token JWT. Se reescribió la pantalla de login con verificación de disponibilidad del backend y mensajes de error del catálogo.

- Páginas de empleados y movimientos (Web): Se implementaron las vistas principales con listado, filtros, modales de inserción/edición/borrado y la página de movimientos por empleado, sin exponer IDs internos al usuario.


Problemas encontrados

- El script de seed fallaba con caracteres especiales en español debido a codificación incorrecta.

- En entorno local, NestJS recibía la IP como `::1` (IPv6 loopback) en lugar de `127.0.0.1`.

- El componente `MovimientosPage` fallaba en SSR porque `useSearchParams` requiere un boundary `Suspense` en Next.js App Router.


Solución aplicada


- Se corrigió el encoding de `seed_xml.sql` para compatibilidad UTF-8 con SQL Server.

- Se normalizó la IP en el servicio: si llega `::1` o `::ffff:127.0.0.1` se reemplaza por `127.0.0.1` antes de pasarla al SP.

- Se envolvió `MovimientosContent` en un `<Suspense>` dentro del componente raíz `MovimientosPage`.

Próximos pasos


- Verificar que todos los eventos requeridos se registren en `BitacoraEvento`.

- Implementar bloqueo de login por intentos fallidos.

- Ejecutar los casos de prueba del checklist (Fase 6).

- Documentar instrucciones de ejecución local.


Comentarios

Publicar un comentario

Entradas más populares de este blog

Bitácora Sesión 1 Monorepo Vacation Control + entorno local

Bitácora – Sesión 1 Título: Monorepo Vacation Control + entorno local Hora de inicio: 12:30 pm Hora de fin: 3:30 pm Horas trabajadas: 3 horas Descripción de avances • Monorepo Turborepo en la raíz: turbo.json, npm workspaces (apps y packages), scripts dev, build, lint, format, db:up, db:down y db:logs. • Paquetes compartidos: types, config y eslint-config (tipos y ESLint compartidos). • Frontend en apps/web: Next.js 15 con App Router, TypeScript, Tailwind; layout con menú; páginas de ejemplo en inicio, login y empleados (datos de prueba, sin API todavía). • Backend en apps/api: NestJS con configuración global; endpoint de salud GET /health; módulos iniciales auth, employees, movements, logs, errors y database (solo estructura, sin lógica de negocio ni ORM). • Base de datos: Docker Compose con SQL Server 2019, puerto 1433 y volumen persistente; variables desde .env en la raíz. • Documentación en README: cómo instalar, correr en desarrollo, levantar Docker y qué hay en cada carpeta. • Va...
Leer más

Bitácora Sesión 3 - Backend: CORS, JWT, SQL y auth API completa

Bitácora Sesión 3 - Backend: CORS, JWT, SQL y auth API completa Hora inicio: 11:40pm Hora final: 1:00am Trabajo total: 1h 20m Descripción de avances: Se configuró CORS en NestJS para poder utilizarlo eventualmente en el frontend sin problemas y evitar potenciales problemas de seguridad. Se integró el paquete mssql y se creó un DatabaseService que ejecuta stored procedures y scripts según el diseño del repo. Se crearon los endpoints para login y logout (auth), usando JWT en NestJS y DTOs. Se hace comprobación, mensajes de la bitácora, validaciones, etc. Problemas encontrados: No estaban sirviendo los tipos que daba mssql. Soluciones aplicadas: Se crearon unos tipos propios en el código, y se descubrió la dependencia @types/mssql para el workspace. Próximos pasos: Consumir el POST /auth/login-availability y el POST /auth/login desde Next.js y manejar el JWT.
Leer más

Bitácora #5: Detalles finales, pruebas y fixes

  Bitácora de desarrollo Control de Vacaciones Sesión 5 Detalles finales, pruebas y cambios mínimos Fecha: 26 de abril de 2026 Hora de inicio: 9:00 pm Hora de fin: 11:00 pm Horas trabajadas: 2h Descripción de avances - Se estuvo las 2 horas probando la aplicación y buscando problemas que se hayan tenido a la hora de desarrollo. - Se leyó todos los requerimientos para verificar que todo sirviera y estuviese correcto. - Se eliminaron algunos .gitkeep que se pusieron inicialmente para las primeras etapas de desarrollo. Problemas encontrados - Inicialmente tuve un problema corriendo el docker de mssql, aunque ya lo había corrido anteriormente estaba teniendo un problema (salía que la plataforma no era compatible con mi dispositivo) Solución aplicada - Se anadió un parámetro de plataforma en el docker-compose.yml con linux/arm64, ya que ambas de nuestras computadoras son ARM64. Próximos pasos - Hacer la documentación.
Leer más