풍경촬영의 성공은
날씨 해석력에서 갈립니다

사진가들이 실제로 찾는 면·리·저수지·산·촬영 명소를 즉시 검색할 수 있도록 로컬 한국 지명 DB를 구축. 해외 출사지(하포·바단지린 등) 국가 표시 정확도를 높이고, 시간대별 날씨에 1시간 간격 모드를 추가했습니다.

• 🇰🇷 한국 지명 로컬 DB 신규 (lib/korea-admin-db.js) — 전국 시·군·구 229곳, 주요 읍·면 26곳, 사진 명소 52곳(송현저수지·월출산·격포·마라도 등)을 포함한 로컬 DB 구축. "봉황면"·"송현저수지"처럼 이전에는 검색 안 되던 지명이 즉시 매칭됩니다. 네트워크 호출 없이 메모리 검색(10~30ms)으로 OSM Nominatim 대비 30배 빠름. 검색 결과에 ★ 명소/읍·면/시·군·구 색상 뱃지로 출처 구분 표시.
• 🌏 해외 명소 국가 자동 감지 — 하포(霞浦)·바단지린(巴丹吉林)·장자제·황산·후지산 등 해외 출사지 검색 시 🇨🇳 🇯🇵 국기와 정확한 국가 코드(CN/JP 등) 자동 표시. FOREIGN_MAP으로 중국·일본·대만·베트남·태국·미국·몽골 지원. 7월 하포 출사 준비 과정에서 발견된 "하포 (KR)" 오표시 버그 해결.
• ⏰ 시간대별 날씨 1시간/3시간 탭 전환 — 기존 3시간 간격 8장 그리드는 그대로 두고, 상단에 [1시간][3시간] 토글 버튼 추가. 1시간 모드는 현재 시각부터 다음 8시간을 2×4 그리드로 표시(자정 넘어가면 "내일 N시" 자동 표시). localStorage로 선택 기억, 탭 전환 시 API 재호출 없이 즉시 렌더링.
• 🎯 "지금 출사 가능?" 종합 점수 카드 — 구름(20)·시정(15)·풍속(15)·PM2.5(15)·안개(10)·강수확률(10) 등 6개 요소 합산 100점 + 은하수 조건 충족 시 보너스 5점. 90+ 🟢 완벽 · 75-89 🔵 좋음 · 60-74 🟡 무난 · 40-59 🟠 주의 · 0-39 🔴 불량. 밤+달 어두움+운량<30% + 점수≥60이면 "🌌 은하수 촬영 최적 조건" 특별 메시지.
• 🌊 WorldTides 가입 가이드 통합 (tides.html) — 해외 좌표 물때 조회 시 에러가 나면 "해외 좌표 물때 이용 안내" 박스에 무료 가입하기 · 개발자 문서 · API 레퍼런스 3개 버튼 표시. 100 credits 무료 제공·1일 2 credits·50일 사용 가능 등 실용 정보와 $WORLDTIDES_KEY 설정법도 함께 안내.
• 💝 후원 페이지 PhotoMet 디자인 통일 (donate.html) — 기존 단독 레이아웃에서 PhotoMet v4.0 글래스모피즘 · 그라디언트 타이틀 · 다크/라이트 테마 동기화 · PWA 등록까지 모두 반영. 토스·카카오페이 QR과 하나은행 계좌 복사 버튼 포함. 메인 페이지 및 info.html "지금 시작하기" 영역에서 바로 접근 가능.
• 🔧 Service Worker 버전 격상 (v4.1.0) — 정적 자원 목록에 korea-admin-db.js·donate.html·info.html 추가. 캐시 버스터 ?v=4.1.0로 브라우저 업데이트 강제 반영. 오프라인에서도 새 한국 지명 DB와 후원 페이지 사용 가능.
• 🛠️ 모바일 인코딩 안정화 — Safari에서 korea-admin-db.js의 한글이 드물게 깨지던 문제 해결을 위해 UTF-8 BOM 선두 추가. iOS·Android 브라우저 전반에서 한글 지명·주소 매칭 신뢰성 확보.

"풍경촬영 날씨체크"에서 PhotoMet · 사진 기상 플랫폼으로 전환. 각 페이지가 따로 움직이던 구조를 공통 데이터 레이어(lib/)로 묶고, 홈 화면에 앱으로 설치해 오프라인에서도 쓸 수 있도록 PWA로 재설계했습니다.

