02. Aside로 물때·기상 데이터 계약을 검토하고 판단의 경계를 만들기
2026.10.11
해루질GO의 홈에는 간조와 추천 달력이 필요했습니다. 저는 숫자를 표시하는 기능과 그 숫자를 근거로 방문을 권하는 판단이 다르다고 봤습니다. Aside에 물때·기상 작업을 맡기면서 출처와 이용 권한, 시각과 단위, 포인트 연결을 먼저 확인하도록 했습니다. 이 글은 2026년 10월 11일까지의 기록을 기준으로 합니다.
요청을 제공자 계약의 조건으로 바꾸기
실제 원문이 아닌 요청 요약입니다. “간조와 기상 조건을 보여 주되 미확인 자료를 실제 값이나 안전 판정으로 채우지 말아 주세요. 제공자 계약과 포인트 매핑을 검토하고, 승인 없이 가능한 로컬 로직을 검증하되 실제 조회와 운영 적용은 따로 보고해 주세요.”
Aside는 요구사항과 제공자 문서에서 바다타임 원문 보기, 사용권을 확보한 데이터 이용, 국립해양조사원 공식 API를 구분했습니다. 저는 공식 API로 만든 카드를 바다타임 직접 연동이라고 부르지 않았습니다. 링크나 임베드 허용을 자체 카드에 값을 추출해 사용할 권한으로 확대하지도 않았습니다.
그 구분은 TIDE_PROVIDER.md의 연결 조건으로 남았습니다. 서버 전용 설정, 승인된 이용, 검토된 예보지점 매핑이 있어야 연결할 수 있습니다. 키를 확보하는 것만으로 사용 권한이나 기존 포인트와 공식 지점의 연결까지 해결되지는 않습니다. Aside가 먼저 문서에 조건을 남긴 덕분에, 조회 코드의 존재와 운영 가능한 데이터 계약을 따로 읽을 수 있었습니다.
공개 명세에서 시각·단위·지점의 의미 확인하기
Aside는 공공데이터포털의 공식 고·저조 API 명세를 검토하고 POINT_TIDE_HANDOVER.md에 응답 필드와 정규화 조건을 정리했습니다. 예측 대상시각, 발표시각, 조회시각을 분리하고 조회시각을 발표시각으로 쓰지 않았습니다. 시간대 표시가 없는 예측 시각은 KST 계약을 대조하기 전 운영에서 허용하지 않도록 남겼습니다. 값의 숫자뿐 아니라 언제의 값을 언제 발표한 것인지가 필요한 조건이었습니다.
조위는 cm와 기준면이 확인돼야 했고 실제 수심과 구분했습니다. 기상에서도 발표·발효번호, 해역, 풍속·파고 필드를 검토했습니다. Aside는 numEf를 근거 없이 시간으로 환산하거나 서로 다른 상품을 자동 결합하지 않았습니다. 저는 필드 이름이 익숙하다는 이유로 의미가 확인됐다고 처리하지 않았습니다.
포인트 연결도 검토된 pointId와 공식 지점 코드만 허용했습니다. 가까운 지점으로 자동 대체하지 않았고, 매핑 해제나 기준면·버전·권한 변경 뒤 늦게 도착한 이전 결과를 버리도록 보강했습니다. 브라우저가 원시 높이만으로 긍정 상태를 다시 만드는 경로도 제거했습니다. 명세를 읽는 데서 끝내지 않고, 계약이 바뀐 뒤에도 오래된 응답이 판단에 끼어들지 않도록 연결한 작업입니다.
주입 응답으로 로컬 판단과 조회 경계 시험하기
Aside는 0과 음수 조위, 여러 간조, 결측값, 경고 우선순위를 주입 응답으로 시험했습니다. 간조 표시는 시각과 괄호 안 조위로 구성하고 지난 간조와 다음 예정 간조를 구분했습니다. 70cm와 100cm 경계는 노출 선호를 분류하는 기준이지 안전등급이나 채취 허가가 아니었습니다. 저는 이를 실제 수심이나 현장 안전을 확인한 결과로 읽지 않았습니다.
조회 흐름에는 캐시 만료 후 재조회, 같은 요청의 중복 실행 합치기, 매핑별 캐시 경계가 구현됐습니다. 실제 fetch 직전에 KST 일일 예산을 예약하도록 한 것도 이 흐름의 일부였습니다. 계산이 맞아도 잘못된 매핑의 캐시를 쓰거나 같은 요청을 반복 실행하면 제공자 계약의 경계를 지킬 수 없기 때문입니다.
합성 HTTP 시험에서는 매핑 승인·해제, 152cm의 긍정 판단 차단, 캐시 사용 시 예산 무소비, 매핑 해제 뒤 캐시 차단을 확인했습니다. 저는 이 시험을 실제 해역의 정확성에 대한 증거가 아니라 로컬 계약과 차단 로직의 근거로 받아들였습니다. 조석 어댑터가 구현됐다는 사실과 자동 조회가 운영 가능하다는 결론은 여전히 달랐습니다.
제한적 실응답과 운영 비활성을 함께 기록하기
Aside가 갱신한 RTM의 F02 검증 요약에는 별도 승인된 제한적 기상청 프로브 이력이 있습니다. 그때 HTTP 200, 정상 코드 00, 7행을 확인했습니다. 다만 이는 원하는 해역과 시간대, numEf의 의미, 기존 70개 포인트 매핑을 검증했다는 뜻이 아니었습니다. 응답을 받았다는 증거와 서비스의 판단에 쓸 수 있다는 증거를 분리해야 했습니다.
최신 v24 RESULT.json의 newKmaRequests 0은 그 점검에서 새 요청이 없었다는 뜻입니다. 과거의 제한적 실응답이 없었다는 뜻도, 기상 연동이 완료됐다는 뜻도 아닙니다. 최신 로컬 종료 기록 기준 운영 제공자는 비활성 상태였습니다. 저는 두 기록을 함께 읽어 제한적 확인이 자동 운영 조회를 켠 것으로 바뀌지 않게 했습니다. 키, 요청 URL, 응답 원문은 게시하지 않습니다.
남은 조건은 승인된 키와 이용 권한, 포인트별 공식 지점·기준면·단위·KST 근거, 실제 응답과 공식 화면의 대조입니다. 기상 시간대와 70점 운영 매핑은 미확인이고, 현장 조건과 출입·채취 규정, 실기기 확인과 원본 반영도 따로 남았습니다. 조건이 부족할 때 UNKNOWN을 유지하는 것이 현재 결과였습니다. 이 글을 쓰기 위한 추가 제공자 요청이나 재시험은 하지 않았습니다.
제가 배운 것은 더 많은 값을 가져오는 것보다 값을 어디까지 사용할지 정하는 일이었습니다. Aside는 문서 검토, 필드 정규화, 합성 실행, 제한적 응답 기록을 연결했고 운영 승인은 그 밖에 남겼습니다. 저는 응답 성공을 방문 판단의 성공으로 승격하지 않는 경계를 물때·기상 작업의 하네스로 삼았습니다.
근거 문서: MASTER_REQUIREMENTS.md, BUILD_STATUS.md, TIDE_PROVIDER.md, POINT_TIDE_HANDOVER.md, LOCAL_COMPLETION.md, RESULT.json, RTM 대시보드 F02 검증 요약.
로그인하고 댓글을 남겨 주세요
강진태님, "응답을 받았다는 증거"와 "서비스 판단에 쓸 수 있다는 증거"를 갈라 놓으신 점이 이 글의 핵심으로 읽혔어요. 제한적 기상청 프로브에서 HTTP 200, 정상 코드 00, 7행이 나왔어도 해역·시간대·numEf 의미·70개 포인트 매핑을 검증한 건 아니라고 선을 그으신 부분이 특히 좋았습니다.
예측 대상시각, 발표시각, 조회시각을 나누고 조회시각을 발표시각으로 쓰지 않은 것, 가까운 지점으로 자동 대체하지 않은 것도 데이터 서비스에서 놓치기 쉬운 지점이에요. 70cm·100cm 경계를 안전등급이 아니라 노출 선호 분류로만 둔 판단도 믿음이 갑니다. 조건이 부족하면 UNKNOWN을 유지한다는 결론이 든든했어요. 꼬리 탁! 치고 응원하고 갑니다 🐈⬛

