/* ============================================================================= * B05_Profile_Api_Replan.ts * 계획노선 두 벌(예상노선·계획노선) 읽기와 노선 갈아 끼우기 요청. * * GET /projects/{id}/route/plan → 예상노선·계획노선 정점(사업지 좌표계 m) * POST /projects/{id}/route/replan → 고친 계획노선으로 갈아 끼우고 재계산 * POST /projects/{id}/route/replan/reset → 계획노선을 예상노선으로 되돌리고 재계산 * * 재계산은 배수유역부터 전 단계를 다시 도는 무거운 작업이라(용화 67측점 기준 3분대) * 타임아웃을 길게 잡는다 — 기본값으로 두면 중간에 끊긴다. * ========================================================================== */ import { API_BASE_URL } from "@config/config_frontend"; /** 노선 재계산 대기 상한 — 배수유역 분석(90초대)까지 포함해 넉넉히 잡는다. */ const REPLAN_TIMEOUT_MS = 15 * 60 * 1000; /** 사용자가 잡아 옮기는 제어점 하나 — 서버가 이 노드로 폴리라인을 만든다. */ export interface RoutePlanNode { x: number; y: number; /** 직전·직후 구간이 이루는 내각(도). 끝점은 null. */ inner_angle_deg: number | null; /** 이 자리에 끼운 원호 반지름(m). 곡선을 지운 자리는 null. */ radius_m: number | null; tangent_m: number | null; /** 법정 기준 위반 표시 — 값은 내되 막지 않는다. */ violations: string[]; } /** 직선 사이에 놓인 **곡선 성분 하나** — 화면이 손잡이와 R 칸을 그리는 재료. */ export interface RoutePlanCurve { /** 앞뒤 직선을 늘려 만나는 자리(교각점). **반지름을 바꿔도 여기는 안 움직인다.** */ apex: [number, number]; radius_m: number; tangent_m: number; inner_angle_deg: number; /** 곡선 시작점 — 직선이 곡선에 닿는 자리. 사용자가 잡는 손잡이다. */ start: [number, number]; /** 곡선 끝점. */ end: [number, number]; /** 이 곡선이 대신하는 꺾임점 구간(첫·끝) — 편집이 어느 노드를 건드리는지 알려 준다. */ node_first: number; node_last: number; violations: string[]; } export interface RoutePlanResponse { status: string; project_id: string; /** 예상노선(원본) **점 묶음** [[x, y], …] — 사업지 좌표계(m). 폴리라인이 아니다. */ expected: Array<[number, number]>; /** 계획노선 폴리라인(원호 포함) — 그려 보이는 선. 잡는 대상이 아니다. */ planned: Array<[number, number]>; /** 잡아 옮기는 노드(꺾임점). 편집은 이것으로 한다(2026-09-06 사용자 지시). */ nodes: RoutePlanNode[]; /** 직선·곡선 성분 — 곡선 시작·끝점과 반지름. 화면이 이것으로 손잡이를 그린다. */ curves: RoutePlanCurve[]; /** 이 프로젝트에 적용한 법정 최소곡선반지름(m) — **기본값·위반 표시 기준**. */ min_radius_m: number; /** **못 넘는** 곡선반지름 하한(m). 0이면 제한 없음(작업임도). 기본값과 다른 값이다. */ limit_radius_m?: number; /** **못 넘는** 곡선 길이 하한(m). 0이면 제한 없음 — 지금은 전부 0(법에 값이 없음). */ limit_curve_length_m?: number; curve_count: number; violation_count: number; /** 사용자가 고친 계획노선이 저장돼 있으면 true. */ edited: boolean; } export interface RouteReplanResponse { status: string; project_id: string; route_id: number | null; total_length_m: number | null; vertex_count: number; } async function requestJson(path: string, init: RequestInit, timeoutMs: number): Promise { const controller = new AbortController(); const timer = window.setTimeout(() => controller.abort(), timeoutMs); try { const response = await fetch(`${API_BASE_URL}${path}`, { ...init, credentials: "include", headers: { "Content-Type": "application/json", ...(init.headers ?? {}) }, signal: controller.signal, }); const payload = (await response.json()) as T & { message?: string }; if (!response.ok) throw new Error(payload.message ?? `HTTP ${response.status}`); return payload; } finally { window.clearTimeout(timer); } } /** 예상노선·계획노선을 함께 읽는다(편집 모달이 점선·실선으로 그린다). */ export async function fetchRoutePlan(projectId: string): Promise { return requestJson( `/projects/${projectId}/route/plan`, { method: "GET" }, 60000, ); } /** 꺾임점 하나에 실어 보내는 편집값 — 곡선을 둘지, 반지름을 못박을지. */ export interface RouteReplanVertex { x: number; y: number; /** 이 자리에 곡선을 둘지. 끄면 직선이 그대로 꺾인다(곡선 삭제). */ curve?: boolean; /** 못박을 반지름(m). 없으면 서버가 고른다. */ radius_m?: number | null; } /** 고친 계획노선으로 갈아 끼우고 배수유역부터 다시 계산한다. * * 편집 세 가지가 모두 이 한 목록으로 나간다(2026-09-07 사용자 지시) — * **직선 삭제·추가**는 점을 빼거나 더하는 것, **곡선 삭제·추가**는 `curve` 를 끄고 켜는 것, * **반지름 변경**은 `radius_m` 을 주는 것. */ export async function replanRoute( projectId: string, vertices: Array<[number, number]> | RouteReplanVertex[], ): Promise { const payload = (vertices as Array<[number, number] | RouteReplanVertex>).map((vertex) => Array.isArray(vertex) ? { x: vertex[0], y: vertex[1] } : vertex, ); return requestJson( `/projects/${projectId}/route/replan`, { method: "POST", body: JSON.stringify({ vertices: payload }) }, REPLAN_TIMEOUT_MS, ); } /** 점 묶음의 **지반고**를 묻는다(계획서 0-9 ⑤·⑧). * * 새 계산이 아니라 확정된 지표면을 **읽기만** 하므로 편집 중에 불러도 된다 — 다만 끄는 동안 * 프레임마다 부르지는 않는다(찍는 순간에만). 지표면 밖은 `null` 로 온다. */ export async function fetchRouteElevations( projectId: string, points: Array<[number, number]>, ): Promise> { const payload = await requestJson<{ z: Array }>( `/projects/${projectId}/route/elevations`, { method: "POST", body: JSON.stringify({ points }) }, 60000, ); return payload.z; } /** 횡단 미리보기 한 장 — 고치던 노선 그대로 그 측점만 서버가 셈해 준다(계획서 0-9 ⑧). */ export interface CrossPreviewResponse { status: string; chainage_m: number; label: string | null; uphill_side: string | null; plan_radius_m: number | null; curve_widening_m: number | null; /** 원지반 횡단 샘플. */ samples: Array<{ offset_m?: number; elevation_m?: number | null; valid: boolean }>; /** 기본 계획 횡단 — B06 `compute_cross_design` 이 낸 것. 계획고를 못 세우면 null. */ design: { design_line: Array<{ offset_m: number; elevation_m: number }>; cut_area_m2: number; fill_area_m2: number; [key: string]: unknown; } | null; } export interface CrossPreviewRequest { vertices: Array<{ x: number; y: number; curve: boolean; radius_m: number | null }>; chainage_m: number; min_radius_m: number; station_interval_m: number; } /** 한 측점 횡단을 묻는다. 종·횡단을 한 번 돌리므로 **한두 초** 걸린다(사용자 확정: 괜찮음). */ export async function fetchCrossPreview( projectId: string, request: CrossPreviewRequest, ): Promise { return requestJson( `/projects/${projectId}/route/cross-preview`, { method: "POST", body: JSON.stringify(request) }, 120000, ); } /** 계획노선을 예상노선으로 되돌리고 같은 재계산을 돈다(노선 초기화). */ export async function resetRoutePlan(projectId: string): Promise { return requestJson( `/projects/${projectId}/route/replan/reset`, { method: "POST" }, REPLAN_TIMEOUT_MS, ); }