chore(home): mirror from kalinamall (6398d48) with papatramp URLs

2026-07-14 20:43:58 +10:00
commit 9116e0472d
59 changed files with 5335 additions and 0 deletions
@@ -0,0 +1,68 @@
+## Стек
+
+| Слой | Технология |
+|------|------------|
+| UI | Kotlin, Jetpack Compose, Material 3 |
+| Сеть | Retrofit / OkHttp, Kotlin Serialization |
+| Хранение | DataStore + Android Keystore (токены, URL сервера) |
+| Push | **Firebase Cloud Messaging (FCM)** |
+| Минимум SDK | Android 8.0 (API 26) |
+
+## Что есть в приложении
+
+- Обзор, события, отчёты, проблемы, хосты (списки и карточки с читаемыми полями)
+- Pull-to-refresh на обзоре и в списках
+- Фильтры событий и проблем (severity, status)
+- Формат даты/времени на выбор (слэш, дефис, точка или системный локаль)
+- Ack / Resolve для роли `operator` и выше
+- Push с переходом в карточку события или problem; режимы: со звуком, без звука, выключено
+- Выбор звука уведомления: системный или свой (ringtone picker)
+- Биометрическая блокировка при **запуске** и при возврате в приложение
+- Экран «Моё устройство»: сервер, пользователь, роль, версия, настройки push, выход
+- Первичная привязка к серверу по **коду регистрации**, который выдаёт администратор в веб-SAC
+
+## Чего нет в приложении (только веб)
+
+- Управление пользователями SAC
+- Настройки каналов (Telegram, SMTP, webhook), severity, policy
+- Выдача и отзыв кодов регистрации, список устройств, способ входа на устройство — всё это в **Настройки → Мобильные устройства** на сервере
+
+## Привязка телефона к серверу
+
+1. Администратор в веб-SAC включает «Разрешать подключение мобильных устройств».
+2. Создаёт **код регистрации** для пользователя (срок действия, одноразовый или с лимитом использований).
+3. Оператор в Seaca: URL API SAC (выдаёт администратор) + код + логин/пароль (если код не привязан к предварительной сессии).
+4. Приложение регистрирует FCM-токен; устройство появляется в списке на сервере.
+5. Администратор может отключить устройство, сменить разрешённый способ входа, переименовать.
+
+Подробный план — [docs/ROADMAP.md](docs/ROADMAP.md).
+
+## Статус
+
+**Версия:** `0.5.7` (Android: Kotlin, Compose; enroll, UI, ack/resolve, FCM, биометрия, звук push, форматы даты)
+
+## Документация
+
+| Документ | Назначение |
+|----------|------------|
+| [docs/operator-guide.md](docs/operator-guide.md) | Инструкция для оператора |
+| [docs/ROADMAP.md](docs/ROADMAP.md) | План разработки |
+
+## Сборка
+
+Требуется **JDK 17+** (Android Studio JBR или отдельная установка) и Android SDK (`local.properties` с `sdk.dir=…`).
+
+```bash
+# Опционально: конфиг Firebase в app/ (шаблон *.example, рабочий файл не в git) — для FCM
+./gradlew assembleDebug
+# Windows:
+gradlew.bat assembleDebug
+```
+
+APK: `app/build/outputs/apk/debug/app-debug.apk`
+
+Без конфига Firebase приложение собирается, но FCM не инициализируется (просмотр данных работает).
+
+## Лицензия
+
+Как у остальных репозиториев семейства SAC (уточняется владельцем проекта).
@@ -0,0 +1,46 @@
+# Seaca
+
+Android-клиент [Security Alert Center (SAC)](https://git.papatramp.ru/PapaTramp/security-alert-center).
+
+**Версия:** `0.5.15` (versionCode 29)
+
+## Возможности
+
+- Обзор, события, проблемы, хосты, отчёты (API веб-SAC)
+- Push (FCM), режимы звука, выбор ringtone; уведомления снимаются при открытии приложения
+- Ack / Resolve проблем (monitor+)
+- **RDG** — метка flap, путь RDS; **«Оборвать сессию»** → SAC API → WinRM на клиентский ПК
+- Завершение сессий SSH/RDP с карточки события и списка активных сессий на хосте
+- Биометрия при запуске и возврате в приложение
+- Формат даты, экран «Моё устройство»
+
+## Нет в приложении (только веб-SAC)
+
+Пользователи, каналы оповещений, WinRM domain admin, коды регистрации.
+
+## Привязка
+
+1. Админ: мобильные устройства + код `sacmob_…`
+2. URL API SAC + код + логин/пароль в Seaca
+3. FCM-токен регистрируется автоматически
+
+[docs/operator-guide.md](docs/operator-guide.md)
+
+## Сборка
+
+JDK 17+, `local.properties`. Опционально `app/google-services.json` for FCM.
+
+```bash
+./gradlew assembleDebug
+```
+
+APK: `app/build/outputs/apk/debug/app-debug.apk`
+
+## Related repositories
+
+| Repository | URL |
+|------------|-----|
+| seaca | https://git.papatramp.ru/PapaTramp/seaca |
+| security-alert-center | https://git.papatramp.ru/PapaTramp/security-alert-center |
+| ssh-monitor | https://git.papatramp.ru/PapaTramp/ssh-monitor |
+| RDP-login-monitor | https://git.papatramp.ru/PapaTramp/RDP-login-monitor |
@@ -0,0 +1,46 @@
+# Seaca
+
+Android-клиент [Security Alert Center (SAC)](https://git.papatramp.ru/PapaTramp/security-alert-center).
+
+**Версия:** `0.5.15` (versionCode 29)
+
+## Возможности
+
+- Обзор, события, проблемы, хосты, отчёты (API веб-SAC)
+- Push (FCM), режимы звука, выбор ringtone; уведомления снимаются при открытии приложения
+- Ack / Resolve проблем (monitor+)
+- **RDG** — метка flap, путь RDS; **«Оборвать сессию»** → SAC API → WinRM на клиентский ПК
+- Завершение сессий SSH/RDP с карточки события и списка активных сессий на хосте
+- Биометрия при запуске и возврате в приложение
+- Формат даты, экран «Моё устройство»
+
+## Нет в приложении (только веб-SAC)
+
+Пользователи, каналы оповещений, WinRM domain admin, коды регистрации.
+
+## Привязка
+
+1. Админ: мобильные устройства + код `sacmob_…`
+2. URL API SAC + код + логин/пароль в Seaca
+3. FCM-токен регистрируется автоматически
+
+[docs/operator-guide.md](docs/operator-guide.md)
+
+## Сборка
+
+JDK 17+, `local.properties`. Опционально `app/google-services.json` for FCM.
+
+```bash
+./gradlew assembleDebug
+```
+
+APK: `app/build/outputs/apk/debug/app-debug.apk`
+
+## Репозитории
+
+| Репозиторий | URL |
+|-------------|-----|
+| seaca | https://git.papatramp.ru/PapaTramp/seaca |
+| security-alert-center | https://git.papatramp.ru/PapaTramp/security-alert-center |
+| ssh-monitor | https://git.papatramp.ru/PapaTramp/ssh-monitor |
+| RDP-login-monitor | https://git.papatramp.ru/PapaTramp/rdp-login-monitor |
@@ -0,0 +1,46 @@
+# Seaca
+
+Android-клиент [Security Alert Center (SAC)](https://git.papatramp.ru/PapaTramp/security-alert-center).
+
+**Версия:** `0.5.15` (versionCode 29)
+
+## Возможности
+
+- Обзор, события, проблемы, хосты, отчёты (API веб-SAC)
+- Push (FCM), режимы звука, выбор ringtone; уведомления снимаются при открытии приложения
+- Ack / Resolve проблем (monitor+)
+- **RDG** — метка flap, путь RDS; **«Оборвать сессию»** → SAC API → WinRM на клиентский ПК
+- Завершение сессий SSH/RDP с карточки события и списка активных сессий на хосте
+- Биометрия при запуске и возврате в приложение
+- Формат даты, экран «Моё устройство»
+
+## Нет в приложении (только веб-SAC)
+
+Пользователи, каналы оповещений, WinRM domain admin, коды регистрации.
+
+## Привязка
+
+1. Админ: мобильные устройства + код `sacmob_…`
+2. URL API SAC + код + логин/пароль в Seaca
+3. FCM-токен регистрируется автоматически
+
+[docs/operator-guide.md](docs/operator-guide.md)
+
+## Сборка
+
+JDK 17+, `local.properties`. Опционально `app/google-services.json` for FCM.
+
+```bash
+./gradlew assembleDebug
+```
+
+APK: `app/build/outputs/apk/debug/app-debug.apk`
+
+## Репозитории
+
+| Репозиторий | URL |
+|-------------|-----|
+| seaca | https://git.papatramp.ru/PapaTramp/seaca |
+| security-alert-center | https://git.papatramp.ru/PapaTramp/security-alert-center |
+| ssh-monitor | https://git.papatramp.ru/PapaTramp/ssh-monitor |
+| RDP-login-monitor | https://git.papatramp.ru/PapaTramp/rdp-login-monitor |