@alizadefaig/pos-server 1.2.26 → 1.2.28

package/app/core/services/PrinterAdminService.js

@@ -0,0 +1,324 @@
+const {HttpError} = require('../errors');
+const {uuid} = require('../support/ids');
+const {nowSql} = require('../support/time');
+const {toBool} = require('../support/num');
+const {castRow} = require('../support/db');
+const {phpTruthy} = require('../support/receipts');
+
+/**
+ * Порт App\Http\Controllers\Api\Platform\PrinterController: настройка принтеров терминала
+ * (update / list / delete / get / syncAddress). Печать — отдельно, в PrintService.
+ *
+ * Без облака касса должна уметь назначить принтер цеху, сменить принтер счёта или подхватить
+ * новый IP принтера: иначе замена принтера посреди смены останавливает кухню до возвращения
+ * интернета. Локальные правки помечаются грязными триггерами 010 и уезжают в облако push'ем
+ * (sync/push.js), облачные приходят снапшотом.
+ *
+ * Семантика запросов — как у Eloquent:
+ *   - Printer::query() не видит soft-deleted — у printers deleted_at есть в обеих схемах;
+ *   - у product_workshops и terminals в локальном снапшоте deleted_at нет (удалённое туда не
+ *     приходит), поэтому условие на них — только под Postgres;
+ *   - where([... => null]) — это IS NULL;
+ *   - Builder::update() и SoftDeletes ставят updated_at.
+ */
+
+// FILTER_VALIDATE_IP + FILTER_FLAG_IPV4: четыре октета 0..255 без ведущих нулей.
+const OCTET = '(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)';
+const IPV4 = new RegExp(`^${OCTET}(?:\\.${OCTET}){3}$`);
+
+// Printer::normalizeMac: разделитель один на весь адрес, октет из 1–2 знаков.
+const MAC = /^\s*([0-9a-f]{1,2})([:-])([0-9a-f]{1,2})(?:\2([0-9a-f]{1,2})){4}\s*$/i;
+
+const normalizeMac = (value) => {
+    if (typeof value !== 'string' || !MAC.test(value)) {
+        return null;
+    }
+    const mac = value.trim().split(/[:-]/).map((octet) => octet.toLowerCase().padStart(2, '0')).join(':');
+    return mac === '00:00:00:00:00:00' || mac === 'ff:ff:ff:ff:ff:ff' ? null : mac;
+};
+
+// $request->boolean(): FILTER_VALIDATE_BOOLEAN — true только для 1/'1'/'true'/'on'/'yes'.
+const requestBoolean = (value) => {
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    if (typeof value === 'number') {
+        return value === 1;
+    }
+    if (typeof value === 'string') {
+        return ['1', 'true', 'on', 'yes'].includes(value.trim().toLowerCase());
+    }
+    return false;
+};
+
+// Идентификаторы USB приходят из скана числами, а лежат строками. Postgres не сравнит varchar с
+// integer-параметром, поэтому в запрос уходит строка.
+const asText = (value) => (value === null || value === undefined ? null : String(value));
+
+// where(column, value) у Eloquent: null → IS NULL, иначе обычное равенство — с индексом в Postgres
+// (IS NOT DISTINCT FROM индекс не использует).
+const eq = (column, value) => (value === null || value === undefined
+    ? {sql: ` AND ${column} IS NULL`, params: []}
+    : {sql: ` AND ${column} = ?`, params: [value]});
+
+const where = (...parts) => ({
+    sql: parts.map((part) => part.sql).join(''),
+    params: parts.flatMap((part) => part.params),
+});
+
+// Сравнение значения из запроса с колонкой «по смыслу» — как isDirty у Eloquent для флагов
+// (true и 1 — одно и то же, иначе каждое сохранение без изменений писало бы строку и гнало push).
+const sameValue = (column, current, next) => {
+    if (['bill', 'bell', 'cashdraw'].includes(column)) {
+        return current !== null && current !== undefined && next !== null && next !== undefined
+            ? toBool(current) === toBool(next)
+            : current === next;
+    }
+    return (current ?? null) === (next ?? null);
+};
+
+class PrinterAdminService {
+    constructor({db, context}) {
+        this.db = db;
+        this.context = context;
+    }
+
+    notDeleted(alias = null) {
+        return this.db.dialect === 'pgsql' ? ` AND ${alias ? `${alias}.` : ''}deleted_at IS NULL` : '';
+    }
+
+    /** DB::table('product_workshops')->where(team_id, deleted_at = null)->get(). */
+    async workshops() {
+        const rows = await this.db.all(
+            `SELECT * FROM product_workshops WHERE team_id = ?${this.notDeleted()}`,
+            [this.context.teamId]
+        );
+        return rows.map((row) => {
+            const {synced_at: ignored, ...rest} = row;
+            return rest;
+        });
+    }
+
+    /** pluck('print_ticket', 'product_workshop_id'): объект, пустой → [] (пустая коллекция в JSON). */
+    async workshopSettings(printerId, db = this.db) {
+        const rows = await db.all(
+            'SELECT product_workshop_id, print_ticket FROM printer_workshop WHERE printer_id = ?',
+            [printerId]
+        );
+        if (!rows.length) {
+            return [];
+        }
+        const settings = {};
+        for (const row of rows) {
+            settings[row.product_workshop_id] = toBool(row.print_ticket);
+        }
+        return settings;
+    }
+
+    /**
+     * Условие поиска сетевого принтера: с MAC — строка с тем же MAC или строка без MAC на этом
+     * IP (записанная до привязки), MAC-строка первой; без MAC — по IP.
+     */
+    lanMatch(ip, mac) {
+        if (!mac) {
+            return {...eq('ip_address', asText(ip)), order: ''};
+        }
+        const byIp = eq('ip_address', asText(ip));
+        return {
+            sql: ` AND (mac_address = ? OR (mac_address IS NULL${byIp.sql}))`,
+            params: [mac, ...byIp.params],
+            order: ' ORDER BY (mac_address IS NULL)',
+        };
+    }
+
+    async update(params) {
+        const terminalId = this.context.terminalId;
+        const type = params.type ?? null;
+        const productId = params.product_id ?? null;
+        const vendorId = params.vendor_id ?? null;
+        const ip = params.ip_address ?? null;
+        const mac = type === 'LAN' ? normalizeMac(params.mac_address) : null;
+        const cashdraw = requestBoolean(params.cashdraw);
+
+        return this.db.transaction(async (db) => {
+            let filter = eq('terminal_id', terminalId);
+            let order = '';
+            if (type === 'USB') {
+                filter = where(filter, eq('product_id', asText(productId)), eq('vendor_id', asText(vendorId)));
+            } else if (type === 'LAN') {
+                const match = this.lanMatch(ip, mac);
+                filter = where(filter, match);
+                order = match.order;
+            }
+            const existing = await db.get(
+                `SELECT * FROM printers WHERE deleted_at IS NULL${filter.sql}${order} LIMIT 1`,
+                filter.params
+            );
+
+            const changes = {
+                name: params.name ?? null,
+                // Laravel пишет bill/bell как пришли. null в NOT NULL-колонку уронил бы запрос,
+                // поэтому непереданный флаг оставляем прежним (у новой строки — DEFAULT).
+                ...(params.bill === undefined || params.bill === null ? {} : {bill: params.bill}),
+                ...(params.bell === undefined || params.bell === null ? {} : {bell: params.bell}),
+                cashdraw,
+                ...(mac ? {ip_address: asText(ip), mac_address: mac} : {}),
+            };
+
+            const now = nowSql();
+            let printerId;
+            if (existing) {
+                printerId = existing.id;
+                const dirty = {};
+                for (const [column, value] of Object.entries(changes)) {
+                    if (!sameValue(column, existing[column], value)) {
+                        dirty[column] = value;
+                    }
+                }
+                if (Object.keys(dirty).length) {
+                    await db.update('printers', printerId, castRow({...dirty, updated_at: now}));
+                }
+            } else {
+                printerId = uuid();
+                await db.insert('printers', castRow({
+                    id: printerId,
+                    ip_address: asText(ip),
+                    mac_address: mac,
+                    type,
+                    vendor_id: asText(vendorId),
+                    product_id: asText(productId),
+                    terminal_id: terminalId,
+                    team_id: this.context.teamId,
+                    company_id: this.context.companyId,
+                    ...changes,
+                    created_at: now,
+                    updated_at: now,
+                }));
+            }
+
+            // BelongsToMany::sync со списком строк: ключи списка — 0..n, поэтому текущие связи
+            // уходят все, а строки вставляются заново. То есть полная замена цехов принтера.
+            const settings = params.workshop_settings;
+            if (phpTruthy(settings) && typeof settings === 'object') {
+                await db.run('DELETE FROM printer_workshop WHERE printer_id = ?', [printerId]);
+                for (const [workshopId, printTicket] of Object.entries(settings)) {
+                    await db.run(
+                        'INSERT INTO printer_workshop (printer_id, product_workshop_id, print_ticket) VALUES (?, ?, ?)',
+                        [printerId, workshopId, castRow({print_ticket: printTicket}).print_ticket]
+                    );
+                }
+            }
+            return true;
+        });
+    }
+
+    async list() {
+        const workshops = await this.workshops();
+        const filter = eq('terminal_id', this.context.terminalId);
+        const rows = await this.db.all(`SELECT * FROM printers WHERE deleted_at IS NULL${filter.sql}`, filter.params);
+        const printers = [];
+        for (const printer of rows) {
+            printers.push({
+                id: printer.id,
+                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,
+                bill: toBool(printer.bill),
+                bell: toBool(printer.bell),
+                cashdraw: toBool(printer.cashdraw),
+                workshop_settings: await this.workshopSettings(printer.id),
+            });
+        }
+        return {workshops, printers};
+    }
+
+    async delete(params) {
+        return this.db.transaction(async (db) => {
+            const filter = where(eq('terminal_id', this.context.terminalId), eq('id', asText(params.id)));
+            const printer = await db.get(`SELECT id FROM printers WHERE deleted_at IS NULL${filter.sql} LIMIT 1`, filter.params);
+            if (printer) {
+                await db.run('DELETE FROM printer_workshop WHERE printer_id = ?', [printer.id]);
+                const now = nowSql();
+                await db.update('printers', printer.id, {deleted_at: now, updated_at: now});
+            }
+            return true;
+        });
+    }
+
+    async syncAddress(params) {
+        const mac = normalizeMac(params.mac_address);
+        const ip = params.ip_address;
+        if (!mac || typeof ip !== 'string' || !IPV4.test(ip)) {
+            throw new HttpError(422, {success: false, message: 'Invalid printer address'});
+        }
+        const now = nowSql();
+
+        const own = eq('terminal_id', this.context.terminalId);
+        const bound = await this.db.run(
+            `UPDATE printers SET mac_address = ?, updated_at = ?
+             WHERE deleted_at IS NULL${own.sql} AND type = 'LAN' AND mac_address IS NULL AND ip_address = ?`,
+            [mac, now, ...own.params, ip]
+        );
+
+        const company = eq('company_id', this.context.companyId);
+        const moved = await this.db.run(
+            `UPDATE printers SET ip_address = ?, updated_at = ?
+             WHERE deleted_at IS NULL
+               AND terminal_id IN (SELECT id FROM terminals WHERE 1 = 1${company.sql}${this.notDeleted()})
+               AND type = 'LAN' AND mac_address = ? AND ip_address != ?`,
+            [ip, now, ...company.params, mac, ip]
+        );
+
+        return {success: true, bound: bound?.changes ?? 0, moved: moved?.changes ?? 0};
+    }
+
+    /**
+     * Скан локального Node (params.printers) + сохранённые настройки: по каждому найденному
+     * принтеру — цеха, счёт, звонок и имя из БД. Не найден — все цеха выключены.
+     */
+    async get(params) {
+        const scanned = Array.isArray(params.printers) ? params.printers
+            : (params.printers && typeof params.printers === 'object' ? Object.values(params.printers) : []);
+        const workshops = await this.workshops();
+        const printers = [];
+        for (const item of scanned) {
+            const printerData = {...(item || {})};
+            const mac = printerData.type === 'LAN' ? normalizeMac(printerData.mac_address) : null;
+
+            const match = this.lanMatch(printerData.ip_address, mac);
+            const filter = where(
+                eq('product_id', asText(printerData.product_id)),
+                eq('vendor_id', asText(printerData.vendor_id)),
+                eq('terminal_id', this.context.terminalId),
+                eq('type', asText(printerData.type)),
+                match
+            );
+            const printer = await this.db.get(
+                `SELECT * FROM printers WHERE deleted_at IS NULL${filter.sql}${match.order} LIMIT 1`,
+                filter.params
+            );
+
+            const workshopSettings = {};
+            for (const workshop of workshops) {
+                workshopSettings[workshop.id] = false;
+            }
+            printerData.workshop_settings = workshops.length ? workshopSettings : [];
+            printerData.bill = false;
+            printerData.bell = false;
+            if (printer) {
+                printerData.bill = toBool(printer.bill);
+                printerData.bell = toBool(printer.bell);
+                printerData.name = printer.name;
+                printerData.workshop_settings = await this.workshopSettings(printer.id);
+            }
+            printers.push(printerData);
+        }
+        return {workshops, printers};
+    }
+}
+
+module.exports = PrinterAdminService;
+module.exports.normalizeMac = normalizeMac;