# Koobique R3 — окончательный план реализации

16 октября 2026 года. Основание: полный источник R2, два отчета ревью и уточненный запрос пользователя. Предыдущего готового R3 нет. Этот план принят в работу, а не является предложением на следующую итерацию.

## Результат

Статическая книга на https://koobique.iqui.page с 51 главой, последовательным чтением, непрерывной версией, поиском, оглавлением, источниками, атласом конструкции, интерактивными объяснениями и журналом инженерных решений. Полные исходники, воспроизводимая сборка, отчет приемки и архив выпуска передаются вместе с сайтом.

## Редакция и контракты

Сначала фиксируется инвентарь исходных 1758 смысловых единиц, вводных частей, вопросов, терминов, таблиц, формул, рисунков и источников. Для каждого исправления сохраняется исходный идентификатор и объяснение изменения. Сайт, непрерывная версия и поиск собираются из одного контентного графа. Исходный R2 хранится отдельно как исторический материал.

Каждое замечание обоих ревью получает решение: исправлено, уточнено, отклонено с обоснованием или оставлено открытым с проверяемым условием закрытия. Подтвержденный дрейф протокола устраняется единым реестром, из которого генерируются представления Rust, Kotlin, JSON Schema и таблицы сайта. Отрицательные примеры и эталонные сообщения проверяются. Это проверка контрактов, а не утверждение о готовой MCU-прошивке.

E0 сохраняет безопасную и выполнимую модель: PIR не доказывает отсутствие или следующий вход; ручной OFF удерживает HOLD до явного разрешения; перезапуск имеет отдельный BOOT_INHIBIT. Временная блокировка до следующего входа остается возможностью E1 после появления квалифицированного распознавания. Client API отделяется от Core↔Node. Смена владельца описывается как распространение полномочий на каждый узел с состоянием pending для недоступных узлов. Недоказанные свойства криптографии, восстановление и аппаратные испытания не закрываются редактурой.

Нарратив строится вокруг комнаты, измерения, оценки, модели, выбора, исполнения и проверки эффекта. Основной текст переводится в связную прозу; таблицы, код и точные формулы сохраняют форму. Списки в исходных схемах превращаются в подписи без маркеров, не теряя смысл. E0, E1 и E2 обозначают зрелость, а не обещание доступных функций.

## Веб-издание

Статический генератор строит HTML для всех маршрутов; Vite собирает локальные ресурсы, а Three.js загружается только для сцен. Это позволяет читать книгу без клиентского фреймворка и серверной базы. Все шрифты, скрипты и текстуры размещаются вместе с сайтом. Поиск работает локально. Глава имеет постоянный адрес, ссылки на разделы и переходы назад/вперед. Прогресс сохраняется только в браузере читателя и может быть сброшен.

Визуальный язык: светлая минеральная поверхность, графитовая типографика, крупная редакционная композиция, серебристые и темные физичные материалы, локальный кобальтовый акцент. По видео проверяются предметность, деталировка, качество света, естественность взаимодействия и устойчивость композиции при увеличении. Органические модели птиц и насекомых не копируются: для Koobique важна инженерная достоверность собственного объекта.

Технический 3D-дизайнер, инженер real-time-графики, редактор, архитекторы ПО/аппаратной части и основной исполнитель работают раздельно по областям. Это агентные роли, не привлеченная внешняя студия. Направление UI и motion ведет основной исполнитель.

## Сцены и объяснения

Станция показывает каркас, оболочку, фильтр, вентиляторы, вычислительную плату и питание; разнос и режим воздушного потока объясняют доступ и компоновку. Измерительный узел показывает расположение датчиков и ограничения измерения около источников тепла. Исполнительный узел разделяет управление, питание нагрузки и свидетельство физического эффекта. Комната связывает окно, рабочую зону, освещение и размещение устройств. Четыре физические сцены покрывают семь тем исходного предложения за счет режимов, а не семи одновременно работающих WebGL-контекстов.

Цикл физического интеллекта, доверие и ручное управление получают интерактивные 2D/2.5D-представления. Электрические соединения, таблицы состояний и код остаются плоскими. Каждая сцена имеет подпись о статусе, управление клавиатурой через внешние кнопки, восстановление вида и статическое представление. Неподтвержденные зазоры и размещение явно отделяются от размеров, заданных в R2.

## Движение

Один выразительный вход в обложку и управляемый разнос объекта задают характер. Переходы глав, выделение деталей и объяснения согласованы по длительности. Обычная прокрутка не перехватывается. Вне экрана рендер останавливается; число пикселей и качество ограничены на мобильных устройствах. Режим reduced motion убирает автоматическое движение. Текст и ссылки доступны до загрузки сцен.

## Приемка

Миграция принимается по идентификаторам и полям, а не по числу страниц. Проверяются 51 глава, все исходные units, вводные/вопросы/термины, 63 таблицы, формулы, 68 схем и 178 источников; исправленные единицы сверяются с журналом. В HTML не должно оставаться неразрешенных math-токенов, битых внутренних ссылок и потерянных якорей.

Функциональный прогон охватывает чтение, оглавление, поиск с результатом и без него, прямые ссылки, восстановление прогресса, сброс, увеличение схем, выбор объекта, разнос и возврат, состояния интерактивного E0. Отдельно проверяются отсутствие JS, WebGL fallback, потеря контекста, reduced motion, клавиатура и узкий экран. Движение проверяется в реальном браузерном WebGL-контексте, не только компиляцией шейдеров.

Визуальный проход проводится на desktop и mobile: первый экран, подробная сцена, длинная глава, плотная таблица, формула, поиск и раскрытая схема. Проверяются контраст, интервалы, отсутствие обрезания и управляемость касанием. Замеры производительности указывают конкретный браузер и режим; эмуляция не называется испытанием физического телефона.

## Публикация

Перед развертыванием проверяются DNS, HTTPS и действующие виртуальные хосты. Публикуется только каталог Koobique; другие приложения сервера сохраняются. Выпуск загружается в отдельный каталог с контрольной суммой, переключается атомарно и имеет откат. После публикации повторяются HTTP/TLS, маршруты, ресурсы и ключевой браузерный сценарий. Пароли не попадают в исходники, архив и отчет.

## Условие завершения

Каждый пункт сопоставляется с фактическим артефактом и результатом проверки. Если аппаратный, криптографический или субъективный критерий не доказан доступными средствами, он получает конкретный открытый статус, а не формулировку «все проверено». Оценка визуального качества сопровождается изображениями и замечаниями, но не подменяет независимую студийную или аппаратную приемку.