dbx-main/app/modules/cafe24/routes_products.py

"""카페24 상품 화면 — 목록/검색 · 상세설명(HTML) 조회 · 편집 후 즉시 적용.

카페24를 언제나 source of truth 로 본다. 목록도 상세설명도 화면을 열 때마다
API 로 현재값을 읽고, 목록 결과는 `cafe24_products` 캐시에 UPSERT 한다
(예약·로그 화면에서 API 없이 상품명을 보여주기 위한 용도).

상세설명은 상품 리소스의 필드다(`/description` 서브리소스는 존재하지 않는다 —
app/integrations/cafe24/products.py 주석 참고). 목록 응답에는 상세설명이 없어
상품 1건씩 조회해야 하므로, 목록 화면에서는 미리보기를 뿌리지 않는다.

쓰기(`POST /products/{no}/apply`)는 반드시 이 순서를 지킨다.
    카페24 현재값 재조회 → BACKUP 버전 저장 → 지문 대조(충돌 거부) → PUT →
    MANUAL 버전 + 감사로그
로컬 DB 의 마지막 버전을 "지금 카페24에 올라간 값"으로 가정하지 않는다.

이미지 경로의 한글은 카페24에 퍼센트 인코딩으로 저장돼 있다. 편집기에는
`store.decode_html_urls` 로 풀어서 보여주고, 저장할 때 `encode_html_urls` 로
되돌린다(왕복 보존 — store.py 주석 참고).

핸들러는 `async def` 가 아니라 `def`(동기)로 선언한다. 카페24 API·DB 호출이
블로킹이므로 FastAPI 스레드풀에서 돌게 두는 편이 이벤트 루프를 막지 않는다.
"""

from __future__ import annotations

import logging
from typing import Any

from fastapi import APIRouter, Form, Request
from fastapi.responses import HTMLResponse, RedirectResponse

from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, products

from . import store
from .common import base_ctx, guard

logger = logging.getLogger("cafe24.products")

products_router = APIRouter()

# 한 화면에 보여줄 상품 수. 카페24 1회 조회 한도(100)를 넘지 않는다.
PAGE_SIZE = 50


def _page_param(raw: str | None) -> int:
    try:
        return max(1, int(raw or 1))
    except ValueError:
        return 1


def _short_dt(value: Any) -> str:
    """'2026-08-14T11:38:18+09:00' → '2026-08-14 11:38'."""
    text = str(value or "").strip()
    if not text:
        return ""
    return text.replace("T", " ")[:16]


def _row_for_list(raw: dict[str, Any]) -> dict[str, Any]:
    """목록 표에 쓸 필드만 골라낸다(응답 필드가 90개라 그대로 넘기지 않는다)."""
    normalized = products.normalize_product(raw)
    return {
        **normalized,
        "updated_date": _short_dt(raw.get("updated_date")),
        "price": str(raw.get("price") or ""),
    }


