chore: initial private ActivityWatch Russian deployment project

2026-04-25 15:24:04 +03:00
commit 0821de0964
26 changed files with 2915 additions and 0 deletions
@@ -0,0 +1,111 @@
+# Windows deployment
+
+## Состав пакета
+
+- `windows/deploy-single-user.ps1` — развёртывание для одного пользователя.
+- `windows/deploy-domain-users.ps1` — массовое развёртывание по списку пользователей.
+- `windows/hardening-recovery.ps1` — повторная регистрация задач, ACL и recovery-loop.
+- `windows/browser-domains-native-collector.ps1` — native collector доменов браузера с категоризацией.
+- `windows/web-category-rules.example.json` — пример кастомных правил категоризации.
+
+## Что делает пакет
+
+- Ставит `aw-watcher-afk` и `aw-watcher-window` из официального Windows ZIP ActivityWatch.
+- Копирует browser-domain collector в `C:\ProgramData\ActivityWatch`.
+- Создаёт per-user задачи `ActivityWatch Launch [...]` с запуском при логоне.
+- Создаёт системную задачу `ActivityWatch Recovery`, которая циклически перезапускает per-user launch tasks.
+- Применяет ACL к `C:\Program Files\ActivityWatch`, `C:\ProgramData\ActivityWatch` и каталогу логов.
+- Не содержит хардкодов инфраструктуры: сервер, домен, список пользователей и правила передаются параметрами.
+
+## Предпосылки
+
+- Windows 10/11 или Windows Server с PowerShell 5.1+.
+- Запуск из elevated PowerShell.
+- Доступ до ActivityWatch Server по `host:port`.
+- Пользователи домена должны реально входить на хост интерактивно.
+- Если интернет недоступен, заранее скачайте ActivityWatch ZIP и передайте `-PackageZipPath`.
+
+## Single-user deploy
+
+```powershell
+Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
+
+.\windows\deploy-single-user.ps1 `
+  -ServerHost aw.example.local `
+  -ServerPort 5600 `
+  -TargetUser 'CONTOSO\svc.activity.user01' `
+  -CustomRulesPath .\windows\web-category-rules.example.json
+```
+
+Локальный пользователь:
+
+```powershell
+.\windows\deploy-single-user.ps1 `
+  -ServerHost aw-gateway.internal `
+  -ServerPort 5600 `
+  -TargetUser '.\operator01'
+```
+
+Оффлайн-установка из локального ZIP:
+
+```powershell
+.\windows\deploy-single-user.ps1 `
+  -ServerHost aw.example.local `
+  -TargetUser 'CONTOSO\user01' `
+  -PackageZipPath C:\Temp\activitywatch-v0.13.2-windows-x86_64.zip
+```
+
+## Multi-user / domain deploy
+
+Поддерживаются:
+
+- `-Users user1,user2`
+- `-Users 'CONTOSO\user1','CONTOSO\user2'`
+- `-UserListPath .\users.txt`
+- `-UserListPath .\users.csv`
+
+TXT-формат:
+
+```text
+# comments are ignored
+user01
+user02
+user03
+```
+
+CSV-формат: колонка `User`, `Username`, `SamAccountName` или `Login`.
+
+Пример:
+
+```powershell
+.\windows\deploy-domain-users.ps1 `
+  -ServerHost aw.example.local `
+  -ServerPort 5600 `
+  -Domain CONTOSO `
+  -UserListPath C:\Temp\aw-users.txt `
+  -CustomRulesPath C:\Temp\web-category-rules.json
+```
+
+Если список уже содержит `DOMAIN\user`, параметр `-Domain` не нужен.
+
+## Категоризация доменов
+
+- Встроенные категории покрывают базовые рабочие, нейтральные и личные домены.
+- Для кастомизации скопируйте `windows/web-category-rules.example.json` и отредактируйте домены.
+- Передайте файл через `-CustomRulesPath`; он будет сохранён как `C:\ProgramData\ActivityWatch\web-category-rules.json`.
+- Пользовательские правила имеют приоритет над встроенными.
+
+## Структура после установки
+
+- `C:\Program Files\ActivityWatch` — бинарники watcher'ов.
+- `C:\ProgramData\ActivityWatch\deployment-config.json` — итоговая конфигурация.
+- `C:\ProgramData\ActivityWatch\launch-watchers.ps1` — per-user launcher.
+- `C:\ProgramData\ActivityWatch\recovery-loop.ps1` — system recovery loop.
+- `C:\ProgramData\ActivityWatch\browser-domains-native-collector.ps1` — runtime collector.
+- `C:\ProgramData\ActivityWatch\logs\` — логи collector'а.
+
+## Повторный прогон
+
+- Скрипты идемпотентны: переустанавливают задачи и обновляют runtime-файлы.
+- Предыдущая установка ActivityWatch бэкапится в `C:\ProgramData\ActivityWatch\backups\install-YYYYMMDD-HHMMSS`.
+- Для жёсткого восстановления запускайте `windows/hardening-recovery.ps1`.