Docs: Android + Capacitor 8 + OAuth — полный гайд по проблемам и решениям ...

- Сохранён весь опыт production-дебага: OAuth deep link, статус бар Android 15,
  splash screen API 31, desktop vs native detection, серверный returnTo fix
- Чеклист для будущих проектов по тому же шаблону

Fix: splash screen иконка расплющена на Android 12+ ...

- SplashScreen API (v31) требует иконку 288dp с контент area 192dp
- Старый layer-list 48dp был слишком мал — система растягивала bitmap
- Перегенерированы PNG по density: mdpi 288×288 / hdpi 432×432 / xhdpi 576×576 /
  xxhdpi 864×864 / xxxhdpi 1152×1152, логотип 192dp центрирован
- Удалён неправильный drawable-v31/ic_splash.xml

Fix: Android статус бар overlay + splash screen размытость ...

- Custom layout/capacitor_bridge_layout_main.xml с fitsSystemWindows=true
  (предотвращает контент за статус баром, override Capacitor bridge layout)
- MainActivity.java: сброс OnApplyWindowInsetsListener от SystemBars plugin,
  установка fitsSystemWindows=true на CoordinatorLayout после super.onCreate()
- SplashScreen API 31+: values-v31/styles.xml с windowSplashScreenAnimatedIcon,
  windowSplashScreenBackground, windowSplashScreenIconBackgroundColor
- drawable-v31/ic_splash.xml: layer-list с bitmap gravity=center для чёткой иконки
- styles.xml: windowOptOutEdgeToEdgeEnforcement=true для Android 15

Fix: splash screen иконка размытая на Android ...

- Перегенерированы splash.png из logo-cube-square.svg в нативном разрешении
- portrait: 360x640 / 540x960 / 720x1280 / 1080x1920 / 1440x2560
- landscape: 640x360 / 960x540 / 1280x720 / 1920x1080 / 2560x1440
- Логотип центрирован, фон #0f172a, размер логотипа пропорционален DPI

Fix: Android статус бар больше не перекрывает контент ...

- MainActivity.java: WindowCompat.setDecorFitsSystemWindows(window, true)
  + FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS / clear FLAG_TRANSLUCENT_STATUS
- styles.xml: добавлен android:windowOptOutEdgeToEdgeEnforcement=true
  (opt-out от Android 15 enforced edge-to-edge)
- capacitor.config.json: adjustMarginsForEdgeToEdge: 'force'
  (Capacitor 8 автоматически добавляет margins под system bars)

Fix: isNativeApp() использует Capacitor.isNativePlatform() вместо window.Capacitor ...

- window.Capacitor !== undefined возвращал true в браузере при dev serve / live reload
- Capacitor.isNativePlatform() корректно различает native app (iOS/Android) и web
- Исправлено: десктоп показывал mobile-setup и редиректил на intent:// после OAuth

Fix: OAuth mobile flow + desktop auth + storage abstraction ...

- Desktop: initAccessToken() теперь вызывается всегда, не только в native
  (исправлен бесконечный цикл логина на десктопе)
- Server: returnTo читается из сессии ДО handleCallback(), пока state живой
  (исправлено: OAuth после авторизации не возвращал на mobile-bridge)
- Storage abstraction: единый адаптер storage.js (Preferences / localStorage)
- Navigation abstraction: единый navigation.js (redirectToOAuth, getOAuthReturnTo)
- AuthController::mobileBridge() — bridge page с intent:// deep link
- Android: custom MainActivity с Theme override, статус бар opaque
- Android: AndroidManifest intent-filter для shserv://auth/callback
- .gitignore: добавлен server/.env, удалён из tracking

Feat: мобильная авторизация через OAuth bridge page + CapacitorHttp ...

- Добавлен серверный endpoint /auth/mobile-bridge:
  - После OAuth callback берёт токен из сессии (refreshAccessToken)
  - Рендерит HTML-страницу, которая редиректит WebView обратно в приложение
  - Редирект: https://localhost/#/mobile-auth?token=TOKEN&expires_in=EXPIRES

- Добавлена Vue-страница /mobile-auth:
  - Ловит токен из URL query params
  - Сохраняет в localStorage через setAccessToken()
  - Инициализирует authStore и редиректит на dashboard

- Все auth-редиректы в мобильном приложении исправлены:
  - 401 в API → /#/login (вместо прямого OAuth на сервере)
  - Logout → /#/login
  - LoginPage/AppShell login → /auth/login?return_to=/auth/mobile-bridge

- Включён CapacitorHttp в capacitor.config.json:
  - Нативный HTTP стек обходит CORS, никаких серверных заголовков не нужно

- Обновлён server/dist/ (production bundle)

Feat: Android-приложение на базе Vue SPA (Capacitor) ...

- Установлен Capacitor: core, CLI, Android platform, Preferences plugin
- Добавлена страница первичной настройки сервера (/mobile-setup) только для мобильного приложения
- Реализовано хранение адреса сервера в нативных Preferences (Capacitor)
- Динамический baseUrl для API-клиента через server-config.js
- Исправлены все auth-редиректы: теперь используют абсолютный URL с учётом serverUrl
- Добавлены мобильные meta-теги в index.html (viewport-fit=cover, theme-color, safe-area)
- CSS: запрет pull-to-refresh, поддержка safe-area-inset, tap-highlight
- Android: adaptive icon из логотипа, тёмный splash screen, разрешён cleartext traffic
- Android: название приложения 'Smart Home', package com.gnexus.shserv
- Скрипты: cap:sync и cap:android для удобной сборки