@products_router.get("/", response_class=HTMLResponse)
def product_list(request: Request) -> HTMLResponse:
    """상품 목록/검색. 검색어는 상품명 부분일치(카페24 API 가 처리)."""
    from app.main import render_template  # noqa: WPS433

    checked = guard(request)
    if not isinstance(checked, tuple):
        return checked
    st, user = checked

    keyword = (request.query_params.get("q") or "").strip()
    page = _page_param(request.query_params.get("page"))

    api = build_cafe24_api(st)
    rows: list[dict[str, Any]] = []
    total = 0
    error = ""
    try:
        total = products.count_products(api.client, product_name=keyword)
        raw_rows = products.list_products(
            api.client,
            limit=PAGE_SIZE,
            offset=(page - 1) * PAGE_SIZE,
            product_name=keyword,
        )
        rows = [_row_for_list(r) for r in raw_rows]
        st.upsert_products([products.normalize_product(r) for r in raw_rows])
    except Cafe24Error as exc:
        # 미연결/토큰만료/호출제한 모두 여기로 온다. 화면은 살려두고 사유만 알린다.
        error = str(exc)
        logger.warning("카페24 상품 목록 조회 실패: %s", exc)

    last_page = max(1, -(-total // PAGE_SIZE)) if total else 1

    ctx = base_ctx(request, user, active_tab="products")
    ctx.update(
        {
            "page_title": "카페24 상품관리",
            "page_subtitle": "상품 상세페이지 조회·편집·예약",
            "rows": rows,
            "keyword": keyword,
            "page": page,
            "last_page": last_page,
            "total": total,
            "error": error,
        }
    )
    return render_template(request, "cafe24/products.html", ctx)


@products_router.get("/products/{product_no}", response_class=HTMLResponse)
def product_detail(request: Request, product_no: int) -> HTMLResponse:
    """상품 1건 — 기본정보 + 카페24에 지금 올라가 있는 상세설명 HTML."""
    from app.main import render_template  # noqa: WPS433

    checked = guard(request)
    if not isinstance(checked, tuple):
        return checked
    st, user = checked

    api = build_cafe24_api(st)
    product: dict[str, Any] = {}
    desc = None
    error = ""
    try:
        product = products.get_product(api.client, product_no)
        desc = products.descriptions_from_product(product)
        st.upsert_products([products.normalize_product(product)])
    except Cafe24Error as exc:
        error = str(exc)
        logger.warning("카페24 상품 %s 조회 실패: %s", product_no, exc)

    info = products.normalize_product(product) if product else {}
    ctx = base_ctx(request, user, active_tab="products")
    ctx.update(
        {
            "page_title": f"카페24 상품 {product_no}",
            "page_subtitle": product.get("product_name") or "상품 상세페이지",
            "product_no": product_no,
            "info": {
                **info,
                "price": str(product.get("price") or ""),
                "updated_date": _short_dt(product.get("updated_date")),
                "summary_description": product.get("summary_description") or "",
            },
            "desc": desc,
            # 편집기에는 이미지 경로의 %EC%9A%A9… 을 한글로 풀어서 보여준다.
            # 저장할 때 다시 인코딩하므로 카페24에 저장되는 값은 그대로다.
            "html_pc": store.decode_html_urls(desc.description) if desc else "",
            "html_mobile": store.decode_html_urls(desc.mobile_description) if desc else "",
            # 지문은 **인코딩된 원본**으로 만든다(적용 직전 카페24 값과 비교하므로).
            "fingerprint": store.fingerprint(desc.description) if desc else "",
            "revisions": st.list_revisions(product_no, limit=20),
            "error": error,
            "flash": request.query_params.get("msg", ""),
            "flash_error": request.query_params.get("err", ""),
        }
    )
    return render_template(request, "cafe24/product.html", ctx)


@products_router.post("/products/{product_no}/apply")
def product_apply(
    request: Request,
    product_no: int,
    html: str = Form(""),
    base_fingerprint: str = Form(""),
    memo: str = Form(""),
):
    """편집한 HTML 을 카페24에 즉시 적용한다.

    순서를 지키는 것이 이 함수의 핵심이다.
      1) 카페24에서 **현재** HTML 을 다시 읽는다(로컬 값을 현재값으로 믿지 않는다)
      2) 그 값으로 BACKUP 버전을 남긴다 ← 유일한 복구 수단
      3) 편집 시작 시점의 지문과 비교해 충돌이면 거부한다
      4) 쓰고, MANUAL 버전과 감사로그를 남긴다

    PC/모바일 미분리 상품은 모바일 필드도 같은 HTML 로 맞춘다. 분리 상품은
    모바일을 건드리지 않는다(화면에 별도 반영 안내를 띄운다).
    """
    checked = guard(request)
    if not isinstance(checked, tuple):
        return checked
    st, user = checked

    actor = str(user.get("email") or "")
    back = f"/cafe24/products/{product_no}"

    submitted = store.encode_html_urls(html or "")
    if not submitted.strip():
        return RedirectResponse(
            url=f"{back}?err=내용이 비어 있습니다. 상세페이지를 비우려면 카페24 관리자에서 하세요.",
            status_code=303,
        )

    api = build_cafe24_api(st)
    try:
        current = products.fetch_descriptions(api.client, product_no)
    except Cafe24Error as exc:
        st.log_audit(
            actor=actor, action="apply_description", product_no=product_no,
            result="FAIL", detail=f"현재값 조회 실패: {exc}",
        )
        return RedirectResponse(url=f"{back}?err=카페24 현재값을 읽지 못해 중단했습니다: {exc}", status_code=303)

    backup_id = st.add_revision(
        product_no=product_no,
        html_content=current.description,
        revision_type=store.REVISION_BACKUP,
        memo="적용 직전 자동 백업",
        created_by=actor,
    )

    if base_fingerprint and base_fingerprint != store.fingerprint(current.description):
        st.log_audit(
            actor=actor, action="apply_description", product_no=product_no,
            revision_id=backup_id, result="FAIL", detail="충돌 — 편집 중 카페24 값이 변경됨",
        )
        return RedirectResponse(
            url=f"{back}?err=편집하는 동안 카페24 값이 변경되었습니다. 새로고침해 현재 내용을 확인한 뒤 다시 적용하세요.",
            status_code=303,
        )

    if submitted == current.description:
        return RedirectResponse(url=f"{back}?msg=변경된 내용이 없어 적용하지 않았습니다.", status_code=303)

    # 미분리 상품은 모바일도 함께 맞춘다(PC 만 바꾸면 모바일이 어긋난다).
    mobile_html = None if current.separated_mobile else submitted
    try:
        products.update_descriptions(
            api.client, product_no, description=submitted, mobile_description=mobile_html
        )
    except Cafe24Error as exc:
        st.log_audit(
            actor=actor, action="apply_description", product_no=product_no,
            revision_id=backup_id, result="FAIL", detail=str(exc),
        )
        logger.warning("카페24 상품 %s 적용 실패: %s", product_no, exc)
        return RedirectResponse(
            url=f"{back}?err=적용에 실패했습니다: {exc} (직전 내용은 버전 {backup_id} 로 보관됨)",
            status_code=303,
        )

    revision_id = st.add_revision(
        product_no=product_no,
        html_content=submitted,
        revision_type=store.REVISION_MANUAL,
        memo=memo,
        created_by=actor,
    )
    st.log_audit(
        actor=actor, action="apply_description", product_no=product_no,
        revision_id=revision_id, result="SUCCESS",
        detail=f"{len(submitted)}자 적용 (백업 {backup_id}"
               + (", 모바일 동시 반영)" if mobile_html is not None else ")"),
    )
    logger.info("카페24 상품 %s 상세설명 적용 (%s)", product_no, actor)
    return RedirectResponse(
        url=f"{back}?msg=카페24에 적용했습니다. 직전 내용은 버전 {backup_id} 로 보관됩니다.",
        status_code=303,
    )