# API данных: боты пишут в папку проекта Любой бот (и любой сервис) может сохранить данные в ядро — они лягут в папку проекта `/root/buryan-infra/data/`. ## Записать ``` POST /data/<коллекция> {"key": "уникальный-ключ", "payload": {"любые": "поля"}, "tags": ["метка"]} ``` Повторная запись с тем же ключом обновляет документ. ## Прочитать ``` GET /data/<коллекция>?limit=50&tag=пожелание ``` ## Выгрузить в папку проекта ``` POST /export {"collection": "wishes", "format": "md"} # или json ``` Файл появится в `/root/buryan-infra/data/<коллекция>/`. ## Что уже пишется автоматически | Что | Куда | |---|---| | Пожелания из любого бота | коллекция `wishes` | | Диалоги с моделью | `/var/lib/hub-bots/dialog.jsonl` → `data/logs/` | | Входящие пожелания | `/var/lib/hub-bots/inbox/*.jsonl` → `data/logs/` | | События системы | коллекция `events` | Ежедневно в 23:00 (`/etc/cron.d/hub-export`) всё выгружается в репозиторий. ## Команда бота `!export wishes` — выгрузить коллекцию прямо из чата, бот вернёт путь. ## Проверено * пожелание «хочу сериал про космос» от @polina легло в `wishes` с полями от/бот/номер/текст; * `!export wishes` выгрузил файл и вернул путь; * в папке проекта: `data/wishes/`, `data/dialog/`, `data/events/`, `data/logs/` (6 файлов).