Aislo/B07_DesignDetail/B07_DesignDetail_Engine_Template.py

"""B07 도각 템플릿 병합 — openwebcad JSON 템플릿을 도면 콘텐츠 둘레에 배치한다.

resources/template_2dDrawing/의 사전 변환 템플릿(A1 도각 등)을 로드해,
도면 콘텐츠 bbox에 맞춰 균등 스케일·이동시킨 뒤 잠금 프레임 레이어
(b08-frame) 엔티티로 병합한다. 콘텐츠 좌표(m)는 건드리지 않는다 —
템플릿 쪽을 확대해 콘텐츠를 감싼다.

A1 템플릿 기하(변환 시점 고정값): 전체 840x594, 하단 y17~47 표제란,
내부 작도 영역 (42, 47) ~ (812, 567).
"""

import json
import logging
import re
from contextvars import ContextVar
from functools import lru_cache
from pathlib import Path
from typing import Any
from uuid import uuid5

from B07_DesignDetail.B07_DesignDetail_Engine_Cad import (
    _ENTITY_NS,
    DRAWING_FORMAT,
    FRAME_LAYER_ID,
)

_TEMPLATE_DIR = Path(__file__).resolve().parent.parent / "resources" / "template_2dDrawing"

logger = logging.getLogger(__name__)

A1_TEMPLATE = "00_template_A1"
COMPASS_TEMPLATE = "00_template_compass"  # 유역도 등 평면 도면의 방위표
# A1 내부 작도 영역(템플릿 좌표) — 콘텐츠가 이 영역 중앙에 오도록 배치한다.
_A1_INNER = (42.0, 47.0, 812.0, 567.0)
# 내부 작도 영역 대비 콘텐츠 여백 비율(각 방향). 5%는 도각 안쪽에 70mm 가까이를
# 비워 횡단 장이 한 장 더 늘었다 — 2%로 줄여 작도 영역을 쓴다(2026-08-30 사용자).
_CONTENT_MARGIN = 0.02

# 회사가 자기 도각을 두는 자리 — `storage/{회사}/templates/`. 프로그램 기본 도각
# (`resources/template_2dDrawing/`)은 **읽기 전용**이고, 고객이 고친 도각은 여기 쌓인다
# (2026-09-01 사용자 확정: "정본은 그냥 두고 수정하는 기능").
COMPANY_TEMPLATE_SUBDIR = "templates"

# 이 요청이 읽을 회사 도각 폴더. 라우터가 요청마다 세운다 — 엔진 6개(종단·횡단장·
# 토적도·유역도·표지·공용)의 서명을 줄줄이 고치지 않으려고 문맥 변수를 쓴다.
# `asyncio.to_thread`가 문맥을 복사하므로 스레드로 넘어간 작도에도 그대로 따라간다.
_company_dir: ContextVar[Path | None] = ContextVar("b07_company_template_dir", default=None)


def use_company_templates(company_dir: Path | None) -> None:
    """이 요청이 읽을 회사 도각 폴더를 정한다. None이면 프로그램 기본 도각."""
    _company_dir.set(company_dir)


# 이 요청이 도각 표제란에 채울 값. 회사 도각 폴더와 같은 이유로 문맥 변수다 —
# 엔진 6개의 서명을 줄줄이 고치지 않는다. 값을 못 구한 자리는 **빈칸**으로 남는다.
_title_fields: ContextVar[dict[str, str]] = ContextVar("b07_title_fields", default={})


def use_title_fields(fields: dict[str, str] | None) -> None:
    """이 요청이 도각 표제란에 채울 값을 정한다. None이면 표제란이 전부 빈칸이다."""
    _title_fields.set(fields or {})


def add_title_fields(extra: dict[str, str]) -> None:
    """이미 세운 표제란 값에 몇 개를 덧붙인다.

    도면번호처럼 **도면을 읽는 도중에야 아는 값**을 위해서다. 라우터가 DB 값을 먼저 세우고,
    작도 스레드가 여기서 나머지를 얹는다(`asyncio.to_thread` 가 문맥을 복사한다).
    """
    _title_fields.set({**_title_fields.get(), **(extra or {})})


def company_template_path(company_dir: Path, name: str = A1_TEMPLATE) -> Path:
    """회사 도각 파일 경로(없을 수도 있다)."""
    return Path(company_dir) / COMPANY_TEMPLATE_SUBDIR / f"{name}.json"


@lru_cache(maxsize=16)
def _read_template(path_str: str, mtime_ns: int) -> dict[str, Any]:
    """파일 하나를 읽어 캐시한다. 수정 시각이 캐시 키라 저장 즉시 새 도각이 나간다."""
    return json.loads(Path(path_str).read_text(encoding="utf-8"))


