PapaTramp/security-alert-center
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(docs): GitHub URLs in README/docs, remove .cursor from repo

Browse Source 
Replace git.kalinamall.ru links with github.com/PTah in public docs.
Add Rewrite-GitHostUrls.ps1 and Push-Mirror.ps1 for kalinamall mirror pushes.
Add .cursor/ to .gitignore.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
PTah
2026-06-16 11:36:41 +10:00
parent 5b2aeb0183
commit 36ccfc9471
27 changed files with 260 additions and 259 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/agent-integration.md
+1 -1
View File
@@ -74,7 +74,7 @@ UI **Настройки** (`/settings`) — правило + параметры
### 1.4. Версии и доставка обновлений
При **любом** изменении агента, влияющем на SAC или поведение на хосте, поднимайте версию и пушьте в **git.kalinamall.ru**:
При **любом** изменении агента, влияющем на SAC или поведение на хосте, поднимайте версию и пушьте в **GitHub** (`github.com/PTah`); для зеркала kalinamall — `.\scripts\Push-Mirror.ps1 kalinamall`:
| Агент | Маркер версии | Как хост узнаёт о новой версии |
|-------|---------------|--------------------------------|
docs/deployment.md
+1 -1
View File
@@ -115,7 +115,7 @@ sudo /opt/sac-deploy.sh
Установка скрипта (один раз): `sudo cp /opt/security-alert-center/deploy/sac-deploy.sh /opt/sac-deploy.sh && sudo chmod 755 /opt/sac-deploy.sh`
После **force-push** на git.kalinamall.ru обычный `git pull` на сервере падает с «diverging branches». Скрипт `sac-deploy.sh` (актуальная версия) делает `fetch` и при необходимости `reset --hard` к upstream. **Один раз вручную**, если на сервере ещё старый скрипт:
После **force-push** на upstream remote обычный `git pull` на сервере падает с «diverging branches». Скрипт `sac-deploy.sh` (актуальная версия) делает `fetch` и при необходимости `reset --hard` к upstream. **Один раз вручную**, если на сервере ещё старый скрипт:
```bash
sudo -u sac git -C /opt/security-alert-center fetch --prune
docs/event-schema-v1.json
+1 -1
View File
@@ -1,6 +1,6 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://git.kalinamall.ru/PapaTramp/security-alert-center/schemas/event-v1.json",
"$id": "https://github.com/PTah/security-alert-center/schemas/event-v1.json",
"title": "Security Alert Center Event v1",
"description": "Каноническое событие от ssh-monitor или RDP-login-monitor",
"type": "object",
docs/install-ubuntu-24.04-docker.md
+1 -1
View File
@@ -24,7 +24,7 @@ Docker удобен для локальной отладки или изолир
```bash
sudo apt install -y git
sudo git clone https://git.kalinamall.ru/PapaTramp/security-alert-center.git /opt/security-alert-center
sudo git clone https://github.com/PTah/security-alert-center.git /opt/security-alert-center
sudo chown -R "$USER:$USER" /opt/security-alert-center
```
docs/install-ubuntu-24.04-native.md
+1 -1
View File
@@ -71,7 +71,7 @@ nginx -v
```bash
sudo mkdir -p /opt
sudo git clone https://git.kalinamall.ru/PapaTramp/security-alert-center.git /opt/security-alert-center
sudo git clone https://github.com/PTah/security-alert-center.git /opt/security-alert-center
```
---
docs/install-ubuntu-24.04.md
+1 -1
View File
@@ -14,7 +14,7 @@
```bash
# см. полный чеклист в native-руководстве
sudo apt update && sudo apt install -y git postgresql nginx python3.12 python3.12-venv
sudo git clone https://git.kalinamall.ru/PapaTramp/security-alert-center.git /opt/security-alert-center
sudo git clone https://github.com/PTah/security-alert-center.git /opt/security-alert-center
# … PostgreSQL, venv, config/sac-api.env, systemd, nginx
```
docs/operations-prod-status.md
+1 -1
View File
@@ -39,7 +39,7 @@ sudo /opt/sac-deploy.sh
| Параметр | Значение |
|----------|----------|
| Хост | `ubabuba` / `10.10.36.9` |
| Репозиторий | `git.kalinamall.ru/PapaTramp/ssh-monitor` (`main`, есть `sac-client.sh`) |
| Репозиторий | `github.com/PTah/ssh-monitor` (`main`, есть `sac-client.sh`) |
| `UseSAC` | пилот **exclusive** — см. [pilot-2.1-exclusive.md](pilot-2.1-exclusive.md) |
| Сервис | `ssh-monitor.service` — **active** |
| `--check-sac` | OK (health + ingest `agent.test` 202) |
docs/roadmap.md
+3 -3
View File
@@ -66,7 +66,7 @@
**Цель:** нативный Android-клиент и push по тем же правилам оповещений, что Telegram/email/webhook.
Репозиторий клиента: [seaca](https://git.kalinamall.ru/PapaTramp/seaca) (Kotlin, Jetpack Compose, FCM).
Репозиторий клиента: [seaca](https://github.com/PTah/seaca) (Kotlin, Jetpack Compose, FCM).
**Сервер SAC:**
@@ -77,7 +77,7 @@
**Не в мобильном клиенте:** пользователи SAC, каналы Telegram/SMTP/webhook, админ-настройки.
Подробный план клиента — [seaca/docs/ROADMAP.md](https://git.kalinamall.ru/PapaTramp/seaca/src/branch/main/docs/ROADMAP.md).
Подробный план клиента — [seaca/docs/ROADMAP.md](https://github.com/PTah/seaca/blob/main/docs/ROADMAP.md).
---
@@ -95,7 +95,7 @@
| v0.1 | — (не требуется) | — |
| v0.2 | TBD (тег с UseSAC) | TBD |
| v0.3+ | совместимость schema 1.0 | совместимость schema 1.0 |
| v0.6 | — | — (мобильный клиент [seaca](https://git.kalinamall.ru/PapaTramp/seaca), не агент) |
| v0.6 | — | — (мобильный клиент [seaca](https://github.com/PTah/seaca), не агент) |
При breaking change схемы — `schema_version: 1.1` с поддержкой 1.0 на ingest.
docs/seaca-mobile.md
+2 -2
View File
@@ -1,6 +1,6 @@
# Seaca — мобильный клиент SAC
Репозиторий приложения: [seaca](https://git.kalinamall.ru/PapaTramp/seaca).
Репозиторий приложения: [seaca](https://github.com/PTah/seaca).
Требуется SAC **≥ 0.9.0** с применённой миграцией `014`.
---
@@ -84,7 +84,7 @@ SAC_FCM_SERVICE_ACCOUNT_JSON=/etc/security-alert-center/fcm-service-account.json
| `sac.kalinamall.ru` | Web UI | yes (`git-sac-allowed`) |
| `sac-api.kalinamall.ru` | Seaca, `/api/v1/mobile/*` | no (enroll + JWT) |
Both resolve to the same SAC server (**192.168.160.145**). nginx must accept both names in `server_name`. See [reverse-proxy/docs/sac-access.md](https://git.kalinamall.ru/PapaTramp/reverse-proxy/src/branch/main/docs/sac-access.md).
Both resolve to the same SAC server (**192.168.160.145**). nginx must accept both names in `server_name`. See [reverse-proxy/docs/sac-access.md](https://github.com/PTah/reverse-proxy/blob/main/docs/sac-access.md).
---
docs/work-plan.md
+1 -1
View File
@@ -9,7 +9,7 @@
| # | Задача | Статус |
|---|--------|--------|
| 0.1–0.3 | ТЗ, архитектура, схема, deployment | ✅ |
| 0.5 | Репозиторий git.kalinamall.ru | ✅ |
| 0.5 | Репозиторий GitHub + зеркало kalinamall | ✅ |
| 0.6 | Multi-root workspace | ✅ |
---
docs/workspace-three-repos.md
+29 -46
View File
@@ -6,13 +6,13 @@
## 1. Расположение репозиториев (пример)
| Имя в workspace | Путь (пример Windows) | Remote |
|-----------------|----------------------|--------|
| `ssh-monitor` | `D:\Soft\Git\ssh-monitor` | git.kalinamall.ru |
| `rdp-monitor` | `D:\Soft\Git\RDP-login-monitor` | git.kalinamall.ru |
| `security-alert-center` | `D:\Soft\Git\security-alert-center` | git.kalinamall.ru |
| Имя в workspace | Путь (пример Windows) | Публичный remote |
|-----------------|----------------------|------------------|
| `ssh-monitor` | `D:\Soft\Git\ssh-monitor` | github.com/PTah/ssh-monitor |
| `rdp-monitor` | `D:\Soft\Git\RDP-login-monitor` | github.com/PTah/RDP-login-monitor |
| `security-alert-center` | `D:\Soft\Git\security-alert-center` | github.com/PTah/security-alert-center |
Пути подставьте свои.
Пути подставьте свои. Закрытый инстанс **git.kalinamall.ru** — зеркало с теми же репозиториями; ссылки в документации на каждом хосте должны вести **на этот же хост** (см. ниже).
---
@@ -23,18 +23,9 @@
```json
{
"folders": [
{
"path": "D:/Soft/Git/ssh-monitor",
"name": "ssh-monitor"
},
{
"path": "D:/Soft/Git/RDP-login-monitor",
"name": "rdp-monitor"
},
{
"path": "D:/Soft/Git/security-alert-center",
"name": "security-alert-center"
}
{ "path": "D:/Soft/Git/ssh-monitor", "name": "ssh-monitor" },
{ "path": "D:/Soft/Git/RDP-login-monitor", "name": "rdp-monitor" },
{ "path": "D:/Soft/Git/security-alert-center", "name": "security-alert-center" }
],
"settings": {
"files.eol": "\n"
@@ -58,50 +49,42 @@
## 4. Соглашения
- Контракт событий: `security-alert-center/docs/event-schema-v1.json` — **единственный источник истины**.
- Контракт событий: `security-alert-center/schemas/event-schema-v1.json` — **единственный источник истины**.
- Изменение схемы → обновить ТЗ + версию `schema_version` + оба агента.
- Коммиты в три репо **раздельные**; связь через теги/версии в README (см. [roadmap.md](roadmap.md)).
### 4.1. Git: только git.kalinamall.ru
### 4.1. Git: зеркала и ссылки в документации
**Единственный рабочий remote для commit/push — `kalinamall` (git.kalinamall.ru).**
GitHub (`origin`) в этом workspace **не используем**: не push, не pull, не PR.
В **main** ссылки между репозиториями указывают на **GitHub** (`https://github.com/PTah/...`).
После каждой завершённой фичи (или логического блока работы):
Перед push на другой хост (kalinamall, papatramp) используйте скрипт зеркалирования — он подменяет URL в docs, пушит и **не оставляет** чужие ссылки в локальной ветке:
```powershell
# security-alert-center (аналогичные скрипты — в соседних репо при необходимости)
.\scripts\Rewrite-GitHostUrls.ps1 kalinamall # только проверка diff
.\scripts\Push-Mirror.ps1 kalinamall # commit → push kalinamall → reset main
.\scripts\Push-Mirror.ps1 github # push на GitHub после обычного commit
```
Обычный цикл разработки:
```bash
git add …
git commit -m "…"
git fetch kalinamall
git push kalinamall main
git push github main
# при необходимости синхронизировать kalinamall:
# PowerShell: .\scripts\Push-Mirror.ps1 kalinamall
```
Upstream ветки `main`:
```bash
git config branch.main.remote kalinamall
git config branch.main.merge refs/heads/main
git config remote.pushDefault kalinamall
```
Если `git push --force-with-lease` пишет `stale info` — сначала `git fetch kalinamall`, затем push снова.
---
## 5. Remote kalinamall (первичная настройка)
```bash
git remote add kalinamall https://git.kalinamall.ru/PapaTramp/<repo>.git
git push -u kalinamall main
```
Репозитории:
## 5. URL репозиториев (GitHub)
| Проект | URL |
|--------|-----|
| security-alert-center | `https://git.kalinamall.ru/PapaTramp/security-alert-center.git` |
| ssh-monitor | `https://git.kalinamall.ru/PapaTramp/ssh-monitor.git` |
| RDP-login-monitor | `https://git.kalinamall.ru/PapaTramp/RDP-login-monitor.git` |
| security-alert-center | `https://github.com/PTah/security-alert-center.git` |
| ssh-monitor | `https://github.com/PTah/ssh-monitor.git` |
| RDP-login-monitor | `https://github.com/PTah/RDP-login-monitor.git` |
---