o2o-site-AEO/solution/backend/tests/test_build_publish.py

"""정적 빌드 + 발행 — 상호명에서 발행까지 한 바퀴.

★ 이 경로가 절대 하면 안 되는 것:
   - 미검증 fact 를 실은 사이트를 발행하는 것
   - 고유 콘텐츠 0건짜리 템플릿 페이지를 발행하는 것
   - JSON-LD 와 화면이 다른 사이트를 발행하는 것
   - 렌더 결과를 확인하지 않고 "발행됨" 으로 남기는 것 (페이지 없는 발행)
   - 해지를 물리 삭제로 처리하는 것

★ 게이트는 이제 **렌더러가 실제로 구운 결과**를 보고 판정한다. 여기서는 그 보고서를
  백엔드가 어떻게 처리하는지를 본다 — 구조화 데이터 ↔ 화면 값 대조 자체는
  렌더러 쪽 테스트가 본다(solution/site/src/seo/verify.test.ts).
"""
import uuid

from sqlalchemy import text

from common.enums import (
    BuildStatus,
    ErrorType,
    FactStatus,
    JobStatus,
    MediaStatus,
    PublishAction,
    PublishRejectReason,
    SiteStatus,
    SourceType,
)
from crud.job_crud import JobQueue
from worker.handlers import build_handler
from worker.runner import Worker

REQUIRED = {
    "check_in_time": "15:00", "check_out_time": "11:00",
    "cancel_policy": "이용 7일 전 100% 환불, 3일 전 50% 환불",
    "cooking_allowed": "true", "pet_allowed": "false",
}


async def _run():
    assert await Worker("w", JobQueue(), build_handler(), job_deadline_sec=60).process_one() is True


async def _place(client, h, name="빌드펜션"):
    pid = (await client.post("/v1/place", headers=h, json={"name": name, "category": 1})).json()["place"]["place_id"]
    await client.post(f"/v1/place/{pid}/verify", headers=h, json={
        "source": 2, "road_address": f"강원특별자치도 양양군 현북면 하조대3길 {uuid.uuid4().hex[:3]}",
        "phone": "033-672-0000", "latitude": "38.0219217", "longitude": "128.7221449",
    })
    return pid


async def _verified_facts(client, h, pid, extra=None):
    """필수 항목을 넣고 전부 승인 상태로 만든다(사람이 직접 입력 = 즉시 노출값)."""
    for k, v in {**REQUIRED, **(extra or {})}.items():
        await client.post(f"/v1/place/{pid}/fact", headers=h, json={"key": k, "value": v})


async def _approved_media(db_engine, pid, alt="2층 목조 건물 외관"):
    async with db_engine.begin() as c:
        await c.execute(
            text("INSERT INTO place_photos (media_id, place_id, url, origin_url, source_type, status, alt_text, label, sort_order) "
                 "VALUES (:m,:p,:u,:u,:s,:st,:a,:l,0)"),
            {"m": uuid.uuid4(), "p": uuid.UUID(pid), "u": f"https://cdn.test/{uuid.uuid4().hex[:6]}.jpg",
             "s": SourceType.CRAWL.value, "st": MediaStatus.APPROVED.value, "a": alt, "l": "외관"},
        )


async def test_full_build_and_publish(auth_headers, client, db_engine):
    """검증: 필수 fact + 승인 사진이 갖춰진 사업장을 빌드·발행한다.
    기대결과: 게이트 통과 → BUILT → PUBLISHED. 버전과 발행 기록이 남는다."""
    h = await auth_headers("u1")
    pid = await _place(client, h)
    await _verified_facts(client, h, pid, {"intro": "하조대 해변 도보 3분 거리의 펜션입니다."})
    await _approved_media(db_engine, pid)

    job_id = (await client.post(f"/v1/place/{pid}/site/build", headers=h, json={"publish": True})).json()["job_id"]
    await _run()

    job = (await client.get(f"/v1/job/{job_id}", headers=h)).json()["job"]
    assert job["status"] == JobStatus.DONE.value, job.get("last_error")
    r = job["result"]
    assert r["gate"]["passed"] is True, r["gate"]
    assert r["build_status"] == "BUILT"
    assert r["published"] is True
    assert r["unique_content_count"] > 0
    # ★ 백엔드는 HTML 을 굽지 않는다. payload 를 쓰고, 렌더러가 굽은 결과를 받아 판정한다.
    assert r["payload_path"], "렌더러에 넘길 payload 가 없다"
    assert r["routes"] > 0, "렌더러가 페이지를 하나도 굽지 않았다"

    site = (await client.get(f"/v1/place/{pid}/site", headers=h)).json()
    assert site["site"]["status"] == SiteStatus.PUBLISHED.value
    assert site["current_version"]["build_status"] == BuildStatus.BUILT.value


