v3.7.0 Pro — Tuya Cloud Hardware Calibration & Wake-Up Engine

🚀 What's New in v3.7.0 Pro

⚡ Tuya Cloud Hardware Energy Calibration (\�dd_ele)

• Hourly Non-Blocking Calibration: Automatically reconciles local trapezoidal energy integration against the smart plug's internal measurement chip every hour at \XX:05\ in a detached background thread.
• Quota-Friendly: Consumes only ~24 calls/day (~720/mo, just 1.4% of Tuya Cloud's 50,000 monthly quota).
• 99.9% Field Precision: Verified live on hardware with 0.001 kWh delta.
• Interactive UI Badge: Added calibration percentage card with a manual on-demand trigger to Desktop and iPad analytics modals.

⏱️ UI Wake-Up Latency Fix (Zero Counter Delay)

• Eliminated ~5-Minute Counter Delay: Fixed browser socket hangs upon waking tablets/browsers by adding strict 2.5s/4.0s \AbortController\ fetch timeouts.
• Instant Wake-Up Reconnect: Added \�isibilitychange\ and \ocus\ listeners that trigger instant polling and timer resynchronization upon unlocking screens or focusing tabs.
• Scanning Threshold: Raised false-positive subnet scan threshold to 5 consecutive failures.

🛡️ Security & Outage Hardening

• Atomic Config Persistence: Implemented \�tomic_write\ (temp file + atomic replace) to protect JSON config from corruption during sudden 220V power blackouts.
• LAN Guard: Enforced strict network boundaries — administrative endpoints and cloud calls reject external WAN traffic with HTTP 403 Forbidden.
• CORS Protection: Whitelisted origin domains for API security.

🏗️ Architecture & Automated Testing

• Separation of Concerns: Extracted thermodynamic logic into standalone \ridge_logic.py.
• Modular Frontend: Cleanly separated inline assets into dedicated \dashboard.css, \dashboard.js, and \�nalytics.js.
• Test Suite: 33 unit tests covering logic, security, and calibration running in under 0.1s.

---

Deployed & verified on Android TV Box H96 Max + iPad 3 Retina Kiosk.

v3.6.0 Pro — Energy & Health Analytics Intelligence

⚡ SmartFridge-Telemetry-Kiosk v3.6.0 Pro — Energy & Health Analytics Intelligence

---

🇷🇺 Описание (RU)

Масштабный релиз с глубоким аналитическим модулем, честным энергоучётом, оценкой здоровья компрессора и интерактивными графиками.

Что нового:

• 📊 Модуль энергоучёта и финансового расчёта:

  • Честный интегральный расчёт электроэнергии (кВт·ч) на основе мощности каждого цикла раздельно для мотора компрессора и ТЭНа No Frost.
  • Автоматический подсчёт среднесуточного расхода (~1.27 кВт·ч/сут) и месячного прогноза (~38.7 кВт·ч/мес).
  • Интерактивный калькулятор стоимости электроэнергии с сохранением тарифа в config.json и поддержкой валют (₽, ₴, $, €, ₸).
  • Новые REST API эндпоинты: /api/analytics и /api/tariff (GET/POST).

• 🩺 Оценка здоровья и предиктивная диагностика:

  • Интегральный индекс здоровья холодильника (Health Score 88/100).
  • Аудит качества электросети: подсчёт часов в зоне риска при падении напряжения ниже 190 В и доли нормального питания ($\ge 205$ В).
  • Диагностика системы автооттайки No Frost: статистика циклов нагрева (~25 мин, 155 Вт), выявление перегрева или обмерзания испарителя.

• 📈 Интерактивные графики Chart.js:

  • Динамика за 14 дней: двойная ось — расход электроэнергии (кВт·ч, столбцы) и КРВ (зелёная линия).
  • Суточный профиль (24h): процент активности компрессора по часам (00:00–23:00) с наложением кривой напряжения сети (наглядное отображение вечерних просадок).

• ⚡ Высокая производительность и серверный RAM-кэш:

  • Кэширование аналитики в оперативной памяти (TTL 10 минут) снизило время ответа API с 998 мс до 11.2 мс на ARM-процессоре Rockchip RK3318.
  • Постраничная загрузка архива: мгновенная отдача 30 последних циклов и отдельное модальное окно полного журнала (300+ записей).

• 🎨 Интерфейс и совместимость:

  • Стилизованные cyber-dark скроллбары с градиентом и «липкими» заголовками (sticky header).
  • Полная поддержка iPad Kiosk Mode для старых планшетов (iOS 9–12 Safari, чистый ES5 без сторонних бандлов).
  • Обновление зависимостей
    equests >= 2.32.3 и Flask >= 3.1.0.

---

🇬🇧 English Description (EN)

Major functional release featuring comprehensive energy accounting, compressor health scoring, interactive diurnal analytics, and zero-latency RAM caching.

What's New:

• 📊 Energy & Cost Accounting Engine:

  • True integral energy calculation (kWh) split between compressor motor and No Frost defrost heating element.
  • Automated daily average consumption (~1.27 kWh/day) and monthly projection (~38.7 kWh/month).
  • Interactive tariff calculator with real-time recalculation, currency selection (₽, ₴, $, €, ₸), and persistence in config.json.
  • Dedicated REST endpoints: /api/analytics and /api/tariff (GET/POST).

• 🩺 Health Index & Predictive Diagnostics:

  • Overall appliance Health Score (88/100).
  • Grid quality assessment: tracking cumulative risk hours when voltage drops below 190V and percentage of nominal power ($\ge 205).
  • No Frost defrost audit: automated heating cycle statistics (~25 min, 155W heater) preventing evaporator icing.

• 📈 Interactive Chart.js Visualizations:

  • 14-Day Timeline: Dual-axis bar & line chart correlating daily kWh consumption against duty cycle (KRV).
  • 24-Hour Diurnal Profile: Hourly compressor activity percentage overlaid with grid voltage line chart, clearly exposing evening voltage drops.

• ⚡ Performance & Server RAM Caching:

  • In-memory caching layer (TTL 10 min) reducing API latency from ~1000 ms to 11.2 ms on Rockchip RK3318 ARM SBC.
  • History archive pagination: lightweight 30-cycle default viewport with on-demand full journal modal (300+ cycles).

• 🎨 UI & Legacy Kiosk Support:

  • Custom cyber-dark scrollbars with neon accents and sticky table headers.
  • 100% legacy iPad Kiosk Mode compatibility (pure ES5 for iOS 9–12 Safari).
  • Security upgrades: bumped
    equests >= 2.32.3 and Flask >= 3.1.0.

v3.5.2 Pro — Policy Routing Shield & 7-Day Storage Shield

🛡️ SmartFridge-Telemetry-Kiosk v3.5.2 Pro — Policy Routing Shield & 7-Day Storage Shield

---

🇷🇺 Описание (RU)

Комплексное обновление отказоустойчивости: защита локального трафика при включенном VPN, автоматическая ротация базы данных и интерактивный центр помощи.

Что нового:

• 🛡️ Linux Policy Routing Shield: внедрение системных правил маршрутизации ядра Linux (ip rule pref 9000/9001 + eth0) на приставке H96 Max — внешние VPN-клиенты (Telegram-боты) работают 24/7 без перехвата или блокировки локальной телеметрии 192.168.0.x.
• 🗄️ 7-дневная автоочистка SQLite: автоматическое скользящее окно хранения сырых измерений с фиксацией размера базы данных на уровне ~11 МБ при бессрочном сохранении всех циклов и блэкаутов.
• ℹ️ Интерактивный центр справки: встроенное 4-вкладочное модальное окно: «О программе», «База знаний (FAQ)», «Характеристики холодильника Samsung RT34MB» и полная «История версий».
• 📱 Полный паритет интерфейсов: единая справочная система и двуязычные данные как в десктопной версии, так и в Kiosk Mode для iPad.

---

🇬🇧 English Description (EN)

The ultimate resilience update: VPN coexistence with local smart devices, rolling database maintenance, and an integrated interactive help center.

What's New:

• 🛡️ Linux Policy Routing Shield: Implemented kernel policy routing (ip rule pref 9000/9001 + eth0) on H96 Max, allowing system VPN clients (Telegram bots, external tunnels) to run 24/7 without hijacking or blocking LAN telemetry on 192.168.0.x.
• 🗄️ 7-Day SQLite Auto-Pruning: Rolling retention policy for raw 4-second telemetry (measurements), locking database size at ~11 MB forever while preserving all historical compressor cycles and blackout logs indefinitely.
• ℹ️ Interactive Help Center: Built-in multi-tab modal window with About the Program, Knowledge Base (FAQ), Technical Specs of Samsung RT34MB, and complete Version History (v1.0.0 to v3.5.2).
• 📱 Dual UI Parity: Identical Help and Version History integration across both Desktop web UI and vintage iPad Kiosk mode.

v3.5.0 — Blackout Recovery Intelligence

⚡ SmartFridge-Telemetry-Kiosk v3.5.0 — Blackout Recovery Intelligence

---

🇷🇺 Описание (RU)

Интеллектуальная система защиты при аварийных отключениях электросети 220В (блэкаутах) с оценкой сохранности замороженных продуктов.

Что нового:

• 🔌 Аппаратный детектор блэкаута: точное определение отключения 220В по времени аптайма ядра Linux (/proc/uptime), исключающее ложные срабатывания при перезагрузке Wi-Fi.
• 🥩 Индекс безопасности продуктов: расчет степени разморозки морозилки по физической кривой удержания холода (до 8–10 часов безопасного хранения).
• 🧩 Автосклейка циклов: закрытие незавершенных циклов перед аварией и защита от искажения статистики КРВ.
• ⏱️ Живые таймеры работы и отдыха: непрерывный секундный отсчет длительности компрессорного цикла и времени простоя.

---

🇬🇧 English Description (EN)

Resilience against power outages with automatic blackout tracking, cycle reconstruction, and food safety estimation.

What's New:

• 🔌 Hardware Cold-Boot Detection: Distinguishes genuine power grid cuts from temporary Wi-Fi disconnects using system uptime (/proc/uptime).
• 🥩 Food Safety Evaluation: Thermodynamic calculation of cold preservation during outages up to 8–10 hours.
• 🧩 Cycle De-fragmentation: Automatically terminates unclosed cycles before outages and prevents corrupted cycle statistics.
• ⏱️ Live Running/Rest Timers: Dual elapsed time counters showing active cooling or compressor rest duration.

v3.4.0 — Zero-Cloud Direct Wi-Fi & iPad Kiosk

🏠 SmartFridge-Telemetry-Kiosk v3.4.0 — Zero-Cloud Direct Wi-Fi & iPad Kiosk

---

🇷🇺 Описание (RU)

100% независимость от облака! Прямой локальный сокет с умной розеткой и специализированный киоск-интерфейс для винтажных планшетов iPad.

Что нового:

• ⚡ Direct Wi-Fi Local Socket: прямой высокоскоростной опрос розетки по локальной сети через TCP-порт 6668.
• 🛡️ 0 запросов в облако (100% экономия): нулевой расход квот Tuya Cloud API, исключение блокировок и вечный лимит.
• 🍏 Вторая жизнь старых iPad (/ipad): сверхлегкий интерфейс на чистом ES5 без внешних библиотек, работающий даже на iPad 2 / iPad 3 Retina (iOS 9.3.6).
• ⏱️ Опрос каждые 3–4 секунды: мгновенная реакция интерфейса на включение и выключение компрессора.

---

🇬🇧 English Description (EN)

100% cloud independence! Direct local socket communication with the smart plug and vintage iPad kiosk UI.

What's New:

• ⚡ Direct Wi-Fi Local Socket: High-speed TCP communication (port 6668) directly with Tuya smart plugs on LAN.
• 🛡️ Zero Cloud Quota Usage: 0 requests/day to Tuya Cloud, freezing developer API quota forever and eliminating latency.
• 🍏 Second Life for Vintage iPads (/ipad): Ultra-lightweight ES5 dashboard crafted specifically for retired iPads (iOS 9.3.6 / iPad 2, 3 Retina, 4).
• ⏱️ Sub-5-Second Polling: Real-time responsiveness with 3–4 second update cadence.

v3.2.0 — Thermal Modeling & Audio Engine

🎵 SmartFridge-Telemetry-Kiosk v3.2.0 — Thermal Modeling & Audio Engine

---

🇷🇺 Описание (RU)

Математическое моделирование температур в камерах холодильника и звуковой синтезатор для звуковых оповещений на планшете.

Что нового:

• 🧊 Теплофизическая модель камер: программная оценка температуры в морозильной (-18°C) и холодильной (+4°C) камерах без сверления корпуса и врезки термопар.
• 🔔 Звуковой синтезатор Web Audio API: мягкий мелодичный сигнал (Chime) при завершении циклов охлаждения с поддержкой фонового воспроизведения на iOS.
• 🔥 Распознавание оттайки No-Frost: раннее разделение работы компрессора (115–140 Вт) и электронагревателя испарителя ТЭН (150–165 Вт).

---

🇬🇧 English Description (EN)

Thermodynamic chamber simulation and a gentle musical cue synthesizer tailored for tablets.

What's New:

• 🧊 Thermodynamic Chamber Simulation: Algorithmic temperature estimation for freezer (-18°C) and fridge (+4°C) compartments without invasive hardware probes.
• 🔔 Web Audio Chime Engine: Gentle synthesized musical cues (Chime) upon cycle completion with iOS background persistence.
• 🔥 Defrost Recognition: Early distinction between active compressor cooling (115–140W) and No-Frost sheath heater cycles (150–165W).

v3.0.0 — Autonomous Edge Host Release (H96 Max 24/7)

🤖 SmartFridge-Telemetry-Kiosk v3.0.0 — Autonomous Edge Host Release (H96 Max 24/7)

---

🇷🇺 Описание (RU)

Полная независимость от домашнего ПК! Вся система перенесена на автономную энергоэффективную ТВ-приставку H96 Max под управлением Termux Linux.

Что нового:

• 🔌 Энергопотребление всего ~3 Вт: круглосуточная работа 24/7/365 на микросервере Rockchip RK3318 Cortex-A53 (Termux).
• 🔄 Супервизор с автоперезапуском: скрипт-сторож start_fridge.sh с автовосстановлением после сбоев и перезагрузок.
• 📌 Фиксированный IP в локальной сети: принудительная привязка Ethernet к 192.168.0.103 для стабильного доступа.
• 🔍 Автопоиск в браузере: поиск сервера в локальной сети без ручного ввода IP-адреса.

---

🇬🇧 English Description (EN)

Liberation from the desktop PC! The entire telemetry stack moves to a dedicated, ultra-low-power Android TV Box running Termux Linux.

What's New:

• 🔌 Ultra-Low Power (~3 Watts): 24/7/365 autonomous operation on an affordable Rockchip RK3318 TV Box.
• 🔄 Supervisor Watchdog: Automated reboot and crash recovery loop (start_fridge.sh) ensuring 99.99% uptime.
• 📌 Static LAN Binding: Ethernet pinned to 192.168.0.103 for rock-solid local access across all home devices.
• 🔍 Zero-Touch Auto-Discovery: Automated network scanner detecting server IP on any browser client.

v2.0.0 — Web Dashboard & SQLite Architecture

📊 SmartFridge-Telemetry-Kiosk v2.0.0 — Web Dashboard & SQLite Architecture

---

🇷🇺 Описание (RU)

Масштабный переход от консольного скрипта к полноценному интерактивному веб-дашборду на базе Flask и базы данных SQLite.

Что нового:

• 🌐 Встроенный веб-сервер Flask: асинхронный HTTP-сервер с REST API (/api/status, /api/history).
• 🗄️ Надежная база SQLite: реляционное хранилище fridge_data.db для сырых измерений и журнала циклов.
• 📈 Интерактивные графики Chart.js: построение кривых мощности, напряжения и тока в реальном времени.
• 🖥️ Режим Kiosk Mode: полноэкранный сенсорный веб-интерфейс для стационарных экранов.

---

🇬🇧 English Description (EN)

Major architectural transition from console scripts to an interactive web dashboard powered by Flask and SQLite.

What's New:

• 🌐 Embedded Flask Web Server: Asynchronous HTTP server with REST endpoints (/api/status, /api/history).
• 🗄️ SQLite Persistence: Relational database (fridge_data.db) storing raw measurements, cooling cycles, and events.
• 📈 Interactive Chart.js Dashboard: Real-time curves for active power (W), grid voltage (V), and current (A).
• 🖥️ Fullscreen Kiosk Mode: Touch-friendly web console suitable for dedicated wall-mounted displays.

v1.0.0 — Genesis Initial Release

🧊 SmartFridge-Telemetry-Kiosk v1.0.0 — Genesis Initial Release

---

🇷🇺 Описание (RU)

Первый официальный публичный релиз на GitHub: настольный инструмент для мониторинга винтажных двухкамерных холодильников Samsung (No-Frost) с умными розетками Tuya.

Ключевые возможности:

• ☁️ Интеграция с Tuya Cloud OpenAPI: сбор активной мощности (Вт), напряжения сети (В) и тока (А).
• 💻 Телеметрия на ПК: непрерывный сбор данных, фиксация нагрузок и диагностика компрессора.
• 📊 Термодинамический КРВ: автоматический расчет коэффициента рабочего времени (Duty Cycle) компрессора.

---

🇬🇧 English Description (EN)

The original open-source foundation for monitoring vintage Samsung No-Frost refrigerators with Tuya smart plugs.

Key Highlights:

• ☁️ Tuya Cloud OpenAPI Integration: Reads active power (W), grid voltage (V), and current (A).
• 💻 Desktop Python Telemetry: Continuous logging of refrigerator duty cycle and power consumption.
• 📊 Thermodynamic Duty Cycle (КРВ): Automatic calculation of compressor run/rest ratios.