Cómo está construido AXIOMA
Cómo está construido AXIOMA: búsqueda, pipeline, capas, validación, evidencia, seguridad y estado del sistema.
- Versión del producto
- AXIOMA 3.5
- Versión de la arquitectura AXIOMA (protocolo)
- v3.0.1
Búsqueda Semántica + IA
Encuentra normativa por significado, no solo por palabra exacta, con respuestas IA ancladas a evidencia
Búsqueda semántica vectorial
Cada fragmento normativo es un vector de 3,072 dimensiones (pgvector + text-embedding-3-large). La búsqueda entiende conceptos, no solo coincidencias.
Búsqueda híbrida
Combina señal léxica (texto exacto) y señal semántica (significado) para máxima precisión y cobertura.
Detector de artículos
Si buscas "artículo 82 del Código de Trabajo", AXIOMA detecta la cita y te lleva directo al fragmento canónico.
Respuesta asistida por IA
La IA sintetiza una respuesta citando los fragmentos exactos (GT:ART:*) que la sustentan. Sin alucinaciones: cada afirmación es trazable.
indemnización por despido injustificado
SemánticaGT:ART:D:1441:ART:82
94% similitud"Si el contrato de trabajo por tiempo indeterminado concluye una vez transcurrido el período de prueba, por razón de despido injustificado..."
GT:ART:D:1441:ART:78
88% similitud"La terminación del contrato de trabajo conforme a una o varias de las causas enumeradas en el artículo anterior, surte efectos..."
Respuesta IA con evidencia
El Código de Trabajo regula la indemnización por despido injustificado en el Art. 82: un mes de salario por cada año de servicios continuos...
¿Qué hace AXIOMA?
Tres pilares que garantizan confianza en la información normativa
Coherencia verificable
Reglas C1–C4 validan integridad referencial, coherencia temporal, jerarquía y semántica.
- C1: Referencias válidas
- C2: Fechas coherentes
- C3: Jerarquía correcta
- C4: Campos requeridos
Trazabilidad auditable
Cada fragmento con evidencia: fuente oficial, hash SHA-256, offsets y coordenadas PDF.
- Hash de documento
- Offsets de texto
- Página y bounding-box
- Cadena de custodia
Vigencia temporal
Consultas "at-date", historial de reformas, detección de conflictos y transitorios.
- Query por fecha
- Timeline de reformas
- Derogaciones parciales
- Ultraactividad
Validación Humana en el Loop
Interface de 3 paneles sincronizados para validar estructura jerárquica, texto canónico y región PDF original.
Estructura Jerárquica
Árbol de fragmentos
Click para seleccionar y sincronizar
Texto Canónico
Contenido validable
GT:ART:CC:1
"La personalidad civil comienza con el nacimiento y termina con la muerte; sin embargo, al que está por nacer se le considera..."
Región PDF Original
Evidencia visual
Bounding box
[72, 520, 540, 680]
Página 42 • Zoom sincronizado
Arquitectura
Qué cambia frente a los sistemas tradicionales de consulta normativa
AXIOMA vs. Sistemas Tradicionales
| Característica | Tradicional | AXIOMA |
|---|---|---|
| Identificadores | Ninguno o inconsistente | GT:NORM:, GT:ART: canónicos |
| Vigencia temporal | Manual o inexistente | Query at-date automático |
| Granularidad | Documento o artículo | Hasta inciso/párrafo |
| Validación | Ninguna o manual | Reglas de validación automatizadas |
| Trazabilidad | Inexistente | Hash SHA-256 + bbox |
| Norma↔Jurisprudencia | Desconectados | Enlaces bidireccionales |
| Búsqueda | Palabras clave exactas | Semántica + híbrida con IA |
| Jurisprudencia | PDFs sueltos | 3 niveles: decisión, casación, doctrina legal |
| Acceso programático | Sin API | API REST + API keys server-to-server |
Estándares y referentes
Lo que AXIOMA implementa y los referentes que se evaluaron para su diseño. AXIOMA no declara cumplimiento formal de ninguno de ellos.
| Estándar o referente | Relación con AXIOMA | Enlace |
|---|---|---|
| RDF (W3C) | ImplementadoModelo de datos del grafo | www.w3.org/RDF |
| OWL (W3C) | ImplementadoOntología jurídica | www.w3.org/OWL |
| JSON-LD (W3C) | ImplementadoInteroperabilidad de datos | www.w3.org/TR/json-ld11 |
| Model Context Protocol | ImplementadoAcceso para agentes de IA | modelcontextprotocol.io |
| LegalRuleML (OASIS) | Referente evaluado | www.oasis-open.org/committees/legalruleml |
| MetaLex (CEN) | Referente evaluado | www.metalex.eu |
| LKIF-Core | Referente evaluado | github.com/RinkeHoekstra/lkif-core |
¿Cómo funciona?
Pipeline de normas: 12 pasos con XAI, desde el PDF fuente hasta la publicación validada. La jurisprudencia tiene su propio pipeline de 9 pasos (ver AXIOMA-J).
Ingesta
Canon
Pre-Estructura
Segmentación
Jerarquía
Identidad
Referencias
Clasificación
Vigencias
Validación
Catálogos
Publicación
Evidencia y Trazabilidad
AXIOMA implementa SSOT: si un dato no está validado y registrado, no existe como fuente autorizada.
SSOT: fuente única de verdad
Identificadores canónicos únicos que nunca cambian
Validaciones C1/C2/C3/C4
Integridad, temporalidad, jerarquía y semántica
Evidencia por anclas
Texto, página PDF y bounding-box visual
Ejemplo de Trazabilidad
Fragmento
GT:ART:CC:1234
Fuente
Diario de Centro América, 14 sep 1963
Hash
sha256:a1b2c3...
Ubicación
Página 42, bbox: [72, 520, 540, 680]
Validación
Seguridad y Acceso Programático
Infraestructura lista para integraciones institucionales con seguridad por defecto
API Keys server-to-server
Integración programática con credenciales rotables, scopes granulares y anti-replay por timestamp firmado.
Autenticación y roles
JWT con verificación de email, control de acceso por roles (RBAC) y permisos finos por recurso.
Rate limiting por niveles
Límites diferenciados para usuarios, aplicaciones con API key y tráfico anónimo, respaldados en Redis.
Watermarking forense
Marcas invisibles en las respuestas permiten trazar filtraciones de datos al consumidor que las originó.
Papers y Documentación
Fundamentos teóricos y documentos del protocolo SSOT
AXIOMA 2
Fundamentos del Sistema
AXIOMA 2.0
Protocolo Ejecutable
AXIOMA-GT
Implementación Guatemala
AXIOMA-N v1.0
Fundamentos Doctrinales
Estado del Sistema
Estadísticas en tiempo real del corpus normativo guatemalteco
v3.0.1
Arquitectura (protocolo)
12
Pasos Pipeline
20
Capas