개도국 기후기술 협력 데이터 플랫폼
정책연구자, 국제협력 기획자, 기업과 연구기관이 개도국의 기후·에너지·정책·사업·기관·지역 데이터를 찾고 해석할 수 있도록 만든 React/TypeScript 플랫폼입니다. 현재 공개 provider는 베트남 파일럿입니다.
현재 제공 범위
- 공개 데이터 프레임워크 152개 항목
- 데이터 찾기와 요소별 분석 상세화면
- 사용자 선정 지도 대상 43개 계약(
docs/MAP_TARGET_CONTRACT_V138.md)과 베트남 63개 성·시 경계. 연결된 레이어 수는 map-index.json의 activeMapLayerCount에서 파생
- 공개 CSV/JSON 선택 다운로드
- 공통 의미 모델에 따른 측정항목·분류·단위·기간 표시
- 접근 가능한 interactive 시계열 chart와 데이터별 유의사항
- 데이터 이용안내, 공개 상태와 다운로드 상태의 일관된 표현
릴리스 수치는 코드 상수로 복제하지 않고 public/data/vietnam/v2/manifest.json, catalog.json, map-index.json에서 파생합니다. 상세 수용 결과는 reports/v128/ 산출물을 기준으로 확인합니다.
공개 화면
- 홈
- 데이터 찾기
- 데이터 상세
- 데이터 지도
- 데이터 다운로드
- 데이터 이용안내
- 404
구형 dataset detail, 국가 비교와 insights 화면은 베트남 v2 공개 흐름의 별도 진입점으로 사용하지 않습니다. 대응 가능한 요청은 데이터 찾기·상세·다운로드로 안전하게 전환합니다.
기술 구성
- React 18, TypeScript 4.9
- Create React App /
react-scripts 5.0.1
- MapLibre GL 기반 지도와 로컬 SVG fallback
- 정적 JSON·GeoJSON·CSV 및 gzip-base64 JSON envelope
- Node.js audit와 Python semantic builder
주요 데이터 구조:
public/data/vietnam/v2/
manifest.json
catalog.json
framework-coverage.json
quality-report.json
rights-matrix.json
asset-integrity.json
map-index.json
packs/
downloads/
geometry/
spatial/
semantic/
원본 ZIP과 Excel은 _source/에만 두며 Git 또는 public/에 포함하지 않습니다. 공개 자산은 ETL이 생성한 whitelist projection만 사용합니다.
로컬 시작
Node.js와 npm이 설치된 환경에서 실행합니다.
npm ci
npm start
production build:
npm run build
build/와 node_modules/는 commit하지 않습니다.
검증
현재 릴리스 전체 gate:
npm run release:vietnam-pilot
이 명령은 V128 수용검사, root와 project subpath 배포경로, 공개파일 보안, bundle 성능 회귀와 production build를 모두 차단형 gate로 실행합니다. 화면·데이터 자체의 전체 회귀만 다시 확인할 때는 npm run finalize:v128을 사용합니다.
V128 개별 감사:
npm run audit:data-acceptance:v128
npm run audit:home:v128
npm run audit:routes:v128
npm run audit:download-reconciliation:v128
npm run audit:public-screens:v128
npm run audit:release:v128
Release audit는 V127 회귀, 152개 데이터 수용, 홈 수치, 공개 경로, 다운로드 reconciliation, production browser 화면과 build를 순차 검증합니다. 감사 조건을 삭제하거나 고정값으로 바꾸어 통과시키지 않습니다.
V138 지도·상세 브라우저 검증(전체 gate npm run finalize:v136과 별도로 실행):
npm run qa:map:v138 # 지도 42개 레이어 전수 표시·다중선택·크기조절·반응형
npm run review:screens:v138 # 152개 상세 화면 초기 상태 검토표
npm run compare:downloads:v138 # 다운로드 파일 재계산값과 화면 캡처 문구 대조
npm run report:map-targets:v138
npm run build:home-preview:v139 # 홈 미리보기 자산(8개 카드 계열 + 송전망 정적 SVG) 재생성 + asset-integrity
npm run qa:home:v139 # 홈 5개 폭 캡처·측정, 검색 예시·카드·지도 링크 동작
V151-2 행정경계·배경지도 검증(PR 차단 gate는 npm run finalize:v151 = finalize:v140 + 경계34 정적 게이트 + 집계정책 게이트):
npm run audit:boundary-policy:v151-2 # 42개 레이어 boundaryPolicy 전수·분위형 range-only·파생 자산·팩 26
npm run qa:viewport:v151-2 -- --build tmp/build-v151-2-review # 레이어/주 분석/토글/배경 전환 시 카메라 유지, view= 복원
npm run qa:labels:v151-2 -- --build tmp/build-v151-2-review # 성급시 6곳 라벨 1개, 대표점 폴리곤 내부 34/63
npm run measure:backdrop:v151-2 -- --build tmp/build-v151-2-review # 배경 4종 첫 타일 시각 3회
npm run measure:detail-prepare:v151-2 -- --build tmp/build-v151-2-review # CCKP 상세 준비시간
node scripts/v151-2/screens-v151-2.mjs --build tmp/build-v151-2-review # 42×{34,63} 스크린샷·배경×레이어·팝업·6폭
npm run build:geometry:v151-2 # 34개 경계(면적)·6권역·국가 외곽선 재생성 + asset-integrity
npm run repack:packs:v151-2 # 8 MB 초과 요소 단독 팩 재구성 + asset-integrity
배포
공개 asset은 publicAssetUrlV128 단일 resolver를 통과합니다. origin root(Vercel)와 하위 경로(PUBLIC_URL) build에서 같은 source code로 manifest, catalog, pack, semantic, download, 지도 JSON·GeoJSON을 요청합니다. PUBLIC_URL은 build 환경에서만 지정하며 resolver가 중복 prefix를 방지합니다.
.github/workflows/ci.yml은 main 대상 PR, main push와 수동 실행에서 전체 release gate를 수행하고 build 및 V128 reports artifact를 보존합니다. 배포는 Vercel 하나입니다(main → production nigtldcmap.vercel.app, PR 브랜치 → Preview). GitHub Pages workflow는 V158에서 삭제했습니다(reports/v158/DEPLOY_VERCEL_ONLY_V158.md). custom domain/DNS 승인은 배포 문서의 사전조건을 따릅니다.
배포된 URL을 별도로 점검할 때:
$env:PRODUCTION_URL = "https://<public-host>/<optional-project-path>/"
npm run smoke:production:v128
운영 문서
릴리스 원칙
- feature/release branch에서 작업하고 main에 직접 push하지 않습니다.
- 전체 감사와 browser screenshot 검토 후 PR을 생성합니다.
- PR, merge, Pages 배포와 tag는 각각 실제 완료 여부를 확인해 기록합니다.
- 원천 license·attribution과 프로젝트 publication decision을 구분합니다.
- 비밀번호, API key, credential은 데이터가 아니며 공개하지 않습니다.
