Интерактивный лендинг вымышленного гражданского летательного аппарата. Прокрутка поворачивает КЕДР, разбирает его на узлы и собирает обратно; в конце можно выбрать комплектацию и скачать спецификацию.
- Три главы анимации на canvas: облёт, разборка и сборка. 240 кадров для каждой из двух адаптивных версий.
- Интерактивная схема узлов и локальный конфигуратор с экспортом текстового файла.
- Фильм загружается только после нажатия «Смотреть фильм».
- Управление с клавиатуры, возврат фокуса после закрытия диалогов и статичный режим при
prefers-reduced-motion. - Локальные шрифты и медиа. Без API-ключей, бэкенда, сторонней аналитики и отправки заявок. Выбор комплектации хранится только в
localStorage.
Стек: Vite 8, JavaScript, CSS, Canvas 2D, Playwright, ESLint, Prettier. Прямые npm-зависимости закреплены точными версиями; GitHub Actions — SHA коммитов.
Рекомендуется Node.js 24 (версия указана в .nvmrc); минимальная версия — 22.12. Для локальных браузерных тестов нужен установленный Google Chrome.
git clone https://github.com/furrydev2007/kedr-01.git
cd kedr-01
npm ci
npm run devОткройте адрес из вывода Vite. Сборка для статического хостинга в корне домена:
npm run build
npm run previewПубликуется только содержимое dist/. Preview-сервер предназначен для локальной проверки, а не для production.
| Команда | Назначение |
|---|---|
npm run dev |
Локальная разработка |
npm run build |
Проверка комплекта медиа и сборка dist/ |
npm run preview |
Просмотр собранного сайта |
npm run format |
Форматирование исходников и документации |
npm run check |
Форматирование без записи, ESLint и модульные тесты |
npm run test:e2e |
Браузерные сценарии на desktop и mobile |
Тесты проверяют диапазоны кадров, пути GitHub Pages, навигацию по главам, загрузку медиа, конфигуратор, скачивание файла, управление фокусом и reduced motion. Локально используется изолированный headless Chrome, в CI — Chromium из Playwright; личный профиль браузера не затрагивается.
.github/workflows/ Проверки pull request и публикация main
public/
media/ Готовые кадры, постеры и фильм
fonts-licenses.txt Лицензии распространяемых шрифтов
scripts/ Проверка медиа и визуальная проверка
src/
main.js Canvas, навигация, диалоги и конфигуратор
sequence.js Загрузка кадров, приоритеты и ограниченный кэш
style.css Дизайн и адаптивные состояния
tests/ Модульные и браузерные тесты
index.html Семантическая разметка страницы
dist/, зависимости, тестовые отчёты и рабочие материалы из output/ не входят в Git. Конфигурационные файлы редактора и файлы с секретами также исключены.
При сборке WebP объединяются в 15 пакетов по 16 кадров для каждого размера экрана — без перекодирования и потери качества. Вместо 240 запросов браузер делает 15. npm run dev и npm run build создают пакеты автоматически в игнорируемой папке public/media/packs/; исходные кадры остаются в Git. При замене изображений измените FRAME_PACK_VERSION в src/sequence.js, чтобы новые пакеты не пересекались с браузерным кэшем предыдущего набора.
Загрузчик хранит сжатые WebP-файлы отдельно от декодированных кадров. Поэтому возврат к уже скачанному участку не требует новых HTTP-запросов. Очередь заранее загружает пакеты по направлению прокрутки, а подготовка изображений ограничена двумя параллельными задачами. В памяти остаются не более 28 декодированных кадров на телефоне и 40 на компьютере; удалённые ImageBitmap освобождаются явно. Неизменившийся кадр не перерисовывается.
Повторяемый замер production-сборки или опубликованного сайта:
node scripts/measure-sequence.mjs https://fdev007-private.github.io/kedr-01/ --mobile --throttleСкрипт прокручивает анимацию вперёд и назад с холодным и прогретым кэшем. Профиль --throttle задаёт 5 Мбит/с, задержку 150 мс и замедление CPU в 4 раза. Это лабораторная эмуляция, а не измерение реального телефона. exactFramePercent сравнивает желаемый и действительно показанный кадр на каждом animation frame; repeatRequests показывает повторные запросы. Тесты также проверяют границы кэша, освобождение памяти, отмену загрузок и режим без ImageBitmap.
Workflow Check and deploy проверяет форматирование, линтер, модульные тесты, production-сборку и браузерные сценарии. Pull request только проверяется; успешный push в main публикует сайт. Возможен ручной запуск из Actions.
В Settings → Pages → Source должен быть выбран GitHub Actions. Дополнительные ключи не нужны: используется штатный GITHUB_TOKEN, право публикации есть только у deploy-job.
Базовый путь берётся из настроек Pages. Проверка production-сборки по адресу /kedr-01/ в PowerShell:
npm run build -- --base=/kedr-01/
$env:PAGES_BASE_PATH = '/kedr-01/'
$env:PLAYWRIGHT_PREVIEW = 'true'
npm run test:e2e
Remove-Item Env:PAGES_BASE_PATH, Env:PLAYWRIGHT_PREVIEWПроверка уже опубликованного сайта без локального сервера:
$env:PLAYWRIGHT_BASE_URL = 'https://fdev007-private.github.io/kedr-01/'
npm run test:e2e
Remove-Item Env:PLAYWRIGHT_BASE_URLПри смене репозитория или домена обновите ссылки в этом файле, package.json, canonical и Open Graph URL в index.html.
Изображения и видео аппарата созданы с помощью AI для этого концепта. Визуальной отправной точкой послужил pear.no; сайт не связан с этим проектом. КЕДР 01 — художественная концепция, а не предложение продажи или подтверждение лётных характеристик.
В Git входят только готовые WebP-кадры (1280×720 и 768×432), три изображения и MP4-фильм. Сырые генерации, PDF, монтажные архивы и служебные параметры остаются локально.
Шрифты Manrope и Cormorant Garamond поставляются через Fontsource; уведомления авторов и SIL Open Font License 1.1 находятся в public/fonts-licenses.txt и включаются в сборку. Лицензия самого проекта пока не выбрана.
Порядок внесения изменений: CONTRIBUTING.md.
