eomsangdonandClaude Opus 5
3651ad9875
2026-09-02 사용자 지시 9건 반영. 화면 실조작 검증은 다음 세션 몫 (사용자 지시로 코딩까지만 진행). 1. 초기 계획선 = 전체 측점 폴리라인 — `design_ground_following_profile()` 신설. 모든 측점을 변화점으로 잡고 계획고 = 원지반고, 라운드는 R을 지정한 자리에만 (`build_curves(only_explicit=)`·`build_alignment(only_explicit_curves=)`). basis `ground_polyline`. 관 정착 선형은 폴백으로 내림. 2. 구간 쉬프트(⬆⬇) 삭제. 3. [직선화] 신설 — `B05_Profile_UI_Profile_Straighten.ts`. 두 측점의 라운드에 탄젠트한 직선으로 대체하고 사이 라운드 삭제. 직선 틸팅 시 가운데 라운드 + 양측 탄젠트 재구성. 4. [쉬프트] 신설 — 직선 구간을 기하에서 되읽어(`detectStraightRun`) 복수 선택, 최외곽 라운드 중심 기준 상·하 평행이동. 5. 방향키 조작 — 상하 0.1m 계획고, 좌우 0.1m 누가거리(구조물·비정규 측점 한정). 6. undo/redo 신설 — B05·B06 조작 세션 키 묶음 스냅샷(`_Profile_History.ts`). 버튼은 요약줄 맨 앞(최대 기울기 좌측), 21x17px. Ctrl+Z / Ctrl+Shift+Z. 7. 종단 요약줄의 횡단배수 최소고 표시 삭제(산식·편집 차단은 유지). 8. [편집 되돌리기] 버튼 삭제 — undo/redo로 대체. 9. 지형 구분 기본값 특수지형 — 패널 셀렉트와 백엔드 기본값(스키마·체인 폴백) 일치. 700줄 제한 — 패널을 `_Profile_Panel_Tools` · `_Profile_Preview` 로 분리하고 측점↔구조물 짝짓기를 `_Profile_Structures` 로 이관(842줄 → 696줄). 검증: tsc --noEmit 오류 0, ruff format/check 통과, pytest tmp/tests/ -q → 366 passed / 14 skipped / 0 failed. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
306 lines
12 KiB
Python
306 lines
12 KiB
Python
"""B05 경로 설계 요청·응답 검증 모델."""
|
|
|
|
from typing import Any, Literal
|
|
|
|
from pydantic import BaseModel, ConfigDict, Field, model_validator
|
|
|
|
from config.config_system import (
|
|
GRADE_MAIN_DIRECTIONS,
|
|
GRADE_TERRAIN_TYPES,
|
|
ROUTE_GRADE_CLASSES,
|
|
)
|
|
|
|
# 경사 입력은 화면·API·DB 모두 **퍼센트(%)** 로 통일한다(비율로 쓰던 과거와 다름).
|
|
# 엔진 진입점에서만 100으로 나눠 비율로 바꾼다.
|
|
GRADE_PERCENT_FIELDS = (
|
|
"max_uphill_grade",
|
|
"max_downhill_grade",
|
|
"min_uphill_grade",
|
|
"min_downhill_grade",
|
|
)
|
|
# 과거 버전은 같은 필드를 비율(0.14 = 14%)로 저장했다. 임도 종단기울기를 1% 이하로
|
|
# 두는 경우는 없으므로, 1 이하 값은 레거시 비율로 보고 퍼센트로 환산한다.
|
|
LEGACY_GRADE_RATIO_MAX = 1.0
|
|
|
|
|
|
def normalize_grade_percent(value: Any) -> Any:
|
|
"""경사 값을 퍼센트로 정규화한다(레거시 비율 자동 환산)."""
|
|
if value is None:
|
|
return None
|
|
try:
|
|
number = float(value)
|
|
except (TypeError, ValueError):
|
|
return value
|
|
if 0.0 < number <= LEGACY_GRADE_RATIO_MAX:
|
|
# 0.14 * 100 = 14.000000000000002 같은 잔여 오차를 남기지 않는다.
|
|
return round(number * 100.0, 6)
|
|
return number
|
|
|
|
|
|
class RoutePoint(BaseModel):
|
|
"""경로 제어점 (BP/CP/EP)."""
|
|
|
|
model_config = ConfigDict(extra="forbid")
|
|
|
|
x: float
|
|
y: float
|
|
z: float | None = None
|
|
order: int | None = None
|
|
|
|
|
|
class CirclePoint(BaseModel):
|
|
"""회피/금지 원 (AP/FP)."""
|
|
|
|
model_config = ConfigDict(extra="forbid")
|
|
|
|
x: float
|
|
y: float
|
|
radius_m: float = Field(gt=0)
|
|
|
|
|
|
class RouteSolveRequest(BaseModel):
|
|
"""경로 탐색 실행 요청."""
|
|
|
|
model_config = ConfigDict(extra="forbid")
|
|
|
|
filter_key: str = Field(description="지면 필터 키 (grid_min_z/csf/pmf)")
|
|
method: str = Field(default="dtm", description="지표면 표현 (dtm/tin/nurbs/implicit/meshfree)")
|
|
smooth: bool = Field(default=False)
|
|
surface_model_id: int | None = Field(default=None, description="기반 지표면 모델 id")
|
|
algorithm: str = Field(default="dijkstra", description="경로 알고리즘 (dijkstra/ridge_valley)")
|
|
|
|
bp: RoutePoint
|
|
ep: RoutePoint
|
|
cp: list[RoutePoint] = Field(default_factory=list)
|
|
ap: list[CirclePoint] = Field(default_factory=list)
|
|
fp: list[CirclePoint] = Field(default_factory=list)
|
|
|
|
grade_class: str = Field(default="trunk")
|
|
paved: bool = Field(default=False)
|
|
min_curve_radius_m: float | None = None
|
|
# 경로탐색 경사 제약 (단위: %). 과거 비율 저장분은 검증 단계에서 자동 환산된다.
|
|
max_uphill_grade: float | None = Field(default=None, ge=0, le=100)
|
|
max_downhill_grade: float | None = Field(default=None, ge=0, le=100)
|
|
min_uphill_grade: float | None = Field(default=None, ge=0, le=100)
|
|
min_downhill_grade: float | None = Field(default=None, ge=0, le=100)
|
|
weights: dict[str, float] | None = None
|
|
allow_avoid_pass_through: bool = Field(default=False)
|
|
station_interval_m: float | None = Field(default=None, gt=0)
|
|
cross_half_width_m: float | None = Field(default=None, gt=0)
|
|
cross_sample_interval_m: float | None = Field(default=None, gt=0)
|
|
long_sample_interval_m: float | None = Field(default=None, gt=0)
|
|
|
|
# 종단 계획선(계획고) 설계 옵션. 빈 값은 null로 두어 config 기본값을 쓴다.
|
|
# 기본 특수지형(2026-09-02 사용자 지시) — B05 좌측 패널 기본 선택과 같은 값이다.
|
|
terrain_type: str = Field(default="special", description="지형 구분 (normal/special)")
|
|
# 설계속도(km/h) — 법정 종단 기준을 정하는 축이다. 임도는 속도를 낼 수 없어 20이
|
|
# 기본이며, 간선·산불진화만 30·40을 고를 수 있다(2026-08-19 사용자 확정).
|
|
# 미지정(None)이면 종류별 기본 설계속도(grade_to_design_speed)를 쓴다.
|
|
design_speed_kph: int | None = Field(default=None, description="설계속도 (20/30/40)")
|
|
main_direction: str = Field(
|
|
default="auto", description="주 진행방향 (auto/ascending/descending/none)"
|
|
)
|
|
max_grade_pct: float | None = Field(default=None, gt=0)
|
|
min_vertical_radius_m: float | None = Field(default=None, gt=0)
|
|
min_tangent_length_m: float | None = Field(default=None, gt=0)
|
|
balance_segment_length_m: float | None = Field(default=None, gt=0)
|
|
start_elevation_offset_m: float | None = None
|
|
end_elevation_offset_m: float | None = None
|
|
# 횡단배수 최소고 강제 여부(2026-09-01 사용자 지시). 기본 해제 — 켜면 계획선이 배관
|
|
# 자리에서 시설 여유만큼 들리고, 그 아래로 내리는 편집도 화면에서 막힌다.
|
|
enforce_pipe_clearance: bool | None = Field(
|
|
default=None, description="횡단배수 최소 계획고 강제 (기본 해제)"
|
|
)
|
|
|
|
@model_validator(mode="after")
|
|
def validate_choices(self) -> "RouteSolveRequest":
|
|
if self.grade_class not in ROUTE_GRADE_CLASSES:
|
|
raise ValueError(f"임도 등급은 {ROUTE_GRADE_CLASSES} 중 하나여야 합니다.")
|
|
if self.algorithm not in ("dijkstra", "ridge_valley"):
|
|
raise ValueError("경로 알고리즘은 dijkstra 또는 ridge_valley여야 합니다.")
|
|
if self.design_speed_kph is not None and self.design_speed_kph not in (20, 30, 40):
|
|
raise ValueError("설계속도는 20/30/40 중 하나여야 합니다.")
|
|
if self.terrain_type not in GRADE_TERRAIN_TYPES:
|
|
raise ValueError(f"지형 구분은 {GRADE_TERRAIN_TYPES} 중 하나여야 합니다.")
|
|
if self.main_direction not in GRADE_MAIN_DIRECTIONS:
|
|
raise ValueError(f"주 진행방향은 {GRADE_MAIN_DIRECTIONS} 중 하나여야 합니다.")
|
|
# 화면·DB에 남아 있던 비율 표기를 퍼센트로 맞춰 이후 단계를 단일 단위로 만든다.
|
|
for field_name in GRADE_PERCENT_FIELDS:
|
|
setattr(self, field_name, normalize_grade_percent(getattr(self, field_name)))
|
|
return self
|
|
|
|
def grade_options(self) -> dict[str, Any]:
|
|
"""계획선 엔진에 넘길 요청 측 재정의 값(사용자가 비우면 None)."""
|
|
return {
|
|
"max_grade_pct": self.max_grade_pct,
|
|
"min_vertical_radius_m": self.min_vertical_radius_m,
|
|
"min_tangent_length_m": self.min_tangent_length_m,
|
|
"balance_segment_length_m": self.balance_segment_length_m,
|
|
"start_elevation_offset_m": self.start_elevation_offset_m,
|
|
"end_elevation_offset_m": self.end_elevation_offset_m,
|
|
"enforce_pipe_clearance": self.enforce_pipe_clearance,
|
|
}
|
|
|
|
def points_data(self) -> dict[str, Any]:
|
|
return {
|
|
"bp": self.bp.model_dump(),
|
|
"ep": self.ep.model_dump(),
|
|
"cp": [p.model_dump() for p in self.cp],
|
|
"ap": [p.model_dump() for p in self.ap],
|
|
"fp": [p.model_dump() for p in self.fp],
|
|
}
|
|
|
|
def options(self) -> dict[str, Any]:
|
|
return {
|
|
"grade_class": self.grade_class,
|
|
"paved": self.paved,
|
|
"terrain_type": self.terrain_type,
|
|
"design_speed_kph": self.design_speed_kph,
|
|
"main_direction": self.main_direction,
|
|
"min_curve_radius_m": self.min_curve_radius_m,
|
|
"max_uphill_grade": self.max_uphill_grade,
|
|
"max_downhill_grade": self.max_downhill_grade,
|
|
"min_uphill_grade": self.min_uphill_grade,
|
|
"min_downhill_grade": self.min_downhill_grade,
|
|
"weights": self.weights,
|
|
"allow_avoid_pass_through": self.allow_avoid_pass_through,
|
|
}
|
|
|
|
|
|
class ContourIntervalUpdateRequest(BaseModel):
|
|
"""등고선 간격 재적용 영속화 요청."""
|
|
|
|
model_config = ConfigDict(extra="forbid")
|
|
|
|
contour_interval_m: float = Field(gt=0)
|
|
|
|
|
|
class ContourIntervalUpdateResponse(BaseModel):
|
|
"""등고선 간격 영속화 결과."""
|
|
|
|
status: str = "success"
|
|
project_id: str
|
|
contour_interval_m: float
|
|
|
|
|
|
class ProfileAlignmentSaveRequest(BaseModel):
|
|
"""종단 계획선 사용자 편집 저장 요청.
|
|
|
|
화면은 편집 결과를 즉시 계산해 보여주고, 확정 시점에 **편집 델타만** 보낸다.
|
|
서버가 저장된 자동 선형(base_pvi)에 델타를 다시 얹어 정본을 만들기 때문에
|
|
표고 전체를 주고받지 않아도 되고, 키를 지우면 자동 선형으로 원복된다.
|
|
"""
|
|
|
|
model_config = ConfigDict(extra="forbid")
|
|
|
|
route_id: int = Field(gt=0)
|
|
# {chainage 문자열(소수 3자리): 자동 선형 대비 계획고 델타(m)}
|
|
station_offsets: dict[str, float] = Field(default_factory=dict)
|
|
# {chainage 문자열(소수 3자리): 종단곡선 반경(m)}. 길이 L은 R × |대수차| 로 파생된다.
|
|
curve_radii: dict[str, float] = Field(default_factory=dict)
|
|
|
|
@model_validator(mode="after")
|
|
def validate_edits(self) -> "ProfileAlignmentSaveRequest":
|
|
for chainage, radius in self.curve_radii.items():
|
|
if radius <= 0:
|
|
raise ValueError(f"종단곡선 반경은 0보다 커야 합니다 (chainage {chainage}).")
|
|
return self
|
|
|
|
def edits(self) -> dict[str, Any]:
|
|
return {"station_offsets": self.station_offsets, "curve_radii": self.curve_radii}
|
|
|
|
|
|
class ProfileAlignmentSaveResponse(BaseModel):
|
|
"""계획선 편집 저장 결과 (재계산된 정본 선형을 그대로 돌려준다)."""
|
|
|
|
status: str = "success"
|
|
project_id: str
|
|
route_id: int
|
|
profile_alignment: dict[str, Any]
|
|
grade_summary: dict[str, Any] | None = None
|
|
|
|
|
|
class RouteSolveResponse(BaseModel):
|
|
"""경로 탐색 실행 결과."""
|
|
|
|
status: str = "success"
|
|
project_id: str
|
|
route_id: int
|
|
total_length_m: float
|
|
metrics: dict[str, Any]
|
|
required_points_ok: bool
|
|
route_data_path: str
|
|
# 종횡단 생성 실패 시 None (경로 자체는 저장됨)
|
|
longitudinal_length_m: float | None = None
|
|
cross_section_count: int | None = None
|
|
# 계획선 산출 실패 시 None (종횡단·경로는 저장됨)
|
|
grade_summary: dict[str, Any] | None = None
|
|
|
|
|
|
class IrregularStationInput(BaseModel):
|
|
"""비정규 측점(구조물). 규칙 격자 밖 chainage 위치에 구조물 정보를 담는다."""
|
|
|
|
model_config = ConfigDict(extra="forbid")
|
|
|
|
chainage_m: float = Field(ge=0)
|
|
structure: str = Field(default="")
|
|
|
|
|
|
class UphillSideOverride(BaseModel):
|
|
"""측점 상단측(=측구 방향) 사용자 변경값. 3D 원형 램프 클릭으로 지정된다."""
|
|
|
|
model_config = ConfigDict(extra="forbid")
|
|
|
|
chainage_m: float = Field(ge=0)
|
|
side: Literal["left", "right"]
|
|
|
|
|
|
class RouteConfirmRequest(BaseModel):
|
|
"""경로 확정 요청.
|
|
|
|
확정 시 비정규 측점의 **횡단을 함께 생성**하기 위해, 지표 샘플러 재구성에 필요한 값
|
|
(solve 때 쓰던 필터/방법/모델)을 함께 받는다. 비정규 측점이 없으면 재생성 없이 확정만 한다.
|
|
모든 필드가 선택이라 빈 본문(`{}`)이면 기존 확정 동작과 동일하다.
|
|
"""
|
|
|
|
model_config = ConfigDict(extra="forbid")
|
|
|
|
filter_key: str | None = None
|
|
method: str | None = None
|
|
smooth: bool = False
|
|
surface_model_id: int | None = None
|
|
irregular_stations: list[IrregularStationInput] = Field(default_factory=list)
|
|
# 측점 상단측(측구 방향) 사용자 변경분 — solve 자동 판정을 확정 시 덮어쓴다.
|
|
uphill_overrides: list[UphillSideOverride] = Field(default_factory=list)
|
|
|
|
def extra_stations(self) -> tuple[tuple[float, str], ...]:
|
|
return tuple((item.chainage_m, item.structure) for item in self.irregular_stations)
|
|
|
|
def can_regenerate(self) -> bool:
|
|
return bool(
|
|
self.irregular_stations
|
|
and self.filter_key
|
|
and self.method
|
|
and self.surface_model_id is not None
|
|
)
|
|
|
|
|
|
class RouteConfirmResponse(BaseModel):
|
|
"""경로 확정 결과."""
|
|
|
|
status: str = "success"
|
|
project_id: str
|
|
route_id: int
|
|
confirmed: bool = True
|
|
|
|
|
|
class RouteLatestResponse(BaseModel):
|
|
"""새로고침 복원을 위한 최신 경로·입력·통계 응답."""
|
|
|
|
status: str = "success"
|
|
project_id: str
|
|
route: dict[str, Any] | None = None
|
|
route_points: list[dict[str, Any]] = Field(default_factory=list)
|
|
surface_params: dict[str, Any]
|
|
route_params: dict[str, Any] | None = None
|