> ## Documentation Index
> Fetch the complete documentation index at: https://docs.botmux.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Хранение данных

> Схема базы данных SQLite и модель хранения

BotMux использует SQLite с режимом WAL. База данных создаётся автоматически при первом запуске с автоматическими миграциями схемы.

## Таблицы

| Таблица                | Описание                                                           |
| ---------------------- | ------------------------------------------------------------------ |
| `bots`                 | Конфигурации ботов (токен, режимы, URL бэкенда, статус, состояние) |
| `chats`                | Отслеживаемые чаты/каналы (составной PK: `bot_id` + `chat_id`)     |
| `messages`             | Все наблюдаемые сообщения (составной PK: `chat_id` + `message_id`) |
| `known_users`          | Пользователи, замеченные в чатах                                   |
| `admin_log`            | Журнал аудита действий через веб-интерфейс                         |
| `user_tags`            | Пользовательские классификации участников чатов                    |
| `routes`               | Правила маршрутизации между ботами                                 |
| `route_mappings`       | Отслеживание Source-NAT для двунаправленной маршрутизации          |
| `auth_users`           | Учётные записи пользователей                                       |
| `auth_sessions`        | Сессии входа                                                       |
| `user_bots`            | Доступ пользователей к ботам (таблица-связка "многие-ко-многим")   |
| `api_keys`             | Хранение API-ключей                                                |
| `llm_config`           | Конфигурация LLM-маршрутизации                                     |
| `bridges`              | Конфигурации мостов протоколов                                     |
| `bridge_chat_mappings` | Сопоставления внешних↔Telegram чатов                               |
| `bridge_msg_mappings`  | Сопоставления внешних↔Telegram сообщений                           |

## Файл базы данных

По умолчанию: `botdata.db` в рабочей директории. Переопределяется флагом `-db`.

В демо-режиме используется отдельная `demo.db`.

## Миграции

Миграции схемы выполняются автоматически при запуске. Ручные шаги миграции не требуются.