Галерея моделей

Галерея (/gallery) — публичная витрина моделей Skyforge, которые можно
скачать и построить самому: файлы для печати и резки, инструкция, лицензия.

Раздел открывается без входа — это единственная такая страница платформы
(остальные уводят на вход). Инструкции по сборке тоже открываются без входа.
Скачивание остальных файлов, наоборот, требует аккаунта и согласия с
Условиями использования и Политикой приватности: файлы
персональны, каждый выданный экземпляр привязан к аккаунту получателя
(см. Скачивание файлов).

Раздел готовится. Пока включённый фича-флаг design_gallery показывает
галерею только администраторам — так раздел смотрят по мере готовности,
не открывая незаполненную витрину всем. Открытие для всех — отдельное
решение, когда каталог наполнится (эпик «Галерея моделей»).

Свой адрес витрины. Самолёты и галерея переезжают на отдельный сайт —
SkyForge Planes (эпик AD-1782). Пока переезд не включён, всё открывается по
прежним адресам платформы. После включения старые ссылки вида
/gallery/<модель> на платформе сами ведут на тот же адрес нового сайта —
закладки и ссылки из писем и уведомлений продолжают работать.

Как попасть в раздел

• Пункт «Самолёты» в левом меню — первый после «Главной» (AD-1781): это
  витрина продукта, те же самолёты, что на главной странице сайта. Раздел
  корневой, не внутри Ангара: в Ангаре лежат ваши борта, а здесь — наши
  проекты, которые можно скачать; со
  Справочником не путать — там
  техпаспорта любых моделей. До AD-1781 пункт звался «Галерея моделей» и
  стоял рядом со Справочником — из кабинета он не читался как «те самые
  самолёты» с главной.
• Главная страница сайта / (AD-1773) — последняя опубликованная
  модель крупным планом и сетка всех опубликованных моделей со ссылками на их
  карточки, плюс пункт «Самолёты» в шапке.
• Блок «Скачайте готовые модели» на странице о платформе — для
  тех, кто ещё не завёл аккаунт: смотреть галерею можно без регистрации,
  скачать файлы — после входа.

Пункт меню и блок на главной появляются ровно у тех, кому раздел действительно
открыт: пока галерея видна только администраторам, остальные её в меню не
увидят — ссылки, ведущей в «страница не найдена», не будет.

Что показывает список

Карточка в списке минимальна: она отвечает на вопрос «что это за самолёт», а
всё остальное — на странице модели. Данные карточка берёт из двух
источников: издание не дублирует характеристики модели, а ссылается на её
запись в Справочнике моделей.

Кликабельна вся карточка (ссылка — имя модели). Порядок — свежие сверху,
по дате публикации витрины. Правка описания издание наверх не поднимает.

Раскладка зависит от числа моделей: одна — большая карточка во всю ширину,
две — две колонки, от трёх — три; с семи моделей самая свежая стоит
крупной карточкой над сеткой.

У каждой витрины видно
происхождение модели:
у заводской — производитель, у самоделки — автор проекта и ссылка на него,
если она задана. Производителя у самоделки не бывает вовсе, поэтому пустой
графы «Производитель» у неё нет — на её месте стоит автор. Видно это в
таблице характеристик на странице модели.

Поиск и фильтры

Фильтры появляются, когда моделей в разделе шесть и больше, поиск — с
двенадцати: на коротком списке они только мешают его увидеть.

• Поиск — по названию, производителю и алиасам модели: «ворон» находит
  Raven, если алиас задан в справочнике (те же алиасы, что в каталоге моделей).
• Материал — по бытовой категории («3D печать», «Пена», «Дерево»,
  «Композит», «Другое»), а не по конкретному написанию: «EPP» и «пенопласт»
  попадают в одну «Пену».
• Производитель — разные написания одного бренда («AtomRC», «atomrc
  official») схлопнуты в один пункт.

Фильтры и номер страницы живут в адресе страницы: отфильтрованный список
можно переслать ссылкой или сохранить в закладки. Кнопка «Сбросить фильтры»
возвращает полный список.

Список страничный. Поиск ищет по всему разделу, а не по текущей странице,
поэтому «дальше» не сбрасывает фильтры.

Чего в списке нет (и почему)

• Черновиков. В галерее видны только витрины с включённой публикацией.
  Неопубликованная витрина недостижима и по прямому адресу — раздел отвечает
  «не найдено», не раскрывая факт её существования.
• Ссылок на файлы. В списке видно только их количество; состав файлов
  показывает карточка витрины (ниже).

Карточка витрины

