# 2026-linux-skladman


## Что это

`2026-linux-skladman` - это ИИ-сервис для учёта вещей на складе. Он позволяет:
* Вести учёт количества оставшихся вещей
* Вести учёт местоположений вещей
* Добавлять новые вещи
* Списывать вещи

Всё взаимодействие с системой происходит при помощи чата, так как все действия
выполняются при помощи LLM. Система спроектирована с расчётом на то, чтобы можно
было без больших проблем дописывать собственные способы взаимодействия, но "из
коробки" предоставляается привязка к Telegram.

Учтено то, что может возникнуть необходимость работы как с self-hosted LLM, так
и с крупными ИИ-сервисами (Gemini, OpenAI и т.д.).


## Пример взаимодействия

#### Найти что-то и взять сколько-нибудь
```
USER:    Мне надо из 12 вольт сделать 5 вольт
SYSTEM:  В "Y12" лежат buck DCDC преобразователи, 5 штук
USER:    Взял 2
SYSTEM:  Записал, что их осталось 3 штуки
```

#### Узнать, что лежит в ячейке, и исправить данные
```
USER:    че в s3
SYSTEM:  В "S3" лежат 12 штук Arduino
USER:    уже нет, они переехали в p4
SYSTEM:  Записал, что теперь в "S3" пусто, а в "P4" лежит 12 штук Arduino.
```

#### Реорганизация склада
```
USER:    Мы объединили S3 и S4, теперь оно называется Q2
SYSTEM:  Записал, что больше ячеек S3 и S4 не существуют, но теперь есть
         ячейка Q2, в которой лежат Arduino (12 штук) и ESP32 (5 штук).
USER:    И ещё ардуин осталось 8, а есп кончились
SYSTEM:  Записал, что теперь в Q2 лежат 8 штук Arduino
```

#### И так далее


## Структура файлов

* `main.py` - скрипт, который нужно запускать
* `config.json` - конфигурация сервиса, генерируется автоматически при первом запуске
* `warehouse_<NAME>/` - папка с данными склада, не редактируйте файлы оттуда вручную