Склад и места хранения
Склад (/hangar/inventory/stock) — учёт вашего личного остатка
комплектующих в разделе Ангар → Инвентарь: что есть, сколько и где лежит.
Позиция склада не описывает железо сама — она ссылается на тип из
справочника комплектующих: как за бортом в
Ангаре стоит модель из каталога, так за позицией склада стоит запись
справочника. Характеристики (KV, ток, масса…) живут в справочнике и не
дублируются.
Позиция склада
У позиции есть:
- тип из справочника — обязательная ссылка (свой, опубликованный чужой или каталожный тип);
- количество (шт.; 0 допустимо — «кончилось, но помню, что было»);
- статус: в наличии / установлен на борт / сломан / отдан;
- место хранения — ссылка на ваше место (опционально);
- установлен на борт — пометка при статусе «установлен» (свой борт); при удалении борта позиция автоматически возвращается в статус «в наличии» — склад не остаётся привязан к несуществующему борту;
- порог «мало осталось» (опционально) — число, ниже или равно которому количество считается «заканчивается»: карточка получает бейдж Заканчивается, а на списке появляется фильтр «Только заканчивающиеся». Порог не задан — бейдж не показывается, даже если количество равно нулю. Уведомлений порог не рассылает — это только визуальная подсказка;
- цена и заметки — опционально.
Аккумуляторы на склад не заводятся вообще — у них свой реестр (Инвентарь → Аккумуляторы) и своей категории на складе нет.
Полётные контроллеры и регуляторы на склад ПОЗИЦИЕЙ не заводятся — у обоих своя сущность, потому что у обоих есть то, что счётчик «N шт» не несёт: прошивка, её семейство/версия, номер мотора на борту (у регулятора) или UID платы (у полётного контроллера). Три одинаковых регулятора — это не «3 шт», а три объекта с независимой прошивкой и настройками; общее правило разделения — сущность у того, что несёт прошивку/настройки и ставится на конкретный борт (полётный контроллер, регулятор), позиция склада со счётчиком — у того, что различается только количеством (мотор, винт, приёмник, GPS, PDB, датчики). Попытка создать позицию склада с категорией типа «Регулятор» или «Полётный контроллер» — через форму, REST или ИИ-ассистента — отклоняется сервером с объяснением, куда идти вместо этого:
- Регулятор → раздел Регуляторы
(
/hangar/esc, инструментcreate_esc); - Полётный контроллер → раздел Полётные
контроллеры
(
/hangar/fc, инструментcreate_flight_controller).
Запись реестра, которая лежит на складе (не установлена на борт), может указать место хранения из этого же справочника — как позиция склада.
Места хранения
Места хранения (/hangar/inventory/locations) — простой личный
справочник: «шкаф мастерской», «коробка №3», «рюкзак». Позиция склада
ссылается на место; на карточке места виден счётчик позиций. Место, в
котором лежат позиции, удалить нельзя — сначала переложите или удалите их.
Два места с одинаковым названием завести нельзя — иначе их не различить
в выпадающем списке позиции склада, полётного контроллера и регулятора; сервер честно
откажет с понятным текстом.
Поиск «где лежит?»
- Живой поиск на странице склада ищет по названию типа, производителю, заметкам и месту — набрав «2808», вы сразу видите карточки с местами и количеством.
- Фильтры — по категории (из справочника), статусу и месту; кнопка «Сбросить фильтры» возвращает полный список.
- На детальной карточке позиции — таблица «Где лежит этот тип»: раскладка всего вашего остатка этого типа по местам и статусам.
Действия
- Добавить — кнопка «+ Добавить позицию»: выберите тип из справочника, количество, статус, место. Ваш склад видите только вы.
- Нужного типа в справочнике ещё нет — уходить за ним никуда не надо: выберите в списке типов пункт «+ Новый тип…», укажите название и категорию (производитель — по желанию), и запись справочника создастся вместе с позицией; созданный тип сразу окажется выбранным. Запись остаётся личной: характеристики и фото можно дозаполнить позже на её странице в справочнике, а публикация в общий каталог — отдельное действие с модерацией. Категорий «Регулятор» и «Полётный контроллер» в этом списке НЕТ — тип этой категории заводится на странице справочника, но позицию склада из него всё равно не создать; регулятор/полётный контроллер заводится напрямую в своём разделе (ссылка выше).
- Карточка — клик по позиции открывает детальную страницу: складские поля + описание и характеристики типа из справочника.
- Редактировать / удалить — со списка или с детальной карточки.
- Тип справочника, на который ссылаются позиции склада (ваши или чужие — для опубликованных), удалить нельзя: сервер честно откажет.
Наполнение через ИИ-ассистента (MCP)
Склад можно наполнять не только руками, но и словами — через Claude,
подключённый к MCP-серверу платформы:
inventory_list (посмотреть позиции с фильтрами), inventory_add
(добавить — тип по id или поиском, место по названию, заведётся
автоматически), inventory_update (количество/статус/место) и
inventory_find — «что у меня есть … и где лежит?». На странице склада об
этом напоминает бейдж ИИ.
Что дальше (эпик «Инвентарь»)
Следующие волны эпика: ИИ-импорт характеристик по URL (страница производителя → характеристики и фото в specs справочника) и интеграция с конфигурациями борта («установлен на борт» станет частью конфигурации).