Название витрины в списке ведёт на её карточку — /gallery/<адрес витрины>.
Карточка тоже открывается без входа и устроена по образцу витрин
печатных самолётов (Eclipson, Flightory, Planeprint): первый экран —
слева галерея, справа название, кнопка и ключевые числа; ниже — описание,
файлы, список покупок, видео, фото сборок, отзывы и похожие модели.

Первый экран:

• галерея изображений — главное фото и все остальные слоты записи
  справочника (у Kestrel это фото и пять рендеров); миниатюры под главным
  снимком, клик по любому открывает просмотрщик с пролистыванием. Фото
  сборок других пользователей сюда не входят — они в своей секции ниже;
• название, слоган (необязательный) и аннотация;
• отметка: «Новинка» — витрина опубликована не больше 90 дней назад (та
  же правда, что у флагмана на главной), иначе — номер текущей версии;
• кнопка «Скачать бесплатно» — вошедшему прокручивает к составу файлов
  (или к форме согласия, если Условия ещё не приняты), гостя ведёт на вход
  с возвратом на эту же карточку;
• ссылка «Инструкция (PDF)» — если к витрине приложена инструкция;
  открывается без входа;
• четыре крупные цифры — размах, взлётный вес, одна ключевая
  характеристика (нагрузка на крыло, скорость сваливания или масса печати,
  если автор внёс её в характеристики записи под типовым ключом; иначе —
  длина) и число файлов. Числа и единицы — в формате вашего языка; плитка
  без данных за ней просто не рисуется — ложных «0» или пустых ячеек не
  бывает.

Дальше на карточке:

• описание и инструкцию по сборке — что это за модель и на что обратить
  внимание при печати и склейке; отдельно — что изменилось в текущей версии;
• состав файлов — сначала коротко: сколько файлов и каких видов (сетки
  для печати, модели для CAD, инструкция, чертежи), а полный список с
  именами и размерами — по кнопке «Показать все файлы»;
• лицензию и версию — условия использования стоят рядом с составом файлов,
  а не в подвале страницы;
• характеристики — раскрывающаяся таблица из записи справочника
  моделей (размах, вес, длина, мотор, материал, автор проекта и прочий
  паспорт), витрина их не дублирует;
• блок истории (необязательный) — короткий рассказ о замысле конструкции
  и теги-особенности («модульная оболочка», «чистая геометрия» и т.п.); блока
  нет, пока автор не заполнил ни текста, ни тегов;
• «Что понадобится» — список покупок по группам: принтер (стол, сопло),
  пластик (тип и граммы), электроника (мотор, регулятор, сервы, батарея,
  полётник, FPV), радиосистема, крепёж и прочее — с количеством,
  примечанием и ссылкой на магазин, если автор её дал. Ссылки ведут на
  чужие сайты и открываются в новой вкладке. Блока нет, пока список пуст;
• видео — ролики с YouTube. На странице лежит только постер и кнопка;
  постер хранится у нас (сервер скачал его один раз, когда автор добавил
  ролик), поэтому до клика по нему ваш браузер не обращается ни к YouTube,
  ни к какому-либо другому стороннему сайту. После клика в карточке
  открывается плеер YouTube в режиме «расширенной приватности»
  (youtube-nocookie.com): с этого момента им управляет Google по своим
  правилам — в том числе с использованием идентификаторов в хранилище
  браузера. Рядом — ссылка «Смотреть на YouTube» для тех, кто предпочитает
  открыть ролик там;
• фото сборок от других пользователей — только те, которые прошли
  модерацию;
• отзывы — те же, что на карточке модели в справочнике, и та же оценка:
  второго рейтинга у галереи нет. Отзывы на модерации, отклонённые и скрытые
  модератором на публичной карточке не видны никому, включая
  администратора: страница обязана показывать ровно то, что видит гость;
• похожие модели — до трёх других опубликованных витрин (самые свежие,
  теми же карточками, что в списке раздела); секции нет, если других
  витрин в галерее пока нет.

Скачивание файлов

Инструкцию по сборке может открыть любой, без входа: у неё в составе
издания есть ссылка «Открыть». PDF открывается прямо в браузере, файл
другого формата скачивается. Такое открытие никуда не записывается.

Имя остальных файлов в составе издания — ссылка: нажмите на него, и файл
скачается. Ссылки видит только вошедший пользователь, принявший Условия
использования и Политику приватности:

• аноним видит тот же состав файлов текстом, а вместо ссылок — кнопку
  «Войдите, чтобы скачать», которая возвращает на ту же карточку после
  входа;
• вошедший, который ещё не принимал действующие редакции документов, видит
  под составом файлов флажок «Я принимаю Условия использования и Политику
  приватности» и кнопку «Принять и продолжить» — после неё ссылки
  становятся активными. Согласие даётся один раз на аккаунт и запрашивается
  снова только после выхода новой редакции любого из документов.

