chore(계획): PLAN 622 이관 — 국유림 임도 · 산림입지도 · 경제림 · 생태자연도 · 산사태 지도 겹(줌별 조각)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015uTVHHDv583hbLQAFeBmd9

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

@@ -0,0 +1,15 @@
+# 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) · 벡터 z8~12 서버 · 13 이상 = 12 늘려 씀 · 그림 z6~19 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 · 벡터 서버 z8~15(줌별 단순화 · 13 이상도 셈 — 화면 maxzoom 15 가능) · z8~15 밖 = 400 · 자료 줌 밖(forest_soil z8~9) = 빈 조각 · 모르는 name = 404 / 그림 z6~19 · 키 없음 = 404 detail 까닭 · 빈 · 오류 조각 = 투명 PNG + 머리 `X-Tile-Empty: empty|error` · Cache-Control 300 s
+- [x] 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) · 둘째 = 파일 31~38 ms(8001) · 색인 처음 한 번 임도 4 s 27 MB · 경제림 18 s 203 MB · 토양 91 s 1.7 GB · 전국 낮은 줌 조각 어림 임도 1,078 · 토양 2,659(z10~12) · 경제림 1,960 ≈ 5,700 개 · 약 170 MB(시험 지역 용화 106 조각 만듦) · 그림 처음 · 둘째 = 산사태 0.25~0.51 s · 11~53 ms · 생태자연도 2~3 s(가끔 8~15 s · 대기 30 s) · 64 ms · 키 없음 404 · 로그인 없음 401 · 커밋 251dfd9a5
+- [x] 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 그대로 · 밝음 · 어두움 · 범례 색 = 조각 색
+