Справочник комплектующих

Комплектующие (/catalog/components, AD-535) — каталог ТИПОВ компонентов
в разделе Справочник: мотор «T-Motor 2808 1300KV»,
серво «HS-311», регулятор, пропеллер и т.д. Это справочные записи о типах
железа, а не ваш личный склад: как за бортом в Ангаре стоит модель из каталога
моделей, так за будущим складским остатком (эпик «Инвентарь») будет стоять
запись этого справочника.

Категории и подтипы

Каждая запись относится к категории: Двигатель, Регулятор (ESC),
Серво, Пропеллер, Полётный контроллер, Приёмник,
Рама / планер, Другое.

У категории может быть подтип — у двигателей это
электрический / калильный (ДВС) / нитро (топливный): у них разные
характеристики (у электро — KV, ток, мощность, банки LiPo; у калильных и
нитро — объём в см³, топливо, свеча). Набор категорий и подтипов расширяемый —
новые появляются по мере развития справочника.

Характеристики

Характеристики — гибкий набор пар «название → значение». При выборе категории
и подтипа форма подсказывает типовой набор (например, для электромотора: KV,
макс. ток, макс. мощность, банки LiPo, масса, вал) — лишнее удалите, свои
поля добавьте. Жёсткого списка нет: любые характеристики до 40 на запись.

Масса и габариты

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

Импорт со страницы производителя (по URL)

Чтобы не вводить характеристики руками, компонент можно импортировать по
ссылке: кнопка «Добавить по URL» → вставьте адрес страницы компонента на
сайте производителя или магазина. Система прочитает страницу, извлечёт
название, производителя, категорию/подтип, характеристики (по типовому
набору категории) и фото — и создаст приватную запись в «Мои».

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

Оценки и отзывы

На карточке публичной записи (общий каталог или опубликованная своя) можно
поставить оценку 1–5 звёзд и написать отзыв — текст необязателен,
можно оставить только оценку. Средний рейтинг и число отзывов видны на
карточке списка и на детальной странице; список можно сортировать по
рейтингу.

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

Видимость и публикация

Как в каталоге моделей, но публикация проходит модерацию:

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

Администраторам заявки видны в админке (раздел «Модерация», бейдж с числом
ожидающих — в навигации админки); свои записи администратор публикует сразу.

Действия

• Добавить — кнопка «+ Добавить компонент» на странице списка: название,
  категория, подтип, производитель, обозначение модели, описание, ссылка на
  страницу производителя, масса и габариты, характеристики.
• Добавить по URL — импорт характеристик и фото со страницы
  производителя (см. выше).
• Найти — живой поиск по названию/производителю + фильтры по категории и
  по производителю; кнопка «Сбросить фильтры» возвращает полный список.
  Производитель приводится к единому написанию при сохранении записи, поэтому
  разные написания одного бренда («MATEKSYS», «matek», «Matek Systems») дают в
  фильтре ОДИН пункт, а поиск находит бренд по любому употребимому написанию —
  в том числе по-русски: «матек» найдёт MatekSys. Поле «Производитель» в форме
  подсказывает уже известные названия.
• Карточка — клик по записи открывает детальную страницу с фото,
  описанием и таблицей характеристик.
• Фото-галерея — на детальной странице своей записи: до 10 фото
  (JPEG/PNG/WebP до 5 МБ каждое) — деталь можно показать с нескольких
  ракурсов. Сверх лимита ОДНОЙ записи действует ОБЩАЯ квота хранилища —
  5 ГБ на все ваши файлы платформы сразу (подробнее —
  «Ангар» → общая квота хранилища); загрузка сверх
  неё отклоняется с понятным сообщением о занятом месте и лимите, удаление
  фото место освобождает. Кнопка «+ Добавить фото» дописывает снимок в
  галерею — снимок можно и просто перетащить мышью на блок с кнопкой
  (первое
  загруженное становится обложкой); клик по миниатюре, кроме текущей
  обложки, делает её новой обложкой; ✕ на миниатюре удаляет фото
  (оставшиеся автоматически перенумеровываются). Все, кто видит запись,
  видят и всю галерею — не только владелец.
• Убрать фон — на детальной странице кнопка доступна АДМИНИСТРАТОРАМ (в
  том числе у общих записей каталога и чужих): полезно для фото, привезённых
  импортом со страницы производителя. Действует ТОЛЬКО на текущую обложку
  (остальные фото галереи — как есть). Вырезка идёт в фоне (тот же механизм,
  что у фото борта/модели) — оригинал сохраняется, при готовности карточка
  сразу показывает фото без фона; смена обложки или загрузка/удаление фото
  сбрасывает вырезку прежней обложки.
• Редактировать / удалить — только свои записи.

Что дальше (эпик «Инвентарь»)

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

Полётные контроллеры тоже привязываются к записи справочника (категория
«Полётный контроллер», AD-878) — карточка полётника в разделе
«Полётные контроллеры»
несёт выбор модели, при выборе форма подсказывает плату из карточки
справочника (не прошивку — версия прошивки зависит от конкретного
экземпляра, не от модели платы, AD-901). С AD-901 эта привязка обязательна:
создать полётник без выбора модели нельзя; свободное поле «Прошивка» у
полётника никуда не делось — оно вводится отдельно (вручную или
автоопределением по USB) и привязкой не затрагивается.