TSK-013-00 Bug: KTO 관광정보 데이터 소비 복구

[ClarusIubar]

메타데이터

• Scope-ID: TSK-013-00-TOURISM-DATA-CONSUMPTION-FIX
• Status: open
• Parent Issue: self
• Branch: 없음 - child issue별 브랜치 사용

목적

지도 KTO 관광정보 레이어가 이미 가진 관광 데이터를 사용자가 이해할 수 있는 정보 시트로 소비하도록 복구한다.

문제

• 관광정보 토글 UI가 칩 흐름을 깨거나 인접 칩을 가릴 수 있다.
• /api/tourism/places가 지연 또는 무응답일 때 Web Front가 무한 로딩처럼 보일 수 있다.
• KTO DTO에는 이미지, 요약, 설명, 출처, 홈페이지, 카테고리, 행정구, 주소가 있는데 정보 시트가 이름/주소 중심으로만 보여 데이터 활용도가 낮다.

고정 결정

• Web Front는 KTO/OpenAPI를 직접 호출하지 않고 /api/tourism/places consumer contract만 사용한다.
• API path, response shape, DB schema, OAuth 성공 경로는 변경하지 않는다.
• 비큐레이션 KTO 장소는 스탬프/후기 액션 없는 정보 시트로 유지한다.
• 사용자-facing copy는 KTO 정보 시트 기능 복구에 필요한 범위에서만 수정한다.

Child Issues

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

완료 체크리스트

• child issue 생성 및 parent 링크
• KTO 정보 시트가 image/summary/description/homepage/source/category/district/address를 소비한다.
• 관광정보 토글 칩이 다른 칩을 가리지 않는다.
• tourism fetch가 timeout/error 상태로 빠져 UI가 무한 로딩에 갇히지 않는다.
• E2E 또는 unit regression test가 추가된다.
• PR URL, merge SHA, CI URL 기록

[ClarusIubar]

완료 근거

• Child Issue: TSK-013-01 KTO tourism info sheet data consumption and timeout guard #421
• PR: fix: improve tourism info data consumption #422
• Main merge SHA: 729cbe8764f59f4ae7c9a3a845de9e0a6a53f83f
• Branch: tourism-info-data-consumption-fix

처리 내용

• KTO 관광정보 시트가 보유 데이터 중 이미지, 요약, 소개, 분류, 지역, 주소, 출처, 홈페이지 링크를 렌더링하도록 수정했습니다.
• /api/tourism/places 응답 지연 시 프론트가 무한 로딩으로 멈추지 않도록 AbortSignal 기반 timeout guard를 추가했습니다.
• KTO 정보성 핀은 스탬프/후기/피드 액션 없이 정보 전용 시트로 유지했습니다.

Architecture Boundary Gate

• Responsibility map: tourismClient는 Worker consumer request, useAppCoordinatorEffects는 요청 lifecycle/timeout, TourismInfoSheet는 TourismPlaceItem presentation을 담당합니다.
• Dependency direction: UI effect -> API client -> fetchJson; browser는 KTO/OpenAPI, Supabase, admin import API를 직접 호출하지 않습니다.
• Test seam: component render boundary와 API client request boundary를 unit test로 고정했습니다.
• Scope map: frontend KTO 데이터 소비와 timeout guard만 변경했습니다. API path/response shape/DB/OAuth는 변경하지 않았습니다.
• Architecture risk: KTO 정보성 핀이 curated place action surface로 변질되는 위험을 막기 위해 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 통과
• changed source/test UTF-8 strict read 통과
• PR checks: frontend, deploy-pages, CodeQL 통과

[ClarusIubar]

TSK-013 child issue #421 and PR #422 are complete. Parent closed with merge SHA and validation evidence.

[ClarusIubar]

TSK-013 reopened for contract-field correction. The frontend must consume the actual /api/tourism/places contract fields: name, roadAddress, ktoContentTypeLabel, ktoFacet, sourcePageUrl, and restore mojibake introduced in TourismInfoSheet copy.

[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 통과