diff --git a/.gitignore b/.gitignore index 0095f399..5e816280 100644 --- a/.gitignore +++ b/.gitignore @@ -54,4 +54,7 @@ resources/data_global_contours/national_contours.gpkg .tmp_* *.log.err tmp/ -**/.obsidian/ \ No newline at end of file +**/.obsidian/ +# 코리도 서버 사전 생성 번들 — `npm run build:corridor` 산출물(2026-09-04). +# 소스가 바뀌면 서버가 스스로 다시 만든다(B05_Profile_Corridor_Prebuild.py). +config/corridor_node/ diff --git a/B03_FileInput/B03_FileInput_Service_Chain.py b/B03_FileInput/B03_FileInput_Service_Chain.py index cc37af0d..b826fda4 100644 --- a/B03_FileInput/B03_FileInput_Service_Chain.py +++ b/B03_FileInput/B03_FileInput_Service_Chain.py @@ -270,6 +270,16 @@ async def run_auto_design_chain( route_id, ) + # 3D 예상형상(코리도) — 브라우저가 쓰는 TS 빌더를 서버에서 한 번 돌려 영구저장한다 + # (2026-09-04 사용자 확정). 이걸 빼면 사용자가 B05에 처음 들어간 그 순간 브라우저가 + # 만들어 첫 진입이 느리다. 실패는 비치명적 — 저장본이 없으면 브라우저가 예전처럼 만든다. + try: + from B05_Profile.B05_Profile_Corridor_Prebuild import prebuild_corridor + + await prebuild_corridor(project_id, route_id, project_root) + except Exception: # noqa: BLE001 — 코리도 실패가 체인을 막지는 않는다 + logger.exception("코리도 사전 생성 실패: project_id=%s", project_id) + # 초기값 스냅샷 — 여기가 [초기화]가 되돌릴 기준선이다(CLAUDE.md 5장). # 체인 규약대로 실패는 비치명적이다: 계산 결과는 그대로 두고 실패 마커만 남겨 # [초기화]가 재계산으로 얼버무리지 않게 한다(2026-09-02 사용자 확정). diff --git a/B05_Profile/B05_Profile_Corridor_Node.ts b/B05_Profile/B05_Profile_Corridor_Node.ts new file mode 100644 index 00000000..013eeb13 --- /dev/null +++ b/B05_Profile/B05_Profile_Corridor_Node.ts @@ -0,0 +1,47 @@ +/* ============================================================================= + * B05_Profile_Corridor_Node.ts + * 코리도(3D 예상형상)를 **서버에서 한 번** 만들어 저장본 형식으로 내놓는 진입점. + * + * 왜 있나(2026-09-04 사용자 확정) — 다른 데이터와 같은 흐름으로 맞춘다: 파일 입력 뒤 + * 전처리 체인 마지막에 계산해 영구저장 → 사용자는 진입 시 로딩만 → 조작은 캐시 → + * [저장]·[확정] 때 저장. 예전에는 사용자가 B05에 처음 들어간 그 순간 브라우저가 만들어 + * 첫 진입이 느렸다. + * + * **계산을 다시 짜지 않는다.** 브라우저가 쓰는 빌더(`_UI_Corridor_Build`)와 저장 형식 + * (`_UI_Corridor_Envelope`)을 그대로 부른다 — 두 벌이 되면 화면과 서버가 다른 그림을 + * 만든다. 빌더 계통에는 Three.js·화면 API가 없어 Node에서 그대로 돈다. + * + * 실행: node <번들> <입력.json> <출력.json> + * 입력 { detail: 종횡단 상세(API와 같은 꼴), route_points: 노선 폴리라인 } + * 출력 브라우저가 GET으로 받는 저장본 그대로(버전·해시 포함) + * 끝 코드: 0 성공 / 2 인자 오류 / 3 측점 부족(만들 것 없음) + * ========================================================================== */ + +import { readFileSync, writeFileSync } from "node:fs"; +import type { SectionDetailResponse } from "../B06_Section/B06_Section_Api_Fetch"; +import type { RoutePoint } from "./B05_Profile_Api_Fetch"; +import { buildCorridor } from "./B05_Profile_UI_Corridor_Build"; +import { corridorHash, serialize } from "./B05_Profile_UI_Corridor_Envelope"; + +interface CorridorNodeInput { + detail: SectionDetailResponse; + route_points: RoutePoint[]; +} + +const [inputPath, outputPath] = process.argv.slice(2); +if (!inputPath || !outputPath) { + console.error("사용법: node <번들> <입력.json> <출력.json>"); + process.exit(2); +} + +const input = JSON.parse(readFileSync(inputPath, "utf8")) as CorridorNodeInput; +const detail = input.detail; +const routePoints = input.route_points ?? []; +// 편집 전이므로 계획선 샘플은 정본 그대로다 — 브라우저의 폴백 경로와 같은 값이다. +const samples = detail.longitudinal?.design_profiles?.[0]?.samples; +const build = buildCorridor(detail.cross_sections, routePoints, samples); +if (!build) { + console.error("코리도 없음 — 분류 가능한 측점이 2개 미만."); + process.exit(3); +} +writeFileSync(outputPath, JSON.stringify(serialize(build, corridorHash(detail, routePoints)))); diff --git a/B05_Profile/B05_Profile_Corridor_Prebuild.py b/B05_Profile/B05_Profile_Corridor_Prebuild.py new file mode 100644 index 00000000..a69be261 --- /dev/null +++ b/B05_Profile/B05_Profile_Corridor_Prebuild.py @@ -0,0 +1,151 @@ +"""코리도(3D 예상형상) 사전 생성 — 전처리 체인 마지막에 서버가 한 번 만들어 영구저장한다. + +왜(2026-09-04 사용자 확정) — 다른 데이터와 같은 흐름으로 맞춘다: 파일 입력 뒤 계산해 +영구저장 → 사용자는 진입 시 로딩만 → 조작은 캐시 → [저장]·[확정] 때 저장. 예전에는 +사용자가 B05에 처음 들어간 그 순간 브라우저가 만들어(실측 17MB 규모) 첫 진입이 느렸다. + +**계산을 다시 짜지 않는다.** 브라우저가 쓰는 TS 빌더를 Node로 그대로 돌린다 +(`B05_Profile_Corridor_Node.ts` → 번들). 파이썬으로 포팅하면 같은 기하가 두 벌이 되어 +화면과 3D가 갈라진다. + +실패는 비치명적이다 — 저장본이 없으면 브라우저가 예전처럼 직접 만든다(폴백 유지). +""" + +from __future__ import annotations + +import asyncio +import json +import logging +import os +import subprocess +import tempfile +from pathlib import Path +from typing import Any +from uuid import UUID + +from B05_Profile.B05_Profile_Repository import get_route_points +from B05_Profile.B05_Profile_Router_Corridor import corridor_path +from config.config_db import get_db_pool + +logger = logging.getLogger(__name__) + +ROOT = Path(__file__).resolve().parents[1] +BUNDLE = ROOT / "config" / "corridor_node" / "B05_Profile_Corridor_Node.js" +# 번들이 낡았는지 재는 대상 — 빌더 계통이 걸쳐 있는 폴더. +_SOURCE_DIRS = ("B05_Profile", "B06_Section", "common_util") +# 번들 만들기·실행 상한(초). 실측 번들 0.1초, 빌드 65측점 3초 수준이라 넉넉하다. +_BUILD_TIMEOUT_S = 300 +_RUN_TIMEOUT_S = 600 + + +def _node_env() -> dict[str, str]: + """config/node_modules를 쓰는 프론트엔드 프로세스 환경(main.py와 같은 규약).""" + env = os.environ.copy() + node_modules = ROOT / "config" / "node_modules" + env["PATH"] = f"{node_modules / '.bin'}{os.pathsep}{env.get('PATH', '')}" + env["NODE_PATH"] = str(node_modules) + return env + + +def _bundle_stale() -> bool: + """번들이 없거나 TS 원본보다 오래됐으면 참. + + 번들이 낡으면 서버와 화면이 **다른 기하**를 만든다 — 이 판정이 그것을 막는 유일한 + 장치다. 개발 중에는 `npm run build`를 따로 돌리지 않으므로 여기서 스스로 갱신한다. + """ + if not BUNDLE.is_file(): + return True + built_at = BUNDLE.stat().st_mtime + for directory in _SOURCE_DIRS: + for path in (ROOT / directory).rglob("*.ts"): + if path.stat().st_mtime > built_at: + return True + return False + + +def _build_bundle() -> bool: + result = subprocess.run( # noqa: S602 — 고정 명령, 사용자 입력 없음 + "npm run build:corridor", + shell=True, + cwd=str(ROOT), + env=_node_env(), + capture_output=True, + text=True, + encoding="utf-8", + errors="replace", + timeout=_BUILD_TIMEOUT_S, + ) + if result.returncode != 0: + logger.error("코리도 번들 빌드 실패:\n%s", result.stderr) + return False + return True + + +def _run_node(input_path: Path, output_path: Path) -> int: + result = subprocess.run( # noqa: S603 — 고정 실행 파일, 인자는 임시 파일 경로뿐 + ["node", str(BUNDLE), str(input_path), str(output_path)], + cwd=str(ROOT), + env=_node_env(), + capture_output=True, + text=True, + encoding="utf-8", + errors="replace", + timeout=_RUN_TIMEOUT_S, + ) + if result.returncode != 0: + logger.warning("코리도 사전 생성 실패(끝 코드 %s): %s", result.returncode, result.stderr) + return result.returncode + + +async def _section_detail(project_id: UUID | str, route_id: int) -> dict[str, Any] | None: + """브라우저가 받는 것과 **같은** 종횡단 상세를 만든다 — 같은 라우터 함수를 부른다.""" + from B06_Section.B06_Section_Router import get_section_detail + + response = await get_section_detail(UUID(str(project_id)), route_id) + payload = getattr(response, "model_dump", None) + if payload is None: # JSONResponse = 실패 + logger.warning("코리도 사전 생성: 종횡단 상세를 못 받음 (route_id=%s)", route_id) + return None + return payload(mode="json") + + +async def prebuild_corridor(project_id: UUID | str, route_id: int, project_root: Path) -> bool: + """코리도를 만들어 영구저장소에 남긴다. 성공하면 참.""" + detail = await _section_detail(project_id, route_id) + if detail is None: + return False + pool = get_db_pool() + async with pool.acquire() as connection: + points = await get_route_points(connection, route_id) + if len(points) < 2: + logger.info("코리도 사전 생성 건너뜀 — 노선 점이 부족함 (route_id=%s)", route_id) + return False + + if _bundle_stale() and not await asyncio.to_thread(_build_bundle): + return False + + target = corridor_path(Path(project_root), route_id) + with tempfile.TemporaryDirectory(prefix="corridor_") as workdir: + source = Path(workdir) / "input.json" + built = Path(workdir) / "corridor.json" + await asyncio.to_thread( + source.write_text, + json.dumps({"detail": detail, "route_points": points}, default=float), + "utf-8", + ) + if await asyncio.to_thread(_run_node, source, built) != 0: + return False + await asyncio.to_thread(target.parent.mkdir, parents=True, exist_ok=True) + await asyncio.to_thread(_replace, built, target) + logger.info( + "코리도 사전 생성 완료: route_id=%s 크기=%.1fMB", + route_id, + target.stat().st_size / (1024 * 1024), + ) + return True + + +def _replace(source: Path, target: Path) -> None: + """임시 폴더가 다른 드라이브일 수 있어 os.replace 대신 복사 후 지운다.""" + target.write_bytes(source.read_bytes()) + source.unlink(missing_ok=True) diff --git a/B05_Profile/B05_Profile_Router_Corridor.py b/B05_Profile/B05_Profile_Router_Corridor.py index cb4214b7..4da39233 100644 --- a/B05_Profile/B05_Profile_Router_Corridor.py +++ b/B05_Profile/B05_Profile_Router_Corridor.py @@ -28,7 +28,8 @@ router = APIRouter(prefix="/api/projects", tags=["B05 Corridor"]) MAX_CORRIDOR_BYTES = 64 * 1024 * 1024 -def _corridor_path(project_root: Path, route_id: int) -> Path: +def corridor_path(project_root: Path, route_id: int) -> Path: + """코리도 저장본 자리 — 사전 생성(체인)·초기값 복원도 같은 자리를 쓴다.""" return project_root / "B05_Profile" / "corridor" / f"corridor_{route_id:04d}.json" @@ -72,7 +73,7 @@ async def get_corridor(project_id: UUID, route_id: int) -> Response: return JSONResponse( status_code=404, content={"status": "error", "message": "프로젝트가 없습니다."} ) - path = _corridor_path(project_root, route_id) + path = corridor_path(project_root, route_id) if not path.is_file(): return JSONResponse( status_code=404, @@ -109,7 +110,7 @@ async def put_corridor(project_id: UUID, route_id: int, payload: dict = Body(... return JSONResponse( status_code=404, content={"status": "error", "message": "프로젝트가 없습니다."} ) - path = _corridor_path(project_root, route_id) + path = corridor_path(project_root, route_id) await asyncio.to_thread(path.parent.mkdir, parents=True, exist_ok=True) await asyncio.to_thread(atomic_write_json, path, payload) return JSONResponse(content={"status": "ok"}) diff --git a/B05_Profile/B05_Profile_Router_Lifecycle.py b/B05_Profile/B05_Profile_Router_Lifecycle.py index 474b3426..8450ff4e 100644 --- a/B05_Profile/B05_Profile_Router_Lifecycle.py +++ b/B05_Profile/B05_Profile_Router_Lifecycle.py @@ -198,6 +198,8 @@ async def reset_route_design(project_id: UUID) -> JSONResponse: }, ) + # 복원이 만든 새 route id — 코리도 초기값을 그 번호로 되돌리는 데 쓴다. + restored_route_id: int | None = None async with pool.acquire() as connection: # 확정 지표면 모델을 초기 체인과 **같은 기준**으로 다시 찾는다 — 체인은 stage 1 # 확정 선택값을 쓴다(2026-08-30). config 기본값을 쓰면 그 선택과 어긋난 모델을 @@ -219,7 +221,9 @@ async def reset_route_design(project_id: UUID) -> JSONResponse: deleted = cursor.rowcount # 복원은 같은 트랜잭션 안에서 끝낸다 — 지우기만 하고 실패하면 경로가 없다. if restored and project_root: - await restore_initial_snapshot(connection, project_root, str(project_id)) + restored_route_id = await restore_initial_snapshot( + connection, project_root, str(project_id) + ) await connection.commit() except Exception: await connection.rollback() @@ -227,8 +231,8 @@ async def reset_route_design(project_id: UUID) -> JSONResponse: if restored and project_root: # 정본 파일도 스냅샷본으로 되돌린다 — 이것을 빼면 구조물·관 편집분이 남아 - # 초기값이 오염된다(2026-08-29). - await asyncio.to_thread(restore_snapshot_files, project_root) + # 초기값이 오염된다(2026-08-29). 코리도는 새 route id 이름으로 되돌아간다. + await asyncio.to_thread(restore_snapshot_files, project_root, restored_route_id) else: # 스냅샷이 없어 재계산으로 초기값을 만드는 경로 — 편집 정본을 먼저 걷어내야 # 진짜 초기값이 나온다. 남기면 구조물 측점이 사용자 편집분에서 다시 파생된다 diff --git a/B05_Profile/B05_Profile_UI_Corridor.ts b/B05_Profile/B05_Profile_UI_Corridor.ts index 52fe3221..8e96f937 100644 --- a/B05_Profile/B05_Profile_UI_Corridor.ts +++ b/B05_Profile/B05_Profile_UI_Corridor.ts @@ -16,12 +16,14 @@ import { API_BASE_URL, API_TIMEOUT_MS } from "@config/config_frontend"; import type { SectionDetailResponse } from "../B06_Section/B06_Section_Api_Fetch"; import type { RoutePoint } from "./B05_Profile_Api_Fetch"; +import { buildCorridor, type CorridorBuildResult } from "./B05_Profile_UI_Corridor_Build"; import { - buildCorridor, - type CorridorBuildResult, - type CorridorRibbon, -} from "./B05_Profile_UI_Corridor_Build"; -import { structureHashParts } from "./B05_Profile_UI_Corridor_Structures"; + corridorHash, + ENVELOPE_VERSION, + deserialize, + serialize, + type CorridorEnvelope, +} from "./B05_Profile_UI_Corridor_Envelope"; /** 구조물별 서피스 대체/삽입 훅 — 별도 지침 후 구현 예정(2026-08-23 범위 제외). */ export interface CorridorStructureHook { @@ -29,58 +31,6 @@ export interface CorridorStructureHook { applies: (chainageStart: number, chainageEnd: number) => boolean; } -/** - * 저장본 **형식(스키마)** 버전 — 담는 필드가 바뀔 때만 올린다. - * - * 기하 계산이 바뀐 것은 여기가 아니라 아래 `BUILD_VERSION`으로 만료시킨다. - * - * 3 = 리본에 셀 마스크·축 고정 커브 조각 삼각형 추가 — 2026-08-26. - * 4 = 절취 측벽 서피스(`cutWalls`) 추가 — 2026-08-27. - * 5 = 측벽에서 빗금(UV)을 뺀다 — 벽은 방향성을 표현하지 않는다(2026-08-27 사용자). - * 6 = 리본의 `patch`·`patchClip` 표식을 담는다 — 안 담아서 저장본으로 다시 연 코리도가 - * 패치인 줄 모르고 지형 스냅에 끌려갔다(2026-09-02). - */ -const ENVELOPE_VERSION = 6; - -interface CorridorEnvelope { - version: number; - hash: string; - ribbons: Array<{ - kind: CorridorRibbon["kind"]; - side: CorridorRibbon["side"]; - colCount: number; - chainages: number[]; - positionsBase64: string; - /** - * 구조물 패치 리본 표식(2026-09-02) — 빌드 때만 쓰는 값이 아니라 **뷰어가 그릴 때도 - * 본다**(`B05_Profile_UI_Viewer.ts` 지형 스냅 제외). 안 담으면 저장본으로 다시 연 - * 코리도가 패치인 줄 몰라 바깥 끝이 원지반까지 끌려 내려간다. - */ - patch?: boolean; - patchClip?: boolean; - /** 셀 마스크(2026-08-26 투영 커브 안쪽 지우기) — 없으면 구멍 없는 리본. */ - cellMaskBase64?: string; - /** 축 고정 커브가 걸친 셀의 조각 삼각형·UV(2026-08-26). */ - trimTrisBase64?: string; - trimUvsBase64?: string; - }>; - outline: CorridorBuildResult["outline"]; - /** 시·종점 마구리(구 저장본엔 없음 — 없으면 빈 배열로 복원). */ - caps?: CorridorBuildResult["caps"]; - /** 배수관 세트 구조물(2026-08-23 — 구 저장본엔 없음, 없으면 빈 배열). */ - structures?: CorridorBuildResult["structures"]; - /** - * 구조물 세트별 탑뷰 투영 커브(2026-08-26) — 저장본에도 담는다. 안 담으면 - * 저장본으로 복원한 코리도에서는 커브가 통째로 사라진다. - */ - planCurves?: CorridorBuildResult["planCurves"]; - /** 절취 측벽 서피스(2026-08-27) — 구 저장본엔 없다. 없으면 빈 배열로 복원. */ - cutWalls?: Array<{ - side: "left" | "right"; - positionsBase64: string; - }>; -} - interface CacheEntry { hash: string; build: CorridorBuildResult; @@ -93,267 +43,6 @@ function keyOf(projectId: string, routeId: number): string { return `${projectId}:${routeId}`; } -/** FNV-1a 32bit — 설계 입력 요약 문자열의 버전 해시. */ -function fnv1a(text: string): string { - let hash = 0x811c9dc5; - for (let i = 0; i < text.length; i += 1) { - hash ^= text.charCodeAt(i); - hash = Math.imul(hash, 0x01000193); - } - return (hash >>> 0).toString(16).padStart(8, "0"); -} - -/** - * 빌드 로직 판번호 — **기하를 바꾸는 수정을 하면 반드시 올린다.** - * - * 해시는 종횡단 입력만 요약하므로, 빌드 코드를 고쳐도 입력이 그대로면 해시가 같아 - * 옛 저장본을 그대로 다시 쓴다 — 코드를 고쳤는데 화면이 안 바뀌는 일이 생긴다 - * (2026-08-23 사용자 보고: "원복이 안 된 것 같다가 갑자기 반영됨"). 판번호를 해시에 - * 섞어 두면 배포와 동시에 저장본이 만료된다. - */ -// 42 = 탑뷰 투영선(빨간 선)·구조물 구간 경계 행·파란 스케치 안쪽 기준 정정· -// 투영 커브 안쪽 성토면 절단 — 커브 다각형 기준(2026-08-26). -// ※ 40에 머물러 있는 동안 기하 수정 3회가 통째로 묻혔다 — 저장본이 그대로 -// 복원되어 화면·데이터가 하나도 안 바뀌었다. 기하를 고치면 **반드시** 올릴 것. -// 56 = 측벽에서 **노견 쪽·성토 끝단 쪽 리본 경계 벽을 뺀다** — 거기서 잘린 게 -// 아니라 리본이 끝난 자리다(2026-08-27 사용자). -// 64 = 변형 성토면(패치) 마감 3종 — ① 행별 지반 절단(빨간 교차선에서 끝냄) + -// 바깥 끝 수직 스커트, ② 날개 사다리꼴 몫만큼 패치 행 범위 확장(BOX는 축 고정), -// ③ 구조물 안착 자리 원지반 재노출(원본 성토 스케치 − 구조물 ∪ 변형 성토) -// (2026-08-27 사용자). -// 65 = 날개벽 평면 스케치까지 변형 성토면에 포함 — 늘린 행에 벽 트림을 걸지 않는다 -// (2026-08-27 사용자). -// 66 = 패치 행을 그 행 지반선과 직접 교차시켜 **자르고 연장**한다 — 날개 사다리꼴 -// 바깥변(원본 성토 끝선)까지 성토면이 이어진다(2026-08-27 사용자). -// 67 = (주석만 앞서 나갔던 번호 — 실제로 들어간 것은 66까지다. 2026-08-27 확인) -// 68 = 패치 스윕 범위를 **주황 날개 평면 스케치(`wing-box`)까지** 넓힌다 — 행별 지반 -// 핀(절단·연장)과 스커트는 그대로 두고, 스케치가 더 바깥일 때만 그 행을 설계 -// 성토 물매로 스케치 경계까지 덧이어 낸다(2026-08-27 사용자: 그 자리에 변형 -// 성토면이 있어야 한다 — 삭제가 아니다). -// 69 = 날개 스케치 확장에서 **BOX암거는 제외**한다 — 날개벽은 세월교·BOX 두 곳에서 -// 쓰이지만 로직이 분리돼 있고, BOX는 이미 채워져 있어(구멍 5~12%) 손대면 행 폭이 -// 0.74 → 4.53m로 뛴다(2026-08-27 사용자: "박스 암거는 로직 원복"). -// 70 = 세월교 날개 사다리꼴 A안 — ① 종방향 범위를 **노선 실투영**으로 잰다 -// (`wingSpanOnRoute`, 직선 투영은 곡선+먼 편거리에서 3m 어긋났다), -// ② 행 편거리를 스케치의 **안쪽·바깥쪽 끝**까지 늘린다(`wingRangeAt`, -// 좌측 고리는 패치보다 1.5m 안쪽에 있었다). BOX암거는 둘 다 제외 — 종전 그대로. -// 71 = 안쪽 확장을 **세월교 바닥판 상단 Z(`slabTopElevation`)로 트림**한다 — 성토 -// 물매 역연장이 유로 위로 솟아 바닥 상단과 안 만나는 자리로 튀었다(2026-08-27 사용자). -// 72 = 날개 스윕 범위를 **날개벽 끝점 횡단선**까지로 바꾼다 — 고리 전체가 아니라 -// 날개벽 선 두 끝을 노선에 실투영해 재고, 구조물 점유 구간 ±5m 여유 안에서 -// 트림한다. 고리와 안 만나는 중간 행도 더는 끊지 않는다(2026-08-27 사용자: -// "5m 늘려 서피스 만들고 날개벽 끝점 횡단선으로 트림"). -// 73 = ① 패치 점 중 **세월교 바닥판 상단 Z를 넘는 것은 지운다**(`clipRunBelow`, -// 종단 shift 반영·천장 교차점 삽입), ② 날개 스팬을 다시 **고리 전체 점**으로 -// 잰다 — 벽 끝점만 쓰면 좌측이 143.2~157.3 → 144.4~155.9로 줄었다 -// (2026-08-27 사용자: "좌측 스윕 더 가야 함"). -// 74 = (날개 몫 행 트림 시도 — 사용자 지시로 **원복**. 안쪽까지 자르면 구조물 구간과 -// 날개 사이가 벌어졌고, 바깥선만 자르는 판은 버전을 안 올려 화면에 못 올라갔다.) -// 75 = 73 상태로 원복 — 트림 없음. 날개 몫 행은 지반 핀 + 스케치 확장 + 바닥 상단 -// Z 초과 삭제까지만 한다(2026-08-27 사용자: "2번 전으로"). -// (76~78의 트림 도구 `wingOuterLines`·`wingTrimAt`·`clipRunToRange` 는 2026-09-02에 -// 제거했다 — 원복 뒤 다시 배선되지 않아 참조가 0이었다. 아래는 이력으로만 남긴다.) -// 76 = 날개 몫 행을 **주황 고리의 바깥선**에서 끝낸다(`wingOuterLines`+`wingTrimAt`). -// 고리가 그 행까지 모자라면 **끝 마디를 복사해 20m 연장**해서 만나게 한다 -// (2026-08-27 사용자). 안쪽은 안 자른다. -// 77 = 주황 바깥선 트림을 **모든 행**에 건다 — 구조물 점유 구간 안 행을 빼놨더니 -// 그 구간이 커브 밖으로 삐져나왔다. 자르는 게 아니라 커브를 새 바깥 끝으로 -// 삼아 줄을 다시 잡고 `resample`이 열을 그 위에 다시 깔아 **메시가 재배치**된다 -// (2026-08-27 사용자: "메시의 재배치가 필요하잖아, 그래야 잘리지"). -// 78 = 날개 몫 로직을 **구조물 종류로 가른다**(2026-08-27 사용자: "세월교, 박스암거, -// 기슭막이") — `section.ford`일 때만 실투영 스팬·스케치 확장·바깥선 트림을 태우고 -// BOX암거·기슭막이는 종전 경로 그대로. 트림선은 **날개 하나 단위**로 나눠 행마다 -// 누가거리가 가장 가까운 날개 것만 쓴다(20m 연장선이 서로 먹던 것을 막는다). -// 79 = 세월교 패치를 **절취 영역 셀 마스크의 반대 규칙**으로 클립한다 — 영역 밖 셀은 -// 지우고 걸친 셀은 안쪽 조각만 남긴다(`patchClip`). 행 단위 바깥선 트림은 폐기 — -// 비스듬한 사다리꼴 경계를 행 끝 하나로는 못 맞춰 74셀이 삐져나왔다(실측). -// 지우는 면과 채우는 면이 같은 경계를 공유한다(2026-08-27 사용자). -// 80 = 배수관 세트(기슭막이) **노견 → 벽 이음선 상단 성토 사면**을 되메움 리본 배열 -// (`fillRuns`)에도 담는다 — 78/79의 포켓은 노견까지 파는데 79까지의 배열에는 -// 벽 아래 다단·집수정 성토선만 있어 **기슭막이 상단부가 통째로 비었다** -// (2026-08-27 사용자). 새 면이 아니라 실루엣이 이미 쓰던 `designTrim` 사면선 -// 그대로다. 벽 루프·집수정 분기가 같은 선을 담으므로 측당 한 번만 등록한다. -// 81 = `slope-deformed` 커브를 **패치 리본과 같은 규칙**으로 끝낸다 — 실루엣 바깥 -// 끝이 그 측점 지반에 안 닿으면(BOX암거: 구체 최상단) 외삽하지 않고 실루엣이 -// 끝나는 자리를 바깥 끝으로 쓴다. 종전에는 이 커브만 무조건 최대 30m 외삽해 -// 성토 끝선까지 갔고, BOX는 기본값에서 변형 성토선이 원본 성토선과 정확히 -// collinear가 되어 `원본 − (구조물 ∪ 변형)` = ∅ — **구체 밖 원지반 재노출이 -// 통째로 미실행**이었다(2026-08-27 사용자 확정: "구체 밖은 원지반이어야 한다"). -// 실루엣이 구조물에서 끝나는지는 기하로 재지 않고 `endsAtStructure` 표식으로 -// 가른다 — 낙차로 재면 기슭막이 유출측처럼 지반보다 바깥으로 나간 실루엣까지 -// 걸려 원래 짧게 잘리던 것이 안 잘린다(실측 84.3 우측 5.10 → 5.69m). -// 아울러 BOX 날개 사다리꼴(`wing-box`)을 원지반 재노출 후보에 넣는다 — 절취 -// 소스에는 있고 되살릴 목록에는 없어 그 자리가 성토면도 지반도 없는 구멍이었다 -// (2026-08-27 사용자: "날개부의 평면 스케치 영역까지 원지반이 같이 노출"). -// 세월교는 제외 — 그 자리는 되메움 패치가 덮는다(`wingRangeAt`, isFord 전용). -// 82 = BOX암거 `structure` 탑뷰 커브를 부재별 7고리가 아니라 **아령 외곽선 한 줄**로 -// 낸다(2026-08-27 사용자: "바닥을 위에서 보면 아령형상이고 제일 외곽에 있는 선 -// 성분을 평면 투영하면 경계"). 상판+에이프런에 `planOutline` 표식을 달고 -// `_Plan_Footprint.ts`가 링 자리마다 편거리 창을 합친다 — 기하 불리언 없음 -// (BOX 부재는 전부 같은 고정축 위 평행 링이다). 종전 부재별 고리에는 날개벽이 -// **패널 두께 슬리버**로 섞여 있었고(실측 0.40㎡ / bbox 1.69×1.40 ×2), 그 슬리버가 -// "덮인 자리"로 빠져 그 자리만 성토면도 지형도 없는 검은 줄이 됐다. 에이프런은 -// 날개벽 발치를 얹으려고 넓혀 둔 부재라 외곽선이 날개를 이미 품는다. -// 83 = 원지반 재노출 영역을 **`cut-merged`**(성토면에서 실제로 도려낸 셀의 윤곽)로 -// 바꾼다. 종전에는 `원본 성토 스케치 − (구조물 ∪ 변형 성토 스케치)`로 영역을 -// **다시 조립**해, 지우는 쪽과 되살리는 쪽이 다른 커브를 쓰며 경계가 어긋났다 -// (날개벽 패널 두께 슬리버 자리에 검은 줄). 이제 지우는 쪽이 남긴 자국을 그대로 -// 쓰므로 **원본 지형 메시가 그 자리에 그대로 남는다** — 새 서피스를 만들지 않는다 -// (2026-08-27 사용자: "원지반 오리지널 데이터에서 가져오라니까"). -// 84 = 잘린 자리 윤곽(`cut-merged`) 추적을 고친다 — 갈림목에서 아무 변이나 집어 -// walk가 남의 고리로 새 나가고, 막다른 길에서 끊긴 **열린 사슬이 고리로 담겼다**. -// 표시용일 땐 안 보였지만 이제 이 커브가 되살릴 영역의 근거라 그대로 구멍이 된다 -// (실측: 도려낸 셀의 18% — 성토 끝단 쪽 col 40~46 — 이 영역에서 빠졌다. -// 2026-08-27 사용자: "유출구에 일부 성토부에 터짐 있음"). 오른손 규칙으로 갈림목을 -// 가르고 **닫힌 고리만** 담는다. -// 85 = 물넘이포장 자리 노면을 판다 — 횡단도와 같은 산식(fordDeckElevationAt)으로 노면·노견 -// 조각 표고를 내린다. 노면 밖 비탈은 그대로라 노견 끝에 수직 단차가 선다(2026-08-28 사용자). -// 86 = 독립 기슭막이(구조물 정본 D군)를 3D에 세운다 — 횡단 카드와 같은 폴리곤 -// (computeRevetmentLayout)을 기준측점 전/후 길이만큼 스윕한다(2026-08-28 사용자). -// 87 = 독립 기슭막이 **다단** — 단마다 솔리드를 세운다. 단 사이 성토는 1:1.2, -// 다음 단 시작점은 윗단 하단 수평선 +근입과 전면 경사선의 교차점(2026-08-22 규칙 승계). -// 88 = 독립 기슭막이 기준을 **맨 위 단**으로 되돌리고 추가 단은 아래로 붙인다(배관 세트와 -// 같은 규칙). 기준 자리는 사용자 이동값(기준 올림·좌우)을 탄다(2026-08-28 사용자). -// 89 = BOX암거 패치도 **절취 영역 안쪽으로 자른다**(2026-09-02). 그 규칙이 세월교에만 -// 걸려 있어 BOX 패치는 한 번도 안 잘리고 영역 밖으로 넘쳤다 — 실측에서 BOX 패치 -// 리본 두 벌(198.4~203.5m)에 셀 마스크가 없었다. BOX도 `wing-box` 커브로 절취 -// 영역을 내므로 같은 반대 규칙이 성립한다. -// 90 = 잘린 자리 윤곽(`cut-merged`)의 **시작 모서리 유실**을 고친다 — `dropCollinear`가 -// 고리의 닫힘 중복점(머리=꼬리)을 순환 이웃으로 셈해 머리 모서리를 지우고, 그 양옆 -// 일직선 점까지 빠져 첫 행이 대각선으로 잘렸다(실측: 8고리 전부, 63셀 구멍 — -// 우 197.6~198.2m BOX 앞 쐐기 33셀이 가장 큼). 되살릴 영역이 이 커브라 저장본을 만료한다. -// 91 = 구조물 솔리드에 **부재키**(`key`)를 싣는다 — 3D 개별 선택이 그 표로 부재를 -// 가려낸다(2026-09-04). 옛 저장본엔 키가 없어 3D에서 골라도 B06 조정창으로 넘길 -// 부재를 못 정하므로 만료한다. -// 92 = 세월교·BOX암거 부재까지 **부재키를 일원화**한다 — 횡단도가 부르는 이름 그대로 -// (세월교 유입·유출, BOX 좌·우, 본체는 `body`). 91 저장본엔 배수관 세트 키만 있다. -const BUILD_VERSION = 92; - -/** 종횡단 정본에서 코리도에 영향을 주는 입력만 요약해 해시 — 갱신 감지 기준. */ -export function corridorHash(detail: SectionDetailResponse, routePoints: RoutePoint[]): string { - const parts: Array = [`v${BUILD_VERSION}`, routePoints.length]; - routePoints.forEach((p) => parts.push(p.x.toFixed(2), p.y.toFixed(2))); - detail.cross_sections.forEach((section) => { - const design = section.design; - parts.push( - section.chainage_m.toFixed(3), - section.center_x.toFixed(2), - section.center_y.toFixed(2), - ); - if (!design) { - parts.push("nodesign"); - return; - } - parts.push( - design.design_elevation_m.toFixed(3), - design.section_mode, - design.ditch_side ?? "", - design.ditch_type ?? "", - String(design.ditch_enabled ?? ""), - design.design_line.length, - ); - design.design_line.forEach((point) => - parts.push(point.offset_m.toFixed(3), point.elevation_m.toFixed(3)), - ); - // 구조물(배수관 세트) 입력 — 길이·전후·형식이 바뀌면 재빌드되어야 한다. - structureHashParts(section).forEach((part) => parts.push(part)); - }); - return fnv1a(parts.join("|")); -} - -function base64FromFloats(values: Float64Array): string { - const bytes = new Uint8Array(values.buffer, values.byteOffset, values.byteLength); - let binary = ""; - const CHUNK = 0x8000; - for (let i = 0; i < bytes.length; i += CHUNK) { - binary += String.fromCharCode(...bytes.subarray(i, i + CHUNK)); - } - return btoa(binary); -} - -function base64FromBytes(bytes: Uint8Array): string { - let binary = ""; - const CHUNK = 0x8000; - for (let i = 0; i < bytes.length; i += CHUNK) { - binary += String.fromCharCode(...bytes.subarray(i, i + CHUNK)); - } - return btoa(binary); -} - -function bytesFromBase64(encoded: string): Uint8Array { - const binary = atob(encoded); - const bytes = new Uint8Array(binary.length); - for (let i = 0; i < binary.length; i += 1) bytes[i] = binary.charCodeAt(i); - return bytes; -} - -function floatsFromBase64(encoded: string): Float64Array { - const binary = atob(encoded); - const bytes = new Uint8Array(binary.length); - for (let i = 0; i < binary.length; i += 1) bytes[i] = binary.charCodeAt(i); - return new Float64Array(bytes.buffer); -} - -function serialize(build: CorridorBuildResult, hash: string): CorridorEnvelope { - return { - version: ENVELOPE_VERSION, - hash, - ribbons: build.ribbons.map((ribbon) => ({ - kind: ribbon.kind, - side: ribbon.side, - colCount: ribbon.colCount, - chainages: ribbon.chainages, - positionsBase64: base64FromFloats(ribbon.positions), - ...(ribbon.patch ? { patch: true } : {}), - ...(ribbon.patchClip ? { patchClip: true } : {}), - ...(ribbon.cellMask ? { cellMaskBase64: base64FromBytes(ribbon.cellMask) } : {}), - ...(ribbon.trimTris && ribbon.trimUvs - ? { - trimTrisBase64: base64FromFloats(ribbon.trimTris), - trimUvsBase64: base64FromBytes(new Uint8Array(ribbon.trimUvs.buffer.slice(0))), - } - : {}), - })), - outline: build.outline, - caps: build.caps, - structures: build.structures, - planCurves: build.planCurves, - cutWalls: (build.cutWalls ?? []).map((wall) => ({ - side: wall.side, - positionsBase64: base64FromFloats(wall.positions), - })), - }; -} - -function deserialize(envelope: CorridorEnvelope): CorridorBuildResult { - return { - ribbons: envelope.ribbons.map((ribbon) => ({ - kind: ribbon.kind, - side: ribbon.side, - colCount: ribbon.colCount, - chainages: ribbon.chainages, - positions: floatsFromBase64(ribbon.positionsBase64), - ...(ribbon.patch ? { patch: true } : {}), - ...(ribbon.patchClip ? { patchClip: true } : {}), - ...(ribbon.cellMaskBase64 ? { cellMask: bytesFromBase64(ribbon.cellMaskBase64) } : {}), - ...(ribbon.trimTrisBase64 && ribbon.trimUvsBase64 - ? { - trimTris: floatsFromBase64(ribbon.trimTrisBase64), - trimUvs: new Float32Array(bytesFromBase64(ribbon.trimUvsBase64).buffer), - } - : {}), - })), - outline: envelope.outline, - caps: envelope.caps ?? [], - structures: envelope.structures ?? [], - planCurves: envelope.planCurves ?? [], - cutWalls: (envelope.cutWalls ?? []).map((wall) => ({ - side: wall.side, - positions: floatsFromBase64(wall.positionsBase64), - })), - }; -} - async function requestCorridor(path: string, init: RequestInit): Promise { const controller = new AbortController(); const timeoutId = window.setTimeout(() => controller.abort(), API_TIMEOUT_MS); @@ -412,6 +101,19 @@ export type ProfileSamples = Array<{ ground_elevation_m?: number; }>; +/** 마지막 코리도가 **어디서 왔는지** — 저장본을 그대로 썼나, 브라우저가 다시 만들었나. + * 서버 사전 생성(2026-09-04)이 실제로 먹었는지 화면 밖에서 수치로 확인하는 창구다 + * (`__corridorScene`·`__corridorSkirt`와 같은 디버그 훅). */ +declare global { + interface Window { + __corridorSource?: { source: "stored" | "built"; hash: string; at: number }; + } +} + +function markSource(source: "stored" | "built", hash: string): void { + window.__corridorSource = { source, hash, at: Date.now() }; +} + export async function ensureCorridor( projectId: string, routeId: number, @@ -429,6 +131,7 @@ export async function ensureCorridor( try { const build = deserialize(stored); cache.set(key, { hash, build, dirty: false }); + markSource("stored", hash); return build; } catch { // 손상 저장본 — 빌드로 폴백. @@ -447,6 +150,7 @@ export async function ensureCorridor( cache.delete(key); return null; } + markSource("built", hash); if (stored === null) { // 최초 생성 — 계획 확정 흐름대로 즉시 영구저장(실패해도 표시는 진행). cache.set(key, { hash, build, dirty: false }); diff --git a/B05_Profile/B05_Profile_UI_Corridor_Envelope.ts b/B05_Profile/B05_Profile_UI_Corridor_Envelope.ts new file mode 100644 index 00000000..feb3aef9 --- /dev/null +++ b/B05_Profile/B05_Profile_UI_Corridor_Envelope.ts @@ -0,0 +1,329 @@ +/* ============================================================================= + * B05_Profile_UI_Corridor_Envelope.ts + * 코리도 저장본 형식 — 버전·해시·직렬화 한 벌. **브라우저와 서버가 같은 것을 쓴다.** + * + * 서버(전처리 체인 끝)가 같은 빌더로 코리도를 미리 만들어 저장하므로(2026-09-04 사용자 + * 확정), 저장 형식과 버전 해시가 두 벌이 되면 브라우저가 서버 저장본을 남으로 보고 + * 통째로 다시 만든다. 그래서 이 파일 하나만 둔다 — 화면 API 를 쓰지 않아 Node 에서도 + * 그대로 돈다(`btoa`·`atob` 는 Node 16+ 전역). + * + * 원래 `_UI_Corridor.ts` 안에 있던 것을 그대로 옮겼다(2026-09-04 분리, 내용 불변). + * ========================================================================== */ + +import type { SectionDetailResponse } from "../B06_Section/B06_Section_Api_Fetch"; +import type { RoutePoint } from "./B05_Profile_Api_Fetch"; +import type { CorridorBuildResult, CorridorRibbon } from "./B05_Profile_UI_Corridor_Build_Types"; +import { structureHashParts } from "./B05_Profile_UI_Corridor_Structures"; + +/** + * 저장본 **형식(스키마)** 버전 — 담는 필드가 바뀔 때만 올린다. + * + * 기하 계산이 바뀐 것은 여기가 아니라 아래 `BUILD_VERSION`으로 만료시킨다. + * + * 3 = 리본에 셀 마스크·축 고정 커브 조각 삼각형 추가 — 2026-08-26. + * 4 = 절취 측벽 서피스(`cutWalls`) 추가 — 2026-08-27. + * 5 = 측벽에서 빗금(UV)을 뺀다 — 벽은 방향성을 표현하지 않는다(2026-08-27 사용자). + * 6 = 리본의 `patch`·`patchClip` 표식을 담는다 — 안 담아서 저장본으로 다시 연 코리도가 + * 패치인 줄 모르고 지형 스냅에 끌려갔다(2026-09-02). + */ +export const ENVELOPE_VERSION = 6; + +export interface CorridorEnvelope { + version: number; + hash: string; + ribbons: Array<{ + kind: CorridorRibbon["kind"]; + side: CorridorRibbon["side"]; + colCount: number; + chainages: number[]; + positionsBase64: string; + /** + * 구조물 패치 리본 표식(2026-09-02) — 빌드 때만 쓰는 값이 아니라 **뷰어가 그릴 때도 + * 본다**(`B05_Profile_UI_Viewer.ts` 지형 스냅 제외). 안 담으면 저장본으로 다시 연 + * 코리도가 패치인 줄 몰라 바깥 끝이 원지반까지 끌려 내려간다. + */ + patch?: boolean; + patchClip?: boolean; + /** 셀 마스크(2026-08-26 투영 커브 안쪽 지우기) — 없으면 구멍 없는 리본. */ + cellMaskBase64?: string; + /** 축 고정 커브가 걸친 셀의 조각 삼각형·UV(2026-08-26). */ + trimTrisBase64?: string; + trimUvsBase64?: string; + }>; + outline: CorridorBuildResult["outline"]; + /** 시·종점 마구리(구 저장본엔 없음 — 없으면 빈 배열로 복원). */ + caps?: CorridorBuildResult["caps"]; + /** 배수관 세트 구조물(2026-08-23 — 구 저장본엔 없음, 없으면 빈 배열). */ + structures?: CorridorBuildResult["structures"]; + /** + * 구조물 세트별 탑뷰 투영 커브(2026-08-26) — 저장본에도 담는다. 안 담으면 + * 저장본으로 복원한 코리도에서는 커브가 통째로 사라진다. + */ + planCurves?: CorridorBuildResult["planCurves"]; + /** 절취 측벽 서피스(2026-08-27) — 구 저장본엔 없다. 없으면 빈 배열로 복원. */ + cutWalls?: Array<{ + side: "left" | "right"; + positionsBase64: string; + }>; +} + +/** FNV-1a 32bit — 설계 입력 요약 문자열의 버전 해시. */ +function fnv1a(text: string): string { + let hash = 0x811c9dc5; + for (let i = 0; i < text.length; i += 1) { + hash ^= text.charCodeAt(i); + hash = Math.imul(hash, 0x01000193); + } + return (hash >>> 0).toString(16).padStart(8, "0"); +} + +/** + * 빌드 로직 판번호 — **기하를 바꾸는 수정을 하면 반드시 올린다.** + * + * 해시는 종횡단 입력만 요약하므로, 빌드 코드를 고쳐도 입력이 그대로면 해시가 같아 + * 옛 저장본을 그대로 다시 쓴다 — 코드를 고쳤는데 화면이 안 바뀌는 일이 생긴다 + * (2026-08-23 사용자 보고: "원복이 안 된 것 같다가 갑자기 반영됨"). 판번호를 해시에 + * 섞어 두면 배포와 동시에 저장본이 만료된다. + */ +// 42 = 탑뷰 투영선(빨간 선)·구조물 구간 경계 행·파란 스케치 안쪽 기준 정정· +// 투영 커브 안쪽 성토면 절단 — 커브 다각형 기준(2026-08-26). +// ※ 40에 머물러 있는 동안 기하 수정 3회가 통째로 묻혔다 — 저장본이 그대로 +// 복원되어 화면·데이터가 하나도 안 바뀌었다. 기하를 고치면 **반드시** 올릴 것. +// 56 = 측벽에서 **노견 쪽·성토 끝단 쪽 리본 경계 벽을 뺀다** — 거기서 잘린 게 +// 아니라 리본이 끝난 자리다(2026-08-27 사용자). +// 64 = 변형 성토면(패치) 마감 3종 — ① 행별 지반 절단(빨간 교차선에서 끝냄) + +// 바깥 끝 수직 스커트, ② 날개 사다리꼴 몫만큼 패치 행 범위 확장(BOX는 축 고정), +// ③ 구조물 안착 자리 원지반 재노출(원본 성토 스케치 − 구조물 ∪ 변형 성토) +// (2026-08-27 사용자). +// 65 = 날개벽 평면 스케치까지 변형 성토면에 포함 — 늘린 행에 벽 트림을 걸지 않는다 +// (2026-08-27 사용자). +// 66 = 패치 행을 그 행 지반선과 직접 교차시켜 **자르고 연장**한다 — 날개 사다리꼴 +// 바깥변(원본 성토 끝선)까지 성토면이 이어진다(2026-08-27 사용자). +// 67 = (주석만 앞서 나갔던 번호 — 실제로 들어간 것은 66까지다. 2026-08-27 확인) +// 68 = 패치 스윕 범위를 **주황 날개 평면 스케치(`wing-box`)까지** 넓힌다 — 행별 지반 +// 핀(절단·연장)과 스커트는 그대로 두고, 스케치가 더 바깥일 때만 그 행을 설계 +// 성토 물매로 스케치 경계까지 덧이어 낸다(2026-08-27 사용자: 그 자리에 변형 +// 성토면이 있어야 한다 — 삭제가 아니다). +// 69 = 날개 스케치 확장에서 **BOX암거는 제외**한다 — 날개벽은 세월교·BOX 두 곳에서 +// 쓰이지만 로직이 분리돼 있고, BOX는 이미 채워져 있어(구멍 5~12%) 손대면 행 폭이 +// 0.74 → 4.53m로 뛴다(2026-08-27 사용자: "박스 암거는 로직 원복"). +// 70 = 세월교 날개 사다리꼴 A안 — ① 종방향 범위를 **노선 실투영**으로 잰다 +// (`wingSpanOnRoute`, 직선 투영은 곡선+먼 편거리에서 3m 어긋났다), +// ② 행 편거리를 스케치의 **안쪽·바깥쪽 끝**까지 늘린다(`wingRangeAt`, +// 좌측 고리는 패치보다 1.5m 안쪽에 있었다). BOX암거는 둘 다 제외 — 종전 그대로. +// 71 = 안쪽 확장을 **세월교 바닥판 상단 Z(`slabTopElevation`)로 트림**한다 — 성토 +// 물매 역연장이 유로 위로 솟아 바닥 상단과 안 만나는 자리로 튀었다(2026-08-27 사용자). +// 72 = 날개 스윕 범위를 **날개벽 끝점 횡단선**까지로 바꾼다 — 고리 전체가 아니라 +// 날개벽 선 두 끝을 노선에 실투영해 재고, 구조물 점유 구간 ±5m 여유 안에서 +// 트림한다. 고리와 안 만나는 중간 행도 더는 끊지 않는다(2026-08-27 사용자: +// "5m 늘려 서피스 만들고 날개벽 끝점 횡단선으로 트림"). +// 73 = ① 패치 점 중 **세월교 바닥판 상단 Z를 넘는 것은 지운다**(`clipRunBelow`, +// 종단 shift 반영·천장 교차점 삽입), ② 날개 스팬을 다시 **고리 전체 점**으로 +// 잰다 — 벽 끝점만 쓰면 좌측이 143.2~157.3 → 144.4~155.9로 줄었다 +// (2026-08-27 사용자: "좌측 스윕 더 가야 함"). +// 74 = (날개 몫 행 트림 시도 — 사용자 지시로 **원복**. 안쪽까지 자르면 구조물 구간과 +// 날개 사이가 벌어졌고, 바깥선만 자르는 판은 버전을 안 올려 화면에 못 올라갔다.) +// 75 = 73 상태로 원복 — 트림 없음. 날개 몫 행은 지반 핀 + 스케치 확장 + 바닥 상단 +// Z 초과 삭제까지만 한다(2026-08-27 사용자: "2번 전으로"). +// (76~78의 트림 도구 `wingOuterLines`·`wingTrimAt`·`clipRunToRange` 는 2026-09-02에 +// 제거했다 — 원복 뒤 다시 배선되지 않아 참조가 0이었다. 아래는 이력으로만 남긴다.) +// 76 = 날개 몫 행을 **주황 고리의 바깥선**에서 끝낸다(`wingOuterLines`+`wingTrimAt`). +// 고리가 그 행까지 모자라면 **끝 마디를 복사해 20m 연장**해서 만나게 한다 +// (2026-08-27 사용자). 안쪽은 안 자른다. +// 77 = 주황 바깥선 트림을 **모든 행**에 건다 — 구조물 점유 구간 안 행을 빼놨더니 +// 그 구간이 커브 밖으로 삐져나왔다. 자르는 게 아니라 커브를 새 바깥 끝으로 +// 삼아 줄을 다시 잡고 `resample`이 열을 그 위에 다시 깔아 **메시가 재배치**된다 +// (2026-08-27 사용자: "메시의 재배치가 필요하잖아, 그래야 잘리지"). +// 78 = 날개 몫 로직을 **구조물 종류로 가른다**(2026-08-27 사용자: "세월교, 박스암거, +// 기슭막이") — `section.ford`일 때만 실투영 스팬·스케치 확장·바깥선 트림을 태우고 +// BOX암거·기슭막이는 종전 경로 그대로. 트림선은 **날개 하나 단위**로 나눠 행마다 +// 누가거리가 가장 가까운 날개 것만 쓴다(20m 연장선이 서로 먹던 것을 막는다). +// 79 = 세월교 패치를 **절취 영역 셀 마스크의 반대 규칙**으로 클립한다 — 영역 밖 셀은 +// 지우고 걸친 셀은 안쪽 조각만 남긴다(`patchClip`). 행 단위 바깥선 트림은 폐기 — +// 비스듬한 사다리꼴 경계를 행 끝 하나로는 못 맞춰 74셀이 삐져나왔다(실측). +// 지우는 면과 채우는 면이 같은 경계를 공유한다(2026-08-27 사용자). +// 80 = 배수관 세트(기슭막이) **노견 → 벽 이음선 상단 성토 사면**을 되메움 리본 배열 +// (`fillRuns`)에도 담는다 — 78/79의 포켓은 노견까지 파는데 79까지의 배열에는 +// 벽 아래 다단·집수정 성토선만 있어 **기슭막이 상단부가 통째로 비었다** +// (2026-08-27 사용자). 새 면이 아니라 실루엣이 이미 쓰던 `designTrim` 사면선 +// 그대로다. 벽 루프·집수정 분기가 같은 선을 담으므로 측당 한 번만 등록한다. +// 81 = `slope-deformed` 커브를 **패치 리본과 같은 규칙**으로 끝낸다 — 실루엣 바깥 +// 끝이 그 측점 지반에 안 닿으면(BOX암거: 구체 최상단) 외삽하지 않고 실루엣이 +// 끝나는 자리를 바깥 끝으로 쓴다. 종전에는 이 커브만 무조건 최대 30m 외삽해 +// 성토 끝선까지 갔고, BOX는 기본값에서 변형 성토선이 원본 성토선과 정확히 +// collinear가 되어 `원본 − (구조물 ∪ 변형)` = ∅ — **구체 밖 원지반 재노출이 +// 통째로 미실행**이었다(2026-08-27 사용자 확정: "구체 밖은 원지반이어야 한다"). +// 실루엣이 구조물에서 끝나는지는 기하로 재지 않고 `endsAtStructure` 표식으로 +// 가른다 — 낙차로 재면 기슭막이 유출측처럼 지반보다 바깥으로 나간 실루엣까지 +// 걸려 원래 짧게 잘리던 것이 안 잘린다(실측 84.3 우측 5.10 → 5.69m). +// 아울러 BOX 날개 사다리꼴(`wing-box`)을 원지반 재노출 후보에 넣는다 — 절취 +// 소스에는 있고 되살릴 목록에는 없어 그 자리가 성토면도 지반도 없는 구멍이었다 +// (2026-08-27 사용자: "날개부의 평면 스케치 영역까지 원지반이 같이 노출"). +// 세월교는 제외 — 그 자리는 되메움 패치가 덮는다(`wingRangeAt`, isFord 전용). +// 82 = BOX암거 `structure` 탑뷰 커브를 부재별 7고리가 아니라 **아령 외곽선 한 줄**로 +// 낸다(2026-08-27 사용자: "바닥을 위에서 보면 아령형상이고 제일 외곽에 있는 선 +// 성분을 평면 투영하면 경계"). 상판+에이프런에 `planOutline` 표식을 달고 +// `_Plan_Footprint.ts`가 링 자리마다 편거리 창을 합친다 — 기하 불리언 없음 +// (BOX 부재는 전부 같은 고정축 위 평행 링이다). 종전 부재별 고리에는 날개벽이 +// **패널 두께 슬리버**로 섞여 있었고(실측 0.40㎡ / bbox 1.69×1.40 ×2), 그 슬리버가 +// "덮인 자리"로 빠져 그 자리만 성토면도 지형도 없는 검은 줄이 됐다. 에이프런은 +// 날개벽 발치를 얹으려고 넓혀 둔 부재라 외곽선이 날개를 이미 품는다. +// 83 = 원지반 재노출 영역을 **`cut-merged`**(성토면에서 실제로 도려낸 셀의 윤곽)로 +// 바꾼다. 종전에는 `원본 성토 스케치 − (구조물 ∪ 변형 성토 스케치)`로 영역을 +// **다시 조립**해, 지우는 쪽과 되살리는 쪽이 다른 커브를 쓰며 경계가 어긋났다 +// (날개벽 패널 두께 슬리버 자리에 검은 줄). 이제 지우는 쪽이 남긴 자국을 그대로 +// 쓰므로 **원본 지형 메시가 그 자리에 그대로 남는다** — 새 서피스를 만들지 않는다 +// (2026-08-27 사용자: "원지반 오리지널 데이터에서 가져오라니까"). +// 84 = 잘린 자리 윤곽(`cut-merged`) 추적을 고친다 — 갈림목에서 아무 변이나 집어 +// walk가 남의 고리로 새 나가고, 막다른 길에서 끊긴 **열린 사슬이 고리로 담겼다**. +// 표시용일 땐 안 보였지만 이제 이 커브가 되살릴 영역의 근거라 그대로 구멍이 된다 +// (실측: 도려낸 셀의 18% — 성토 끝단 쪽 col 40~46 — 이 영역에서 빠졌다. +// 2026-08-27 사용자: "유출구에 일부 성토부에 터짐 있음"). 오른손 규칙으로 갈림목을 +// 가르고 **닫힌 고리만** 담는다. +// 85 = 물넘이포장 자리 노면을 판다 — 횡단도와 같은 산식(fordDeckElevationAt)으로 노면·노견 +// 조각 표고를 내린다. 노면 밖 비탈은 그대로라 노견 끝에 수직 단차가 선다(2026-08-28 사용자). +// 86 = 독립 기슭막이(구조물 정본 D군)를 3D에 세운다 — 횡단 카드와 같은 폴리곤 +// (computeRevetmentLayout)을 기준측점 전/후 길이만큼 스윕한다(2026-08-28 사용자). +// 87 = 독립 기슭막이 **다단** — 단마다 솔리드를 세운다. 단 사이 성토는 1:1.2, +// 다음 단 시작점은 윗단 하단 수평선 +근입과 전면 경사선의 교차점(2026-08-22 규칙 승계). +// 88 = 독립 기슭막이 기준을 **맨 위 단**으로 되돌리고 추가 단은 아래로 붙인다(배관 세트와 +// 같은 규칙). 기준 자리는 사용자 이동값(기준 올림·좌우)을 탄다(2026-08-28 사용자). +// 89 = BOX암거 패치도 **절취 영역 안쪽으로 자른다**(2026-09-02). 그 규칙이 세월교에만 +// 걸려 있어 BOX 패치는 한 번도 안 잘리고 영역 밖으로 넘쳤다 — 실측에서 BOX 패치 +// 리본 두 벌(198.4~203.5m)에 셀 마스크가 없었다. BOX도 `wing-box` 커브로 절취 +// 영역을 내므로 같은 반대 규칙이 성립한다. +// 90 = 잘린 자리 윤곽(`cut-merged`)의 **시작 모서리 유실**을 고친다 — `dropCollinear`가 +// 고리의 닫힘 중복점(머리=꼬리)을 순환 이웃으로 셈해 머리 모서리를 지우고, 그 양옆 +// 일직선 점까지 빠져 첫 행이 대각선으로 잘렸다(실측: 8고리 전부, 63셀 구멍 — +// 우 197.6~198.2m BOX 앞 쐐기 33셀이 가장 큼). 되살릴 영역이 이 커브라 저장본을 만료한다. +// 91 = 구조물 솔리드에 **부재키**(`key`)를 싣는다 — 3D 개별 선택이 그 표로 부재를 +// 가려낸다(2026-09-04). 옛 저장본엔 키가 없어 3D에서 골라도 B06 조정창으로 넘길 +// 부재를 못 정하므로 만료한다. +// 92 = 세월교·BOX암거 부재까지 **부재키를 일원화**한다 — 횡단도가 부르는 이름 그대로 +// (세월교 유입·유출, BOX 좌·우, 본체는 `body`). 91 저장본엔 배수관 세트 키만 있다. +const BUILD_VERSION = 92; + +/** 종횡단 정본에서 코리도에 영향을 주는 입력만 요약해 해시 — 갱신 감지 기준. */ +export function corridorHash(detail: SectionDetailResponse, routePoints: RoutePoint[]): string { + const parts: Array = [`v${BUILD_VERSION}`, routePoints.length]; + routePoints.forEach((p) => parts.push(p.x.toFixed(2), p.y.toFixed(2))); + detail.cross_sections.forEach((section) => { + const design = section.design; + parts.push( + section.chainage_m.toFixed(3), + section.center_x.toFixed(2), + section.center_y.toFixed(2), + ); + if (!design) { + parts.push("nodesign"); + return; + } + parts.push( + design.design_elevation_m.toFixed(3), + design.section_mode, + design.ditch_side ?? "", + design.ditch_type ?? "", + String(design.ditch_enabled ?? ""), + design.design_line.length, + ); + design.design_line.forEach((point) => + parts.push(point.offset_m.toFixed(3), point.elevation_m.toFixed(3)), + ); + // 구조물(배수관 세트) 입력 — 길이·전후·형식이 바뀌면 재빌드되어야 한다. + structureHashParts(section).forEach((part) => parts.push(part)); + }); + return fnv1a(parts.join("|")); +} + +function base64FromFloats(values: Float64Array): string { + const bytes = new Uint8Array(values.buffer, values.byteOffset, values.byteLength); + let binary = ""; + const CHUNK = 0x8000; + for (let i = 0; i < bytes.length; i += CHUNK) { + binary += String.fromCharCode(...bytes.subarray(i, i + CHUNK)); + } + return btoa(binary); +} + +function base64FromBytes(bytes: Uint8Array): string { + let binary = ""; + const CHUNK = 0x8000; + for (let i = 0; i < bytes.length; i += CHUNK) { + binary += String.fromCharCode(...bytes.subarray(i, i + CHUNK)); + } + return btoa(binary); +} + +function bytesFromBase64(encoded: string): Uint8Array { + const binary = atob(encoded); + const bytes = new Uint8Array(binary.length); + for (let i = 0; i < binary.length; i += 1) bytes[i] = binary.charCodeAt(i); + return bytes; +} + +function floatsFromBase64(encoded: string): Float64Array { + const binary = atob(encoded); + const bytes = new Uint8Array(binary.length); + for (let i = 0; i < binary.length; i += 1) bytes[i] = binary.charCodeAt(i); + return new Float64Array(bytes.buffer); +} + +export function serialize(build: CorridorBuildResult, hash: string): CorridorEnvelope { + return { + version: ENVELOPE_VERSION, + hash, + ribbons: build.ribbons.map((ribbon) => ({ + kind: ribbon.kind, + side: ribbon.side, + colCount: ribbon.colCount, + chainages: ribbon.chainages, + positionsBase64: base64FromFloats(ribbon.positions), + ...(ribbon.patch ? { patch: true } : {}), + ...(ribbon.patchClip ? { patchClip: true } : {}), + ...(ribbon.cellMask ? { cellMaskBase64: base64FromBytes(ribbon.cellMask) } : {}), + ...(ribbon.trimTris && ribbon.trimUvs + ? { + trimTrisBase64: base64FromFloats(ribbon.trimTris), + trimUvsBase64: base64FromBytes(new Uint8Array(ribbon.trimUvs.buffer.slice(0))), + } + : {}), + })), + outline: build.outline, + caps: build.caps, + structures: build.structures, + planCurves: build.planCurves, + cutWalls: (build.cutWalls ?? []).map((wall) => ({ + side: wall.side, + positionsBase64: base64FromFloats(wall.positions), + })), + }; +} + +export function deserialize(envelope: CorridorEnvelope): CorridorBuildResult { + return { + ribbons: envelope.ribbons.map((ribbon) => ({ + kind: ribbon.kind, + side: ribbon.side, + colCount: ribbon.colCount, + chainages: ribbon.chainages, + positions: floatsFromBase64(ribbon.positionsBase64), + ...(ribbon.patch ? { patch: true } : {}), + ...(ribbon.patchClip ? { patchClip: true } : {}), + ...(ribbon.cellMaskBase64 ? { cellMask: bytesFromBase64(ribbon.cellMaskBase64) } : {}), + ...(ribbon.trimTrisBase64 && ribbon.trimUvsBase64 + ? { + trimTris: floatsFromBase64(ribbon.trimTrisBase64), + trimUvs: new Float32Array(bytesFromBase64(ribbon.trimUvsBase64).buffer), + } + : {}), + })), + outline: envelope.outline, + caps: envelope.caps ?? [], + structures: envelope.structures ?? [], + planCurves: envelope.planCurves ?? [], + cutWalls: (envelope.cutWalls ?? []).map((wall) => ({ + side: wall.side, + positions: floatsFromBase64(wall.positionsBase64), + })), + }; +} diff --git a/common_util/common_util_initial_snapshot.py b/common_util/common_util_initial_snapshot.py index 9b68e25c..39934bf7 100644 --- a/common_util/common_util_initial_snapshot.py +++ b/common_util/common_util_initial_snapshot.py @@ -45,6 +45,11 @@ _FILE_TREES = ( # 배수유역을 폴더 통째로 넓히기 전(2026-09-04)에 찍힌 스냅샷이 갖고 있는 자리. _LEGACY_DRAINAGE_TREE = "B04_PreProcess__drainage__edits" +# 코리도(3D 예상형상) 초기값 — 체인이 만든 저장본 한 벌(2026-09-04 사용자 확정). +# 작업본 파일명에는 route id가 박히는데 [초기화]는 **새 route id**를 만드므로, 스냅샷에는 +# 번호 없는 이름으로 두었다가 복원 때 새 번호로 되돌린다. +_CORRIDOR_NAME = "initial_corridor.json" + # `routes.id`를 참조하는 표는 스키마상 이 넷이 전부다(001_create_schema.sql:539~556). _CHILD_TABLES = ("route_points", "route_statistics", "longitudinal_sections", "cross_sections") @@ -198,6 +203,13 @@ async def save_initial_snapshot( for tree in _FILE_TREES: _copy_tree(root / tree, target / tree.replace("/", "__")) + # 코리도는 체인이 마지막에 만든다 — 있으면 함께 뜬다(없으면 브라우저 폴백 그대로). + from B05_Profile.B05_Profile_Router_Corridor import corridor_path + + corridor = corridor_path(root, route_id) + if corridor.is_file(): + shutil.copy2(corridor, target / _CORRIDOR_NAME) + async with connection.cursor(aiomysql.DictCursor) as cursor: await cursor.execute("SELECT * FROM routes WHERE id = %s", (route_id,)) route = await cursor.fetchone() @@ -245,7 +257,7 @@ def wipe_edited_masters(project_root: Path) -> list[str]: return removed -def restore_snapshot_files(project_root: Path) -> None: +def restore_snapshot_files(project_root: Path, route_id: int | None = None) -> None: """스냅샷 파일을 작업본 자리에 되돌린다. 스냅샷에 없던 트리는 비워 둔다. 배수유역 범위를 넓히기 전(2026-09-04)에 찍힌 스냅샷은 `edits/`만 갖고 있다 — @@ -261,6 +273,16 @@ def restore_snapshot_files(project_root: Path) -> None: continue _copy_tree(stored, root / tree) + # 코리도는 복원으로 만든 **새 route id** 이름으로 되돌린다 — 이름이 어긋나면 브라우저가 + # 저장본을 못 찾아 초기화 뒤 첫 진입마다 통째로 다시 만든다. + from B05_Profile.B05_Profile_Router_Corridor import corridor_path + + corridor = source / _CORRIDOR_NAME + if route_id is not None and corridor.is_file(): + target = corridor_path(root, int(route_id)) + target.parent.mkdir(parents=True, exist_ok=True) + shutil.copy2(corridor, target) + async def restore_initial_snapshot( connection: aiomysql.Connection, project_root: Path, project_id: str diff --git a/package.json b/package.json index 00290cfa..a5e66137 100644 --- a/package.json +++ b/package.json @@ -5,7 +5,8 @@ "type": "module", "scripts": { "dev": "node ./config/node_modules/vite/bin/vite.js --configLoader runner", - "build": "node ./config/node_modules/typescript/bin/tsc --noEmit && node ./config/node_modules/vite/bin/vite.js build --configLoader runner && npm run build:b07-cad", + "build": "node ./config/node_modules/typescript/bin/tsc --noEmit && node ./config/node_modules/vite/bin/vite.js build --configLoader runner && npm run build:corridor && npm run build:b07-cad", + "build:corridor": "node ./config/node_modules/vite/bin/vite.js build --configLoader runner --ssr ../B05_Profile/B05_Profile_Corridor_Node.ts --outDir ../config/corridor_node", "install:b07-cad": "npm --prefix B07_DesignDetail/openwebcad install", "build:b07-cad": "npm run install:b07-cad && npm --prefix B07_DesignDetail/openwebcad run build", "preview": "node ./config/node_modules/vite/bin/vite.js preview --configLoader runner",