Cómo se crean y verifican las reglas de Scanara

Cómo evalúa Scanara la documentación con OPA y Rego

Las comprobaciones de cumplimiento a nivel documental de Scanara se ejecutan sobre Open Policy Agent (OPA). OPA evalúa la documentación técnica frente a las obligaciones del Reglamento (UE) 2024/1689. Esto sigue el mismo enfoque policy-as-code que se usa en todo el ecosistema OPA: reglas declarativas, evaluación determinista y un resultado auditable en todo momento. Esto se ejecuta junto con el escaneo de código fuente de Scanara. El escaneo de código comprueba lo que hace el código. OPA comprueba lo que dice la documentación.

Cada archivo de documentación sigue los mismos pasos. Primero, Scanara lo analiza y detecta su idioma (se admiten 8 idiomas de la UE). Después lo normaliza en un documento de entrada estructurado: secciones, encabezados, texto extraído. OPA evalúa este documento estructurado frente a un paquete de políticas Rego compilado.

Scanara genera estas reglas a partir de un mapeo canónico entre el texto de los artículos del Reglamento (UE) 2024/1689 y requisitos verificables automáticamente. Ninguna regla se escribe a mano por repositorio. Cada regla se remonta a un artículo, apartado y punto concretos. La evaluación produce un hallazgo por obligación: cumplida, ausente o parcial. Estos hallazgos se incorporan al informe de cumplimiento junto con los hallazgos de código fuente.

El siguiente ejemplo muestra el patrón. Está simplificado con fines de documentación pública. El conjunto de reglas en producción cubre docenas de categorías de obligaciones, además de detección multilingüe, ponderación de gravedad y comprobaciones de coherencia entre documentos que no se muestran aquí.

package eu_ai_act.example.article_11

# Illustrative pattern only — simplified for public documentation.
# Scanara's production ruleset covers dozens of obligation categories with
# multi-language detection, severity weighting, and cross-document
# consistency checks not shown here.

default satisfied := false

# A document satisfies this (illustrative) Article 11 check when its parsed
# sections include the required topic, with non-empty content.
satisfied if {
	some section in input.document.sections
	section.topic == "risk_management_process"
	count(trim_space(section.content)) > 0
}

finding := {
	"article": "11",
	"obligation": "technical_documentation.risk_management_process",
	"status": "satisfied",
} if satisfied

finding := {
	"article": "11",
	"obligation": "technical_documentation.risk_management_process",
	"status": "missing",
	"severity": "high",
} if not satisfied

Juntos, ambos motores detectan automáticamente 66 artículos del Reglamento (UE) 2024/1689: 44 detectables en código y 22 a nivel documental mediante OPA. La cobertura abarca los 8 idiomas de la UE. Los hallazgos de ambos motores se incorporan directamente al dossier de cumplimiento generado. La trazabilidad de la evidencia se remonta a un resultado de escaneo real, no a una autoevaluación.