Файлы персональны. Каждый выданный экземпляр привязан к вашему аккаунту,
и факт скачивания хранится бессрочно (раздел 20 Условий, раздел 23 Политики).
Передавать файлы другим, выкладывать или продавать их можно, только если это
прямо разрешает лицензия, указанная на карточке.

Что важно знать про выдачу:

• файл отдаётся только со своей витрины. Ссылка на файл, подставленная в
  адрес другой витрины, отвечает «не найдено» — как и ссылка на файл
  неопубликованной витрины или на файл, который админ уже удалил из состава;
• имя файла сохраняется, включая русские названия и пробелы: браузер
  сохранит его тем же именем, каким файл подписан в составе издания;
• файл отдаётся потоком — стомегабайтная модель не ждёт, пока сервер
  соберёт её целиком;
• есть ограничение частоты: до 30 файлов в минуту на аккаунт. Скачать
  издание целиком (до 50 файлов) это не мешает — ограничение рассчитано на
  скрипт, выкачивающий каталог подряд.

Скачивание одним архивом — AD-1804 (решение основателя 29.09.2026). Пока его
нет, файлы скачиваются по одному — берите то, что нужно печатать сейчас.

Счётчика скачиваний на страницах витрины нет — это служебная
статистика, а не свойство модели. Выдача учитывается в журнале скачиваний
(отчёт «Скачивания» в админке).

Счётчик просмотров

Платформа считает, сколько раз смотрели страницу модели, — это
статистика для администраторов и авторов, на самих страницах витрины число
не показывается.

Как оно считается:

• анонимно. Платформа не запоминает, кто именно открыл карточку: растёт
  только общий счётчик витрины и общий счётчик раздела в статистике
  востребованности (см. политику приватности, раздел о
  статистике). Журнала просмотров нет — в отличие от скачиваний, где учёт
  поимённый и обещан отдельно;
• без роботов. Карточка публична и её обходят поисковики; запросы
  поисковых краулеров, превью ссылок в мессенджерах и скриптов в счётчик не
  попадают — иначе число показывало бы обход роботов, а не интерес людей;
• перезагрузка страницы счётчик не накручивает: повторные открытия одной
  карточки с того же устройства в пределах пары минут считаются одним
  просмотром. Точность здесь ориентировочная: посетители из одной сети с
  одинаковым браузером в это окно могут посчитаться как один;
• число — до вашего захода: ваш просмотр учитывается и попадёт в
  статистику при следующем подсчёте.

Загрузка своего фото сборки — прямо с карточки. Вошедший пользователь
видит под лентой фото кнопку «+ Добавить фото своей сборки»: загруженное фото
уходит в ту же очередь премодерации, что и фото с карточки модели в
справочнике (второго механизма загрузки нет), и появляется на этой карточке
только после того, как его одобрит модератор — до этого момента фото не видно
даже автору, потому что публичная карточка одинакова для всех посетителей.
Исключение одно: фото, которое загружает сам модератор (администратор),
публикуется сразу — одобрять себя в очереди не нужно, и подтверждение так и
говорит: «Фото опубликовано». Анониму вместо кнопки — «Войдите, чтобы
добавить фото». Фото можно и перетащить мышью на блок с кнопкой — путь
тот же, включая премодерацию (и то же исключение для модератора).

Написать отзыв можно прямо с карточки — форма «Ваш отзыв» (оценка звёздами
и необязательный текст) появляется вошедшему под списком отзывов; анониму
вместо неё — кнопка входа с возвратом на эту же карточку. Отзыв уходит через
ту же ручку, что и на карточке модели в справочнике: оценка учитывается сразу
(отдельного счётчика у галереи нет), а текст — после модерации, как и везде
(см. выше). На чужой отзыв можно пожаловаться кнопкой «Пожаловаться» — она
видна только рядом с чужими отзывами, не со своим.

Справочник и галерея: что где

Разделы похожи (в обоих фото самолётов и характеристики), но отвечают на разные
вопросы:

• Справочник (/catalog/models) — техпаспорт любого
  типа ЛА, включая те, которые мы не делаем: Volantex, Eclipson, самоделки
  других пилотов. Отсюда заводятся борта Ангара;
• галерея — только наши проекты, у которых есть файлы для скачивания.
  У каждой витрины обязательно есть запись в справочнике: характеристики
  карточка берёт оттуда и не дублирует их.

Переходы между разделами есть в обе стороны:

• в справочнике — бейдж «Есть файлы для сборки» на карточке модели (и в
  списке, и на её странице). Бейдж — ссылка на витрину, и он появляется только
  тогда, когда витрина опубликована и в ней есть хотя бы один файл: иначе
  ссылка вела бы на страницу, которой нет, или на пустой список файлов;
