Documentación viva · mapa técnico

Cómo está construida LIA, capa a capa

Las capas del sistema, de la pantalla a la base de datos, lo que hace cada bloque, con qué tecnologías, dónde vive en el repositorio y los caminos que sigue una petición.

  • 59bloques técnicos
  • 10capas
  • 7recorridos comentados
  • 57módulos de infraestructura
  • 63dominios de negocio atendidos

Versión 4.6.010 de noviembre de 2026actualizado en cada commit, a partir de los datos del repositorio

Visión general

Las capas del sistema

De la pantalla a la base de datos. Pasa el cursor por un bloque para trazar sus vínculos, haz clic para ver sus tecnologías, sus archivos y sus decisiones.

se apoya enusado por

Clientes

Lo que la persona toca: la aplicación web, su modo sin conexión, las carcasas móviles y los canales de mensajería.

Perímetro

Lo que se sitúa entre Internet y la aplicación: túnel, política de contenido, límite de tasa, sesiones.

API y base de la aplicación

La API FastAPI dividida en dominios de negocio, su flujo SSE, su arranque ordenado y su configuración.

Orquestación de agentes

El grafo LangGraph: enrutamiento, planificación o bucle ReAct, validación humana, herramientas y respuesta.

Modelos y costes

El acceso a los modelos de cada proveedor, el razonamiento, las salidas estructuradas, los embeddings y la contabilidad de cada llamada.

Integraciones

Los clientes de los servicios externos, los protocolos abiertos, el entorno aislado y los canales de voz.

Tareas en segundo plano

Lo que se ejecuta sin petición: programador de tareas de líder único, motor proactivo, tareas duraderas, autodiagnóstico.

Datos

Dónde vive el estado: PostgreSQL y pgvector, Redis, archivos, y los registros de lo que LIA ha hecho, leído y decidido.

Observabilidad

Medir, ver, alertar, revisar: métricas, dashboards, alertas, logs, trazas.

Entrega

Cómo el código se convierte en un servicio: imágenes, integración continua y sus guardas, release cualificada, instalador, demostrador.

Recorridos

Elige un escenario: sus pasos se iluminan uno a uno en el mapa.

Capas

Haz clic en una capa para aislarla.

Los recorridos

El camino de una petición, una llamada, una entrega

Cada paso nombra el bloque que actúa y lo que garantiza.

El recorrido de un mensaje de chat

Del teclado a la pantalla, pasando por el grafo: una petición, un flujo, ningún token expuesto.

  1. Aplicación web
    El navegador envía el mensaje a la API de su propio origen.
  2. Túnel, CSP y límite de tasa
    El túnel lo encamina; se comprueba la tasa de peticiones del llamante.
  3. Sesiones y autenticación
    La cookie de sesión se valida en el servidor.
  4. API FastAPI por dominios
    La ruta del chat abre un flujo y arranca el grafo.
  5. Grafo LangGraph
    El estado de la conversación se recarga desde su checkpoint.
  6. Enrutador
    La petición se clasifica y las herramientas se puntúan.
  7. Planificador y ejecutor
    Se escribe un plan, se valida y se ejecuta en paralelo.
  8. Herramientas y manifiestos
    Cada herramienta pasa la puerta de autoridad y se inscribe en el registro.
  9. Clientes de conectores
    Se llama al proveedor, sin ninguna transacción de base de datos abierta.
  10. Síntesis de la respuesta
    La respuesta se sintetiza a partir de los resultados.
  11. Streaming SSE
    Llega palabra a palabra, con su coste, por el mismo flujo.

Una llamada al modelo, de principio a fin

Limitada antes, traducida para el proveedor, tarificada en su momento, trazada después.

  1. Prompts versionados
    Se ensambla el prompt: lo estable primero, una sola frontera de caché.
  2. Contabilidad y límites
    Se consultan los dos límites — cuenta e instancia — antes del gasto.
  3. Razonamiento
    La intención de razonamiento se traduce para ese modelo concreto.
  4. Fábrica de modelos
    El cliente nativo del proveedor envía la petición.
  5. Salidas estructuradas
    Una salida cortada por el límite de tokens se convierte en un rechazo explícito.
  6. Contabilidad y límites
    El uso se lee una sola vez y se tarifica según la franja horaria de la llamada.
  7. Registros trazables
    Los parámetros realmente enviados se incorporan al registro de la llamada.
  8. Métricas
    Tokens, latencia y coste se convierten en métricas.

