제 4 장: ITU-T Y.4900 KPI 프레임워크

지속가능 스마트시티 KPI, oneM2M 정합 데이터 봉투, UN SDG 11.1-11.7 목표 U4SSC 정합.

본 장은 스마트 시티(WIA-CITY-001) 표준의 ITU-T Y.4900 KPI 프레임워크 영역을 다룬다. 스마트 시티 표준의 봉투 형식·API 표면·프로토콜 교환은 WIA 표준 체계 안에서 다른 호스트와 상호운용되도록 설계되었다. `spec/` 안의 각 Phase 파일은 하나의 아키텍처 계층(봉투·REST 표면·연합·생태계)을 문서화하며, 본 장은 그 계층의 ITU-T Y.4900 KPI 프레임워크 부분을 집중 다룬다.

ITU-T Y.4900 KPI 프레임워크 구현은 다음 표준들이 상호 정합적이라는 전제를 만족해야 한다: ISO 37120:2018 (City indicators), ISO 37122:2019 (Smart city indicators), ISO 37123:2019 (Resilient cities indicators), ITU-T Y.4900 series, ISO/IEC 30141:2018 (IoT Reference Architecture). 스마트 시티의 Phase 1 봉투 클래스는 호스트 식별자와 테넌트 식별자를 담아, Phase 3 프로토콜 계층에서 연합되는 호스트 사이에서도 감사 기록을 재구성할 수 있도록 한다.

운영자가 ITU-T Y.4900 KPI 프레임워크에 진입할 때의 통상적인 경로는: `simulator/index.html`의 참조 시뮬레이터를 띄우고 → `cli/smart-city.sh envelope` 명령으로 정상 봉투를 한 차례 산출 → 참조 컨테이너 `wia/smart-city-host:1.0.0`에 대해 curl/Postman으로 Phase 2 엔드포인트를 차례대로 시연한다. 이 절차가 끝나면 Phase 1 §A.* 봉투 카탈로그와 Phase 2 §B.* 엔드포인트 카탈로그를 따라 실 백엔드를 한 엔드포인트씩 차례로 결선한다.

ITU-T Y.4900 KPI 프레임워크 영역에서 자주 마주치는 운영 관심사는 관측가능성이다. Phase 1 봉투마다 호스트의 감사 전송에 다음을 담은 구조화된 로그 한 줄을 SHOULD 발신한다: RFC 3339 ISO 8601 UTC 타임스탬프, 호스트 식별자, 테넌트 식별자, 봉투 클래스, 봉투 식별자, 동작 결과, 그리고 W3C Trace Context의 `traceparent` 헤더로 종단간 전파되는 trace 식별자. Phase 2는 같은 trace 식별자를 `X-WIA-Trace-Id` 응답 헤더로 노출한다. Phase 3 프로토콜 교환은 이 식별자를 교환 봉투 내부에 전파하여 연합 경계도 종단 간 상관관계를 유지한다.

ITU-T Y.4900 KPI 프레임워크는 다음과 합성된다: 자격증명 저장은 WIA-OMNI-API, 런타임 신뢰 목록은 WIA-AIR-SHIELD, 워크로드 의도 선언은 WIA-INTENT, 개인정보가 포함되는 경우 봉인 데이터 봉투는 WIA Secure Enclave. 이 합성을 통해 여러 WIA 패밀리 표준을 함께 운영하는 호스트가 하나의 신원·하나의 서명키 체인·하나의 감사 전송을 재사용할 수 있어, 표준마다 N개의 병렬 구현을 유지하지 않아도 된다.