Платформа Skyforge

Skyforge — платформа для авиамоделистов: цифровой ангар, журнал событий полёта,
инструменты проектирования и документация. Aero Designer — один из инструментов платформы.

Разделы платформы

Все разделы доступны из вертикального сайдбара слева:

Примечание: «Проекты сообщества» (/projects/hub) — будущая доска совместных
проектов (заглушка, в разработке AD-367). Она относится к разделу «Сообщество»
и доступна со страницы /community и из футера.

Справочник

Справочник (/catalog, AD-763 · SFHD-28 → AD-766 → AD-767) — отдельный
корневой раздел платформы: общая база знаний, не привязанная к вашему личному
флоту или складу. До этого «Модели» короткое время были подразделом Ангара
(AD-621) — фидбек основателя пересмотрел решение: раздел равноправен с
Ангаром, Событие полётаами, Вики и остальными пунктами сайдбара, а не вложен в
один из них. Изначально раздел назывался «Справочники» — переименован в
«Каталог» (AD-766), чтобы не путать с одноимённой категорией вики
(/wiki/reference); позже, пересмотром основателя (AD-767), раздел назвали
«Справочник» — а категорию вики заодно переименовали в «База знаний», чтобы
снова не столкнуться именами. Старые адреса /reference и /reference/models
навсегда (301) редиректят на новые (URL /catalog не менялся ни разу).

Наполнение:

• Модели — каталог типов ЛА и их характеристики (общие + ваши, с
  публикацией для сообщества). Адрес страницы — /catalog/models: с AD-1630
  раздел живёт в «Справочнике» и по навигации, и по адресу. Прежний ангарный
  адрес /hangar/models отвечает браузеру постоянным (301) редиректом сюда,
  а без Accept: text/html остаётся JSON-API моделей (API-токены, MCP).
• Комплектующие (/catalog/components, AD-535 — слайс 1 эпика
  «Инвентарь») — справочник типов компонентов: моторы (с подтипами
  электро/калильный/нитро), ESC, серво, пропеллеры, полётные контроллеры,
  приёмники и др., с гибкими характеристиками по категории/подтипу, фото и
  публикацией своих записей. Подробно —
  Справочник комплектующих.
• Аксессуары, Аппаратура — заготовки категорий будущего справочника
  (канопы, крепления, аппаратура управления и пр.), пока помечены «скоро» —
  данные появятся следующими волнами эпика инвентаря AD-535.

Сайдбар

Сайдбар несёт только лого и навигацию по разделам — профиль, вход/выход и
остальные личные контролы живут в верхней панели (см. ниже).

• Свёртывание. Кнопка сворачивания (в верхней панели, слева) сжимает
  сайдбар до иконок и разворачивает обратно. Состояние запоминается в браузере
  (localStorage, ключ skyforge-sidebar) — при следующем визите сайдбар
  откроется в том же виде, без мерцания при загрузке страницы. На узком
  экране (до 980px, телефон) сайдбар всегда свёрнут до иконок, и кнопки нет
  (AD-1781) — переключать там нечего.
• Активный раздел подсвечивается автоматически по текущему адресу.

Верхняя панель

Узкая горизонтальная панель над содержимым страницы (AD-769). Слева — кнопка
сворачивания сайдбара; справа — личные контролы:

• На сайт — обратно на главную страницу сайта / с самолётами (AD-1781);
  только у вошедших: гость и так на сайте, а его «Главная» в крошках ведёт
  на /;
• Профиль — имя и иконка, клик ведёт в настройки /settings;
• Управление сервером — только у администраторов, ведёт в /admin;
• Переключатель языка (RU/EN);
• Выйти / Войти — в зависимости от того, вошли вы или нет.

Раньше (AD-381) все эти контролы жили внизу сайдбара — AD-769 (фидбек
основателя) перенёс их в отдельную верхнюю панель, оставив в сайдбаре только
навигацию.

На экранах шириной до 980px пункты панели показываются значками — подпись
остаётся во всплывающей подсказке; на телефоне отступы ещё и ужаты, чтобы все кнопки
помещались в одну строку. Чем больше пунктов в панели, тем дольше она остаётся
значками: у администратора («Управление сервером») — до 1180px, с
переключателем «Классика / Авиабаза» и кнопкой дня и ночи — до 1280px, у
администратора с ними — до 1500px; иначе на планшете и ноутбуке с развёрнутым
сайдбаром подписи не помещаются. В режиме значков у кнопки дня и ночи тоже
остаётся только значок. Длинное имя в профиле обрезается многоточием (AD-1781).