• 📱 PWA 홈 화면 설치 지원 — manifest.json과 service-worker.js 신규. 아이폰·안드로이드·데스크톱 어느 기기든 홈 화면에 설치해 주소창 없이 전체 화면 앱으로 사용 가능. Android에서는 아이콘 길게 누르면 "3일 예보·물때·위성영상" 바로가기 메뉴가 뜹니다.
• 🔌 오프라인 작동 — 네트워크가 끊겨도 마지막에 본 위치의 날씨·물때가 그대로 표시됩니다. 산속·섬·해외 출사지에서 로밍 없이도 직전 조회 내용을 참조할 수 있습니다. SW가 정적 자원·API 응답을 계층별로 캐싱합니다.
• 🏗️ 공통 데이터 레이어 (lib/) 신규 — 8개 모듈(cw-config, utils, cache, storage, location, weather-api, tides-api, marine-api)로 구성된 window.CW 네임스페이스. 각 HTML의 중복 fetch·localStorage 로직 제거. 페이지 간 캐시 공유로 네트워크 호출 최대 83% 감소, 페이지 로드 62% 단축.
• 🌬️ 실측 대기질(WAQI) 통합 — 한국 국내는 에어코리아 측정소의 구·군 단위 실측값 우선 사용. 해외는 OWM 모델 추정치로 자동 폴백. "● 실측 WAQI 67 · 종로구" 식으로 출처와 측정소명을 명시합니다.
• ⏰ 오늘의 시간대별 날씨 카드 — 3시간 간격 8개(00·03·06·09·12·15·18·21시)를 4×2 그리드로 한눈에. 각 시간대마다 날씨·기온·체감·풍향·풍속·운량·강수확률·습도·안개 위험·노을 품질을 표시. 일출·일몰 ±1.5h 카드는 노을 품질 점수(0~100)와 ✨ 황금 배경으로 강조. 현재 시각 카드는 "지금"으로 하이라이트.
• 🎨 테마 실시간 상호 동기화 — 한 페이지에서 다크·라이트를 바꾸면 다른 탭·페이지에 즉시 반영. storage 이벤트 기반으로 별도 새로고침 불필요.
• 🛠️ 타임존 버그 해결 — toISOString().slice(0,10)이 UTC 기준이라 한국 시간 오전 9시 이전에 전날 날짜가 반환되던 숨은 버그 수정. 로컬 날짜 기반으로 일괄 교체.
• 🏷️ 브랜드 전환 — 제품명을 PhotoMet(Photo + Meteorology)으로 정립. 홈 화면 아이콘, 스플래시 스크린, 메타데이터 일체 통일.

사용 현장에서 발견된 세 가지 문제를 직접 해결한 버전. 이름을 외우지 않아도 지도에서 관측소를 고를 수 있게 되었고, iPhone GPS 거부와 모바일 레이아웃 흔들림도 바로잡았습니다.

• 🗺️ 조류 관측소 지도 선택 UI 신규 — Leaflet 기반 인터랙티브 지도를 tides.html 조류 카드에 통합. 지역 필터(서해·남해·동해·제주) 칩, 다크·라이트 테마 자동 대응, 선택 시 펄스 애니메이션. 관측소 이름을 몰라도 촬영지 주변을 지도에서 바로 고를 수 있습니다.
• 📍 조위·조류 관측소 전용 페이지 — tidal-stations.html 신규. 36개 대표 조위 관측소를 Leaflet 지도 + 해역별 필터 + Pretendard 폰트로 정리한 참고용 페이지. 출사 전 관측소 위치를 확인하는 용도로 설계.
• 🍎 iPhone Safari GPS 복구 안내 강화 — "허용 안 함" 한 번 누르면 다시 묻지 않는 iOS의 사이트별 권한 구조를 감지. 기기별(iOS / Android / Desktop) 맞춤 복구 가이드를 다이얼로그로 표시. "방문 기록 삭제 → 재시도" 단계를 이미지 없이도 따라할 수 있도록 단계별 안내.
• 📱 모바일 가로 폭 흔들림 해결 — 배경 gradient orb의 transform 충돌과 html 요소의 overflow-x 누락으로 iOS Safari에서 간헐적으로 가로 스크롤이 발생하던 문제 수정. orb 크기를 모바일에서 60% 축소하고 `contain: strict`로 배경을 격리.
• 💾 조류 관측소 좌표 수집 저장 fallback — Synology NAS의 웹 디렉토리 쓰기 권한 문제로 populate 엔드포인트가 실패하던 현장 이슈 해결. `/tmp` 경로 자동 시도 + 실패 시 상세 진단 정보(실행 사용자, 디렉토리 권한, 에러 메시지) 출력.

