fix(B05): 지운 구조물 부활 차단 · 임시저장이 캐시 수정분을 저장하도록

사용자 확정 모델: 초기 계산값은 **원복용으로 그대로 두고**, 사용자가 제어한 수정
1세트가 최종본이다. 여러 세트는 두지 않는다. 두 곳이 이 모델을 어기고 있었다.

① 지운 구조물이 되살아난다 — B05는 그려질 때마다 종단 정본의 비정규 측점을 모아
   `/structures/migrate`를 부른다. 서버의 "멱등" 기준이 **지금 그 자리에 구조물이
   있는가**여서, 사용자가 지우면 자리가 비고 다음 진입에서 같은 구조물이 다시
   생성됐다(진행단계 오버레이로 오가면 매번). 옮긴 자리를 `structures.json`의
   `migrated_legacy`에 **이력으로** 남기고, 이력에 있으면 구조물이 없어도 다시 만들지
   않는다. 원천(비정규 측점)은 원복용으로 손대지 않는다. 이력은 일반 저장 경로에서도
   보존한다 — 사라지면 삭제분이 부활한다.

② 임시저장이 캐시 수정분을 버린다 — B05 [임시저장]이 `cross_patches`를 보내지 않고
   `invalidateSectionDetail`로 공유 캐시를 비웠다. B06에서 만져 캐시에 얹힌 구조물
   조정(4축·다단·연동·표시 반폭)이 영구저장소에 못 가고 사라졌다. 계획선·비정규 측점
   저장 **뒤에** 캐시 수정분을 `saveSections`로 남기고, 그 다음에 캐시를 비운다 —
   순서가 뒤바뀌면 재계산이 사용자 수정을 덮는다.

`saveCachedCrossPatches`·`crossPatchesFromCache`는 공유 캐시 모듈에 뒀다 — B05 페이지
파일이 이미 700줄을 넘겨 더 불리지 않기 위함이다(기존 부채).

tsc/ruff/prettier 통과, pytest 200 passed(기존 실패 1건 유지).
신규 검증: tmp/tests/test_b05_structures_migration_history.py 4건.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-08-24 19:56:40 +09:00
co-authored by Claude Opus 5
parent 38fd7e49e0
commit 0e2309f5ce
4 changed files with 108 additions and 7 deletions
@@ -64,6 +64,24 @@ def load_structures(project_root: str) -> tuple[int, list[StructureInstance]]:
return revision, structures
def load_migrated_legacy(project_root: str) -> set[str]:
"""이미 구조물 정본으로 옮긴 구 비정규 측점의 표식 집합.
원천(종단 정본의 비정규 측점)은 **원복용으로 그대로 둔다**. 대신 "옮겼다"는 이력을
여기 남겨, 사용자가 그 구조물을 지운 뒤 화면에 다시 들어와도 되살아나지 않게 한다
(2026-08-24 사용자 확정: 초기 계산값은 원복용, 사용자 수정 1세트가 최종본).
"""
path = structures_file_path(project_root)
if not os.path.exists(path):
return set()
try:
with open(path, encoding="utf-8") as handle:
payload = json.load(handle)
return {str(key) for key in payload.get("migrated_legacy", [])}
except (OSError, ValueError, TypeError):
return set()
def _without_dropped_keys(item: Any) -> Any:
"""폐지된 필드가 남아 있는 저장분을 지금 스키마로 읽을 수 있게 손질한다."""
if not isinstance(item, dict):
@@ -79,10 +97,13 @@ def save_structures(
*,
base_revision: int,
max_chainage_m: float | None = None,
migrated_legacy: Iterable[str] | None = None,
) -> int:
"""구조물 목록을 정본에 덮어쓰고 새 판번호를 돌려준다.
`max_chainage_m`는 노선 총연장(m) — 주어지면 범위 밖 배치를 거절한다.
`migrated_legacy`는 이번에 옮긴 구 측점 표식 — 기존 이력에 **더해서** 남긴다.
이력은 어느 저장 경로로 덮어써도 사라지면 안 된다(사라지면 지운 구조물이 되살아난다).
"""
items = list(structures)
_validate_types(items)
@@ -98,9 +119,11 @@ def save_structures(
item.structure_id = uuid.uuid4().hex
revision = current_revision + 1
history = load_migrated_legacy(project_root) | set(migrated_legacy or ())
payload = {
"revision": revision,
"structures": [item.model_dump(mode="json") for item in items],
"migrated_legacy": sorted(history),
}
atomic_write_json(structures_file_path(project_root), payload)
return revision