def _load_template(name: str) -> dict[str, Any] | None:
    """회사 도각이 있으면 그것, 없으면 프로그램 기본 도각."""
    company_dir = _company_dir.get()
    if company_dir is not None:
        override = company_template_path(company_dir, name)
        if override.is_file():
            return _read_template(str(override), override.stat().st_mtime_ns)
    path = _TEMPLATE_DIR / f"{name}.json"
    if not path.is_file():
        return None
    return _read_template(str(path), path.stat().st_mtime_ns)


def template_entities(name: str = A1_TEMPLATE) -> list[dict[str, Any]]:
    """도각 원본 엔티티(실치수 1:1). 편집 화면이 그대로 싣고, 저장도 이 좌표계로 받는다."""
    template = _load_template(name)
    return list(template.get("entities", [])) if template else []


def frame_template_document(name: str = A1_TEMPLATE) -> dict[str, Any]:
    """도각 편집 화면이 그대로 싣는 도면 — 실치수 1:1, 잠금 없는 도각 층 하나.

    1:1이라 편집 캔버스 좌표가 곧 템플릿 좌표다. 저장할 때 되돌릴 변환이 없다.
    """
    return {
        "format": DRAWING_FORMAT,
        "entities": [{**entity, "layerId": FRAME_LAYER_ID} for entity in template_entities(name)],
        "layers": [{"id": FRAME_LAYER_ID, "name": "도각", "isVisible": True, "isLocked": False}],
    }


def validate_template_entities(entities: list[dict[str, Any]]) -> None:
    """도면 조립이 실제로 쓰는 좌표가 숫자인지 본다. 어긋나면 ValueError.

    검사 없이 받으면 좌표가 빠진 도형 하나로 **이후 모든 도면 요청이 500**이 되고
    되돌릴 길이 없다(2026-09-01 지적). 여기서 막으면 편집 화면에 400으로 돌아간다.
    `_transform_entity`·`entities_bbox`가 읽는 키만 본다 — 그 밖은 그대로 통과시킨다.
    """

    def _check(entity: Any, where: str) -> None:
        if not isinstance(entity, dict):
            raise ValueError(f"도각 도형이 올바르지 않습니다 ({where}).")
        shape = entity.get("shapeData")
        if isinstance(shape, dict):
            for key in ("startPoint", "endPoint", "basePoint", "point", "center"):
                point = shape.get(key)
                if point is None:
                    continue
                if not isinstance(point, dict) or not all(
                    isinstance(point.get(axis), (int, float)) for axis in ("x", "y")
                ):
                    raise ValueError(f"도각 도형의 {key} 좌표가 숫자가 아닙니다 ({where}).")
            if "radius" in shape and not isinstance(shape["radius"], (int, float)):
                raise ValueError(f"도각 도형의 반지름이 숫자가 아닙니다 ({where}).")
        children = entity.get("children")
        if isinstance(children, list):
            for index, child in enumerate(children):
                _check(child, f"{where}:{index}")

    for index, entity in enumerate(entities):
        _check(entity, f"#{index}")


def clear_company_template(company_dir: Path, name: str = A1_TEMPLATE) -> bool:
    """회사 도각을 지워 프로그램 기본 도각으로 되돌린다. 지울 것이 없으면 False."""
    path = company_template_path(company_dir, name)
    if not path.is_file():
        return False
    path.unlink()
    return True


def save_company_template(
    company_dir: Path, entities: list[dict[str, Any]], name: str = A1_TEMPLATE
) -> Path:
    """편집한 도각을 회사 도각 파일로 저장한다. 프로그램 기본 도각은 건드리지 않는다."""
    validate_template_entities(entities)
    path = company_template_path(company_dir, name)
    path.parent.mkdir(parents=True, exist_ok=True)
    document = {
        "format": DRAWING_FORMAT,
        "source": "B07 도각 편집 화면",
        # 도각은 도면마다 잠금 층 하나로 붙으므로 편집 중 새로 만든 층은 도각으로 모은다.
        "entities": [{**entity, "layerId": FRAME_LAYER_ID} for entity in entities],
        "layers": [{"id": FRAME_LAYER_ID, "name": "도각", "isVisible": True, "isLocked": False}],
    }
    temporary = path.with_suffix(".tmp")
    temporary.write_text(json.dumps(document, ensure_ascii=False, indent=2), encoding="utf-8")
    temporary.replace(path)
    return path