Una tarea proactiva de fondo

Un solo líder, un jitter, una reclamación, un envío liquidado a partir de su resultado.

  1. Programador de líder único
    El líder lanza el barrido, desplazado por su jitter.
  2. Motor proactivo
    Se seleccionan las cuentas elegibles bajo todas las reglas.
  3. Clientes de conectores
    Se leen las fuentes, cada una en una transacción corta.
  4. Fábrica de modelos
    El mensaje se redacta dentro de los límites de gasto.
  5. Registros trazables
    El envío se reclama antes de salir.
  6. Notificaciones push
    La notificación sale hacia el navegador o el teléfono.
  7. Registros trazables
    El efecto se liquida a partir del resultado real del envío.

Una sesión Live delegada

El recorrido delegado: el navegador habla con el proveedor y cada petición vuelve al grafo.

  1. Aplicación web
    La persona abre una sesión Live.
  2. Transportes Live
    La API emite un identificador de un solo uso y renderiza el mandato de la voz.
  3. Transportes Live
    El navegador abre el transporte del proveedor (WebSocket o WebRTC).
  4. API FastAPI por dominios
    Una petición delegada se convierte en un turno de chat normal.
  5. Grafo LangGraph
    El grafo la ejecuta con sus validaciones y sus registros.
  6. Transportes Live
    La respuesta, acotada y aplanada, se devuelve a la voz.
  7. Tareas duraderas
    Al final, un cierre único archiva, calcula el coste y transmite.

Del commit a producción

Cada guarda se ejecuta antes del push; nada se publica sin cualificación.

  1. Integración continua y guardas
    El hook y la CI ejecutan los mismos comandos de Task: lint, ratchets, tests.
  2. Integración continua y guardas
    Con el tag, las imágenes candidatas se construyen y se etiquetan por huella.
  3. Release, despliegue e instalador
    Una instalación desechable cualifica al candidato.
  4. Release, despliegue e instalador
    La release verifica las pruebas y publica las etiquetas de versión.
  5. Imágenes y composición
    Las imágenes fijadas se descargan en el servidor.
  6. Release, despliegue e instalador
    El despliegue desacoplado escribe su veredicto en un archivo que luego se relee.
  7. Demostrador
    El demostrador se vuelve a desplegar y se verifica.

Ver, alertar, autodiagnosticarse

Cada señal tiene un lector; una alerta tiene un runbook; LIA lee sus propias pruebas.

  1. Métricas
    Los procesos publican sus métricas, memoria incluida.
  2. Logs
    Los logs estructurados, sin datos personales, llegan a Loki.
  3. Dashboards
    Grafana muestra cada subsistema.
  4. Alertas
    Una alerta sale con su runbook.
  5. Autodiagnóstico
    LIA reúne las pruebas del incidente y lo diagnostica.

Ejecutar una orden de aplicación

Identidad duradera y condiciones actuales; una continuación abierta sigue pendiente.

  1. Aplicación web
    El cliente usa el catálogo de operaciones ofrecido a esta cuenta.
  2. Herramientas y manifiestos
    La declaración fija operación, esquema, alcance y capacidades requeridas.
  3. Órdenes de aplicación duraderas
    La preparación vincula valores anteriores y posteriores, digest, actor, origen y caducidad en una orden cifrada.
  4. Validación y borradores
    El control de efectos verifica la aprobación exacta cuando la operación la requiere.
  5. Órdenes de aplicación duraderas
    La ejecución vuelve a leer permisos y capacidades; el claim protegido por token y el compare-and-set del servicio de origen protegen sus respectivas fronteras.
  6. Sesiones y autenticación
    Una continuación privada queda vinculada a la sesión y, si procede, al dispositivo indicado; los secretos quedan fuera del modelo.
  7. Órdenes de aplicación duraderas
    Committed, waiting, conflicto, fallo y cancelación siguen separados; una respuesta perdida no se vuelve a ejecutar automáticamente.
  8. Aplicación web
    Una señal dirigida invalida los recursos afectados; el cliente repite sus consultas autenticadas.