From 702b61726e38bc03894b522878fa5795c737883d Mon Sep 17 00:00:00 2001 From: PTah Date: Sun, 21 Jun 2026 20:13:40 +1000 Subject: [PATCH] fix: restore mirror README templates for home and github MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Обновлён kalinamall.md; восстановлены github.md и home.md для push-remotes.sh. --- scripts/readme/github.md | 45 ++++++++++++++++++ scripts/readme/home.md | 45 ++++++++++++++++++ scripts/readme/kalinamall.md | 90 ++++++++++-------------------------- 3 files changed, 114 insertions(+), 66 deletions(-) create mode 100644 scripts/readme/github.md create mode 100644 scripts/readme/home.md diff --git a/scripts/readme/github.md b/scripts/readme/github.md new file mode 100644 index 0000000..5872eaf --- /dev/null +++ b/scripts/readme/github.md @@ -0,0 +1,45 @@ +# Seaca + +Android-клиент [Security Alert Center (SAC)](https://github.com/PTah/security-alert-center). + +**Версия:** `0.5.11` (versionCode 25) + +## Возможности + +- Обзор, события, проблемы, хосты, отчёты (API веб-SAC) +- Push (FCM), режимы звука, выбор ringtone +- Ack / Resolve проблем (monitor+) +- **RDG flap** — метка в списке; **qwinsta / logoff** → SAC API → WinRM на клиентский ПК +- Биометрия при запуске и возврате в приложение +- Формат даты, экран «Моё устройство» + +## Нет в приложении (только веб-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://github.com/PTah/seaca | +| security-alert-center | https://github.com/PTah/security-alert-center | +| ssh-monitor | https://github.com/PTah/ssh-monitor | +| RDP-login-monitor | https://github.com/PTah/RDP-login-monitor | diff --git a/scripts/readme/home.md b/scripts/readme/home.md new file mode 100644 index 0000000..17650ea --- /dev/null +++ b/scripts/readme/home.md @@ -0,0 +1,45 @@ +# Seaca + +Android-клиент [Security Alert Center (SAC)](https://git.papatramp.ru/PapaTramp/security-alert-center). + +**Версия:** `0.5.11` (versionCode 25) + +## Возможности + +- Обзор, события, проблемы, хосты, отчёты (API веб-SAC) +- Push (FCM), режимы звука, выбор ringtone +- Ack / Resolve проблем (monitor+) +- **RDG flap** — метка в списке; **qwinsta / logoff** → SAC API → WinRM на клиентский ПК +- Биометрия при запуске и возврате в приложение +- Формат даты, экран «Моё устройство» + +## Нет в приложении (только веб-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` для 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 | diff --git a/scripts/readme/kalinamall.md b/scripts/readme/kalinamall.md index 001c3e6..b911ca7 100644 --- a/scripts/readme/kalinamall.md +++ b/scripts/readme/kalinamall.md @@ -1,87 +1,45 @@ # Seaca -**Seaca** (Security Event Alert Center App) — нативный мобильный клиент **Security Alert Center (SAC)** для Android. +Android-клиент [Security Alert Center (SAC)](https://git.kalinamall.ru/PapaTramp/security-alert-center). -Оператор видит те же данные, что и в веб-интерфейсе SAC: обзор, события, отчёты, проблемы и хосты. Push-уведомления приходят по тем же правилам severity и cooldown, что Telegram/email/webhook на сервере. Управление пользователями, каналами оповещений и привязкой устройств — **только в веб-SAC** (раздел «Настройки»). +**Версия:** `0.5.11` (versionCode 25) -## Связанные репозитории +## Возможности -| Репозиторий | Роль | -|-------------|------| -| security-alert-center | Сервер SAC: API, UI, оповещения, управление мобильными устройствами | -| ssh-monitor | Агент Linux | -| RDP-login-monitor | Агент Windows | +- Обзор, события, проблемы, хосты, отчёты (API веб-SAC) +- Push (FCM), режимы звука, выбор ringtone +- Ack / Resolve проблем (monitor+) +- **RDG flap** — метка в списке; **qwinsta / logoff** → SAC API → WinRM на клиентский ПК +- Биометрия при запуске и возврате в приложение +- Формат даты, экран «Моё устройство» -| Репозиторий | URL | -|-------------|-----| -| security-alert-center | https://git.kalinamall.ru/PapaTramp/security-alert-center | -| ssh-monitor | https://git.kalinamall.ru/PapaTramp/ssh-monitor | -| RDP-login-monitor | https://git.kalinamall.ru/PapaTramp/RDP-login-monitor | -## Стек +## Нет в приложении (только веб-SAC) -| Слой | Технология | -|------|------------| -| 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) | +Пользователи, каналы оповещений, WinRM domain admin, коды регистрации. -## Что есть в приложении +## Привязка -- Обзор, события, отчёты, проблемы, хосты (списки и карточки с читаемыми полями) -- Pull-to-refresh на обзоре и в списках -- Фильтры событий и проблем (severity, status) -- Формат даты/времени на выбор (слэш, дефис, точка или системный локаль) -- Ack / Resolve для роли `operator` и выше -- Push с переходом в карточку события или problem; режимы: со звуком, без звука, выключено -- Выбор звука уведомления: системный или свой (ringtone picker) -- Биометрическая блокировка при **запуске** и при возврате в приложение -- Экран «Моё устройство»: сервер, пользователь, роль, версия, настройки push, выход -- Первичная привязка к серверу по **коду регистрации**, который выдаёт администратор в веб-SAC +1. Админ: мобильные устройства + код `sacmob_…` +2. URL API SAC + код + логин/пароль в Seaca +3. FCM-токен регистрируется автоматически -## Чего нет в приложении (только веб) - -- Управление пользователями 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) | План разработки | +[docs/operator-guide.md](docs/operator-guide.md) · SAC [docs/seaca-mobile.md](https://git.kalinamall.ru/PapaTramp/security-alert-center/src/branch/main/docs/seaca-mobile.md) ## Сборка -Требуется **JDK 17+** (Android Studio JBR или отдельная установка) и Android SDK (`local.properties` с `sdk.dir=…`). +JDK 17+, `local.properties`. Опционально `app/google-services.json` для FCM. ```bash -# Опционально: конфиг Firebase в app/ (шаблон *.example, рабочий файл не в git) — для FCM ./gradlew assembleDebug -# Windows: -gradlew.bat assembleDebug ``` APK: `app/build/outputs/apk/debug/app-debug.apk` -Без конфига Firebase приложение собирается, но FCM не инициализируется (просмотр данных работает). +## Репозитории -## Лицензия - -Как у остальных репозиториев семейства SAC (уточняется владельцем проекта). +| Репозиторий | URL | +|-------------|-----| +| seaca | https://git.kalinamall.ru/PapaTramp/seaca | +| security-alert-center | https://git.kalinamall.ru/PapaTramp/security-alert-center | +| ssh-monitor | https://git.kalinamall.ru/PapaTramp/ssh-monitor | +| RDP-login-monitor | https://git.kalinamall.ru/PapaTramp/rdp-login-monitor |