TSK-013-01 KTO tourism info sheet data consumption and timeout guard

[ClarusIubar]

메타데이터

• Scope-ID: TSK-013-01-TOURISM-INFO-DATA-CONSUMPTION
• Status: open
• Parent Issue: TSK-013-00 Bug: KTO 관광정보 데이터 소비 복구 #420
• Branch: tourism-info-data-consumption-fix
• PR: TBD-TSK-013-01

목표

KTO 관광정보 토글과 정보 시트가 이미 받은 관광 데이터를 사용자에게 충분히 보여주고, API 지연/무응답 시에도 Web Front가 무한 로딩에 갇히지 않게 한다.

재현 근거

• TourismInfoSheet는 TourismPlaceItem의 imageUrl, description, homepageUrl, sourceName, category, district, address, summary를 모두 받을 수 있다.
• 현재 사용자 관점에서는 장소명과 주소 중심으로 보여 정보 활용도가 낮다.
• /api/tourism/places 응답이 지연되면 showTourismInfo=true, tourismPlaces=[], tourismLoading=true 상태가 오래 유지될 수 있다.

체크리스트

• 최신 origin/main 기준으로 코드 확인
• tourism-toggle-chip 레이아웃을 칩 행에서 안전하게 고정
• TourismInfoSheet에 이미지, 요약/설명, 출처, 홈페이지, 위치 메타를 표시
• tourism fetch timeout/error guard 추가
• 정상 데이터 표시 regression test 추가
• timeout/error regression test 추가
• Architecture Boundary Gate 근거 기록
• PR URL 기록
• merge SHA 기록
• CI URL 기록

검증 체크리스트

• npm.cmd run lint
• npm.cmd run typecheck
• npm.cmd run test:unit
• npm.cmd run test:e2e
• npm.cmd run build
• git diff --check
• UTF-8 integrity check

[ClarusIubar]

Reopened for follow-up correction: PR #422 improved rendering but still used legacy title/homepageUrl field assumptions and left TourismInfoSheet copy mojibake on main.

[ClarusIubar]

계약 필드 보정 완료

• Corrective PR: fix: align tourism info sheet with api contract #424
• Main merge SHA: ad668fe4cebadffae87e90412c2c54e40cee59f4
• CI: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27458593746
• production-smoke: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27458593745
• CodeQL: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27458593463
• Code Quality: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27458593440

수정 요약

• /api/tourism/places 실제 응답 계약에 맞춰 Web Front TourismPlaceItem에 name, ktoContentTypeId, ktoContentTypeLabel, ktoFacet, roadAddress, sourcePageUrl, sourceUpdatedAt를 반영했습니다.
• TourismInfoSheet는 name, ktoContentTypeLabel, roadAddress, sourcePageUrl을 우선 소비하고 기존 title/homepageUrl은 fallback으로만 둡니다.
• main에 남아 있던 TourismInfoSheet와 KTO 테스트 fixture mojibake를 복구했습니다.
• KTO 정보성 장소는 계속 read-only로 유지하고, stamp/review/feed 액션은 추가하지 않았습니다.

검증

• npm.cmd run check:numeric-literals
• npm.cmd run lint
• npm.cmd run typecheck
• npm.cmd run test:unit -- tourism-info-sheet tourism-client
• npm.cmd run test:unit
• npm.cmd run test:integration
• npm.cmd run test:regression
• npm.cmd run test:e2e
• npm.cmd run build
• git diff --check
• UTF-8 commit hook 통과