• в галерее — ссылка «Собрали? Добавьте борт в свой Ангар» рядом с
  файлами: она открывает на платформе форму добавления борта с уже выбранной
  моделью. Это и есть путь «скачал → построил → учёл в Ангаре».

Бейджи и переходы видны тем, кому открыт сам раздел: пока флаг design_gallery
показывает галерею только администраторам, остальные их не увидят — ссылка вела
бы на «не найдено».

Опубликовать свою модель

Выложить в галерею собственную конструкцию может её автор — без администратора.
Экран — «Мои публикации» в личном кабинете: /settings/publications
(кнопка «Мои публикации» есть и на странице галереи, когда вы вошли).

Порядок такой:

1. Опубликуйте модель в Ангаре. Издание всегда принадлежит вашей
   ОПУБЛИКОВАННОЙ модели справочника: имя, характеристики и фото на странице
   витрины показываются всем, поэтому сначала публикуется сама модель (заявка
   из списка моделей, проходит премодерацию).
2. Создайте издание. На «Моих публикациях» выберите модель из списка —
   там показываются только ваши опубликованные модели, у которых издания ещё
   нет. Издание создаётся черновиком: в галерее его не видно.
3. Приложите файлы. STL/STEP/3MF, PDF-инструкция, DXF-чертёж или ZIP —
   до 100 МБ на файл, до 50 файлов и 500 МБ на издание. Файлы проходят ту же
   проверку содержимого и антивирус, что и остальные загрузки платформы, а их
   объём считается в вашей общей квоте хранилища (5 ГБ — те же байты видны в
   «Все мои файлы»).
4. Заполните описание (кнопка «Изменить»): аннотация, описание, заметки
   по сборке, лицензия, а также слоган героя и блок истории с тегами —
   необязательные лендинг-поля, которые превращают карточку в полноценную
   страницу модели, а не просто список файлов. Полоса характеристик отдельно
   не заполняется — она берётся из ТТХ модели в Ангаре.
5. Выберите оформление. В той же форме — поле «Стиль страницы»: набор
   готовых цветовых пресетов (платформенный по умолчанию, тёплый акцент,
   технический синий, тёмный неон). Оформление меняет ТОЛЬКО цвета —
   кнопка скачивания, список файлов, лицензия и заголовок сайта остаются
   как на любой другой странице платформы; произвольного цвета или своего
   CSS в галерее нет. Пресет применяется сразу — предпросмотра «до
   публикации» нет, но переключить его можно в любой момент, в том числе
   после публикации.
6. Опубликуйте. Кнопка появляется, когда приложен хотя бы один файл —
   пустую витрину опубликовать нельзя. Публикация делает карточку видимой
   всем: в списке галереи, по прямой ссылке и в поисковой выдаче.

Снять издание с публикации можно в любой момент — карточка исчезает из
галереи, файлы остаются приложенными, и публикацию можно включить снова.
Удаление издания удаляет и его файлы; сама модель остаётся в Ангаре и
справочнике.

Изданий у одного автора может быть до 20 — по числу доведённых до публикации
моделей (связь «модель — издание» всегда один к одному).

Для ИИ-ассистента

Раздел доступен агенту через MCP-инструменты (подробнее про подключение —
ИИ-ассистент и MCP):

• list_gallery_releases — список витрин теми же фильтрами, что у страницы:
  «какие модели Skyforge можно скачать, из какого материала и под какой
  лицензией» одним вызовом;
• get_gallery_release — одна витрина по адресу из ссылки: описание, версия,
  лицензия, состав файлов и характеристики из справочника.

Все ссылки в ответах обоих инструментов — полные адреса (url — страница
модели, photo_url — её фото, view_url — инструкция), их можно сразу
отдать человеку: после переезда витрины на свой сайт они ведут уже туда.

Свои издания (экран «Мои публикации») агент ведёт отдельным набором — от
списка со статусами до загрузки файла:
list_my_gallery_releases, create_gallery_release,
update_gallery_release, set_gallery_release_published,
delete_gallery_release, upload_gallery_release_file (файл — base64, до
8 МБ; крупнее — веб-формой или REST), delete_gallery_release_file.

Байты ОПУБЛИКОВАННЫХ файлов через MCP не отдаются: скачивание остаётся ручкой
веб-приложения под аккаунтом. У инструкции в ответе get_gallery_release есть
публичная ссылка на просмотр (view_url) — её можно просто передать человеку.
Принять Условия за пользователя агент не может: согласие даётся только на
карточке, в браузере. Скачивание по API-токену работает, если владелец токена
уже принял действующие Условия в веб-интерфейсе.

Администратору

Как завести витрину, приложить файлы и опубликовать её —
Витрины галереи (администратору). Админ видит и правит
любые издания, включая пользовательские.