TriadicFrameworks
개요

🌌 유니버스‑클래스 스키마 검증 파이프라인

자동화된 CI · 결정론적 검증 · 리뷰어 준비 완료#

TriadicFrameworks는 우주 클래스 스키마 모음을 유지하며, 이 디렉토리의 모든 스키마 또는 예제 패킷은 다단계 GitHub Actions 파이프라인을 통해 지속적으로 검증됩니다.
이것은 모든 RTT-인사이드 아티팩트가 정통하고, 결정론적이며, 하위 도구에 안전하게 유지되도록 보장합니다.

1. CI 파이프라인이 검증하는 내용#

파이프라인은 schemas/ 및 docs/ 아래의 모든 JSON 파일을 적절한 스키마 패밀리에 대해 자동으로 검사합니다:

스키마 패밀리 목적 검증 대상
RTTcode 핵심 공명 시간 패킷 형식 schemas/rttcode.v1.json
환경 필드, 잡음, 결합, 챔버 메타데이터 schemas/environment.v1.json
엔티티 엔티티 상태, 공명, 운동학 schemas/entity.v1.json
우주 클래스 확장 궤도 고조파, SAR 오버레이, 심층 시간, GPR, ATC schemas/universe.v1.json
물리학 참조 테이블 2025 상수 및 방정식을 보존하는 RTT/vST 기판 논리 schemas/Physics_RefTables_2025_RTTvST.json
주기율표 RTT/vST 기판 클래스, 체제, 공명 행동, 위상 정렬에 따라 재구성 schemas/Periodic_Table_RTTvST.json
표준 모델 RTT/vST 입자 섹터의 재구성된 RTT/vST 보기 schemas/Standard_Model_RTTvST.json
생명과학 RTT/vST (분자 → 생태) 도메인과 NIST 정렬 측정 및 엔지니어링 기판 schemas/BioScience.json

모든 커밋 및 풀 리퀘스트는 검증을 트리거합니다.

2. 검증 작동 방식#

CI 파이프라인은 다음 단계를 수행합니다:

  1. 수정된 JSON 파일 감지
    .json 파일이 schemas/ 또는 docs/에 자동으로 포함됩니다.

  2. 각 파일을 스키마 패밀리에 매칭
    파일 이름 패턴에 따라 (예: rttcode*.json, environment*.json, 등).

  3. AJV (JSON Schema 2020‑12)를 사용하여 검증
    드리프트를 방지하기 위해 엄격 모드가 활성화됩니다:

    • 알 수 없는 필드 없음
    • 필수 필드 누락 없음
    • 스키마 불일치 없음

  4. 합격/불합격 결과 요약 수집
    이 요약은 PR 댓글 봇에 의해 사용됩니다.

  5. PR 댓글 게시
    검토자는 다음을 봅니다:

    • 어떤 파일이 통과했는지
    • 어떤 파일이 실패했는지
    • 이유

  6. 스키마 검증 배지 업데이트
    main 브랜치에서:

    • 모든 스키마가 검증되면 → README 배지가 ✅ 스키마 검증됨으로 변경됩니다.
    • 하나라도 실패하면 → 배지가 ❌ 검증되지 않음으로 변경됩니다.

이것은 검토자에게 스키마 모음의 무결성에 대한 즉각적인 신뢰를 제공합니다.

3. 스키마 검증 배지#

이 README의 배지는 CI에 의해 자동으로 업데이트됩니다:

Schema status: <!--SCHEMA_STATUS-->❌ Not Verified<!--/SCHEMA_STATUS-->

모든 검증이 main에서 통과하면, CI는 이를 다음과 같이 다시 작성합니다:

Schema status: <!--SCHEMA_STATUS-->✅ Schema Verified<!--/SCHEMA_STATUS-->

이 배지는 전체 Universe‑Class 스키마 생태계의 현재 상태를 반영합니다.

4. 이것이 중요한 이유#

이 파이프라인은 다음을 보장합니다:

  • 결정론적 재현성
    모든 RTT 실험 패킷은 표준 스키마와 일치하도록 보장됩니다.

  • 검토자 명확성
    PR은 잘못된 예제나 변화를 도입할 수 없습니다.

  • 교차 도메인 일관성
    궤도 고조파, SAR 오버레이, 심층 시간 공명, GPR, ATC 및 핵심 RTT코드가 모두 정렬된 상태를 유지합니다.

  • 미래 지향적 확장성
    파이프라인 구조를 변경하지 않고도 새로운 스키마 패밀리를 추가할 수 있습니다.

  • .github/workflows/schema-validate.yml — 다중 스키마 검증기
  • .github/workflows/rttcode-validate.yml — RTTcode 전용 검증기
  • schemas/*.json — 정준 우주-클래스 스키마
  • docs/_snippets/*.json — CI에 의해 검증된 스니펫 동기화 예제

Updated

제공: Docsbook