학생, 교사, 일반 사용자가 전 세계 CMIP6 기후 시나리오를 지도에서 조회하고 기간 자료를 CSV, PDF, PNG로 저장할 수 있는 공개 Web UI입니다.
- OpenStreetMap 기반 전 세계 좌표 선택, 휠 확대·축소, 드래그 이동
- 날짜, 위도·경도, SSP 시나리오, 6개 CMIP6 모델 및 전체 앙상블 조회
- 최고기온, 최저기온, 강수량, 풍속, 열지수, 체감기온 표시
- 선택일, 월, 1년, 5년, 10년 또는 전체 기간 내보내기
- 원자료 조회 중 진행 표시와 새로고침 방지 안내
- 320px 모바일부터 와이드 데스크톱까지 반응형 화면
일반 Frontend 개발에는 Node.js 20.19 이상 또는 22.12 이상과 pnpm이 필요합니다. 읽기 전용 Python 게이트웨이 통합에는 Python 3.12 이상이 추가로 필요합니다. 출시 컨테이너는 Python 3.13을 사용합니다. WebUI는 Backend 자료를 생성·정규화·재봉인하거나 Backend의 publication 적격성을 재판정하지 않습니다.
corepack pnpm install
corepack pnpm dev읽기 전용 기후자료 게이트웨이가 다른 주소에서 실행 중이면 개발 서버를 시작하기 전에 CTC_QUERY_GATEWAY_TARGET을 지정합니다. 기본값은 http://127.0.0.1:8765입니다. 이 값은 Vite 개발·미리보기 프록시에만 사용되며 브라우저 배포 번들에는 포함되지 않습니다.
리버스 프록시나 임시 검증 주소를 통해 개발·미리보기 서버를 노출할 때는 CTC_WEB_ALLOWED_HOSTS에 허용할 호스트 이름을 쉼표로 구분해 지정합니다. 하위 도메인 전체를 허용해야 하면 .example.org처럼 점으로 시작하는 도메인을 사용할 수 있습니다. 이 값도 실행 환경에서만 읽으며 배포 번들에는 포함되지 않습니다.
프로덕션 빌드는 다음 명령으로 dist/에 생성됩니다.
corepack pnpm build저장소 루트를 브라우저에서 직접 열어 확인할 정적 산출물을 새 빌드와 동기화하려면 다음 명령을 사용합니다.
corepack pnpm sync:deploy루트의 index.html과 assets/는 직접 열기용으로 동기화한 검증 정적 번들입니다. 공개 웹 서버의 문서 루트에는 저장소 전체가 아닌 dist/만 배포해야 합니다. 개발 시에는 source/의 읽을 수 있는 공개 소스를 사용합니다.
공개 소스에서 루트 배포본을 동일하게 재현하는지는 다음 명령으로 검증합니다.
corepack pnpm test
corepack pnpm build
corepack pnpm verify:reproducible
corepack pnpm verify:cloud-policypnpm test는 실제자료 API 경로 제한, 날짜 확인, 지도 확대·축소, 원자료 CSV 열, 월별 체감 기준, CSV 출처 정보와 파일 저장 결과를 검증합니다. GitHub의 검증 워크플로는 Windows와 Linux에서 동일한 테스트와 재현 빌드를 실행합니다.
verify:public-data, attest:production, verify:deployment와 배포·승격 스크립트는 실서비스 Backend, GCS 또는 공개 후보 리비전을 조회하거나 변경할 수 있는 조율 대상입니다. Backend·배포 담당자의 명시적 승인과 정확한 자료판이 준비되기 전에는 실행하지 않습니다.
실제자료 자체의 배열·API 일치 여부는 WebUI 저장소의 합성값으로 대신하지 않습니다. 운영 데이터 검증에서는 정본의 Zarr·Parquet를 직접 읽는 검증기와 같은 좌표·날짜·시나리오·모델을 조회하는 API 검증기를 함께 실행해야 합니다.
브라우저의 공개 기후자료 계약은 같은 출처의 /api/climate/query, /api/climate/series, /api/climate/metadata, /api/climate/attribution으로 구성됩니다. 현재 GCS RC consumer는 Backend가 만든 ctwebui의 작은 identity 파일과 실제 관측자료 출처 표를 서버 측에서 읽고, 기존 gateway 응답과 결합한 공개 schema v1을 검증한 뒤 listener를 엽니다. Backend 내부 completion·attribution publication 세대는 Frontend의 admission gate가 아닙니다. query와 series에는 실제 ctwebui 출처 카탈로그를 사용하고 raw-model-grid 결과에는 관측 provider를 표시하지 않습니다. 지도 화면은 별도 이용 조건과 출처 표시를 따르는 OpenStreetMap 타일 제공자에 연결됩니다.
프로젝트·CMIP6·방법론 인용은 Frontend 공개 카탈로그가 소유합니다. 관측 provider 이름, 데이터셋, 라이선스, 인용문, 사용 행 수와 결과 표장 요구는 ctwebui에 실제로 저장된 관측자료 출처 표만 사용합니다. 이 공개 출처 정보를 제외한 Google Drive·GCS 주소, 로컬·네트워크 경로와 토큰·자격 증명은 브라우저 UI 또는 내보내기에 포함하지 않습니다. GitHub Pages 연결 설정에는 검증된 공개 Cloud Run API 주소만 들어갑니다.
현재 RC 게이트웨이는 단일 ctc_latte 버킷의 webui/에 운영자가 탑재한 ctwebui를 서버 측 서비스 계정으로 read-only 소비합니다. 버킷은 공개 또는 비공개일 수 있으며 브라우저에는 버킷 이름·주소·객체 경로·자격 증명을 노출하지 않습니다. 정적 화면은 GitHub Pages 또는 Vercel, 읽기 전용 질의 API는 Cloud Run에서 제공합니다. pnpm start:rc가 이 consumer 경로를 시작합니다. 별도의 정식 publication 경로에는 pnpm start:gateway:production과 배포 확인서 검증을 사용합니다. 자세한 경계는 배포 자료 원본 정책을 참고하세요.
기간 자료 내보내기의 CSV 출처 묶음, PDF, PNG, 대화형 HTML과 DOCX에는 실제 결과의 관측 provider와 인용 정보를 포함합니다. KMA 표장은 해당 provider descriptor가 요구하고 로컬 원본의 이름·SHA-256·크기·media type이 모두 일치할 때만 표시·내보냅니다. raw-model-grid 결과에는 관측 provider나 표장을 포함하지 않습니다. 프로젝트·CMIP6·방법론 인용의 라이선스는 Frontend 카탈로그에 값이 있을 때만 표시하며, 값이 없으면 추정하지 않습니다.
지표 계산과 결측 처리 기준은 자료 의미와 계산 기준을 참고하세요.
코드는 GPL-3.0-only 조건으로 배포됩니다. 기후자료와 지도 타일에는 각 제공자의 별도 이용 조건과 출처 표시가 적용됩니다.