Domů Procházet Nápověda
Přihlásit se
nekomataokayu
/
ani67
1
0
Rozštěpit 0
Soubory Úkoly 0 Pull Requesty 0 Wiki
Strom: ca9afa5c49
Větve Značky
ani67
/
docs
/
UTB_API_MIGRATION.md

UTB_API_MIGRATION.md 4.8 KB
Historie Surový

Migración a Autenticación API UTB

Estado: ✅ Completado

1. Variables de Entorno

Archivo: .env

  • Agregar UTB_API_URL=https://sai.utb.edu.ec/v2/ws/auth/login
  • Agregar UTB_API_APP_ID=6d834518ee8832b9455d3887aa0dc1a369bccee2d017812994ab066faae42067
  • Agregar UTB_API_APP_TOKEN=c9449f3452c6645081282a01240c0679eb1ca1e440eebf322eb23d5f2260c2d4

2. Configuración

Archivo: src/lib/config.ts

  • Agregar sección utbApi
  • Agregar validación de credenciales en logger

3. Cliente API UTB

Archivo: src/lib/utb-api.ts (nuevo)

  • Crear función authenticateUser(username: string, password: string)
  • Configurar headers: X-App-Id, X-App-Token, Content-Type
  • Manejo de respuesta exitosa (200)
  • Manejo de errores (400, 401, 405)
  • Retornar interface UTBAuthResponse

4. Schema Prisma

Archivo: prisma/schema.prisma

  • Agregar campo identificacion String? @unique al modelo User
  • Agregar campo isExternalAuth Boolean @default(false) al modelo User
  • Modificar email String? @unique (hacerlo opcional)
  • Modificar password String? (hacerlo opcional)

5. Migración Base de Datos

  • Ejecutar npx prisma migrate dev --name add_utb_fields
  • Verificar que la migración se aplicó correctamente

6. Lógica de Autenticación

Archivo: src/lib/auth.ts

  • Importar cliente UTB API
  • Modificar authorize():
    • Validar contra API UTB (no bcrypt)
    • Buscar usuario por identificacion o username
    • Si no existe, crear usuario nuevo
    • Mapear datos de API a modelo User
    • Mapear roles: ESTUDIANTE→PATIENT, DOCENTE→DOCTOR, ADMINISTRADOR→ADMIN
    • Si existe, actualizar datos desde API

7. Formulario de Login

Archivo: src/app/auth/login/page.tsx

  • Cambiar campo email por username
  • Actualizar labels y placeholders
  • Actualizar mensaje informativo

8. API Account Update

Archivo: src/app/api/account/update/route.ts

  • Prevenir cambio de contraseña para usuarios UTB
  • Validar que password no sea null antes de bcrypt.compare

9. Tipos TypeScript

Archivo: src/types/utb-api.d.ts (nuevo)

  • Definir UTBAuthResponse
  • Definir UTBUser
  • Definir UTBErrorResponse

10. Build y Pruebas

  • Verificar que el proyecto compila sin errores
  • Probar login con usuario estudiante
  • Probar login con usuario docente
  • Verificar creación de usuario en DB
  • Verificar actualización de datos existentes
  • Probar manejo de credenciales inválidas

11. UI de Cuenta

Archivos: src/components/account/*.tsx, src/app/account/page.tsx

  • Banner informativo para usuarios UTB
  • Mostrar identificacion (solo lectura)
  • Bloquear campos nombre/apellido para usuarios UTB
  • Email opcional y editable
  • Deshabilitar cambio de contraseña para usuarios UTB
  • Link a SAI UTB para cambios

Estado Final: ✅ COMPLETADO Y SIMPLIFICADO

Migración exitosa a autenticación API UTB.

Simplificación UTB-Only (100% dependencia API)

Decisión: El sistema ya no soporta usuarios locales. Todos los usuarios deben autenticarse mediante la API de UTB.

Cambios de simplificación realizados:

  1. Componentes de cuenta simplificados:

    • PersonalInfoSection.tsx: Siempre muestra banner UTB, campos nombre/apellido bloqueados
    • PasswordChangeSection.tsx: Solo muestra mensaje de gestión por UTB, sin campos de contraseña

  2. API de actualización simplificada:

    • Eliminados checks de isExternalAuth
    • Solo permite actualizar: email y profileImage
    • Bloquea cualquier intento de cambio de contraseña
    • Removidos imports y lógica de bcrypt no utilizados

  3. Props simplificadas:

    • Eliminado prop isExternalAuth de componentes de cuenta
    • Props de contraseña en PasswordChangeSection marcadas como opcionales por compatibilidad

Estado actual:

  • ✅ Autenticación mediante API externa
  • ✅ Sincronización automática de datos
  • ✅ Protección de campos gestionados por UTB
  • ✅ UI simplificada sin lógica condicional
  • ✅ Build exitoso sin errores
  • ✅ Código más limpio y mantenible

Campos editables:

  • ✅ Email (opcional)
  • ✅ Foto de perfil

Campos bloqueados (gestionados por UTB):

  • 🔒 Nombre
  • 🔒 Apellido
  • 🔒 Fecha de nacimiento
  • 🔒 Contraseña

Notas Importantes

  • Email opcional: Los usuarios pueden agregarlo después en /account
  • Password: Se guarda vacío para usuarios UTB (no se usa)
  • Identificación: Campo único que vincula con API UTB
  • Roles: Mapeo automático según tipo de la API
  • Reportes: Se mantienen vinculados por userId interno
  • Sin usuarios locales: Ya no se soporta autenticación local, solo UTB