Goliat · Arquitectura de la aplicación · Diagrama

Inventario

La Function consulta Azure y publica un JSON completo en Blob Storage, sin acceder a PostgreSQL.
El backend lee y valida el documento, normaliza 69 informes de origen en 73 vistas y publica un snapshot en una transacción.
Actualizar solicita una generación autenticada, espera la publicación, importa el documento y recarga la web.
Un fallo de importación conserva el snapshot anterior; el bloqueo compartido coordina las actualizaciones manuales.

FinOps

El backend consulta Azure Cost Management con su identidad y las suscripciones autorizadas.
Los gastos no se importan a las tablas de inventario: la caché de consulta reside temporalmente en el proceso web.
Las monedas se mantienen separadas. Los permisos insuficientes y los datos parciales se muestran explícitamente.

Acceso y operación

Auth.js gestiona el acceso Entra ID o demo; páginas y API comprueban sesión y permisos en el servidor.
Administración requiere permisos de administrador de Goliat y consulta los servicios mediante las identidades del servidor.
DASHBOARD_AUTH_ENABLED=false desactiva explícitamente la protección del dashboard; no es un valor adecuado para inventarios privados publicados.
Las credenciales cloud y PostgreSQL permanecen en el servidor.

Despliegue y desarrollo

iac/ despliega la Function, Storage, la web y PostgreSQL; el otro diagrama documenta esos recursos de referencia.
db:init prepara el esquema antes de activar la web. Readiness verifica el esquema y la web no ejecuta DDL al arrancar.
db:seed carga inventario ficticio para desarrollo sin credenciales cloud.
Este diagrama explica el flujo lógico; los módulos de normalización forman parte del backend, no son otro servicio desplegado.