Files

178 lines
27 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Задачи 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 не закрываются автоматически технической проверкой этого экрана.