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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Название витрины в списке ведёт на её карточку — /gallery/<адрес витрины>.
Карточка тоже открывается без входа и показывает:

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

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

Имя файла в составе издания — ссылка: нажмите на него, и файл скачается.
Ссылки видит только вошедший пользователь: раздать файлы анонимно значит
потерять всякий учёт того, кто их получил. Аноним видит тот же состав файлов
текстом, а вместо ссылок — кнопку «Войдите, чтобы скачать», которая
возвращает на ту же карточку после входа.

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

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

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

Готовится. Счётчик скачиваний на карточке и журнал «кто что скачал»
подключаются следующим шагом — сейчас выдача файла ни того, ни другого не
меняет.

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

Рядом со счётчиком скачиваний карточка показывает, сколько раз её смотрели.
Это число видно и в списке раздела.

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

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

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

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

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

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

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

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

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

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

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

Раздел доступен агенту через два MCP-инструмента:

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

Подробнее про подключение —
ИИ-ассистент и MCP.

Файлы через MCP не отдаются: скачивание остаётся ручкой веб-приложения под
аккаунтом.

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

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