Aislo/M02_MasterTemplete/M02_MasterTemplete_Options.py

"""M02 구조물 옵션 보이기 — 구조물 종류마다 B05/B06 폼에 보일 옵션을 사용자가 체크.

정본 = `resources/master_template/구조물옵션표시.json` = `{type_id: {option_key: false}}`
— 없는 종류 · 키는 보임(파일이 없어도 모두 보임).
저장은 **숨김(false)만** 남김 — 「모두 보임」 = `{}`.
옵션 정의 · 옛 값은 그대로 — 폼이 그리는 것만 갈림(`GET /api/projects/structure-types` `visible`).
판 = 파일 sha256 앞 16자(`store.version_of`) · 낡은 판으로 쓰면 409.
"""

from __future__ import annotations

import json
import logging
from typing import Any

from pydantic import Field

from B05_Profile.B05_Profile_Structures_Schema import (
    StructureOptionField,
    StructureType,
    StructureTypesResponse,
    load_structure_types,
    registry_schema_version,
)
from common_util.common_util_json import atomic_write_json
from M02_MasterTemplete import M02_MasterTemplete_Store as store

FILE = "구조물옵션표시.json"
logger = logging.getLogger(__name__)


class OptionWithVisible(StructureOptionField):
    """폼 옵션 한 칸 + 보임 여부(서버가 채움)."""

    visible: bool = True


class TypeWithVisible(StructureType):
    options: list[OptionWithVisible] = Field(default_factory=list)


class TypesWithVisible(StructureTypesResponse):
    """`GET /structure-types` 응답 — 옵션마다 `visible` 칸."""

    types: list[TypeWithVisible]


def _load() -> tuple[dict[str, Any], str]:
    """(숨김 표 · 판) — 파일이 없으면 빈 표 · 판 빈 글."""
    path = store.FOLDER / FILE
    if not path.is_file():
        return {}, ""
    raw = path.read_bytes()
    try:
        doc = json.loads(raw)
    except ValueError as e:
        raise store.StoreError(500, f"{FILE} 을 못 읽음 — {e}") from e
    if not isinstance(doc, dict):
        raise store.StoreError(500, f"{FILE} 은 종류별 묶음이어야 함")
    return doc, store.version_of(raw)


def _shown(doc: dict[str, Any], type_id: str, key: str) -> bool:
    row = doc.get(type_id)
    return not (isinstance(row, dict) and row.get(key) is False)


def hidden_keys() -> dict[str, set[str]]:
    """숨긴 옵션(종류 → 키 집합) — 저장 검증이 숨긴 옵션을 필수로 안 침 · 깨진 표는 모두 보임."""
    try:
        doc = _load()[0]
    except store.StoreError as e:
        logger.warning("구조물 옵션 표시 표를 못 읽어 모두 보임으로 봄 — %s", e.detail)
        return {}
    return {
        type_id: {key for key, shown in row.items() if shown is False}
        for type_id, row in doc.items()
        if isinstance(row, dict)
    }


def with_visible() -> TypesWithVisible:
    """레지스트리 정본 + 보임 여부 — 파일이 깨졌으면 모두 보임(폼이 죽지 않게 · 로그만)."""
    try:
        doc = _load()[0]
    except store.StoreError as e:
        logger.warning("구조물 옵션 표시 표를 못 읽어 모두 보임으로 냄 — %s", e.detail)
        doc = {}
    types = [
        {
            **t.model_dump(),
            "options": [
                {**o.model_dump(), "visible": _shown(doc, t.type_id, o.key)} for o in t.options
            ],
        }
        for t in load_structure_types()
    ]
    return TypesWithVisible.model_validate(
        {"schema_version": registry_schema_version(), "types": types}
    )


def listing() -> dict[str, Any]:
    """`{판, 표시, 종류}` — 표시 = 숨긴 것만 · 종류 = 옵션이 있는 종류와 그 옵션."""
    doc, version = _load()
    hidden: dict[str, dict[str, bool]] = {}
    kinds = []
    for t in load_structure_types():
        if not t.options:
            continue
        off = {o.key: False for o in t.options if not _shown(doc, t.type_id, o.key)}
        if off:
            hidden[t.type_id] = off
        kinds.append(
            {
                "type_id": t.type_id,
                "group": t.group,
                "name": t.name,
                "enabled": t.enabled,
                "options": [
                    {"key": o.key, "label": o.label, "phase": o.phase, "required": o.required}
                    for o in t.options
                ],
            }
        )
    return {"판": version, "표시": hidden, "종류": kinds}


def _clean(shown: Any) -> dict[str, dict[str, bool]]:
    """받은 표 검사 → 숨김만 남김. 없는 종류 · 키 · 참거짓 아닌 값은 422."""
    if not isinstance(shown, dict):
        raise store.StoreError(400, "표시는 종류별 묶음이어야 함")
    keys = {t.type_id: {o.key for o in t.options} for t in load_structure_types()}
    errors: list[str] = []
    out: dict[str, dict[str, bool]] = {}
    for type_id, row in shown.items():
        if type_id not in keys:
            errors.append(f"없는 구조물 종류 「{type_id}」")
        elif not isinstance(row, dict):
            errors.append(f"「{type_id}」 는 옵션별 묶음이어야 함")
        else:
            for key, value in row.items():
                if key not in keys[type_id]:
                    errors.append(f"「{type_id}」 에 없는 옵션 「{key}」")
                elif not isinstance(value, bool):
                    errors.append(f"「{type_id}.{key}」 는 참 · 거짓이어야 함")
                elif not value:
                    out.setdefault(type_id, {})[key] = False
    if errors:
        raise store.StoreError(422, {"errors": errors})
    return out


def save(shown: Any, version: str) -> dict[str, Any]:
    """고쳐 씀 — 판이 같을 때만. 돌려주는 것 = 새 `listing()`."""
    fixed = _clean(shown)
    path = store.FOLDER / FILE
    with store._LOCK:
        have = store.version_of(path.read_bytes()) if path.is_file() else ""
        if have != (version or ""):
            raise store.StoreError(409, {"stale": [FILE], "판": have})
        atomic_write_json(path, fixed)
    return listing()