def entities_bbox(entities: list[dict[str, Any]]) -> tuple[float, float, float, float] | None:
    """엔티티 목록의 (min_x, min_y, max_x, max_y). 좌표가 없으면 None."""
    xs: list[float] = []
    ys: list[float] = []

    def _collect(entity: dict[str, Any]) -> None:
        shape = entity.get("shapeData") or {}
        for key in ("startPoint", "endPoint", "basePoint", "point"):
            p = shape.get(key)
            if isinstance(p, dict):
                xs.append(float(p["x"]))
                ys.append(float(p["y"]))
        center = shape.get("center")
        if isinstance(center, dict):
            r = float(shape.get("radius", 0.0))
            xs.extend((float(center["x"]) - r, float(center["x"]) + r))
            ys.extend((float(center["y"]) - r, float(center["y"]) + r))
        for child in entity.get("children") or []:
            _collect(child)

    for entity in entities:
        _collect(entity)
    if not xs:
        return None
    return (min(xs), min(ys), max(xs), max(ys))


def _transform_entity(
    entity: dict[str, Any], seed: str, scale: float, dx: float, dy: float
) -> dict[str, Any]:
    """템플릿 엔티티를 스케일+이동 복사한다. id는 도면별 결정적 재생성."""
    out = dict(entity)
    out["id"] = str(uuid5(_ENTITY_NS, seed))
    out["layerId"] = FRAME_LAYER_ID
    shape = entity.get("shapeData")
    if isinstance(shape, dict):
        new_shape = dict(shape)
        for key in ("startPoint", "endPoint", "basePoint", "point", "center"):
            p = shape.get(key)
            if isinstance(p, dict):
                new_shape[key] = {"x": p["x"] * scale + dx, "y": p["y"] * scale + dy}
        # 꼭짓점 배열을 쓰는 엔티티(Image 로고·서명, Hatch 띠)도 함께 옮긴다.
        points = shape.get("points")
        if isinstance(points, list):
            new_shape["points"] = [
                {"x": point["x"] * scale + dx, "y": point["y"] * scale + dy}
                for point in points
                if isinstance(point, dict)
            ]
        if "radius" in shape:
            new_shape["radius"] = shape["radius"] * scale
        options = shape.get("options")
        if isinstance(options, dict):
            new_options = dict(options)
            new_options["fontSize"] = options.get("fontSize", 4.0) * scale
            new_shape["options"] = new_options
        out["shapeData"] = new_shape
    children = entity.get("children")
    if isinstance(children, list):
        out["children"] = [
            _transform_entity(child, f"{seed}:{index}", scale, dx, dy)
            for index, child in enumerate(children)
        ]
    return out


def compass_entities(
    drawing_id: str,
    center: tuple[float, float],
    size_mm: float,
    template_name: str = COMPASS_TEMPLATE,
) -> list[dict[str, Any]]:
    """방위표 템플릿을 지정 위치에 지정 크기로 놓는다(잠금 프레임 레이어).

    도각과 달리 콘텐츠를 감쌀 일이 없으므로 긴 변이 size_mm가 되도록 균등 축소한다.
    """
    template = _load_template(template_name)
    if not template:
        return []
    entities = template.get("entities", [])
    bbox = entities_bbox(entities)
    if not bbox:
        return []
    min_x, min_y, max_x, max_y = bbox
    span = max(max_x - min_x, max_y - min_y, 1e-6)
    scale = size_mm / span
    dx = center[0] - (min_x + max_x) / 2.0 * scale
    dy = center[1] - (min_y + max_y) / 2.0 * scale
    return [
        _transform_entity(entity, f"{drawing_id}:compass:{index}", scale, dx, dy)
        for index, entity in enumerate(entities)
    ]


def usable_bbox() -> tuple[float, float, float, float]:
    """작도 영역 한가운데에 놓인 **수용 한도 크기**의 빈 bbox.

    담을 내용이 없는 도면(빈 도면)이 도각만 두를 때 쓴다. `_A1_INNER`를 그대로 넘기면
    여백을 뺀 한도(`usable_area()`)보다 커서 "작도 영역을 넘습니다" 경고가 뜬다 —
    내용이 없는데 넘칠 리 없다. 중심이 같으므로 도각 배치(이동량 0)는 그대로다.
    """
    ix0, iy0, ix1, iy1 = _A1_INNER
    width, height = usable_area()
    cx, cy = (ix0 + ix1) / 2.0, (iy0 + iy1) / 2.0
    return (cx - width / 2.0, cy - height / 2.0, cx + width / 2.0, cy + height / 2.0)


def usable_area() -> tuple[float, float]:
    """A1 내부 작도 영역에서 여백을 뺀 유효 크기(mm). 척도 고정 도면의 수용 한도."""
    ix0, iy0, ix1, iy1 = _A1_INNER
    return (
        (ix1 - ix0) * (1.0 - 2.0 * _CONTENT_MARGIN),
        (iy1 - iy0) * (1.0 - 2.0 * _CONTENT_MARGIN),
    )


_PLACEHOLDER = re.compile(r"\{\{\s*([^}]+?)\s*\}\}")


