TriadicFrameworks
개요

미니멀 옵저버 API

삼원 옵저버 레이어는 의도적으로 가볍습니다. 그 API는 발행하기 쉬우며, 오용하기 어렵고, 기본적으로 도메인에 구애받지 않습니다. 기존 시스템은 아키텍처 변경이나 정치적 위험 없이 참여할 수 있어야 합니다.

옵저버는 관측을 소비합니다. 요청하지 않습니다.

디자인 목표#

  • 최소한의 표면적.
  • 명시적인 단계 선언.
  • 일급 시간 및 출처.
  • 암시된 권한 없음.
  • 부분 채택 시 안전함.

API는 완전성보다 명확성을 선호합니다.

핵심 관찰 스키마#

관찰자가 제출한 모든 관찰은 다음 구조를 따라야 합니다:

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

필드 의미#

  • domain — 운영 맥락 (예: 선거, 공급망, 과학).
  • entity_id — 가장 작은 독립적으로 관찰 가능한 단위.
  • phase — 관찰의 선언된 생애 주기 단계.
  • metric — 측정되는 것.
  • value — 보고된 측정값.
  • unit — 측정 단위 또는 분류.
  • source — 관찰을 발생시키는 시스템 또는 프로세스.
  • timestamp — 이 관찰이 보고된 형태로 존재했던 시점.
  • confidence — 선언적 확신 수준 (예: 임시, 최종).
  • notes — 선택적 인간 맥락; 결코 필수는 아님.

어떤 필드도 정확성을 의미하지 않습니다. 모든 필드는 맥락을 의미합니다.

단계 선언 규칙#

  • 단계는 명시적이어야 합니다.
  • 단계는 관찰자에 의해 추론되어서는 안 됩니다.
  • 동일한 엔티티와 메트릭에 대해 여러 단계가 동시에 존재할 수 있습니다.
  • 단계 전환은 관찰되며, 강제되지 않습니다.

단계 불일치는 신호로 보존됩니다.

시간 의미#

타임스탬프는 존재를 나타내며, 섭취를 나타내지 않습니다.

  • 늦은 제출은 유효합니다.
  • 순서가 뒤바뀐 이벤트는 유효합니다.
  • 수정은 새로운 관찰이며, 덮어쓰기가 아닙니다.

시간적 불일치는 정보적입니다.

소스 의미#

소스는 식별자이지 권위가 아닙니다.

  • 여러 소스가 동일한 메트릭을 발행할 수 있습니다.
  • 상충하는 소스가 있을 것으로 예상됩니다.
  • 소스 신뢰는 관찰자 외부에 있습니다.

관찰자는 소스의 순위를 매기지 않습니다.

신뢰도 필드#

신뢰도는 확률적이지 않고 선언적입니다.

예시:

  • 임시
  • 추정
  • 감사됨
  • 인증됨
  • 보관됨

신뢰도는 단계나 출처를 무시하지 않습니다.

도메인 전문화#

도메인은 추가 필드로 스키마를 확장할 수 있지만, 다음을 해서는 안 됩니다:

  • 핵심 필드를 제거합니다.
  • 축을 축소합니다.
  • 권한을 암시합니다.

확장은 관찰 가능해야 합니다.

예시: 선거#

{
  "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"
}

예시: 공급망#

{
  "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"
}

관찰자 보장#

관찰자는 다음을 보장합니다:

  • 모든 관찰이 보존됩니다.
  • 어떤 관찰도 수정되지 않습니다.
  • 어떤 합성도 정확성을 의미하지 않습니다.
  • 모든 출력은 재생 가능합니다.

관찰자는 구조를 가시화하며, 진리를 최종적으로 제시하지 않습니다.

이 최소한의 API는 제어, 예측 또는 강제를 도입하지 않고도 도메인 간 삼중 일관성 분석을 지원하는 데 충분합니다.

단순함은 의도적입니다. 복잡성은 해석에 속하며, 방출에는 속하지 않습니다.

제공: Docsbook