async def test_unverified_fact_blocks_publish(auth_headers, client, db_engine):
    """검증: 미검증 fact 가 섞인 채로 빌드한다.

    기대결과: ★ 스냅샷에서 전부 걸러져 페이지에 남는 내용이 없다 — NO_UNIQUE_CONTENT 로 막힌다.
      (필수 항목 누락은 2026-08-27 부터 막지 않는다. 그래서 여기서 걸리는 사유가 바뀌었다.)

    ★ 미검증값은 공식 API 수집으로 만든다. 크롤링은 2026-09-14 부터 빈 자리에 바로
      노출값으로 들어가므로 더는 '미검증 fact' 를 만드는 경로가 아니다 —
      그래도 UNVERIFIED 가 페이지에 새어 나가면 안 된다는 것은 그대로다."""
    h = await auth_headers("u1")
    pid = await _place(client, h, "미검증펜션")
    # 공식 API 로 들어온 값 = 후보 상태(UNVERIFIED)
    for k, v in REQUIRED.items():
        await client.post(f"/v1/place/{pid}/fact", headers=h, json={
            "key": k, "value": v, "source_type": SourceType.API.value, "source_url": "https://api.test/1"})

    job_id = (await client.post(f"/v1/place/{pid}/site/build", headers=h, json={"publish": True})).json()["job_id"]
    await _run()

    r = (await client.get(f"/v1/job/{job_id}", headers=h)).json()["job"]["result"]
    assert r["gate"]["passed"] is False
    assert r["gate"]["reason"] == PublishRejectReason.NO_UNIQUE_CONTENT.name
    assert r["build_status"] == "FAILED"
    assert r.get("published") is None

    site = (await client.get(f"/v1/place/{pid}/site", headers=h)).json()
    assert site["site"]["status"] == SiteStatus.DRAFT.value, "★ 게이트를 막았는데 발행됐다"


async def test_no_unique_content_blocks_publish(auth_headers, client):
    """검증: 필수 항목은 다 채웠지만 값이 전부 짧은 정형값이고 소개문·FAQ·사진이 없다.
    기대결과: ★ NO_UNIQUE_CONTENT — 이 가게를 구분할 문장이 하나도 없으면
    같은 템플릿 대량 생성으로 보인다(스팸 판정 대상)."""
    h = await auth_headers("u1")
    pid = await _place(client, h, "빈껍데기펜션")
    # 취소 규정을 한 글자로 — 형식은 갖췄지만 이 가게만의 내용이 없다.
    for k, v in {**REQUIRED, "cancel_policy": "X"}.items():
        await client.post(f"/v1/place/{pid}/fact", headers=h, json={"key": k, "value": v})

    job_id = (await client.post(f"/v1/place/{pid}/site/build", headers=h, json={"publish": True})).json()["job_id"]
    await _run()

    r = (await client.get(f"/v1/job/{job_id}", headers=h)).json()["job"]["result"]
    assert r["gate"]["passed"] is False
    assert r["gate"]["reason"] == PublishRejectReason.NO_UNIQUE_CONTENT.name


async def test_owner_written_intro_counts_as_unique_content(auth_headers, client):
    """검증: fact·FAQ·사진 설명은 없지만 사장님이 소개 섹션 본문을 직접 썼다.
    기대결과: 실제 발행본에 표시되는 소개문 1건으로 계수되어 발행된다."""
    h = await auth_headers("owner-intro")
    pid = await _place(client, h, "직접소개펜션")
    for k, v in {**REQUIRED, "cancel_policy": "X"}.items():
        await client.post(f"/v1/place/{pid}/fact", headers=h, json={"key": k, "value": v})
    await client.post(f"/v1/place/{pid}/site/theme", headers=h, json={"theme": {"sections": [{
        "id": "intro", "name": "소개", "enabled": True, "locked": False,
        "body": "하조대의 아침 바다를 조용히 바라볼 수 있는 작은 숙소입니다.",
    }]}})

    job_id = (await client.post(
        f"/v1/place/{pid}/site/build", headers=h, json={"publish": True}
    )).json()["job_id"]
    await _run()

    r = (await client.get(f"/v1/job/{job_id}", headers=h)).json()["job"]["result"]
    assert r["gate"]["passed"] is True
    assert r["unique_content_count"] == 1
    assert r["published"] is True


