TSK-014-00 Bug: 모바일 지도 위치 찾기와 KTO 시트 레이아웃 복구

[ClarusIubar]

Scope-ID

TSK-014-00-MAP-UX-REGRESSION-FIX

목적

모바일 지도 화면에서 확인된 UX 회귀를 복구한다.

• 내 위치 찾기 버튼이 실제 위치 이동/상태 피드백을 제공하지 못하는 문제
• KTO 관광정보 바텀시트가 이미지 이후 본문을 충분히 보여주지 못하고 하단 탭에 잘리는 문제
• KTO 관광정보 시트가 운영 API가 가진 상세 정보를 충분히 렌더링하지 않고 외부 링크에 의존하던 문제
• KTO 원문 링크가 실패 페이지로 이어질 수 있는데도 주요 CTA로 노출되던 문제

작업 원칙

• 실제 사용자 화면 증상 기준으로 재현한다.
• 자식 이슈 없이 구현하지 않는다.
• 외부 API path, response shape, DB schema, OAuth 경로는 변경하지 않는다.
• KTO 정보성 장소는 read-only 정보 시트로 유지한다.
• 사용자-facing copy는 기능 복구에 필요한 범위만 수정한다.

Child Issues

• TSK-014-01 Mobile map location and tourism sheet layout fix: TSK-014-01 Mobile map location and tourism sheet layout fix #426, PR fix: restore mobile map location and tourism sheet layout #427, merge 1991601439794f38bbc35a4cda9ae70e04a86466
• TSK-014-02 KTO tourism rich information sheet fix: TSK-014-02 KTO tourism rich information sheet fix #428, PR fix: render rich KTO tourism info locally #429, merge 0f5294780ed108121836907240b4a32df94d8177
• TSK-014-03 KTO source link CTA fix: TSK-014-03 KTO source link CTA fix #431, PR fix: remove KTO source link CTA #432, merge ffc3745679aa4cfbdb0449d782c56f9d337a524d

완료 체크리스트

• 내 위치 찾기 버튼의 실패/성공 동작이 테스트로 고정됨
• 바텀시트가 KTO 이미지/본문/출처를 하단 탭에 가리지 않고 보여줌
• KTO 시트가 이미지, 요약, 분류, 구, 주소, 좌표, 출처, 갱신일을 시트 내부에서 렌더링함
• 외부 KTO 원문 링크를 주요 CTA로 렌더링하지 않음
• 유효하지 않은 원문 URL은 클릭 가능한 링크로 렌더링하지 않음
• 모바일 E2E 또는 레이아웃 회귀 테스트가 추가됨
• PR, merge SHA, CI 링크가 기록됨

최종 근거

• PR fix: restore mobile map location and tourism sheet layout #427: fix: restore mobile map location and tourism sheet layout #427
• PR fix: render rich KTO tourism info locally #429: fix: render rich KTO tourism info locally #429
• PR docs: record KTO tourism info merge evidence #430: docs: record KTO tourism info merge evidence #430
• PR fix: remove KTO source link CTA #432: fix: remove KTO source link CTA #432
• PR docs: record KTO source link merge evidence #433: docs: record KTO source link merge evidence #433
• 최종 docs merge SHA: dba8b3214d5bd61a56560383feac76ae65c2a306
• 보고서: reports/completion/TSK-014-03-kto-source-link-cta-fix.md

[ClarusIubar]

완료 근거

• Child Issue: TSK-014-01 Mobile map location and tourism sheet layout fix #426
• Parent Issue: TSK-014-00 Bug: 모바일 지도 위치 찾기와 KTO 시트 레이아웃 복구 #425
• PR: fix: restore mobile map location and tourism sheet layout #427
• Main merge SHA: 1991601439794f38bbc35a4cda9ae70e04a86466
• Branch: mobile-map-location-sheet-fix
• CI: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27459728533
• production-smoke: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27459728526
• CodeQL: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27459728242
• Code Quality: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27459728252

수정 요약

