본문으로 건너뛰기

스키마 동기화

데이터 소스의 카탈로그 스키마를 GenD 로 동기화하고, 실행 이력·변경 감지 결과를 추적하는 거버넌스 화면입니다 (Theme D-4, #2242).

진입점​

  • 사이드바 거버넌스 → 스키마 동기화 (/governance/schema-sync)

기능​

실행 이력 표​

각 동기화 실행 행은 상태 배지, 소스 참조, 시작/종료 시각, 변경 감지 수(changes_detected), 실행자를 보여줍니다.

  • 상태 배지 색: 성공=초록 · 실행 중=파랑 · 실패=빨강 · 대기=노랑.
  • 실패 사유 툴팁 — 실패 행의 배지는 포커스 가능한 버튼(a11y)으로, 호버/포커스 시 error_msg 툴팁이 표시됩니다.
  • 정직한 스켈레톤 — 이력이 없으면 "동기화 이력이 없습니다" 빈 상태를 그대로 노출합니다(빈 표를 위장하지 않음).

동기화 실행 (Trigger)​

우상단 동기화 실행 버튼(워크스페이스 admin 전용)을 누르면 POST /schema-sync/trigger 가 호출되어 동기화가 기동되고, 이력 표 맨 위에 "실행 중" 행이 추가됩니다.

⏱ 동기(synchronous)·장시간 작업: 라우터는 카탈로그 동기화를 요청 안에서 끝까지 수행한 뒤 응답합니다(prod 관측 ~4–5분). "실행 중" 이력 행은 ~1초 내에 나타나지만, 성공 토스트는 동기화가 끝난 뒤에야 뜹니다.

권한​

  • 이력 조회(GET /schema-sync/history): 뷰어.
  • 동기화 실행(POST /schema-sync/trigger): 워크스페이스 admin(글로벌 admin 역할 또는 Keycloak /tenants/<slug>/admins 멤버) — 서버에서 시행.

관련 문서​