해안 사진가의 결정 화면을 완성시킨 버전. 파고 데이터가 추가되어 갯바위 안전과 장노출 셔터 속도를 한 화면에서 판단할 수 있게 됐습니다.

• 🌊 파고 카드 신규 — Open-Meteo Marine API 기반, 좌표별 7일치 파고·파향·파주기. 카드 순서는 조석 → 파고 → 조류로 사진가의 판단 흐름에 맞춤.
• 📸 사진가용 5단계 파고 해석 — 잔잔(반영) / 약함(비단결) / 보통(포말) / 강함(역동) / 매우 강함(망원 안전). 파주기 8초 이상이면 "긴 너울" 보너스 표시.
• 🔍 한국어 지명 검색 강화 — 무안·함평·서귀포 등 검색 안 되던 문제 해결. 한글→로마자 매핑 240개 + 행정구역 접미어(군·시·구) 자동 처리.
• 📱 모바일 반응형 4단계 — 768px·480px·태블릿·터치기기 별도 대응. 검색박스 한 줄 유지, 9 카드 화면별 1/2/3열 자동, iOS 줌 방지.
• ⚡ 빠른 첫 화면 로딩 — 시스템 폰트 우선 사용으로 폰트 다운로드량 최소화 (15MB → 3MB).

해안 사진가를 위한 본격적 물때 화면이 완성된 버전. 국립해양조사원 공식 데이터 기반으로 신뢰도를 끌어올렸습니다.

• 🌊 조류(유향·유속) 카드 신규 — CSS 나침반 + 유속 게이지 + 5단계 사진가 팁
• 🔗 자동 매칭 — 조석 관측소 선택 시 가장 가까운 조류 관측소 자동 연결
• 📍 375개 관측소 지원 — 조석 171개 + 조류 204개 (격포항 포함)
• 🔎 한 글자 검색 — datalist 기반 즉시 자동완성
• ⚡ 2단계 로딩 — 1초 안에 오늘 정보 먼저 표시 후 7일치 보강

갯벌·해안 사진가의 가장 큰 요청이었던 물때 화면이 처음 등장한 버전. KHOA 조석 API 연동으로 신뢰성 있는 시작점이 됐습니다.

• 🌊 만조·간조 시각 + 음력 + 사리·조금 자동 계산
• 📅 7일치 탭 인터페이스 + ⭐ 추천일 선정
• 🇰🇷 KHOA 조석 API 통합

메인 화면의 9개 카드 체계가 자리 잡고, forecast.html과 satellite.html이 함께 추가된 시기. 사진가의 판단 카테고리가 정리됐습니다.

• 📊 9 카드 시스템 확정 — 현재날씨·시정·안개·노을·은하수·운량·풍속·대기질·종합점수
• 📅 forecast.html — 3일 출사 계획 + 자동 추천
• 🛰️ satellite.html — Windy 임베드 (7가지 레이어)
• 🌌 은하수·노을·달위상·Bortle 지수 통합 계산 추가
• 🌫️ 이슬점 기반 안개 5단계 위험도

초기 OpenWeatherMap 단일 의존을 벗어나, 한국 기상청 단기예보와 격자 좌표계를 정식으로 통합한 시기.

• 🇰🇷 기상청 단기예보 API + Lambert 격자 좌표 변환
• 🌬️ OpenWeatherMap 대기질 보조 데이터
• 🎨 다크 모드 + 글래스 카드 UI

컬러워크 교육원 수업 보조 도구로 시작된 버전. "출사 가서 흐리면 너무 아쉽다"는 한 학생의 말에서 출발했습니다.

• 📍 단일 도시 날씨 표시
• 🌐 OpenWeatherMap API 단독 사용
• 📚 colorwork.kr/app/weather 경로 확립