Aislo/resources/tester/test_538_help_guide.py

"""PLAN 538 [?] 사용자 가이드 — 변환 글 · 그림 내려주기 · 바로 고침.

짝: `ui_template/ui_template_help.ts`(`renderHelpMarkdown`)
— `helper_538_help_render.cjs` 가 Node 로 돌림 ·
`common_util/common_util_help_router.py`(GET /api/help · 그림 · PUT · POST).
"""

from __future__ import annotations

import json
import os
import shutil
import subprocess
import tempfile
from pathlib import Path

import pytest
from fastapi import FastAPI
from fastapi.testclient import TestClient

from common_util import common_util_help_router as help_router
from common_util.common_util_auth import verify_session

HERE = os.path.dirname(__file__)


@pytest.fixture(scope="module")
def html() -> dict:
    proc = subprocess.run(  # noqa: S603 — 고정 실행 파일
        ["node", os.path.join(HERE, "helper_538_help_render.cjs")],
        capture_output=True,
        text=True,
        encoding="utf-8",
        timeout=60,
    )
    assert proc.returncode == 0, proc.stderr
    return json.loads(proc.stdout)


def test_덩어리마다_원문_줄(html) -> None:
    admin = html["admin"]
    for tag in [
        '<h2 data-src="0-0">',
        '<p data-src="2-3">',
        '<ul data-src="5-6">',
        'class="ui-markdown-table" data-src="8-10"',
        'data-src="12-13"',
        '<figure data-src="17-17"',
    ]:
        assert tag in admin, tag
    assert '<ul data-src="2-3">' in html["crlf"]


def test_페이지_안_넘기면_옛_출력(html) -> None:
    """B01 지식 채팅 — 원문 줄 · 그림 · 상자 · 링크 없음."""
    plain = html["plain"]
    assert "data-src" not in plain and "<figure" not in plain and "<aside" not in plain
    assert plain.startswith("<h2>종단 설계</h2><p>첫 문단 [표준 횡단](B06/00_설명서)")


def test_그림_상자_링크(html) -> None:
    admin, user = html["admin"], html["user"]
    assert (
        '<img src="/api/help/B05/img/b05_full.webp?v=abc" alt="화면 통째" loading="lazy">' in admin
    )
    assert "<figcaption>화면 통째</figcaption>" in admin
    assert "그림 없음 — 더블클릭해 지정" in admin and "그림 없음" not in user
    assert "그림 준비 중" in user
    assert (
        '<aside class="ui-help-note ui-help-note--warn" data-src="12-13"><strong>주의</strong>'
        in admin
    )
    assert '<aside class="ui-help-note ui-help-note--info"' in admin
    assert 'data-help-goto="B06/00_설명서">표준 횡단</a>' in admin
    assert 'data-help-goto="B05/구조물_돌쌓기(메)">돌쌓기</a>' in admin


def test_html_은_먼저_막음(html) -> None:
    for out in html.values():
        assert "<script>" not in out
    assert "../x.webp" in html["admin"] and 'data-img="../x.webp"' not in html["admin"]


# ── 서버 ─────────────────────────────────────────────────────────────────────


@pytest.fixture
def root(monkeypatch):
    path = Path(tempfile.mkdtemp())
    (path / "B05").mkdir()
    (path / "B05" / "00_설명서.md").write_text("# 종단\n\n첫 문단\n", encoding="utf-8")
    monkeypatch.setattr(help_router, "HELP_ROOT", path)
    yield path
    shutil.rmtree(path, ignore_errors=True)


def client(role: str = "SYSTEM_ADMIN") -> TestClient:
    app = FastAPI()
    app.include_router(help_router.router)
    app.dependency_overrides[verify_session] = lambda: {"role": role, "user_id": 1}
    return TestClient(app)


def test_guide_admin_칸(root) -> None:
    assert client().get("/api/help").json()["admin"] is True
    body = client("USER").get("/api/help").json()
    assert body["admin"] is False and body["pages"][0]["page"] == "B05"


def test_그림_내려주기_no_cache(root) -> None:
    (root / "B05" / "full.webp").write_bytes(b"RIFF0000WEBP")
    res = client("USER").get("/api/help/B05/img/full.webp")
    assert res.status_code == 200 and res.content == b"RIFF0000WEBP"
    assert res.headers["cache-control"] == "no-cache"
    assert res.headers["content-type"] == "image/webp"
    assert list(client().get("/api/help").json()["pages"][0]["images"]) == ["full.webp"]


@pytest.mark.parametrize(
    "url",
    [
        "/api/help/B05/img/none.webp",
        "/api/help/B05/img/00_설명서.md",
        "/api/help/B05/img/..%2F..%2Fmain.py",
        "/api/help/B05/img/a.gif",
        "/api/help/..%2FB05/img/full.webp",
        "/api/help/b05/img/full.webp",
    ],
)
def test_그림_404(root, url) -> None:
    (root / "B05" / "full.webp").write_bytes(b"RIFF0000WEBP")
    assert client().get(url).status_code == 404