fishing_check 🎣 피싱체크
서해·동해 바다낚시 출조 결정 엔진을 담은 반응형 모바일 웹(PWA)입니다.
물때(만조·간조), 바다날씨, 수온, 포인트 유형(내항·외항·방파제·갯바위·선상), 어종 습성을 합쳐 "언제, 어디서, 무엇을" 낚을지 알려줍니다.
주요 기능
- v1.32 미리 알 수 있는 순서: 확인 순서를 ① 물때·해 뜨는 시각(2주 전부터, 천문 계산) → ② 파도·바람·앞바람/뒷바람(7일 전부터 예보) → ③ 수온·냉수대(1
3일 전) → ④ 유튜브 캠·조황·새떼(당일)로 정리(점수 비중은 그대로). /agent를 같은 순서로 재배치: 순서 안내 → ① 2주 미리 보기(오전 피딩 + 중·끝들물 겹치는 날, 천문 추정 src/lib/surfPlan.ts) → ② 3일 TOP → ③ 한 번에 찾기(1순위 카드도 ①④ 단계별) → ④ 실시간 바다 보기. 단계 정의 LEAD_TIERS(src/data/liveView.ts)
- v1.31 한 번에 찾기(속초·양양·강릉 서프루어): 홈 버튼 한 번 →
/agent#now가 해변·방파제 끝·외항·갯바위 9곳의 최신 예보(파도·바람·수온·냉수대 급랭)·물때·해 뜨는 시각을 다시 받아 앞으로 24시간 회유어 서프루어 갈 곳 1순위 + 대안을 고름. 지금 점수 = 에이전트 점수 − 파도·바람 주의 8 − 앞바람(포인트 방향 기준, 5m/s 이상) 5 − 냉수대 15. 지역별 지금 바다, 유튜브 고정 캠 방송 상태 자동 확인(영상 페이지 isLiveNow, 실패 시 확인 못 함), 새떼·보일링·조황은 1탭 확인 링크(오늘 영상·최근 조황·지금 낚시 라이브). API /api/agent/now, 스크립트 node scripts/pelagic-agent.mjs --now
- v1.30 실시간 바다 보기(속초·양양·강릉):
/agent#live와 포인트 화면 — 조황(유튜브 오늘 업로드·네이버 블로그 최근 1주 검색), 유튜브 라이브(속초해수욕장·강문해변 24시간 캠 + '지금 방송 중' 라이브 필터 검색), CCTV·웨이브캠(바다타임 속초등대·주문진, WSB FARM, CCTV월드, 뷰맵라이브 경포, 해양수산부 연안포털), 국립수산과학원 냉수대·실시간 수온, 파도예보. 확인한 것(조황·새떼·사람 몰림·냉수대·파도)을 고르면 출발/조건부/보류 판단(파도·냉수대는 보류). 데이터 src/data/liveView.ts, 스킬에도 반영
- v1.29 회유어 찾기 에이전트(속초·양양·강릉 워킹 시범): '들물 + 새벽 동틀 무렵 + 외해 조류가 통하는 방파제·갯바위 + 적정 수온' 조합을 포인트 × 날짜 × 시간대로 자동 순위(
src/lib/pelagicAgent.ts, 규칙 기반·별도 AI API 없음). 에이전트 점수 = 앱 점수(그 시간대 최고) × 0.6 + 조건 일치(오전 피딩 30·들물 30·외해 소통 25·수온 15) × 40, 위험·금어기·지난 시간 제외, 물 높이 차이 60cm 미만이면 들물 가중치 40%. 화면 /agent, JSON /api/agent/pelagic?days=3&limit=5. Claude Code 스킬 .claude/skills/pelagic-agent(+ node scripts/pelagic-agent.mjs)로 Claude가 결과를 읽고 출조 계획을 세움
- v1.28 회유어 신호·길목: 삼치·고등어·부시리 '회유 신호' 탭 — 관찰 순서 체크(편광 선글라스 5
10분, 하늘·수면·소리·물결·물때), 신호 9가지(갈매기 다이빙·가마우지·보일링·라이징·쫓기는 베이트볼·멸치 소리·포말/조경 띠/여·쉬는 새·신호 없음) → 가능성·뜻·할 일(현장 경험/사실/추론 + 출처), 시간대별 길목(오전 피딩 해 뜨기 30분 전뜬 뒤 2시간 연안 급심·외항 석축 / 낮 1016시 곶부리·외해 쪽 깊게 / 오후 피딩 해 지기 2시간 전진 뒤 30분 연안·홈통 입구), 물때 궁합(중들물~끝들물 가장 좋음, 간조·끝썰물 어려움). 포인트 화면은 그날 실제 시각에 물때 단계·수온(어종 범위)·최고 점수를 겹쳐 보여 줌. 바로잡음: '새 다이빙 = 100% 포식어'는 가능성이 아주 높음으로, 가마우지는 스스로 잠수해 사냥하는 새라 포식어 증거가 아님
- v1.27 삼치 새떼·보일링: 삼치 화면 '새떼·보일링' 탭 — 지금 보이는 신호(갈매기 내리꽂힘·보일링·먹잇감·쉬는 새·신호 없음)를 고르면 삼치 가능성·뜻·할 일(현장 경험/추론 표시), 포인트·시간·루어 무게·색 요령과 출처. 포인트 화면(삼치 선택 시) '새떼·보일링 살필 시간'(해 뜨기 60분 전
뜬 뒤 90분, 해 지기 90분 전진 뒤 20분, 앱 추정)과 그 시간 최고 점수. 삼치·감성돔 금어기 5/1~5/31 반영(해양수산부). 데이터 src/data/boil.ts
- v1.26 달별 물때 달력 · 8물때식 바로잡기:
/tide#tc-month 달력(일요일 시작, 일 빨강·토 파랑, 날짜 옆 그날 물때, 사리 정도로 칸 색, 🌑 삭·🌕 망, 오늘 표시, 이전·다음 달, 서해 7물때식↔남·동해 8물때식 비교 보기, 29일 달에 건너뛴 물때 안내). 8물때식을 바로잡음 — 무시가 없고 조금 전날이 14물, 조금은 서해와 같은 음력 8·23일(이전엔 조금·무시를 하루 앞당겨 표시). 2026년 11월 30일치가 남·동해 물때 달력과 같은지 테스트. 보름(망) 시각을 Meeus 식으로 계산(fullMoonJde, moonPhasesBetween). '물때, 이렇게 읽어요' — 숫자는 물 세기가 아니라 며칠째, 물때별 평균 물 차이 막대(가장 센 날 서해 8·9물·남해 9·10물, 가장 약한 날 무시·1물 무렵 — 이 앱 계산), 두 방식 비교표
- v1.25 초들물·초날물 계산 · 바늘 크기 점검: 물때 — 초들물(간조부터)·초날물(만조부터)을 그날 실제 간격 ÷ 3으로 계산해 포인트 물 높이 표(⏱, 고른 어종 최고 점수 함께)와 7일 물때표에 표시,
/sea#s-calc 물때표 계산기(간조·만조 시각 입력 → 정조·초·중·끝 시간, '+2시간' 어림셈과 차이, 12분의 1 법칙 8·17·25·25·17·8%). 용어 보완: 평균 간격 약 6시간 12분(M2 12시간 25분의 절반), 창조·낙조, 여, 물돌이 타임(앞뒤 약 1시간·경험담 표시), 하루 만조·간조 3번인 날, '초들물·초날물 계산' 용어. 바늘 — 25종 바늘 값을 낚시 매체·커뮤니티·판매처 자료와 대조해 수정 5(노래미 '감성돔 바늘 1012호' 표기 오류→세이코 1012호, 학꽁치 13호→47호, 숭어 68호→감성돔 12호, 가자미 1012호→세이코 1216호, 전어 카드 46호→34호)·보완·엇갈림·미확인을 표시(src/data/hookCheck.ts, 채비 치수가 이 값을 그대로 씀). /hooks 내 바늘 체크(어종·호수 → 작음/적당/큼), 현장 신호별 바늘 조정, 출처 점검 결과, 어종 화면 바늘 줄에 출처 상태
- v1.24 물때 용어 · 어종 습성 · 낚시 방법: 물때 용어 — 간조→만조→간조 한 바퀴 그림(앱 규칙 그대로: 만조·간조 앞뒤 40분 = 정조, 들물·썰물을 셋으로 나눠 초·중·끝, 12분의 1 법칙 막대), 만조·간조·조차·매일 50분·들물(밀물)·썰물(날물)·정조·물돌이·조류·초/중/끝 들물·썰물·물때·사리·조금·무시·7/8물때식 21개 용어를
/sea#s-terms·포인트 물 높이 표('물 단계가 뭐예요?', 지금 단계 강조)·도움말·장비 용어 사전 '물때·물 흐름' 분류(‘초돌’로 찾아도 초들물)에 연결. 어종 습성 — 25종의 사는 곳·움직임(정착·계절 이동·회유)·번식(난태생·성전환·알 지킴·1년살이)·산란기를 출처 번호와 근거 수준(공공·연구기관/논문/백과/기사/현장 경험/추론)으로 표시, 자료마다 다른 값은 '자료마다 다름'으로 함께, 제철·산란·금어기 한 해 달력과 '그래서 이렇게 낚아요'(사실 → 낚시 연결). 어종 화면 탭 '습성·먹이', /habits 25종 달력·이번 달 산란·금어기·움직임별·번식 특징. 참문어 금어기 5/16~6/30(시·도 달리 정할 수 있음) 반영. 낚시 방법 — /methods 원투·루어·찌·선상·대낚시(민장대) 원리·순서·활동량/비용/난이도·이런 분께·대표 어종·채비 연결, 훌치기는 원리·규정(내수면 제한 사례, 바다 전국 금지 조문 미확인)·위험만 사실대로(방법 안내 없음). 어종 화면 '이 고기를 낚는 방법'. 데이터 src/data/tideTerms.ts, src/data/habits.ts, src/data/methods.ts
- v1.23 바늘 고르기 · 바다 이해하기:
/hooks — 바늘 부분 이름 그림(귀·축·휨·품·끝·미늘), 모양별 쓰임(짧은 축·긴 축·세발·갈고리), 호수 읽는 법(계열마다 기준이 달라 숫자 비교 불가, 서양식 #·/0, 지그헤드 g·에기 호), 크기를 정하는 6가지 이유(입·미끼·방법·줄 균형·이빨·활성도), 입 크기별 분류, 25종 바늘·줄·채비·이유(규격은 rigSpecs 단일 출처). /sea — 바다를 읽는 8가지(물때·조류·수온·바람·파도와 너울·기압·바닥·빛: 무엇·고기에게·앱에서·안전), 해역별 사리 조차(관측소 추정값) 범위, 점수 엔진의 해역별 비중과 시간대 판단의 물 흐름 비중, 하루·보름·계절 리듬, 위험 신호. 어종 화면 채비 카드에 바늘 이유 연결. 데이터 src/data/hooks.ts, src/data/sea.ts
- v1.22 채비 도감:
/rigs(더보기·도움말·장비 용어·어종 화면에서 연결). 채비 16종(바닥 가지채비·유동 봉돌 외바늘·선상 바닥·다운샷 / 반유동·전유동·막대찌 / 카드 / 지그헤드·노싱커·미노우·메탈지그·타이라바 / 에깅·봉돌+에기·오징어 뿔)을 그림·구성(위→아래, 용어 사전 연결)·원리·쓰는 법·장단점·실수·대표 어종으로 정리. 채비 고르기(장소·깊이·미끼), 한눈에 비교 표. 채비 그림에 노싱커·전유동·유동 봉돌·오징어 뿔 추가. 어종 화면 일치: 벵에돔 전유동(찌멈춤 없음), 돌돔 구멍봉돌, 오징어 뿔 그림. 기존 그림 글자 잘림 수정(루어, 타이라바). 데이터 src/data/rigs.ts
- v1.21 바다낚시 장비·용어:
/gear(더보기·도움말·어종 목록에서 연결). ① 물고기를 잡는 6단계(던지기→깊이 맞추기→유혹→입질→걸기→끌어올리기)와 맡는 장비, ② 부분 이름 그림(낚싯대·스피닝 릴 9곳, 찌낚시 채비 연결 순서 9곳 + 원줄/목줄/찌밑 수심), ③ 장르별 장비 조합(원투·찌·루어·카드·선상, 채비 그림·핵심 용어·대표 어종), ④ 검색·분류되는 용어 사전 66개(역할·이유·요령·실수·함께 쓰는 용어·관련 화면), ⑤ 첫 장비 체크리스트. 사용자 제공 자료를 바탕으로 정리·보완(백래시는 주로 베이트릴, 플로팅 원줄은 찌낚시용 등). 채비 그림의 '낚싯줄'·'찌멈춤 매듭' 글자 겹침 수정. 데이터 src/data/gearTerms.ts
- v1.20 어종별 릴 감기: 어종 상세 '릴 감기' 탭(
/fish/{id}#reel). 25종 한 주기(감기·저킹·폴링·끌기·고패·흘림·멈춤·기다림의 초·핸들 바퀴·바퀴/초) 리듬 막대, 속도 등급, 왜 이 속도인지(먹는 방식과 연결), 입질 뒤 감는 법·자주 하는 실수, 조건 보정(수온은 엔진의 tempFit, 밤·물살·바람), 내 릴 '1회전당 감기는 길이'로 cm/초 계산, 따라하기 코치(실시간 단계·바퀴 세기). 포인트 상세에 고른 어종의 오늘 조건 맞춤 요약. 값은 현장 통용 기준이며 낚시 방법 탭과 일치(참돔 1초 1바퀴, 볼락 1초 반 바퀴). 데이터 src/data/retrieve.ts, 로직 src/lib/retrieve.ts
- v1.19 구조물별 서식 가이드:
/structures(도움말·포인트 상세에서 연결). 테트라포드·석축·수직벽·선착장 그늘·모래 바닥·암초·방파제 안/밖·방파제 끝·가로등 경계·모래-암초 경계 10개 환경을 대표 어종·상주/회유·이유·수층·낮밤·민장대/원투 적합성·미끼·안전으로 비교, 근거를 생태/현장/추론/규정으로 구분하고 출처 표기. 문어·오징어류는 따로(속초시 문어낚시 금지 조례 등). 설악항·물치항·낙산항 내항 포인트 추가(좌표 대략값, 확인된 정보·미확인 항목 분리). 모든 포인트 상세에 '구조물별 노릴 곳'(기사로 확인된 구조물 또는 포인트 종류 기준). 조사 문서: docs/12-structure-habitat-sokcho-yangyang.md, 데이터: src/data/structures.ts
- v1.18 어종 먹이 습성: 어종 상세에 '먹이 습성' 탭(
/fish/{id}#feed, 포인트 상세 어종 카드에서도 연결). 25종 전부: 먹이 구성(%) 막대, 먹는 깊이(표층·중층·바닥) 단면 그림, 하루 먹이 활동 24시간 막대(밤 음영·지금 표시), 수온별 먹이 활동 곡선, 미끼 궁합(미끼가 흉내 내는 자연 먹이 비중으로 잘 맞음/보통/약함), 먹는 방식별 요령, 입질 모습, 철마다 먹성, 먹이가 비슷한 어종. 하루 활동·수온 곡선은 점수 엔진과 같은 식(lightFit·tempFit)을 써서 점수와 어긋나지 않음(엔진 결과 해시 동일 확인). 데이터: src/data/feeding.ts, 로직: src/lib/feeding.ts
- v1.17.1 첫 화면·속도: 포인트 상세에서 황금타임 상자를 점수 바로 아래로 올림(첫 화면에 보이게). 그날 남은 황금타임이 없으면 다음 좋은 날의 황금타임을 첫 줄에 안내. 점수 계산에서 어종과 무관한 물때 값을 포인트당 한 번만 계산하고 신월 계산을 캐시해 전체 순위 첫 계산 시간 약 20% 단축(결과 동일 확인). GitHub Actions 30분 예약 실행에서 홈·랭킹 데이터를 미리 계산(한국시각 00:05 포함,
FC_SITE_URL만 있으면 동작).
- v1.17 물때표: 새 화면
/tide(홈 '물때표' 버튼, 포인트 상세 물 높이 표 아래 링크). 포인트별 날짜마다 만조·간조 시각·높이, 조차, 사리 정도 막대, 일출·일몰, 낮 시간 들물 구간, 그날 추천 어종 점수. 다음 사리·조금까지 남은 날, 한 달(5주) 물때 달력(7/8물때식 설정 따름). 포인트 상세 '시간대별 물 높이'에 고른 어종의 가장 좋은 시간·물 단계 요약과 그 시간대 '입질' 표시. 로직: src/lib/tideCalendar.ts
- v1.16 전국 해안 시·군·구 + 시간대별 물 높이: 포인트 53곳 → 142곳. 바다를 낀 모든 시·군·구(인천·경기·충남·전북·전남·경남·부산·울산·경북·강원·제주)에 대표 항구·방파제·갯바위·해변, 흑산도·거문도·추자도·울릉도·덕적도 등 섬과 섬 안쪽 대피 항구. 새 조위관측소 11곳 연결. 새 포인트 좌표는 대략값(길찾기는 이름 검색). 모든 포인트 상세에 '시간대별 물 높이' 표(매시 cm·1시간 변화·초/중/끝 들물·썰물·만조·간조·물살 셈, 조차, 관측소·출처). Open-Meteo 요청은 0.05° 격자로 공유. 데이터:
src/data/coastSpots.ts
- v1.15 포인트 상세 '시간대별 잡히는 어종': 낚시터 → 포인트(선착장 등) 상세에서 새벽·오전·한낮·오후·저녁·심야마다 상위 3어종(좋음·보통·나쁨·희박 + 지수), 그 시간대 최고 2시간, 물 흐름(들물·썰물), 점수를 올린 이유, 막힌 시간대는 이유(위험·배 안 뜸), 지난 시간대는 내일로. 아래에 그 포인트 48시간 어종별 입질 지수(시간축 이동)
- v1.14 어종별 입질 지수 (
/hourly 기본 보기): 포인트 하나의 지금부터 48시간을 시간 눈금(3시간마다)·환경 줄(3시간 묶음, 바람·파도·기압)로 펼치고, 시각을 누르거나 슬라이더로 옮기면 어종별 고리 그래프(0~100 지수, 좋음·보통·나쁨·희박)가 그 시각 순위로 바뀜. 점수순/이름순, 포인트 고르기·내 주변·지난번 포인트 기억, 금어기·위험 시간은 0. 확률이 아니라 조건 지수임을 화면에서 설명
- v1.13 시간대별 추천 (
/hourly, 홈 '⏰ 시간대별 추천', 가장 잘 잡히는 포인트에서도 연결): 하루를 새벽(04–07)·오전·한낮·오후·저녁·심야(23–04) 6개 탭으로 나눠 시간대마다 가장 좋은 연속 2시간이 높은 포인트·어종 순위(포인트당 1어종, 위험·배 안 뜨는 시간·금어기 제외). 오늘/내일/모레·바다 선택, 지금 시간대 탭이 먼저 열림, 지난 시간대는 내일로 안내. 10분 공유 캐시
- v1.12 오늘 밤 밤낚시 (
/night, 홈 '🌙 오늘 밤 밤낚시 스팟'): 서울(또는 내 위치) 120km 안 밤낚시 포인트를 오늘 밤(일몰~새벽 3시) 실시간 예보로 순위 — 가장 좋은 2시간·들물 시간·바람·파도·체감온도·위험 판정. 방식(원투·루어·찌·가족) 선택, 24시간 유료 바다낚시터(정성·선재·만정) 오늘 밤 쾌적도, 영종도 삼목선착장·망둥어 추가
- v1.11 앱 푸시 알림: 설정 → 알림에서 켜기. 매일 새벽 5시 반 즐겨찾기 포인트의 오늘 황금타임·위험 예보(황금타임이 없으면 이번 주 더 나은 날), 선택 시 황금타임 30~90분 전 알림(GitHub Actions 30분 간격), 시험 알림. 아이폰은 홈 화면에 추가한 앱에서(iOS 16.4+). 필요: Upstash +
VAPID_PUBLIC_KEY·VAPID_PRIVATE_KEY(/setup 에서 생성) + CRON_SECRET. 점검: node scripts/push-e2e.mjs
- v1.10 회원가입 이메일 인증(무료): 가입 시 이메일로 6자리 인증번호(10분, 5회까지), 인증 안 하면 화면·서버 모두에서 가입 차단, 이메일 인증번호로 비밀번호 찾기. Gmail 앱 비밀번호(
GMAIL_USER·GMAIL_APP_PASSWORD, 하루 약 500통 무료)만 넣으면 켜짐 (또는 Brevo·Resend). 저장소 없이 서명 토큰으로 동작. 경쟁 분석: docs/11-competitor-eosin.md
- v1.9.1 홈 화면 바로 추가: 안드로이드·PC 크롬은 버튼 한 번으로 설치 창(늦게 오는 설치 이벤트 대기, Web Install API), 아이폰은 사파리 버전별 안내 + 눌러야 할 버튼 화살표, 플레이스토어 앱(TWA)용
/.well-known/assetlinks.json. 한계와 방법: docs/10-home-install.md
- v1.9 회원가입·로그인 바로 사용: 키 없이도 가입·로그인·닉네임·비밀번호 변경·탈퇴가 동작(계정은 각 기기에 저장). Vercel → Storage → Upstash for Redis 를 연결하면 자동으로 서버 계정(여러 기기 동기화·사장님 조황 공유)으로 전환. 홈 상단 '로그인·가입' 버튼, 로그인 화면의 회원가입 버튼. 점검:
node scripts/account-e2e.mjs
- v1.6 어종 24종·낚시점: 갈치·농어·벵에돔·삼치·부시리·숭어·전어·도다리·문어·붕장어·돌돔·오징어 추가, 포인트 근처 낚시점(카카오·네이버)과 전화 질문 자동 작성, 이용자가 공유하는 '사장님께 들은 최근 조황'
- v1.5 전국 바다: 전남·경남·부산·울산·제주 포인트 추가(남해 전용 계산 방식), 추가 이유 안내 팝업, 내 주변순에 '○○시 ○○동 근처' 주소 표시, 가장 잘 잡히는 포인트 화면 재설계
- v1.4 회원가입·로그인: 이메일(선택: 카카오) 가입, 약관·개인정보 동의, 즐겨찾기·조과 기록 기기 간 동기화, 내 계정·탈퇴 (Supabase, 키가 없으면 로그인 없이 동작)
- 채비 실제 치수: 어종별 원줄·목줄·가지줄 호수와 길이, 가지 간격, 봉돌 호수, 찌밑 수심, 바닥에서 띄우는 높이를 치수선 그림·표로
- 채비 준비물 실시간 가격: 쿠팡 파트너스 Open API(대체: 네이버 쇼핑) 가격·링크, 필수 준비물 합계
- 캐스팅·채비 움직임 영상: 던지기(또는 배에서 내리기)부터 가라앉기·입질·챔질까지 채비 종류별 애니메이션 + 단계 자막
- v1.3 디자인 시스템: 홈·낚시터·포인트 상세·어종 목록/상세·내 기록·설정·도움말 8개 화면을 새 디자인 시스템(라이트 기본, 다크·자동 테마, 하단 5탭)으로 재구성. 포인트 사진 대신 SVG 풍경·어종 일러스트, 시간대별 낚시지수 막대, 물때 곡선, 현재 해황 타일, 하단 고정 길찾기·즐겨찾기 버튼
- 가장 잘 잡히는 포인트(
/best): 날짜·해역·유형·어종별 점수 높은 순 추천
- 카카오톡 공유 썸네일:
public/og.jpg (1200×630) Open Graph
- 어디 갈까 (홈): 해역(전체·서해·동해) × [오늘(남은 시간)·토·일] 상위 포인트 랭킹과 위험 경고
- 지금 카드: 현장용 — 들물/썰물, 다음 만조·간조까지 남은 시간, 지금 점수, 진행 중·다음 골든타임
- 피싱 인덱스(0~100)와 골든타임: 포인트 × 어종 × 1시간 단위로 점수를 매기고, 가장 좋은 연속 구간(최대 4시간)을 근거 칩과 함께 보여줍니다.
- 7일 출조 캘린더: 날짜별 출조 판정(출조 추천 / 무난 / 비추천 / 위험)과 물때를 보여줍니다.
- 안전 게이트: 강풍, 월파, 너울(파주기 8초 이상), 해무, 간조 고립 조건이면 점수를 제한하고 "위험"으로 표시합니다. 이때 더 좋은 날과 인근 대체 포인트를 추천합니다.
- 물때 계산: 음력 날짜와 물때를 서버에서 직접 계산합니다. 7물때식과 8물때식을 설정에서 고를 수 있고, 월령·일출·일몰도 함께 계산합니다.
- 시간대별 차트: 점수 막대와 조위 곡선을 함께 보여줍니다. 시간대를 누르면 세부 조건과 점수 구성을 볼 수 있고, 표 보기로도 전환할 수 있습니다.
- 어종별 점수 탭: 그날 가장 점수가 높은 어종을 기본으로, 탭마다 점수·⚠·금어기 표시
- 포인트 찾기: 검색, 초보·가족·화장실·주차·야간 필터, 가까운 순
- 캘린더 추가(.ics): 골든타임 90분 전 알림 / 용어·도움말(
/guide) / 안전 수칙 카드
- 물고기별 낚는 법: 미끼 먹는 모습(입질), 언제 낚아채는지, 채비 그림(SVG 6종), 따라 하는 순서, 처음 준비물, 흔한 실수, 안전, 영상 보기(YouTube) — 포인트 화면과 물고기 화면에서 제공
- 쉬운 말: 중학생도 이해할 수 있게 화면 문구·점수 설명을 다듬음 (예: 들물 → "물 들어오는 중")
- 어종 도감: 12종의 월별 시즌, 적정 수온, 선호 물때, 채비·미끼, 금어기·금지체장 경고를 담았습니다.
- 조황 기록: 기록할 때 그 시각의 예측 점수를 함께 저장해 "골든타임 적중률"을 계산합니다. 사진(자동 축소)을 붙일 수 있고, 기록은 이 기기에만 저장되며 JSON으로 내보낼 수 있습니다.
- PWA: 홈 화면에 설치할 수 있고, 통신이 약한 곳에서는 마지막으로 받은 데이터를 보여줍니다. 설정에서 라이트·다크·자동(기기 설정 따름) 테마를 고를 수 있습니다.
실행
npm install
cp .env.example .env.local # 키는 선택 사항
npm run dev # http://localhost:3000
npm test # 단위·시나리오 테스트
npm run simulate # 엔진 대량 시뮬레이션 리포트 (docs/sim/engine-report.md)
npm run ux # 브라우저 UX 시뮬레이션 (서버 실행 필요, docs/06 참고)
npm run build && npm start
데이터 소스와 폴백
| 데이터 | 1순위 (키 필요) | 2순위 (키 불필요) | 최후 폴백 |
|---|
| 조석(고·저조) | 국립해양조사원 조석예보(공공데이터포털) DATA_GO_KR_SERVICE_KEY | Open-Meteo 해수면 모델 | 천문 추정 모델 |
| 바람·강수·기온 | 기상청 단기예보 DATA_GO_KR_SERVICE_KEY | Open-Meteo 예보 | 데모 값 |
| 파고·파주기·수온 | 기상청 파고(WAV) + Open-Meteo Marine | Open-Meteo Marine | 데모 값 |
어떤 소스를 썼는지는 화면 아래쪽에 표시됩니다. 추정 모델이나 데모 값을 쓸 때는 경고도 함께 표시됩니다.
FISHING_OFFLINE=1로 설정하면 외부 호출 없이 개발할 수 있습니다.
구조
src/
app/ Next.js App Router (홈, 포인트, 포인트 상세, 어종, 조황기록, 설정, API)
components/ Timeline(점수·조위 차트), HomeClient, CatchLog, Settings …
data/ spots.ts(베타 포인트 29곳), species.ts(어종 12종)
lib/engine/ astro(음력·물때·일출몰), tide(조위 보간·극값·추정), score(점수·안전·골든타임)
lib/providers/ khoa, kma, openMeteo, demo, index(폴백 체인·캐시)
lib/sim/ scenarios(기상 시나리오 9종), mode(?sim= 시뮬레이션 모드)
scripts/ simulate.ts(엔진), ux-walkthrough.mjs(브라우저 UX), make-icons.mjs
public/ manifest, service worker, icon
docs/ 리서치·기획·구현 문서
문서
점수는 참고용 예측입니다. 출항·출입 여부는 해양경찰·선장·현장 안내를 따르세요.
