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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Действия

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

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

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

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