API de Observador Mínimo

La Capa de Observador Triádico es intencionalmente ligera. Su API está diseñada para ser fácil de emitir, difícil de malutilizar y agnóstica al dominio por defecto. Los sistemas existentes deberían poder participar sin cambios arquitectónicos ni riesgos políticos.

El observador consume observaciones. No las solicita.

Ziele des Designs#

• Minimale Oberfläche.
• Explizite Phasendeklaration.
• Erstklassige Zeit und Quelle.
• Keine implizierte Autorität.
• Sicher bei teilweiser Übernahme.

Die API bevorzugt klarheit über Vollständigkeit.

Esquema de Observación Central#

Cada observación enviada al observador debe conformarse a la siguiente estructura:

{
  "domain": "string",
  "entity_id": "string",
  "phase": "string",
  "metric": "string",
  "value": "number|string",
  "unit": "string",
  "source": "string",
  "timestamp": "ISO-8601",
  "confidence": "string",
  "notes": "string (optional)"
}

Semántica de Campo#

• domain — El contexto operativo (por ejemplo, elecciones, cadena_de_suministro, ciencia).
• entity_id — La unidad más pequeña observable de forma independiente.
• phase — Etapa del ciclo de vida declarada de la observación.
• metric — Lo que se está midiendo.
• value — La medición reportada.
• unit — Unidad de medida o clasificación.
• source — Sistema o proceso que emite la observación.
• timestamp — Cuándo existió esta observación en su forma reportada.
• confidence — Nivel de certeza declarativa (por ejemplo, provisional, final).
• notes — Contexto humano opcional; nunca requerido.

Ningún campo implica corrección. Todos los campos implican contexto.

Reglas de Declaración de Fase#

• La fase debe ser explícita.
• La fase no debe ser inferida por el observador.
• Puede haber múltiples fases simultáneamente para la misma entidad y métrica.
• Las transiciones de fase se observan, no se imponen.

El desacuerdo de fase se preserva como señal.

Semántica del Tiempo#

La marca de tiempo representa existencia, no ingestión.

• Las presentaciones tardías son válidas.
• Los eventos fuera de orden son válidos.
• Las correcciones son nuevas observaciones, no sobrescrituras.

La inconsistencia temporal es informativa.

Semántica de Fuentes#

Las fuentes son identificadores, no autoridades.

• Múltiples fuentes pueden emitir la misma métrica.
• Se esperan fuentes conflictivas.
• La confianza en la fuente es externa al observador.

El observador nunca clasifica las fuentes.

Campo de Confianza#

La confianza es declarativa, no probabilística.

Ejemplos:

• provisional
• estimado
• auditado
• certificado
• archivado

La confianza no anula la fase o la fuente.

Spécialisation de domaine#

Les domaines peuvent étendre le schéma avec des champs supplémentaires, mais ne doivent pas :

• Supprimer des champs essentiels.
• Réduire les axes.
• Impliquer une autorité.

Les extensions doivent rester observationnelles.

Ejemplo: Elecciones#

{
  "domain": "elections",
  "entity_id": "MI-Wayne-P042",
  "phase": "counted",
  "metric": "ballots_cast",
  "value": 1832,
  "unit": "count",
  "source": "county_tabulator_v3",
  "timestamp": "2026-11-03T21:14:00Z",
  "confidence": "provisional",
  "notes": "late upload due to network outage"
}

Ejemplo: Cadena de Suministro#

{
  "domain": "supply_chain",
  "entity_id": "DC-ATL-07",
  "phase": "in_transit",
  "metric": "units_shipped",
  "value": 4200,
  "unit": "items",
  "source": "logistics_system_A",
  "timestamp": "2026-04-12T09:30:00Z",
  "confidence": "reported"
}

Garantías del Observador#

El observador garantiza que:

• Todas las observaciones se preservan.
• Ninguna observación es modificada.
• Ninguna síntesis implica corrección.
• Todos los resultados permanecen reproducibles.

El observador hace visible la estructura, no la verdad final.

Esta API mínima es suficiente para apoyar el análisis de coherencia triádica a través de dominios sin introducir control, predicción o imposición.

La simplicidad es intencional. La complejidad pertenece a la interpretación, no a la emisión.