chore(github): generic example.com in docs, remove mirror scripts

Replace sac.kalinamall.ru with sac.example.com in public docs/deploy.
Remove Push-Mirror and Rewrite-GitHostUrls scripts from repo.
Simplify workspace-three-repos.md for GitHub-only workflow.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
PTah
2026-06-16 11:57:02 +10:00
parent 06c6748274
commit 6b288bfa49
21 changed files with 84 additions and 335 deletions
+14 -57
View File
@@ -6,26 +6,22 @@
## 1. Расположение репозиториев (пример)
| Имя в 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** — зеркало с теми же репозиториями; ссылки в документации на каждом хосте должны вести **на этот же хост** (см. ниже).
| Имя в workspace | Публичный remote |
|-----------------|------------------|
| `ssh-monitor` | github.com/PTah/ssh-monitor |
| `rdp-monitor` | github.com/PTah/RDP-login-monitor |
| `security-alert-center` | github.com/PTah/security-alert-center |
---
## 2. Файл workspace
Создайте `security-monitors.code-workspace`:
```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": "ssh-monitor", "name": "ssh-monitor" },
{ "path": "RDP-login-monitor", "name": "rdp-monitor" },
{ "path": "security-alert-center", "name": "security-alert-center" }
],
"settings": {
"files.eol": "\n"
@@ -33,61 +29,22 @@
}
```
Открыть: **File → Open Workspace from File**.
---
## 3. Порядок работ по фазам
| Фаза | Где править |
|------|-------------|
| 0 — ТЗ | `security-alert-center/docs/` |
| 1 — MVP SAC | `security-alert-center/backend`, `frontend` |
| 2 — UseSAC | `ssh-monitor`, `RDP-login-monitor` + мелкие правки SAC при необходимости |
---
## 4. Соглашения
## 3. Соглашения
- Контракт событий: `security-alert-center/schemas/event-schema-v1.json`**единственный источник истины**.
- Изменение схемы → обновить ТЗ + версию `schema_version` + оба агента.
- Коммиты в три репо **раздельные**; связь через теги/версии в README (см. [roadmap.md](roadmap.md)).
### 4.1. Git: зеркала и ссылки в документации
В **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
```
Обычный цикл разработки:
- Коммиты в три репо **раздельные**; связь через теги/версии в README.
```bash
git add …
git commit -m "…"
git push github main
# при необходимости синхронизировать kalinamall:
# PowerShell: .\scripts\Push-Mirror.ps1 kalinamall
git clone https://github.com/PTah/security-alert-center.git
git clone https://github.com/PTah/ssh-monitor.git
git clone https://github.com/PTah/RDP-login-monitor.git
```
---
## 5. URL репозиториев (GitHub)
| Проект | URL |
|--------|-----|
| 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` |
---
## См. также
- [work-plan.md](work-plan.md) фаза 0.6
- [work-plan.md](work-plan.md)