Saltar a contenido

0001. Panel administrativo como SPA Vue 3 con TypeScript estricto

Estado: Aceptado Fecha: 2026-10-21 Autor: Duval Alcivar Módulo(s) afectado(s): panel administrativo (core-admin): arranque, build y tipado Evidencia: commit 3b81172 (2026-10-21) y package.json, tsconfig.json

Contexto

El panel administrativo de SIGFA 2.0 debía operar la API de core-svc-identidad desde una interfaz propia. El repositorio partía de una copia del template Tabler (Bootstrap), que no ofrecía un modelo de aplicación para consumir una API JSON ni una red de tipos sobre las respuestas.

Decisión

Se construye una SPA independiente en Vue 3.5.44 con Vite y TypeScript en modo strict. El script de build es vue-tsc --noEmit && vite build: el typecheck corre antes de Vite, así que un error de tipos impide generar el artefacto. El alias @ apunta a src y la única variable de entorno es VITE_API_BASE_URL. La API de identidad permanece pura: el panel solo la consume.

Alternativas descartadas

  • Mantener el renderizado del lado del servidor del template anterior — no hay evidencia de esa implementación en el repositorio y el panel necesita consumir una API JSON con estado de sesión en el cliente.
  • Compilar sin typecheck — el build es la única red del proyecto (no hay tests ni linter); sin vue-tsc un error de tipos llegaría al artefacto.

Consecuencias

Un error de tipos rompe el build, lo que compensa en parte la ausencia de tests y linter. El desacople es total: el panel no conoce el backend más allá de sus endpoints, así que un cambio de contrato se descubre en ejecución y no al compilar.


Documentado a posteriori desde el código y el historial de Git del repositorio core-admin; la fecha corresponde al commit que introdujo la decisión, no a la fecha de publicación en este sitio (2026-11-09).