• watchPosition 콜백이 동기 실행될 때 watchId 초기화 전에 접근하던 결함을 제거했습니다.
• 지도 위치 확인 메시지가 NaverMapStatus까지 전달되도록 MapStageMapSurface props 연결을 복구했습니다.
• 위치 확인/오류 문구와 관광정보 토글/시트 관련 mojibake를 이번 UX 경로 범위에서 복구했습니다.
• KTO 관광정보 시트를 공통 MapBottomSheet wrapper로 조립하도록 바꿨습니다.
• KTO 정보 시트는 기본 full 상태로 열고, full 시트 content에 bottom nav offset padding을 추가해 이미지 이후 위치/출처/링크가 잘리지 않게 했습니다.

Architecture Boundary Gate

• Responsibility map: geolocation.ts는 브라우저 위치 API 변환/검증, NaverMapStatus는 위치 버튼/피드백, MapBottomSheet는 공통 지도 바텀시트 shell, TourismInfoSheet는 KTO read-only presentation을 담당합니다.
• Dependency direction: app coordinator -> map stage -> Naver map/status -> geolocation action 흐름을 유지했습니다. KTO 시트는 Worker/KTO API를 직접 호출하지 않습니다.
• Test seam: geolocation browser mock, map status UI render test, TourismInfoSheet shared shell/full state test를 추가했습니다.
• Scope map: frontend map UX만 변경했습니다. API path/response shape/DB schema/OAuth/Worker import flow는 변경하지 않았습니다.
• Architecture risk: bottom tab hide 정책은 전역 app-shell 설계 범위라 이번 버그에서는 content padding으로 접근성을 보강했습니다.

검증

• npm.cmd run typecheck 통과
• npm.cmd run test:unit -- geolocation naver-map-status tourism-info-sheet map-config 통과
• npm.cmd run check:numeric-literals 통과
• npm.cmd run lint 통과
• npm.cmd run test:integration 통과
• npm.cmd run test:regression 통과
• npm.cmd run test:e2e 통과
• npm.cmd run build 통과
• git diff --check 통과
• UTF-8 strict read 및 commit hook 통과

[ClarusIubar]

TSK-014 complete via child #426 and PR #427 with green main checks.

[ClarusIubar]

Reopened for TSK-014-02: KTO tourism information sheet still does not sufficiently consume the available /api/tourism/places data, and the external detail link must be validated before rendering.

[ClarusIubar]

완료 근거

TSK-014-02 범위는 구현 및 main 반영 완료입니다.

• PR: fix: render rich KTO tourism info locally #429
• 구현 merge SHA: 0f5294780ed108121836907240b4a32df94d8177
• 추적성 보정 PR: docs: record KTO tourism info merge evidence #430
• 추적성 보정 merge SHA: 4980122c01a6e791d806f083ed2ce6fb24dc7d58

검증

• npm.cmd run check:numeric-literals: 통과
• npm.cmd run lint: 통과
• npm.cmd run typecheck: 통과
• 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 integrity check: 통과

원격 검증

• PR fix: render rich KTO tourism info locally #429 frontend: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27467212709/job/81191557710
• PR fix: render rich KTO tourism info locally #429 CodeQL JS/TS: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27467211971/job/81191556686
• main frontend: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27467236652/job/81191624614
• main smoke: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27467236660/job/81191654547
• main protected-smoke: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27467236660/job/81191654553
• main CodeQL JS/TS: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27467236421/job/81191624884
• docs evidence CodeQL JS/TS: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27467338284/job/81191895531

Architecture Boundary Gate

• Responsibility map: TourismInfoSheet는 Worker consumer DTO를 read-only KTO 시트로 렌더링합니다.
• Dependency direction: UI -> TourismPlaceItem -> Worker API response contract 방향만 유지합니다.
• Test seam: React Testing Library rendered output, URL validation, shared bottom-sheet shell 구조, E2E KTO layer toggle입니다.
• Scope map: 프론트 표시 계층과 consumer DTO 필드만 변경했습니다.
• Architecture risk: 향후 KTO 추가 필드 표시 우선순위는 별도 정책으로 분리해야 합니다.

[ClarusIubar]

TSK-014 하위 작업 #426, #428이 모두 main에 반영됐고, PR #427/#429/#430 및 main check 근거를 본문과 완료 댓글에 기록했습니다.

[ClarusIubar]

KTO 원문 링크가 외부 실패 페이지로 이어지는 추가 UX 결함이 확인되어 TSK-014 parent를 재오픈합니다. 새 child에서 원문 링크 CTA 정책을 보정합니다.