Aislo/docs/raw/plans/2026-10-31_plan_622.md

PLAN 622 이관 — 받은 산림 · 환경 자료 = 예정노선 지도 겹(요구 529)

622 받은 산림 · 환경 자료 = 예정노선 지도 겹(줌별 조각) (요구 529 · 진행)

• 근거: PLAN 621 확보 목록 · 615 등고선 줌별 조각 꼴(common_util/common_util_contour_tiles.py · 창고 · 잠금 · 지문 · 미리 만들기) · 산사태 WMS D03_PlanAnalysis_Landslide.py(지금 = 받은 범위 한 장).
• 이음: 벡터 GET /api/projects/{id}/plan/vt/{name}/{z}/{x}/{y}.pbf(name = forest_road · forest_soil · eco_forest) · 그림 GET /api/projects/{id}/plan/wmt/{name}/{z}/{x}/{y}.png(name = ecology · landslide · 서버가 대리 받아 기억) · 창고 storage/_shared/vector_tiles/<name>/<지문>/ · storage/_shared/wms_tiles/<name>/.
• 이음(조각 칸 · sub3 화면이 읽음): 벡터 겹 이름(source-layer) = name 그대로 · forest_road kind(정수 1 간선 · 2 작업 · 3 산불 = FRRD_DV_B) name(FRRD_NM) · forest_soil code(글 두 자리 = SLTP_CD 「02」) · eco_forest own(글 「국유」 · 「사유」 = ecoFrst_01 · 02) · 벡터 z812 서버 · 13 이상 = 12 늘려 씀 · 그림 z619 256 px 투명 PNG.
• 원자료: resources/data_forest/임도망도/<시도>/ 국가임도 선 · 산림입지토양도_1-25000/ 면 · 경제림육성단지/ 면(국유 · 사유) · 생태자연도 오픈API(.env DATA_GO_KR_API_KEY) · 산사태 생활안전지도 WMS(SAFEMAP_API_KEY).
• 정함: 새 라우터 파일(D03_PlanAnalysis_Router.py 651 줄 · 늘리지 않음) · 화면 새 줄은 UI_MapGl.ts 또는 새 파일(UI_Layers.ts 688 줄 늘리지 않음) · 산림입지도 화면 = 받은 전국 파일 조각(브이월드 받기 요약은 621-3 정할 때까지 그대로) · 색 --draw-map-* · 지방 · 민간임도 = 사용자 입력(이번 범위 밖).
• 이음 확정(622-1 · 위 줄 따름 + 덧): forest_road 선 {kind 1|2|3 · name · width m · year} · forest_soil 면 {code · name 토양형 이름} · eco_forest 면 {own 국유|사유 · name 단지명} · MVT 512 px · 범위 4096 · 벡터 서버 z815(줌별 단순화 · 13 이상도 셈 — 화면 maxzoom 15 가능) · z815 밖 = 400 · 자료 줌 밖(forest_soil z89) = 빈 조각 · 모르는 name = 404 / 그림 z619 · 키 없음 = 404 detail 까닭 · 빈 · 오류 조각 = 투명 PNG + 머리 X-Tile-Empty: empty|error · Cache-Control 300 s
• 622-1 서버(sub1) — 공용 벡터 조각(SHP 원자료 · 줌별 단순화 · 남길 칸 · 미리 z8~12) · WMS 조각 대리(생태자연도 · 산사태 · 기억) · 시험
  • 검증완료 — 시험 13 · 615 시험 9 통과 · typecheck 0 · 조각 셈(z10 · z13 · z15) 용화: 임도 0.59 s 12 KB · 0.02 s 1 KB · 0.01 s / 토양 0.95 s 192 KB · 0.04 s 13 KB · 0.02 s 2 KB / 경제림 0.37 s 52 KB · 0.18 s 2 KB · 0.11 s 0.5 KB · 강원 평창 산지 같은 꼴(토양 z10 0.77 s 137 KB) · 둘째 = 파일 3138 ms(8001) · 색인 처음 한 번 임도 4 s 27 MB · 경제림 18 s 203 MB · 토양 91 s 1.7 GB · 전국 낮은 줌 조각 어림 임도 1,078 · 토양 2,659(z1012) · 경제림 1,960 ≈ 5,700 개 · 약 170 MB(시험 지역 용화 106 조각 만듦) · 그림 처음 · 둘째 = 산사태 0.250.51 s · 1153 ms · 생태자연도 23 s(가끔 815 s · 대기 30 s) · 64 ms · 키 없음 404 · 로그인 없음 401 · 커밋 251dfd9a5
• 622-2 화면(sub3) — 예정노선 겹 다섯(국유림 임도 · 산림토양도 · 경제림 · 생태자연도 · 산사태) 고정 소스 · 범례 · 켬끔 · 밝음 · 어두움 · ORCA 수치
  • 검증완료 — typecheck 0 · 시험 88 통과 · ORCA 용화 다섯 겹 켬 → 0.3 s 안 그림(z12 임도 53 · 토양 477~539 · 경제림 128 지물) · 서버 조각 화면 하나 z9 2.9 MB / z12 3.8 MB / z15 1.0 MB(생태자연도 첫 대리 최대 7.6 s · 뒤 기억) · 켬 때 가장 긴 틈 54 ms · 산사태 조각 = 옛 한 장 같은 등급 94.6 %(밀면 80 % — 자리 같음) · 옛 캔버스 한 장 1,375 px 그대로 · 밝음 · 어두움 · 범례 색 = 조각 색