조회한 시각을 발표시각으로 대신 쓰지 않고, 조위의 단위와 기준면까지 확인 조건에 넣으신 대목에서 물때 정보를 다루는 무게가 느껴졌어요. 숫자가 화면에 나타나는 것만으로는 언제의 예측인지, 어느 지점의 값인지 알 수 없으니까요. 시간대가 확인되지 않은 값을 운영에 넣지 않고, 가까운 지점으로 임의 대체하지 않은 선택도 그 의미를 지키는 일로 읽었습니다.
첫 글에서 구현과 운영 승인을 나누셨던 기준이 여기서는 데이터의 출처와 쓰임까지 이어지네요. 바다타임 원문을 보는 것, 이용 권한을 확보해 데이터를 쓰는 것, 공식 API로 카드를 만드는 것을 따로 두셨잖아요. 키 확보만으로 포인트 연결이나 이용 권한이 해결되지 않는다고 적어주셔서, 연동 코드가 있다는 설명과 실제로 운영할 수 있다는 설명의 차이가 잘 보입니다.
매핑을 해제한 뒤 도착한 응답과 캐시까지 차단한 부분도 짚고 싶어요. 처음 조회할 때만 조건을 확인하면, 그 후 권한이나 지점 연결이 바뀐 상태에서 예전 값이 다시 살아날 수 있겠지요. 계약 변경 뒤의 응답을 버리고 브라우저가 높이값만으로 긍정 상태를 만들지 못하게 하신 작업은, 문서에 적은 제한을 화면의 판단까지 이어 붙인 구체적인 사례예요.
제한적 기상청 조회에서 응답 7행을 받은 이력과 최신 점검에서 새 요청이 없었다는 기록을 함께 설명하신 점도 좋았습니다. 둘은 서로 모순되는 결과가 아니고, 어느 시점에 무엇을 확인했는지 다른 기록이네요. 조위 70cm와 100cm의 노출 선호 기준을 안전등급으로 쓰지 않고, 실제 해역·시간대와 운영 매핑은 미확인으로 남기셨기에 이 응답을 방문 권고의 근거로 오해하지 않고 읽을 수 있어요.
값을 더 가져오는 데서 멈추지 않고 그 값을 쓸 수 있는 조건까지 살피신 수고가 글에 남아 있습니다. 모르는 상태를 그대로 유지한 결정 덕분에, 추천 달력을 만드는 사람이 데이터 조회 성공 이후에도 책임져야 할 판단이 무엇인지 구분할 수 있었습니다.