manure-removal-owen/CHANGELOG.md

CHANGELOG — ACS Monitoring (СКУД + Датчики воды)

---

[Unreleased] — 2026 Q2

• ⏳ Прошивка door-controller v2.0 ожидает первого деплоя на железо
• ⏳ Датчик воды v3.5.8 ожидает USB flash деплой

---

[2026-02-10] — Прошивка СКУД v2.0 написана

Добавлено

• firmware/door-controller-v2.0/door_controller_v2.ino — главный файл state machine
• firmware/door-controller-v2.0/config.h — GPIO пины, константы, структуры DeviceConfig
• firmware/door-controller-v2.0/mqtt_handler.h — MQTT клиент: provision, heartbeat, команды, batch sync
• firmware/door-controller-v2.0/web_config.h — AP Mode captive portal с тёмной темой (192.168.4.1)
• firmware/door-controller-v2.0/wiegand_reader.h — Wiegand 26/34 bit с проверкой чётности
• firmware/door-controller-v2.0/card_cache.h — NVS кеш до 10,000 карт
• firmware/door-controller-v2.0/event_queue.h — Offline очередь до 500 событий
• firmware/door-controller-v2.0/README.md — полная документация

Возможности v2.0

• WiFi + MQTT связь с сервером
• Авторизация карт по локальному кешу (до 10,000)
• Offline режим: карты работают без WiFi, события копятся и синхронизируются
• AP Mode при первом запуске: ACS-DOOR-XXXX, 192.168.4.1
• OTA обновления
• Команды от сервера: open_door, close_door, reboot, factory_reset, sync_cards, set_door_duration
• Heartbeat каждые 30 сек (uptime, RSSI, free_heap, card_cache_count)

---

[2026-02-09] — Завершение страниц СКУД

Обновлено

• AccessLogPage.tsx — полная переработка:

  • Группировка событий по дате (Сегодня / Вчера / дата)
  • Сворачиваемые группы со счётчиком разрешённых/запрещённых
  • Calendar picker с пресетами (Сегодня / Неделя / Месяц)
  • Пагинация (load more, по 50 записей)
  • Экспорт CSV с BOM для Excel
  • Фильтр по устройству
  • Сортировка новые/старые
  • Цветовые бейджи по типу события
  • Подсветка запрещённых проходов красным фоном

• FirmwarePage.tsx — добавлено:

  • Удаление прошивки
  • Модалка "Подробнее" (changelog, размер, дата)
  • Переключение стабильная/бета (toggleFirmwareStable)
  • Кнопка "Push OTA" на устройства (pushFirmwareOTA)

• DevicesPage.tsx — добавлено:

  • Кнопка "Открыть дверь" прямо из карточки
  • Настройка сети устройства (static IP / DHCP, gateway, DNS)
  • Команды: перезагрузка, синхронизация карт, blink LED
  • Dropdown обновления прошивки

• AccessKeysPage.tsx — добавлено:

  • Интеграция со станцией регистрации (кнопка "Считать карту")
  • Пагинация
  • Фильтр по типу карты (RFID / RF)

• EmployeesPage.tsx — добавлено:

  • Фильтр по отделу/должности
  • Пагинация

Деплой

cd /var/www/acs-monitoring/frontend && npm run build
# Сборка: 2708 модулей, 10.28с, 843 kB JS, 42 kB CSS

---

[2026-02-09] — Backend API прошивок завершён

Добавлено/завершено в backend/src/api/firmware.ts

• GET /api/firmware — список прошивок
• POST /api/firmware — добавить прошивку
• DELETE /api/firmware/:id — удалить
• PUT /api/firmware/:id/toggle-stable — стабильная/бета
• POST /api/firmware/:id/push-ota — OTA push на устройства

---

[2026-02-09] — СКУД backend MQTT завершён

Добавлено в backend/src/mqtt/skud-handlers.ts

• Обработчик devices/provision — активация нового устройства, запись в devices, отправка списка карт
• Обработчик skud/{id}/status — обновление is_online, last_seen, firmware_version
• Обработчик skud/{id}/access — запись в access_events, проверка прав
• Обработчик skud/{id}/sync — batch синхронизация offline событий
• Отправка команд через skud/{id}/command
• Топик skud/{id}/provision/ack с ответом + списком карт

---

[2026-02-09] — Первые 5 страниц СКУД (базовая версия)

Создано (первая версия)

• AccessLogPage.tsx — журнал с базовой таблицей
• FirmwarePage.tsx — список прошивок, загрузка
• DevicesPage.tsx — список дверей, статус online/offline
• AccessKeysPage.tsx — CRUD карт, привязка к сотруднику
• EmployeesPage.tsx — CRUD сотрудников, RF регистрация
• DiscoveryPage.tsx — поиск новых устройств

---

[2026-02-09] — Сборка первого физического устройства

Выполнено

• Получены все компоненты
• ESP32 DevKit 30-pin прошит прошивкой v1.0
• Mini560 настроен на 5.0V
• Wiegand считыватель подключён (GPIO 26/27)
• Реле подключено (GPIO 25)
• Кнопка выхода (GPIO 33)
• Тест: считыватель читает карты (любая карта открывает — тестовый режим v1.0)

---

[2026-01-30] — Прошивка СКУД v1.0 (тестовая)

Добавлено

• firmware/door-controller-v1.0/ — тестовая прошивка
• Wiegand RFID 26/34 bit
• Управление реле (замок)
• Кнопка выхода (GPIO прерывание)
• Serial Monitor логи
• Автотесты компонентов при старте
• ⚠️ Открывает дверь для ЛЮБОЙ карты — только для тестирования

---

[2026-01-30] — Схема подключения и документация

Добавлено

• Схема подключения ESP32 ↔ Wiegand ↔ Реле ↔ Замок ↔ БП ↔ АКБ
• Распиновка ESP32 DevKit 30-pin
• Чеклист сборки
• Инструкция по прошивке
• TROUBLESHOOTING.md

---

[2026-01-28] — Проектирование БД и веб-панели

Добавлено

• SQL схема 6 таблиц: employees, access_keys, devices, access_log, firmware, remote_controls
• Структура веб-панели: раздел СКУД в боковом меню
• Обсуждение шлагбаумов, RF брелоков, станции регистрации
• MQTT топики и протокол взаимодействия

---

[2026-01-14] — Начало проекта СКУД

Добавлено

• Архитектурное решение: ESP32 на каждую дверь + Wiegand RFID
• Список компонентов для 1 двери (~4 750 ₽)
• Заказ компонентов (15 дверей)
• Интеграция с существующей системой ACS Monitoring

---

История (датчики воды)

[2026-01-20] — Прошивка датчика воды v3.5.8

• journal-first архитектура: запись в SPIFFS перед MQTT
• Монотонные счётчики для дедупликации
• FIFO очередь неотправленных показаний
• isFresh логика на backend (заменила isJournal)
• Исправлен timezone bug (3-часовой offset → pure UTC NTP)
• Устранены аномальные показания > 900 л/мин

[2026-01-18] — Прошивка датчика воды v3.5.x

• Non-blocking file scanning (исправлены lockups MQTT keepalive)
• Batch processing файлов журнала
• Оптимизация OTA — исправлено зависание при обновлении

[2026-01-01] — Датчики воды v3.3.2 (стабильная)

• Базовая версия с MQTT reporting
• firmware/water-sensor-v3.3.2/acs_sensor_v3.3.2.ino

---

Обновлено: май 2026