@alizadefaig/pos-server 1.2.25 → 1.2.27

package/app/db/driver.js

@@ -0,0 +1,248 @@
+/**
+ * Драйверы БД ядра: один и тот же SQL исполняется в двух контурах.
+ *
+ *   pgsql  — облако («боевой»): та же база, что у Laravel. Node постепенно забирает события,
+ *            Laravel остаётся рядом как откат, схема — общая (её ведут миграции Laravel).
+ *   sqlite — локальный мастер: одна касса держит БД, остальные терминалы ходят к ней.
+ *
+ * Интерфейс намеренно асинхронный ДЛЯ ОБОИХ: pg синхронным быть не может, а держать две
+ * версии ядра (sync + async) — гарантированное расхождение в деньгах. SQLite-драйвер внутри
+ * остаётся синхронным, наружу отдаёт Promise.
+ *
+ * Наружу: {dialect, query(sql, params), run(sql, params), exec(sql), transaction(cb), close()}
+ *   query → массив строк, run → {changes}
+ */
+
+let driverName = null;
+
+// node:sqlite принимает только null | number | bigint | string | Uint8Array.
+// Всё остальное (boolean, Date, undefined, объекты) приводим сами — иначе получим TypeError
+// на ровном месте, причём уже внутри бизнес-логики, а не здесь.
+const normalizeParam = (value) => {
+    if (value === undefined || value === null) {
+        return null;
+    }
+    if (typeof value === 'boolean') {
+        return value ? 1 : 0;
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (typeof value === 'number' || typeof value === 'bigint' || typeof value === 'string') {
+        return value;
+    }
+    if (value instanceof Uint8Array || Buffer.isBuffer(value)) {
+        return value;
+    }
+    return JSON.stringify(value);
+};
+
+const normalizeParams = (params) => params.map(normalizeParam);
+
+/** `?` → `$1, $2, ...`: ядро пишет SQL в стиле SQLite, pg требует нумерованные плейсхолдеры. */
+const toPgPlaceholders = (sql) => {
+    let index = 0;
+    return sql.replace(/\?/g, () => `$${++index}`);
+};
+
+// ---------------------------------------------------------------- SQLite
+
+const openSqliteConnection = (file) => {
+    try {
+        const {DatabaseSync} = require('node:sqlite');
+        driverName = 'node:sqlite';
+        return new DatabaseSync(file);
+    } catch (e) {
+        try {
+            const BetterSqlite3 = require('better-sqlite3');
+            driverName = 'better-sqlite3';
+            return new BetterSqlite3(file);
+        } catch (e2) {
+            const error = new Error(
+                'Нет доступного драйвера SQLite: node:sqlite недоступен (' + e.message + '), ' +
+                'better-sqlite3 не установлен (' + e2.message + ')'
+            );
+            error.code = 'NO_SQLITE_DRIVER';
+            throw error;
+        }
+    }
+};
+
+const openSqlite = (file) => {
+    const db = openSqliteConnection(file);
+    // Кэш подготовленных выражений: горячий путь (addProduct/calculate) гоняет одни и те же
+    // запросы сотни раз за смену, перекомпиляция SQL там лишняя.
+    const statements = new Map();
+    const prepare = (sql) => {
+        if (!statements.has(sql)) {
+            statements.set(sql, db.prepare(sql));
+        }
+        return statements.get(sql);
+    };
+
+    const driver = {
+        dialect: 'sqlite',
+        raw: db,
+        // Соединение одно на процесс: синхронный блок синка (app/sync/mirror.js) не должен
+        // стартовать посреди чужой транзакции, иначе его запись уедет в её COMMIT/ROLLBACK.
+        // Свойство DatabaseSync.isTransaction есть не во всех сборках Node — считаем сами.
+        inTransaction: false,
+        async query(sql, params = []) {
+            return prepare(sql).all(...normalizeParams(params));
+        },
+        async run(sql, params = []) {
+            const result = prepare(sql).run(...normalizeParams(params));
+            return {changes: result?.changes ?? 0};
+        },
+        async exec(sql) {
+            db.exec(sql);
+        },
+        /**
+         * SQLite однопоточен, вложенных транзакций нет — сам объект драйвера и есть «клиент».
+         */
+        async transaction(callback) {
+            db.exec('BEGIN');
+            driver.inTransaction = true;
+            try {
+                const result = await callback(driver);
+                db.exec('COMMIT');
+                return result;
+            } catch (e) {
+                try {
+                    db.exec('ROLLBACK');
+                } catch (rollbackError) {
+                    // ROLLBACK может упасть, если транзакция уже свёрнута самим SQLite —
+                    // подавляем, чтобы не потерять исходную ошибку.
+                }
+                throw e;
+            } finally {
+                driver.inTransaction = false;
+            }
+        },
+        async close() {
+            statements.clear();
+            db.close();
+        },
+    };
+
+    return driver;
+};
+
+// ---------------------------------------------------------------- Postgres
+
+let pgTypesConfigured = false;
+
+/**
+ * Типы pg приводим к тому же виду, что отдаёт SQLite, — иначе ядро пришлось бы учить
+ * различать контуры на каждом чтении.
+ *   timestamp → строка 'YYYY-MM-DD HH:mm:ss' (Laravel хранит UTC, ядро тоже);
+ *   numeric/int8 → число (по умолчанию pg отдаёт строку, и суммы бы склеивались строками).
+ */
+const configurePgTypes = (pg) => {
+    if (pgTypesConfigured) {
+        return;
+    }
+    const asDateTime = (value) => (value === null ? null : String(value).slice(0, 19));
+    pg.types.setTypeParser(1114, asDateTime); // timestamp without time zone
+    pg.types.setTypeParser(1184, asDateTime); // timestamp with time zone
+    pg.types.setTypeParser(1082, (value) => value); // date
+    pg.types.setTypeParser(1700, (value) => (value === null ? null : parseFloat(value))); // numeric
+    pg.types.setTypeParser(20, (value) => (value === null ? null : parseInt(value, 10))); // int8
+    pgTypesConfigured = true;
+};
+
+const pgConfig = () => {
+    if (process.env.CORE_DB_URL) {
+        return {connectionString: process.env.CORE_DB_URL};
+    }
+    // Имена переменных совпадают с .env Laravel намеренно: ops копирует значения как есть.
+    return {
+        host: process.env.DB_HOST || '127.0.0.1',
+        port: Number(process.env.DB_PORT || 5432),
+        database: process.env.DB_DATABASE,
+        user: process.env.DB_USERNAME,
+        password: process.env.DB_PASSWORD,
+        max: Number(process.env.CORE_DB_POOL || 10),
+    };
+};
+
+const openPostgres = () => {
+    let pg;
+    try {
+        pg = require('pg');
+    } catch (e) {
+        const error = new Error('Драйвер pg не установлен: npm i pg (нужен только серверному контуру)');
+        error.code = 'NO_PG_DRIVER';
+        throw error;
+    }
+    configurePgTypes(pg);
+    driverName = 'pg';
+
+    const pool = new pg.Pool(pgConfig());
+
+    /** Обёртка над клиентом/пулом — одинаковая, чтобы транзакция давала тот же интерфейс. */
+    const wrap = (executor, isTransaction = false) => ({
+        dialect: 'pgsql',
+        raw: executor,
+        async query(sql, params = []) {
+            const result = await executor.query(toPgPlaceholders(sql), params.map(
+                (value) => (value === undefined ? null : value)
+            ));
+            return result.rows;
+        },
+        async run(sql, params = []) {
+            const result = await executor.query(toPgPlaceholders(sql), params.map(
+                (value) => (value === undefined ? null : value)
+            ));
+            return {changes: result.rowCount ?? 0};
+        },
+        async exec(sql) {
+            await executor.query(sql);
+        },
+        async transaction(callback) {
+            if (isTransaction) {
+                // Вложенную транзакцию не открываем: внешняя уже гарантирует атомарность.
+                return callback(wrap(executor, true));
+            }
+            const client = await pool.connect();
+            try {
+                await client.query('BEGIN');
+                const result = await callback(wrap(client, true));
+                await client.query('COMMIT');
+                return result;
+            } catch (e) {
+                try {
+                    await client.query('ROLLBACK');
+                } catch (rollbackError) {
+                    // соединение могло умереть — исходную ошибку важнее сохранить
+                }
+                throw e;
+            } finally {
+                client.release();
+            }
+        },
+        async close() {
+            if (!isTransaction) {
+                await pool.end();
+            }
+        },
+    });
+
+    return wrap(pool);
+};
+
+/**
+ * @param {{dialect?: string, file?: string}} options
+ * @returns {{dialect: string, query: Function, run: Function, exec: Function, transaction: Function, close: Function}}
+ */
+const openDriver = (options = {}) => {
+    const dialect = options.dialect || 'sqlite';
+    if (dialect === 'pgsql' || dialect === 'postgres') {
+        return openPostgres();
+    }
+    return openSqlite(options.file);
+};
+
+const getDriverName = () => driverName;
+
+module.exports = {openDriver, getDriverName, normalizeParam, toPgPlaceholders};

package/app/db/migrations/001_snapshot.sql

@@ -0,0 +1,214 @@
+-- Снапшот справочников из облака (Laravel остаётся системой записи бэк-офиса).
+-- Локально эти таблицы только читаются доменной логикой заказов; наполняет их синк вниз.
+-- Имена колонок совпадают с Postgres-схемой намеренно: синк должен быть тупым копированием,
+-- а не маппингом полей, иначе расхождение схем всплывёт в деньгах.
+
+CREATE TABLE IF NOT EXISTS teams (
+    id            TEXT PRIMARY KEY,
+    name          TEXT,
+    timezone      TEXT,
+    -- час окончания бизнес-дня: граница суток для сброса номеров чеков и отчётов
+    shift_ends_at INTEGER DEFAULT 0,
+    -- код языка команды: Laravel ставит его как локаль приложения (PlatformApiMiddleware),
+    -- от него зависит, какой перевод отдаётся в name/full_name товаров
+    language_code TEXT DEFAULT 'az',
+    settings      TEXT,
+    synced_at     TEXT
+);
+
+CREATE TABLE IF NOT EXISTS companies (
+    id              TEXT PRIMARY KEY,
+    team_id         TEXT,
+    name            TEXT,
+    service_charge  REAL DEFAULT 0,
+    synced_at       TEXT
+);
+
+CREATE TABLE IF NOT EXISTS terminals (
+    id                    TEXT PRIMARY KEY,
+    team_id               TEXT,
+    company_id            TEXT,
+    name                  TEXT,
+    type                  TEXT DEFAULT 'standard',
+    is_active             INTEGER DEFAULT 1,
+    is_primary            INTEGER DEFAULT 0,
+    print_via_terminal_id TEXT,
+    synced_at             TEXT
+);
+
+CREATE TABLE IF NOT EXISTS users (
+    id        TEXT PRIMARY KEY,
+    name      TEXT,
+    synced_at TEXT
+);
+
+CREATE TABLE IF NOT EXISTS roles (
+    id         TEXT PRIMARY KEY,
+    team_id    TEXT,
+    name       TEXT,
+    is_courier INTEGER DEFAULT 0,
+    is_owner   INTEGER DEFAULT 0,
+    synced_at  TEXT
+);
+
+CREATE TABLE IF NOT EXISTS team_users (
+    id        TEXT PRIMARY KEY,
+    team_id   TEXT,
+    user_id   TEXT,
+    role_id   TEXT,
+    synced_at TEXT
+);
+
+CREATE TABLE IF NOT EXISTS order_sources (
+    id               TEXT PRIMARY KEY,
+    team_id          TEXT,
+    name             TEXT,
+    type             TEXT DEFAULT 'dine_in',
+    show_in_terminal INTEGER DEFAULT 0,
+    is_system        INTEGER DEFAULT 0,
+    synced_at        TEXT
+);
+
+CREATE TABLE IF NOT EXISTS halls (
+    id         TEXT PRIMARY KEY,
+    team_id    TEXT,
+    company_id TEXT,
+    name       TEXT,
+    short_name TEXT,
+    type       TEXT,
+    "order"    INTEGER DEFAULT 0,
+    synced_at  TEXT
+);
+
+CREATE TABLE IF NOT EXISTS tables (
+    id             TEXT PRIMARY KEY,
+    team_id        TEXT,
+    company_id     TEXT,
+    hall_id        TEXT,
+    label          TEXT,
+    type           TEXT,
+    has_deposit    INTEGER DEFAULT 0,
+    deposit_amount REAL DEFAULT 0,
+    "order"        INTEGER DEFAULT 0,
+    synced_at      TEXT
+);
+
+CREATE TABLE IF NOT EXISTS units (
+    id         TEXT PRIMARY KEY,
+    name       TEXT,
+    short_name TEXT,
+    code       TEXT,
+    unit       INTEGER DEFAULT 1000,
+    synced_at  TEXT
+);
+
+CREATE TABLE IF NOT EXISTS product_workshops (
+    id           TEXT PRIMARY KEY,
+    team_id      TEXT,
+    name         TEXT,
+    print_ticket INTEGER DEFAULT 0,
+    config       TEXT,
+    synced_at    TEXT
+);
+
+CREATE TABLE IF NOT EXISTS products (
+    id                    TEXT PRIMARY KEY,
+    team_id               TEXT,
+    name                  TEXT,
+    full_name             TEXT,
+    barcode               TEXT,
+    color                 TEXT,
+    image                 TEXT,
+    description           TEXT,
+    is_with_modification  INTEGER DEFAULT 0,
+    has_portion           INTEGER DEFAULT 0,
+    extra                 INTEGER DEFAULT 0,
+    extra_type            TEXT,
+    unit_id               TEXT,
+    product_category_id   TEXT,
+    product_workshop_id   TEXT,
+    type                  TEXT DEFAULT 'product',
+    price                 REAL DEFAULT 0,
+    cost                  REAL DEFAULT 0,
+    measure               REAL DEFAULT 1,
+    is_not_discount       INTEGER DEFAULT 0,
+    is_giftable           INTEGER DEFAULT 0,
+    is_weight_item        INTEGER DEFAULT 0,
+    ignore_service_charge INTEGER DEFAULT 0,
+    ignore_deposit        INTEGER DEFAULT 0,
+    ignore_workshop       INTEGER DEFAULT 0,
+    standalone            INTEGER DEFAULT 0,
+    is_hidden             INTEGER DEFAULT 0,
+    is_available          INTEGER DEFAULT 1,
+    is_active             INTEGER DEFAULT 1,
+    disable_stock         INTEGER DEFAULT 0,
+    cooking_time          INTEGER DEFAULT 0,
+    "order"               INTEGER DEFAULT 0,
+    data                  TEXT,
+    parent_id             TEXT,
+    deleted_at            TEXT,
+    synced_at             TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_products_team ON products (team_id);
+CREATE INDEX IF NOT EXISTS idx_products_workshop ON products (product_workshop_id);
+
+CREATE TABLE IF NOT EXISTS modifier_sets (
+    id          TEXT PRIMARY KEY,
+    team_id     TEXT,
+    name        TEXT,
+    type        TEXT,
+    description TEXT,
+    min         INTEGER,
+    max         INTEGER,
+    config      TEXT,
+    synced_at   TEXT
+);
+
+CREATE TABLE IF NOT EXISTS product_modifier_sets (
+    id              TEXT PRIMARY KEY,
+    product_id      TEXT,
+    modifier_set_id TEXT,
+    title           TEXT,
+    description     TEXT,
+    "order"         INTEGER DEFAULT 0,
+    config          TEXT,
+    synced_at       TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_pms_product ON product_modifier_sets (product_id);
+CREATE INDEX IF NOT EXISTS idx_pms_set ON product_modifier_sets (modifier_set_id);
+
+CREATE TABLE IF NOT EXISTS modifier_set_modifiers (
+    id              TEXT PRIMARY KEY,
+    modifier_set_id TEXT,
+    product_id      TEXT,
+    unit_id         TEXT,
+    type            TEXT DEFAULT 'product',
+    name            TEXT,
+    image           TEXT,
+    is_without_debit INTEGER DEFAULT 0,
+    "default"       INTEGER DEFAULT 0,
+    min             INTEGER DEFAULT 0,
+    max             INTEGER DEFAULT 1,
+    default_count   INTEGER DEFAULT 0,
+    price           REAL DEFAULT 0,
+    cost            REAL DEFAULT 0,
+    gross           REAL DEFAULT 0,
+    "order"         INTEGER DEFAULT 0,
+    description     TEXT,
+    synced_at       TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_msm_set ON modifier_set_modifiers (modifier_set_id);
+
+CREATE TABLE IF NOT EXISTS payment_methods (
+    id               TEXT PRIMARY KEY,
+    team_id          TEXT,
+    name             TEXT,
+    type             TEXT,
+    provider         TEXT DEFAULT 'local',
+    show_in_terminal INTEGER DEFAULT 0,
+    has_change       INTEGER DEFAULT 0,
+    synced_at        TEXT
+);

package/app/db/migrations/002_orders.sql

@@ -0,0 +1,190 @@
+-- Горячий контур: всё, что касса пишет сама и должна уметь писать без интернета.
+-- Истина по открытому чеку здесь; наверх уезжает через outbox (UUID + operation_id уже есть).
+
+CREATE TABLE IF NOT EXISTS orders (
+    id                                TEXT PRIMARY KEY,
+    global_number                     INTEGER DEFAULT 1,
+    number                            INTEGER DEFAULT 1,
+    opened_at                         TEXT,
+    closed_at                         TEXT,
+    progress                          INTEGER DEFAULT 0,
+    guest_count                       INTEGER DEFAULT 0,
+    comment                           TEXT,
+    status                            TEXT DEFAULT 'created',
+    payed_by_third_party_application  INTEGER DEFAULT 0,
+    profit                            REAL DEFAULT 0,
+    cost                              REAL DEFAULT 0,
+    fiscal_id                         TEXT,
+    fiscal_url                        TEXT,
+    rrn                               TEXT,
+    subtotal                          REAL DEFAULT 0,
+    service_charge                    REAL DEFAULT 0,
+    service_charge_amount             REAL DEFAULT 0,
+    deposit_type                      TEXT,
+    deposit_amount                    REAL DEFAULT 0,
+    deposit_gap                       REAL DEFAULT 0,
+    discount_amount                   REAL DEFAULT 0,
+    discount                          REAL DEFAULT 0,
+    max_discount_amount               REAL DEFAULT 0,
+    discount_type                     TEXT DEFAULT 'amount',
+    tax                               REAL DEFAULT 0,
+    tip                               REAL DEFAULT 0,
+    total                             REAL DEFAULT 0,
+    is_closed_without_payment         INTEGER DEFAULT 0,
+    without_payment_reason            TEXT,
+    data                              TEXT,
+    customers                         TEXT DEFAULT '[1]',
+    extras                            TEXT,
+    closing_order_started_at          TEXT,
+    client_id                         TEXT,
+    table_id                          TEXT,
+    hall_id                           TEXT,
+    team_id                           TEXT,
+    company_id                        TEXT,
+    terminal_id                       TEXT,
+    order_source_id                   TEXT,
+    opened_by_id                      TEXT,
+    closed_by_id                      TEXT,
+    serving_id                        TEXT,
+    shift_id                          TEXT,
+    slot_index                        INTEGER DEFAULT 1,
+    printed_at                        TEXT,
+    should_send_to_kitchen            INTEGER DEFAULT 0,
+    deleted_at                        TEXT,
+    created_at                        TEXT,
+    updated_at                        TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_orders_company_status ON orders (company_id, status);
+CREATE INDEX IF NOT EXISTS idx_orders_opened_at ON orders (opened_at);
+CREATE INDEX IF NOT EXISTS idx_orders_closed_at ON orders (closed_at);
+
+CREATE TABLE IF NOT EXISTS order_products (
+    id                             TEXT PRIMARY KEY,
+    order_id                       TEXT NOT NULL,
+    product_id                     TEXT,
+    company_id                     TEXT,
+    team_id                        TEXT,
+    unit_id                        TEXT,
+    guest_number                   INTEGER DEFAULT 1,
+    price                          REAL DEFAULT 0,
+    cost                           REAL DEFAULT 0,
+    profit                         REAL DEFAULT 0,
+    cost_total                     REAL DEFAULT 0,
+    price_total                    REAL DEFAULT 0,
+    quantity                       REAL DEFAULT 1,
+    price_after_service_charge     REAL DEFAULT 0,
+    price_after_discount           REAL DEFAULT 0,
+    subtotal                       REAL DEFAULT 0,
+    discount                       REAL DEFAULT 0,
+    discount_amount                REAL DEFAULT 0,
+    total                          REAL DEFAULT 0,
+    service_charge                 REAL DEFAULT 0,
+    service_charge_amount          REAL DEFAULT 0,
+    max_discount_amount            REAL DEFAULT 0,
+    service_charge_calculate_mode  TEXT DEFAULT 'after_discount',
+    discount_type                  TEXT DEFAULT 'percent',
+    status                         TEXT DEFAULT 'cooking',
+    type                           TEXT DEFAULT 'product',
+    added_at                       TEXT,
+    modified_at                    TEXT,
+    is_gift                        INTEGER DEFAULT 0,
+    stopped_at                     TEXT,
+    is_stopped                     INTEGER DEFAULT 0,
+    is_fixed                       INTEGER DEFAULT 0,
+    paused_seconds                 INTEGER DEFAULT 0,
+    timer_limit_minutes            INTEGER,
+    comment                        TEXT,
+    modifications_sets_hash        TEXT,
+    print_quantity                 REAL DEFAULT 0,
+    receipt_print_quantity         REAL DEFAULT 0,
+    workshop_print_quantity        REAL DEFAULT 0,
+    kds_print_quantity             REAL DEFAULT 0,
+    total_workshop_print_quantity  REAL DEFAULT 0,
+    deleted_at                     TEXT,
+    created_at                     TEXT,
+    updated_at                     TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_order_products_order ON order_products (order_id);
+CREATE INDEX IF NOT EXISTS idx_order_products_merge
+    ON order_products (order_id, product_id, guest_number, modifications_sets_hash);
+
+CREATE TABLE IF NOT EXISTS order_product_modifier_sets (
+    id                       TEXT PRIMARY KEY,
+    order_product_id         TEXT NOT NULL,
+    modifier_set_id          TEXT,
+    modifier_set_modifier_id TEXT,
+    price                    REAL DEFAULT 0,
+    quantity                 REAL DEFAULT 0,
+    total                    REAL DEFAULT 0,
+    name                     TEXT,
+    modifier_set_title       TEXT,
+    modifier_set_type        TEXT,
+    deleted_at               TEXT,
+    created_at               TEXT,
+    updated_at               TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_opms_order_product ON order_product_modifier_sets (order_product_id);
+
+CREATE TABLE IF NOT EXISTS order_payments (
+    id                TEXT PRIMARY KEY,
+    order_id          TEXT NOT NULL,
+    payment_method_id TEXT,
+    name              TEXT,
+    amount            REAL DEFAULT 0,
+    real_amount       REAL DEFAULT 0,
+    change            REAL DEFAULT 0,
+    deleted_at        TEXT,
+    created_at        TEXT,
+    updated_at        TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_order_payments_order ON order_payments (order_id);
+
+CREATE TABLE IF NOT EXISTS order_events (
+    id                TEXT PRIMARY KEY,
+    platform_event_id TEXT,
+    event             TEXT,
+    team_id           TEXT,
+    team_user_id      TEXT,
+    order_id          TEXT,
+    terminal_id       TEXT,
+    accepted_by       TEXT,
+    product_id        TEXT,
+    quantity          REAL DEFAULT 0,
+    ip_address        TEXT,
+    data              TEXT,
+    time_at           TEXT,
+    deleted_at        TEXT,
+    created_at        TEXT,
+    updated_at        TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_order_events_order ON order_events (order_id);
+
+-- Очередь мутаций наверх. Дедуп на стороне Laravel уже есть (idempotency_keys),
+-- поэтому здесь достаточно хранить operation_id и повторять до подтверждения.
+CREATE TABLE IF NOT EXISTS outbox (
+    id            TEXT PRIMARY KEY,
+    operation_id  TEXT,
+    event         TEXT NOT NULL,
+    payload       TEXT NOT NULL,
+    headers       TEXT,
+    status        TEXT DEFAULT 'pending',
+    attempts      INTEGER DEFAULT 0,
+    last_error    TEXT,
+    created_at    TEXT,
+    sent_at       TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_outbox_status ON outbox (status, created_at);
+
+-- Резерв номеров чеков на терминал: офлайн нельзя спрашивать номер у облака,
+-- иначе две кассы выдадут один и тот же (OFFLINE-FIRST-PLAN, Э6).
+CREATE TABLE IF NOT EXISTS number_sequences (
+    name       TEXT PRIMARY KEY,
+    value      INTEGER DEFAULT 0,
+    updated_at TEXT
+);

package/app/db/migrations/003_idempotency.sql

@@ -0,0 +1,18 @@
+-- Exactly-once для мутаций (БАГ A) в локальном контуре.
+-- Схема повторяет таблицу Laravel (2026_06_24_000001_create_idempotency_keys_table):
+-- в облаке ядро пишет в неё же, поэтому расхождение колонок недопустимо.
+
+CREATE TABLE IF NOT EXISTS idempotency_keys (
+    operation_id  TEXT PRIMARY KEY,
+    company_id    TEXT,
+    event         TEXT,
+    status        TEXT NOT NULL DEFAULT 'pending',
+    response      TEXT,
+    http_status   INTEGER,
+    created_at    TEXT,
+    updated_at    TEXT,
+    expires_at    TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_idempotency_company ON idempotency_keys (company_id);
+CREATE INDEX IF NOT EXISTS idx_idempotency_expires ON idempotency_keys (expires_at);

package/app/db/migrations/004_shifts.sql

@@ -0,0 +1,21 @@
+-- Кассовые смены: приходят сверху синком снапшота (открывают их в облаке), локально нужны
+-- только чтобы закрытый чек сразу получил shift_id — как finalizeClose в Laravel.
+
+CREATE TABLE IF NOT EXISTS shifts (
+    id              TEXT PRIMARY KEY,
+    team_id         TEXT,
+    company_id      TEXT,
+    type            TEXT NOT NULL DEFAULT 'work',
+    started_at      TEXT,
+    ended_at        TEXT,
+    start_amount    REAL NOT NULL DEFAULT 0,
+    end_amount      REAL NOT NULL DEFAULT 0,
+    minutes         INTEGER,
+    opened_by       TEXT,
+    closed_by       TEXT,
+    deleted_at      TEXT,
+    created_at      TEXT,
+    updated_at      TEXT
+);
+
+CREATE INDEX IF NOT EXISTS shifts_open_cash ON shifts (company_id, type, ended_at);