Files
flexly-cms/scripts/qa_editor_001.py
T
phelex 88ac95dd19 Integrate Antirion admin with FastAPI and htmx
Add the shared document API, constructor and expert editors, isolated preview, and fragment catalog metadata with typed block IDs.

Include design references, specification 001, QA scripts, project guidance, and cached Docker dependency installation. Leave example sites for a separate commit.
2026-11-12 21:55:36 +03:00

342 lines
20 KiB
Python

"""Two real HTTP origins and Chromium: buffers, CAS, preview bridge, assets, auth, release."""
from __future__ import annotations
import json
import os
import shutil
import socket
import tempfile
from pathlib import Path
from unittest.mock import patch
from playwright.sync_api import expect, sync_playwright
from qa_001 import PASSWORD, ROOT, serve
from site_engine.parsing import frontmatter
from site_engine.services.auth import hash_password
from site_engine.web.app import create_app
from site_engine.web.preview_app import create_preview_app
def reserve():
sock = socket.socket()
sock.bind(("127.0.0.1", 0))
return sock
def main():
artifacts = Path("/tmp/site-engine-001-editor-qa")
artifacts.mkdir(exist_ok=True)
checks = []
with tempfile.TemporaryDirectory(prefix="cms-editor-qa-") as tmp:
work = Path(tmp)
site = work / "site"
shutil.copytree(
ROOT / "examples/studio-site", site, ignore=shutil.ignore_patterns(".engine")
)
probe = site / "fragments/qa_probe"
probe.mkdir(parents=True)
(probe / "fragment.yaml").write_text(
"id: qa_probe\nname: Probe\ncategory: test\nfields: []\nslots: {}\n"
)
(probe / "template.html.j2").write_text(
"<section><h2>Script probe</h2><script>window.__site_script_ran=1</script></section>"
)
(probe / "script.js").write_text("window.__site_bundle_ran=1;")
meta, body = frontmatter.parse((site / "pages/index.md").read_text())
meta["regions"]["main"].append({"id": "b_probe", "fragment": "qa_probe"})
(site / "pages/index.md").write_text(frontmatter.dumps(meta, body))
(site / "pages/crlf.md").write_bytes(
b"---\r\ntitle: Exact\r\nstatus: draft\r\n---\r\nBody\r\n"
)
(site / "assets/new.svg").parent.mkdir(exist_ok=True)
(site / "assets/new.svg").write_text(
'<svg xmlns="http://www.w3.org/2000/svg" width="30" height="30"><rect width="30" height="30" fill="red"/></svg>'
)
a, p = reserve(), reserve()
admin = f"http://127.0.0.1:{a.getsockname()[1]}"
preview = f"http://127.0.0.1:{p.getsockname()[1]}"
env = {
"SITE_ROOT": str(site),
"SITE_DIST": str(work / "dist"),
"SITE_STATE_DIR": str(work / "state"),
"SITE_ADMIN_LOGIN": "admin",
"SITE_ADMIN_PASSWORD_HASH": hash_password(PASSWORD, n=2**10),
"SITE_SECRET_KEY": "temporary-editor-browser-secret-" * 2,
"SITE_COOKIE_SECURE": "0",
"SITE_ADMIN_ORIGIN": admin,
"SITE_PREVIEW_ORIGIN": preview,
}
with (
patch.dict(os.environ, env),
serve(create_app(), a),
serve(create_preview_app(), p),
sync_playwright() as pw,
):
browser = pw.chromium.launch(headless=True, args=["--no-sandbox"])
context = browser.new_context(
viewport={"width": 1440, "height": 1000}, reduced_motion="reduce"
)
page = context.new_page()
errors = []
browser_api_requests = []
page.on("pageerror", lambda e: errors.append(str(e)))
page.on(
"request",
lambda r: (
browser_api_requests.append(r.url)
if "/admin/api/v1/" in r.url or "authorization" in r.headers
else None
),
)
page.on("dialog", lambda d: d.accept())
page.goto(admin + "/admin/login")
page.locator("[name=login]").fill("admin")
page.locator("[name=password]").fill(PASSWORD)
page.get_by_role("button", name="Войти", exact=True).click()
page.wait_for_url(admin + "/admin/")
page.goto(admin + "/admin/pages/index")
source = page.locator("#document-source")
original = (site / "pages/index.md").read_text()
page.locator("#preview-result iframe").wait_for()
frame = page.frame_locator("#preview-result iframe")
expect(frame.locator("[data-preview-id=b_hero]")).to_be_visible()
assert frame.locator("body").evaluate(
"()=>window.__site_script_ran===undefined&&window.__site_bundle_ran===undefined"
)
assert frame.locator("[data-preview-id=b_demo]").count() == 0
checks.extend(["site_scripts_blocked", "feature_hidden_not_rendered"])
assert page.locator("#preview-result iframe").get_attribute("src").startswith(preview)
checks.append("separate_origin_preview")
frame.locator("[data-preview-id=lh_header]").click(position={"x": 10, "y": 10})
expect(page.locator("[data-readonly-inspector]")).to_be_visible()
expect(page.locator("[data-readonly-inspector]")).to_contain_text("layout / default")
checks.append("fixed_readonly_inspector")
tab = context.new_page()
tab.on("dialog", lambda d: d.accept())
tab.goto(admin + "/admin/pages/index")
tab.locator("#preview-result iframe").wait_for()
# Select via the preview bridge; then apply typed values to memory only.
frame.locator("[data-preview-id=b_hero]").click(position={"x": 20, "y": 20})
expect(page.locator(".tree-node.selected")).to_have_attribute("data-tree-id", "b_hero")
expect(page.locator('[data-inspector] [name="p.title"]')).to_be_visible()
page.locator('[data-inspector] [name="p.title"]').fill("Browser buffer hero")
page.locator('[data-inspector] [name="p.image"]').fill("assets/new.svg")
with page.expect_response(lambda r: r.url.endswith("/transform")) as response:
page.get_by_role("button", name=__import__("re").compile("^Применить (к буферу|изменения)$")).click()
assert response.value.status == 200, response.value.text()
expect(source).to_have_value(__import__("re").compile("Browser buffer hero"))
assert (site / "pages/index.md").read_text() == original
expect(
page.frame_locator("#preview-result iframe").get_by_role(
"heading", name="Browser buffer hero", exact=True
)
).to_be_visible()
img = page.frame_locator("#preview-result iframe").locator('img[src*="new.svg"]')
expect(img).to_be_visible()
assert img.evaluate("(e)=>e.complete&&e.naturalWidth>0")
checks.extend(
["preview_to_tree", "constructor_no_write", "unsaved_preview", "workspace_asset"]
)
# Tree navigation scrolls only when needed; the next preview restores that viewport.
page.locator("button[data-tree-id=b_cta]").click()
expect(page.locator(".tree-node.selected")).to_have_attribute("data-tree-id", "b_cta")
expect(
page.frame_locator("#preview-result iframe").locator("[data-preview-id=b_cta]")
).to_have_css("outline-style", "solid")
page.wait_for_timeout(180)
scroll = (
page.frame_locator("#preview-result iframe").locator("body").evaluate("()=>scrollY")
)
assert scroll > 0
page.locator('[data-inspector] [name="p.title"]').fill("Расскажите о сайте")
page.get_by_role("button", name=__import__("re").compile("^Применить (к буферу|изменения)$")).click()
expect(
page.frame_locator("#preview-result iframe").get_by_role(
"heading", name="Расскажите о сайте", exact=True
)
).to_be_visible()
page.wait_for_timeout(180)
restored = (
page.frame_locator("#preview-result iframe").locator("body").evaluate("()=>scrollY")
)
assert abs(scroll - restored) < 4, (scroll, restored)
checks.append("tree_scroll_and_viewport_restore")
# Mode switch changes no serialization; Save commits the exact common buffer.
before = source.input_value()
page.get_by_role("button", name="Эксперт", exact=True).click()
expect(source).to_be_visible()
page.get_by_role("button", name="Конструктор", exact=True).click()
assert source.input_value() == before
page.get_by_role("button", name="Сохранить документ", exact=True).click()
expect(page.locator("#editor-result .success")).to_be_visible()
assert (site / "pages/index.md").read_text() == before
checks.extend(["mode_roundtrip", "explicit_save"])
# Stale second tab must retain its own text and receive both versions.
tab.get_by_role("button", name="Эксперт", exact=True).click()
stale = (
tab.locator("#document-source")
.input_value()
.replace("title: Главная", "title: Second tab")
)
tab.locator("#document-source").fill(stale)
with tab.expect_response(lambda r: r.url.endswith("/save")) as response:
tab.get_by_role("button", name="Сохранить документ", exact=True).click()
assert response.value.status == 409
expect(tab.locator(".conflict-panel")).to_be_visible()
assert tab.locator("#document-source").input_value() == stale
tab.locator("[name=confirm_rebase]").check()
tab.locator("[data-rebase]").click()
assert (site / "pages/index.md").read_text() == before
tab.get_by_role("button", name="Сохранить документ", exact=True).click()
expect(tab.locator("#editor-result .success")).to_be_visible()
checks.append("two_tab_conflict_explicit_rebase")
tab.close()
# Invalid expert text and rejected stale response never destroy the buffer.
page.get_by_role("button", name="Эксперт", exact=True).click()
bad = "---\ntitle: A\ntitle: B\n---\nkeep invalid body"
source.fill(bad)
page.get_by_role("button", name="Проверить", exact=True).click()
expect(page.locator("#editor-result")).to_have_attribute("data-valid", "0")
assert source.input_value() == bad
checks.append("invalid_expert_preserved")
page.screenshot(path=str(artifacts / "invalid-expert.png"), full_page=True)
# Reload (explicitly discard dirty) and check normal entry fields and saving.
page.goto(admin + "/admin/content/services/bots")
page.locator('[data-inspector] [name="p.title"]').fill("Browser entry")
page.get_by_role("button", name=__import__("re").compile("^Применить (к буферу|изменения)$")).click()
expect(page.locator("#document-source")).to_have_value(
__import__("re").compile("Browser entry")
)
page.get_by_role("button", name="Сохранить документ", exact=True).click()
expect(page.locator("#editor-result .success")).to_be_visible()
assert "Browser entry" in (site / "content/services/bots.md").read_text()
checks.append("entry_buffer_save")
page.screenshot(path=str(artifacts / "entry.png"), full_page=True)
# Exact original CRLF bytes survive mode changes and an unmodified Save.
page.goto(admin + "/admin/pages/crlf")
page.get_by_role("button", name="Эксперт", exact=True).click()
page.get_by_role("button", name="Конструктор", exact=True).click()
exact = (site / "pages/crlf.md").read_bytes()
page.get_by_role("button", name="Сохранить документ", exact=True).click()
expect(page.locator("#editor-result .success")).to_be_visible()
assert (site / "pages/crlf.md").read_bytes() == exact
checks.append("exact_crlf_source")
# A delayed old preview response cannot replace a newer expert buffer.
page.wait_for_load_state("networkidle")
held = []
page.route("**/admin/editor/pages/crlf/preview", lambda route: held.append(route))
with page.expect_request(lambda r: r.url.endswith("/admin/editor/pages/crlf/preview")):
page.get_by_role("button", name="Обновить превью", exact=True).click()
page.wait_for_timeout(150)
assert held
page.get_by_role("button", name="Эксперт", exact=True).click()
page.locator("#document-source").fill(
"---\ntitle: New buffer\nstatus: draft\n---\nNewer"
)
held.pop().continue_()
page.wait_for_timeout(300)
assert page.locator("#document-source").input_value().endswith("Newer")
page.unroute("**/admin/editor/pages/crlf/preview")
checks.append("stale_preview_rejected")
# Network failures leave text and download available.
page.route("**/admin/editor/pages/crlf/save", lambda route: route.abort())
page.get_by_role("button", name="Сохранить документ", exact=True).click()
expect(page.locator("#editor-notice")).to_contain_text("Нет связи")
assert page.locator("#document-source").input_value().endswith("Newer")
page.unroute("**/admin/editor/pages/crlf/save")
checks.append("network_error_preserves_buffer")
page.goto(admin + "/admin/pages/index")
page.locator("#preview-result iframe").wait_for()
page.screenshot(path=str(artifacts / "constructor.png"), full_page=True)
# Reject each boundary independently: origin, source, snapshot, revision and unknown block.
page.evaluate("""() => {
const root=document.querySelector('#document-editor'),p=document.querySelector('#preview-result'),f=p.querySelector('iframe');
const data={type:'preview:select',snapshot:p.dataset.snapshot,revision:Number(p.dataset.revision),block:{scope:'page',owner:'index',id:'b_dirs'}};
for(const variant of [
{origin:'https://evil.example',source:f.contentWindow,data},
{origin:root.dataset.previewOrigin,source:window,data},
{origin:root.dataset.previewOrigin,source:f.contentWindow,data:{...data,snapshot:'wrong'}},
{origin:root.dataset.previewOrigin,source:f.contentWindow,data:{...data,revision:999999}},
{origin:root.dataset.previewOrigin,source:f.contentWindow,data:{...data,block:{scope:'page',owner:'index',id:'unknown'}}},
{origin:root.dataset.previewOrigin,source:f.contentWindow,data:{...data,block:{scope:'page',owner:'wrong',id:'b_dirs'}}}
]) window.dispatchEvent(new MessageEvent('message',variant));
}""")
page.wait_for_timeout(120)
assert page.locator(".tree-node.selected").get_attribute("data-tree-id") == "b_hero"
checks.append("message_boundaries_checked")
# Forged messages are rejected, and document content never enters localStorage.
page.evaluate(
"window.dispatchEvent(new MessageEvent('message',{origin:'https://evil.example',source:window,data:{type:'preview:select',snapshot:'wrong',revision:0,block:{scope:'page',owner:'index',id:'b_hero'}}}))"
)
storage = page.evaluate("Object.keys(localStorage)")
assert all(k in ["site-admin-theme", "site-admin-narrow"] for k in storage), storage
checks.extend(["forged_messages_rejected", "no_content_storage"])
page.goto(admin + "/admin/publish")
page.get_by_role(
"button", name="Опубликовать текущий черновик сайта", exact=True
).click()
page.get_by_role("button", name="Продолжить", exact=True).click()
expect(page.locator(".status-published")).to_have_count(1)
assert (work / "dist/current/index.html").exists()
public = (work / "dist/current/index.html").read_text()
assert "data-preview-" not in public and "preview:ready" not in public
checks.append("publish_public_html")
first = (work / "dist/current").resolve().name
(site / "pages/crlf.md").write_text("---\ntitle: Updated draft\nstatus: draft\n---\n")
# A different workspace hash creates a second release, then rollback only switches current.
page.get_by_role(
"button", name="Опубликовать текущий черновик сайта", exact=True
).click()
page.get_by_role("button", name="Продолжить", exact=True).click()
expect(page.get_by_role("button", name="Вернуть этот релиз", exact=True)).to_have_count(
1
)
page.get_by_role("button", name="Вернуть этот релиз", exact=True).click()
with page.expect_response(lambda r: "/admin/publish/rollback/" in r.url):
page.get_by_role("button", name="Продолжить", exact=True).click()
expect(page.locator(".status-published")).to_have_count(1)
assert (work / "dist/current").resolve().name == first
assert "Updated draft" in (site / "pages/crlf.md").read_text()
checks.append("rollback_preserves_workspace")
# Ordinary Save also works with JavaScript disabled.
fallback = browser.new_context(
java_script_enabled=False, storage_state=context.storage_state()
)
plain = fallback.new_page()
plain.goto(admin + "/admin/pages/crlf?mode=expert")
plain.locator("#document-source").fill(
"---\ntitle: Full form save\nstatus: draft\n---\nNo JS"
)
plain.get_by_role("button", name="Сохранить документ", exact=True).click()
assert (site / "pages/crlf.md").read_text().endswith("No JS")
assert plain.locator("#editor-result .success").count() == 1
fallback.close()
checks.append("ordinary_form_without_js")
# Epoch revocation keeps open editor source available for download.
page.goto(admin + "/admin/pages/index")
page.get_by_role("button", name="Эксперт", exact=True).click()
before = page.locator("#document-source").input_value()
page.locator("#document-source").fill(before + "\nunsaved after expiry")
(work / "state/auth_epoch").write_text("1")
page.get_by_role("button", name="Сохранить документ", exact=True).click()
expect(page.locator("#editor-notice")).to_contain_text("Сессия истекла")
assert "unsaved after expiry" in page.locator("#document-source").input_value()
with page.expect_download() as download:
page.get_by_role("button", name="Скачать исходник", exact=True).click()
assert download.value.suggested_filename == "index.md"
checks.append("session_expiry_download")
assert not errors, errors
assert not browser_api_requests, browser_api_requests
checks.append("internal_credentials_never_in_browser")
browser.close()
(artifacts / "report.json").write_text(
json.dumps({"checks": checks, "js_errors": errors}, ensure_ascii=False, indent=2)
)
print(json.dumps({"checks": len(checks), "artifacts": str(artifacts)}))
if __name__ == "__main__":
main()