@alizadefaig/pos-server 1.2.26 → 1.2.27

package/app/sync/config.js

@@ -0,0 +1,185 @@
+const {Database} = require('../db/Database');
+
+/**
+ * Настройки синка локального Node с облаком (OFFLINE-FIRST-PLAN §11, модель F).
+ *
+ * Читаются прямо из env, а не через app/core: ядро само спрашивает у синка текущий режим,
+ * и обратный require дал бы цикл.
+ *
+ * Всё выключено по умолчанию. Синк работает только поверх локальной SQLite: в облачном
+ * контуре (CORE_DB=pgsql) ядро пишет прямо в боевую базу, синхронизировать там нечего.
+ */
+const flag = (name, fallback = 'false') => (process.env[name] ?? fallback) === 'true';
+
+const num = (name, fallback) => {
+    const value = Number(process.env[name]);
+    return Number.isFinite(value) && value > 0 ? value : fallback;
+};
+
+const isCoreEnabled = () => flag('OFFLINE_CORE');
+
+const isSyncEnabled = () => isCoreEnabled() && flag('OFFLINE_SYNC') && Database.defaultDialect() === 'sqlite';
+
+const stripSlash = (value) => String(value || '').trim().replace(/\/+$/, '');
+
+const masterSetting = () => stripSlash(process.env.OFFLINE_MASTER_URL);
+
+/** OFFLINE_MASTER_URL=auto — адрес мастера ищется в сети (discovery.js). */
+const isMasterAuto = () => masterSetting().toLowerCase() === 'auto';
+
+// Последний найденный автопоиском адрес мастера; пишет только discovery.js.
+let discoveredMasterUrl = null;
+
+const setDiscoveredMasterUrl = (url) => {
+    discoveredMasterUrl = url ? stripSlash(url) : null;
+};
+
+/**
+ * Адрес мастера в зале (http://192.168.1.10:3005). При auto — найденный в сети, до первого
+ * ответа мастера null: запросы к мастеру тогда отвечают «мастер недоступен».
+ */
+const masterUrl = () => (isMasterAuto() ? discoveredMasterUrl : masterSetting() || null);
+
+/**
+ *   standalone — одна касса: сама держит БД и сама синкается с облаком;
+ *   master     — то же, плюс обслуживает ведомые терминалы зала по LAN;
+ *   follower   — своей БД не ведёт: офлайн ходит к мастеру, синком не занимается.
+ *
+ * Ведомый — по настройке, а не по найденному адресу: касса с auto, ещё не нашедшая мастера,
+ * не должна на это время становиться самостоятельной и вести свои чеки.
+ */
+const role = () => {
+    if (masterSetting()) {
+        return 'follower';
+    }
+    return (process.env.OFFLINE_ROLE || '').toLowerCase() === 'master' ? 'master' : 'standalone';
+};
+
+/** Общий секрет зала: без него чужое устройство в той же сети не достучится до мастера. */
+const lanKey = () => process.env.CAFEPOS_LAN_KEY || null;
+
+const LAN_KEY_HEADER = 'x-cafepos-lan-key';
+
+const intervals = () => ({
+    tick: num('OFFLINE_SYNC_TICK_MS', 3000),
+    health: num('OFFLINE_HEALTH_MS', 3000),
+    pull: num('OFFLINE_PULL_MS', 15000),
+    // сигнальный сокет облака оборван — патчи о чужих правках не придут, опрашиваем чаще
+    pullWithoutSignal: num('OFFLINE_PULL_NO_SIGNAL_MS', 3000),
+    snapshot: num('OFFLINE_SNAPSHOT_MS', 600000),
+    signalDebounce: num('OFFLINE_SIGNAL_DEBOUNCE_MS', 300),
+    // модель M: как часто спрашивать у облака режим заведения (заодно это heartbeat кассы)
+    modePoll: num('OFFLINE_MODE_POLL_MS', 10000),
+    // выход терминала при недосланном: столько push досылает очередь, прежде чем токен отзовут
+    logoutGrace: num('OFFLINE_LOGOUT_GRACE_MS', 600000),
+});
+
+const timeouts = () => ({
+    health: num('OFFLINE_HEALTH_TIMEOUT_MS', 3000),
+    api: num('OFFLINE_API_TIMEOUT_MS', 15000),
+    snapshot: num('OFFLINE_SNAPSHOT_TIMEOUT_MS', 60000),
+    push: num('OFFLINE_PUSH_TIMEOUT_MS', 30000),
+    // запрос ведомого к мастеру: мастер сам может ждать облако, поэтому запас больше api
+    master: num('OFFLINE_MASTER_TIMEOUT_MS', 20000),
+});
+
+const limits = () => ({
+    pushBatch: num('OFFLINE_PUSH_BATCH', 50),
+    pullLimit: num('OFFLINE_PULL_LIMIT', 500),
+    pullPages: num('OFFLINE_PULL_PAGES', 20),
+    // гистерезис связи: сколько подряд провалов/успехов переключают режим
+    failuresToOffline: num('OFFLINE_FAILURES_TO_OFFLINE', 2),
+    successesToOnline: num('OFFLINE_SUCCESSES_TO_ONLINE', 3),
+    // чек, который облако раз за разом не принимает, не должен вечно держать recovering
+    poisonAttempts: num('OFFLINE_POISON_ATTEMPTS', 5),
+    // сколько дней локально держим закрытые чеки (архив офлайн)
+    keepClosedDays: num('OFFLINE_KEEP_CLOSED_DAYS', 3),
+});
+
+/**
+ * Сверка касса ↔ облако (P2): закрытые чеки за последние windowHours часов, раз в interval.
+ * settle — хвост окна, который не сверяется: только что закрытый чек мог ещё не доехать.
+ * Включена по умолчанию, но работает только внутри синка (сам синк за флагами).
+ */
+const isReconcileEnabled = () => flag('OFFLINE_RECONCILE', 'true');
+
+const reconcile = () => ({
+    interval: num('OFFLINE_RECONCILE_MS', 300000),
+    // после расхождения — проверить лечение раньше обычного
+    retry: num('OFFLINE_RECONCILE_RETRY_MS', 60000),
+    windowHours: num('OFFLINE_RECONCILE_WINDOW_H', 24),
+    settle: num('OFFLINE_RECONCILE_SETTLE_MS', 300000),
+    maxHeal: num('OFFLINE_RECONCILE_MAX_HEAL', 500),
+    // столько сверок подряд с расхождением — тревога в суперадминке
+    alarmAfter: num('OFFLINE_RECONCILE_ALARM_AFTER', 3),
+});
+
+/**
+ * Облачный Node (модель M): принимает сигнальные сокеты мастер-касс и ретранслирует им события
+ * заведений в режиме local (POST /master/request от Laravel). Выключено по умолчанию.
+ */
+const isMasterRelayEnabled = () => flag('MASTER_RELAY_ENABLED');
+
+// Меньше таймаутов Laravel (pos_mode.relay_timeout 20с / relay_print_timeout 150с): облачный Node
+// обязан ответить сам — «мастер не успел», а не оборвать Laravel на полуслове.
+const relayTimeouts = () => ({
+    api: num('MASTER_RELAY_TIMEOUT_MS', 17000),
+    print: num('MASTER_RELAY_PRINT_TIMEOUT_MS', 140000),
+    // проверка личности мастера через Laravel (sync.mode)
+    verify: num('MASTER_RELAY_VERIFY_TIMEOUT_MS', 10000),
+});
+
+/** Общий секрет Laravel ↔ Node для служебных путей (/socket, /socket/request, /master/*). */
+const internalKey = () => process.env.INTERNAL_API_KEY || null;
+
+const INTERNAL_KEY_HEADER = 'x-internal-key';
+
+/**
+ * Переход браузера облако → мастер по LAN (официант на телефоне без интернета). Мастер раздаёт
+ * копию фронта с облака и пускает телефон по его токену (список хешей токенов заведения — из
+ * облака, sync.lanDevices). Только у мастера зала с ключом: остальным раздавать некого.
+ */
+const isLanFrontEnabled = () => flag('LAN_FRONT') && isSyncEnabled() && role() === 'master' && Boolean(lanKey());
+
+/** Откуда брать фронт: тот же сайт, с которого работает официант. */
+const lanFrontUrl = () => stripSlash(process.env.LAN_FRONT_URL) || 'https://platform.cafepos.az';
+
+const lanFront = () => ({
+    // как часто сверять версию фронта с облаком
+    sync: num('LAN_FRONT_SYNC_MS', 600000),
+    // повтор после неудачной загрузки
+    retry: num('LAN_FRONT_RETRY_MS', 60000),
+    // как часто обновлять список токенов устройств
+    devices: num('LAN_DEVICES_MS', 60000),
+    timeout: num('LAN_FRONT_TIMEOUT_MS', 30000),
+    maxFiles: num('LAN_FRONT_MAX_FILES', 2000),
+    maxBytes: num('LAN_FRONT_MAX_MB', 150) * 1024 * 1024,
+});
+
+/** Путь проверки связи. /up — health-роут Laravel 11: через облачный Node он проверяет весь путь. */
+const healthPath = () => process.env.OFFLINE_HEALTH_PATH || '/up';
+
+module.exports = {
+    isCoreEnabled,
+    isSyncEnabled,
+    masterUrl,
+    isMasterAuto,
+    setDiscoveredMasterUrl,
+    role,
+    lanKey,
+    LAN_KEY_HEADER,
+    intervals,
+    timeouts,
+    limits,
+    isReconcileEnabled,
+    reconcile,
+    healthPath,
+    stripSlash,
+    isMasterRelayEnabled,
+    relayTimeouts,
+    internalKey,
+    INTERNAL_KEY_HEADER,
+    isLanFrontEnabled,
+    lanFrontUrl,
+    lanFront,
+};