EVENTFLOW FE · DOCUMENTACIÓN TÉCNICA · 07
Arquitectura Operacional
EventFlow FE separa la ejecución fiscal de la observación operacional. La transacción fiscal permanece bajo responsabilidad del sistema de facturación y de su límite de integración con SIFEN; la evidencia operacional se procesa de forma independiente mediante un límite de runtime separado.
Principio arquitectónico
La ejecución fiscal y la observación operacional son responsabilidades separadas.
EventFlow FE es responsable del ciclo de facturación electrónica dentro de su entorno fiscal: preparación del documento fiscal, representación electrónica, firma digital, generación del QR, envío a SIFEN, gestión de la respuesta de la autoridad y representación del estado fiscal resultante.
La evidencia operacional se observa fuera de ese límite transaccional y es procesada de manera independiente por el runtime. Una operación fiscal no debe depender de la disponibilidad del sistema que la observa. El análisis operacional, la persistencia y la recuperación pueden evolucionar de forma independiente sin modificar la ruta de la transacción fiscal.
Dos planos operacionales
Plano de transacción fiscal
Es responsable de la ejecución empresarial y regulatoria de la facturación electrónica y de hacer avanzar cada documento a través del ciclo de vida aplicable en SIFEN.
- Preparación del documento fiscal
- Generación del documento electrónico
- Firma digital
- Generación del QR
- Envío a SIFEN
- Gestión de la respuesta de la autoridad
- Representación del estado fiscal
Plano de observación operacional
Consume evidencia operacional producida por el sistema fiscal mediante una ruta de procesamiento delimitada de forma independiente.
- Observación de evidencia operacional
- Procesamiento independiente del runtime
- Representación operacional persistente
- Procesamiento idempotente
- Recuperación entre ejecuciones del runtime
- Continuidad de trazas operacionales
- Aislamiento de fallas respecto de la ejecución fiscal
Arquitectura conceptual
La arquitectura pública está definida por tres límites explícitos de responsabilidad.
El diagrama expresa responsabilidad arquitectónica, no implementación interna. Los contratos públicos se definen mediante límites, comportamiento observable y garantías validadas.
Capa de Integración del Producto
La Capa de Integración del Producto preserva la semántica de dominio de EventFlow FE mientras presenta la actividad operacional mediante límites estables de integración con el runtime.
Los conceptos fiscales y su ejecución permanecen bajo responsabilidad de EventFlow FE. La capa de integración observa evidencia operacional relevante y la traduce para su procesamiento por el runtime sin transferir la responsabilidad sobre la ejecución de facturas, la comunicación con SIFEN ni las respuestas de la autoridad fiscal.
Este límite mantiene la arquitectura compartida del runtime de EventFlow independiente de protocolos fiscales e implementaciones específicas del producto, mientras EventFlow FE conserva la responsabilidad sobre sus reglas fiscales.
Límite independiente del runtime
EventFlow Core Runtime consume evidencia operacional a través del límite de integración del producto y mantiene continuidad de procesamiento de forma independiente respecto del ciclo transaccional fiscal de EventFlow FE. El procesamiento del runtime puede ser durable, reiniciable e idempotente sin requerir que la transacción fiscal original sea ejecutada nuevamente.
Matriz de responsabilidades
| Responsabilidad | EventFlow FE | Capa de Integración del Producto | Runtime Operacional |
|---|---|---|---|
| Creación del documento fiscal | Responsable | — | — |
| Firma digital y generación del QR | Responsable | — | — |
| Interoperabilidad con SIFEN | Responsable | — | — |
| Gestión de la respuesta fiscal | Responsable | — | — |
| Observación operacional | Fuente | Límite | Procesador |
| Traducción de dominio | — | Responsable | — |
| Procesamiento durable del runtime | — | — | Responsable |
| Idempotencia del runtime | — | — | Responsable |
| Recuperación del runtime | — | — | Responsable |
Aislamiento de fallas
La disponibilidad del runtime no es un requisito previo para la ejecución de un documento fiscal.
Las fallas que afectan la comunicación con SIFEN pertenecen al dominio de la transacción fiscal; las fallas que afectan la observación operacional o la persistencia del runtime pertenecen al dominio del runtime operacional. La recuperación del runtime no requiere repetir la ejecución fiscal.
Independencia tecnológica
La arquitectura separa la semántica de dominio del producto de las tecnologías de transporte, almacenamiento y runtime. EventFlow FE permanece especializado para su entorno fiscal mientras el runtime compartido opera mediante límites estables de integración del producto.
La interoperabilidad con SIFEN permanece sujeta a los formatos, mecanismos de seguridad y requisitos de comunicación del entorno paraguayo de facturación electrónica. La independencia tecnológica se aplica al límite entre esos requisitos específicos del producto y la arquitectura compartida del runtime.
Límite de la arquitectura pública
Esta documentación expone la arquitectura mediante responsabilidades, límites, comportamiento observable y garantías validadas. Los algoritmos propietarios del runtime, los modelos internos de procesamiento de conocimiento, la semántica privada de estado, los esquemas específicos de implementación y la composición del runtime a nivel de código permanecen fuera de la especificación pública.