TSK-012-00 Epic: 2차 UI/UX 서브내비 헤더 통합 및 KTO 지도 통합

[ClarusIubar]

메타데이터

• Scope-ID: TSK-012-00-SECOND-UIUX-KTO-MAP-INTEGRATION
• Status: closed
• Parent Issue: self
• Branch: 없음 - child issue별 브랜치 사용
• PR: TSK-012 child PR 묶음
• Final main SHA: 3069e933b4c084dd620f8c42f89234144f7ecc30

목적

2차 구현 명세의 세 축을 실제 Web Front 코드에 반영한다.

• 헤더를 풀와이드 앱 헤더로 통합한다.
• 서브내비를 지도 위 absolute overlay가 아니라 앱 셸 flow/grid 레이어로 분리한다.
• KTO 관광장소는 행사 탭 세그먼트가 아니라 지도 화면의 선택형 정보 마커 레이어로 통합한다.

고정 결정

• KTO 관광정보 표시 토글 기본값은 OFF다.
• 기존 GET /api/tourism/places consumer contract를 사용하고 새 API client를 중복 생성하지 않는다.
• API path, response shape, DB schema, OAuth 성공 경로는 변경하지 않는다.
• KTO/OpenAPI, Supabase, admin import/sync를 브라우저에서 직접 호출하지 않는다.
• 사용자-facing copy는 명세 구현에 필요한 탭/토글/시트 문구 외에는 수정하지 않는다.

Child Issues

• TSK-012-01 2차 UI/UX audit baseline: TSK-012-01 2차 UI/UX audit baseline #405 / PR Record second UI/UX audit baseline #412 / merge dc0c5027
• TSK-012-02 App header slot integration: TSK-012-02 App header slot integration #406 / PR Integrate app header slot #413 / merge edac1e31
• TSK-012-03 App shell subnav grid layout: TSK-012-03 App shell subnav grid layout #407 / PR TSK-012-03 App shell subnav grid layout #414 / merge bcd1284
• TSK-012-04 Event tab festival-only cleanup: TSK-012-04 Event tab festival-only cleanup #408 / PR TSK-012-04 Event tab festival-only cleanup #415 / merge 3ee8f77
• TSK-012-05 KTO tourism map layer and InfoSheet: TSK-012-05 KTO tourism map layer and InfoSheet #409 / PR Add KTO tourism map layer #416 / merge b89b7fc
• TSK-012-06 App shell CSS offset cleanup: TSK-012-06 App shell CSS offset cleanup #410 / PR Clean app shell map offset overrides #417 / merge fa67c88
• TSK-012-07 2차 UI/UX traceability docs: TSK-012-07 2차 UI/UX traceability docs #411 / PR docs: update second UIUX traceability #418 / merge 3069e933b4c084dd620f8c42f89234144f7ecc30

완료 체크리스트

• 각 child issue가 생성되고 parent 링크를 가진다.
• 헤더 액션과 뒤로가기가 앱 헤더 내부 슬롯으로 통합된다.
• 서브내비가 flow/grid 레이어로 분리되어 지도/리스트와 겹치지 않는다.
• 행사 탭은 행사 콘텐츠만 표시한다.
• KTO 정보성 장소는 지도 토글 ON일 때 보조 마커로 표시된다.
• KTO 정보성 장소 선택 시 스탬프/후기 없는 InfoSheet가 열린다.
• 누적 absolute/fixed offset CSS가 정리된다.
• Wiki/QA/release traceability가 최신화된다.

완료 판단 근거

• PR 링크 기록
• main merge SHA 기록
• CI 링크 기록
• 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 통과
• UTF-8 integrity check 통과

최종 추적성

• Repo traceability: docs/ui-ux-redesign-traceability.md
• QA matrix: docs/ui-ux-qa-matrix.md
• Release candidate: docs/release-candidate-1.3.3.md, Wiki Release-Notes-1.3.3
• Wiki commit: f123e4b

[ClarusIubar]

TSK-012 최종 완료 근거

• Final main SHA: 3069e933b4c084dd620f8c42f89234144f7ecc30
• Final PR: docs: update second UIUX traceability #418
• Wiki commit: f123e4b
• CI: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27453935978
• production-smoke: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27453935962
• CodeQL: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27453935660
• Code Quality: https://github.com/STH-1-Class-One-Group/JamIssue/actions/runs/27453935676

완료된 문서 근거:

• docs/GOVERNANCE_INDEX.md
• docs/ui-ux-qa-matrix.md
• docs/ui-ux-redesign-baseline.md
• docs/ui-ux-redesign-traceability.md
• docs/release-candidate-1.3.3.md
• reports/completion/TSK-012-07-second-uiux-traceability-docs.md
• Wiki Home, _Sidebar, UI-UX-QA-Matrix, UI-UX-Redesign-Traceability, Release-Notes, Release-Notes-1.3.3

Architecture Boundary Gate:

• Responsibility map: Web Front UI/UX 구현과 consumer contract 추적성만 포함했습니다.
• Dependency direction: 문서는 issue/PR/merge SHA를 참조하고 API/DB/OAuth/provider contract는 변경하지 않았습니다.
• Test seam: markdown diff, UTF-8 strict read, unit/source-quality, lint/typecheck/build, PR checks, main checks로 검증했습니다.
• Scope map: TSK-012-01 2차 UI/UX audit baseline #405~TSK-012-07 2차 UI/UX traceability docs #411 전체 child issue 완료 근거를 parent에 연결했습니다.
• Architecture risk: PR/merge SHA 없는 항목은 후보/TBD로만 표기하고 완료로 기록하지 않도록 정리했습니다.

[ClarusIubar]

TSK-012 child issues #405~#411 완료, PR #418 merge, Wiki/repo traceability 갱신, main CI/production-smoke/CodeQL 성공 확인 후 닫습니다.