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:
2026-11-12 21:55:36 +03:00
parent 58cc8090a9
commit 88ac95dd19
260 changed files with 20395 additions and 320 deletions
+363
View File
@@ -0,0 +1,363 @@
"""Stage 2: original/runtime visual measurements and real browser interactions."""
import json
import os
import shutil
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.build.pipeline import build_site
from site_engine.services.auth import hash_password
from site_engine.web.app import create_app
OUT = Path("/tmp/site-engine-pages-001")
MEASURE = """names => Object.fromEntries(names.map(name => {
const e=document.querySelector(name), r=e.getBoundingClientRect(), s=getComputedStyle(e);
return [name,{x:r.x,y:r.y,width:r.width,height:r.height,fontSize:s.fontSize,
fontFamily:s.fontFamily,fontWeight:s.fontWeight,lineHeight:s.lineHeight,
padding:s.padding,color:s.color,background:s.backgroundColor}];
}))"""
def settled(page):
page.wait_for_function("() => !document.querySelector('.htmx-request,.htmx-swapping,.htmx-settling')")
def main():
OUT.mkdir(exist_ok=True)
report = {"visual": [], "flows": [], "errors": []}
with tempfile.TemporaryDirectory(prefix="cms-pages-") as temp:
work = Path(temp)
site = work / "site"
shutil.copytree(
ROOT / "examples/studio-site", site, ignore=shutil.ignore_patterns(".engine")
)
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-pages-qa-secret-" * 2,
"SITE_COOKIE_SECURE": "0",
"SITE_ADMIN_ORIGIN": "",
"SITE_PREVIEW_ORIGIN": "",
"SITE_PUBLIC_HOST": "",
}
with patch.dict(os.environ, env), serve(create_app()) as origin, sync_playwright() as pw:
browser = pw.chromium.launch(headless=True, args=["--no-sandbox"])
context = browser.new_context(
viewport={"width": 1440, "height": 960}, reduced_motion="reduce"
)
page = context.new_page()
page.on("pageerror", lambda e: report["errors"].append(str(e)))
page.on(
"console", lambda m: report["errors"].append(m.text) if m.type == "error" else None
)
page.on(
"response",
lambda r: (
report["errors"].append(f"{r.status} {r.url}") if r.status >= 400 else None
),
)
page.goto(origin + "/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(origin + "/admin/")
reference = browser.new_page(
viewport={"width": 1440, "height": 960}, reduced_motion="reduce"
)
reference.goto((ROOT / "design/antirion-rework.html").as_uri())
for screen in ["pages", "overview"]:
for p in [page, reference]:
p.set_viewport_size({"width": 1440, "height": 960})
page.goto(origin + ("/admin/pages" if screen == "pages" else "/admin/"))
if screen == "overview":
reference.locator('[data-route="overview"]').first.click()
# Compare original component geometry with identical text/data.
# Only original text and row count change; its markup/CSS/layout stay intact.
reference.evaluate(
"""html => {
const source=new DOMParser().parseFromString(html,'text/html');
for(const selector of ['.headline','.ribbon']) {
const a=document.querySelector(selector), b=source.querySelector(selector);
const ta=document.createTreeWalker(a,NodeFilter.SHOW_TEXT), tb=document.createTreeWalker(b,NodeFilter.SHOW_TEXT);
const texts=[]; while(tb.nextNode())if(tb.currentNode.textContent.trim())texts.push(tb.currentNode.textContent);
let i=0;while(ta.nextNode())if(ta.currentNode.textContent.trim() && i<texts.length)ta.currentNode.textContent=texts[i++];
}
if(source.querySelector('#pageRows')) {
const originals=[...document.querySelectorAll('#pageRows tr')];
const rows=[...source.querySelectorAll('#pageRows tr')];
originals.slice(rows.length).forEach(r=>r.remove());
originals.slice(0,rows.length).forEach((r,i)=>{
const originalCells=r.querySelectorAll('td'), cells=rows[i].querySelectorAll('td');
originalCells.forEach((c,j)=>{
if(j===0){c.querySelector('b').textContent=cells[j].querySelector('b').textContent;c.querySelector('small').textContent=cells[j].querySelector('small').textContent;}
else c.innerHTML=cells[j].innerHTML;
});
});
}
}""",
page.content(),
)
selectors = [
".headline",
".headline h2",
".headline p",
".ribbon",
".ribbon-item .number",
]
if screen == "pages":
selectors += [
".toolbar",
".search",
".select",
".tabs",
".workbench",
".data-table",
".data-table thead",
"#pageRows tr",
".inspect-heading",
".preview",
".device-toggle",
]
else:
selectors += [
".overview-stage",
".overview-lead",
".giant",
".overview-live",
".section-grid",
".section-title",
]
for theme in ["light", "dark"]:
for p in [page, reference]:
p.evaluate("theme=>document.body.dataset.skin=theme", theme)
for width in [1440, 1280, 1024, 768, 390, 360]:
for p in [page, reference]:
p.set_viewport_size({"width": width, "height": 960})
reference.wait_for_timeout(200)
actual, expected = (
page.evaluate(MEASURE, selectors),
reference.evaluate(MEASURE, selectors),
)
# Different inspector text/overview state changes vertical content height.
# Compare stable structure and every visual style, record other coordinates.
for selector in selectors:
props = [
"fontSize",
"fontFamily",
"fontWeight",
"lineHeight",
"padding",
"color",
"background",
"x",
"width",
]
if selector in [
".headline",
".headline h2",
".headline p",
".toolbar",
".search",
".select",
".tabs",
".data-table thead",
"#pageRows tr",
] or (selector == ".ribbon" and screen == "pages"):
props += ["y", "height"]
for prop in props:
a, b = actual[selector][prop], expected[selector][prop]
assert (
abs(a - b) < 0.6 if isinstance(a, (float, int)) else a == b
), (screen, theme, width, selector, prop, a, b)
assert not page.evaluate(
"document.documentElement.scrollWidth>innerWidth+1"
), (screen, theme, width)
report["visual"].append(
{
"screen": screen,
"theme": theme,
"width": width,
"runtime": actual,
"reference": expected,
}
)
if width in [1440, 390]:
page.screenshot(
path=str(OUT / f"{screen}-{theme}-{width}.png"), full_page=True
)
reference.screenshot(
path=str(OUT / f"reference-{screen}-{theme}-{width}.png"),
full_page=True,
)
page.set_viewport_size({"width": 1440, "height": 960})
page.goto(origin + "/admin/pages")
expect(page.locator("#pageRows tr.selected")).to_have_attribute("data-page", "index")
page.locator('#pageRows tr[data-page="contacts"] td').nth(1).click()
expect(page.locator(".inspect-heading h3")).to_have_text("Контакты")
assert "/admin/pages?" in page.url
page.locator('#pageRows tr[data-page="index"]').focus()
page.keyboard.press("Enter")
expect(page.locator(".inspect-heading h3")).to_have_text("Главная")
page.locator('[data-page-device="mobile"]').click()
page.locator("#pageSearch").fill("contacts")
expect(page.locator("#pageRows tr[data-page]")).to_have_count(1)
assert page.locator("#pageSearch").evaluate("e=>e===document.activeElement")
page.locator('#pageRows tr[data-page="contacts"]').click()
expect(page.locator(".inspect-heading h3")).to_have_text("Контакты")
expect(page.locator("[data-page-browser]")).to_have_class("browser mobile")
page.locator("[data-reset-pages]").click()
expect(page.locator("#pageRows tr[data-page]")).to_have_count(5)
expect(page.locator("#pageSearch")).to_have_value("")
settled(page)
expect(page.locator(".inspect-heading h3")).to_have_text("Контакты")
page.get_by_role("tab", name="Черновики").click()
expect(page.locator("#pageRows tr[data-page]")).to_have_count(1)
page.go_back()
expect(page.locator("#pageRows tr[data-page]")).to_have_count(5)
settled(page)
page.go_forward()
expect(page.locator("#pageRows tr[data-page]")).to_have_count(1)
settled(page)
page.locator("[data-reset-pages]").click()
expect(page.locator("#pageRows tr[data-page]")).to_have_count(5)
settled(page)
page.locator("#layoutFilter").select_option("default")
page.wait_for_url("**/*layout=default*")
page.get_by_role("tab", name="В каталоге").click()
expect(page.locator("#pageRows tr[data-page]")).to_have_count(4)
assert "layout=default" in page.url and "status=published" in page.url
report["flows"].append(
"row click/keyboard, inspector, mobile miniature, live search/focus, filters, reset, Back/Forward"
)
page.locator("#pageSearch").fill("no-such-document")
expect(page.locator(".empty h3")).to_have_text("Ничего не найдено")
page.get_by_role("link", name="Сбросить фильтры", exact=True).click()
expect(page.locator("#pageRows tr[data-page]")).to_have_count(5)
settled(page)
for opener, dialog in [
("pages-info-dialog", "pages-info-dialog"),
("page-details-dialog", "page-details-dialog"),
("new-page-dialog", "new-page-dialog"),
]:
trigger = page.locator(f'[data-open-modal="{opener}"]')
before = list(site.glob("pages/**/*.md"))
trigger.click()
expect(page.locator("#" + dialog)).to_be_visible()
page.keyboard.press("Tab")
assert page.locator("#" + dialog).evaluate("e=>e.contains(document.activeElement)")
page.screenshot(path=str(OUT / (dialog + ".png")))
if dialog == "new-page-dialog":
page.set_viewport_size({"width": 390, "height": 844})
assert not page.evaluate("document.documentElement.scrollWidth>innerWidth+1")
page.screenshot(path=str(OUT / "new-page-mobile.png"))
page.set_viewport_size({"width": 1440, "height": 960})
page.keyboard.press("Escape")
expect(page.locator("#" + dialog)).not_to_be_visible()
assert trigger.evaluate("e=>e===document.activeElement")
assert list(site.glob("pages/**/*.md")) == before
report["flows"].append(
"info/details/create dialogs: focus, Escape, no writes on open/cancel"
)
page.locator('[data-open-modal="new-page-dialog"]').click()
page.locator('#new-page-dialog [name="title"]').fill("Новая вложенная страница")
page.locator('#new-page-dialog [name="page_id"]').fill("nested/browser")
page.get_by_role("button", name="Создать черновик", exact=True).click()
page.wait_for_url("**/*msg=created*")
expect(page.locator(".inspect-heading h3")).to_have_text("Новая вложенная страница")
settled(page)
assert (site / "pages/nested/browser.md").exists()
assert not (work / "dist/current").exists()
page.locator('[data-open-modal="new-page-dialog"]').click()
page.locator('#new-page-dialog [name="title"]').fill("Duplicate preserved")
page.locator('#new-page-dialog [name="page_id"]').fill("nested/browser")
page.get_by_role("button", name="Создать черновик", exact=True).click()
expect(page.locator('#new-page-dialog [role="alert"]')).to_be_visible()
expect(page.locator('#new-page-dialog [name="title"]')).to_have_value(
"Duplicate preserved"
)
expect(page.locator("#new-page-dialog")).to_be_visible()
settled(page)
page.locator('#new-page-dialog [name="page_id"]').fill("new")
with page.expect_response(lambda response: response.url.endswith('/admin/pages/new') and response.status == 422):
page.get_by_role("button", name="Создать черновик", exact=True).click()
settled(page)
expect(page.locator('#new-page-dialog [name="page_id"]')).to_have_value("new")
expect(page.locator('#new-page-dialog [role="alert"]')).to_be_visible()
assert not (site / "pages/new.md").exists()
# Duplicate/reserved ID intentionally return 409/422.
report["errors"] = [
e
for e in report["errors"]
if not (
any(code in e for code in ["409", "422"])
and ("/admin/pages/new" in e or "Failed to load resource" in e)
)
]
page.keyboard.press("Escape")
report["flows"].append(
"real nested draft creation, list selection, 409/422 with values retained, no publication"
)
build_site(site, work / "dist")
page.goto(origin + "/admin/pages")
expect(page.locator(".ribbon-item").nth(1).locator(".number")).to_have_text("02")
source = site / "pages/index.md"
original = source.read_bytes()
source.write_bytes(original + b"\n")
page.reload()
expect(page.locator(".ribbon-item").nth(1).locator(".number")).to_have_text("03")
source.write_bytes(original)
page.reload()
expect(page.locator(".ribbon-item").nth(1).locator(".number")).to_have_text("02")
page.screenshot(path=str(OUT / "pages-live.png"), full_page=True)
report["flows"].append("real release counts, modified/reverted source, long build ID")
manifest_path = work / "dist/current/manifest.json"
manifest_source = manifest_path.read_bytes()
manifest = json.loads(manifest_source)
del manifest["page_sources"]
manifest_path.write_text(json.dumps(manifest))
page.reload()
expect(page.locator(".ribbon-item").nth(1).locator(".number")).to_have_text("—")
expect(
page.get_by_text(
"Для этого релиза нет данных сравнения. Они появятся после следующей публикации."
)
).to_be_visible()
manifest_path.write_bytes(manifest_source)
report["flows"].append("legacy release comparison is unknown, not a false zero")
nojs = browser.new_context(
java_script_enabled=False, storage_state=context.storage_state()
)
fallback = nojs.new_page()
fallback.goto(origin + "/admin/pages")
fallback.locator("#pageSearch").fill("contacts")
fallback.get_by_role("button", name="Найти", exact=True).click()
expect(fallback.locator("#pageRows tr[data-page]")).to_have_count(1)
fallback.locator('[data-open-modal="new-page-dialog"]').click()
expect(fallback.locator("#new-page-dialog")).to_be_visible()
fallback.locator('#new-page-dialog [name="title"]').fill("Без JavaScript")
fallback.locator('#new-page-dialog [name="page_id"]').fill("no-js")
fallback.get_by_role("button", name="Создать черновик", exact=True).click()
expect(fallback.locator(".inspect-heading h3")).to_have_text("Без JavaScript")
report["flows"].append("no-JavaScript filter and real draft creation")
nojs.close()
assert not report["errors"], report["errors"]
browser.close()
(OUT / "report.json").write_text(json.dumps(report, ensure_ascii=False, indent=2))
print(
json.dumps(
{"visual": len(report["visual"]), "flows": report["flows"], "artifacts": str(OUT)},
ensure_ascii=False,
)
)
if __name__ == "__main__":
main()