Files
Aislo/B05_Profile/B05_Profile_Structures_Migration.py
T
eomsangdonandClaude Fable 5 50e5626a95 feat(B05): 구조물 타입 레지스트리·정본 CRUD 백엔드 추가
임도 구조물 전체(구조물군 B~G)를 수동 배치할 수 있도록 백엔드 기반을 만든다.
타입 정의를 코드가 아닌 데이터(JSON 레지스트리)로 두어, 구조물 목록이 바뀌어도
코드를 고치지 않고 화면 폼까지 따라오게 했다.

- B05_Profile_Structure_Types.json: 타입 레지스트리 정본 (B~G 32종 + 호환 4종).
  배치형태(point/interval/site)·옵션 스키마·마크 스타일·drawing_views 메타 포함.
- B05_Profile_Structures_Schema.py: 타입·인스턴스 Pydantic 모델.
  배치형태별 위치 필드 배타 검증, side·offset_m·placement_source·status·revision.
- B05_Profile_Structures_Repository.py: structures.json 단일 정본 읽기·쓰기.
  atomic_write_json 재사용, base_revision 불일치 시 충돌 예외,
  설계 영향 변경만 후속 단계를 무효화하도록 판정하는 지문 비교.
- B05_Profile_Structures_Migration.py: 기존 비정규 측점 이관.
  배관은 pipe_points.json 정본이라 제외, 기성막이→기슭막이, 대피로→대피소 통합,
  나머지는 이름을 살려 기타. 같은 입력이면 같은 결과.
- B05_Profile_Structures_Router.py: GET /structure-types, 구조물 목록 조회·저장.
  판번호 충돌 409, 미등록·타 정본 관리 타입 400, 저장 후 B06 이후 STALE 전파.

테스트 45건(tmp/tests) 통과. 기존 배관·배수유역·종단 편집 코드는 건드리지 않았다.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-16 22:19:00 +09:00

84 lines
3.2 KiB
Python

"""기존 비정규 측점 → 구조물 정본 마이그레이션.
기존 화면은 구조물을 4종(배관·기성막이·대피로·기타)으로 받아 왔고, 서버에는 `chainage_m` +
표시 문자열만 남겼다. 신규 레지스트리 타입으로 옮기면서 종류별 의미를 살린다.
- 배관: 옮기지 않는다 — `pipe_points.json`이 정본이다.
- 기성막이 → 기슭막이(`revetment`). 기존 이름이 오기였다 (2026-08-16 사용자 확정).
- 대피로 → 대피소(`refuge`)로 통합. 폭 값은 대피소 너비 옵션으로 옮긴다 (동 확정).
- 그 밖: 이름을 살려 `기타`.
구간형으로 바뀌는 타입(기슭막이·대피소)은 기존 데이터에 종점이 없다. 기점만 알고 있으므로
최소 구간을 임시로 주고, 사용자가 화면에서 종점을 조정한다 — 값을 지어내는 것보다 낫다.
"""
from typing import Any, Iterable
from B05_Profile.B05_Profile_Structures_Schema import StructureInstance, structure_type_map
PIPE_STRUCTURE_NAME = "배관"
# 기존 타입 이름 → 신규 type_id.
LEGACY_TYPE_MAP = {
"기성막이": "revetment",
"대피로": "refuge",
"기타": "etc",
}
# 종점을 모르는 구간형 항목에 주는 임시 길이(m). 화면에서 조정하라는 표시값이다.
DEFAULT_INTERVAL_LENGTH_M = 15.0
def _is_pipe(entry: dict[str, Any]) -> bool:
return (
entry.get("origin") == "pipe"
or entry.get("structureType") == PIPE_STRUCTURE_NAME
or str(entry.get("structure", "")).strip() == PIPE_STRUCTURE_NAME
)
def migrate_irregular_stations(entries: Iterable[dict[str, Any]]) -> list[StructureInstance]:
"""기존 비정규 측점 목록을 구조물 인스턴스로 옮긴다(같은 입력이면 같은 결과)."""
types = structure_type_map()
migrated: list[StructureInstance] = []
seen: set[tuple[str, float]] = set()
for entry in entries:
if _is_pipe(entry):
continue
chainage = float(entry.get("chainage_m", 0.0))
legacy_type = entry.get("structureType")
type_id = LEGACY_TYPE_MAP.get(legacy_type, "etc")
definition = types[type_id]
key = (type_id, round(chainage, 3))
if key in seen:
continue
seen.add(key)
data: dict[str, Any] = {
"type_id": type_id,
"placement": definition.placement,
"side": "center",
"options": _options_for(type_id, entry),
"placement_source": "manual",
}
if definition.placement == "interval":
data["start_m"] = chainage
data["end_m"] = chainage + DEFAULT_INTERVAL_LENGTH_M
data["memo"] = "구 비정규 측점 이관 — 종점 확인 필요"
else:
data["chainage_m"] = chainage
migrated.append(StructureInstance.model_validate(data))
return migrated
def _options_for(type_id: str, entry: dict[str, Any]) -> dict[str, Any]:
if type_id == "refuge":
width = entry.get("escapeWidthM")
return {"width_m": float(width)} if width is not None else {}
if type_id == "etc":
name = entry.get("customName") or entry.get("structure") or "기타 구조물"
return {"name": str(name).strip()}
return {}