def _fill_placeholders(
    entities: list[dict[str, Any]], fields: dict[str, str]
) -> list[dict[str, Any]]:
    """도각의 {{키}}를 값으로 바꾼 엔티티 목록을 낸다. 값이 없으면 빈칸 — 남의 값이 남지 않는다.

    요청 문맥의 표제란 값(`use_title_fields`)이 바탕이고, 인자로 준 값(도면마다 다른
    도면명 등)이 위에 얹힌다. 합치는 자리를 **치환 함수 한 곳**에 둬야 도각을 두르지
    않는 표지처럼 다른 경로로 들어온 도면도 같은 값을 받는다(2026-09-02 표지 누락).
    """
    fields = {**_title_fields.get(), **(fields or {})}

    def substitute(text: str) -> str:
        return _PLACEHOLDER.sub(lambda match: str(fields.get(match.group(1), "")), text)

    for entity in entities:
        shape = entity.get("shapeData") or {}
        # 글자 자리
        label = shape.get("label")
        if entity.get("type") == "Text" and isinstance(label, str) and "{{" in label:
            shape["label"] = substitute(label)
        # 그림 자리(회사 로고·개인 서명) — 값은 data URL. 못 구하면 그림을 통째로
        # 빼서 빈 칸으로 둔다(빈 문자열을 남기면 CAD가 깨진 그림으로 그린다).
        image = shape.get("imageData")
        if entity.get("type") == "Image" and isinstance(image, str) and "{{" in image:
            shape["imageData"] = substitute(image)
    # 그림을 못 구한 자리는 엔티티째 뺀다 — 빈 문자열을 남기면 CAD가 깨진 그림을 그린다.
    return [
        entity
        for entity in entities
        if entity.get("type") != "Image" or (entity.get("shapeData") or {}).get("imageData")
    ]


def scale_fields(*denominators: tuple[str, int]) -> dict[str, str]:
    """축척 칸(`{{축척_A1}}`·`{{축척_A3}}`)에 넣을 값.

    도각이 `A1 = 1 :` 를 이미 찍으므로 **분모만** 낸다. A3 는 A1 도면을 절반으로 뽑는
    종이라 분모가 2배다. 가로·세로 축척이 다른 도면(종단·토적)은 이름표를 붙여 함께 적는다.
    값은 `config_system` 의 축척 상수에서 오며 여기서 새로 정하지 않는다.
    """

    def text(factor: int) -> str:
        return " · ".join(
            f"{denominator * factor}({name})" if name else str(denominator * factor)
            for name, denominator in denominators
        )

    return {"축척_A1": text(1), "축척_A3": text(2)}


def frame_entities(
    drawing_id: str,
    content_bbox: tuple[float, float, float, float],
    template_name: str = A1_TEMPLATE,
    fit: bool = True,
    fields: dict[str, str] | None = None,
) -> list[dict[str, Any]]:
    """콘텐츠 bbox를 감싸는 도각 프레임 엔티티 목록(잠금 레이어). 템플릿 없으면 빈 목록.

    fit=False면 도각을 **실치수(1:1)** 로 두고 위치만 맞춘다 — 콘텐츠가 이미 종이
    밀리미터로 그려진 척도 고정 도면(종단·횡단)용. fit=True는 척도가 없는 도면을
    도각에 맞춰 늘리던 기존 동작이다.
    """
    template = _load_template(template_name)
    if not template:
        return []
    min_x, min_y, max_x, max_y = content_bbox
    content_w = max(max_x - min_x, 1e-6)
    content_h = max(max_y - min_y, 1e-6)

    ix0, iy0, ix1, iy1 = _A1_INNER
    usable_w, usable_h = usable_area()
    scale = max(content_w / usable_w, content_h / usable_h) if fit else 1.0
    # 한도와 **같은** 크기는 넘친 것이 아니다 — 부동소수 오차만큼의 여유를 둔다
    # (수용 한도를 그대로 넘기는 빈 도면이 마지막 자리 오차로 경고를 냈다).
    if not fit and (content_w > usable_w + 1e-6 or content_h > usable_h + 1e-6):
        logger.warning(
            "도면 콘텐츠가 A1 작도 영역을 넘습니다: %s (%.0fx%.0f mm > %.0fx%.0f mm)",
            drawing_id,
            content_w,
            content_h,
            usable_w,
            usable_h,
        )

    # 콘텐츠 중심 = 내부 작도 영역 중심이 되도록 이동량 산출.
    dx = (min_x + max_x) / 2.0 - (ix0 + ix1) / 2.0 * scale
    dy = (min_y + max_y) / 2.0 - (iy0 + iy1) / 2.0 * scale

    placed = [
        _transform_entity(entity, f"{drawing_id}:frame:{index}", scale, dx, dy)
        for index, entity in enumerate(template.get("entities", []))
    ]
    return _fill_placeholders(placed, fields or {})