# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

================================================================================
ОБРАБОТЧИК: db
================================================================================

ОПИСАНИЕ
  Операции с базой данных для центрального экземпляра BACH. Управляет данными SQLite,
  выполняет запросы, экспортирует таблицы и создает резервные копии. Заменяет супабазу
  MCP как локальное решение.

ОПЕРАЦИИ
  статус Показывает обзор базы данных (таблицы, размер, версия)
  таблицы Перечисляет все таблицы с количеством строк.
  info <таблица> Подробности: схема, столбцы, распределение dist_type, примеры
  запрос «SQL» Выполняет SQL-запрос (SELECT или DML).
  схема <таблица> Показывает оператор CREATE TABLE с индексами.
  count <таблица> Количество строк в одной таблице
  экспорт <таблица> Экспортирует таблицу в формате CSV или JSON.
                     Параметры: --format csv|json (по умолчанию: csv)
  Insert <таблица> Вставляет запись данных (формат JSON)
  резервное копирование Создает быструю резервную копию в data/_backups/

ПРИМЕРЫ
  bach db status
    -> Показывает состояние базы данных, номер таблицы, размер, представления, индексы 

  bach db tables
    -> Перечисляет все таблицы с количеством строк

  bach db info agents
    -> Показывает схему, столбцы, распределение dist_type и 5 строк примера 

  bach db query "SELECT * FROM agents WHERE status='active' LIMIT 10"
    -> Выполняет запрос, показывает максимум 50 строк

  bach db schema prompts
    -> Показывает операторы CREATE TABLE и INDEX

  bach db export runs --format json
    -> Экспортирует «прогоны» в формате JSON в data/export/runs_YYYYMMDD_HHMMSS.json

  bach db insert tasks '{"title":"Test","priority":1}'
    -> Вставляет набор данных в «задачи» (проверяет столбцы)

  bach db backup
    -> Созданные данные/_backups/bach_quick_YYYYMMDD_HHMMSS.db

ФАЙЛЫ
  data/bach.db Центральная база данных SQLite
  данные/экспорт/Экспорт файлов (CSV, JSON)
  data/_backups/ Быстрое резервное копирование

СМОТРИ ТАКЖЕ
  base.py Класс BaseHandler
  каталог данных/базы данных
  Справка Bach CLI: bach --help