Страницы, которые видно без входа и которые рисуются отдельно от платформы —
главная / (самолёты SkyForge), рассказ о платформе /welcome, вход и
регистрация, восстановление пароля, «Условия» и «Политика
конфиденциальности», — несут свою узкую шапку: бренд (ведёт на главную) и тот
же переключатель языка. С AD-1652 он именно там, на первом экране: раньше на
этих страницах его приходилось искать в самом низу.

У главной и у /welcome в шапке ещё и навигация сайта (AD-1773): «Самолёты»
(галерея моделей — у тех, кому она открыта), «Платформа» (/welcome) и справа
— «Войти» или, если вы уже вошли, «Мой кабинет» (он же /dashboard со всем
управлением). После входа без адреса возврата вы попадаете сразу в кабинет, а
не на главную. Обратная дорога из кабинета — ссылка «На сайт» в верхней
панели и пункт «Самолёты» в левом меню (AD-1781).

Тёмная тема

Платформа работает только в тёмной теме (AD-422) — переключателя нет.

Инструменты

Блок Инструменты на главной (/dashboard#tools, пункт «Инструменты» сайдбара
ведёт туда же):

Инструменты открываются в собственном интерфейсе (Aero Designer использует
свой layout, не сайдбар Skyforge).

Где документация

• Мини-вики /wiki (вы сейчас в ней): категории, поиск, оглавление страниц,
  перекрёстные ссылки. Пункт Вики в сайдбаре и футере ведёт сюда же.
• Ссылка Документация есть и в футере, колонка «Инструменты».

Дашборд

На главной (/dashboard):

• Статистика флота — сводная панель-плитки по всем вашим бортам (см. ниже);
• Мой флот — до 3 последних бортов, кнопка «+ Добавить борт», ссылка «Весь ангар →»;
• Последние события — до 3 видимых событий, ссылка «Все события →»;
• Последние проекты — до 3 проектов Aero Designer, ссылка «Все проекты →»;
• карточки разделов (Ангар, События полёта, Вики, Сообщество) и блок инструментов.

Статистика флота

Панель-плитки со сводкой по всем вашим бортам (только ваши данные):

• Бортов — всего, с разбивкой «в строю / в музее»;
• Мои модели — только ваши построенные модели (общий каталог не считается);
• Событий — сколько происшествий вы зафиксировали;
• Полётов — число загруженных треков;
• суммарный налёт и дистанция — ЕДИНЫЙ источник: счётчик налёта
  полётного контроллера (одометр, синхронизируется по USB — см. «Ангар»,
  раздел про синхронизацию налёта) КАЖДОГО борта,
  просуммированный по всему флоту. Загруженные треки полёта
  в эту сумму НЕ входят вообще — это карта/маршрут/анализ конкретного полёта,
  а не источник счётчика; поэтому борт с загруженными треками, но БЕЗ хотя бы
  одной синхронизации одометра, вносит в налёт флота 0 (осознанно — синхронизируйте
  налёт борта, чтобы он учитывался);
• рекорды по трекам: макс. высота (над стартом) — набор над точкой взлёта,
  а не абсолютная высота над уровнем моря; макс. время одного полёта;
  макс. скорость — эти три метрики берутся ТОЛЬКО из загруженных треков
  (одометр их не даёт) и показываются, только если хотя бы один трек загружен;
• Самый летающий борт — борт с наибольшим налётом ПО ТРЕКАМ (тоже требует
  загруженных треков, независимо от одометра);
• пара шутливых «антирекордов»: Поставщик музея — сколько бортов ушло
  разбитыми/потерянными (проданные/отданные не в счёт), и Самый невезучий
  борт — с наибольшим числом событий (появляется при повторных).

Данные берутся из треков полёта (вкладка «Полёты»
борта, только для рекордов и «самого летающего борта»), одометра полётного
контроллера (единственный источник суммарного налёта/дистанции) и справочника
флота. Пока не загружен ни один трек И не синхронизирован ни один одометр,
панель показывает подсказку, где добавить трек или синхронизировать налёт.
Если бортов ещё нет — панель скрыта, а начать помогает блок «Первые шаги».

Следующие шаги

• Ангар — заведите модели и борта
• События полёта — журнал отказов и разборов
• Начало работы — первый проект в Aero Designer