- 알약: 예상노선 추적 · 토공 최소 · 기울기 순한 · 짧은 노선(short) · 흙 균형(balance) · 비중 계산 — 짧은 노선 · 흙 균형은 비중 없음 - 비교값에 「남는 흙」(surplus_m3 · + 남음 / − 모자람) - 응답 similar · band_width_m → 비교값 아래 「이 지형은 제약 안에서 갈 길이 폭 …」 한 줄 + 흐린 안내 · 없으면 줄 숨김 - 시험: 가짜 응답 · 여섯 이름 · 남는 흙 · 알림 줄 · 비중 계산 사유 · 왕복 시험에 short · balance 더함 Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
66 lines
2.6 KiB
TypeScript
66 lines
2.6 KiB
TypeScript
/* =============================================================================
|
|
* B05_Profile_Api_RouteInitial.ts
|
|
* 초기노선 갈래 요청(계획서 20) — 로직 하나를 골라 서버가 새 계획노선 노드를 낸다.
|
|
*
|
|
* POST /projects/{id}/route/initial { mode, weights?, criteria? } → 노드 · 비교값 · 공통 제약 기준값
|
|
*
|
|
* 계산 자리는 **서버 단독**(CLAUDE.md 5장 ③) — 화면은 부르고, 받은 노드를 편집 캐시에 싣고,
|
|
* 받은 비교값·기준값을 보이기만 한다. 모양은 계획서 20 「API」 줄(서버 `initial_route`) —
|
|
* 답을 펴는 자리는 `normalizeRouteInitial`(`_RouteEdit_Initial_Model`) 한 곳이다.
|
|
* ========================================================================== */
|
|
|
|
import { requestJson } from "./B05_Profile_Api_Replan";
|
|
|
|
/** 갈래 셈 대기 상한 — 노선 여러 벌을 셈해 견주므로 넉넉히 잡는다. */
|
|
const INITIAL_TIMEOUT_MS = 5 * 60 * 1000;
|
|
|
|
/** 로직 이름 — 서버와 같은 낱말을 쓴다. `follow` 는 예상노선 추적(처음 초기값). */
|
|
export type RouteInitialLogic =
|
|
"follow" | "earthwork" | "gentle" | "short" | "balance" | "weighted";
|
|
|
|
/** 비중 계산의 세 비중(%) — 합 100. */
|
|
export interface RouteInitialWeights {
|
|
expected: number;
|
|
earthwork: number;
|
|
grade: number;
|
|
}
|
|
|
|
/** 공통 제약 겹침 값 — 화면 네 칸(계획서 20 확정). 비우면 서버가 프로젝트 기본값을 쓴다.
|
|
* 이름은 서버 몸통과 그대로(snake_case) — 변환 없이 그대로 실어 보낸다. */
|
|
export interface RouteInitialCriteria {
|
|
max_grade_pct?: number;
|
|
min_radius_m?: number;
|
|
stream_offset_m?: number;
|
|
grade_smooth_m?: number;
|
|
}
|
|
|
|
export interface RouteInitialRequest {
|
|
mode: RouteInitialLogic;
|
|
weights?: RouteInitialWeights;
|
|
criteria?: RouteInitialCriteria;
|
|
}
|
|
|
|
/** 서버 길이 아직 없다(404·405) — 화면은 이 글로 알린다. */
|
|
export const ROUTE_INITIAL_MISSING =
|
|
"초기노선 갈래 서버 길이 아직 없습니다(계획서 20 · sub3 대기).";
|
|
|
|
/** 로직 하나로 초기노선을 묻는다. 답의 모양은 `normalizeRouteInitial` 이 편다. */
|
|
export async function fetchRouteInitial(
|
|
projectId: string,
|
|
request: RouteInitialRequest,
|
|
): Promise<unknown> {
|
|
try {
|
|
return await requestJson<unknown>(
|
|
`/projects/${projectId}/route/initial`,
|
|
{ method: "POST", body: JSON.stringify(request) },
|
|
INITIAL_TIMEOUT_MS,
|
|
);
|
|
} catch (error) {
|
|
const message = error instanceof Error ? error.message : "";
|
|
if (/HTTP 40[45]|Not Found|Method Not Allowed/.test(message)) {
|
|
throw new Error(ROUTE_INITIAL_MISSING);
|
|
}
|
|
throw error;
|
|
}
|
|
}
|