frontend/apps/sn/docs/작업내용/SN-GIS-지도이동검색조건초기화/001-fe-SN-GIS-지도이동검색조건초기화-통합구현기록.md

SN GIS 지도 이동 검색조건 초기화 통합구현기록

2026-10-02 유지보수 사전 분석 — 구현 미착수

• 사용자 범위: 프론트+백엔드 영향 분석. 실제 구현은 다음 단계.
• 확정 대상: 상단 지역·시설 검색조건. 목록에서 선택한 분석 결과/레이어 상태 유지.
• 원본: 요구사항정의서 기능 시트 93행 SFR-011-007, 96행 SFR-012-001; 화면설계서 실제 슬라이드 19/SN_MN010201, 21/SN_MN010202.
• ProcSearchBar 내부 state와 공통 GeoJSON 검색/직접 fit의 분산 구조를 확인했다. 통수위험은 검색바 갱신이 없고 침입수/RDII는 반대로 지역·시설 동기화 이벤트가 있다.
• 필수 대상 15개 기능 묶음과 별도 버튼/지도 진입 경로는 공통 설계의 목록을 기준으로 한다. 기능 목록은 정적 코드 기준이며 브라우저에서 전수 검증한 목록이 아니다.
• 제안: SN 지도별 공통 이동 처리, 검색바 optional reset revision, 공통 GeoJSON 검색의 optional 성공 callback. moveend 일괄 초기화 금지.
• 구현 시 핵심 파일: map/ui/map-search-bar.tsx, map/ui/map-page-client.tsx, map/lib/use-map-runtime-bridge.ts, 각 결과 지도 hook, src/features/facility-detail의 직접 이동부. 허용 공통 경로는 packages/common/business_components/src/ui/map/searchBar/procSearchBar.tsx 및 필요한 lib/gis.layer.js로 한정한다.
• 비동기 시설 후보 조회의 늦은 응답, message/storage 중복, 실패 시 유지, 검색바 직접 조회의 값 보존을 검증한다.
• 이번 실제 수정은 문서뿐이다. 타입검사·빌드·브라우저·API 시험은 미수행이며 새 테스트 파일/서버를 생성하지 않았다.
• 기존 문서 경로와 파일명은 유지했다. 기존 한글 주석의 일부 손상은 본 작업에서 수정하지 않았다.
• 롤백: 이 기록 및 공통 설계/검증계획의 이번 추가분만 복원. 코드·API·DB 영향 없음.
• 상세 설계: IIPBS/docs/작업계획/SN-GIS-지도이동검색조건초기화/001-de-SN-GIS-지도이동검색조건초기화-설계.md.

2026-10-02 구현 및 자동검증

• 사용자 후속 구현 지시에 따라 공통 지도 이동/검색조건 초기화를 반영했다.
• 지도별 요청 세대와 reset revision, 검색바 optional props, GIS 비동기 성공 callback, 직접 fit/지역 이동 경로를 연결했다.
• 기존 분석 결과·선택 강조·레이어·시설유형/필터·상단 직접 검색 동작은 유지한다. 실행 경로별 보존은 브라우저 회귀에서 추가 확인한다.
• 침입수/RDII 기존 검색바 채우기 제거, 선택 요청 ID 중복 제거, 통수위험의 조회 시작/결과 식별과 오래된 응답 방어를 구현했다.
• 타입검사 최종 exit 0, 파일 없는 Node 실행 검증 4종 및 diff 공백 검사 통과. 중간의 FitOptions/부분 지도 인터페이스 타입 오류는 수정 후 재검사했다.
• 사용자 개발 서버 가동을 확인하여 build/재시작하지 않았다. 새 프로세스/검증파일 생성 없음. 브라우저 로그인 대기.

실제 소스 변경 파일 (frontend 기준)

• apps/sn/app/(map-layout)/map/components/exmn/use-exmn-result-map.ts
• apps/sn/app/(map-layout)/map/components/inftwt-result/inftwt-result-popup-page.tsx
• apps/sn/app/(map-layout)/map/components/inftwt-result/use-inftwt-result-map.ts
• apps/sn/app/(map-layout)/map/components/rdii-result/rdii-result-popup-page.tsx
• apps/sn/app/(map-layout)/map/components/rdii-result/use-rdii-result-map.ts
• apps/sn/app/(map-layout)/map/components/water-risk/water-risk-popup-page.tsx
• apps/sn/app/(map-layout)/map/lib/use-flood-history-selection.ts
• apps/sn/app/(map-layout)/map/lib/use-map-runtime-bridge.ts
• apps/sn/app/(map-layout)/map/lib/use-water-risk-layer.ts
• apps/sn/app/(map-layout)/map/search-modal/use-basic-tab.ts
• apps/sn/app/(map-layout)/map/search-modal/use-operation-tab.ts
• apps/sn/app/(map-layout)/map/search-modal/use-search-modal.ts
• apps/sn/app/(map-layout)/map/ui/map-page-client.tsx
• apps/sn/app/(map-layout)/map/ui/map-search-bar.tsx
• apps/sn/src/features/facility-detail/ui/smh.tsx
• apps/sn/src/features/facility-detail/ui/swtrmt-prcs-zone-analysis.tsx
• apps/sn/src/features/fldng-predc-prst/lib/use-flood-prediction-map.ts
• packages/common/business_components/src/ui/map/lib/gis.layer.js
• packages/common/business_components/src/ui/map/searchBar/procSearchBar.tsx
• packages/common/business_components/src/ui/map/searchBar/utils.ts
• apps/sn/src/features/map-search/lib/map-navigation.ts

남은 검증과 롤백

• 실제 데이터로 15개 기능의 지도 이동/상단 초기화 및 분석 표시 보존 확인은 로그인 후 수행한다.
• 롤백 시 위 소스 변경을 함께 복원한다. BE/DB 롤백 없음.

2026-10-02 적용 누락 재점검 및 보완

• 사용자 재확인 요청으로 전체 지도 이동 호출·메시지 경로를 대조했다. 침수흔적 상세 심선/위선 연도 선택(신규 조회·캐시)과 상세 탭 복귀 FID 재조회 경로의 초기화 누락을 발견해 보완했다.
• 수정: frontend/apps/sn/app/(map-layout)/map/components/fldng-hstry/fldng-hstry-feature-click.tsx, frontend/apps/sn/app/(map-layout)/map/ui/map-page-client.tsx. 누적 소스 변경은22개다.
• 기존15개 기능 묶음 및 추가 경로의 적용표를 공통 설계/통합검증결과에 기록했다. 초기 대표 목록 적용 보고와 하위 상세 경로 누락을 구분했다.
• SN 전체 타입검사 exit0, 캐시 성공·지연 응답 거부·신규 callback 전달 실행검증 및 diff 공백 검사 통과. 임시파일·서버 생성 없음, BE/API/DB 변경 없음.
• 실브라우저 전수 검증은 로그인 대기 상태로 유지한다. 롤백은 위2개 파일의 이번 callback 추가를 복원한다.