@alizadefaig/pos-server 1.2.26 → 1.2.27

package/app/core/services/PrintService.js

@@ -0,0 +1,715 @@
+const PrinterRepository = require('../repositories/PrinterRepository');
+const KdsService = require('./KdsService');
+const OrderProduct = require('../models/OrderProduct');
+const {money, qty, round2, toBool, sum} = require('../support/num');
+const {now, nowSql, parse} = require('../support/time');
+const {DEFAULT_TIMEZONE, zonedParts} = require('../support/tz');
+const {translated} = require('../support/lang');
+const {md5} = require('../support/str');
+const {uuid} = require('../support/ids');
+const {notFound} = require('../errors');
+const {normalizeReceipts, phpTruthy, findRow} = require('../support/receipts');
+const {withLock, LockTimeoutError} = require('../support/lock');
+
+const TYPE_TIMER = OrderProduct.TYPE_TIMER;
+const DINE_IN = 'dine_in';
+
+// Таймауты — те же, что Laravel передаёт в /socket/request. Цеховой чек ждёт реальную печать
+// (90с, см. инвариант таймаутов в Laravel); счёт уходит через SocketService::request без
+// time_out, то есть с дефолтом Node — 10с.
+const WORKSHOP_TIMEOUT_MS = 90000;
+const BILL_TIMEOUT_MS = 10000;
+
+// TTL дедуп-меток — как у Cache::add/put в Laravel.
+const LOCK_TTL_MS = 120 * 1000;
+const DONE_TTL_MS = 30 * 1000;
+
+// Отправки в цех одного чека идут строго по одной (как `print:order:<id>` в Laravel): иначе
+// вторая читает workshop_print_quantity до того, как первая его проставила, и печатает те же
+// позиции ещё раз. Ожидание — PRINT_ORDER_LOCK_WAIT (с), дефолт 15, больше 25 не бывает:
+// ожидание + печать 90 держатся под таймаутом мастера 150 и фронта 160.
+const ORDER_LOCK_WAIT_DEFAULT_S = 15;
+const ORDER_LOCK_WAIT_MAX_S = 25;
+
+const orderLockWaitMs = () => {
+    const raw = process.env.PRINT_ORDER_LOCK_WAIT;
+    const seconds = raw === undefined || raw === '' ? ORDER_LOCK_WAIT_DEFAULT_S : Number.parseInt(raw, 10);
+    if (!Number.isFinite(seconds)) {
+        return ORDER_LOCK_WAIT_DEFAULT_S * 1000;
+    }
+    return Math.min(Math.max(seconds, 0), ORDER_LOCK_WAIT_MAX_S) * 1000;
+};
+
+/**
+ * Дедуп-метки печати (`print:lock:*` / `print:done:*` из кэша Laravel).
+ *
+ * Здесь это Map в памяти процесса, а не Redis: одна касса-мастер — один процесс Node, и все
+ * терминалы заведения ходят в него же, поэтому гонка «два клика / два терминала» ловится.
+ * Цена — метки не переживают рестарт, что безопасно: рестарт длится дольше 30с окна done,
+ * а физический повтор всё равно отсекает терминал по print_idempotency_key.
+ */
+const printMarks = new Map();
+
+const purgeExpired = (at) => {
+    for (const [key, expiresAt] of printMarks) {
+        if (expiresAt <= at) {
+            printMarks.delete(key);
+        }
+    }
+};
+
+/** Cache::add — true, только если метки не было (или она истекла). */
+const markAdd = (key, ttlMs) => {
+    const at = Date.now();
+    purgeExpired(at);
+    if (printMarks.has(key)) {
+        return false;
+    }
+    printMarks.set(key, at + ttlMs);
+    return true;
+};
+
+const markHas = (key) => {
+    const expiresAt = printMarks.get(key);
+    if (expiresAt === undefined) {
+        return false;
+    }
+    if (expiresAt <= Date.now()) {
+        printMarks.delete(key);
+        return false;
+    }
+    return true;
+};
+
+const markPut = (key, ttlMs) => {
+    printMarks.set(key, Date.now() + ttlMs);
+};
+
+const markForget = (key) => {
+    printMarks.delete(key);
+};
+
+/** Для смоуков: изолировать сценарии друг от друга. */
+const resetPrintMarks = () => printMarks.clear();
+
+const pad = (value) => String(value).padStart(2, '0');
+
+/**
+ * `$carbon->setTimezone($tz)->format('Y-m-d H:i:s')`. Время в чеке — стенные часы заведения,
+ * а не UTC: кассир сверяет его с часами на стене. Битая зона не должна срывать печать —
+ * откатываемся на Asia/Baku, как и весь остальной код ядра.
+ */
+const formatZoned = (date, timeZone) => {
+    let parts;
+    try {
+        parts = zonedParts(date, timeZone || DEFAULT_TIMEZONE);
+    } catch (e) {
+        parts = zonedParts(date, DEFAULT_TIMEZONE);
+    }
+    return `${parts.year}-${pad(parts.month)}-${pad(parts.day)} ${pad(parts.hour)}:${pad(parts.minute)}:${pad(parts.second)}`;
+};
+
+// В PHP null в строковой интерполяции — пустая строка, в JS — «null».
+const str = (value) => (value === null || value === undefined ? '' : String(value));
+
+// Флаги принтера Laravel отдаёт сырыми (кастов у модели нет): в Postgres это boolean, локально
+// INTEGER 0/1. Приводим к boolean, null оставляем null — как пришёл бы из Postgres.
+const flag = (value) => (value === null || value === undefined ? null : toBool(value));
+
+const printerPayload = (printer, cashdraw) => ({
+    type: printer.type,
+    ip_address: printer.ip_address,
+    mac_address: printer.mac_address ?? null,
+    vendor_id: printer.vendor_id,
+    product_id: printer.product_id,
+    name: printer.name,
+    bell: flag(printer.bell),
+    cashdraw,
+});
+
+const printerError = (printerName, terminalName, suffix = '') => ({
+    title: 'Printerlə əlaqədə xəta',
+    message: `Printer ${str(printerName)} ilə əlaqə qurula bilmədi. (Terminal: ${str(terminalName)})${suffix}`,
+});
+
+// Ответ терминала: успех только при success, как `!$response || !$response['success']`.
+const isSuccess = (response) => Boolean(response) && typeof response === 'object' && phpTruthy(response.success);
+
+// Удалённые записи в облаке Eloquent не отдаёт; локально deleted_at у справочника может и не быть.
+const alive = (row) => (row && !row.deleted_at ? row : null);
+
+/**
+ * Печать — порт `OrderService::sendToWorkshops` / `printBillReceipt` и
+ * `PrinterController::getReceiptPrinter`.
+ *
+ * Ядро решает, ЧТО и КУДА печатать (цеха, принтеры, терминал), а растр и отправку на
+ * устройство по-прежнему делает терминал: задание уходит ему сокет-запросом
+ * `request:orders:print*:<id>`, тем же каналом, которым сегодня печатает Laravel. Payload и
+ * формат ответа совпадают байт в байт — терминалу всё равно, кто прислал задание.
+ */
+class PrintService {
+    /**
+     * @param {object} deps
+     * @param {object} deps.orders OrderService этого запроса (find, guard, syncWorkshopCount, patch)
+     * @param {Function} [deps.socketRequest] транспорт до терминала; подменяется в тестах
+     */
+    constructor({db, context, emitter = null, orders, socketRequest = null}) {
+        this.db = db;
+        this.context = context;
+        this.emitter = emitter;
+        this.orders = orders;
+        this.printers = new PrinterRepository(db);
+        // Лениво: socket/request тянет utils (sharp) и socket.io-сервер, а ядро грузится и без них.
+        this.socketRequest = socketRequest || ((options) => require('../../socket/request').socketRequest(options));
+    }
+
+    locale() {
+        return this.context.locale();
+    }
+
+    /** Настройки чеков команды заказа — уже прогнанные через каст Laravel. */
+    async receiptsOf(team) {
+        let settings = team ? team.settings : null;
+        if (typeof settings === 'string') {
+            try {
+                settings = JSON.parse(settings);
+            } catch (e) {
+                settings = null;
+            }
+        }
+        const raw = settings && typeof settings === 'object' ? settings.receipts : null;
+        return normalizeReceipts(raw, await this.printers.findCurrencySymbol(team));
+    }
+
+    /**
+     * Терминал, который физически печатает. Для делегирующих (mobile без печати в браузере) —
+     * его print_via_terminal_id; удалённый/не найденный целевой терминал = печать своим.
+     */
+    async resolvePrintTerminal(terminal) {
+        if (terminal && terminal.print_via_terminal_id) {
+            return (await this.printers.findTerminal(terminal.print_via_terminal_id)) || terminal;
+        }
+        return terminal;
+    }
+
+    /** Делегирование — по факту (терминалы различаются), а не по заполненному полю. */
+    static isDelegated(terminal, printTerminal) {
+        return Boolean(terminal && printTerminal && printTerminal.id !== terminal.id);
+    }
+
+    // ------------------------------------------------------------ цеховые чеки
+
+    /**
+     * Только синхронный режим: терминал ждёт результат печати в ответе запроса. Async-ветка
+     * Laravel (Job в очереди `prints`) офлайн не нужна — очереди у кассы нет, а сама печать
+     * и так не держит пул воркеров (Node не блокируется на ожидании сокета).
+     *
+     * @param {boolean} allowClosed внутренний обход guard'а для auto_print_on_close
+     */
+    async sendToWorkshops(id, {allowClosed = false} = {}) {
+        try {
+            return await withLock(`print:order:${id}`, () => this.sendToWorkshopsLocked(id, {allowClosed}), {
+                waitMs: orderLockWaitMs(),
+            });
+        } catch (error) {
+            if (!(error instanceof LockTimeoutError)) {
+                throw error;
+            }
+            console.warn('[core][print] sendToWorkshops: order is still printing, rejected', {order_id: id});
+            return {
+                async: false,
+                errors: [{
+                    title: 'Çek çap olunur',
+                    message: 'Bu çek hələ çap olunur. Bir az sonra yenidən göndərin.',
+                }],
+                order: await this.orders.resource().order(await this.orders.findOrFail(id, {withTrashed: true})),
+            };
+        }
+    }
+
+    async sendToWorkshopsLocked(id, {allowClosed}) {
+        const context = this.context;
+        const order = await this.orders.findOrFail(id);
+        if (!allowClosed) {
+            this.orders.assertMutable(order, 'orders.sendToWorkshops');
+        }
+
+        const team = await this.printers.findTeam(order.team_id);
+        const timeZone = (team && team.timezone) || DEFAULT_TIMEZONE;
+        const printedAt = formatZoned(now(), timeZone);
+
+        // KDS: тикеты отправки создаются до печати и от её успеха не зависят (свой счётчик
+        // kds_print_quantity). Сбой KDS печать не ломает — как в Laravel.
+        try {
+            await new KdsService({db: this.db, context, emitter: this.emitter}).createTicketsForSend(order);
+        } catch (e) {
+            console.warn('[core][kds] createTicketsForSend failed', {order_id: id, error: e.message});
+        }
+
+        const terminal = context.getTerminal();
+        const printTerminal = await this.resolvePrintTerminal(terminal);
+        const isDelegated = PrintService.isDelegated(terminal, printTerminal);
+
+        const source = order.source;
+        if (!source) {
+            throw notFound('Order source not found');
+        }
+
+        const header = {
+            number: order.number,
+            printed_at: printedAt,
+            guest_count: order.guest_count,
+            order_source_type: source.type,
+            order_source_label: source.name,
+            waiter: order.waiter ? order.waiter.user_name ?? null : null,
+            workshop: '',
+            terminal: terminal ? terminal.name : null,
+            comment: order.comment ?? null,
+            comments: order.comment ?? null,
+            products: [],
+        };
+        if (source.type === DINE_IN) {
+            const table = alive(await this.orders.snapshot.findTable(order.table_id));
+            if (table) {
+                const hall = alive(await this.orders.snapshot.findHall(table.hall_id));
+                header.hall = hall ? hall.name : null;
+                header.table = table.label;
+            }
+        }
+
+        const printWorkshops = await this.printers.findPrintWorkshops(context.teamId);
+        const pendingRows = await this.printers.findPendingOrderProducts(order.id);
+        const pending = await Promise.all(pendingRows.map((row) => this.orders.orders.hydrateProduct(row)));
+
+        // Подпись идемпотентности строится от АБСОЛЮТНОГО quantity, а не от дельты: при
+        // добавлении по одной штуке дельта всегда 1 и новый чек ложно отбивался бы как дубль.
+        // Это же снимок того, ЧТО печатается: после печати syncWorkshopCount ставит
+        // workshop_print_quantity по нему, а не по текущему quantity, иначе количество,
+        // добавленное во время печати, помечалось бы напечатанным и терялось.
+        const qtyById = new Map(pending.map((item) => [item.id, item.quantity]));
+
+        const noWorkshop = [];
+        const productsToPrint = new Map();
+        const syncOrderProducts = new Map();
+
+        for (const item of pending) {
+            const product = item.product;
+
+            // Позиция без товара в справочнике: Laravel упал бы на null, а мы синкаем её
+            // без печати — цех всё равно не знает, что это.
+            if (item.type === 'standalone' || item.type === 'modifier' || !product) {
+                noWorkshop.push(item.id);
+                continue;
+            }
+            if (toBool(product.ignore_workshop)) {
+                noWorkshop.push(item.id);
+                continue;
+            }
+
+            // Цех — через мутатор (пустой берётся у категории), и у модификации, и у родителя.
+            const snapshot = this.orders.snapshot;
+            let workshopId = await snapshot.productWorkshopId(product);
+            if (!workshopId && product.parent_id) {
+                workshopId = await snapshot.productWorkshopId(await snapshot.findProduct(product.parent_id));
+            }
+
+            const workshop = workshopId ? printWorkshops.get(workshopId) : null;
+            if (!workshop) {
+                noWorkshop.push(item.id);
+                continue;
+            }
+
+            if (!productsToPrint.has(workshopId)) {
+                productsToPrint.set(workshopId, {data: {...header, workshop: workshop.name, products: []}});
+                syncOrderProducts.set(workshopId, []);
+            }
+            syncOrderProducts.get(workshopId).push(item.id);
+
+            productsToPrint.get(workshopId).data.products.push({
+                name: translated(product.full_name, this.locale()),
+                quantity: item.quantity - item.workshop_print_quantity,
+                // весовой товар печатается в цех как «1.5 kq», а не «1.5X»
+                is_weight_item: toBool(product.is_weight_item),
+                unit_id: item.unit_id ?? null,
+                comment: item.comment ?? null,
+                modifications: (item.modifiers || []).map((modifier) => ({
+                    name: modifier.name,
+                    quantity: qty(modifier.quantity),
+                })),
+            });
+        }
+
+        if (noWorkshop.length) {
+            await this.orders.syncWorkshopCount(noWorkshop, order.id, qtyById);
+        }
+
+        // Задания: по одному на каждый принтер каждого цеха.
+        const jobs = [];
+        for (const [workshopId, printData] of productsToPrint) {
+            let printers = await this.printers.findWorkshopPrinters([printTerminal ? printTerminal.id : null], workshopId);
+
+            // При делегировании печать жёстко привязана к целевому терминалу: fallback по всем
+            // терминалам компании в мультизоне напечатал бы заказ в чужой зоне.
+            if (!printers.length && !isDelegated) {
+                const terminalIds = await this.printers.findCompanyTerminalIds(order.team_id, context.companyId);
+                printers = await this.printers.findWorkshopPrinters(terminalIds, workshopId);
+            }
+            if (!printers.length) {
+                console.warn('[core][print] no printer found for workshop — skipping', {order_id: id, product_workshop_id: workshopId});
+                continue;
+            }
+
+            for (const printer of printers) {
+                if (!printer.terminal_id) {
+                    continue;
+                }
+                const printerTerminal = await this.printers.findTerminal(printer.terminal_id);
+                jobs.push({
+                    workshopId,
+                    printData: {
+                        data: printData.data,
+                        terminal_id: printer.terminal_id,
+                        terminal_name: printerTerminal ? printerTerminal.name : null,
+                        printer: printerPayload(printer, false),
+                    },
+                });
+            }
+        }
+
+        const receipts = jobs.length ? await this.receiptsOf(team) : null;
+        const requests = jobs.map(({workshopId, printData}) => {
+            // Стабильный per-ticket ключ: одинаков при повторе того же состояния — терминал
+            // распознаёт дубль и не печатает второй раз. request_id в ключ не входит.
+            const ticketSig = (syncOrderProducts.get(workshopId) || [])
+                .map((opId) => `${opId}:${qtyById.has(opId) ? qtyById.get(opId) : 0}`)
+                .sort()
+                .join('|');
+            const printIdempotencyKey = `${id}:${workshopId}:${printData.terminal_id}:${str(printData.printer.name)}:${md5(ticketSig)}`;
+
+            return {
+                workshopId,
+                printer: printData.printer,
+                terminalName: printData.terminal_name ?? '',
+                terminalId: printData.terminal_id,
+                requestId: uuid(),
+                data: {
+                    config: receipts.workshop_receipt_config,
+                    print_idempotency_key: printIdempotencyKey,
+                    ...printData,
+                },
+            };
+        });
+
+        // Контентный ключ: тот же набор позиций+количеств = тот же ключ, с какого бы терминала
+        // или по какому бы клику ни пришла отправка.
+        let idempotencyKey = null;
+        if (requests.length) {
+            // По снимку, из которого собраны чеки, а не по перечитанной БД: позиция, изменённая
+            // после сборки, не должна менять подпись уже собранного чека.
+            const opIds = [...new Set([...syncOrderProducts.values()].flat())];
+            const signature = opIds.map((opId) => `${opId}:${qty(qtyById.get(opId) ?? 0)}`).sort().join('|');
+            idempotencyKey = `print:sig:${id}:${md5(signature)}`;
+
+            // Такой же набор печатается прямо сейчас — отклоняем дубль.
+            if (!markAdd(`print:lock:${idempotencyKey}`, LOCK_TTL_MS)) {
+                return {async: false, duplicate: true, errors: []};
+            }
+            // Такой же набор только что успешно напечатан — не дублируем.
+            if (markHas(`print:done:${idempotencyKey}`)) {
+                markForget(`print:lock:${idempotencyKey}`);
+                return {async: false, duplicate: true, errors: []};
+            }
+        }
+
+        const errors = [];
+        if (requests.length) {
+            // Все цеха параллельно — общее время = самый медленный принтер, а не сумма.
+            const responses = await Promise.all(requests.map((request) => this.socketRequest({
+                terminalId: request.terminalId,
+                eventName: 'orders:printWorkshop',
+                data: request.data,
+                requestId: request.requestId,
+                timeout: WORKSHOP_TIMEOUT_MS,
+            })));
+
+            for (const [index, request] of requests.entries()) {
+                if (!isSuccess(responses[index])) {
+                    // Провал не синкает количество: позиция остаётся «неотправленной» и уйдёт
+                    // при следующей отправке.
+                    errors.push(printerError(request.printer.name, request.terminalName));
+                } else {
+                    await this.orders.syncWorkshopCount(syncOrderProducts.get(request.workshopId), id, qtyById);
+                }
+            }
+
+            // Успех → done (гасит повтор того же набора 30с), провал → снять lock (разрешить повтор).
+            if (idempotencyKey) {
+                if (!errors.length) {
+                    markPut(`print:done:${idempotencyKey}`, DONE_TTL_MS);
+                } else {
+                    markForget(`print:lock:${idempotencyKey}`);
+                }
+            }
+        }
+
+        // Ответ самодостаточен: фронт берёт ошибки и обновлённый чек прямо из него,
+        // не завися от доставки сокет-патча.
+        return {
+            async: false,
+            errors,
+            order: await this.orders.patchOrResource(id, {withTrashed: true}),
+        };
+    }
+
+    // ------------------------------------------------------------ счёт гостю
+
+    /** Товары счёта: гость → (товар + цена), модификаторы свёрнуты по имени и цене. */
+    billProducts(order, showTableServiceCharge) {
+        const byGuest = new Map();
+        for (const item of order.products) {
+            if (!byGuest.has(item.guest_number)) {
+                byGuest.set(item.guest_number, []);
+            }
+            byGuest.get(item.guest_number).push(item);
+        }
+
+        const products = [];
+        for (const group of byGuest.values()) {
+            const byProduct = new Map();
+            for (const item of group) {
+                const key = `${item.product_id}_${item.price}`;
+                if (!byProduct.has(key)) {
+                    byProduct.set(key, []);
+                }
+                byProduct.get(key).push(item);
+            }
+
+            for (const productGroup of byProduct.values()) {
+                const first = productGroup[0];
+
+                const modifications = new Map();
+                for (const item of productGroup) {
+                    for (const modifier of item.modifiers || []) {
+                        const price = money(modifier.price);
+                        const key = `${modifier.name}_${price}`;
+                        if (!modifications.has(key)) {
+                            modifications.set(key, {name: modifier.name, quantity: 0, price});
+                        }
+                        modifications.get(key).quantity += qty(modifier.quantity);
+                    }
+                }
+
+                let name = first.product ? translated(first.product.full_name, this.locale()) : null;
+                if (first.type === TYPE_TIMER) {
+                    first.calculate(order.serviceChargeMode);
+                    const minutes = first.elapsed_total_minutes;
+                    name = `${str(name)} ${pad(Math.trunc(minutes / 60))}:${pad(minutes % 60)}`;
+                }
+
+                products.push({
+                    name,
+                    quantity: sum(productGroup, 'quantity'),
+                    // весовой товар печатается как «1.5 kq», цена — за 1 kq
+                    is_weight_item: Boolean(first.product && toBool(first.product.is_weight_item)),
+                    unit_id: first.unit_id ?? null,
+                    price: first.price,
+                    discount_amount: sum(productGroup, 'discount_amount'),
+                    service_charge_amount: sum(productGroup, 'service_charge_amount'),
+                    total: showTableServiceCharge ? sum(productGroup, 'total') : sum(productGroup, 'subtotal'),
+                    modifications: [...modifications.values()],
+                });
+            }
+        }
+        return products;
+    }
+
+    /**
+     * Счёт (или пречек) на принтер «Qəbz». Повторная печать оплаченного чека закрытого заказа
+     * легальна (копия гостю), пречек по закрытому — нет: это шаг ДО оплаты.
+     */
+    async printBillReceipt(id, isPreReceipt = false) {
+        const context = this.context;
+        const preReceipt = phpTruthy(isPreReceipt);
+        const order = await this.orders.findOrFail(id, {withTrashed: true});
+        if (preReceipt) {
+            this.orders.assertMutable(order, 'orders.printBillReceipt:preReceipt');
+        }
+
+        const team = await this.printers.findTeam(order.team_id);
+        const timeZone = (team && team.timezone) || DEFAULT_TIMEZONE;
+        const terminal = context.getTerminal();
+        const cashier = await this.orders.snapshot.findTeamUserWithUser(context.employeeId);
+        const receipts = await this.receiptsOf(team);
+        const config = receipts.bill_receipt_config;
+
+        if (phpTruthy(receipts.auto_print_on_close)) {
+            // allowClosed: заказ здесь уже закрыт, guard обходим осознанно. Результат, как и в
+            // Laravel, не влияет на печать счёта.
+            await this.sendToWorkshops(order.id, {allowClosed: true});
+        }
+
+        const paymentsRow = findRow(config, 'payments');
+        const productsRow = findRow(config, 'order_products');
+        const showCharge = phpTruthy(paymentsRow?.config?.change?.value);
+        const showTableServiceCharge = phpTruthy(productsRow?.config?.service_charge?.value);
+
+        // Логотип — только если его печать включена в строке `logo` конфига и он есть у команды.
+        // На кассе это копия из снапшота (team_logos), в облаке — файл с диска картинки (findTeamLogo).
+        const logoRow = findRow(config, 'logo');
+        const logo = team && logoRow && phpTruthy(logoRow.print) ? await this.printers.findTeamLogo(team.id) : null;
+
+        const printedAt = now();
+        const source = order.source;
+        let hall = null;
+        let table = null;
+        if (source && source.type === DINE_IN) {
+            hall = alive(order.hall);
+            table = alive(order.table);
+        }
+
+        const payments = [];
+        for (const payment of order.payments) {
+            const method = await this.printers.findPaymentMethod(payment.payment_method_id);
+            // MoneyCast превращает null в 0, поэтому `real_amount ?? amount` в PHP — всегда real_amount.
+            const change = money(payment.change);
+            payments.push({
+                label: method ? method.name : null,
+                value: showCharge ? money(payment.real_amount) : money(payment.amount),
+                change: change > 0 && showCharge ? change : 0,
+            });
+        }
+
+        order.calculate(true, false);
+
+        const openedAt = order.opened_at ? parse(order.opened_at) : now();
+        const data = {
+            logo,
+            number: order.number,
+            opened_at: formatZoned(openedAt, timeZone),
+            closed_at: order.closed_at ? formatZoned(parse(order.closed_at), timeZone) : null,
+            printed_at: formatZoned(printedAt, timeZone),
+            cashier: cashier ? cashier.user_name ?? null : null,
+            waiter: order.waiter ? order.waiter.user_name ?? null : null,
+            id: order.id,
+            total: order.total,
+            subtotal: order.subtotal,
+            discount: order.discount_amount,
+            service_charge: order.service_charge_amount,
+            deposit_gap: round2(order.deposit_gap),
+            deposit_amount: round2(order.deposit_amount),
+            order_source_type: source ? source.type : null,
+            order_source_label: source ? source.name : null,
+            hall: hall ? hall.name : null,
+            table: table ? table.label : null,
+            courier: '',
+            comment: order.comment ?? null,
+            delivery_address: '',
+            print_name: receipts.print_name_of === 'team'
+                ? (team ? translated(team.name, this.locale()) : null)
+                : (context.getCompany() ? context.getCompany().name : null),
+            payments,
+            // appends Laravel-контроллер не пробрасывает (всегда []), фронт шлёт их зря.
+            appends: [],
+        };
+
+        const products = this.billProducts(order, showTableServiceCharge);
+
+        const printTerminal = await this.resolvePrintTerminal(terminal);
+        const isDelegated = PrintService.isDelegated(terminal, printTerminal);
+
+        let printer = await this.printers.findBillPrinter(printTerminal ? printTerminal.id : null);
+        // При делегировании печать привязана к целевому терминалу — без fallback по компании.
+        if (!printer && !isDelegated) {
+            printer = await this.printers.findCompanyBillPrinter(terminal ? terminal.company_id : context.companyId);
+        }
+        if (!printer) {
+            // Имя терминала в тексте — оператору видно, где отметить принтер «Qəbz»
+            // (при делегировании это НЕ тот терминал, с которого нажали печать).
+            return {
+                success: false,
+                title: 'Printer tapılmadı',
+                message: isDelegated
+                    ? `"${str(printTerminal.name)}" terminalında qəbz printeri tapılmadı`
+                    : 'Qəbz çapı üçün printer tapılmadı',
+            };
+        }
+
+        data.products = products;
+        const printData = {
+            data,
+            terminal_id: printer.terminal_id,
+            config,
+            printer: printerPayload(printer, !preReceipt && toBool(printer.cashdraw)),
+        };
+
+        const response = await this.socketRequest({
+            terminalId: printData.terminal_id,
+            eventName: 'orders:printBillReceipt',
+            data: printData,
+            requestId: uuid(),
+            timeout: BILL_TIMEOUT_MS,
+        });
+
+        if (!isSuccess(response)) {
+            const printerTerminal = await this.printers.findTerminal(printer.terminal_id);
+            // Хвостовой апостроф — опечатка исходной строки Laravel; оставлен ради паритета текста.
+            return {
+                success: false,
+                ...printerError(printData.printer.name, printerTerminal ? printerTerminal.name : null, "'"),
+            };
+        }
+
+        await this.orders.saveEvents([{
+            event: 'orders:printBillReceipt',
+            time: nowSql(),
+            order_id: order.id,
+        }]);
+
+        // Laravel кладёт сюда Carbon в зоне команды, и Eloquent пишет его стенные часы как есть.
+        // Повторяем то же значение: в облачном контуре обе реализации пишут в одну колонку.
+        order.printed_at = formatZoned(printedAt, timeZone);
+
+        // Пречек — снимок суммы, гость ещё сидит: таймер НЕ останавливаем. Финальный чек
+        // останавливает повременные позиции (в памяти, сохранятся вместе с пересчётом).
+        if (!preReceipt) {
+            const stoppedAt = nowSql();
+            for (const item of order.products) {
+                if (item.type === TYPE_TIMER && !item.is_stopped) {
+                    item.is_stopped = true;
+                    item.stopped_at = stoppedAt;
+                    item.receipt_print_quantity = 1;
+                }
+            }
+        }
+
+        order.calculate(true, true);
+        await this.orders.orders.save(order);
+        await this.orders.emitPatch(order.id);
+        return [];
+    }
+
+    // ------------------------------------------------------------ принтер счёта терминала
+
+    /** PrinterController::getReceiptPrinter — принтер «Qəbz» текущего терминала или null. */
+    async getReceiptPrinter() {
+        const printer = await this.printers.findBillPrinter(this.context.terminalId);
+        if (!printer) {
+            return null;
+        }
+        return {
+            name: printer.name,
+            type: printer.type,
+            ip_address: printer.ip_address,
+            mac_address: printer.mac_address ?? null,
+            vendor_id: printer.vendor_id,
+            product_id: printer.product_id,
+            bell: flag(printer.bell),
+            cashdraw: flag(printer.cashdraw),
+        };
+    }
+}
+
+PrintService.resetPrintMarks = resetPrintMarks;
+PrintService.formatZoned = formatZoned;
+
+module.exports = PrintService;