178 lines
27 KiB
Markdown
178 lines
27 KiB
Markdown
# Задачи 001 — Antirion Rework
|
||
|
||
Дата: 2026-11-12. Статус: функциональная реализация проверена; задачи переноса и визуальной приёмки открыты повторно после замечаний пользователя. [Поэтапная проверка дизайна](design-transfer.md). Результаты и ограничения — [verification.md](verification.md), воспроизводимый контракт и запуск — [runtime.md](runtime.md).
|
||
|
||
Основание: [спецификация](spec.md) и [технический план](plan.md). Создание этих документов не закрывает перечисленные задачи разработки. Новые ID T037–T041 добавлены без перенумерации прежних задач; порядок выполнения задаётся этапами и зависимостями.
|
||
|
||
## Правила выполнения
|
||
|
||
- Выполнять этапы A → B → C → D → E → F с контрольными точками ниже.
|
||
- Задача закрывается после изменения, относящейся к нему проверки и записи результата; наличие кода без проверки не равно завершению.
|
||
- Существующие проверки запускаются по характеру изменения; чистые CSS-правки проверяются сборкой и браузером, а не тестами, повторяющими CSS.
|
||
- Несвязанные пользовательские файлы и прототипы сохраняются. Рабочие данные и секреты не используются как место реализации.
|
||
- Результаты реально выполненных проверок записываются при реализации. Не отмечать задачи выполненными по результатам чтения документации или QA mock-прототипа.
|
||
|
||
## A. Подготовка и соответствие документации
|
||
|
||
Зависимость: нет. Выход — проверяемая исходная точка для оформления и сервисов.
|
||
|
||
- [x] **T001** Сопоставить stage7 текущему коду и исправить несовместимые примеры/контракты.
|
||
- Матрица охватывает файловую модель, query/content, visibility, layout/schema Entry, маршруты, csrf/etag, preview, release, DB/MCP-заготовки. Примеры проверены в временной копии сайта.
|
||
- [x] **T002** Сопоставить ADR и зафиксировать границы 001 в документации stage7.
|
||
- История сохранена; реализованные решения отделены от предложений; новые кандидаты/медиа/RBAC/заявки/MCP отнесены к следующей очереди.
|
||
- [x] **T003** Подготовить изолированное окружение и выполнить исходные тесты, validate и build.
|
||
- Зафиксированы команды, результаты и реальные ограничения окружения. Включены server/dev-зависимости; подготовлен способ запускать HTTP/browser QA.
|
||
- [ ] **T004** Зафиксировать визуальные эталоны рабочих экранов и тестовые состояния.
|
||
- Использованы выбранные HTML/CSS; сохранены проверки desktop/mobile, пустых состояний, ошибок, формы входа и данных сайта-примера.
|
||
- [x] **T041** Поставить локальный htmx из flexly-estimator и проверить существующее подключение.
|
||
- Побайтовая копия 2.0.11, SHA-256 совпадает с источником и VENDOR.md; лицензия/источник записаны, статическая раздача и wheel проверены. Это не реализация API или нового редактора.
|
||
- Проверено 2026-11-12: `node --check`; 62 теста обработчиков/редактора и 2 теста упаковки, включая сборку wheel; HTTP smoke через настоящий FastAPI/TestClient (файл/MIME/nosniff, вход, hx-boost-разметка, CSRF/422, конфигурация и allowlist).
|
||
- Тесты обработчиков/редактора запускались на временной копии примера без `.engine`: исходный запуск упёрся в недоступный рабочий `.engine/audit.jsonl`. Рабочие данные и права не менялись. На момент подготовки T041 исполнение htmx в браузере ещё не проверялось; итоговые T023/T032 закрыты реальными Chromium-сценариями, см. verification.md.
|
||
|
||
## B. Оформление рабочих экранов
|
||
|
||
Зависимость: T001–T004. Этап завершается до перехода к новому общему буферу.
|
||
|
||
- [ ] **T005** Перенести стили, токены и ресурсы Antirion Rework в runtime-пакет.
|
||
- Shell/editor/publication не конфликтуют; светлая палитра по умолчанию и тёмная палитра Antirion согласованы; работа не зависит от `design/` на сервере.
|
||
- [ ] **T006** Реализовать общий shell, адаптивную навигацию, диалоги и UI-настройки.
|
||
- Клавиатура, фокус, открытие/закрытие мобильного меню, Esc, возврат фокуса; localStorage содержит только настройки интерфейса.
|
||
- [ ] **T007** Перенести вход, обзор, сообщения и пустые состояния.
|
||
- Реальные статусы сайта/релиза, ошибки входа и недоступного сайта; сохранены текущие защитные заголовки и cookie.
|
||
- [ ] **T008** Перенести списки Page/Entry, поиск, фильтры и просмотр свойств.
|
||
- Проверены q/status/layout, вложенные ID, пустая выдача, выбранный объект и неизвестный ID; представлены реальные file/layout/count/current.
|
||
- [ ] **T009** Перенести формы Page, Block и Entry и существующие операции блоков.
|
||
- Сохранены имена полей и URL, создание draft, слоты/привязки, добавление/порядок/видимость/удаление и семантика формы без изменений.
|
||
- [x] **T010** Перенести существующие публикацию, историю и откат с подтверждениями.
|
||
- Исходный Publication, реальные build candidate/activate и rollback; настоящий diff/preview; CAS Live, видимые ошибки и пустые состояния. Техническая приёмка — verification-publication.md; визуальная проверка пользователя отдельно P006.
|
||
- [x] **T011** Исправить CSP iframe и защищённые ассеты workspace.
|
||
- Браузер загружает пассивное превью; изображения и зависимые ресурсы берутся из workspace; traversal/выход по symlink отклоняется; binary MIME корректен.
|
||
- [x] **T012** Сохранить пользовательские значения при 409/422 на существующих формах.
|
||
- Ошибка не теряет ввод, не выдаёт новый ETag за согласие перезаписать файл и не запускает повторный POST автоматически.
|
||
- [ ] **T013** Принять оформление рабочих экранов по AC-01, AC-08, AC-09 и упаковочной части AC-10.
|
||
- Выполнены подходящие существующие тесты, реальные HTTP/browser-сценарии, адаптивная проверка и проверка wheel со статикой/шаблонами.
|
||
|
||
**Контрольная точка B:** существующие операции работают в новом оформлении. Новый буфер и интерактивное превью ещё не считаются выполненными.
|
||
|
||
## C. Общие сервисы и файловая запись
|
||
|
||
Зависимость: T013. Новые сервисы сохраняют действующие файловые контракты.
|
||
|
||
- [x] **T014** Определить снимки документов, результаты буфера/сохранения/конфликта и контекст автора.
|
||
- Использованы dataclass/Report; сервис не зависит от Request/Jinja, автор получен из проверенной сессии.
|
||
- [x] **T015** Реализовать обновление файла с одним владельцем SiteLock.
|
||
- CAS и актуальная validation находятся внутри цикла обновления; нет вложенного lock/deadlock; отказ не создаёт историю или частичный файл; два писателя проверены.
|
||
- [x] **T016** Выделить PageService и перевести операции Page/Block на него.
|
||
- Чтение, создание, metadata, props, add/delete/toggle/move используют общий validation/save; аудит без дублирования, старые маршруты совместимы.
|
||
- [x] **T017** Выделить EntryService и перевести операции Entry на него.
|
||
- Поля коллекции, статус и Markdown проходят общую проверку; идентичность записи и запрет записи кода сохраняются.
|
||
- [x] **T037** Реализовать основу версионированного JSON API FastAPI и схемы контракта.
|
||
- Зависимость: T014–T017. Явные маршруты `/admin/api/v1/`, Pydantic request/response и error envelope, текущее чтение/создание/изменение документов, пассивное превью и publish/rollback; защищённые OpenAPI/docs и выгрузка схемы. DTO буфера определены; операции развиваются в T019/T020, интерактивное превью — в T026. Dataclass-ядро сохранено.
|
||
- [x] **T038** Реализовать серверный API-клиент UI и внутреннюю авторизацию.
|
||
- Зависимость: T037. httpx включён в server extra; ASGITransport вызывает то же приложение с общим lifespan, синхронные операции не блокируют event loop; credentials связаны с автором/сессией/epoch и не попадают в браузер или логи.
|
||
- [x] **T039** Перевести существующие UI-операции на единый API-клиент.
|
||
- Зависимость: T038. Списки/обзор, Page/Block/Entry, validation, превью и publish/rollback используют контракт API; HTML-маршруты сохраняются, ошибки API не обходятся прямым вызовом сервисов. Вход/сессия/статика остаются в UI.
|
||
- [x] **T040** Проверить API-контракт и реальное прохождение UI → API по AC-11.
|
||
- Зависимость: T037–T039. Реальный FastAPI проверяет реализованные операции: request/response/OpenAPI, единые 401/403/404/409/422, авторство, эпоху/logout, разграничение JSON/HTML и отсутствие обхода при ошибке API. Проверки расширяются в T024/T030/T032; полная приёмка AC-11 выполняется после редакторов/превью.
|
||
|
||
## D. Буфер, Конструктор и «Эксперт»
|
||
|
||
Зависимость: T014–T017, T037–T040. Изменение буфера не означает сохранение файла.
|
||
|
||
- [x] **T018** Отклонять повторяющиеся ключи YAML и проверить безопасный разбор.
|
||
- Покрыты вложенные дубли, aliases, лимиты, запрещённые выражения и корректный текущий сайт; ошибка не приводит к потере текста.
|
||
- [x] **T019** Реализовать получение, проверку и transform буфера без записи.
|
||
- HTML-endpoints под `/admin/editor/` вызывают JSON API через клиент; проверены сессия/Origin/CSRF на UI, credentials на API, вложенные ID, схемы, типизированные действия и прежний ETag основы.
|
||
- [x] **T020** Реализовать явное сохранение полного исходника с ETag, историей и аудитом.
|
||
- API save и HTML-адаптер используют общий контракт; Page/Entry сохраняются одной операцией; slug/path/fixed нельзя изменить в обход правил; клиент получает сохранённый source и новый ETag.
|
||
- [x] **T021** Реализовать общий буфер Конструктора и «Эксперта», дерево и встроенный инспектор.
|
||
- Constructor выбран по умолчанию, Entry использует схему коллекции, layout/display показываются read-only, неприменимый source остаётся в редакторе.
|
||
- [x] **T022** Реализовать подтверждения внутренних переходов с несохранёнными правками через окна интерфейса, скачивание исходника и разрешение 409. Нативные alert/confirm/prompt и beforeunload-диалоги не использовать.
|
||
- Переход режима/документа и уход не отбрасывают правки; две версии доступны; принятие новой основы явно; повторный конфликт обрабатывается.
|
||
- [x] **T023** Настроить htmx и обработку согласованных частичных ответов редактора.
|
||
- Локальная библиотека поставлена в T041; нет inline-выражений/eval/скриптов из ответов и сторонних запросов; 409/422 направляются в нужный регион, не очищают буфер; устаревшие revision игнорируются; истечение сессии и полная форма Save работают по AC-12.
|
||
- [x] **T024** Принять сервисы и редакторы по AC-02–AC-05.
|
||
- Проверены semantic round-trip, сохранение исходника без правок, вложенные слоты, refs/query, Entry, отсутствие файловых изменений до Save и реальный CAS двух вкладок.
|
||
|
||
**Контрольная точка D:** работают общий буфер и ручное сохранение; подготовка интерактивного превью не подменяется mock-iframe.
|
||
|
||
## E. Интерактивное превью
|
||
|
||
Зависимость: T019–T024. Приёмка требует двух действительных origin.
|
||
|
||
- [x] **T025** Добавить SITE_ADMIN_ORIGIN/SITE_PREVIEW_ORIGIN и отдельное приложение превью.
|
||
- Валидируются разные точные origin; приложение не имеет admin/login; описан запуск вторым процессом/контейнером, пассивный режим сохранён при отсутствии конфигурации.
|
||
- [x] **T026** Реализовать временный рендер буфера, ассеты, токены и очистку.
|
||
- API preview и HTML-адаптер возвращают PreviewResult; 600 секунд, подпись с отдельным назначением ключа, привязка к снимку/epoch, проверка каждого ресурса, последние 20 снимков документа/сессии, очистка и маскирование токенов в логах.
|
||
- [x] **T027** Добавить preview-маркировку Renderer с различимыми областями блоков.
|
||
- Page/layout/display и вложенные блоки адресуются однозначно; fixed read-only; лишние контейнеры не меняют layout; обычный рендер не маркируется.
|
||
- [x] **T028** Реализовать служебный скрипт и двусторонний протокол сообщений.
|
||
- Точные origin/source, разрешённые типы, snapshot/revision и блоки проверяются; CSP/sandbox допускают только нужное поведение; wildcard отсутствует.
|
||
- [x] **T029** Связать превью с деревом и инспектором, сохранить viewport и порядок обновлений.
|
||
- Клик preview без scroll, дерево скроллит только при необходимости, изменение props не сбрасывает позицию; hidden/fixed/deleted и быстрые последовательные правки обработаны.
|
||
- [x] **T030** Выполнить security-проверки превью по AC-07.
|
||
- Проверены неверный/истёкший/отозванный токен, чужой снимок, logout, traversal/symlink, поддельные сообщения, запрет admin/login и исполнения скриптов сайта.
|
||
- [x] **T031** Проверить живое превью буфера и неизменность публичной сборки по AC-06/AC-10.
|
||
- Используется новый ассет workspace без публикации; canonical/current не меняются; истечение токена/сбой сервиса не теряет буфер; обычный HTML не содержит bridge/служебных атрибутов.
|
||
|
||
## F. Сквозная приёмка и документация
|
||
|
||
Зависимость: T005–T031, T037–T041.
|
||
|
||
- [x] **T032** Выполнить сквозные сценарии через реальное FastAPI и браузер.
|
||
- Вход/истечение сессии, Page/Entry, режимы, validate/Save/409/422, preview, publish/rollback; настоящий htmx и ASGI-клиент, AC-11/AC-12; результат приложен отдельно от тестов подставного FastAPI.
|
||
- [ ] **T033** Проверить размеры, клавиатуру, фокус, ошибки и reduced motion.
|
||
- 1440/1280/1024/768/390/360 px, палитры Antirion, мобильное меню, таблицы, диалоги, инспектор и отсутствие переполнения страницы.
|
||
- [x] **T034** Выполнить регрессию, validate/build и проверку установленного wheel.
|
||
- Установленный пакет содержит все runtime-ресурсы, работает без `design/`, сохраняет существующие гарантии CLI/core/build/security.
|
||
- [x] **T035** Обновить README, AGENTS.md, stage7 и инструкцию запуска превью.
|
||
- Документация соответствует фактическому состоянию, описывает env, два origin, состояние/очистку токенов, backup тестового сайта и воспроизводимый локальный/Docker-запуск.
|
||
- [ ] **T036** Сопоставить результаты с FR-01–FR-20, NFR-01–NFR-06 и AC-01–AC-12.
|
||
- Приложены результаты и ограничения; незавершённые пункты остаются открытыми; 001 не объявляется готовой по одному визуальному сравнению.
|
||
|
||
## Матрица требований и задач
|
||
|
||
| Требования | Основные задачи | Приёмка |
|
||
|---|---|---|
|
||
| FR-01–FR-03 | T004–T008, T033 | AC-01, AC-09 |
|
||
| FR-04–FR-05 | T009–T013, T022–T023 | AC-01, AC-04, AC-05 |
|
||
| FR-06–FR-07 | T014–T017, T019–T020 | AC-02–AC-05 |
|
||
| FR-08–FR-10 | T015–T024 | AC-02, AC-03, AC-05 |
|
||
| FR-11–FR-13 | T018–T024 | AC-02, AC-04, AC-05 |
|
||
| FR-14–FR-16 | T025–T031 | AC-03, AC-06, AC-07 |
|
||
| FR-17 | T027, T031, T034 | AC-10 |
|
||
| FR-18–FR-19 | T014–T017, T037–T040, T032 | AC-11, AC-12 |
|
||
| FR-20 | T019–T023, T032, T041 | AC-03–AC-05, AC-12 |
|
||
| NFR-01–NFR-02 | T003, T009–T020, T025–T030, T032, T034 | AC-01, AC-07, AC-08 |
|
||
| NFR-03–NFR-04 | T004–T006, T021–T023, T029, T033 | AC-09 |
|
||
| NFR-05–NFR-06 | T011–T015, T020, T026, T031, T034–T036 | AC-03, AC-05, AC-08, AC-10 |
|
||
|
||
Расширенный workflow релизов, медиа/настройки, доступы, заявки и MCP следующей очереди не входят в список выполнения 001; реальный candidate/diff включён уточнением этапа 5. Их порядок и зависимости перечислены в конце `plan.md`.
|
||
|
||
## Прежняя функциональная проверка (визуальная приёмка открыта повторно)
|
||
|
||
2026-11-12: 239 тестов; настоящий FastAPI/ASGITransport; 25 сценариев Chromium на двух origin; 8 экранов и 60 проверок ширины, обе темы, клавиатура и reduced motion; validate/build примеров stage7 — 0 ошибок/0 предупреждений, 7 страниц; wheel установлен вне checkout без design/. Подробная матрица требований, команды и ограничения — [verification.md](verification.md); машиночитаемые результаты — [qa-results.json](qa-results.json).
|
||
|
||
Этапы 1–2 приняты пользователем. Этап 3 (Конструктор/Эксперт Page) подготовлен к проверке: исходные компоненты builder-antirion, реальные дерево/инспектор/каталог/источники, автоматическое применение полей и явное сохранение, дублирование поддерева, перетаскивание, 422 без потери ввода, сравнение/отмена/форматирование исходника. 247 тестов; Chromium — 12 сравнений Конструктора и 6 «Эксперта», 11 групп сценариев; регрессия editor/shell/pages, CLI и установленного wheel — OK. Подробности — [design-transfer.md](design-transfer.md). На момент этой проверки этапы 4–5 оставались открытыми. Их текущий статус приведён ниже; общая пользовательская визуальная приёмка T033/T036 остаётся отдельной.
|
||
|
||
## Повторный перенос: этап 4 / Content (2026-11-17)
|
||
|
||
- [x] **C001** Перенести исходные четыре панели, формы, Expert, диалоги, CSS/SVG и responsive без самостоятельного дизайна.
|
||
- [x] **C002** Подключить настоящие коллекции, поля, связи, использования, схему и поиск/фильтры.
|
||
- [x] **C003** Дополнить API проверкой готовности, CAS-дублированием/удалением, сравнением и настоящим Workspace/Card/Page и Live/Page.
|
||
- [x] **C004** Подключить общую фоновую очередь 003, явное сохранение, видимые 409/422/500/сеть и исходные подтверждения.
|
||
- [x] **C005** Пользователь разрешил переход от Content к этапу 5.
|
||
|
||
Технические проверки и ограничения: [verification-content.md](verification-content.md); доработки: [content-backend.md](content-backend.md). Публикация/история/откат реализованы этапом 5 ниже; общая пользовательская визуальная приёмка остаётся отдельной.
|
||
|
||
## Повторный перенос: этап 5 / Publication (2026-11-17)
|
||
|
||
- [x] **P001** Перенести исходную композицию, CSS/SVG, пять вкладок, таблицу/инспектор и диалоги в принятый shell.
|
||
- [x] **P002** Реализовать private provenance, реальные изменения/историю, build без активации и неизменяемое сравнение кандидата.
|
||
- [x] **P003** Подключить preview готового релиза, подтверждение с комментарием, source/render/output hashes и expected_live под SiteLock.
|
||
- [x] **P004** Подключить действительные историю релизов/аудит, последствия отката и переключение без изменения workspace; видимые ошибки/сеть/конфликты, committed_build и traceback.
|
||
- [x] **P005** Проверить контракт, браузер/ширины/две темы/два preview origin, общий UI и установленный wheel; обновить OpenAPI и документацию.
|
||
- [ ] **P006** Пользовательская визуальная приёмка Publication и итоговых экранов.
|
||
|
||
Границы — [publication-backend.md](publication-backend.md); результаты и команды — [verification-publication.md](verification-publication.md). Общие T004–T009/T013/T033/T036 не закрываются автоматически технической проверкой этого экрана.
|