Eje 3: Componentes
Visión general
El GCBoK define seis componentes centrales del stack de GitCover:
GCDMS - GitCover Document Management System
Sistema de gestión de evidencias y documentos basado en contenedores .v7g.md y sus metadatos. Cadena de herramientas: v7g-pack, v7g-verify, v7g-sign, v7g-export.
GCPN - GitCover PrimaNota
Mecanismo de metadatos para la formación de cadenas de evidencia a prueba de auditoría (predecesor/sucesor) para documentos comerciales. El término histórico PrimaNota designa una clave de ordenación que asigna a un hecho económico - p.ej. un asiento de la contabilidad por partida doble o un proceso de contabilización multiparte (cuenta por cobrar, IVA, centro de coste/distribución por objeto de coste) - una clave única de pertenencia. GCPN traslada este principio a una base UUIDv7: cada documento recibe un identificador ordenado en el tiempo (RFC 9562) y se encadena con sus documentos predecesores y sucesores mediante referencias Predecessor/Successor.
El encadenamiento se realiza de forma no cronológica: un documento registrado posteriormente puede insertarse como predecesor (Predecessor-Insert) en una cadena existente - decisivo para GoBD Rz. 80 (verificación progresiva y retrógrada). Los campos Match-Key (número de pedido, deudor, importe bruto, etc.) permiten la asociación automática de cadenas sin asignación manual.
El formato de contenedor .v7g.md combina metadatos legibles por humanos (YAML + Markdown) con datos comerciales procesables por máquina (JSON incrustado) y se almacena en repositorios Git cuyo hash de commit sirve como prueba criptográfica de integridad.
Ámbitos de aplicación más allá de la contabilidad: registros de actividades de tratamiento del RGPD (Art. 30), cadenas de incidentes NIS2, decisiones de arquitectura MADR, ciclo de vida de tokens OIDC/OAuth, OSCAL-Assessment-Results.
Protección de modelo de utilidad: Az 20 2026 000 272.7 - en vigor. Objeto protegido: estructura de datos de contenedor para una gestión de documentos comerciales basada en UUIDv7 y a prueba de auditoría, con encadenamiento dinámico Predecessor/Successor. Solicitud de patente presentada (47 reivindicaciones).
GCUCB - GitCover Unified Communication Bus
Bus de contexto basado en memoria compartida con direccionamiento V7GUID determinista. Hub central de datos entre agentes de IA, validadores OPA y sistemas de auditoría.
El problema del overhead
| Fuente | Hallazgo |
|---|---|
| RMMAP (EuroSys 2024) | Serialización = 17-72% del tiempo del flujo de trabajo |
| AgentTaxo (ICLR 2025) | 20-60% de los tokens = overhead de coordinación |
| AgentDiet (arXiv 2025) | 39,9-59,7% de los tokens de entrada son inútiles |
La solución
GCUCB elimina la serialización/deserialización repetida mediante acceso directo tipado a regiones de archivos memory-mapped. Los agentes de IA reciben structs tipados con referencias V7GUID directamente del bus - sin system prompts enormes.
OPA/Rego actúa como VPRM (Verifiable Process Reward Model): los guardrails surgen de un conjunto de reglas determinista, no del prompt engineering.
Delimitación
| Componente | Capa | Delimitación respecto a GCUCB |
|---|---|---|
| GCEP | Persistencia (Git-to-Git) | De instancia a instancia; GCUCB = bus de memoria en tiempo de ejecución |
| GCSYNC | Outbound (Git -> RAG) | Canal externo; GCUCB = bus interno |
| GCPN | Lógica de encadenamiento | Cadenas de evidencia (predecesor/sucesor); GCUCB = transporte/acceso |
GCEP - GitCover Exchange Protocol
Protocolo de intercambio de instancia a instancia entre repos Git sobre soportes diferentes. Semánticamente determinado por catálogos OSCAL y hooks/callbacks definidos mediante OPA.
Track de IETF planificado (I-D, forma corta: gcep). Solicitud de patente: 10 2025 003 359.1.
Niveles de protocolo: ACP, MCP y GCEP
GCEP no debe confundirse con los protocolos de agentes de IA. Los tres resuelven problemas distintos en niveles distintos:
(z. B. VS Code)"] -->|"Agent Client Protocol (ACP)"| B["Logik-Ebene / KI-Agent"] B -->|"Model Context Protocol (MCP)"| C["Infrastruktur- & Daten-Ebene"] C -->|"GitCover Exchange Protocol (GCEP)
mit Advisory Locks"| D["Verteilte Git-Server / VCS"] style A fill:#bbdefb style B fill:#c8e6c9 style C fill:#ffe0b2 style D fill:#f8bbd0
| Nivel | Protocolo | Dirección | Propósito |
|---|---|---|---|
| Puente de UI | ACP (Agent Client Protocol) | UI ↔ Agente | Conecta la interfaz de usuario (p. ej., VS Code) con la lógica del agente |
| Puente de contexto de IA | MCP (Model Context Protocol) | Agente ↔ Datos | Acceso estructurado del agente a las fuentes de datos (documentos, herramientas) |
| Nivel de repositorio | GCEP | Servidor ↔ Servidor | Replicación, sincronización y aseguramiento del estado entre instancias Git físicas |
La combinación es de gran relevancia para la gestión: el agente trabaja a alta velocidad mediante ACP/MCP; GCEP garantiza en el nivel de repositorio subyacente que las rutas de commit y de sincronización permanezcan consistentes.
Los Advisory Locks en la era de la IA
Los agentes de IA autónomos generan accesos de escritura con alta frecuencia. Sin un protocolo de bloqueo a nivel de Git, dos agentes que actúan en paralelo - o un agente y un empleado administrativo humano - pueden modificar los mismos repositorios simultáneamente y generar estados inconsistentes (Race Conditions).
| Aspecto | Advisory Lock | Mandatory Lock |
|---|---|---|
| Mecanismo de acción | Los procesos comprueban el estado de bloqueo voluntariamente antes de escribir | El sistema operativo impone el bloqueo de forma estricta |
| Comportamiento en caso de timeout | El agente puede reaccionar estratégicamente: posponer un subobjetivo, emitir una notificación en la UI | A menudo estados muertos del sistema (deadlocks) |
| Idoneidad para agentes de IA | Alta - el agente consulta el estado de bloqueo por adelantado (p. ej., a través de un servidor MCP-Git) | Baja - bloquea el pipeline del agente |
Un agente de IA puede consultar por adelantado el estado de bloqueo de GCEP ("¿Está este repositorio bloqueado para otro establecimiento?") y ajustar su planificación en consecuencia - en lugar de bloquearse de forma rígida.
GCAL - GitCover Advisory Lock
Mecanismo de bloqueo distribuido entre repos Git - análogo al Advisory Lock de PostgreSQL, pero a nivel de repositorio. Requisito para GCEP: antes de que dos instancias intercambien datos, un lock debe garantizar una transferencia atómica.
GCSYNC - GitCover Sync
Canal outbound desde GitCover hacia otros sistemas de almacenamiento de datos. Proporciona datos para sistemas RAG, servidores MCP y Nextcloud Shares.
Véase también: Derechos de protección y estado de las patentes en Derechos de protección. Reconocimiento de investigación en Proyecto de investigación.