Aislo/B07_DesignDetail/B07_DesignDetail_Schema.py

"""B07 상세 설계 도면 목록·단건 응답 모델."""

from typing import Any, Literal

from pydantic import BaseModel, Field


class DesignDrawingItem(BaseModel):
    """B06 확정 산출물에서 노출하는 도면 메타데이터."""

    id: str
    # blank: 아직 내용을 만들지 않은 도면 — 도각만 실어 연다(2026-09-01 사용자 지시).
    kind: Literal[
        "cover",
        "longitudinal",
        "cross",
        "mass_haul",
        "watershed",
        "plan",
        "landuse",
        "cross_standard",
        # 구조물 도면(376) — B05 · B06 배치에 연결된 구조물 조합 도면.
        "structure",
        "development",  # 전개도(요구 241 · 377)
        "blank",
    ]
    label: str
    chainage_m: float | None = None
    confirmed: bool = False
    # 계획평면도만 — 그 도면의 종류 id · 이름(PLAN 60장). 화면이 종류별로 묶는다.
    plan_kind: str | None = None
    plan_kind_name: str | None = None
    # 입력 지문(508-3b) — 같으면 같은 그림 · 횡단 장은 측점마다(`_Router_Support_Fingerprint`)
    fingerprint: str | None = None
    stations: dict[str, str] | None = None


class DesignDrawingListResponse(BaseModel):
    """B07 진입 시 캐시할 경량 도면 목록."""

    status: str = "success"
    project_id: str
    route_id: int
    drawings: list[DesignDrawingItem]
    #: 확정을 건너뛰고 개발 우회로로 열렸나. **조용히 열지 않기 위해** 응답에 싣는다 —
    #: 그냥 열면 다음 사람이 「왜 값이 없나」로 헤맨다(2026-09-09).
    dev_bypass: bool = False


class DesignDrawingResponse(BaseModel):
    """openwebcad 브리지로 전달할 단일 CAD 도면."""

    status: str = "success"
    project_id: str
    route_id: int
    id: str
    # blank: 아직 내용을 만들지 않은 도면 — 도각만 실어 연다(2026-09-01 사용자 지시).
    kind: Literal[
        "cover",
        "longitudinal",
        "cross",
        "mass_haul",
        "watershed",
        "plan",
        "landuse",
        "cross_standard",
        # 구조물 도면(376) — B05 · B06 배치에 연결된 구조물 조합 도면.
        "structure",
        "development",  # 전개도(요구 241 · 377)
        "blank",
    ]
    label: str
    drawing: dict[str, Any]
    confirmed: bool = False
    # 횡단도 편집용 수량 산출표 값 (미산정 항목은 null). 종단도는 None.
    quantity_table: dict[str, float | None] | None = None
    # CAD 가이드 선(169-1) — {area: [x0, y0, x1, y1] 도면 좌표, marks: 넘친 칸[]} · 저장 · 인쇄 안 됨
    guide: dict[str, Any] | None = None
    # B06에서 지정한 잠정 설계(지반유형·단면유형·절성토 단면적). 횡단도만, 없으면 None.
    design: dict[str, Any] | None = None


class DesignDrawingConfirmRequest(BaseModel):
    """CAD 앱에서 직렬화한 현재 편집 도면."""

    drawing: dict[str, Any]
    # 사용자가 편집한 수량 산출표 값 (횡단도 확정 시 영구 저장).
    quantity_table: dict[str, Any] | None = None


class DesignDrawingConfirmResponse(BaseModel):
    """도면별 확정 및 B07 전체 완료 상태."""

    status: str = "success"
    project_id: str
    id: str
    confirmed: bool
    all_confirmed: bool
    # 횡단도 확정 시 저장된 설계(상태만 status=confirmed). 종단도·장·설계 없음이면 None.
    design: dict[str, Any] | None = None


class DesignDrawingInvalidateResponse(BaseModel):
    """확정 도면 변경에 따른 상태 롤백 결과."""

    status: str = "success"
    project_id: str
    id: str
    confirmed: bool = False


class FrameTemplateResponse(BaseModel):
    """도각 편집 화면이 실을 도각 한 장(실치수 1:1, 잠금 없는 도면층)."""

    status: str = "success"
    project_id: str
    drawing: dict[str, Any]
    # 회사가 고친 도각을 쓰고 있으면 True, 프로그램 기본 도각이면 False.
    customized: bool = False
    # 자리표에 **보여 줄** 실제 값 (2026-09-06 사용자 지시) — 편집 화면 전용이고
    # 저장값은 `{{키}}` 토큰 그대로다. 값이 없는 자리는 담기지 않는다.
    fields: dict[str, str] = {}


class FrameTemplateImportResponse(BaseModel):
    """외부 도각 파일(DXF·DWG)을 읽어 편집 화면에 실을 도면으로 바꾼 결과."""

    status: str = "success"
    project_id: str
    drawing: dict[str, Any]
    entity_count: int


class DrawingExportRequest(BaseModel):
    """캐드 화면의 도면을 DXF·DWG 파일로 내보내는 요청 (2026-09-06 사용자 지시)."""

    drawing: dict[str, Any]
    file_format: str = Field(default="dxf", pattern="^(dxf|dwg)$")
    # 내려받을 파일 이름(확장자 제외). 비우면 도면 id 를 쓴다.
    name: str | None = Field(default=None, max_length=120)


class FrameTemplateSaveRequest(BaseModel):
    """도각 편집 화면이 [완료]에서 넘기는 도각."""

    drawing: dict[str, Any]


class FrameTemplateSaveResponse(BaseModel):
    """프로젝트 도각 저장 결과."""

    status: str = "success"
    project_id: str
    customized: bool = True