async def test_missing_required_field_warns_but_publishes(auth_headers, client, db_engine):
    """검증: 취소 규정 없이 빌드한다.

    기대결과: ★ **발행된다.** 막아야 할 것은 "틀린 정보가 나가는 것"이지 "덜 찬 것"이 아니다
      (2026-08-27 결정). 대신 무엇이 비었는지는 경고로 알려줘야 한다 — 사장님이 나중에
      채우면 재빌드된다. 여기서 막으면 주소·전화가 확인된 쓸모 있는 페이지조차 못 낸다."""
    h = await auth_headers("u1")
    pid = await _place(client, h, "규정없는펜션")
    partial = {k: v for k, v in REQUIRED.items() if k != "cancel_policy"}
    for k, v in partial.items():
        await client.post(f"/v1/place/{pid}/fact", headers=h, json={"key": k, "value": v})
    await _approved_media(db_engine, pid)

    job_id = (await client.post(f"/v1/place/{pid}/site/build", headers=h, json={"publish": True})).json()["job_id"]
    await _run()

    r = (await client.get(f"/v1/job/{job_id}", headers=h)).json()["job"]["result"]
    assert r["gate"]["passed"] is True, "필수 항목 누락은 더 이상 발행을 막지 않는다"
    assert r["gate"]["warning"] == PublishRejectReason.REQUIRED_FACT_MISSING.name
    assert "cancel_policy" in r["gate"]["missing"], "무엇이 비었는지는 계속 알려줘야 한다"
    assert r["build_status"] == "BUILT"

    site = (await client.get(f"/v1/place/{pid}/site", headers=h)).json()
    assert site["site"]["status"] == SiteStatus.PUBLISHED.value


async def test_rejected_build_is_logged_with_reason(auth_headers, client):
    """검증: 게이트가 막은 뒤 발행 기록.
    기대결과: REJECTED 로 남고 사유가 detail 에 있다 — 운영자가 뭘 고칠지 안다."""
    h = await auth_headers("u1")
    pid = await _place(client, h, "기록펜션")
    for k, v in {**REQUIRED, "cancel_policy": "X"}.items():
        await client.post(f"/v1/place/{pid}/fact", headers=h, json={"key": k, "value": v})
    await client.post(f"/v1/place/{pid}/site/build", headers=h, json={"publish": True})
    await _run()

    logs = (await client.get(f"/v1/place/{pid}/site/log/list", headers=h)).json()["logs"]
    assert logs
    assert logs[0]["reject_reason"] == PublishRejectReason.NO_UNIQUE_CONTENT.value
    assert logs[0]["detail"]["reason"] == "NO_UNIQUE_CONTENT"


async def test_build_requires_verified_place(auth_headers, client):
    """검증: 동일 업소 검증 전에 빌드한다.
    기대결과: PLACE_NOT_VERIFIED — 주소·좌표가 없으면 JSON-LD 가 성립하지 않는다."""
    h = await auth_headers("u1")
    pid = (await client.post("/v1/place", headers=h, json={"name": "미검증", "category": 1})).json()["place"]["place_id"]
    r = await client.post(f"/v1/place/{pid}/site/build", headers=h, json={})
    assert r.json()["result"]["code"] == ErrorType.PLACE_NOT_VERIFIED.value


