Один фреймворк на все self-hosted FastAPI-приложения: 404 автотеста для Kanban-доски, учётной системы и CPA-трекера. Playwright, эфемерная SQLite, GitHub Actions CI.
E2E-тестирование веб-приложения — это всегда один и тот же каркас: поднять приложение на чистой базе, дождаться готовности, авторизоваться, открыть браузер, действовать от имени пользователя, прибраться за собой. Каркас один, а приложения разные: у доски drag-and-drop и файлы, у учётной системы — табличные документы и деньги в минорных единицах, у трекера — HTTP-пайплайн кликов и постбэков.
Задача — собрать каркас один раз в общее ядро, а всё, что различается, вынести в декларативный профиль приложения. Требование жёсткое: подключение нового приложения не должно требовать правки ядра. Имена приложений для ядра не важны — важна архитектура.
karkase2e — один фреймворк на все self-hosted FastAPI-приложения проекта: 404 теста (168 на доску задач, 106 на учётную систему, 130 на трекер), ядро без единого упоминания имён приложений. Smoke-набор каждого приложения проходит меньше чем за полминуты, полный набор — за минуты. Новое приложение подключается одной папкой-плагином: конфиг, профиль доменных полей, страницы и тесты.
Ядро karkas_testkit ничего не знает о приложениях: единственный шов — замороженная dataclass AppConfig, которую строит плагин. Всё остальное — сервер, авторизация, страницы, формы, отчётность — общее.
Одна frozen-структура описывает всё, что различается: env-префикс, uvicorn-цель, путь readiness, тестиды формы логина, флаг uploads-каталога. load_app_config() читает YAML, применяет KARKAS_*-переопределения и импортирует app.py плагина по пути файла (дефис в имени пакета регистрируется синтетическим модулем).
Поднимает приложение subprocess'ом uvicorn на эфемерной SQLite и свободном порту (portpicker), ждёт готовности по readiness-пути, прогоняет seed-demo, после прогона удаляет временную базу.
Логин через raw http.client с чтением Set-Cookie из 303-редиректа — urllib при редиректе cookie теряет. Cookie зеркалится в Playwright storage_state: каждый тест стартует залогиненным, но в свежем контексте, поэтому logout и смена локали не каскадируются.
FieldType/FieldSpec описывают типы полей (деньги в минорных единицах, reference-поля с пикером, COLOR/FILE), type-aware filler заполняет формы, проверки Excel-экспортов — через openpyxl.
Базовые маркеры smoke/auth/flow/contract/unit плюс динамические маркеры каждого приложения (board, card, catalog, document, campaign, pipeline…): 14 smoke-тестов — 20 секунд, 404 теста — минуты.
При падении сохраняются скриншот браузера и дамп серверных логов за время прогона; GitHub Actions повторяет тот же сценарий на каждый push.
Один фреймворк вместо трёх копий: меньше поддержки, быстрее новые приложения.
автотеста на 3 приложения
168 — Kanban-доска (DnD через SortableJS, файлы, голосование), 106 — учётная система (документы, проводки, деньги), 130 — CPA-трекер (пайплайн кликов и постбэков без браузера).
упоминаний приложений в ядре
Всё, что различается, живёт в AppConfig плагина. Ядро не менялось при подключении всех трёх приложений.
smoke-набор приложения
Логин, ключевые страницы и health-check; полный прогон с браузером — минуты, для трекера — вообще без браузера.
для нового приложения
app.py с AppConfig, профиль доменных полей, страницы и тесты. Шаблон и промпт для AI-агента — в docs/ADD-NEW-APP.md.