База данных — схема и миграции

SQLite-база, путь задаётся в config.ini (db/dbPath). Управляется через DatabaseManager (singleton) + DAO-слой.

Инициализация схемы

При каждом запуске приложения вызывается DatabaseManager::initSchema() (database/DatabaseManager.cpp). Именно здесь происходят все миграции — до открытия главного окна.

При обновлении из меню приложение скачивает новый .exe, применяет его и перезапускается, поэтому initSchema() тоже выполняется заново на новой версии.

Что применяется автоматически при обновлении

Изменение	Применяется?	Как
Новая таблица	Да	`CREATE TABLE IF NOT EXISTS`
Новая колонка	Да	`ALTER TABLE ... ADD COLUMN`
Удаление таблицы	Да	`DROP TABLE IF EXISTS`
Удаление колонки	Нет	SQLite не поддерживает
Переименование колонки	Нет	Нужна пересборка таблицы
Изменение типа колонки	Нет	Нужна пересборка таблицы
Изменение DEFAULT у существующей колонки	Нет	`CREATE TABLE IF NOT EXISTS` не выполняется повторно

Паттерн добавления колонки

// 1. Добавить колонку в CREATE TABLE IF NOT EXISTS (для новых установок)
q.exec(R"(CREATE TABLE IF NOT EXISTS my_table (
    ...
    new_col TEXT DEFAULT ''
))");

// 2. Добавить ALTER TABLE для существующих БД (ошибка "column already exists" игнорируется)
q.exec("ALTER TABLE my_table ADD COLUMN new_col TEXT DEFAULT ''");

Оба шага обязательны: CREATE TABLE покрывает свежие установки, ALTER TABLE — обновление существующей БД.

Сложные миграции (изменение типа, переименование)

Для изменений, которые SQLite не поддерживает напрямую, используется ручная миграция с пересозданием таблицы и PRAGMA user_version для версионирования:

QSqlQuery q(db);
q.exec("PRAGMA user_version");
q.next();
int version = q.value(0).toInt();

if (version < 2) {
    // пересоздаём таблицу
    q.exec("ALTER TABLE my_table RENAME TO my_table_old");
    q.exec("CREATE TABLE my_table (...)");
    q.exec("INSERT INTO my_table SELECT ... FROM my_table_old");
    q.exec("DROP TABLE my_table_old");
    q.exec("PRAGMA user_version = 2");
}

Таблицы

Таблица	Описание
`devices`	Android-устройства, подключённые по ADB
`bank_profiles`	Банковские профили (приложение + устройство)
`materials`	Карты/счета профиля
`transactions`	Транзакции по картам
`events`	Задачи из очереди API
`banks`	Справочник банков (alias, name, nspk_name)
`general_logs`	Общий лог приложения
`settings`	Настройки key-value

3.6 KiB Raw Permalink Blame History Unescape Escape