async def test_needs_rebuild_after_content_change(auth_headers, client, db_engine):
    """검증: 발행 후 노출값을 바꾼다.
    기대결과: ★ needs_rebuild=true — 이 사업장만 재빌드하면 된다(전체 재빌드 금지)."""
    h = await auth_headers("u1")
    pid = await _place(client, h, "재빌드펜션")
    await _verified_facts(client, h, pid, {"intro": "조용한 펜션입니다."})
    await _approved_media(db_engine, pid)
    await client.post(f"/v1/place/{pid}/site/build", headers=h, json={"publish": True})
    await _run()

    assert (await client.get(f"/v1/place/{pid}/site", headers=h)).json()["needs_rebuild"] is False

    await client.post(f"/v1/place/{pid}/fact", headers=h, json={"key": "check_in_time", "value": "16:00"})
    assert (await client.get(f"/v1/place/{pid}/site", headers=h)).json()["needs_rebuild"] is True


async def test_suspend_is_state_transition_not_delete(auth_headers, client, db_engine):
    """검증: 발행된 사이트를 중지하고 다시 재개한다.
    기대결과: ★ 상태만 바뀌고 버전·행은 그대로 — 해지를 삭제로 처리하지 않는다."""
    h = await auth_headers("u1")
    pid = await _place(client, h, "해지펜션")
    await _verified_facts(client, h, pid, {"intro": "펜션 소개문입니다."})
    await _approved_media(db_engine, pid)
    await client.post(f"/v1/place/{pid}/site/build", headers=h, json={"publish": True})
    await _run()
    version_id = (await client.get(f"/v1/place/{pid}/site", headers=h)).json()["current_version"]["site_version_id"]

    body = (await client.post(f"/v1/place/{pid}/site/status", headers=h,
                              json={"action": PublishAction.SUSPEND.value})).json()
    assert body["site"]["status"] == SiteStatus.SUSPENDED.value
    assert body["current_version"]["site_version_id"] == version_id, "★ 중지가 버전을 지웠다"

    body = (await client.post(f"/v1/place/{pid}/site/status", headers=h,
                              json={"action": PublishAction.RESUME.value})).json()
    assert body["site"]["status"] == SiteStatus.PUBLISHED.value


async def test_versions_accumulate(auth_headers, client, db_engine):
    """검증: 두 번 빌드한다.
    기대결과: 버전이 1, 2 로 쌓인다 — 예전에 뭐가 나갔는지 추적할 수 있다."""
    h = await auth_headers("u1")
    pid = await _place(client, h, "버전펜션")
    await _verified_facts(client, h, pid, {"intro": "펜션 소개문입니다."})
    await _approved_media(db_engine, pid)

    await client.post(f"/v1/place/{pid}/site/build", headers=h, json={"publish": True})
    await _run()
    await client.post(f"/v1/place/{pid}/site/build", headers=h, json={"publish": True})
    await _run()

    versions = (await client.get(f"/v1/place/{pid}/site/version/list", headers=h)).json()["versions"]
    assert [v["version"] for v in versions] == [2, 1]


async def test_site_is_scoped_to_owner(auth_headers, client):
    """검증: 다른 사장님 계정으로 남의 사이트를 본다.
    기대결과: PLACE_NOT_FOUND."""
    h1 = await auth_headers("o1")
    pid = await _place(client, h1, "스코프펜션")
    h2 = await auth_headers("o2")
    r = await client.get(f"/v1/place/{pid}/site", headers=h2)
    assert r.json()["result"]["code"] == ErrorType.PLACE_NOT_FOUND.value


# ── 렌더 결과 기반 게이트 ────────────────────────────────────────────────────
async def _built_place(client, h, db_engine):
    pid = await _place(client, h)
    await _verified_facts(client, h, pid, {"intro": "하조대 해변 도보 3분 거리의 펜션입니다."})
    await _approved_media(db_engine, pid)
    return pid


async def _build(client, h, pid, publish=True):
    job_id = (await client.post(f"/v1/place/{pid}/site/build", headers=h,
                                json={"publish": publish})).json()["job_id"]
    await _run()
    return (await client.get(f"/v1/job/{job_id}", headers=h)).json()["job"]["result"]


