프로젝트

Gen1 → Gen2 관제 데이터의 명시적 매핑 어댑터 보완

Explicit Mapping Adapter for Gen1-to-Gen2 Telemetry Migration

Gen1 관제 데이터의 버전·단계·결과 코드를 Gen2 의미 모델에 맞춰 명시적으로 변환하도록 Go 변환기의 누락 및 미구현 분기를 보완했습니다.

핵심 변경

구세대의 상세 값을 그대로 전달하던 경로와 미구현 분기를 점검하고, 새 모델의 단계·결과 코드에 맞는 명시적 변환을 보완했습니다. 구현 범위와 외부 소비자의 최종 수용 시험은 별도로 다룹니다.

의미 모델 차이

구세대(Gen1) 관제 데이터를 차세대(Gen2) 플랫폼 모델로 전환하는 과정에서 두 체계 간의 데이터 구조는 단순한 1:1 필드 치환으로 해결되지 않았습니다.

변환 문제를 확인하려면 원본 필드의 값뿐 아니라 버전별 정의와 목적 모델의 의미를 함께 살펴봐야 합니다. 상세 복원 자료에는 버전별 분기와 결과·단계 매핑의 부족이 기록돼 있습니다. 다만 원본 전문과 승인된 매핑표가 없어 구체적인 일대다 변환이나 집계 규칙을 실제 사례로 만들어 설명하지 않습니다.

누락된 mapping

변환기(Converter) 코드베이스를 확인한 결과, 특정 버전 및 특수 규격에 대한 매핑 로직이 불완전한 상태였습니다.

  • 버전별 분기 미구현: 별도보고 1.2 및 1.3 규격에 해당하는 변환 분기 일부가 비어 있거나 TODO 상태로 남아 있었습니다.
  • 상태 코드 매핑 부재: 특정 단계(Step) 범위와 재시도(retry), 롤백(rollback), 단말 리셋 등 예외적 진행 상황에서 발생하는 세부 결과 코드가 Gen2 규격으로 명시 매핑되지 않아 상태 왜곡이나 누락이 발생할 가능성이 있었습니다.

선택한 변환 방식

다운스트림 시스템이 구세대의 복잡한 버전 파편화에 직접 종속되지 않도록, 변환기 내부에서 의미를 보존하는 명시적 매핑(explicit mapping)을 보완했습니다:

  • Go 변환기 내에 Gen2 도메인 상수를 명확히 정의하고, Gen1 별도보고 1.2/1.3 규격에 대응하는 변환 분기를 추가 및 보정했습니다.
  • 세부 단계 및 예외 결과 코드의 의미를 Gen2 도메인 체계에 맞게 명시적 브랜치로 분기 매핑했습니다.
  • Gen1 상세 값을 그대로 복사하지 않고 세대별 코드 체계에 맞춰 변환하도록 정리했습니다.

이를 통해 버전별 step과 result의 의미를 명시적으로 매핑하도록 컨버터를 보완했습니다.

검증 가능한 범위

  • 구현 기록의 범위: 상세 복원 자료에는 별도보고 1.2/1.3 및 주요 단계별 결과 코드에 대한 변환 분기와 상수가 보완된 것으로 기록돼 있습니다. 원본 저장소를 이번 작업에서 직접 확인한 것은 아닙니다.
  • 확정할 수 없는 한계: 매핑 규칙의 원본 사양(spec) 전체를 독자적으로 설계하거나 정의한 것은 아니며, 구현된 변환기에 대한 외부 컨슈머 측의 최종 수용 시험 통과 여부나 실제 운영 환경에서의 데이터 정합성 통계는 확보된 자료에 없어 확정하지 않습니다.

추가 검증에는 버전별 입력·출력 예제, 원본 사양, 승인된 매핑표가 필요합니다. 이를 확보하면 미등록 코드, 빈 버전, 예외 결과를 포함한 fixture를 구성할 수 있습니다. 이 계획을 당시 완료한 테스트로 표현하지 않습니다.