Fix: 50px лого в nav-topbar-brand (global CSS + !important) ...

- Сменил scoped на global стиль с !important для переопределения стилей gnexus-ui-kit

Chore: убрать старые favicon PNG из branding/, добавить logo в public

Fix: 50px лого в nav-topbar-brand через CSS ...

- AppShell.vue: scoped стиль .nav-topbar-brand img { width: 50px; height: 50px; }

Feat: размер лого 50px в хедере, большое лого 120px на логине ...

- AppShell.vue: logo-size='50' для навигации
- LoginPage.vue: <img> с логотипом 120×120px вместо иконки

Feat: применить логотип в веб-клиенте ...

- AppShell.vue: brand='SHSERV', logo-src='/logo-cube-square.svg'
- server/dist/: добавлены favicon и logo-cube-square.svg

Логотип отображается в хедере навигации через GnNavigationShell.

Feat: обновить логотип и favicon — изометрический куб ...

- logo-cube-square.svg — куб в скруглённом квадрате (тёмно-синий фон)
- favicon.svg — компактная версия для favicon
- logo-32/64/128/256/512.png — PNG версии логотипа
- favicon-16/32/48/64px.png, apple-touch-icon.png — иконки для веб
- branding/README.md — обновлённая документация

Концепция:
- Куб — центральный хаб/контроллер умного дома
- Орбитальные точки — подключённые устройства (оранжевый/бирюзовый)
- Орбита — сеть, связь между устройствами
- Палитра: фиолетовый (#6366f1, #8b5cf6), оранжевый (#f97316),
  бирюзовый (#14b8a6), тёмно-синий фон (#1e1b4b)

Feat: добавить логотип и favicon для системы ...

- logo-primary.svg — основная версия с градиентом и WiFi/хабом
- logo-simple.svg — упрощённая версия для UI
- logo-monochrome.svg — монохромная версия для тёмных фонов
- favicon.svg, favicon-*.png — иконки для браузеров (16, 32, 48, 64px)
- apple-touch-icon.png — иконка для iOS (180×180)
- index.html — добавлены ссылки на favicon
- branding/README.md — документация и инструкции

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

Feat: форматирование дат устройств (relative time + tooltip) ...

- Добавлена утилита webclient/src/utils/date.js:
  - formatRelative() — относительный формат ("5 min ago", "1 hour ago")
  - formatDateTime() — точная дата для tooltip ("Jun 8, 2026 14:30")
  - formatDate() — короткая дата ("Jun 8, 2026")
- DeviceTable.vue: колонка Last Contact с относительным форматом + tooltip
- DeviceDetailPage.vue: last_contact → relative, create_at → полный формат
- AreaDetailPage.vue: исправлен watch на route.params.id для обновления при навигации
- Добавлены тесты date.spec.js (17 тестов)

Даты теперь читаются как "1 hour ago", при наведении — точное время.

Docs: актуализация Control Scripts и документирование событий от устройств ...

- docs/events-from-devices.md (новый): полное описание системы событий
  • Формат POST /events/new от устройства
  • 5 паттернов имён событий (global, type, alias, channel, alias+channel)
  • Жизненный цикл на сервере (EventsController → EventsModel)
  • Как подписываться в Control Scripts
  • Известные event_name от устройств (button, relay, hatch, sensor)
  • Асинхронность через fastcgi_finish_request
  • Sync map и DeviceScriptsHelper

- docs/control-scripts-guide.md: полная переработка
  • Указан базовый класс (server/SHServ/Middleware/ControlScripts.php)
  • 4 регистрационных метода с примерами
  • Таблица паттернов событий
  • DeviceScriptsHelper методы
  • API endpoints для управления Scope

- docs/architecture.md: актуализация
  • Control Scripts раздел переписан с таблицей методов
  • Система событий расширена (жизненный цикл, EventsModel)
  • Веб-клиент: Vue Client (основной) + Legacy Client (архив)

- docs/server-api.md: дополнено POST /events/new
  • Требования к авторизации
  • 5 паттернов событий
  • Жизненный цикл обработки

Translate all error messages to English, add missing aliases

Refactor: extract shared logger utils, fix edge cases in Pinia/HTTP logging

P2: Vue Client — console logging (HTTP, router, Pinia actions, error handler)

P1: Add structured business-logic logging across PHP server (auth, devices, scripts, areas, events)

Fix P0 review issues: dedup exception logs, SqlQueryLogger stack, chmod once, json_encode guard, RequestLogger guard

P0: super-verbose server logging — JSONL, levels, request/SQL/error/device HTTP logs

Fix PermissionResolver: fallback for missing/empty tables; add seed migration for roles and permissions

Fix production auth: disable IP/UA binding (breaks reverse-proxy), add /api/v1/auth/* aliases, prepare PHP-FPM reload

Phase 4 cleanup & polish: param migration seeds, gnexus-ui-kit LoginPage styles, single .env ...

- Replace raw string interpolation in migration with $tb->prepare() + execute()

- Remove all var(--color-*) from LoginPage.vue in favor of gnexus-ui-kit utility classes

- Unify .env: single server/.env, remove server/SHServ/.env override, update config.php

- Update auth-fix-plan.md: mark Phase 4 tasks complete

Phase 3 infrastructure hardening: IP/UA binding, nginx getallheaders fallback, auth rate limiting, permission cache

Phase 2 session stability: refresh queue, Bearer fallback, proactive refresh

Update auth-fix-plan: mark Phase 1 tasks completed