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-tscun 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).