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.
This commit is contained in:
@@ -0,0 +1,341 @@
|
||||
"""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()
|
||||
Reference in New Issue
Block a user