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
+409
View File
@@ -0,0 +1,409 @@
"""Exercise the schema-1 example, public build and real admin on an isolated copy."""
from __future__ import annotations
import argparse
import datetime as dt
import hashlib
import json
import os
import re
import shutil
import tempfile
from html.parser import HTMLParser
from pathlib import Path
from unittest.mock import patch
from urllib.parse import urljoin, urlsplit
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.core.registry import load_site
from site_engine.core.routes import build_route_table
from site_engine.core.validate import validate_release, validate_workspace
from site_engine.errors import EngineError, Report
from site_engine.parsing.frontmatter import parse
from site_engine.parsing.yamlio import load_yaml
from site_engine.services.auth import hash_password
from site_engine.web.app import create_app
EXAMPLE = ROOT / "examples/ai-studio"
NOW = dt.datetime(2026, 11, 12, 12, tzinfo=dt.UTC)
class LocalURLs(HTMLParser):
def __init__(self):
super().__init__()
self.urls = set()
def handle_starttag(self, tag, attrs):
values = dict(attrs)
if tag == "link" and values.get("rel") not in ("stylesheet", "icon"):
return
if tag not in ("a", "img", "link", "script"):
return
value = values.get("href") or values.get("src") or ""
if value and not value.startswith("#") and not urlsplit(value).scheme:
self.urls.add(value)
def files(root):
return {
p.relative_to(root).as_posix(): hashlib.sha256(p.read_bytes()).hexdigest()
for p in root.rglob("*")
if p.is_file() and ".engine" not in p.relative_to(root).parts
}
def main():
parser = argparse.ArgumentParser()
parser.add_argument("--out", type=Path, default=Path("/tmp/ai-studio-qa"))
args = parser.parse_args()
args.out.mkdir(parents=True, exist_ok=True)
baseline = files(EXAMPLE)
report = {"schema": 1, "checks": [], "browser_errors": [], "native_dialogs": []}
checks = report["checks"]
with tempfile.TemporaryDirectory(prefix="ai-studio-qa-") as tmp:
work = Path(tmp)
site, dist = work / "site", work / "dist"
shutil.copytree(EXAMPLE, site, ignore=shutil.ignore_patterns(".engine"))
reg = load_site(site)
issues = Report()
table = build_route_table(reg, issues)
issues.extend(validate_workspace(reg, table))
issues.extend(validate_release(reg, table))
assert not issues.issues, [str(i) for i in issues.issues]
assert load_yaml((site / "site.yaml").read_text())["schema"] == 1
for page_file in (site / "pages").rglob("*.md"):
assert parse(page_file.read_text())[0]["schema"] == 1
local_fragments = [f for f in reg.fragments.values() if not f.builtin]
assert all(f.version == 1 for f in local_fragments)
assert {f.id for f in local_fragments} == {
"entry_cover",
"benefits",
"related",
"steps",
}
assert not any(fid.startswith("ai_") for fid in reg.fragments)
assert all(
reg.fragments[fid].builtin
for fid in (
"hero",
"page_header",
"richtext",
"card_grid",
"faq",
"cta_banner",
"section",
"columns",
"collection_list",
)
)
assert set(reg.collections) == {"services", "scenarios", "cases"}
home_blocks = {b.id: b for b in reg.pages["index"].regions["main"]}
assert home_blocks["hero_home"].fragment == "hero"
assert home_blocks["services_list"].fragment == "collection_list"
assert home_blocks["benefits_grid"].fragment == "card_grid"
assert home_blocks["benefits_grid"].props["variant"] == "features"
assert home_blocks["process_steps"].fragment == "steps"
assert "variant" not in home_blocks["process_steps"].props
assert home_blocks["cta_home"].fragment == "cta_banner"
checks.append("schema_1_and_clean_workspace_release_validation")
checks.append("universal_fragment_ids_and_shared_builtins_without_duplicates")
checks.append("design_block_ids_and_fragment_types_kept_separate")
build = build_site(site, dist, now=NOW)
assert not build.report.issues, [str(i) for i in build.report.issues]
assert build.pages == 14, build.pages
repeated = build_site(site, work / "second-dist", now=NOW)
assert repeated.build_id == build.build_id
assert files(repeated.output_dir) == files(build.output_dir)
checks.append("14_pages_and_deterministic_build_without_database")
public = dist / "current"
home = (public / "index.html").read_text()
assert "Telegram-боты" in home and "AI-ассистенты" in home
assert "Почему нам доверяют" in home and "Под задачу, а не по шаблону" in home
for hidden in ("Исследовательские прототипы", "Академия", "Автоматизация процессов"):
assert hidden not in home, hidden
assert not (public / "services/research").exists()
assert not (public / "drafts").exists()
sitemap = (public / "sitemap.xml").read_text()
assert "research" not in sitemap and "academy" not in sitemap
assert "Автоматизация процессов" in (public / "services/index.html").read_text()
checks.append("featured_queries_and_draft_exclusion")
service_html = (public / "services/bots/index.html").read_text()
for text in (
"/assets/bot.svg",
"Интеграция с CRM и расписанием",
"/scenarios/support/",
"/cases/support-assistant/",
"/contacts/",
"Обсудим похожую задачу?",
):
assert text in service_html, text
assert "Поддержка клиентов" in (public / "scenarios/support/index.html").read_text()
case_html = (public / "cases/support-assistant/index.html").read_text()
assert "Демонстрационный кейс" in case_html and "Учебная служба поддержки" in case_html
assert "Корректность источников" in case_html
assert "data-preview-id" not in service_html
assert "<form" not in (public / "contacts/index.html").read_text()
checks.append("covers_benefits_metadata_refs_cta_and_demo_cases_rendered")
about_html = (public / "about/index.html").read_text()
assert "f-columns--2" in about_html
assert "Принципы" in about_html and "/assets/automation.svg" in about_html
assert "f-steps__items" in about_html and "f-card_grid--steps" not in about_html
checks.append("columns_composition_and_dedicated_steps_coexist")
# Failed publication must retain the working release.
broken_file = site / "content/services/bots.md"
saved_source = broken_file.read_bytes()
broken_file.write_text(saved_source.decode().replace("- support\n", "- missing_scenario\n"))
assert broken_file.read_bytes() != saved_source
try:
build_site(site, dist, now=NOW + dt.timedelta(minutes=1))
except EngineError as exc:
assert "E_REF_MISSING" in exc.report.codes(), exc.report.codes()
else:
raise AssertionError("Broken reference accepted")
assert public.resolve() == build.output_dir.resolve()
broken_file.write_bytes(saved_source)
checks.append("broken_reference_rejected_current_preserved")
env = {
"SITE_ROOT": str(site),
"SITE_DIST": str(dist),
"SITE_STATE_DIR": str(work / "state"),
"SITE_ADMIN_LOGIN": "admin",
"SITE_ADMIN_PASSWORD_HASH": hash_password(PASSWORD, n=2**10),
"SITE_SECRET_KEY": "isolated-ai-studio-browser-" * 3,
"SITE_COOKIE_SECURE": "0",
"SITE_ADMIN_ORIGIN": "",
"SITE_PREVIEW_ORIGIN": "",
}
with patch.dict(os.environ, env), serve(create_app()) as origin, sync_playwright() as pw:
kind = getattr(pw, os.environ.get("QA_BROWSER", "chromium"))
options = {"headless": True}
if kind.name == "chromium":
options["args"] = ["--no-sandbox", "--no-proxy-server"]
if kind.name == "firefox":
options["firefox_user_prefs"] = {"network.proxy.type": 0}
if os.environ.get("QA_BROWSER_EXECUTABLE"):
options["executable_path"] = os.environ["QA_BROWSER_EXECUTABLE"]
browser = kind.launch(**options)
report["browser"] = {"name": kind.name, "version": browser.version}
context = browser.new_context(viewport={"width": 1440, "height": 960})
page = context.new_page()
page.on(
"pageerror",
lambda e: report["browser_errors"].append(
{"message": str(e), "stack": e.stack, "url": page.url}
),
)
def native(dialog):
report["native_dialogs"].append(dialog.message)
dialog.dismiss()
page.on("dialog", native)
routes = sorted(r.route for r in table.values() if r.published and r.kind != "redirect")
responsive = []
linked_urls = set()
for route in routes:
page.set_viewport_size({"width": 1440, "height": 960})
response = page.goto(origin + route)
assert response.status == 200, route
expect(page.locator("main h1")).to_have_count(1)
for img in page.locator("img").all():
img.scroll_into_view_if_needed()
expect(img).to_have_js_property("complete", True)
assert img.evaluate("e=>e.naturalWidth>0"), route
page.evaluate("window.scrollTo(0,0)")
links = LocalURLs()
links.feed(page.content())
linked_urls.update(urljoin(origin + route, url) for url in links.urls)
for width in (1440, 1024, 768, 390, 360):
page.set_viewport_size({"width": width, "height": 960})
assert page.evaluate("document.documentElement.scrollWidth<=innerWidth+1"), (
route,
width,
)
responsive.append([route, width])
if route in (
"/",
"/about/",
"/services/bots/",
"/cases/support-assistant/",
) and width in (
1440,
390,
):
name = route.strip("/").replace("/", "-") or "home"
page.screenshot(path=str(args.out / f"{name}-{width}.png"), full_page=True)
for url in sorted(linked_urls):
if urlsplit(url).netloc == urlsplit(origin).netloc:
assert context.request.get(url).status == 200, url
report["responsive"] = responsive
report["local_urls_checked"] = len(linked_urls)
checks.append("public_pages_images_links_and_70_responsive_checks")
page.set_viewport_size({"width": 1440, "height": 960})
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/")
for collection in ("services", "scenarios", "cases"):
assert page.goto(origin + "/admin/content/" + collection).status == 200
page.goto(origin + "/admin/pages/about")
about_source = page.locator("#document-source").input_value()
frame = page.frame_locator("#preview-result iframe")
page.locator("[data-tree-id=about_columns]").click()
expect(page.locator("#inspectpane")).to_contain_text("Количество колонок")
expect(frame.locator("[data-preview-id=about_columns]")).to_have_attribute(
"data-preview-selected", "true"
)
page.locator("[data-tree-id=body_about]").click()
expect(frame.locator("[data-preview-id=body_about]")).to_have_attribute(
"data-preview-selected", "true"
)
frame.locator("[data-preview-id=about_image] img").click()
expect(page.locator("[data-tree-id=about_image]")).to_have_class(re.compile("selected"))
expect(frame.locator("[data-preview-id=about_image]")).to_have_attribute(
"data-preview-selected", "true"
)
expect(page.locator("#inspectpane")).to_contain_text("Описание изображения")
page.locator("[data-editor-mode=expert]").click()
page.locator("[data-editor-mode=constructor]").click()
assert page.locator("#document-source").input_value() == about_source
checks.append("nested_columns_bidirectional_selection_and_mode_roundtrip")
page.goto(origin + "/admin/pages/index")
page.locator("[data-catalog-open]").first.click()
dialog = page.locator("#builder-catalog-dialog")
for fid, name, description in (
("collection_list", "Список коллекций", "Карточки, получаемые из collection"),
("section", "Текстовая секция", "Заголовок и содержимое секции"),
("richtext", "Markdown body", "Выводит Markdown из файла страницы"),
("card_grid", "Карточки", "Сетка преимуществ"),
("steps", "Этапы", "Три этапа реализации"),
):
item = dialog.locator(f"[data-fragment='{fid}']")
expect(item).to_be_visible()
expect(item.locator("b")).to_have_text(name)
expect(item.locator("small")).to_have_text(description)
expect(dialog.locator("[data-fragment=catalog]")).to_have_count(0)
page.screenshot(path=str(args.out / "fragment-catalog.png"))
dialog.locator("[data-catalog-search]").fill("получаемые")
expect(dialog.locator("[data-fragment=collection_list]")).to_be_visible()
expect(dialog.locator("[data-fragment=section]")).to_be_hidden()
dialog.locator("[data-catalog-search]").fill("card_grid")
expect(dialog.locator("[data-fragment=card_grid]")).to_be_visible()
expect(dialog.locator("[data-fragment=collection_list]")).to_be_hidden()
dialog.locator("[data-catalog-search]").fill("")
dialog.get_by_role("button", name="Данные", exact=True).click()
expect(dialog.locator("[data-fragment=collection_list]")).to_be_visible()
expect(dialog.locator("[data-fragment=card_grid]")).to_be_hidden()
dialog.get_by_role("button", name="Все", exact=True).click()
dialog.get_by_role("button", name="Отмена", exact=True).click()
checks.append("design_catalog_names_descriptions_search_and_categories")
frame = page.frame_locator("#preview-result iframe")
expect(frame.locator("[data-preview-id=hero_home]")).to_have_attribute(
"data-preview-selected", "true"
)
page.locator("[data-tree-id=services_list]").click()
expect(frame.locator("[data-preview-id=services_list]")).to_have_attribute(
"data-preview-selected", "true"
)
expect(page.locator("#inspectpane")).to_contain_text("Какие записи показать")
page.locator("[data-tree-id=benefits_grid]").click()
expect(frame.locator("[data-preview-id=benefits_grid]")).to_have_attribute(
"data-preview-selected", "true"
)
expect(page.locator("#inspectpane")).to_contain_text("Вариант оформления")
page.locator("[data-tree-id=process_steps]").click()
expect(frame.locator("[data-preview-id=process_steps] .f-steps__item")).to_have_count(3)
expect(page.locator("#inspectpane")).to_contain_text("Название этапа")
expect(page.locator('[data-inspector] [name="p.variant"]')).to_have_count(0)
page.locator('[data-inspector] [name="p.items.0.title"]').fill("QA первый этап")
expect(frame.locator("[data-preview-id=process_steps] h3").first).to_have_text(
"QA первый этап"
)
page.locator('[data-inspector] [name="p.items.0.title"]').fill("Разбираемся в задаче")
expect(frame.locator("[data-preview-id=process_steps] h3").first).to_have_text(
"Разбираемся в задаче"
)
checks.append("dedicated_steps_inspector_and_list_edit_reach_preview")
page.locator("[data-tree-id=hero_home]").click()
source = page.locator("#document-source").input_value()
page.locator("[data-editor-mode=expert]").click()
page.locator("[data-editor-mode=constructor]").click()
assert page.locator("#document-source").input_value() == source
page.screenshot(path=str(args.out / "admin-constructor.png"))
checks.append("three_collections_and_localized_constructor_preview_mode_roundtrip")
page_source = (site / "pages/index.md").read_bytes()
page.locator('[data-inspector] [name="p.image_alt"]').fill("QA описание обложки")
expect(page.locator("#document-source")).to_have_value(
re.compile("QA описание обложки")
)
assert (site / "pages/index.md").read_bytes() == page_source
page.locator("[data-save-document]").click()
expect(page.locator("#editor-result")).to_have_attribute("data-saved", "1")
page_meta, _ = parse((site / "pages/index.md").read_text())
assert page_meta["schema"] == 1
assert page_meta["regions"]["main"][0]["props"]["title"] == {"bind": "page.title"}
assert (public / "index.html").read_text() == home
checks.append("page_edit_explicit_save_schema_bindings_preserved_no_publish")
page.wait_for_load_state("networkidle")
page.goto(origin + "/admin/content/services/bots")
entry_original = (site / "content/services/bots.md").read_bytes()
expect(page.locator("[data-inspector]")).to_contain_text("Краткое описание")
expect(page.locator("[data-inspector]")).to_contain_text("Призыв к действию")
page.locator('[data-inspector] [name="p.summary"]').fill("QA новое описание услуги")
page.locator('[data-inspector] [name="p.cta.title"]').fill("QA новый CTA")
page.locator('[data-inspector] [name="p.cta.actions.0.label"]').fill("QA связаться")
page.locator("[data-inspector]").get_by_role(
"button", name="Применить к буферу", exact=True
).click()
expect(page.locator("#document-source")).to_have_value(re.compile("QA новый CTA"))
assert (site / "content/services/bots.md").read_bytes() == entry_original
page.get_by_role("button", name="Сохранить документ", exact=True).click()
expect(page.locator("#editor-result")).to_have_attribute("data-saved", "1")
meta, _ = parse((site / "content/services/bots.md").read_text())
assert meta["summary"] == "QA новое описание услуги"
assert meta["cta"]["title"] == "QA новый CTA"
assert meta["cta"]["actions"][0] == {"page": "contacts", "label": "QA связаться"}
assert meta["related_scenarios"] == ["support"]
assert (public / "services/bots/index.html").read_text() == service_html
page.wait_for_load_state("networkidle")
checks.append("entry_group_list_link_refs_edit_explicit_save_no_publish")
updated = build_site(site, dist, now=NOW + dt.timedelta(minutes=2))
assert not updated.report.issues
updated_html = (public / "services/bots/index.html").read_text()
assert "QA новое описание услуги" in updated_html and "QA новый CTA" in updated_html
assert "QA связаться" in updated_html
checks.append("saved_content_reaches_public_site_after_build")
csrf = page.locator('form[action="/admin/logout"] [name=csrf]').first.input_value()
response = context.request.post(
origin + "/admin/logout", form={"csrf": csrf}, headers={"Origin": origin}
)
assert response.status == 200 and response.url.endswith("/admin/login")
page.goto(origin + "/admin/pages/index")
page.wait_for_url(origin + "/admin/login")
checks.append("login_preview_and_logout_complete_without_http_500")
assert not report["browser_errors"], report["browser_errors"]
assert not report["native_dialogs"], report["native_dialogs"]
browser.close()
assert files(EXAMPLE) == baseline, "QA modified the example"
checks.append("source_example_unchanged")
(args.out / "report.json").write_text(json.dumps(report, ensure_ascii=False, indent=2) + "\n")
print(
json.dumps(
{
"checks": len(checks),
"pages": 14,
"responsive": len(report["responsive"]),
"out": str(args.out),
},
ensure_ascii=False,
)
)
if __name__ == "__main__":
main()