# План реализации и приёмки Акылдаш Основа аудита: `main` на `7ece39f212b67e497a8dfb360d5d271ab088ef57` от 2 ноября 2026 года. Документ хранит результаты UI-аудита, критерии интерфейсной приёмки и порядок подготовки production. Целевые возможности и условия публичного MVP ведутся в [функциональности платформы](platform-functionality.md). ## 1. Статус и границы достоверности Различаем три вида сведений: - **В коде** — наличие исходного кода на указанном commit; это не доказывает, что функция развёрнута или доступна пользователям. - **Историческое наблюдение** — результат конкретного аудита, дата и пределы которого указаны рядом. Оно не является повторной проверкой текущего сайта. - **Цель / gate** — требование, которое нужно выполнить и подтвердить до следующего этапа. На сверенном commit источники кода показывают Backend `0.13.3` (`backend/search/minjust_opensearch.py`), Frontend `0.3.3` (`backend/search/review.html`) и Telegram-бот `0.2.2` (`tools/telegram-bot/bot.py`). Это версии исходного кода, а не подтверждение установленных production-версий. В этом PR согласованы версии в корневом и общем документационном README; `backend/README.md` отдельно называет версию загрузчика `minjust_cbd.py` (`0.9.3`). При новых изменениях сверять версию компонента с соответствующим исполняемым кодом. В Search API и frontend реализованы поиск RU/KY, фильтры, карточка документа, редакции, поиск в тексте, внутренняя лаборатория, вход и административные действия. В коде также есть локальные Noto Sans/Serif с лицензиями, favicon и встроенный SVG-знак бренда. Наличие файлов и ссылок в HTML не подтверждает, что они загрузились в live-браузере. Результаты браузерной проверки приведены только в [отчёте визуальной приёмки](visual-review/README.md). Production readiness не следует из наличия Compose, release workflow или deploy-кода. Подтверждённое состояние и ограничения находятся в [CURRENT_STATE.md](../operations/CURRENT_STATE.md); статус релиза — в [DEPLOYMENT.md](../operations/DEPLOYMENT.md), ограничения backup/restore — в [BACKUP.md](../operations/BACKUP.md), rollback — в [ROLLBACK.md](../operations/ROLLBACK.md), аварийное восстановление — в [RECOVERY.md](../operations/RECOVERY.md). Этот план не повторяет команды из этих runbooks. ## 2. Очерёдность работ ### 2.1 Интерфейс: датированный реестр UI-01—UI-33 Реестр ниже сохраняет исходные наблюдения аудита **23 октября 2026 года** и критерии приёмки; это не список текущих открытых дефектов. Актуальный план на `main` указывает, что все UI-01—UI-33 реализованы в PR #54. Он также описывает follow-up по поиску, кабинету и лаборатории, локальную браузерную проверку и синтетические regression fixtures. Их результаты привязаны к указанным в исходном документе commits и окружению, а не являются повторным live-аудитом в этой документационной задаче. Сверяться с [отчётом visual-review](visual-review/README.md); не открывать снова выполненные пункты без нового воспроизводимого свидетельства. Источники по состоянию на базовый commit этого PR сохранены постоянными ссылками: [UI-план на `7ece39f`](https://git.vakanaut.ru/admin/akyldash/src/commit/7ece39f212b67e497a8dfb360d5d271ab088ef57/docs/product/interface-correction-plan.md) и [план pixel-perfect на `7ece39f`](https://git.vakanaut.ru/admin/akyldash/src/commit/7ece39f212b67e497a8dfb360d5d271ab088ef57/docs/product/frontend-pixel-perfect-plan.md). UI-01—UI-33 вошли в [PR #54](https://git.vakanaut.ru/admin/akyldash/pulls/54) (merge commit [`01380d3c`](https://git.vakanaut.ru/admin/akyldash/commit/01380d3c09d71e32c965d974a39a4d82de0a15c5)); последующий follow-up поиска, кабинета и лаборатории записан в [commit `e5a8326a`](https://git.vakanaut.ru/admin/akyldash/commit/e5a8326a5e3def1bf5d5dc94794da82a2af801ab). В исходном реестре **P1** означает обязательное исправление до визуальной приёмки/выпуска, **P2** — существенное улучшение понятности и последовательности. Отсутствие функции само по себе не считается багом; обозначенные целевые корректировки требуют подтверждения по коду и дизайну. | ID | Приоритет | Историческое наблюдение 23.10.2026 | Требование / критерий | |---|---|---|---| | UI-01 | P1 | При пустом запросе одновременно показывались подсказка и empty-состояние | Разделить initial/loading/results/empty/error; empty показывать после завершённого поиска | | UI-02 | P1 | До выбора документа были доступны действия и пустые select | До загрузки документа показывать понятное приглашение; действия доступны после выбора | | UI-03 | P1 | Фильтры имели горизонтальное переполнение (`clientWidth=194`, `scrollWidth=231` при 1064 px) | Исключить переполнение; длинные списки раскрывать по запросу | | UI-04 | P1 | Действие «Сбросить» обрезалось заголовком | Заголовок и действие видны целиком на поддерживаемых размерах | | UI-05 | P1 | Счётчики отрывались от подписей, переносы растягивали панель | Разделить колонки выбора/подписи/числа; переносить только длинные названия | | UI-06 | P1 | Все 28 видов и 8 статусов были раскрыты, орган и даты находились ниже первого экрана | Показывать основные значения и сворачиваемые группы, сохраняя доступ ко всему каталогу | | UI-07 | P1 | Ширины около 78 px не хватало для RU/KY названий языка | Подбирать размер по самой длинной локализованной подписи без обрезки | | UI-08 | P1 | На 390 px навигация прокручивалась горизонтально, кабинет и фильтры уходили за край | Адаптивно показывать поиск, фильтры и кабинет без горизонтальной прокрутки основных действий | | UI-09 | P2 | Кабинет был малозаметной иконкой во второй строке | Подписанная desktop-кнопка; на mobile — доступное имя и достаточная touch-область | | UI-10 | P1 | Три колонки оставались тесными на 1024/1064 px | Перейти к двухпанельному режиму и скрытию фильтров, не сжимать колонки бесконечно | | UI-11 | P2 | Название документа повторялось в breadcrumb, заголовке и тексте | Breadcrumb обозначает контекст; официальный текст не переписывать | | UI-12 | P1 | Ссылка на источник и toolbar переполнялись на промежуточной ширине | Переносить действия группами без обрезки; сохранять подписи редакции и языка | | UI-13 | P2 | Пустые абзацы и синие ссылки конфликтовали с оболочкой | Нормализовать отступы и ссылки без потери структуры официального текста | | UI-14 | P1 | Таблицы в документе шире панели (`clientWidth=412`, `scrollWidth=834`) | Дать таблице отдельную обозначенную прокрутку; не прокручивать всю страницу по горизонтали | | UI-15 | P1 | Встречались Temp-пути и HTTP-ссылки исходного редактора | Классифицировать ссылки безопасно, не удалять юридический текст; не считать локальные/IP-ссылки проверенными | | UI-16 | P2 | Развёрнутый документ терял поиск, совпадение и toolbar | Сохранять редакцию, язык, позицию и навигацию; обеспечить очевидный возврат | | UI-17 | P2 | Часть KY-интерфейса оставалась на русском | Инвентаризировать строки интерфейса; не заменять переводом язык документа | | UI-18 | P1 | На `/review` отображались два footer, общий footer был выше сохранения | Один footer после основного содержимого и панели сохранения | | UI-19 | P1 | Шапка, формы, панели и footer лаборатории имели разные направляющие | Единая оболочка и совпадающие границы контента | | UI-20 | P1 | Высокая шапка лаборатории отодвигала работу на mobile | Компактный заголовок и помощь; поиск и рабочая область доступны сразу | | UI-21 | P1 | Заголовок кабинета был пустым | Видимый заголовок и доступное имя диалога | | UI-22 | P1 | Не было постоянного крестика; закрытие находилось внизу формы | Крестик 44×44, доступное имя, Escape и возврат фокуса; отмена редактирования остаётся | | UI-23 | P1 | Навигация, выход, профиль и смена пароля были смешаны | Разделить «Профиль» и «Безопасность», отделить выход от формы | | UI-24 | P1 | Окно пользователей открывалось поверх кабинета | Не оставлять конкурирующие модальные окна; сохранять контекст и корректный фокус | | UI-25 | P1 | Список пользователей был длинным модальным окном с закрытием ниже экрана | Отдельный экран списка и короткие диалоги для создания/сброса | | UI-26 | P2 | Создание, удаление, сброс и входные данные смешивались | Действия на строке, отдельное подтверждение удаления, не раскрывать лишние формы | | UI-27 | P2 | Бренд, навигация, шрифты и ссылки различались между экранами | Общие header, logo, button, link, dialog и footer | | UI-28 | P2 | Диалоги закрывались разными способами | Единая модель окна и доступного закрытия | | UI-29 | P2 | Обучение появлялось с задержкой и перехватывало ввод | Запуск по запросу или ненавязчиво до начала ввода; не отбирать фокус | | UI-30 | P2 | Шкала 0–3 переносилась, комментарии всегда занимали место | Полные подписи; допустима сетка 2×2; раскрываемый комментарий без потери текста | | UI-31 | P2 | Пустой экран лаборатории выглядел готовым к отправке оценки | Явное состояние снимка, прогресс и статус черновика; не менять смысл пустой оценки | | UI-32 | P2 | Footer live-сайта показывал «Концепция Түндүк» | Рабочий интерфейс показывает продукт и реальные версии; концепция подписывается только в макете/демо | | UI-33 | P1 | Документ растягивал лабораторию до y≈636935 px, сохранение уходило ниже | Ограничить высоту области чтения и прокручивать её отдельно; сохранение доступно независимо от длины текста | Дополнительные целевые критерии исходного аудита: - **Сетка и ресайз колонок:** desktop — три колонки с доступными разделителями; ориентиры 1440 px: `280 / 408 / 736` плюс два захвата по 8 px, 1280 px: `256 / 384 / 624` плюс захваты. Рекомендуемые пределы фильтров 256–360 px, выдачи от 360 px, документа от 560 px. При недостатке ширины сначала скрыть фильтры, затем показывать документ отдельно. - Разделители должны иметь `role=separator`, доступное имя, min/max/current значения, pointer drag и управление стрелками клавиатуры. Отдельные кнопки скрытия/показа фильтров и сброса ширины обязательны; двойной клик не заменяет доступный сброс. Сохранённая ширина ограничивается текущим viewport. - Остальные правила сетки: фильтры не становятся постоянно прокручиваемой узкой колонкой; полный каталог значений всегда достижим; API single-select не изображается множественными checkbox. Длинное название органа читается в панели выбора полностью. Поля дат имеют постоянные «От» / «До» и переходят в столбец, когда не помещаются. На desktop выдача и документ могут иметь отдельную вертикальную прокрутку с доступными заголовком/toolbar; на mobile основной поток вертикальный с отдельными панелями. Footer использует растущий main (`min-height: 100dvh`), не перекрывает контент и следует за ним; панель сохранения имеет собственное место. - **Панели и формы:** понятный заголовок и крестик 44×44; именованный modal dialog, фокус внутри, Tab/Shift+Tab без выхода в фон, Escape там, где закрытие допустимо, возврат фокуса инициатору; фон не интерактивен. Не наслаивать кабинет и пользователей. Профиль и безопасность — отдельные разделы; права по-прежнему проверяет сервер. В форме пароля постоянные подписи, требования, доступное показать/скрыть и подтверждение нового пароля. Пароли не предзаполнять и не сохранять в материалах аудита; ввод выполняет человек. - Основное действие одно; отмена вторична, выход отдельно; Enter отправляет только активную форму. Ошибка у поля и в доступном сообщении, допустимый ввод сохраняется, loading исключает повторную отправку. Несохранённое редактирование защищено от случайной потери, обычный просмотр закрывается без лишнего подтверждения. После успеха сообщается результат, при ошибке есть путь восстановления; состояние не кодируется одним цветом. - Правила применяются к кабинету, входу, обязательной смене пароля, источникам, созданию/сбросу/удалению пользователя, обучению и просмотру документа. - **Приёмка:** единая оболочка/header/footer; нет общей горизонтальной прокрутки; initial не сообщает об empty до поиска; действия документа активируются по состоянию; keyboard и touch работают; RU/KY подписи и язык документа независимы; таблицы прокручиваются отдельно; тестируются contrast WCAG AA, видимый focus, reduced motion, zoom/reflow и доступные имена. - Viewport: **1440×900, 1280×800, 1024×768, 390×844**, дополнительно 320 CSS px для reflow. Визуальное сравнение — детерминированное fixture; нулевой pixel-diff не является критерием. Авторизация и destructive-сценарии проверяются только в безопасном тестовом контуре. Исторически выполненные браузерные сценарии и ограничения аудита 23.10.2026: | Область | Выполнено в том аудите | Не проверено тогда | |---|---|---| | Начальная страница и поиск RU | Пустой запрос, фильтры, footer; поиск «налог на прибыль», открытие кодекса | Экспертная оценка юридической релевантности | | Фильтры, сортировка, страницы | Статус, chip, снятие фильтра, дата/релевантность, страница 2 и сброс на страницу 1 | Все комбинации справочников | | Пустая выдача и документ | Контрольный заведомо пустой запрос, реальные текст и редакции, язык, разворот | Искусственное создание серверного сбоя, реальная печать/PDF | | Поиск в документе и локализация | Совпадения, переход к следующему, переключение RU/KY и чтение подписей | Поиск после смены редакции; полная проверка всех переводов | | Источники и мобильные фильтры | Открытие/закрытие панели и раздела источников | Внешний сайт Минюста, полный touch на физическом устройстве | | Кабинет и пользователи | Профиль, поля смены пароля, Escape/возврат фокуса; просмотр списка | Ввод пароля, создание/удаление пользователя, сброс пароля | | `/review` | Пустое состояние, поиск, шкала, документ, обучение | Отправка оценки и подтверждение серверного сохранения | | Авторизация | Наличие локальной реализации | Live login, истечение сессии и обязательная смена пароля | Этот перечень описывает только прежний браузерный сеанс. Не использовать его как подтверждение текущих production-сценариев. #### Реализация, зафиксированная в текущем плане `main` UI-план, находившийся на базовом commit этого PR, отмечает UI-01—UI-33 реализованными в PR #54 и связывает группы изменений с регрессионными сценариями: | Пункты | Изменение, зафиксированное в плане `main` | Regression evidence, указанное там | |---|---|---| | UI-01—02 | Разделены initial/loading/results/empty/error; действия документа зависят от выбранной редакции | Empty, API error и редакция без текста | | UI-03—08 | Компактные/сворачиваемые фильтры, счётчики, локализованные языковые select и адаптивная навигация | Reflow 320/390/640/1024/1280/1440; на 640 px проверены основные действия `/`, `/review`, `/users` | | UI-09—10 | Подписанный кабинет и адаптивный layout вместо бесконечного сжатия трёх колонок | Геометрия и overflow на 640/1024/1280/1440 | | UI-11—16 | Breadcrumb, toolbar, отдельный scroll таблиц, очистка небезопасных URL-атрибутов и разворот документа в панели | Синтетические private-IP/relative/HTTP ссылки; ошибки и гонки редакций A/B | | UI-17 | Перевод интерфейсных подписей RU/KY с независимым языком документа | Переключение языка; полный ручной лингвистический review остаётся открытым | | UI-18—20 | Один footer, общие направляющие и ограниченная по высоте лаборатория | Один footer и длинный синтетический документ с собственным scroll | | UI-21—24 | Имя и разделы кабинета, безопасный переход к пользователям без наложенных диалогов | ARIA name, Escape, focus trap/return и отдельные маршруты | | UI-25—28 | Отдельный экран пользователей, целевые окна для действий, общий способ закрытия | Только фиктивный `fixture-created`; реальные аккаунты/API не использовались | | UI-29 | Обучение запускается пользователем | Локальный regression scenario | | UI-30—31 | Оценка 2×2, раскрываемый комментарий, disable до результата и draft state | Фиктивное сохранение и сохранность оценок при ошибке/устаревшем ответе | | UI-32—33 | Версии в footer и отдельная прокрутка длинного текста лаборатории | Footer versions и длинный fixture, сохранение остаётся доступно | Тот же план `main` фиксирует локальный browser run на **320×800, 390×844, 640×450, 1024×900, 1280×800 и 1440×900 CSS px**; на 1280 px измерена сетка 256 / 384 / 640 px. Экран лаборатории с длинным текстом имел собственную панель прокрутки, а сохранение/footer оставались доступны. Встроенная проверка fixture не использовала production API или реальные учётные записи. Это точная передача прежнего отчёта; её не следует трактовать как результат нового прогона в этом PR. Полный screen-reader review, 200–400% zoom, физический touch и полный ручной лингвистический review в исходном плане оставлены непроверенными. Отдельный follow-up в плане `main` описывает реализованные после PR #54 корректировки и regression coverage: - **Поиск:** «Открыт» сбрасывается при смене результата/редакции и ставится только после успешной загрузки. Оглавление распознаёт самостоятельные заголовки RU/KY из структурированных абзацев (`p > b > span`), задаёт уникальные якоря и вложенность, не принимает обычные упоминания за заголовки. Выбор языка поиска находится в фильтрах и не обрезается; декоративный SVG и пустое резервное место удалены; активная навигация использует палитру. Проверены ошибки и гонки загрузки, структура заголовков, splitter и доступность диапазона его ширины. - **Кабинет:** ссылки действий сохраняют `` семантику, крестик остаётся подписанной SVG-кнопкой 44×44, значения профиля стоят в парах «поле—значение», длинные значения переносятся, заголовок компактнее; администратору явно доступно «Управление пользователями». Проверены RU/KY, отсутствие ссылки у не-администратора, фокус/закрытие и ширина. - **Лаборатория:** имя показывается без дублирующей роли; ссылки навигации имеют вид кнопок; оболочка, форма, рабочая область, сохранение и footer выровнены. Пустой live status не резервирует высоту, результаты и документ образуют общую поверхность с внутренней прокруткой на desktop, заголовок использует доступную ширину, а mobile возвращается к естественному потоку. Проверены desktop/mobile, пустой status, сохранение после длинного документа и page overflow. Исходный план сообщает о локальной проверке этих изменений 24 октября 2026 года и повышении frontend до `0.3.0` из-за регулируемой ширины панелей. Текущий source footer и версия кода — `0.3.3`. Его отметка «ожидаются CI и review» относилась к конкретному pushed SHA и не задаёт статус этого или любого нового PR. #### Проверка сценариев публичного MVP Каждый завершённый пользовательский сценарий проходит проверку через `better-interface` с оценкой интерфейса, типографики, цвета, доступности, компоновки и текстов. Перед выпуском публичного MVP провести итоговую комплексную проверку поиска, фильтров и просмотра документа. #### Общие критерии окон и форм - Desktop-окно обычно 480–640 px и не шире viewport; на mobile — отступ 16 px или полноэкранный режим для длинной формы. Заголовок и закрытие остаются доступны при прокрутке. - Диалог именуется через заголовок, держит фокус внутри и не делает фон интерактивным. Escape закрывает обычные окна; исключения (например, обязательная смена пароля) должны объясняться, а не маскироваться. - Профиль и безопасность разделены. Удаление требует отдельного подтверждения; создание/сброс не раскрывают дополнительные формы без запроса. - Поля имеют постоянные подписи; пароль не предзаполняется и не записывается в отчёт. Ошибки объясняют восстановление, допустимый ввод сохраняется, повторная отправка во время loading исключена. - «Отмена» вторична, выход не смешивается с сохранением; несохранённое редактирование защищено от случайной потери. Обычный просмотр закрывается без лишнего подтверждения. #### Последовательность при возобновлении UI-работ 1. Зафиксировать актуальные SHA и версии; читать маршрут, API, `DESIGN.md`, UI tests и CI. Не переносить состояние live-сайта без новой проверки. 2. Исправить общую оболочку и разделение поиска, лаборатории и служебных экранов; затем initial/loading/empty/error и жизненный цикл документа. 3. Исправить фильтры, адаптивные минимумы и RU/KY; после этого — регулируемые колонки и скрытие фильтров. 4. Привести формы/диалоги к общей модели с сохранением серверной авторизации, прав, валидации, снимков оценок и черновиков. 5. Проверить текст, таблицы, ссылки, редакции, печать, адаптивность, локализацию, доступность и состояния на реальном корпусе, где доступен. 6. Сделать детерминированный fixture-проход и независимый review; обновить версию только при изменении кода, а changelog — после зелёных проверок и разрешения blocking findings. Не переносить существующий Python frontend на React/Next.js ради визуальной корректировки. UI-работа не меняет ранжирование, корпус или права доступа. | Приёмка | Условие | |---|---| | Оболочка | Один header/footer на маршруте, единые границы и порядок контента | | Фильтры | Нет общей горизонтальной прокрутки; подписи/действия/счётчики видны полностью | | Начальное состояние | До первого завершённого запроса empty-сообщение не показано | | Документ | До выбора неактивные действия не вводят в заблуждение | | Колонки | Pointer и клавиатура; min/max; скрытие/возврат; reset; адаптация сохранённой ширины к viewport | | Телефон | Основные действия без горизонтального скролла; понятный возврат из фильтров/документа | | Окна | Заголовок, крестик, Escape, trap/return focus; окна не конкурируют слоями | | Лаборатория | Поиск → чтение → оценка → черновик → сохранение; текст не теряется, панель доступна при длинном документе | | Локализация | RU/KY labels и символы; язык UI не подменяет язык документа | | Геометрия | При 1280×800 границы основных зон и отступы/размеры controls отличаются от измеренного fixture не более чем на 2 CSS px; согласованные исключения описаны | | Типографика и таблицы | Noto действительно загружается; читаемый длинный текст; у широкой таблицы собственный скролл | | Доступность | Контраст AA, focus, Tab/Shift+Tab/Enter/Escape, zoom/reflow, reduced motion и touch targets | | Авторизация | Неверный пароль, expired session и обязательная смена проверены только в безопасном тестовом контуре | | Снимки | 1440×900, 1280×800, 1024×768, 390×844 и 320 CSS px; стабильные fixture и объяснённые различия | Допуск **до 2 CSS px** для границ крупных зон и отступов/размеров controls при 1280×800 перенесён из исторического pixel-perfect плана по стабильной ссылке выше. Он применяется к одинаковым детерминированным fixture; расхождения растра, вызванные сглаживанием текста или содержимым, сами по себе не дают основания обрезать или уплотнять юридический текст. #### Нормативный орнамент и фактическое состояние `DESIGN.md` нормативно требует небольшой золотистый SVG-орнамент в свободной нижней части desktop-панели фильтров, не перекрывающий длинные списки и не резервирующий место за счёт управления. Follow-up из commit `e5a8326a` удалил предыдущий декоративный SVG и его пустой резерв; в `backend/search/review.html` на базовом `main` целевого орнамента нет. Это не выполненное требование, а подтверждённое расхождение между `DESIGN.md` и реализацией. Дизайн остаётся нормативным до отдельного решения владельца: UI-задача должна либо вернуть орнамент в свободную область без влияния на управление, либо получить явное одобрение на изменение `DESIGN.md` и подтвердить его визуальной приёмкой. ### 2.2 Инфраструктура и переход к production Инфраструктурные источники содержали повторяющиеся этапы deployment и устаревшие снимки VPS. В этом плане оставлены только gates; актуальные подтверждённые данные и процедуры находятся в операционных документах. 1. **Аудит:** сверить commit `main`, CI, Compose, зависимости, порты, volumes, healthchecks, данные и перечень env-переменных без вывода секретов. Для VPS пользоваться только read-only инвентаризацией, разрешённой [правилами доступа](../operations/ACCESS.md). Не переносить IP, версии, DNS-статус или ресурсы из старых планов как текущие факты. 2. **Данные и конфигурация:** установить источник и допустимость корпуса, формат, состав, checksum/manifest, размер и воспроизводимую цепочку импорта. Обязательный gate любой передачи/публикации корпуса — процедура [CORPUS_HANDOFF.md](../operations/CORPUS_HANDOFF.md): source → staging → inventory/manifest и checksum comparison → атомарная публикация проверенного staging-корпуса в `DATA_ROOT/minjust-normalized` → отдельная проверка и импорт в индекс → OpenSearch alias switch. Runbook требует непустые source и staging, явное решение по исключению code 6 и fail-closed при неполных/несовпадающих данных. Атомарная файловая публикация и возобновление/отказ после прерывания — обязательный, но ещё не реализованный gate; до описания и проверки all-or-nothing механизма не заменять им действующий корпус. Не смешивать его с атомарным переключением OpenSearch alias. Следовать runbook без копирования его команд сюда; до прохождения gates корпус в production не передавать и не индексировать. Не подменять корпус пустым каталогом. Production env/секреты создаются вне Git; в репозитории остаются только имена переменных и шаблоны без значений. 3. **Build/CI:** PR-проверки не получают production secrets и Docker socket. Публикация образов должна фиксировать digest и provenance; release workflow не равен deployment. Production CD не включать до прохождения owner gates, безопасной сборки, backup и отдельного restore. 4. **Контролируемое изменение существующего production:** последняя датированная проверка `https://akyldash.kg/review` вернула HTTP 200 25 октября 2026 года ([CURRENT_STATE](../operations/CURRENT_STATE.md)); установленный на хосте SHA остался неизвестен. План относится к безопасному обновлению существующего сервиса, а не к первому развёртыванию. До изменения проверять реальные данные и конфигурацию, доступное место, опубликованные порты, права, совместимость схем и backup readiness. Выполнять через существующую ограниченную процедуру; не добавлять общие sudo/Docker- привилегии. Базы данных и внутренние сервисы не публиковать в интернет. DNS, reverse proxy и TLS проверять до выпуска; для Cloudflare применять Full (strict). SSH/UFW и сетевые ограничения меняются только после owner approval. 5. **Проверка и recovery:** проверять health/API, RU/KY canaries, доступность HTTPS, сохранность данных и rollback в пределах его документированных ограничений. Data restore — отдельная процедура в staging, не автоматический побочный эффект отката образа. 6. **Автоматизация:** только после одобренного отдельного bootstrap и end-to-end проверки; serial deployment, digest verification, backup ACK, health gates и отказ без destructive cleanup. Не включать триггер только потому, что workflow завершился зелёным. **Backup/maintenance gate:** настройки CI, проверка конфигурации и подготовка release provenance должны быть отделены от production cutover. Production CD в `CURRENT_STATE.md` остаётся неактивным. Перед каждым фактическим production изменением, включая миграции, создать и проверить внешний pre-change backup. Полный cold backup требует остановки Compose и может выполняться только в заранее согласованное с владельцем окно. Ни полный архив, ни его временная копия никогда не записываются на VPS. По текущей утверждённой схеме архив передаётся напрямую на фиксированный `D:\Dev\akyldash\.backups`; фактическая готовность D:, SSH и отдельное восстановление всё ещё не подтверждены. На VPS остаётся только secret-free идентификатор/manifest согласно `BACKUP.md`. Политика — одна retained, проверенная внешняя копия. При замене прежняя копия сохраняется до тех пор, пока новый candidate не опубликован и не проверен; на время этой проверки две копии могут сосуществовать. После подтверждения новой копии retention может изменить только владелец явным решением; автоматическая очистка запрещена. При неудачной публикации или проверке прежняя подтверждённая копия остаётся. Локальные VPS cold-backup команды из старых документов superseded и использоваться не должны. #### Локальные generated reports `/reports/` и `/tmp/` игнорируются по умолчанию, чтобы generated bulk не попадал в обычный `git status`. Уже отслеживаемые historical evidence остаются отслеживаемыми. Если конкретный отчёт нужен в Git, сначала проверить его содержимое, удалить секреты, персональные данные, production corpus и временные файлы, затем добавить только предназначенный к публикации файл явной командой `git add -f reports/`. Не добавлять каталоги целиком. Нынешний статус не переопределяется этим roadmap: на сверенной документации production CD остаётся неактивным, а backup/restore и внешний bootstrap имеют непроверенные owner prerequisites. Все точные блокировки сверять с `CURRENT_STATE.md` и `DEPLOYMENT.md` перед планированием действий. ## 3. Визуальные материалы и исходная база ### Макеты Figma Целевые редактируемые экраны — гипотезы компоновки, а не работающий интерфейс, источник юридических данных или доказательство доступности. | Экран | Макет | |---|---| | 01. Поиск с документом, 1440×900 | [Figma](https://www.figma.com/design/3PE98PJYOXo7a35u2X5VqB?node-id=3-2) | | 02. Фильтры скрыты | [Figma](https://www.figma.com/design/3PE98PJYOXo7a35u2X5VqB?node-id=3-173) | | 03. Начальный поиск | [Figma](https://www.figma.com/design/3PE98PJYOXo7a35u2X5VqB?node-id=3-288) | | 04. Лаборатория и сохранение | [Figma](https://www.figma.com/design/3PE98PJYOXo7a35u2X5VqB?node-id=3-395) | | 05. Кабинет: профиль и закрытие | [Figma](https://www.figma.com/design/3PE98PJYOXo7a35u2X5VqB?node-id=5-30) | | 06. Кабинет: безопасность | [Figma](https://www.figma.com/design/3PE98PJYOXo7a35u2X5VqB?node-id=5-229) | | 07. Источники | [Figma](https://www.figma.com/design/3PE98PJYOXo7a35u2X5VqB?node-id=5-428) | | 08. Пользователи: отдельный экран | [Figma](https://www.figma.com/design/3PE98PJYOXo7a35u2X5VqB?node-id=5-605) | | 09–11. Телефон: выдача, чтение и фильтры (общий Figma-узел) | [Figma](https://www.figma.com/design/3PE98PJYOXo7a35u2X5VqB?node-id=5-670) | | 12. Эталон 1280×800 | [Figma](https://www.figma.com/design/3PE98PJYOXo7a35u2X5VqB?node-id=7-74) | | 13. Планшет: две панели | [Figma](https://www.figma.com/design/3PE98PJYOXo7a35u2X5VqB?node-id=7-245) | | 14. Кабинет на телефоне | [Figma](https://www.figma.com/design/3PE98PJYOXo7a35u2X5VqB?node-id=7-360) | | 15. Вход, создание и подтверждение удаления | [Figma](https://www.figma.com/design/3PE98PJYOXo7a35u2X5VqB?node-id=8-118) | Локальные target exports: [поиск](../design/tunduk-search-target.png), [лаборатория](../design/tunduk-review-target.png), [кабинет](../design/tunduk-account-target.png). Это изображения цели; они не заменяют браузерную проверку. В Figma экраны собраны из редактируемого текста, Auto Layout, SVG, локальных переменных цвета/отступов и общих экземпляров кнопок; это не один растр. Состояния 09–11 ведут на один общий мобильный узел, как в исходном плане. Прокрутка длинной выдачи/текста показывает продолжение содержимого. Splitter, закрытие и формы описывают целевое поведение, но не являются работающим web-кодом. ### Исторические свидетельства Аудит UI выполнен **23 октября 2026 года** в авторизованной сессии на `https://akyldash.kg/`, где footer показывал Frontend `0.2.3`, Backend `0.13.0`. Сверка SHA сервиса с checkout не выполнялась. Проверены 1440×900, 1280×800, 1024×768, 390×844 CSS px и дополнительный browser viewport 1064×1244. Пароли не вводились; создание/удаление пользователей и отправка оценки не выполнялись; полный физический touch, screen-reader и принтерный прогоны не выполнялись. Существующие локальные browser evidence и screenshots собраны в [отчёте visual-review](visual-review/README.md). Ветка `main` не содержит отдельный архив live screenshots этого аудита. Любое использование результатов требует повторной проверки актуальной версии и окружения. ## 4. Постоянные правила дизайна и полномочия [DESIGN.md](../../DESIGN.md) остаётся нормативной дизайн-системой: цветовые токены, типографика, бренд, композиционные принципы и доступность не дублируются здесь. Этот roadmap задаёт работы, исторические критерии и gates; он не утверждает новый дизайн и не разрешает production deployment. Все пункты плана отмечать выполненными только при наличии актуального свидетельства. Изменения приложения проходят обычные тесты, версионирование, CI и независимое review. Инфраструктурные изменения отражаются в `CURRENT_STATE.md` только по фактическим проверкам. Никакие действия с production, секретами, пользователями или правовым корпусом не следуют из наличия этого документа. Root-only bootstrap и предоставление секретов выполняет/утверждает владелец в защищённой среде; DEV готовит проверяемый код и точный план, reviewer независимо проверяет безопасность и failure paths.