개도국 기후기술 협력 데이터 플랫폼

정책연구자, 국제협력 기획자, 기업과 연구기관이 개도국의 기후·에너지·정책·사업·기관·지역 데이터를 찾고 해석할 수 있도록 만든 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

운영 문서

• 배포
• Vercel Deployment Storage
• 운영 점검
• 데이터 갱신
• 롤백
• 공개 정보구조
• 지도 대상 43개 계약과 다중선택 지도
• 행정경계 34개 기준과 값 집계정책
• 배경지도·라벨·뷰포트
• 데이터 상태 정책
• 릴리스 수용 기준

릴리스 원칙

• feature/release branch에서 작업하고 main에 직접 push하지 않습니다.
• 전체 감사와 browser screenshot 검토 후 PR을 생성합니다.
• PR, merge, Pages 배포와 tag는 각각 실제 완료 여부를 확인해 기록합니다.
• 원천 license·attribution과 프로젝트 publication decision을 구분합니다.
• 비밀번호, API key, credential은 데이터가 아니며 공개하지 않습니다.