async def test_렌더가_실패하면_발행하지_않는다(auth_headers, client, db_engine, monkeypatch):
    """검증: 렌더러가 페이지를 굽지 못했다고 보고한다.
    기대결과: ★ FAILED. 페이지가 없는데 "발행됨"으로 남으면 사장님은 404 를 눌러야 안다."""
    from services import render_service

    async def _broken(payload_path, site_version, timeout_sec):
        return {"schemaVersion": 1, "slug": "t", "siteId": "", "placeId": "",
                "siteVersion": site_version, "ok": False, "renderedAt": "2026-01-01T00:00:00Z",
                "routes": 0, "bundle": "t.js", "uniqueContentCount": 5, "jsonld": [],
                "mismatches": [], "error": "번들이 없다"}

    h = await auth_headers("u1")
    pid = await _built_place(client, h, db_engine)
    monkeypatch.setattr(render_service, "render_site", _broken)

    r = await _build(client, h, pid)
    assert r["build_status"] == "FAILED"
    assert r.get("published") is not True
    assert "번들이 없다" in r["error"]

    site = (await client.get(f"/v1/place/{pid}/site", headers=h)).json()
    assert site["site"]["status"] != SiteStatus.PUBLISHED.value


async def test_구조화데이터가_화면과_다르면_발행하지_않는다(auth_headers, client, db_engine, monkeypatch):
    """검증: 렌더러가 JSON-LD 불일치를 보고한다.
    기대결과: ★ JSONLD_MISMATCH — 검색엔진에만 다른 말을 하는 페이지는 나가면 안 된다."""
    from services import render_service

    async def _mismatch(payload_path, site_version, timeout_sec):
        return {"schemaVersion": 1, "slug": "t", "siteId": "", "placeId": "",
                "siteVersion": site_version, "ok": False, "renderedAt": "2026-01-01T00:00:00Z",
                "routes": 0, "bundle": "t.js", "uniqueContentCount": 5, "jsonld": [],
                "mismatches": ["telephone: '02-0000-0000' 이 화면에 없다"],
                "error": "구조화 데이터가 화면 값과 다릅니다(1건)"}

    h = await auth_headers("u1")
    pid = await _built_place(client, h, db_engine)
    monkeypatch.setattr(render_service, "render_site", _mismatch)

    r = await _build(client, h, pid)
    assert r["build_status"] == "FAILED"
    # ★ 사유가 "렌더 실패"로 뭉뚱그려지면 운영자가 손댈 곳을 알 수 없다.
    assert r["gate"]["reason"] == PublishRejectReason.JSONLD_MISMATCH.name
    assert r["mismatches"]


async def test_렌더_결과가_안_오면_발행하지_않는다(auth_headers, client, db_engine, monkeypatch):
    """검증: 렌더러가 죽어 보고서가 오지 않는다(타임아웃).
    기대결과: ★ FAILED. 확인하지 못한 것을 발행됨으로 남기지 않는다."""
    from services import render_service

    async def _timeout(payload_path, site_version, timeout_sec):
        raise render_service.RenderFailed("렌더 결과를 받지 못했다 — 렌더러가 도는지 확인이 필요하다")

    h = await auth_headers("u1")
    pid = await _built_place(client, h, db_engine)
    monkeypatch.setattr(render_service, "render_site", _timeout)

    r = await _build(client, h, pid)
    assert r["build_status"] == "FAILED"
    assert r.get("published") is not True
    assert "렌더 결과" in r["error"]


async def test_렌더_보고서의_값이_그대로_박제된다(auth_headers, client, db_engine):
    """검증: site_versions 에 남는 jsonld·고유콘텐츠 수의 출처.
    기대결과: ★ 렌더러가 실제로 내보낸 값이다 — 백엔드가 따로 계산하지 않는다.
    (따로 계산하던 시절엔 게이트가 통과시킨 근거와 실제 페이지가 어긋날 수 있었다.)"""
    h = await auth_headers("u1")
    pid = await _built_place(client, h, db_engine)
    r = await _build(client, h, pid)

    assert r["build_status"] == "BUILT"

    async with db_engine.begin() as c:
        row = (await c.execute(
            text("SELECT jsonld, unique_content_count FROM site_versions WHERE site_version_id = :v"),
            {"v": uuid.UUID(r["site_version_id"])},
        )).mappings().first()

    assert row["unique_content_count"] == r["unique_content_count"]
    assert row["jsonld"], "렌더러가 내보낸 JSON-LD 가 박제되지 않았다"
    # 렌더러 대역이 내보낸 노드가 그대로 들어와야 한다(백엔드가 다시 만들지 않는다).
    assert row["jsonld"][0]["@type"] == "LodgingBusiness"