Compare commits

..
13 Commits
Author SHA1 Message Date
TMSH 3d2e23dd9b [1.9] Обращения: ADR-0006 и макет окна Помощника (#10)
ci / smoke (push) Successful in 2s
**Задача:** #1.9
**Пункты:** 1.9.5, 1.9.6, 1.9.7

## Что сделано
- docs/adr/0006-user-tickets.md — черновик ADR-0006, статус "Предложено": цепочка обращения, форма (1000 знаков, без срочности), статусы с переоткрытием в 3 дня, кнопка "Решено" политикой, скриншоты 30 дней и доступ по tickets.manage.
- docs/ux/helper-window.html — функциональный макет окна Помощника: форма с категориями и превью скриншота, список "Мои обращения", переписка с подтверждением, "О программе". Это схема экранов, не визуальный дизайн.
- Правка статуса записи журнала ветки 1.8-functions (забыл включить в PR #9).

## Как проверить
- Открыть docs/ux/helper-window.html в браузере — 4 экрана.
- ADR-0006 сверить с ответами В1-В6 и текстом решения в карточке 1.9.

## Чек-лист
- [x] Коммиты и название PR по-русски, в каждом коммите есть Refs:
- [x] Секретов и персональных данных нет
- [x] Документация обновлена: запись журнала, docs/status/
- [ ] Ссылка на этот PR добавлена в «Ссылки» задачи в дорожной карте

Reviewed-on: #10
Co-authored-by: BrowenSiz <top.timashevsky@gmail.com>
2026-11-15 14:23:13 +00:00
TMSH 9a0533b102 [1.8] Функции Помощника по фазам и черновик ADR-0005 (#9)
ci / smoke (push) Successful in 3s
**Задача:** #1.8
**Пункты:** 1.8.4, 1.8.5 (черновик)

## Что сделано
- docs/architecture/helper.md — функции Помощника по фазам: роль и ограничения, фаза 1 (обращения по #1.9), фаза 2 (удалённый доступ, уведомления, захват экрана), границы, черновой список методов IPC для proto/helper/v1.
- docs/adr/0005-agent-and-helper.md — черновик ADR-0005, статус «Предложено»: архитектура агент+Помощник, варианты технологии с результатами PoC. Решение по технологии открыто до замера на Astra 1.8 (#1.8.3).

## Как проверить
- Только документы. Сверить с карточками #1.8 (В2–В5), #1.9 (поля формы), #1.10 (согласие, индикатор).

## Чек-лист
- [x] Коммиты и название PR по-русски, в каждом коммите есть Refs:
- [x] Секретов и персональных данных в документах нет
- [x] Документация обновлена: запись журнала, docs/status/
- [ ] Ссылка на этот PR добавлена в «Ссылки» задачи в дорожной карте

Reviewed-on: #9
Co-authored-by: BrowenSiz <top.timashevsky@gmail.com>
2026-11-10 21:57:00 +00:00
TMSH 22d1698764 [1.8] PoC Помощника: трей и замеры на Windows (#8)
ci / smoke (push) Successful in 3s
**Задача:** #1.8
**Пункты:** 1.8.1, 1.8.2

## Что сделано
- PoC в poc/helper-tray/: Tauri 2 только с иконкой в трее (окна при старте нет), меню из трёх пунктов, окно создаётся по клику и уничтожается при закрытии.
- Форма «Сообщить о проблеме» по прототипу; «Выход» только в debug-сборке.
- Замер времени открытия — команда first_paint (invoke после двойного rAF); сценарий --measure-scenario + measure.ps1: PrivateBytes и WorkingSetPrivate дерева процессов по отметкам этапов в логе.
- Замеры Windows 11 (release, 5 прогонов, медиана): покой 2,0 МБ PB, окно 155,3 МБ PB (цель 150 — не дотянуто ~5 МБ), после закрытия 5,2 МБ, открытие 580/555 мс. Выводы и методика — docs/research/helper-tray-poc.md.
- AGENTS.md: добавлена временная папка poc/ (удаляется после ADR-0005).

## Как проверить
1. cd poc/helper-tray && pnpm install && pnpm tauri build
2. Запустить src-tauri/target/release/helper-tray.exe — только трей, без окна.
3. powershell -ExecutionPolicy Bypass -File measure.ps1 — 5 прогонов, таблица.
4. На Linux: сборка по docs/research/helper-tray-poc.md, замер через PSS.

## Чек-лист
- [x] Коммиты и название PR по-русски, в каждом коммите есть Refs:
- [x] Ветка свежая: git rebase origin/main, конфликтов нет
- [x] Секретов и персональных данных в коде, логах и документах нет
- [x] Документация обновлена: запись журнала, docs/status/, docs/research/
- [ ] Ссылка на этот PR добавлена в «Ссылки» задачи в дорожной карте
<!-- Прочие пункты шаблона неприменимы: нет запросов к БД, прав, миграций, флагов -->

Reviewed-on: #8
Co-authored-by: BrowenSiz <top.timashevsky@gmail.com>
2026-11-10 21:42:07 +00:00
SheinovM 9547fa7076 Feat/2.9.1 ci smoke (#7)
ci / smoke (push) Successful in 2s
2026-11-09 17:53:56 +00:00
TMSH 235ffd3382 docs: записана проверка hello world Tauri и Go на Windows (#6)
**Задача:** #1.3
**Пункты:** 1.3.9

## Что сделано
- Hello world Tauri 2 и Go собран на Windows, инструкция и таблица результатов — в docs/environment.md

## Как проверить
1. Выполнить шаги из docs/environment.md, раздел «Проверка #1.3.9»

Refs: 1.3.9
Reviewed-on: #6
Co-authored-by: BrowenSiz <top.timashevsky@gmail.com>
2026-11-09 17:49:14 +00:00
TMSH 800d000ac5 Docs/1.2 private notes (#5)
<!-- Название PR: «[ID] Что сделано», по-русски. Например: [2.11] Изоляция организаций -->

**Задача:** #<!-- ID задачи в дорожной карте -->
**Пункты:** <!-- 2.11.4, 2.11.6 -->

## Что сделано
-

## Как проверить
1.

## Скриншоты
<!-- Для изменений интерфейса. Иначе удалить раздел. -->

## Чек-лист
- [ ] Коммиты и название PR по-русски, в каждом коммите есть `Refs:`
- [ ] Ветка свежая: `git rebase origin/main`, конфликтов нет
- [ ] Запросы к данным организации — с `tenant_id` и через `WithTenantTx`
- [ ] Права проверяются на сервере (`access.Require` / `ScopesFor`), интерфейс только скрывает
- [ ] Новая функция — за флагом из каталога функций
- [ ] Миграции только новые, смерженные не изменены; контракты (`api/`, `proto/`, `migrations/`) — отдельным PR
- [ ] Тесты добавлены или обновлены; для новой таблицы организации — тест изоляции
- [ ] Секретов и персональных данных в коде, логах и документах нет
- [ ] Документация обновлена: запись журнала, `docs/status/`, ADR при значимом решении
- [ ] Ссылка на этот PR добавлена в «Ссылки» задачи в дорожной карте

Reviewed-on: #5
Co-authored-by: BrowenSiz <top.timashevsky@gmail.com>
2026-11-09 13:33:30 +00:00
TMSHandDevin dcee1faf7d chore: добавлены правила git, шаблон PR и проверочные хуки (#4)
Правила работы с ветками, коммитами и PR в docs/contributing.md. Lefthook проверяет формат коммита, форматирует Go и ищет секреты перед коммитом.

Refs: 1.2.8, 1.2.9, 1.2.10, 1.13.4

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Reviewed-on: #4
Co-authored-by: BrowenSiz <top.timashevsky@gmail.com>
2026-11-08 15:35:13 +00:00
TMSH 377a7f3807 Merge pull request 'chore(ci): зафиксированы версии инструментов окружения' (#3) from feat/1.3-dev-environment into main
Reviewed-on: #3
2026-11-08 15:09:21 +00:00
TMSHandDevin ce06be801c chore(ci): зафиксированы версии инструментов окружения
Одинаковые версии у обоих разработчиков и в CI: Go 1.27.3, Node 26 LTS, pnpm 12.17, Task 3.54, Rust 1.99.1. Выбор и установка описаны в docs/environment.md.

Refs: 1.3.6

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-11-08 18:08:46 +03:00
TMSH 3d9c84839e Merge pull request 'docs: добавлено правило писать коммиты и PR на русском' (#2) from docs/1.2-commit-rules-ru into main
Reviewed-on: #2
2026-11-08 14:32:41 +00:00
TMSHandDevin e9a85ad1a4 docs: добавлено правило писать коммиты и PR на русском
Единый понятный стиль истории для обоих разработчиков и AI-ассистентов. Тип и область остаются латиницей для инструментов (git-cliff, lefthook).

Refs: 1.2.9

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-11-08 17:31:21 +03:00
SheinovM 434becbba3 Merge pull request 'docs: AI documentation protocol and roadmap context tool' (#1) from chore/1.2-ai-docs-protocol into main
Reviewed-on: #1
2026-11-08 14:28:02 +00:00
TMSHandDevin a1ce4bdb8a docs: AI documentation protocol and roadmap context tool
Протокол работы AI-ассистентов, зоны frontend/backend/shared, статусы, журнал, шаблоны и скрипт сводки дорожной карты.

Refs: 1.2.3

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-11-08 17:14:44 +03:00
74 changed files with 7807 additions and 6 deletions

No files matched your search

+25
View File
@@ -0,0 +1,25 @@
<!-- Название PR: «[ID] Что сделано», по-русски. Например: [2.11] Изоляция организаций -->
**Задача:** #<!-- ID задачи в дорожной карте -->
**Пункты:** <!-- 2.11.4, 2.11.6 -->
## Что сделано
-
## Как проверить
1.
## Скриншоты
<!-- Для изменений интерфейса. Иначе удалить раздел. -->
## Чек-лист
- [ ] Коммиты и название PR по-русски, в каждом коммите есть `Refs:`
- [ ] Ветка свежая: `git rebase origin/main`, конфликтов нет
- [ ] Запросы к данным организации — с `tenant_id` и через `WithTenantTx`
- [ ] Права проверяются на сервере (`access.Require` / `ScopesFor`), интерфейс только скрывает
- [ ] Новая функция — за флагом из каталога функций
- [ ] Миграции только новые, смерженные не изменены; контракты (`api/`, `proto/`, `migrations/`) — отдельным PR
- [ ] Тесты добавлены или обновлены; для новой таблицы организации — тест изоляции
- [ ] Секретов и персональных данных в коде, логах и документах нет
- [ ] Документация обновлена: запись журнала, `docs/status/`, ADR при значимом решении
- [ ] Ссылка на этот PR добавлена в «Ссылки» задачи в дорожной карте
+12
View File
@@ -0,0 +1,12 @@
name: ci
on:
push:
branches: [main]
pull_request:
jobs:
smoke:
runs-on: ubuntu-latest # ← метка из регистрации раннера
steps:
- uses: actions/checkout@v4
- run: node -v
+48 -6
View File
@@ -1,37 +1,79 @@
# Секреты и локальные настройки
# Что НЕ попадает в Gitea. Правила — docs/contributing.md, раздел «Что не коммитим».
# ── Секреты: пароли, токены, ключи, сертификаты ─────────────────────
.env
.env.*
!.env.example
*.pem
*.key
*.p12
*.pfx
*.jks
*.keystore
*.kdbx
*.ovpn
id_rsa*
id_ed25519*
secrets/
.secrets/
# ── Личное: видит только владелец компьютера ────────────────────────
# Заметки разработчика с AI (docs/ai/PROTOCOL.md, раздел 2)
docs/private/
# Личные правила и настройки AI-инструментов (общие — в AGENTS.md и docs/ai/)
.cursor/
.windsurf/
.claude/
.continue/
.aider*
CLAUDE.local.md
*.local.md
.devin/*.local.*
# Личные переопределения версий и окружения
.mise.local.toml
mise.local.toml
# ── Данные, которые могут содержать персональные данные клиентов ─────
*.dump
*.sql.gz
*.backup
dumps/
backups/
# ── Прогресс дорожной карты: отдельный репозиторий shtil-roadmap-progress
roadmap/progress.json
# ── Сборка и зависимости ───────────────────────────────────────────────
# Go
/bin/
*.exe
*.test
*.out
coverage.*
# Node
node_modules/
dist/
.vite/
*.tsbuildinfo
.pnpm-store/
coverage/
playwright-report/
test-results/
# Rust / Tauri
target/
src-tauri/gen/
# Task
.task/
# IDE и ОС
# ── IDE и ОС ───────────────────────────────────────────────────────────
.idea/
.vscode/*
!.vscode/extensions.json
*.swp
.DS_Store
Thumbs.db
desktop.ini
# Логи и временное
# ── Логи и временное ───────────────────────────────────────────────────
*.log
tmp/
.tmp/
+8
View File
@@ -0,0 +1,8 @@
# Версии инструментов проекта. Меняются только PR с записью в docs/environment.md.
[tools]
go = "1.27.3"
node = "26.13.0"
pnpm = "12.17.0"
task = "3.54.0"
lefthook = "2.2.2"
gitleaks = "8.30.1"
+11
View File
@@ -0,0 +1,11 @@
{
"recommendations": [
"golang.go",
"Vue.volar",
"rust-lang.rust-analyzer",
"tauri-apps.tauri-vscode",
"dbaeumer.vscode-eslint",
"bradlc.vscode-tailwindcss",
"EditorConfig.EditorConfig"
]
}
+164
View File
@@ -0,0 +1,164 @@
# AGENTS.md — контекст проекта «Штиль» для разработчиков и AI-ассистентов
## 1. Что мы строим
**«Штиль»** — отечественная RMM-платформа (Remote Monitoring & Management) для ИТ-отделов и MSP в РФ/СНГ.
Коммерческий продукт T&B.Soft, закрытый код.
| Компонент | Где работает | Что делает |
|---|---|---|
| **Сервер** `shtil-server` | SaaS (ЦОД в РФ) или сервер заказчика | Принимает агентов, хранит данные, отдаёт REST API |
| **Приложение «Штиль»** (Tauri 2 + Vue 3) | ПК администраторов, техников, офисов филиалов | Основной интерфейс для всех ролей, подключается к SaaS или on-prem серверу |
| **Агент** `shtil-agent` (Go) | Каждое устройство, служба SYSTEM/root, без окон | Связь с сервером, инвентаризация, метрики, выполнение подписанных команд, запуск Помощника |
| **Помощник** «Штиль Помощник» (Tauri 2) | Сессия каждого пользователя ПК, иконка в трее | Обращения сотрудников в ИТ-отдел, статусы и ответы, уведомления; фаза 2 — согласие и индикатор удалённого доступа |
- **Помощник** не имеет прав администратора и не общается с сервером напрямую — только с агентом через IPC (named pipe / unix socket) с проверкой подлинности. На серверах без графической сессии работает только агент.
- **Уровни доступа** — роль назначается на область (организация → филиал → отдел), права наследуются вниз. Офис филиала видит только метрики и данные своего филиала, главный админ видит и может всё. ADR-0008.
- **Обращение** (`ticket`) — сообщение сотрудника через Помощника с автодиагностикой. **Алерт** (`alert`) — автоматическое событие мониторинга. Оба попадают в раздел «Входящие». ADR-0006.
- **Удалённый доступ** — два режима: «с согласием» (запрос пользователю, видимый индикатор сеанса) и «без согласия» (серверы и ПК без людей: отдельное право, повторная 2FA, обязательная причина), плюс смешанный режим. Решение о показе запроса принимает агент по подписанной политике, а не сервер. ADR-0007.
Поставка: **SaaS** и **on-prem** (вплоть до изолированного контура) из **одной кодовой базы**.
## 2. Команда и реальность
- 2 разработчика, работают вместе и постоянно на связи. Отдельных DevOps, QA и дизайнера нет.
- Продуктовый план рассчитан на 16–18 человек, поэтому объём сознательно режется, а технологии выбираются с минимальной операционной нагрузкой.
- Главный риск — растянуть MVP. Всё, что вне текущего шага дорожной карты, идёт в бэклог.
- Задачи, статусы, обсуждения и решения ведутся **в дорожной карте** (`shtil-roadmap.html` с сервера). Отдельного трекера нет. ID задач (`2.11`) и пунктов (`2.11.4`) используются в ветках, коммитах и PR.
- Код — в **Gitea** на своём сервере, CI — Gitea Actions (`act_runner`).
- Чтобы понять, что решила команда, читай сводку из «Настройки → Сводка для AI» или `progress.json`: поля `decisions`, `answers`, `comments`, `notes`, `custom`.
## 3. Стек (зафиксирован, менять только через ADR)
| Слой | Технология |
|---|---|
| Сервер | Go, **монолит**: один бинарник, одна БД, функции отключаются программно |
| HTTP API | REST + OpenAPI 3 (spec-first), роутер `net/http` (Go 1.22+) или `chi` |
| Протокол агента | WebSocket поверх TLS 443 + Protobuf, mTLS-идентификация агента |
| IPC агент ↔ Помощник | Protobuf поверх named pipe (Windows) / unix socket (Linux) |
| Внутренняя шина | NATS (встроенный в бинарник; внешний кластер — при масштабировании SaaS) |
| БД | PostgreSQL 16+ (совместимость с Postgres Pro), `pgx/v5` + `sqlc`, миграции `goose` |
| Метрики | PostgreSQL (партиционирование) за интерфейсом `MetricStore`, ClickHouse позже |
| Файлы | S3-совместимое хранилище (MinIO) |
| Приложение и Помощник | Tauri 2 + Vue 3 + TypeScript (strict) + Vite + Pinia + Vue Router + TanStack Query |
| UI | Общая дизайн-система `packages/ui`: Reka UI (headless) + Tailwind CSS, иконки Lucide |
| Удалённый доступ | WebRTC (Pion) + собственный TURN — фаза 2 |
| Наблюдаемость | `log/slog` (JSON), OpenTelemetry, Prometheus-метрики |
| Dev-окружение | Docker Compose, Taskfile, mise |
Версии инструментов (Go, Node LTS, pnpm, Task, Rust, Tauri) зафиксированы в `.mise.toml` и `rust-toolchain.toml`, объяснение и установка — `docs/environment.md`.
## 4. Архитектурные принципы (обязательны)
1. **Мультиарендность с первого дня.** У каждой таблицы организации есть `tenant_id`. Изоляция двойная: проверка в коде (организация берётся из контекста запроса) и Row-Level Security в Postgres. Доступ к данным организации — только через `WithTenantTx`. Системные таблицы без `tenant_id` оформляются явно.
2. **Монолит с понятными границами.** Код сервера лежит в `internal/server/<область>` (`access`, `sites`, `devices`, `tickets`, `remote`…). Это организация кода, а не отдельные модули: общая БД и общие транзакции разрешены. Правило: таблицы области меняет только код этой области; другие области вызывают её сервисные функции, а не пишут SQL в чужие таблицы. Слои внутри области: обработчик HTTP → сервис → запросы к БД.
3. **Функции отключаются программно.** Каталог функций и лимитов — `internal/server/features`. Итоговое значение: аварийное отключение в конфиге → редакция лицензии → настройка организации → значение по умолчанию. Проверка в API, фоновых задачах, приложении (`/me/features`) и агенте (`HelloAck`). Технические флаги для незаконченной разработки удаляются после релиза функции. Никаких `if saas` по коду.
4. **Безопасность в основе.** RMM имеет права администратора на всех устройствах клиента, поэтому взлом платформы означает взлом всех клиентов.
- Агент ↔ сервер: mTLS, ключ создаётся на устройстве, сертификат выдаётся при регистрации, CA сервера закреплён в агенте.
- Каждая команда агенту подписана (Ed25519) и содержит `tenant_id`, `device_id`, `nonce`, `expires_at`. Агент отклоняет неподписанные, чужие и просроченные команды.
- Политика удалённого доступа подписана и применяется агентом. Локальный запрет на устройстве сервер снять не может.
- 2FA (TOTP) для пользователей приложения, повторная 2FA для подключения без согласия.
- Журнал аудита только дополняется (цепочка хэшей). Каждое действие с устройством и каждая попытка удалённого доступа попадают в журнал.
- Секреты не попадают ни в логи, ни в git, ни в ответы API. Скриншоты обращений — персональные данные: ограниченный срок хранения и доступ по правам.
5. **Протокол агента и IPC версионируются.** Только обратно совместимые изменения, `buf breaking` в CI, поле `protocol_version`. Сервер поддерживает агентов N-2 версий.
6. **Агент работает автономно.** Без связи события и обращения копятся в локальной очереди; переподключение с exponential backoff и jitter. Сервер выдерживает шторм переподключений.
7. **Маршрутизация команд через NATS** subject `agent.<tenant>.<device>`. Соединения агентов не хранят состояние, которое нельзя потерять (задел под `--only=gateway`).
8. **Всё асинхронное идемпотентно.** Команды, обращения, задачи и вебхуки имеют `id`, повторная доставка безопасна.
9. **Время в UTC, ID в UUIDv7**, деньги — целые копейки, никаких float.
10. **Доступ = право + область.** `access.Require(ctx, perm, object)` для действий, `access.ScopesFor(ctx, perm)` + SQL-фильтр по поддеревьям `sites.path` для списков. Приложение только скрывает недоступное, источник истины — сервер.
## 5. Структура репозитория (монорепо)
```
cmd/shtil-server точка входа сервера
cmd/shtil-agent точка входа агента
internal/server/ серверный монолит
app/ сборка зависимостей и запуск
platform/ config, log, db, httpx, bus, obs
access/ features/ audit/ auth/ tenants/ sites/ users/
devices/ tickets/ commands/ remote/ (следующие шаги)
internal/agent/ агент: transport, collectors, executor, ipc, service, platform/{windows,linux}
internal/shared/ общее для сервера и агента
proto/agent/v1, proto/helper/v1 контракты (buf)
api/openapi.yaml контракт REST API
migrations/ SQL-миграции (goose)
apps/console/ приложение «Штиль» (Vue в src/, Tauri в src-tauri/)
apps/helper/ «Штиль Помощник»
packages/ui/ общая дизайн-система
packages/api-client/ сгенерированный TS-клиент
deploy/dev/ docker-compose для разработки
poc/ временные прототипы для проверки решений (удаляются после ADR)
docs/ ai/, status/, journal/, frontend/, backend/, adr/, architecture/, ux/, testing/, research/, glossary.md
roadmap/ data.js (содержание), app.js + app.css (интерфейс), progress.json (работа команды)
tools/roadmap-server/ сервер дорожной карты (Go, без зависимостей)
tools/roadmap-context/ сводка дорожной карты для AI (Node, только чтение)
shtil-roadmap.html дорожная карта
```
## 6. Правила для кода
### Go
- Go — последняя стабильная версия. Поддерживаемые ОС — ADR-0001 (Go ≥ 1.21 не работает на Windows 7/8.1/Server 2012 R2).
- `gofmt` и `golangci-lint` без предупреждений. Ошибки оборачиваются `fmt.Errorf("...: %w", err)`, `panic` в бизнес-коде не используется.
- `context.Context` — первый аргумент любой функции с I/O.
- SQL пишется руками и генерируется через `sqlc`. ORM не используется.
- Тесты табличные. Интеграционные — против настоящего Postgres (testcontainers-go). Для каждой новой таблицы организации обязателен тест изоляции.
### Frontend (приложение и Помощник)
- TypeScript strict, `any` запрещён. Типы API генерируются из `api/openapi.yaml`, руками не пишутся.
- Composition API + `<script setup>`. Серверное состояние — TanStack Query, клиентское — Pinia.
- Все строки интерфейса — через `vue-i18n`, даже если пока есть только русский.
- Компоненты — из `packages/ui`. Новый базовый компонент сначала добавляется туда.
- Вызовы Tauri API и плагинов — только через слой `src/platform/`.
- Видимость элементов — через `v-can` / `useFeature`, без ручных проверок ролей.
### Общее
- Термины — по `docs/glossary.md`. Новый термин сначала добавляется в словарь.
- Ветки `feat/<ID>-кратко`, коммиты Conventional Commits с областью (`feat(server): …`) и строкой `Refs: <ID подзадачи>`, PR в Gitea «[ID] Название», squash merge.
- **Коммиты и PR пишутся на русском языке, понятно и чётко.** Тип и область остаются латиницей (их читают инструменты), всё остальное — по-русски:
- заголовок: `тип(область): что сделано` — с маленькой буквы, без точки, до 72 символов, глагол в прошедшем времени (`добавлен`, `исправлена`, `убрано`);
- тело (если нужно): почему и что важно знать, а не пересказ диффа;
- последняя строка: `Refs: <ID пункта>`.
- Хорошо: `feat(server): добавлен WithTenantTx для доступа к данным организации`, `fix(console): исправлен повтор запроса после истечения токена`.
- Плохо: `fix`, `правки`, `update files`, `WIP`, английский текст.
- Заголовок squash-коммита при слиянии PR тоже по-русски, обычно совпадает с названием PR.
- Формат проверяет хук `commit-msg` (lefthook), `--no-verify` не используется. Полные правила git — `docs/contributing.md`, описание PR — по шаблону `.gitea/pull_request_template.md`.
- Изменения `api/openapi.yaml`, `proto/`, `migrations/` — отдельным PR.
- Значимое техническое решение — ADR в `docs/adr/NNNN-название.md` и поле «Решение» в дорожной карте.
- Без лишних комментариев: комментарий объясняет «почему», а не «что».
## 7. Чего НЕ делать (особенно AI-ассистентам)
- Не предлагать микросервисы, Kubernetes, GraphQL, Kafka и прочее «на вырост» без ADR.
- Не добавлять зависимость без проверки лицензии: **AGPL/GPL запрещены** (в том числе код RustDesk и MeshCentral). Разрешены MIT, BSD, Apache-2.0, MPL-2.0.
- Не использовать сервисы и зависимости, которые могут стать недоступны из РФ. Всё работает on-prem без интернета (шрифты и иконки — локально).
- Не писать запросы к данным организации без `tenant_id` и мимо `WithTenantTx`.
- Не выполнять на агенте ничего без проверенной подписи. Не давать серверу обходить решение агента о согласии пользователя.
- Не давать Помощнику прав администратора и прямой связи с сервером.
- Не делать функции вне текущего шага и не делать «не в MVP»: бэкап, MDM, полный ITIL, антивирус, BI, MSP-биллинг, ИИ.
- Не перенумеровывать ID задач в `roadmap/data.js`: новые пункты получают следующий свободный номер. Отметки и обсуждения в `progress.json` привязаны к этим ID.
- Не редактировать `progress.json` на сервере руками — его пишет только `roadmap-server`. Свои пункты команды (`custom`) при раскрытии следующего шага переносятся в `data.js` новыми ID.
## 8. Команды разработки
Появятся в шаге 2.8. Ориентир:
```
task setup # установить инструменты и зависимости
task dev # postgres, nats, minio, mailpit + сервер + приложение
task test # все тесты
task lint # все линтеры
task gen # sqlc + buf + oapi-codegen + openapi-typescript
task migrate # миграции
task seed # демо-организация «Ромашка»
task build # все артефакты
```
## 9. Документирование и контекст (обязательно для AI)
Память проекта живёт в файлах, а не в чате. Полный протокол — **`docs/ai/PROTOCOL.md`**, выполняй его в каждой сессии.
- **Начало сессии:** прочитай `docs/status/shared.md`, `docs/status/<зона>.md`, последние записи `docs/journal/`, сверься с дорожной картой (`node tools/roadmap-context/roadmap-context.mjs [ID]`), коротко доложи, где мы и что предлагаешь. До этого код не пишется.
- **Зоны:** `frontend`, `backend`, `shared`. Читай `shared` + свою зону, пиши в свою зону + `shared`. Всё, что видит или от чего зависит другая сторона, — в `shared`.
- **Перед коммитом:** запись журнала ветки, обновлённый статус зоны, `shared` при влиянии на другую сторону, ADR для значимых решений. PR без документации не готов.
- **Дорожная карта** (https://locshare.ru/roadmap/) — трекер задач. AI только читает её (`docs/ai/roadmap.md`) и в конце работы выдаёт блок «Для дорожной карты»: какие пункты отметить, какой статус поставить, текст сообщения или решения.
+30
View File
@@ -0,0 +1,30 @@
# Документация «Штиль»
Начните с `AGENTS.md` (правила проекта), затем `docs/ai/PROTOCOL.md` (как работать с контекстом и документировать).
## Порядок чтения для новой сессии
1. `AGENTS.md`
2. `docs/ai/PROTOCOL.md`
3. `docs/status/shared.md` + `docs/status/<ваша зона>.md`
4. Последние записи `docs/journal/`
5. Дорожная карта: `node tools/roadmap-context/roadmap-context.mjs`
## Карта
| Папка / файл | Зона | Что внутри |
|---|---|---|
| `ai/` | shared | Протокол AI, сверка с дорожной картой, шаблоны |
| `status/` | shared + зоны | Снимок текущего состояния: общее, Frontend, Backend |
| `journal/` | все | История работы: одна запись на ветку/PR |
| `adr/` | shared | Архитектурные решения `NNNN-название.md` |
| `architecture/` | shared | ERD, правила БД, протокол агента, IPC Помощника |
| `ux/` | shared | Информационная архитектура, макеты, сценарии |
| `testing/` | shared | Тестовый стенд, сценарии доступа |
| `research/` | shared | Интервью, исследования рынка |
| `frontend/` | frontend | Внутренние правила Frontend: дизайн-система, компоненты, соглашения |
| `private/` | только владелец | Личные заметки разработчика с AI. В `.gitignore`, в Gitea не попадает |
| `backend/` | backend | Внутренние правила Backend: области сервера, агент, эксплуатация |
| `environment.md` | shared | Версии инструментов и установка окружения (#1.3) |
| `glossary.md` | shared | Словарь терминов (#2.1) |
| `features.md` | shared | Каталог функций и лимитов (#2.3) |
| `contributing.md` | shared | Ветки, коммиты, PR, версии (#1.2.9) |
+37
View File
@@ -0,0 +1,37 @@
# ADR-0005: ПО на устройстве — Агент и Помощник
- **Статус:** Предложено
- **Дата:** 2026-11-11
- **Задача:** #1.8
- **Участники:** Oleg, Максим
- **Зоны:** shared
## Контекст
Пользователю нужен интерфейс на ПК: сообщить о проблеме, видеть статус обращения, подтвердить удалённое подключение. Агент — служба в Session 0 (Windows) / systemd (Linux) и физически не может показывать окна. Значит на устройстве два компонента: служба-агент и «Штиль Помощник» в сессии пользователя. Оставалось выбрать технологию Помощника: критерии — в покое ≤ 40 МБ ОЗУ, с открытым окном ≤ 150 МБ, открытие ≤ 1 с, общий UI-стек с приложением, работа в изолированном контуре.
## Решение
*Черновик до решения #1.8.3: архитектура подтверждена, выбор технологии ждёт замер на Astra 1.8.*
- На устройстве два компонента: **агент** (служба, SYSTEM/root, единственный канал к серверу по mTLS) и **Помощник** (процесс в сессии пользователя, иконка в трее, без прав администратора).
- Помощник общается только с агентом по IPC (named pipe / unix socket, Protobuf, `proto/helper/v1`); агент проверяет подлинность Помощника (путь, подпись бинарника, пользователь сессии).
- Запуск: Windows — агент отслеживает входы и запускает Помощника в сессиях; Linux — XDG autostart, агент контролирует наличие. Пункта «Выход» нет, при падении агент перезапускает.
- Один установщик «агент + Помощник»; на серверах Помощник по умолчанию выключен. Иконка и название переопределяются конфигом (white-label для MSP).
- **Технология (предложение):** Tauri 2 в режиме «только трей»: окна нет при старте, форма создаётся по клику и уничтожается при закрытии. Подтверждено PoC (`poc/helper-tray`, `docs/research/helper-tray-poc.md`): Windows 11, release, медиана из 5 прогонов — покой 2,0 МБ PrivateBytes, открытие 580/555 мс, окно 155,3 МБ PrivateBytes (цель 150 — превышение ~5 МБ признано допустимым, т.к. расход даёт WebView2-движок, общий с приложением).
- Функции Помощника по фазам — `docs/architecture/helper.md`.
## Рассмотренные варианты
| Вариант | Плюсы | Минусы |
|---|---|---|
| **Tauri 2 трей + окно на WebView** | Общий UI-стек и дизайн-система с приложением, один язык для команды, WebView2 уже есть на Windows | Окно ~155 МБ PB > цели 150; на Linux зависит от WebKitGTK 4.1 |
| Трей на Go + окно Tauri по запросу | Покой ещё ниже (~2–3 МБ и так 2 МБ) | Окно всё равно на WebView — выигрыша по памяти с окном нет; второй стек IPC/сборки; выигрыш только в покое, который и так 20× ниже цели |
| Нативный трей + нативные окна (Go/Qt/winfrey) | Минимум памяти | Нет общего UI с приложением, два UI-стека, дороже поддержка — отклонено по трудозатратам |
## Последствия
- Нужны `proto/helper/v1` (черновик методов — `docs/architecture/helper.md`) и каркас `apps/helper/` на следующих шагах.
- Запасной путь при провале цели на Astra/РЕД ОС: трей на Go, окно Tauri по запросу.
- Решение пересматривается, если замер на Astra 1.8 (#1.12.5) покажет окно значительно выше ~160 МБ или открытие > 1 с.
- `poc/` удаляется после принятия ADR.
+46
View File
@@ -0,0 +1,46 @@
# ADR-0006: Обращения пользователей
- **Статус:** Предложено
- **Дата:** 2026-11-15
- **Задача:** #1.9
- **Участники:** Oleg, Максим
- **Зоны:** shared
## Контекст
Обращение (`ticket`) — сообщение сотрудника через Помощника: ключевая функция для пользователей и основа будущего Service Desk. Цель: сообщить о проблеме в два клика, а администратор сразу видит, кто, откуда и что случилось — без звонков. Алерт — автоматическое событие мониторинга (фаза 2); оба типа попадают в раздел «Входящие».
## Решение
**Сценарий.** Пользователь: трей → «Сообщить о проблеме» → форма. Помощник → агент по IPC (агент добавляет автодиагностику и отправляет; без связи — в очереди агента). Сервер создаёт обращение и отдаёт пользователям с правом `tickets.manage` на подразделение устройства, иначе владельцу организации. Пользователь видит статус и ответ в Помощнике.
**Форма.** 6 категорий-кнопок + «Другое»; описание обязательно до 1000 знаков; автоскриншот с превью и «Убрать» (отключается политикой организации); контакт запоминается после первого ввода. Поля «срочность» нет — приоритет ставит администратор при обработке.
**Автодиагностика** (добавляет агент): имя ПК, IP, подразделение, пользователь ОС, ОС и аптайм, CPU/ОЗУ, место на дисках, доступность шлюза, DNS и сервера «Штиль», ошибки системного журнала (за 1 час, до 20). Для «Не печатает» — принтеры, состояние и очередь печати.
**Статусы:** Новое → В работе → Ожидает пользователя → Решено → Закрыто (автоматически через 3 дня) · Отклонено. Ответ пользователя после «Решено» в течение 3 дней переоткрывает обращение.
**Переписка и подтверждение.** Комментарии внутри обращения (не отдельный чат). Кнопка «Решено» у пользователя — политика организации, по умолчанию включена, наследуется по подразделениям: включена — админ ставит «Ожидает пользователя», пользователь подтверждает или переоткрывает; выключена — админ закрывает сам.
**Скриншоты** — персональные данные: хранение 30 дней, доступ по `tickets.manage`, сжатие до 2 МБ, отключение политикой.
**Защита.** Обращение подписано сертификатом устройства; лимит 5 обращений за 10 минут с устройства.
**История и права.** «Мои обращения» — последние 10. Наблюдатель филиала видит обращения филиала только на чтение. Каналы без агента (веб-форма, почта, Telegram) — фаза 2 и позже.
## Рассмотренные варианты
| Вопрос | Выбрано | Альтернатива и почему отказались |
|---|---|---|
| Ответ админа | Комментарии внутри обращения | Живой чат — создаёт ожидание мгновенного ответа, админ не колл-центр |
| Срочность | Ставит админ при обработке | Поле у пользователя — все ставят «срочно», сигнала нет |
| Описание | До 1000 знаков | 2000 — поощряет простыни; 400 — мало для текста ошибки |
| Скриншот | Включён с «Убрать» | Выключен по умолчанию — теряется главная польза диагностики |
| Окно жизни чата | Таймер авто-закрытия (3 дня) | Отдельная механика «активного чата» — лишняя сложность |
## Последствия
- Нужен `proto/helper/v1` (`TicketSubmit` с диагностикой и ссылкой на скриншот — #2.6.4) и `proto/agent/v1` пересылка на сервер.
- Реализация формы и «Входящих» — шаг 6 (#2.15); макет окна Помощника — `docs/ux/helper-window.html` (#1.9.7).
- Политики: скриншоты вкл/выкл, кнопка «Решено», сроки хранения — войдут в каталог функций (#2.3).
- Решение пересматривается, если интервью (#1.14) покажут, что пользователям нужен живой чат или поле срочности.
+158
View File
@@ -0,0 +1,158 @@
# Протокол AI-ассистента: контекст и документирование
Обязателен для любого AI-ассистента в репозитории «Штиль» (Devin, Windsurf, Cursor, Claude Code и др.) у обоих разработчиков.
Читается сразу после `AGENTS.md`. Цель: ассистент в любой новой сессии за 1–2 минуты понимает, где проект, что сделано на Frontend и Backend, что делать дальше, и **сам поддерживает эту память в актуальном виде**.
---
## 1. Где что хранится (источники истины)
| Что | Где | Кто пишет |
|---|---|---|
| План, задачи, статусы, исполнители, обсуждения, решения команды | Дорожная карта (`docs/ai/roadmap.md`) | Люди в интерфейсе карты. **AI только читает** |
| Правила проекта, стек, запреты | `AGENTS.md` | Люди; AI предлагает правки |
| Как работает AI с памятью проекта | `docs/ai/` (этот файл) | Люди; AI предлагает правки |
| Текущее состояние «здесь и сейчас» | `docs/status/{shared,frontend,backend}.md` | AI в каждом PR |
| История: что сделано, почему, что осталось | `docs/journal/` — одна запись на ветку/PR | AI в каждом PR |
| Значимые решения | `docs/adr/NNNN-*.md` | AI готовит, люди принимают |
| Как устроена каждая часть системы | `docs/architecture/`, `docs/frontend/`, `docs/backend/`, `docs/ux/`, `docs/testing/` | AI при появлении нового модуля/паттерна |
| Контракты | `api/openapi.yaml`, `proto/`, `migrations/` | Отдельный PR, обсуждение с обоими |
| Термины | `docs/glossary.md` | Сначала словарь, потом код |
**Приоритет при расхождении:** код и контракты (как сделано) → ADR (как решили) → дорожная карта (статусы и решения команды) → `docs/status` → `docs/journal` → память чата. Нашёл расхождение — сообщи пользователю и предложи исправление, не выбирай молча.
**Не дублировать.** Дорожная карта отвечает на «что и в каком статусе», `docs/` — на «как сделано и почему». В `docs/` ссылайся на задачи по ID (`#2.11`, `#2.11.4`), не переписывай их текст.
---
## 2. Зоны ответственности
| Зона | Владелец | Пути | Что документируется |
|---|---|---|---|
| `frontend` | Frontend-разработчик | `apps/console/src/`, `apps/helper/src/`, `apps/*/src-tauri/`, `packages/ui/`, `docs/frontend/` | Дизайн-система, токены, компоненты, вёрстка, состояние, роутинг, i18n, слой `src/platform/`, Tauri-оболочка |
| `backend` | Backend-разработчик | `cmd/`, `internal/`, `deploy/`, `tools/` (кроме `roadmap-context`), `docs/backend/` | Сервер, агент, БД, NATS, безопасность, сборка, окружение |
| `shared` | Оба | `api/`, `proto/`, `migrations/`, `packages/api-client/`, `docs/adr/`, `docs/architecture/`, `docs/ux/`, `docs/glossary.md`, `docs/features.md`, `docs/status/shared.md`, `AGENTS.md`, `docs/ai/`, `tools/roadmap-context/`, `roadmap/`, `Taskfile.yml`, `.gitea/`, `.mise.toml` | Всё, что видит или от чего зависит другая сторона |
Правила зон:
- **Читаешь:** `shared` + свою зону. Чужую зону — только если задача её касается (например, Frontend подключает эндпоинт и смотрит `docs/backend/` по нему).
- **Пишешь:** свою зону + `shared`. Документы чужой зоны не редактируешь. Нашёл в них ошибку или нужна правка у другой стороны — запись в «Запросы между зонами» в `docs/status/shared.md`.
- Чисто внутренние вещи зоны (дизайн-правила, вёрстка, внутренняя организация сервиса) остаются в документах зоны и **не попадают** в `shared`. Ассистент другой стороны их не читает и не тратит на них контекст.
- **Личные заметки — `docs/private/`.** Папка в `.gitignore`: она есть только на компьютере владельца, в Gitea не попадает, второй разработчик и его AI её не видят. Это внутренний «чат» разработчика с AI: черновые мысли, личные договорённости с ассистентом, заметки по текущей работе, контекст между сессиями. Файлы: `docs/private/notes.md` (основной), при необходимости другие. Правила:
- ассистент читает `docs/private/` в начале сессии и дописывает туда то, что нужно помнить только владельцу;
- всё, что нужно другой стороне или проекту (решения, изменения поведения, договорённости), идёт в `docs/status`, `docs/journal` или ADR, а не только в `private`;
- ассистент не переносит текст из `private` в файлы под git без согласия владельца;
- секреты и пароли не хранятся и здесь — только в менеджере паролей. Резервную копию папки владелец делает сам.
- **Как определить зону сессии:** 1) пользователь назвал её («зона: frontend»); 2) она задана в личных правилах разработчика (раздел 8); 3) по путям файлов задачи. Задача затрагивает обе зоны — работай как `shared` и спроси, кто делает вторую часть.
### Что обязательно идёт в `shared` (impact: shared)
- изменения `api/openapi.yaml`, `proto/`, `migrations/`, сгенерированного клиента;
- права, роли, области, каталог функций и лимитов, коды ошибок и формат ответов;
- новые или изменённые переменные окружения, конфиг, порты, команды `task`, CI, зависимости уровня репозитория;
- поведение, которое видит другая сторона (новый эндпоинт готов, поле стало обязательным, формат даты изменился, эндпоинт нужен фронту);
- безопасность: аутентификация, токены, CSP и capabilities Tauri, хранение секретов, аудит;
- новые термины, ADR, решения из чата, отклонения от плана дорожной карты, блокеры для другой стороны.
---
## 3. Начало сессии
Выполни по порядку и **не начинай писать код, пока не сделал шаги 1–5**:
1. `AGENTS.md` (обычно подгружается сам) и этот файл.
2. `docs/status/shared.md`, `docs/status/<зона>.md` и личные заметки `docs/private/` (если папка есть; если нет — создай `docs/private/notes.md` по шаблону `docs/ai/templates/private-notes.md`).
3. Журнал: последние 5 записей своей зоны и все записи `impact: shared` новее твоей последней записи (`docs/journal/`, имена файлов сортируются по дате).
4. Дорожная карта: `node tools/roadmap-context/roadmap-context.mjs` (текущий шаг) и `... <ID задачи>` для задачи сессии. Подробности и запасные варианты — `docs/ai/roadmap.md`.
5. Git: текущая ветка, `git status`, `git log --oneline -15 origin/main`. Есть ли смерженные PR другой стороны после последнего обновления статуса.
6. Отчитайся пользователю (не больше 10 строк):
- где мы: фаза, шаг, задача и её статус в карте;
- что изменилось с прошлой сессии, в том числе у другой стороны;
- открытые вопросы, блокеры, запросы к этой зоне;
- расхождения между картой, документами и кодом;
- что предлагаешь сделать сейчас.
Задача вне текущего шага, без ID или в статусе «Выполнено» — предупреди и предложи: взять задачу текущего шага, добавить «свой пункт» в карту или записать в бэклог.
---
## 4. Во время работы
- Работа идёт в ветке `feat/<ID>-кратко` (`AGENTS.md`, раздел 6). Запись журнала этой ветки создаётся в первом же коммите и дополняется по ходу.
- **Решение принято в чате** — сразу в раздел «Решения» записи журнала. Значимое (влияет на архитектуру, контракт, безопасность, другую сторону, его дорого отменить) — черновик ADR по шаблону и текст для поля «Решение» в карте.
- **Отклонился от плана** (пункт сделан иначе, не нужен, нужен новый) — раздел «Отклонения от плана» и предложение для карты.
- **Нашёл что-то вне шага** — раздел «Идеи и бэклог», не реализуй.
- **Нужно что-то от другой стороны** — запрос в `docs/status/shared.md` и текст сообщения типа «Вопрос» или «Блокер» для карты.
- **Контракт меняется** — отдельный PR (только контракт + запись `shared`), потом реализация.
- Не держи важное только в чате: если завтра сессия начнётся с нуля, всё нужное должно быть в файлах.
---
## 5. Перед коммитом и в конце сессии
Документация — часть PR. PR без обновлённой документации не готов к ревью.
Чек-лист:
- [ ] Запись журнала ветки обновлена: сделано, решения, проверка, что осталось (`docs/ai/templates/journal-entry.md`).
- [ ] Личное (черновые мысли, на чём остановились, что обсудить с собой) — в `docs/private/notes.md`.
- [ ] `docs/status/<зона>.md` отражает текущее состояние: заменить устаревшее, а не дописать снизу.
- [ ] Если есть impact `shared` — обновлён `docs/status/shared.md` (раздел «Готово для другой стороны» или «Запросы между зонами»).
- [ ] Новый модуль, экран, компонент, паттерн, эндпоинт — описание в документах зоны (`docs/ai/templates/module.md`).
- [ ] Значимое решение — `docs/adr/NNNN-*.md` (`docs/ai/templates/adr.md`), статус «Предложено» до одобрения людьми.
- [ ] Новый термин — `docs/glossary.md`. Новая команда или правило — предложение правки `AGENTS.md`.
- [ ] Секретов, паролей, токенов, внутренних адресов стенда и персональных данных в документах нет.
- [ ] Блок **«Для дорожной карты»** выведен пользователю в чат:
```
Задача: #2.11 → статус: На проверке
Отметить пункты: 2.11.4, 2.11.6
Сообщение (Комментарий/Вопрос/Блокер/Решение): <текст>
Поле «Решение»: <текст, если есть>
Ссылка: PR <URL> (после открытия)
```
Человек переносит это в карту сам. Описание PR можно взять кнопкой «Для PR» в задаче карты.
Документы коммитятся в той же ветке, что и код (`docs(<область>): …` или вместе с кодом), с той же строкой `Refs: <ID>`.
**Коммиты, названия и описания PR — только на русском** (правило в `AGENTS.md`, раздел 6): `тип(область): что сделано`, тип и область латиницей, остальное по-русски, понятно и конкретно. Ассистент сам предлагает сообщение коммита в этом формате и не использует английские шаблоны своего инструмента.
---
## 6. Форматы и размеры
- Язык — русский, термины по `docs/glossary.md`, идентификаторы кода — как в коде.
- Пиши факты: что сделано, где лежит (относительный путь), как проверить. Без воды, пересказа кода и мотивационных фраз.
- `docs/status/*.md` — до 120 строк. Это снимок, не история: выполненное старше одного шага удаляется (оно есть в журнале).
- Запись журнала — до 60 строк. Одна запись на ветку/PR, не на каждый чат.
- Имя записи журнала: `docs/journal/YYYY-MM-DD-<зона>-<ID>-<кратко>.md`, дата — день создания ветки. Пример: `2026-11-20-frontend-2.13-design-tokens.md`.
- Описание модуля — в документах зоны или `docs/architecture/`, если его используют обе стороны.
- Ссылки на задачи — `#ID`, на код — относительный путь, на ADR — `ADR-0008`.
- Дата — `YYYY-MM-DD`, время, если нужно, — UTC.
---
## 7. Конфликты и совместная работа
- Свою зону и свой журнал правит только её владелец, поэтому конфликты возможны только в `shared`-файлах. При конфликте в `docs/status/shared.md` сохраняются записи обеих сторон.
- Пункт в «Запросах между зонами» закрывает тот, кто выполнил: удаляет строку и добавляет запись в «Готово для другой стороны».
- В конце шага (ритм «Конец шага» в карте) один из разработчиков просит ассистента: «подведи итог шага» → ассистент сверяет карту, журнал и код, чистит `docs/status/*`, выдаёт список несовпадений и текст для ретро.
---
## 8. Личные правила разработчика (не в git)
Каждый добавляет в правила своего AI-инструмента (глобальные правила Windsurf/Devin, `~/.config/devin/`, User Rules в Cursor и т.п.) короткий блок. Пример для Frontend:
```
Проект «Штиль». Я — Frontend-разработчик, моя зона: frontend.
В начале каждой сессии выполняй docs/ai/PROTOCOL.md (раздел 3), в конце — раздел 5.
Backend-документацию читай только когда задача касается API/контрактов.
```
Для Backend — то же с зоной `backend`.
Стартовая фраза новой сессии, если правила не настроены:
```
Зона: frontend. Задача: #2.13. Выполни начало сессии по docs/ai/PROTOCOL.md.
```
Конец сессии: `Заверши сессию по docs/ai/PROTOCOL.md (раздел 5).`
+59
View File
@@ -0,0 +1,59 @@
# Сверка с дорожной картой
Дорожная карта — единственный трекер задач команды: https://locshare.ru/roadmap/
AI-ассистент **только читает** её. Изменения в карту вносят люди через интерфейс; ассистент готовит для них текст (блок «Для дорожной карты», `PROTOCOL.md`, раздел 5).
## Основной способ
```
node tools/roadmap-context/roadmap-context.mjs # текущий шаг, статусы задач, последние изменения
node tools/roadmap-context/roadmap-context.mjs 2 # обзор шага 2
node tools/roadmap-context/roadmap-context.mjs 2.11 # задача полностью: описание, вопросы и ответы, решение, пункты, обсуждение, ссылки
node tools/roadmap-context/roadmap-context.mjs --all # всё подробно (много текста, только при подведении итогов шага)
```
План (`data.js`) берётся из `roadmap/data.js` в репозитории, если файл есть, иначе с сервера. Если локальная копия отличается от сервера, скрипт выводит предупреждение — сообщи об этом пользователю. Прогресс всегда берётся с сервера.
Переменные окружения (задаются локально, в git не попадают):
| Переменная | По умолчанию | Назначение |
|---|---|---|
| `ROADMAP_URL` | `https://locshare.ru/roadmap` | Адрес roadmap-server |
| `ROADMAP_AUTH` | — | `логин:пароль` для Basic Auth, когда на сервере включён пароль |
| `ROADMAP_DATA` | `roadmap/data.js` | Путь к локальному плану |
## Что проверять
В начале сессии:
- текущий шаг (`meta.current`) и есть ли задача сессии в этом шаге;
- статус задачи и исполнители: не делает ли её уже другой человек;
- ответы на вопросы `В1…Вn` и поле «Решение» — это решения команды, они обязательны к исполнению;
- незакрытые сообщения «Блокер» и «Вопрос» по задаче;
- «свои пункты» команды — работа, которой нет в плане, но она согласована.
Расхождения, о которых нужно сказать пользователю:
- в коде/журнале пункт сделан, а в карте не отмечен (или наоборот);
- решение в карте противоречит ADR или коду;
- задача «В работе» у другого человека, а мы её трогаем;
- работа идёт по задаче вне текущего шага.
## Как устроены данные (для разбора вручную)
| Запрос | Что возвращает |
|---|---|
| `GET {ROADMAP_URL}/api/health` | `{"revision": N}` — номер ревизии, растёт при каждом изменении |
| `GET {ROADMAP_URL}/api/progress` | JSON `shtil-roadmap-progress/2` — работа команды |
| `GET {ROADMAP_URL}/roadmap/data.js` | Содержание плана: `window.SHTIL_ROADMAP = { meta, areas, types, phases[].steps[].tasks[] }` |
Разделы `progress`: `members` (id → имя, роль), `tasks` (статус `todo/doing/review/done/blocked`, `assignees`, `priority`, `due`), `items` (ID пункта → `done`), `decisions` (статус `open/discuss/accepted/postponed`, `text`), `answers` (ключ `<задача>~<номер вопроса>`), `comments` (`task`, `kind`: `comment/question/proposal/blocker/decision`, `resolved`, `deleted`), `notes`, `custom` (свои пункты), `links`.
**Запрещено:** `POST /api/ops` и любые другие запросы на запись, правка `progress.json`, перенумерация ID в `data.js`.
## Если сервер недоступен
1. Попросить пользователя: «Настройки → Сводка для AI» → скопировать и вставить в чат (или скачать `.md`).
2. Работать по `roadmap/data.js` и `docs/status/*`, явно предупредив, что статусы могут быть устаревшими.
## Раскрытие следующего шага
В конце шага пользователь передаёт ассистенту «Сводку для AI» и комментарий. Ассистент обновляет `roadmap/data.js` по правилам из шапки файла: новые пункты получают следующий свободный номер, «свои пункты» из `custom` переносятся в план новыми ID, `meta.current` и `meta.changelog` обновляются. Это отдельный PR `docs(roadmap): …`.
+22
View File
@@ -0,0 +1,22 @@
# ADR-NNNN: Название решения
- **Статус:** Предложено | Принято | Отклонено | Заменено ADR-NNNN
- **Дата:** YYYY-MM-DD
- **Задача:** #1.5
- **Участники:** Имя, Имя
- **Зоны:** shared | frontend | backend
## Контекст
Какая проблема, какие ограничения и факты. 3–6 предложений.
## Решение
Что решили, конкретно и проверяемо.
## Рассмотренные варианты
| Вариант | Плюсы | Минусы |
|---|---|---|
| | | |
## Последствия
- Что становится проще, что сложнее, что нужно сделать (с ID задач).
- Как понять, что решение пора пересмотреть.
+34
View File
@@ -0,0 +1,34 @@
---
date: YYYY-MM-DD
zone: frontend | backend | shared
task: "2.13"
items: ["2.13.1", "2.13.2"]
branch: feat/2.13-design-tokens
pr: —
impact: none | shared
status: в работе | на проверке | смержено
author: Имя
---
# [2.13] Кратко, что делаем
## Сделано
- Что сделано и где лежит (`путь/к/файлу`). Отмеченный пункт карты — с его ID.
## Решения
- Что решили и почему. Значимое → ADR-NNNN.
## Для другой стороны
<!-- Только при impact: shared. Что изменилось для другой зоны и что ей нужно сделать. Иначе удалить раздел. -->
## Отклонения от плана
<!-- Пункт сделан иначе / не нужен / появился новый. Иначе удалить раздел. -->
## Проверка
- Какие тесты, линтеры, ручные проверки пройдены.
## Осталось
- [ ] Что не доделано в этой ветке.
## Идеи и бэклог
<!-- Найдено вне текущего шага, не делали. Иначе удалить раздел. -->
+22
View File
@@ -0,0 +1,22 @@
# Название модуля / экрана / компонента
- **Зона:** frontend | backend | shared
- **Где в коде:** `путь/`
- **Задачи:** #2.14, #3.2
- **Связанные ADR и документы:** ADR-0008, `docs/architecture/...`
## Назначение
Что делает и чего НЕ делает. 2–4 предложения.
## Как устроено
Ключевые части, поток данных, точки расширения. Схема — если помогает.
## Контракт и зависимости
- Эндпоинты / сообщения proto / таблицы / компоненты `packages/ui`, от которых зависит.
- Права и функции (`perm.*`, `features.*`), которые проверяются.
## Правила и подводные камни
- То, что нельзя нарушать, и то, на чём легко ошибиться.
## Как проверить
- Тесты, команды, ручной сценарий.
+17
View File
@@ -0,0 +1,17 @@
# Личные заметки
Только на этом компьютере (`docs/private/` в `.gitignore`). В Gitea не попадает, второй разработчик не видит.
Всё, что нужно проекту или другой стороне, — в `docs/status`, `docs/journal`, ADR. Секреты здесь не хранить.
## На чём остановились
-
## Мысли и черновики
-
## Договорённости с AI
<!-- Как мне удобнее работать: стиль ответов, что проверять, что не делать без спроса. -->
-
## Обсудить с напарником
-
+56
View File
@@ -0,0 +1,56 @@
# Помощник «Штиль» — функции по фазам
- **Задача:** #1.8.4 · **Статус:** черновик, утверждается решением #1.8.3 → ADR-0005
- Источники: карточка #1.8 (диаграмма), #1.9 (обращения), #1.10 (удалённый доступ)
## Роль и ограничения
Помощник — процесс в сессии пользователя, единственный компонент на устройстве с интерфейсом.
- Прав администратора нет, установки драйверов/служб не требует.
- С сервером напрямую не общается — только с агентом по IPC (named pipe / unix socket, Protobuf).
- Запуск: Windows — агентом при входе пользователя (служба в Session 0 окон не имеет); Linux — XDG autostart, агент контролирует наличие.
- Пункта «Выход» нет; при падении агент перезапускает.
- На серверах не ставится по умолчанию (параметр установки).
- Устанавливается одним инсталлятором с агентом; иконка и название переопределяются конфигом (white-label).
## Фаза 1 — обращения (MVP)
| Функция | Содержание |
|---|---|
| Иконка в трее | Меню: «Сообщить о проблеме», «Мои обращения», «О программе». Без окон при старте; окно создаётся по клику и уничтожается при закрытии |
| Форма обращения | Категории-кнопки: Не печатает · Нет сети/интернета · Медленно работает · Не работает программа · Нужен доступ или ПО · Другое. Описание (обязательно, ≤ 2000), срочность (обычная / срочно — работа стоит), контакт (телефон/кабинет, запоминается) |
| Скриншот | Снимается автоматически, показывается превью, кнопка «Убрать». Организация может отключить политикой |
| Отправка | Помощник → агент по IPC. Агент добавляет автодиагностику и отправляет; без связи копит в своей очереди — у Помощника очереди нет |
| «Мои обращения» | Последние 10: статус и ответы администратора, простая переписка внутри обращения |
| «О программе» | Версия, организация, статус связи с агентом |
## Фаза 2 — удалённый доступ и уведомления
| Функция | Содержание |
|---|---|
| Диалог согласия | Кто подключается и причина. Кнопки: Разрешить / Только просмотр / Отклонить. Нет ответа 30 с — отказ |
| Индикатор сеанса | Красная рамка по краю экрана + панель «К вам подключён {имя} · {время} · Завершить». Пользователь может прервать сеанс в любой момент |
| Захват экрана | По команде агента: служба в Session 0 рабочий стол не видит, снимает только процесс сессии. Передача потока агенту |
| Уведомления | Всплывающие: ответ по обращению, сообщения от администратора, события сеанса удалённого доступа |
## Чего Помощник не делает
- Не хранит данные дольше сессии, не имеет своей БД и очереди.
- Не показывает настроек пользователю (кроме white-label через конфиг агента).
- Не принимает решений по безопасности: показ диалога согласия решает агент по подписанной политике.
- Не работает в Session 0 и без графической сессии.
## Черновой список методов IPC (`proto/helper/v1`)
Для оценки поверхности протокола, детали — в #1.8.5 и позже.
| Метод | Направление | Фаза |
|---|---|---|
| `TicketSubmit` | Помощник → агент | 1 |
| `TicketList` / `TicketReply` | Помощник ↔ агент | 1 |
| `ConsentRequest` / `ConsentResponse` | агент → Помощник → агент | 2 |
| `SessionIndicator` (start/stop) | агент → Помощник | 2 |
| `Notify` | агент → Помощник | 2 |
| `ScreenCapture` (start/stop) | агент → Помощник | 2 |
| `GetState` | Помощник → агент | 1 (статус связи для «О программе») |
+15
View File
@@ -0,0 +1,15 @@
# Backend: документы зоны
Зона `backend` (`docs/ai/PROTOCOL.md`, раздел 2): сервер `shtil-server`, агент `shtil-agent`, БД, окружение, сборка.
Здесь — внутренние правила Backend, которые не нужны Frontend. Всё, что влияет на API, протокол, права, функции, конфиг, — в `shared`.
## Документы
| Файл | О чём | Появится в |
|---|---|---|
| `conventions.md` | Структура `internal/server/<область>`, слои, ошибки, логи, тесты, транзакции | #2.10 |
| `areas/<область>.md` | Область сервера (`access`, `sites`, `audit`…): таблицы, сервисные функции, права, события NATS | по мере появления |
| `agent.md` | Устройство агента: транспорт, сборщики, очередь, исполнитель, платформенные части | шаг 4–5 |
| `operations.md` | Запуск, конфиг, переменные окружения, миграции, диагностика | #2.8 |
Шаблон для областей и модулей — `docs/ai/templates/module.md`. Общая архитектура, ERD, правила БД, IPC — `docs/architecture/` (shared).
+93
View File
@@ -0,0 +1,93 @@
# Как мы работаем с git
Задача #1.2. Кратко для AI — `AGENTS.md`, раздел 6. Здесь — полная версия для людей.
## Главное
- `main` — общая рабочая версия продукта. Всегда собирается и работает. Напрямую в неё не пушим.
- Одна задача — одна короткая ветка (1–3 дня) → PR → ревью второго → **squash**-слияние → ветка удаляется.
- Файлы друг друга получаем только через `main`: после слияния `git pull`.
- Задачи, статусы и обсуждения — в дорожной карте. ID задачи есть в ветке, коммитах и PR.
## Первый запуск
```
git clone https://locshare.ru/TMSH/shtil.git
cd shtil
mise trust && mise install # версии инструментов, docs/environment.md
lefthook install # git-хуки: проверка коммитов и секретов
```
## Ветки
| Вид | Формат | Пример |
|---|---|---|
| Новая функция | `feat/<ID>-кратко` | `feat/2.13-design-tokens` |
| Исправление | `fix/<ID>-кратко` | `fix/2.14-token-refresh` |
| Документы | `docs/<ID>-кратко` | `docs/1.11-information-architecture` |
| Служебное | `chore/<ID>-кратко` | `chore/2.9-ci` |
Имя ветки — латиницей через дефис. Ветка живёт не дольше 3 дней; незаконченное прячется за техническим флагом функции и сливается.
## Коммиты
Формат — Conventional Commits, текст **по-русски**:
```
тип(область): что сделано
Почему так и что важно знать (если нужно).
Refs: 2.11.4
```
- **Типы:** `feat` новое · `fix` исправление · `docs` документы · `refactor` переделка без изменения поведения · `test` тесты · `perf` скорость · `build` сборка · `ci` CI и окружение · `chore` прочее служебное · `style` форматирование · `revert` откат.
- **Области:** `server` `agent` `helper` `console` `ui` `proto` `api` `db` `ci` `docs` `roadmap` `tools` `deps`. Область можно не указывать, если изменение общее.
- Заголовок с маленькой буквы, без точки, до 72 символов, глагол в прошедшем времени: «добавлен», «исправлена», «убрано».
- `Refs:` — ID пунктов дорожной карты через запятую.
- Коммиты маленькие: один коммит — одно законченное изменение.
| Хорошо | Плохо |
|---|---|
| `feat(server): добавлен WithTenantTx для доступа к данным организации` | `правки` |
| `fix(console): исправлен повтор запроса после истечения токена` | `fix bug` |
| `docs(ui): описаны цветовые токены и темы` | `WIP` |
Формат проверяет хук `commit-msg` (`tools/git-hooks/commit-msg.mjs`). Обходить его (`--no-verify`) нельзя.
## Каждый день
```
git switch main && git pull # начало задачи
git switch -c feat/2.13-design-tokens
git add . && git commit # по ходу работы
git fetch && git rebase origin/main # каждое утро и перед PR
git push -u origin feat/2.13-design-tokens # первый раз
git push --force-with-lease # после rebase, только в свою ветку
```
Конфликт при rebase решается у себя: исправить файлы → `git add` → `git rebase --continue`.
## Pull Request
1. Название: `[ID] Что сделано`, по-русски. Описание заполняется по шаблону, текст «Выполнение» можно взять кнопкой «Для PR» в задаче карты.
2. Рецензент — второй разработчик. Ревью — в тот же день.
3. Слияние — кнопкой **squash** (другие способы отключены). Заголовок итогового коммита — как название PR, в формате коммита. Ветка удаляется автоматически.
4. Ссылка на PR — в «Ссылки» задачи карты, отмечены выполненные пункты.
5. Оба делают `git pull` в `main`.
Изменения `api/openapi.yaml`, `proto/`, `migrations/` — отдельным маленьким PR с обсуждением, до реализации.
## Нельзя
- Пушить в `main` и делать `force push` в `main` или чужую ветку.
- Сливать PR без одобрения второго разработчика и при красном CI (после #2.9).
- Редактировать смерженную миграцию — только новая миграция.
- Коммитить секреты, `.env`, ключи. Нашли секрет в истории — сразу сообщить второму, секрет перевыпустить.
## Что не коммитим
Список — в `.gitignore`. Кратко:
- **Секреты:** `.env`, ключи, сертификаты с закрытым ключом, файлы менеджера паролей. Шаблон переменных — только `.env.example` без значений. Пароли стенда — только в менеджере паролей.
- **Личное:** `docs/private/` (заметки с AI), личные настройки AI-инструментов (`.cursor/`, `.windsurf/`, `.claude/`, `*.local.md`), `.mise.local.toml`. Общие правила для AI — только `AGENTS.md` и `docs/ai/`.
- **Данные клиентов и дампы БД:** `*.dump`, `backups/` — там могут быть персональные данные.
- **Прогресс дорожной карты** `roadmap/progress.json` — его хранит roadmap-server в отдельном репозитории.
- **Сборка и зависимости:** `node_modules/`, `target/`, `dist/`, `bin/`, `*.exe`.
Перед коммитом gitleaks проверяет секреты. Если нужный файл попал под `.gitignore` — обсудить, а не добавлять через `git add -f`.
## Версии
- До беты у всех компонентов одна версия репозитория. Тег ставится в конце шага: `v0.1.0` — шаг 2, `v0.2.0`…`v0.8.0` — шаги 3–9, `v0.9.x` — бета, `v1.0.0` — коммерческий релиз.
- `CHANGELOG.md` собирается из коммитов (git-cliff) при постановке тега, поэтому формат коммитов важен.
- Протокол агента версионируется отдельно (`protocol_version`).
+103
View File
@@ -0,0 +1,103 @@
# Окружение разработчика
Задача #1.3. Версии одинаковые у обоих разработчиков и в CI. Источник истины — `.mise.toml` и `rust-toolchain.toml`, этот документ объясняет выбор.
## Версии
Зафиксировано 2026-11-08.
| Инструмент | Версия | Где зафиксирована | Почему эта |
|---|---|---|---|
| Go | 1.27.3 | `.mise.toml` | Последний стабильный выпуск; Go поддерживает две последние версии, патчи безопасности выходят ежемесячно |
| Node.js | 26.13.0 | `.mise.toml` | Active LTS «Lithium», поддержка до апреля 2029 — самая долгая из доступных |
| pnpm | 12.17.0 | `.mise.toml` | Последняя мажорная, выпуску больше 7 дней |
| Task | 3.54.0 | `.mise.toml` | Последний стабильный |
| lefthook | 2.2.2 | `.mise.toml` | Git-хуки: формат коммитов, gofmt, gitleaks (`lefthook.yml`) |
| gitleaks | 8.30.1 | `.mise.toml` | Поиск секретов перед коммитом |
| Rust | 1.99.1 | `rust-toolchain.toml` | Последний stable; `rustup` ставит его сам при первой сборке в папке проекта |
| Tauri | 2.x (CLI 2.12.4) | `package.json` приложений (#2.14) | Стабильная ветка. Tauri 3 пока alpha — не используем |
| mise | 2026.10.25 | вручную | Менеджер версий, ставит Go, Node, pnpm, Task по `.mise.toml` |
| Docker | 29.x | вручную | Для `deploy/dev` (PostgreSQL, NATS, MinIO, Mailpit) |
Правила:
- Обновление версии — отдельным PR `chore(ci): …` с правкой этой таблицы. Оба обновляются в тот же день.
- Новые версии берём не раньше чем через 7 дней после выхода (кроме срочных исправлений безопасности).
- Не используем alpha, beta, rc и версии Node без LTS (нечётные).
- Версии фронтенд-библиотек (Vue, Vite, TypeScript, Tailwind, Reka UI) фиксируются в `pnpm-lock.yaml` в шаге 2 (#2.14).
## Установка на Windows
1. **Системные программы** (один раз):
- Git, Docker Desktop (с WSL2);
- Visual Studio 2022 Build Tools или Community с компонентом «Desktop development with C++»;
- WebView2 Runtime (в Windows 11 уже есть);
- Rust через `rustup` (https://rustup.rs).
2. **mise**: скачать `mise-v<версия>-windows-x64.zip` из релизов `jdx/mise` на GitHub, сверить SHA256 с `SHASUMS256.txt`, распаковать `mise.exe` и `mise-shim.exe` в `%LOCALAPPDATA%\mise\bin`.
3. **PATH пользователя**: добавить в начало `%LOCALAPPDATA%\mise\shims` и `%LOCALAPPDATA%\mise\bin`.
4. **Подключить mise в терминалах** — иначе системные Node и Go, установленные в `C:\Program Files`, перекрывают версии проекта:
- PowerShell (`$PROFILE`):
```powershell
$env:MISE_PWSH_CHPWD_WARNING = 0 # только для Windows PowerShell 5.1
(& "$env:LOCALAPPDATA\mise\bin\mise.exe" activate pwsh) | Out-String | Invoke-Expression
```
- Git Bash (`~/.bashrc`):
```bash
eval "$("$LOCALAPPDATA/mise/bin/mise.exe" activate bash)"
```
5. **В папке проекта**:
```
mise trust
mise install
lefthook install
```
6. **VS Code**: открыть проект и поставить рекомендуемые расширения (`.vscode/extensions.json`).
7. **Перезапустить редактор и терминалы.**
## Установка на Linux (Astra 1.8 / Debian 12)
```bash
sudo apt install build-essential curl git libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev libssl-dev
curl https://sh.rustup.rs -sSf | sh
curl https://mise.run | sh # затем подключить: eval "$(~/.local/bin/mise activate bash)" в ~/.bashrc
cd shtil && mise trust && mise install && lefthook install
```
## Проверка
В папке проекта (новый терминал):
```
node -v # v26.13.0
pnpm -v # 12.17.0
go version # go1.27.3
task --version # 3.54.0
rustc --version # 1.99.1
```
### Проверка #1.3.9: «hello world» Tauri и Go
Делается в `tmp/` (папка в `.gitignore`), чтобы версии Node и Rust брались из настроек проекта. В git ничего не попадает.
**Tauri** (первая сборка 5–10 минут — компилируются зависимости Rust):
```bash
mkdir -p tmp && cd tmp
pnpm dlx create-tauri-app@4.7.5 hello-tauri --manager pnpm --template vue-ts --identifier ru.tbsoft.shtil.hello --yes
cd hello-tauri && pnpm install
pnpm tauri build --bundles nsis # Linux: --bundles deb
```
Готово, если собрался `src-tauri/target/release/hello-tauri(.exe)`, установщик в `src-tauri/target/release/bundle/` и приложение открывает окно.
**Go:**
```bash
mkdir -p tmp/hello-go && cd tmp/hello-go && go mod init hello
# main.go: package main; import "fmt"; func main() { fmt.Println("hello") }
go build -o hello.exe . # Windows
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o hello-linux . # Linux
```
**Результаты:**
| Кто | ОС | Tauri | Go | Дата |
|---|---|---|---|---|
| Frontend | Windows 11 | ✓ exe 4,2 МБ, установщик NSIS 1,4 МБ, окно открывается | ✓ windows/amd64, ✓ сборка linux/amd64 | 2026-11-08 |
| Frontend | Linux | — нужна машина #1.3.7 | запуск linux-бинарника — на машине #1.3.7 | — |
| Backend | Windows | — | — | — |
| Backend | Linux | — | — | — |
+25
View File
@@ -0,0 +1,25 @@
# Frontend: документы зоны
Зона `frontend` (`docs/ai/PROTOCOL.md`, раздел 2): приложение «Штиль» (`apps/console`), «Штиль Помощник» (`apps/helper`), дизайн-система `packages/ui`.
Здесь — внутренние правила Frontend, которые не нужны Backend. Всё, что влияет на API, права, функции, безопасность Tauri, — в `shared`.
## Документы
| Файл | О чём | Появится в |
|---|---|---|
| `design-system.md` | Токены (цвета, отступы, радиусы, тени), темы, типографика, иконки, правила вёрстки | #2.13 |
| `components.md` | Каталог компонентов `packages/ui`: назначение, варианты, когда какой использовать | #2.13 |
| `conventions.md` | Структура `src/`, именование, состояние (Pinia / TanStack Query), роутинг, i18n, обработка ошибок API | #2.14 |
| `platform-layer.md` | Слой `src/platform/`: Tauri API, хранилище ключей, профили серверов | #2.14 |
| `screens/<экран>.md` | Экран: назначение, данные, права, состояния (загрузка, пусто, ошибка) | по мере появления |
Шаблон для экранов и модулей — `docs/ai/templates/module.md`. Информационная архитектура и макеты (общие для обеих сторон) — `docs/ux/`.
## Исходные данные из дорожной карты (до решений #1.11 и #2.13)
Это рекомендации карты, а не принятые решения. После решения перенести в `design-system.md` и удалить отсюда.
- Шрифты Unbounded, Manrope, JetBrains Mono — локально, без CDN. Иконки — Lucide.
- Темы светлая и тёмная, по умолчанию — системная. Минимальный размер окна 1280×720.
- Меню ≤ 11 пунктов в 3 группах: Работа · Управление · Аналитика. Недоступное по правам или редакции скрыто.
- Селектор области (подразделения) фильтрует весь экран. Карточки — в боковой панели. Ctrl+K — поиск и команды.
- Помощник: при старте только иконка в трее, окно создаётся по клику и уничтожается при закрытии; цели ≤ 40 МБ ОЗУ в покое, ≤ 150 МБ с окном, открытие ≤ 1 с.
@@ -0,0 +1,37 @@
---
date: 2026-11-08
zone: shared
task: "1.2"
items: []
branch: chore/1.2-ai-docs-protocol
pr: —
impact: shared
status: в работе
author: Frontend
---
# [1.2] Система документирования для AI-ассистентов
## Сделано
- Протокол работы AI: `docs/ai/PROTOCOL.md` — источники истины, зоны frontend/backend/shared, чек-листы начала и конца сессии.
- Сверка с дорожной картой: `docs/ai/roadmap.md` и скрипт `tools/roadmap-context/roadmap-context.mjs` (Node 18+, без зависимостей, только чтение).
- Шаблоны: `docs/ai/templates/` — запись журнала, ADR, описание модуля.
- Снимки состояния: `docs/status/shared.md`, `frontend.md`, `backend.md`.
- Индексы зон: `docs/frontend/README.md`, `docs/backend/README.md`; карта документации `docs/README.md`.
- `AGENTS.md`: раздел 9 «Документирование и контекст».
## Решения
- Дорожная карта остаётся единственным трекером; AI её только читает и готовит текст для людей.
- Память проекта для AI — `docs/status` (снимок) + `docs/journal` (история по PR), документация коммитится в той же ветке, что и код.
- Внутренние документы зоны в `docs/frontend` и `docs/backend`; ассистент другой зоны их не читает без необходимости.
## Для другой стороны
- Backend: прочитать `docs/ai/PROTOCOL.md`, добавить личный блок правил с `зона: backend` (раздел 8).
## Проверка
- `node tools/roadmap-context/roadmap-context.mjs` и `... 1.2` против https://locshare.ru/roadmap/ — сводка выводится.
## Осталось
- [ ] Обсудить протокол вдвоём, при необходимости поправить.
- [ ] Перенести в репозиторий Gitea вместе с остальными файлами (#1.2.3).
- [ ] Включить пароль на roadmap-server (#1.1.2): сейчас `/api/progress` читается без авторизации.
@@ -0,0 +1,36 @@
---
date: 2026-11-08
zone: shared
task: "1.2"
items: ["1.2.8", "1.2.9", "1.2.10", "1.13.4"]
branch: feat/1.2-git-rules
pr: —
impact: shared
status: на проверке
author: Frontend
---
# [1.2] Правила git, шаблон PR, хуки
## Сделано
- `docs/contributing.md` — ветки, коммиты по-русски, ежедневный цикл, PR, запреты, версии.
- `.gitea/pull_request_template.md` — описание PR: задача, что сделано, как проверить, чек-лист безопасности и документации.
- `lefthook.yml` + `tools/git-hooks/commit-msg.mjs` — проверка формата коммита, `gofmt` для Go, `gitleaks` для секретов.
- `.mise.toml`: lefthook 2.2.2, gitleaks 8.30.1.
- Настройки Gitea: разрешён только squash, ветки удаляются после слияния (#1.2.7).
## Решения
- Область в заголовке коммита необязательна, но если указана — только из списка.
- `Refs:` обязателен в каждом коммите (кроме Merge/Revert/fixup).
- prettier подключается в #2.7.2, когда появится pnpm-workspace.
## Для другой стороны
- После `git pull`: `mise install && lefthook install`. Без `lefthook install` хуки не работают.
## Проверка
- `commit-msg.mjs`: корректные сообщения проходят; «правки», английский текст, заглавная буква, без `Refs:`, неизвестная область — отклоняются.
- `lefthook run pre-commit` с тестовым токеном в индексе — gitleaks нашёл утечку и остановил коммит.
## Осталось
- [ ] prettier в pre-commit (#2.7.2).
- [ ] Default merge style в Gitea — «Создать объединённый коммит».
@@ -0,0 +1,37 @@
---
date: 2026-11-08
zone: shared
task: "1.3"
items: ["1.3.1", "1.3.2", "1.3.3", "1.3.4", "1.3.5", "1.3.6", "1.3.8"]
branch: feat/1.3-dev-environment
pr: —
impact: shared
status: на проверке
author: Frontend
---
# [1.3] Окружение разработчика: версии инструментов
## Сделано
- `.mise.toml`: Go 1.27.3, Node 26.13.0 (LTS), pnpm 12.17.0, Task 3.54.0.
- `rust-toolchain.toml`: Rust 1.99.1 с rustfmt и clippy.
- `.vscode/extensions.json`: Go, Vue, rust-analyzer, Tauri, ESLint, Tailwind, EditorConfig.
- `docs/environment.md`: таблица версий с причинами выбора, установка на Windows и Linux, проверка.
- У Frontend-разработчика (Windows) окружение установлено и проверено: mise 2026.10.25, Docker 29.1, VS 2022 C++, WebView2.
## Решения
- Node 26 LTS вместо 22/24: самая долгая поддержка (до 04.2029).
- Tauri остаётся на 2.x, Tauri 3 alpha не используем.
- Новые версии — не раньше 7 дней после выхода; обновление отдельным PR.
- Tauri CLI не ставится глобально, фиксируется в `package.json` приложений (#2.14).
## Для другой стороны
- Максиму: `git pull`, затем по `docs/environment.md` поставить mise, подключить его в терминале, `mise trust && mise install`.
- На Windows системные Node и Go из `C:\Program Files` перекрывают mise, если не подключить `mise activate` в профиле терминала.
## Проверка
- `node -v`, `pnpm -v`, `go version`, `task --version`, `rustc --version` в папке проекта показывают зафиксированные версии (Git Bash и PowerShell).
## Осталось
- [ ] #1.3.7 Linux-машина или VM для сборки.
- [ ] #1.3.9 hello world Tauri и Go под Windows и Linux у обоих.
@@ -0,0 +1,33 @@
---
date: 2026-11-08
zone: shared
task: "1.3"
items: []
branch: feat/1.3-hello-world
pr: —
impact: shared
status: на проверке
author: Frontend
---
# [1.3] Проверка окружения: hello world Tauri и Go
## Сделано
- Tauri 2 (шаблон Vue + TS, `create-tauri-app` 4.7.5, CLI 2.12.4, Rust 1.99.1) собран на Windows 11: `hello-tauri.exe` 4,2 МБ, установщик NSIS 1,4 МБ, окно открывается. Первая сборка — 6 мин 18 с.
- Go 1.27.3: hello world собран и запущен на Windows, кросс-сборка под linux/amd64 проходит (ELF).
- Инструкция и таблица результатов — `docs/environment.md`, раздел «Проверка #1.3.9».
## Решения
- Проверка делается в `tmp/` (в `.gitignore`), пробный код в репозиторий не попадает. Настоящий каркас приложения — #2.14.
## Для другой стороны
- Максиму повторить проверку по `docs/environment.md` и вписать результат в таблицу.
- Шаблон `create-tauri-app` ставит TypeScript 6 и Vite 8; версии фронтенд-библиотек выбираем в #2.14.
## Проверка
- Запуск `hello-tauri.exe`: окно «hello-tauri» открылось, процесс корректно завершён.
- Предварительно ОЗУ: процесс приложения ~30 МБ, процессы WebView2 ~337 МБ (рабочий набор, включает общую память). Точный замер с private working set — в PoC #1.8.1–1.8.2.
## Осталось
- [ ] Сборка Tauri и запуск Go-бинарника под Linux — после появления машины #1.3.7.
- [ ] Проверка у Максима (Windows и Linux).
@@ -0,0 +1,39 @@
---
date: 2026-11-09
zone: frontend
task: "1.8"
items: ["1.8.1", "1.8.2"]
branch: feat/1.8-helper-tray-poc
pr: —
impact: shared
status: на проверке
author: Frontend
---
# [1.8] PoC Помощника: Tauri только с иконкой в трее
## Сделано
- `poc/helper-tray/` — Tauri 2 приложение только с иконкой в трее: `app.windows: []`, трей с меню из трёх пунктов, окна создаются через `WebviewWindowBuilder` и уничтожаются при закрытии, `prevent_exit` только при `code.is_none()` (иначе `app.exit(0)` блокируется). Форма «Сообщить о проблеме» по прототипу (категории, описание, «Отправить» без отправки).
- Замер времени открытия — команда `first_paint` по invoke после двойного rAF (capability с пустым `permissions` на `win-*`).
- `poc/helper-tray/measure.ps1` + флаг `--measure-scenario`: сценарий 30 с покой → окно → 10 с → закрыть → 10 с → повтор → закрыть; отметки этапов в `helper-tray-poc.measure.log` (рядом с exe или в `%TEMP%`), скрипт снимает **PrivateBytes** и WorkingSetPrivate дерева процессов.
- Замеры Windows 11 (release, 5 прогонов, медиана): покой **2,0 МБ PB**, окно **155,3 МБ PB** (цель 150 — не дотянуто ~5 МБ), после закрытия **5,2 МБ PB**, открытие **580/555 мс**. Таблица и выводы — `docs/research/helper-tray-poc.md`.
- `AGENTS.md` раздел 5: добавлена строка про `poc/`.
## Решения
- Пункты «Мои обращения» и «О программе» открывают окно-заглушку через ту же фабрику — иначе меню выглядело бы сломанным.
- Команды приложения в Tauri 2.12 не входят в ACL: для `first_paint` отдельного permission нет, capability окон с пустым `permissions`.
- Решающая метрика ОЗУ — PrivateBytes: WorkingSetPrivate у простаивающих процессов занижен Windows.
- CSP: `connect-src ipc: http://ipc.localhost` — иначе на Linux/macOS IPC уходит в postMessage-запасной режим.
## Для другой стороны
- Максиму: повторить замер на Astra 1.8, когда будет VM (#1.12.5). Инструкция — `docs/research/helper-tray-poc.md` (measure.ps1 Windows-only, для Linux PSS/`smem`).
- Замеры нужны для ADR-0005 (#1.8.3) — решение принимаем вместе, сам по себе PoC технологию не выбирает.
## Проверка
- `pnpm tauri build` release — чисто, без предупреждений. `vue-tsc --noEmit`, `cargo clippy`, `cargo fmt --check` проходят.
- `measure.ps1` 5 прогонов — сценарий доходит до `stage done`, приложение завершается само во всех прогонах (`app.exit(0)` не блокируется).
- Ручной проклик меню трея не автоматизирован: `open_window` проверена сценарием замера, обработчик меню вызывает ту же функцию. Предупреждение о postMessage-запасном IPC проверить в devtools можно только вручную — на Windows IPC идёт через `window.ipc.postMessage` и не зависит от `connect-src`.
## Осталось
- [ ] Замер на Astra 1.8 — Максим, VM #1.12.5.
- [ ] После ADR-0005 папку `poc/` удалить.
@@ -0,0 +1,33 @@
---
date: 2026-11-11
zone: frontend
task: "1.8"
items: ["1.8.4", "1.8.5"]
branch: feat/1.8-helper-functions
pr: —
impact: shared
status: смержено
author: Frontend
---
# [1.8] Функции Помощника по фазам и черновик ADR-0005
## Сделано
- `docs/architecture/helper.md` — список функций Помощника по фазам (#1.8.4): роль и ограничения, фаза 1 (обращения), фаза 2 (удалённый доступ, уведомления, захват экрана), границы, черновой список методов IPC.
- `docs/adr/0005-agent-and-helper.md` — черновик ADR-0005 со статусом «Предложено» (#1.8.5): архитектура «агент + Помощник», варианты технологии с результатами PoC. Решение по технологии открыто — ждёт замер на Astra 1.8 (#1.8.3, В1).
## Решения
- Захват экрана отнесён к Помощнику (фаза 2): агент в Session 0 рабочий стол не видит, снимать экран может только процесс в сессии пользователя — по команде агента.
- Локальная очередь обращений живёт в агенте, не в Помощнике: Помощник без прав, хранить данные дольше сессии не должен.
- Всплывающие уведомления — фаза 2 (по карте); в фазе 1 статусы и ответы видны в «Мои обращения».
## Для другой стороны
- Максиму: посмотреть черновой список методов IPC в конце `docs/architecture/helper.md` — это заготовка под `proto/helper/v1`.
- ADR-0005 в статусе «Предложено» — финальное решение после замера на Astra 1.8 (#1.8.3).
## Проверка
- Документы, кода нет. Сверено с картой: #1.8 (диаграмма, вопросы В2–В5), #1.9 (поля формы, автодиагностика), #1.10 (режимы доступа, диалог согласия, индикатор).
## Осталось
- [ ] Ответы на вопросы В1–В5 и решение в #1.8.3 — после замера Максима на Astra 1.8 (VM #1.12.5).
- [ ] ADR-0005 перевести в «Принято» при записи решения (#1.8.5).
@@ -0,0 +1,35 @@
---
date: 2026-11-15
zone: frontend
task: "1.9"
items: ["1.9.5", "1.9.6", "1.9.7"]
branch: feat/1.9-user-tickets
pr: —
impact: shared
status: в работе
author: Frontend
---
# [1.9] Обращения: ADR-0006 и макет окна Помощника
## Сделано
- `docs/adr/0006-user-tickets.md` — черновик ADR-0006 со статусом «Предложено» (#1.9.6): сценарий обращения, поля формы, статусы, маршрутизация, правила скриншотов, переписка и подтверждение «Решено».
- `docs/ux/helper-window.html` — макет окна Помощника (#1.9.7): живая HTML-страница по прототипу — форма с категориями, описанием со счётчиком, автоскриншотом с превью и «Убрать»; «Мои обращения» со статусами, перепиской и подтверждением «Решено»; «О программе».
- Правки записи журнала ветки 1.8-functions: статус «смержено».
## Решения (по ответам в карточке 1.9)
- Описание обязательно, до 1000 знаков (изначально в карте 2000 — сократили, чтобы не писали простыни).
- Поля «срочность» нет: приоритет ставит администратор при обработке — пользователи всегда ставят «срочно».
- Переписка — комментарии внутри обращения, не отдельный чат; ответ после «Решено» в течение 3 дней переоткрывает.
- Кнопка «Решено» у пользователя — политика организации, по умолчанию включена.
- Скриншоты: хранение 30 дней, доступ по `tickets.manage`, отключение политикой (#1.9.5).
## Для другой стороны
- Максиму: ADR-0006 фиксирует автодиагностику и очередь на агенте — это его реализация на шаге 6.
## Проверка
- Макет открыт в браузере и проверен вручную; документы сверены с ответами в карточке 1.9.
## Осталось
- [ ] Решение 1.9 перевести в «Принято» и ADR-0006 в «Принято» после ревью.
- [ ] Макет окна согласовать с Максимом (он часть результата шага 1).
+8
View File
@@ -0,0 +1,8 @@
# Журнал работы
Одна запись на ветку/PR. Шаблон — `docs/ai/templates/journal-entry.md`, правила — `docs/ai/PROTOCOL.md`.
- Имя: `YYYY-MM-DD-<зона>-<ID>-<кратко>.md`, дата — день создания ветки.
- `zone` — чья работа; `impact: shared` — запись обязательна к прочтению другой стороной.
- Запись правит только её автор. Смерженную запись не переписывают; исправление — новой записью.
- Ассистент в начале сессии читает последние 5 записей своей зоны и все `impact: shared` новее своей последней записи.
+148
View File
@@ -0,0 +1,148 @@
# PoC «Штиль Помощник»: Tauri только с иконкой в трее
Задачи #1.8.1–1.8.2, задел для решения ADR-0005 (выбор технологии Помощника — #1.8.3).
Код — `poc/helper-tray/`. Папка `poc/` временная: после принятия ADR-0005 удаляется.
## Что проверяем
Рекомендация карты: Tauri 2 в режиме «только трей» — при старте окно не создаётся,
WebView не запускается; окно создаётся по клику и уничтожается при закрытии.
Цели из дорожной карты:
| Метрика | Цель |
|---|---|
| ОЗУ в покое (только трей) | ≤ 40 МБ |
| ОЗУ с открытым окном | ≤ 150 МБ |
| Время открытия окна | ≤ 1 с |
Если цели не достигаются — запасной вариант: трей на Go + окно Tauri по запросу.
## Как устроен PoC
- `src-tauri/tauri.conf.json`: `app.windows: []` — окна при старте нет; строгий CSP
(`default-src 'self'; style-src 'self' 'unsafe-inline'; connect-src ipc: http://ipc.localhost`
— последнее нужно IPC по кастомному протоколу на Linux/macOS, иначе Tauri
переходит на postMessage-запасной вариант); identifier `ru.tbsoft.shtil.helper.poc`.
- `src-tauri/src/lib.rs`:
- трей (`tray-icon`) с меню «Сообщить о проблеме» / «Мои обращения» / «О программе»;
пункт «Выход» есть только в debug-сборке (`cfg!(debug_assertions)`);
- каждый пункт создаёт окно через `WebviewWindowBuilder` с меткой `win-<view>-<n>`;
закрытие окна уничтожает его (не `hide`), повторный клик — новое окно;
- `RunEvent::ExitRequested` → `prevent_exit()` только при `code.is_none()`:
закрытие последнего окна не завершает приложение в трее, а программный
`app.exit(0)` (сценарий замера, «Выход (debug)») работает;
- замер времени открытия: `Instant` перед `build()` окна → фронтенд после
`mounted` + двойной `requestAnimationFrame` (вторая рамка = первая уже
отрисована) вызывает команду `first_paint` → разница в мс пишется в лог.
Команды приложения не входят в ACL, плагинов нет — capability окон `win-*`
имеет пустой `permissions`;
- флаг `--measure-scenario` (только для замера): приложение по таймеру делает
30 с покоя → открывает окно → 10 с → закрывает → 10 с → открывает повторно →
10 с → закрывает и завершается. Отметки этапов пишутся в
`helper-tray-poc.measure.log` (рядом с exe, при недоступности — в `%TEMP%`)
за ~1,5 с до действия, чтобы скрипт успел снять ОЗУ.
- `src/App.vue`: форма по прототипу — кнопки-категории, поле описания, кнопка
«Отправить» (отправки нет). «Мои обращения» и «О программе» — заглушки.
- `measure.ps1`: запускает exe с `--measure-scenario`, читает отметки из лога,
снимает два счётчика дерева процессов (приложение + все дочерние
`msedgewebview2.exe`, по цепочке родителей и по user-data-dir в командной
строке) из `Win32_PerfFormattedData_PerfProc_Process`:
- **PrivateBytes** — committed private memory. **Решение принимаем по ней:**
Windows урезает рабочий набор у простаивающих процессов, поэтому
WorkingSetPrivate для покоя занижен;
- **WorkingSetPrivate** — private working set, для справки.
5 прогонов, медиана и разброс.
## Сборка и запуск
Версии инструментов — `docs/environment.md`.
```bash
cd poc/helper-tray
pnpm install
pnpm tauri build # release-сборка: exe и установщики в src-tauri/target/release/
# без установщиков быстрее: pnpm tauri build --no-bundle
```
Запуск: `src-tauri/target/release/helper-tray.exe` — появляется только иконка
в трее, окна нет. В release-режиме выхода из меню нет: завершение — через
диспетчер задач или `taskkill /IM helper-tray.exe /F`.
Разработка: `pnpm tauri dev` (в debug-сборке есть пункт «Выход (debug)»).
### Linux (Astra 1.8 / Debian 12)
Зависимости из `docs/environment.md` (включая `libayatana-appindicator3-dev`).
Дальше те же `pnpm install` и `pnpm tauri build`. Примечания:
- иконка в трее требует работающего AppIndicator/StatusNotifier (в Astra —
через расширение трея, если трей пустой — это ограничение среды, не PoC);
- `measure.ps1` — только Windows. Для Linux замер вручную: запуск с
`--measure-scenario`, в моменты отметок лога снять PSS дерева процессов
(`smem -P <pid>` или сумма `Private_*` из `/proc/<pid>/smaps_rollup`
по дереву `pstree -p <pid>`). Строку для результатов см. в таблице.
## Методика замера (как в задании)
- Только release-сборка. Каждый замер — 5 прогонов сценария, в отчёт — медиана
и разброс (min–max).
- ОЗУ в покое — через 30 с после старта, до первого окна.
- ОЗУ с открытым окном — через 10 с после открытия.
- ОЗУ после закрытия окна — через 10 с (проверка освобождения).
- Время открытия — холодное (первое окно) и тёплое (повторное), из лога.
- ОЗУ — **PrivateBytes** всего дерева процессов (решающая метрика) и
WorkingSetPrivate для справки. Обычный working set завышает цифру на общую
память WebView2, а private working set занижает её для простаивающих
процессов — Windows вытесняет их страницы.
## Результаты
ОС: Windows 11 · машина Frontend-разработчика · дата: 2026-11-09 · сборка release.
PB — PrivateBytes (решающая метрика), WS — WorkingSetPrivate (для справки).
| Метрика | Цель | Медиана (5 прогонов) | Разброс | Итог |
|---|---|---|---|---|
| ОЗУ в покое, PB | ≤ 40 МБ | 2,0 МБ | 2,0 – 2,0 | ✅ |
| ОЗУ в покое, WS | — | 1,5 МБ | 1,5 – 1,5 | — |
| ОЗУ с окном, PB | ≤ 150 МБ | 155,3 МБ | 154,9 – 158,3 | ⚠ +4 % к цели |
| ОЗУ с окном, WS | — | 97,3 МБ | 96,9 – 100,3 | — |
| ОЗУ после закрытия, PB | освобождение | 5,2 МБ | 5,0 – 5,2 | ✅ |
| ОЗУ после закрытия, WS | — | 3,6 МБ | 3,5 – 3,6 | — |
| Открытие окна, холодное | ≤ 1 с | 580 мс | 570 – 622 | ✅ |
| Открытие окна, тёплое | ≤ 1 с | 555 мс | 540 – 648 | ✅ |
| ОЗУ повторного окна, PB | — | 157,4 МБ | 155,6 – 160 | — |
| ОС | Покой, PB | Окно, PB | После закрытия, PB | Открытие хол./тёпл. | Дата |
|---|---|---|---|---|---|
| Windows 11 | 2,0 МБ | 155,3 МБ | 5,2 МБ | 580 / 555 мс | 2026-11-09 |
| Astra 1.8 | — ждём VM #1.12.5 — | | | | |
## Выводы
- Покой и скорость открытия — с большим запасом: **2,0 МБ PB** (цель ≤ 40),
открытие **~0,58 с** (цель ≤ 1 с). «Только трей» реально не запускает
WebView2 до первого окна — 2 МБ это весь процесс.
- Окно по решающей метрике **155,3 МБ PB — на ~4 % выше цели 150 МБ**
(по WorkingSetPrivate — 97 МБ и цель формально выполнена). Это честный
предел WebView2 на Windows 11: private bytes включают зарезервированную,
но не вытянутую память рендерера. Обсуждение того, насколько цель жёсткая
и считаем ли проходом, — в #1.8.3.
- `destroy()` при закрытии освобождает память полностью — через 10 с остаётся
~5,2 МБ PB самого процесса.
- Холодное и тёплое открытие почти не различаются (~0,6 с); повторное окно по
памяти такое же (~157 МБ PB).
- Для ADR-0005: на Windows 11 режим «Tauri только трей» выполняет цели по
покою и скорости и не дотягивает ~5 МБ по окну. Запасной вариант «трей на
Go + окно Tauri» по памяти окна ничего не даст — окно в обоих вариантах на
Tauri/WebView2, выигрыш был бы только в покое, а там уже 2 МБ.
Решающий фактор — повторение замера на Astra 1.8 (WebKitGTK): Максим, после
появления VM #1.12.5.
- Что переносить в Помощник при выборе Tauri: паттерн `app.windows: []` +
`prevent_exit` при `code.is_none()`, фабрика окон с `destroy`, замер
`first_paint` (двойной rAF → invoke), пустой `permissions` у capability,
строгий CSP с `connect-src ipc: http://ipc.localhost`, меню без «Выход».
## Что PoC не делает (вне задания)
Нет IPC с агентом, отправки обращений, уведомлений, i18n, дизайн-системы,
автозапуска, установщика-поставки. Решение по технологии Помощника принимается
в #1.8.3 совместно с Backend — по этим замерам.
+24
View File
@@ -0,0 +1,24 @@
# Состояние: Backend
Обновлено: 2026-11-08 · Владелец: Backend-разработчик
Снимок, а не история. Внутренние правила зоны — `docs/backend/`.
## Сейчас
- Кода нет. Впереди в шаге 1: Gitea и правила Git (#1.2), решения 1.4–1.7, тестовый стенд (#1.12).
## Сделано в текущем шаге
- —
## В работе
<!-- - #ID · ветка · что осталось -->
- —
## Ждём от Frontend
- —
## Ближайшее
- —
## Известные проблемы и долги
- —
+33
View File
@@ -0,0 +1,33 @@
# Состояние: Frontend
Обновлено: 2026-11-15 · Владелец: Frontend-разработчик
Снимок, а не история. Внутренние правила зоны — `docs/frontend/`.
## Сейчас
- Кода продукта нет. Окружение готово, Tauri 2 собирается на Windows.
- PoC Помощника собран и замерен: цели подтверждены на Windows 11.
## Сделано в текущем шаге
- #1.2 правила git, шаблон PR, хуки, личные заметки `docs/private/`.
- #1.3 версии инструментов; hello world Tauri и Go на Windows (#1.3.9, часть Frontend/Windows).
- #1.8.1–1.8.2 PoC трея Помощника (`poc/helper-tray/`): покой 2,0 МБ PB, окно 155,3 МБ PB (цель 150 не дотянута ~5 МБ), открытие ~0,58 с. Замеры — `docs/research/helper-tray-poc.md`. PR #8 смержен.
- #1.8.4 список функций Помощника по фазам — `docs/architecture/helper.md`; черновик ADR-0005 «Предложено» — `docs/adr/0005-agent-and-helper.md`. PR #9 смержен.
- #1.9.6 черновик ADR-0006 — `docs/adr/0006-user-tickets.md`; #1.9.7 макет окна Помощника — `docs/ux/helper-window.html`.
## В работе
<!-- - #ID · ветка · что осталось -->
- #1.9 · `feat/1.9-user-tickets` · ADR-0006 и макет окна; осталось — ревью и «Принято»
- #1.8 · осталось — замер на Astra 1.8 (Максим, #1.12.5) и решение в #1.8.3
- #1.4 · без ветки · обсуждение поддерживаемых ОС (взял в работу)
## Ждём от Backend
- Linux-сборка hello world (#1.3.9) и замер PoC на Astra 1.8 (#1.8.1–1.8.2), когда будет VM #1.12.5.
## Ближайшее
- #1.8.3–1.8.5 решение по Помощнику и ADR-0005 (вместе с Максимом).
- Информационная архитектура и макеты (#1.11).
## Известные проблемы и долги
- Замер рабочего набора hello world (~337 МБ) оказался завышенным на общую память — PrivateBytes окна в PoC ~155 МБ (WS ~97 МБ).
- `poc/` временная, удаляется после ADR-0005.
+39
View File
@@ -0,0 +1,39 @@
# Состояние: общее (shared)
Обновлено: 2026-11-15 · Шаг 1 «Решения и подготовка» · Версия —
Снимок, а не история. Правила — `docs/ai/PROTOCOL.md`, разделы 2 и 6.
## Сейчас
- Продуктового кода нет. Идёт шаг 1: решения, Gitea, окружение, макеты.
- Дорожная карта на сервере работает (#1.1 выполнено).
- Введена система документирования для AI: `docs/ai/`, `docs/status/`, `docs/journal/`, `tools/roadmap-context/`.
## Контракты
| Контракт | Состояние | Последнее изменение |
|---|---|---|
| `api/openapi.yaml` | нет, шаг 2 (#2.5) | — |
| `proto/agent/v1`, `proto/helper/v1` | нет, шаг 2 (#2.6) | — |
| `migrations/` | нет, шаг 2 (#2.11) | — |
| Каталог функций `docs/features.md` | нет, шаг 2 (#2.3) | — |
## Принятые решения (кратко, со ссылкой)
- —
## Окружение
- Go 1.27.3 · Node 26.13.0 LTS · pnpm 12.17.0 · Task 3.54.0 · Rust 1.99.1 · Tauri 2.x — `docs/environment.md` (#1.3).
## Готово для другой стороны
<!-- Формат: - YYYY-MM-DD · зона → зона · что готово · где (путь, эндпоинт, ADR) -->
- 2026-11-08 · frontend → backend · правила git (`docs/contributing.md`), шаблон PR, хуки lefthook: после `git pull` выполнить `mise install && lefthook install`
- 2026-11-08 · frontend → backend · версии инструментов зафиксированы: `git pull`, `mise trust && mise install` по `docs/environment.md`
- 2026-11-09 · frontend → backend · PoC трея Помощника (#1.8.1–1.8.2): на Windows 11 по PrivateBytes покой 2,0 МБ (≤40 ✅), окно 155,3 МБ (цель 150 — не дотянуто ~5 МБ), открытие ~0,58 с ✅. Методика и как повторить на Astra 1.8 — `docs/research/helper-tray-poc.md`; нужен замер Максима для ADR-0005 (#1.8.3)
- 2026-11-11 · frontend → backend · функции Помощника по фазам (#1.8.4) — `docs/architecture/helper.md` с черновым списком методов IPC для `proto/helper/v1`; черновик ADR-0005 «Предложено» — `docs/adr/0005-agent-and-helper.md`
- 2026-11-15 · frontend → backend · обращения пользователей (#1.9): черновик ADR-0006 — `docs/adr/0006-user-tickets.md` (автодиагностика и очередь — на агенте, шаг 6); макет окна Помощника — `docs/ux/helper-window.html`
## Запросы между зонами
<!-- Формат: - [ ] YYYY-MM-DD · от зоны → к зоне · что нужно · зачем · #ID -->
- —
## Блокеры
- —
+220
View File
@@ -0,0 +1,220 @@
<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Макет окна «Штиль Помощник» — #1.9.7</title>
<link rel="preconnect" href="https://fonts.googleapis.com">
<link href="https://fonts.googleapis.com/css2?family=Golos+Text:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
<style>
:root{
--bg:#F4F5F7; --card:#FFFFFF; --line:#E2E5EA;
--text:#23272E; --text-2:#6B7280; --text-3:#9AA1AB;
--accent:#3D6E9E; --accent-soft:#E8F0F7;
--ok:#3F7D54; --ok-soft:#E5F0E8;
--warn:#9A7418; --warn-soft:#F7EFD8;
--err:#A94438; --err-soft:#F7E6E2;
--mut:#8A919B; --mut-soft:#EEF0F2;
--r:10px;
}
*{margin:0;padding:0;box-sizing:border-box}
body{font-family:"Golos Text",system-ui,sans-serif;background:var(--bg);color:var(--text);font-size:14px;line-height:1.5;padding:32px}
h1{font-size:20px;margin-bottom:4px}
.sub{color:var(--text-2);margin-bottom:24px;font-size:13px}
.sub code{font-family:"JetBrains Mono",monospace;font-size:12px}
.screens{display:flex;gap:24px;flex-wrap:wrap;align-items:flex-start}
.screen-cap{font-family:"JetBrains Mono",monospace;font-size:11px;letter-spacing:.1em;text-transform:uppercase;color:var(--text-3);margin-bottom:8px}
/* окно Помощника */
.win{width:400px;background:var(--card);border:1px solid var(--line);border-radius:14px;box-shadow:0 4px 20px rgba(30,35,45,.10);overflow:hidden}
.win-head{padding:14px 18px;border-bottom:1px solid var(--line);display:flex;align-items:center;gap:10px}
.win-head .ttl{font-weight:700;font-size:15px}
.win-head .min{margin-left:auto;color:var(--text-3);font-family:"JetBrains Mono",monospace;font-size:11px}
.win-body{padding:16px 18px;display:grid;gap:14px}
/* категории */
.cats{display:grid;grid-template-columns:1fr 1fr;gap:8px}
.cat{border:1px solid var(--line);border-radius:var(--r);padding:9px 12px;font-size:13px;font-weight:500;cursor:pointer;display:flex;gap:8px;align-items:center;transition:all .12s}
.cat:hover{border-color:var(--accent)}
.cat.on{border-color:var(--accent);background:var(--accent-soft);color:var(--accent);font-weight:600}
.cat .ic{font-size:15px}
/* поля */
.f label{display:block;font-size:12.5px;font-weight:600;margin-bottom:5px}
.f .hint{float:right;font-family:"JetBrains Mono",monospace;font-size:10.5px;color:var(--text-3);font-weight:400}
.f textarea,.f input{width:100%;font:inherit;font-size:13.5px;border:1px solid var(--line);border-radius:var(--r);padding:9px 11px;resize:vertical;background:#FCFCFD}
.f textarea:focus,.f input:focus{outline:none;border-color:var(--accent);box-shadow:0 0 0 3px var(--accent-soft)}
.f textarea{min-height:76px}
/* скриншот */
.shot{display:flex;gap:10px;align-items:center;border:1px dashed var(--line);border-radius:var(--r);padding:8px 10px}
.shot .prev{width:72px;height:44px;border-radius:6px;background:linear-gradient(135deg,#cdd6e0,#9fb2c8);flex:none;border:1px solid var(--line);display:flex;align-items:center;justify-content:center;font-size:16px}
.shot .nm{font-size:12.5px;color:var(--text-2)}
.shot .rm{margin-left:auto;font-size:12px;color:var(--err);font-weight:600;cursor:pointer;border:none;background:none;font-family:inherit}
.shot .rm:hover{text-decoration:underline}
/* кнопки */
.btn{font:inherit;font-weight:600;font-size:14px;padding:10px 16px;border-radius:var(--r);border:1px solid transparent;cursor:pointer;transition:all .15s}
.btn-p{background:var(--accent);color:#fff;width:100%}
.btn-p:hover{background:#335F88}
.btn-s{background:transparent;color:var(--accent);border-color:var(--line);padding:7px 13px;font-size:13px}
.btn-s:hover{border-color:var(--accent);background:var(--accent-soft)}
.btn-ok{background:var(--ok);color:#fff;padding:7px 13px;font-size:13px}
.btn-ok:hover{background:#356747}
.btn-err{background:transparent;color:var(--err);border-color:var(--line);padding:7px 13px;font-size:13px}
.btn-err:hover{border-color:var(--err);background:var(--err-soft)}
/* чипы статусов */
.chip{display:inline-flex;align-items:center;gap:5px;font-size:11.5px;font-weight:600;border-radius:999px;padding:3px 10px;white-space:nowrap}
.chip i{width:6px;height:6px;border-radius:50%;background:currentColor;font-style:normal}
.c-new{background:var(--accent-soft);color:var(--accent)}
.c-work{background:var(--warn-soft);color:var(--warn)}
.c-wait{background:var(--err-soft);color:var(--err)}
.c-done{background:var(--ok-soft);color:var(--ok)}
.c-closed,.c-rej{background:var(--mut-soft);color:var(--mut)}
/* список обращений */
.tk{border:1px solid var(--line);border-radius:var(--r);padding:11px 13px;cursor:pointer;transition:all .15s}
.tk:hover{box-shadow:0 2px 10px rgba(30,35,45,.08)}
.tk .top{display:flex;align-items:center;gap:8px}
.tk .t{font-weight:600;font-size:13.5px}
.tk .m{font-family:"JetBrains Mono",monospace;font-size:10.5px;color:var(--text-3);margin-top:3px}
.tk .chip{margin-left:auto}
/* переписка */
.thread{display:grid;gap:8px}
.msg{max-width:88%;border-radius:10px;padding:8px 11px;font-size:13px}
.msg .who{display:block;font-family:"JetBrains Mono",monospace;font-size:10px;color:var(--text-3);margin-bottom:2px}
.msg.a{background:var(--accent-soft);justify-self:start}
.msg.u{background:var(--mut-soft);justify-self:end}
.sysline{text-align:center;font-family:"JetBrains Mono",monospace;font-size:10.5px;color:var(--text-3);padding:4px 0}
.confirm{border:1px solid var(--warn);background:var(--warn-soft);border-radius:var(--r);padding:10px 12px}
.confirm .q{font-size:12.5px;font-weight:600;color:var(--warn);margin-bottom:8px}
.reply{display:flex;gap:8px}
.reply input{flex:1;font:inherit;font-size:13px;border:1px solid var(--line);border-radius:var(--r);padding:8px 11px}
.reply input:focus{outline:none;border-color:var(--accent)}
/* о программе */
.about{display:grid;gap:8px;font-size:13.5px}
.about .row{display:flex;justify-content:space-between;border-bottom:1px dashed var(--line);padding-bottom:6px}
.about .row:last-child{border-bottom:none;padding-bottom:0}
.about .k{color:var(--text-2)}
.about .v{font-weight:500}
.about .v.mono{font-family:"JetBrains Mono",monospace;font-size:12px}
.st-ok{color:var(--ok);font-weight:600}
.note{margin-top:28px;max-width:640px;color:var(--text-2);font-size:12.5px;border-left:3px solid var(--line);padding-left:14px}
@media (prefers-reduced-motion:reduce){*{transition:none!important}}
</style>
</head>
<body>
<h1>Окно «Штиль Помощник»</h1>
<p class="sub">Функциональный макет #1.9.7 — по прототипу из карточки 1.9. Это схема экранов, <b>не визуальный дизайн</b>: цвета и стиль задаст тема приложения позже. Ширина окна ~400px.</p>
<div class="screens">
<!-- ЭКРАН 1: форма -->
<div>
<div class="screen-cap">Экран 1 · Сообщить о проблеме</div>
<div class="win">
<div class="win-head"><span class="ttl">Сообщить о проблеме</span><span class="min">— □ ×</span></div>
<div class="win-body">
<div class="cats">
<div class="cat"><span class="ic">🖨</span>Не печатает</div>
<div class="cat on"><span class="ic">🌐</span>Нет сети</div>
<div class="cat"><span class="ic">🐢</span>Медленно</div>
<div class="cat"><span class="ic">⚠</span>Программа</div>
<div class="cat"><span class="ic">🔑</span>Доступ / ПО</div>
<div class="cat"><span class="ic">💬</span>Другое</div>
</div>
<div class="f">
<label>Описание <span class="hint">148 / 1000</span></label>
<textarea>Пропал интернет минут 15 назад, значок жёлтый. Соседям по кабинету то же самое.</textarea>
</div>
<div class="shot">
<div class="prev">🖥</div>
<div class="nm">Скриншот приложится<br>автоматически</div>
<button class="rm">Убрать</button>
</div>
<div class="f">
<label>Как с вами связаться</label>
<input value="каб. 214, вн. 45-12">
</div>
<button class="btn btn-p">Отправить</button>
</div>
</div>
</div>
<!-- ЭКРАН 2: список -->
<div>
<div class="screen-cap">Экран 2 · Мои обращения</div>
<div class="win">
<div class="win-head"><span class="ttl">Мои обращения</span><span class="min">— □ ×</span></div>
<div class="win-body">
<div class="tk">
<div class="top"><span class="t">Нет сети</span><span class="chip c-wait"><i></i>Ждёт вас</span></div>
<div class="m">#1042 · сегодня, 14:02</div>
</div>
<div class="tk">
<div class="top"><span class="t">Не печатает HP</span><span class="chip c-work"><i></i>В работе</span></div>
<div class="m">#1031 · 12 ноя, Козлов Д.</div>
</div>
<div class="tk" style="opacity:.75">
<div class="top"><span class="t">Нужен 1С:ЗУП</span><span class="chip c-closed"><i></i>Закрыто</span></div>
<div class="m">#0987 · 3 ноя</div>
</div>
<div class="tk" style="opacity:.75">
<div class="top"><span class="t">Медленно грузится</span><span class="chip c-rej"><i></i>Отклонено</span></div>
<div class="m">#0950 · 28 окт</div>
</div>
</div>
</div>
</div>
<!-- ЭКРАН 3: карточка с перепиской -->
<div>
<div class="screen-cap">Экран 3 · Обращение и переписка</div>
<div class="win">
<div class="win-head"><span class="ttl">#1042 · Нет сети</span><span class="chip c-wait" style="margin-left:auto"><i></i>Ждёт вас</span></div>
<div class="win-body">
<div class="thread">
<div class="msg u"><span class="who">вы · 14:02</span>Пропал интернет минут 15 назад, значок жёлтый.</div>
<div class="msg a"><span class="who">Козлов Д. · 14:10</span>Вижу, у всего этажа пропал DHCP. Перезапускаю службу, проверьте через минуту.</div>
<div class="msg u"><span class="who">вы · 14:13</span>Появилась сеть, спасибо!</div>
<div class="sysline">Козлов Д. отметил как «Решено» · 14:15</div>
</div>
<div class="confirm">
<div class="q">Проблема решена? Через 3 дня обращение закроется само.</div>
<div style="display:flex;gap:8px">
<button class="btn btn-ok">Да, решено</button>
<button class="btn btn-err">Нет, не помогло</button>
</div>
</div>
<div class="reply"><input placeholder="Написать в обращение…"><button class="btn btn-s">→</button></div>
</div>
</div>
</div>
<!-- ЭКРАН 4: о программе -->
<div>
<div class="screen-cap">Экран 4 · О программе</div>
<div class="win">
<div class="win-head"><span class="ttl">О программе</span><span class="min">— □ ×</span></div>
<div class="win-body">
<div class="about">
<div class="row"><span class="k">Приложение</span><span class="v">Штиль Помощник</span></div>
<div class="row"><span class="k">Версия</span><span class="v mono">0.9.2 (64-bit)</span></div>
<div class="row"><span class="k">Организация</span><span class="v">ООО «Ромашка»</span></div>
<div class="row"><span class="k">Устройство</span><span class="v mono">WS-0142</span></div>
<div class="row"><span class="k">Связь с агентом</span><span class="v st-ok">подключено</span></div>
</div>
</div>
</div>
</div>
</div>
<p class="note">
<b>Что учтено из решения 1.9:</b> поля «срочность» нет (приоритет ставит админ); описание со счётчиком до 1000; скриншот — превью с «Убрать»; кнопки «Решено / Не помогло» показываются только в статусе «Ожидает пользователя» и только когда политика организации включила подтверждение; список — последние 10 обращений.
</p>
</body>
</html>
+18
View File
@@ -0,0 +1,18 @@
# Git-хуки проекта. Установка один раз после клонирования: lefthook install
# Правила — docs/contributing.md
pre-commit:
parallel: true
commands:
gitleaks:
run: gitleaks git --pre-commit --staged --redact --no-banner .
gofmt:
glob: "*.go"
run: gofmt -w {staged_files}
stage_fixed: true
# prettier подключается в #2.7.2 вместе с pnpm-workspace
commit-msg:
commands:
format:
run: node tools/git-hooks/commit-msg.mjs {1}
+24
View File
@@ -0,0 +1,24 @@
# Logs
logs
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*
lerna-debug.log*
node_modules
dist
dist-ssr
*.local
# Editor directories and files
.vscode/*
!.vscode/extensions.json
.idea
.DS_Store
*.suo
*.ntvs*
*.njsproj
*.sln
*.sw?
+7
View File
@@ -0,0 +1,7 @@
{
"recommendations": [
"Vue.volar",
"tauri-apps.tauri-vscode",
"rust-lang.rust-analyzer"
]
}
+15
View File
@@ -0,0 +1,15 @@
# PoC «Штиль Помощник» — трей-only (#1.8.1–1.8.2)
Tauri 2 приложение, которое при старте не создаёт окно — только иконку в трее
с меню. Окно формы создаётся по клику и уничтожается при закрытии.
Временный прототип для замеров ОЗУ и времени открытия окна (ввод к ADR-0005).
Сборка, методика и результаты — `docs/research/helper-tray-poc.md`.
```bash
pnpm install
pnpm tauri build # release в src-tauri/target/release/
pnpm tauri dev # разработка (есть пункт «Выход (debug)»)
```
Замер (Windows): `powershell -ExecutionPolicy Bypass -File measure.ps1`
+13
View File
@@ -0,0 +1,13 @@
<!doctype html>
<html lang="ru">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Штиль Помощник (PoC)</title>
</head>
<body>
<div id="app"></div>
<script type="module" src="/src/main.ts"></script>
</body>
</html>
+156
View File
@@ -0,0 +1,156 @@
# Замер памяти PoC «Штиль Помощник» (#1.8.1–1.8.2).
#
# Запускает release-сборку с флагом --measure-scenario: приложение само
# открывает и закрывает окна по таймеру и пишет отметки этапов в
# helper-tray-poc.measure.log (рядом с exe, при недоступности — в %TEMP%).
# Скрипт снимает по отметкам два счётчика дерева процессов:
# PrivateBytes — committed private memory (решение принимаем по ней:
# Windows урезает рабочий набор простаивающих процессов,
# поэтому WorkingSetPrivate для покоя занижен);
# WorkingSetPrivate — private working set, для справки.
# Отметки: покой (30 с), открытое окно (+10 с), после закрытия (+10 с),
# повторно открытое окно (+10 с). Время открытия — из строк
# «window-opened ... ms=N» в логе.
#
# Дерево: процесс приложения + все дочерние msedgewebview2.exe (по цепочке
# родителей и по user-data-dir в командной строке).
#
# Использование: powershell -ExecutionPolicy Bypass -File measure.ps1 [-Runs 5]
# Требуется собранный релиз: pnpm tauri build
param(
[int]$Runs = 5,
[string]$ExePath = "$PSScriptRoot\src-tauri\target\release\helper-tray.exe",
[int]$TimeoutSec = 150
)
$ErrorActionPreference = 'Stop'
$WebViewMarker = 'ru.tbsoft.shtil.helper.poc'
$LogCandidates = @(
(Join-Path (Split-Path $ExePath) 'helper-tray-poc.measure.log'),
(Join-Path $env:TEMP 'helper-tray-poc.measure.log')
)
if (-not (Test-Path $ExePath)) {
throw "Не найден $ExePath — сначала выполните: pnpm tauri build"
}
function Stop-Poc {
Get-Process -Name 'helper-tray' -ErrorAction SilentlyContinue | Stop-Process -Force
Get-CimInstance Win32_Process -Filter "Name='msedgewebview2.exe'" |
Where-Object { $_.CommandLine -and $_.CommandLine.Contains($WebViewMarker) } |
ForEach-Object { Stop-Process -Id $_.ProcessId -Force -ErrorAction SilentlyContinue }
# Убитые процессы уходят не мгновенно; если не подождать, следующий прогон
# посчитает их за свойства нового (fallback ищет по user-data-dir).
Start-Sleep -Seconds 2
}
function Get-TreeMemory([int]$AppPid) {
$all = Get-CimInstance Win32_Process
# Дочерние процессы приложения (WebView2 плодит дерево глубиной 2–3 уровня).
$tree = New-Object 'System.Collections.Generic.List[int]'
$tree.Add($AppPid)
for ($i = 0; $i -lt $tree.Count; $i++) {
$parent = $tree[$i]
foreach ($child in ($all | Where-Object ParentProcessId -eq $parent)) {
if (-not $tree.Contains($child.ProcessId)) { $tree.Add($child.ProcessId) }
}
}
# Страховка: webview-процессы, пережившие переодресацию родителя.
foreach ($w in ($all | Where-Object {
$_.Name -eq 'msedgewebview2.exe' -and
$_.CommandLine -and $_.CommandLine.Contains($WebViewMarker)
})) {
if (-not $tree.Contains($w.ProcessId)) { $tree.Add($w.ProcessId) }
}
$perf = Get-CimInstance Win32_PerfFormattedData_PerfProc_Process
$pb = 0.0; $ws = 0.0
foreach ($tpid in $tree) {
$row = $perf | Where-Object IDProcess -eq $tpid | Select-Object -First 1
if ($row) {
$pb += $row.PrivateBytes
$ws += $row.WorkingSetPrivate
}
}
[pscustomobject]@{
Pids = $tree.Count
PbMB = [math]::Round($pb / 1MB, 1)
WsMB = [math]::Round($ws / 1MB, 1)
}
}
function Get-Median([double[]]$Values) {
$s = $Values | Sort-Object
return $s[[int]($s.Count / 2)]
}
$results = @()
for ($run = 1; $run -le $Runs; $run++) {
Stop-Poc
foreach ($log in $LogCandidates) { Remove-Item $log -ErrorAction SilentlyContinue }
Write-Host "── Прогон $run из $Runs ──────────────"
$proc = Start-Process $ExePath -ArgumentList '--measure-scenario' -PassThru
$seen = 0
$opens = @()
$sample = @{ Done = $false }
$deadline = (Get-Date).AddSeconds($TimeoutSec)
while ((Get-Date) -lt $deadline -and -not $sample.Done) {
$logPath = $LogCandidates | Where-Object { Test-Path $_ } | Select-Object -First 1
if ($logPath) {
foreach ($line in (Get-Content $logPath | Select-Object -Skip $seen)) {
$seen++
switch -Regex ($line) {
'stage open-window-1' { $sample.Idle = Get-TreeMemory $proc.Id }
'stage close-window-1' { $sample.Open = Get-TreeMemory $proc.Id }
'stage open-window-2' { $sample.AfterClose = Get-TreeMemory $proc.Id }
'stage close-window-2' { $sample.WarmOpen = Get-TreeMemory $proc.Id }
'window-opened .*ms=(\d+)' { $opens += [int]$Matches[1] }
'stage done' { $sample.Done = $true }
}
}
}
Start-Sleep -Milliseconds 200
}
# После «stage done» приложение должно завершиться само (app.exit(0)
# не блокируется prevent_exit — code задан).
$null = $proc | Wait-Process -Timeout 10 -ErrorAction SilentlyContinue
$selfExited = $proc.HasExited
Stop-Poc
if (-not $sample.Done) {
Write-Warning "Прогон ${run}: сценарий не дошёл до конца за $TimeoutSec с — пропускаю"
continue
}
$results += [pscustomobject]@{
Run = $run
IdlePbMB = $sample.Idle.PbMB
IdleWsMB = $sample.Idle.WsMB
OpenPbMB = $sample.Open.PbMB
OpenWsMB = $sample.Open.WsMB
AfterClosePb = $sample.AfterClose.PbMB
AfterCloseWs = $sample.AfterClose.WsMB
WarmOpenPb = $sample.WarmOpen.PbMB
ColdOpenMs = $opens[0]
WarmOpenMs = $opens[1]
SelfExit = [bool]$selfExited
}
Write-Host (" покой {0}/{1} МБ · окно {2}/{3} МБ · после закрытия {4}/{5} МБ · открытие {6}/{7} мс" -f `
$sample.Idle.PbMB, $sample.Idle.WsMB, $sample.Open.PbMB, $sample.Open.WsMB, `
$sample.AfterClose.PbMB, $sample.AfterClose.WsMB, $opens[0], $opens[1])
}
if (-not $results) { throw "Ни один прогон не завершился" }
Write-Host ""
Write-Host "══ Итог ($($results.Count) прогонов): медиана [min–max], PB = PrivateBytes, WS = WorkingSetPrivate ══"
foreach ($m in 'IdlePbMB','IdleWsMB','OpenPbMB','OpenWsMB','AfterClosePb','AfterCloseWs','WarmOpenPb','ColdOpenMs','WarmOpenMs') {
$v = @($results | ForEach-Object { [double]$_.$m })
$med = Get-Median $v
Write-Host (" {0,-13} {1,8} [{2} – {3}]" -f $m, $med, ($v | Measure-Object -Minimum).Minimum, ($v | Measure-Object -Maximum).Maximum)
}
if (-not ($results.SelfExit -contains $false)) { Write-Host " приложение завершилось само во всех прогонах" } else { Write-Warning "были прогоны без самостоятельного завершения" }
$results | Format-Table -AutoSize
+23
View File
@@ -0,0 +1,23 @@
{
"name": "helper-tray-poc",
"private": true,
"version": "0.1.0",
"type": "module",
"scripts": {
"dev": "vite",
"build": "vue-tsc --noEmit && vite build",
"preview": "vite preview",
"tauri": "tauri"
},
"dependencies": {
"vue": "^3.5.13",
"@tauri-apps/api": "^2"
},
"devDependencies": {
"@vitejs/plugin-vue": "^6.0.7",
"typescript": "~6.0.3",
"vite": "^8.0.16",
"vue-tsc": "^3.3.5",
"@tauri-apps/cli": "^2"
}
}
+879
View File
@@ -0,0 +1,879 @@
lockfileVersion: '9.0'
settings:
autoInstallPeers: true
excludeLinksFromLockfile: false
importers:
.:
dependencies:
'@tauri-apps/api':
specifier: ^2
version: 2.12.4
vue:
specifier: ^3.5.13
version: 3.5.45(typescript@6.0.3)
devDependencies:
'@tauri-apps/cli':
specifier: ^2
version: 2.12.4
'@vitejs/plugin-vue':
specifier: ^6.0.7
version: 6.0.10(vite@8.3.6)(vue@3.5.45(typescript@6.0.3))
typescript:
specifier: ~6.0.3
version: 6.0.3
vite:
specifier: ^8.0.16
version: 8.3.6
vue-tsc:
specifier: ^3.3.5
version: 3.3.14(typescript@6.0.3)
packages:
'@babel/helper-string-parser@7.29.13':
resolution: {integrity: sha512-fWegr+WsEsiMVW4KUNdIIzzMTZSzNiqhy0//6+2MRi2d5NFNsL/AYwBQW8eBnRbTBVRnDVzjaJEUqKaCWjMMdQ==}
engines: {node: '>=6.9.0'}
'@babel/helper-validator-identifier@7.29.7':
resolution: {integrity: sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==}
engines: {node: '>=6.9.0'}
'@babel/parser@7.29.13':
resolution: {integrity: sha512-fJM50YYjlTiBhgdkGmC1tBpv+FMAyo4annf2X6Aks+0yRlaiVkYW/3f07xAfVVkYIoZ9fFZp+mEThUFnuybhkQ==}
engines: {node: '>=6.0.0'}
hasBin: true
'@babel/types@7.29.11':
resolution: {integrity: sha512-WCsemW40Cpc6gouC1SrY6PBaZ+oLRlEVY9XBvZBI7il/HyUrb2nJ505wE1MHEFyDZNnrWDEuy4jL50WVHfTTSQ==}
engines: {node: '>=6.9.0'}
'@jridgewell/sourcemap-codec@1.6.0':
resolution: {integrity: sha512-T7jf+5zgsZHwNJ4lvQ7/aezbyk0nNX+zJVWpmHA7VYsEx7a7qr5Rg5IbtJFqkgze5Y2sruq1RUY8Q837Od7iFw==}
'@oxc-project/types@0.156.0':
resolution: {integrity: sha512-1Duyg48TdJNdyhEB8Xn1L36bT9Pv6GUtlKjHxOys8xkaF/rQq3XJE+bAurSK/AgIz5mGFsb77cn9Pb20+WCScw==}
'@rolldown/binding-android-arm-eabi@1.2.16':
resolution: {integrity: sha512-ia3DwAs0OsMGS7+IConptSiyk9pEXkOx/AbJ2n/lAGxH3QkWQus1t8d7gnAT38FCU2sQu8lUbeR6AiZFv4JxaA==}
engines: {node: ^20.19.0 || >=22.12.0}
cpu: [arm]
os: [android]
'@rolldown/binding-android-arm64@1.2.16':
resolution: {integrity: sha512-kx5wBiMB6E7TEvpl2B9gjLU004BkvEm2Dr941BFjx/SontPwSzNuQUIoVKxHHoSjpFIfHMmcguyLOtyn0hObRg==}
engines: {node: ^20.19.0 || >=22.12.0}
cpu: [arm64]
os: [android]
'@rolldown/binding-darwin-arm64@1.2.16':
resolution: {integrity: sha512-qslZrXnKJU4cUpjoAmtAo/KQM9e2IRMlmpig6Zpwj+8KWxW8v+nkAf9216Bsek9lOC1jvg2yCjygCFo2f83msQ==}
engines: {node: ^20.19.0 || >=22.12.0}
cpu: [arm64]
os: [darwin]
'@rolldown/binding-darwin-x64@1.2.16':
resolution: {integrity: sha512-FdF+y48ND13eAyM2mQn+85kvAqNlvRWROy2rhgA463X/0Gv4vGtazZtfaF1mRBLscYvtOlh4QnLjOWiFzX69OQ==}
engines: {node: ^20.19.0 || >=22.12.0}
cpu: [x64]
os: [darwin]
'@rolldown/binding-freebsd-x64@1.2.16':
resolution: {integrity: sha512-ddjqFM5e95AgLbUPtKIS7V1KTVlA0RUgCVr5mn+/IEhsdy3pr+Vuj/HZ7nlMN2FyxIwUktOH1LEPIQXO1v9y1Q==}
engines: {node: ^20.19.0 || >=22.12.0}
cpu: [x64]
os: [freebsd]
'@rolldown/binding-linux-arm-gnueabihf@1.2.16':
resolution: {integrity: sha512-tHdKWbFkFBI687iim3LIyIvyL7j66VvQYkDPss5Stn/qyE2tWkR1YD0dXmXPFKKqT/o5ZEJVsaRsWS2meQwGOA==}
engines: {node: ^20.19.0 || >=22.12.0}
cpu: [arm]
os: [linux]
'@rolldown/binding-linux-arm64-gnu@1.2.16':
resolution: {integrity: sha512-FJiLGAblPBMlBEdbOqw6kW6QcXDWAf/oJu7gYs9ZJZwmg+K+/zjFLxPTIY9izJUzxzc24FHvmseyA0IvJSl17w==}
engines: {node: ^20.19.0 || >=22.12.0}
cpu: [arm64]
os: [linux]
libc: [glibc]
'@rolldown/binding-linux-arm64-musl@1.2.16':
resolution: {integrity: sha512-hrJpblMsrQ58U9veWpbXzkhV5zStunds6HWLprqq1qauvgBr1E6P+24kLj6lSLI9vjRn/RYpjprhkHQPKGWpNg==}
engines: {node: ^20.19.0 || >=22.12.0}
cpu: [arm64]
os: [linux]
libc: [musl]
'@rolldown/binding-linux-ppc64-gnu@1.2.16':
resolution: {integrity: sha512-qJd/dC6j6CwLG9/s/RP2nb1RZ0GIgj7Ioj7x/SYa3RzjVrlzrmH0fhIOpfvqQDeIsdP0loi+kHaMhJzY1PBIaA==}
engines: {node: ^20.19.0 || >=22.12.0}
cpu: [ppc64]
os: [linux]
libc: [glibc]
'@rolldown/binding-linux-s390x-gnu@1.2.16':
resolution: {integrity: sha512-Vx7Xg5uUJuNcujJjI70OICaH0EYj80BtOLZTSN7uOYg8QOLlyKnaG0IW7Fn/J0IpJsaKzmDKMhOQv1JBM9m9vg==}
engines: {node: ^20.19.0 || >=22.12.0}
cpu: [s390x]
os: [linux]
libc: [glibc]
'@rolldown/binding-linux-x64-gnu@1.2.16':
resolution: {integrity: sha512-TNKhgE3uJTsTzatUSSYt0Kgo+Oa2uSlSjz4r1aEIea7HX6ULBym4fAlYUhG1i6pjNf2njfCUAfKwr6C3E9Xg1w==}
engines: {node: ^20.19.0 || >=22.12.0}
cpu: [x64]
os: [linux]
libc: [glibc]
'@rolldown/binding-linux-x64-musl@1.2.16':
resolution: {integrity: sha512-7chXdpjXZ8qG0+mIxECN3cT9kvhZ3/oZhMX6Pp876P7CDrIy8nJswva6Mq357JR7eYXfuskwZxMeV1SzoZdHrA==}
engines: {node: ^20.19.0 || >=22.12.0}
cpu: [x64]
os: [linux]
libc: [musl]
'@rolldown/binding-openharmony-arm64@1.2.16':
resolution: {integrity: sha512-Kwjt+7uNTJK5/MDkGWGVO2KQPnj8yAV75dMpfwyHZrJSXWHrniOB0aUEWlVYf3H1hOqFLIStLdM5QXq6bnKmOQ==}
engines: {node: ^20.19.0 || >=22.12.0}
cpu: [arm64]
os: [openharmony]
'@rolldown/binding-win32-arm64-msvc@1.2.16':
resolution: {integrity: sha512-/LH6WfjDRXXJz/p5xl4TmU+jpcnwcxbKEQBW/GZE0JHfN0lGIyTtsUEGaQ/q/GikkGJ2yLKe6pwm7AnEWO8pdw==}
engines: {node: ^20.19.0 || >=22.12.0}
cpu: [arm64]
os: [win32]
'@rolldown/binding-win32-x64-msvc@1.2.16':
resolution: {integrity: sha512-1lv1KvX0Z871zfk7vw+dnXMMnHNyDwMzWG8Kv3HxDXMOhzCX4SHc7HK319fInP0i+0p9D8brkfzL7pJOaGl+tw==}
engines: {node: ^20.19.0 || >=22.12.0}
cpu: [x64]
os: [win32]
'@rolldown/pluginutils@1.0.1':
resolution: {integrity: sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==}
'@tauri-apps/api@2.12.4':
resolution: {integrity: sha512-pVmfis+4zT8H0Qhp3xPZx9Ju7kpzvA6rr/PSJPyuwfvucTQ8sVt61NYU9KMkK703UFlYadFmjKA4HhybOtN0gg==}
'@tauri-apps/cli-darwin-arm64@2.12.4':
resolution: {integrity: sha512-OxqKSckIkoJ6vX2AjifIJpTasFC0Hbdoo7gEiCmAjauABO3U8m2MRsLWe+QTiBwDx1mIrvgA+rvI7tvDnbnHVg==}
engines: {node: '>= 10'}
cpu: [arm64]
os: [darwin]
'@tauri-apps/cli-darwin-x64@2.12.4':
resolution: {integrity: sha512-fz76/77wMMJOaaUN6n3CybRG0P/MTEjjqYk81mGPyhi9m6Ue5T+LWBnJP/AkPooNatBPI2vtulGqomyMJ44lCQ==}
engines: {node: '>= 10'}
cpu: [x64]
os: [darwin]
'@tauri-apps/cli-linux-arm-gnueabihf@2.12.4':
resolution: {integrity: sha512-K0w8Bof6Lt8QKLAYhRy0yy36ZH5iA/35VuSOvnxyjvCUZ+A3JKsUTlALviH/sVgAlisaPzzmeJSH8XOn4Q2HBA==}
engines: {node: '>= 10'}
cpu: [arm]
os: [linux]
'@tauri-apps/cli-linux-arm64-gnu@2.12.4':
resolution: {integrity: sha512-j5rOnjmRUwWrm1oosf0zBYl4D+fqydgUROFCk0hvKZxvbTT8SOERes0QB7rBV/XWNy+kM6pCKzb3oSm2sRglzg==}
engines: {node: '>= 10'}
cpu: [arm64]
os: [linux]
libc: [glibc]
'@tauri-apps/cli-linux-arm64-musl@2.12.4':
resolution: {integrity: sha512-aOue3Fy6Jb7+oWcfAVUsVHfeTybSCt2CZoU06aO4jv4d2Ks/KnaTPwMAK3CLEduGOvBLY1lbBBrIyomqLLH5Sg==}
engines: {node: '>= 10'}
cpu: [arm64]
os: [linux]
libc: [musl]
'@tauri-apps/cli-linux-riscv64-gnu@2.12.4':
resolution: {integrity: sha512-Fx6GShY/RvST+t6LMlTHAwd66+1tEaAAGrnU7cysVfaiRP1BKng5Vl6rVmO6rSLOA1Sp1dRzNYM4f0OWQGb7qA==}
engines: {node: '>= 10'}
cpu: [riscv64]
os: [linux]
libc: [glibc]
'@tauri-apps/cli-linux-x64-gnu@2.12.4':
resolution: {integrity: sha512-tNzZSa79Z1nRpHxEpQ38lsAFpKlFlYvoXzjTV+lRRn/zSf3wrdUC3wnLcq2XEadchPu4ttK0zivhYzr+XGD19Q==}
engines: {node: '>= 10'}
cpu: [x64]
os: [linux]
libc: [glibc]
'@tauri-apps/cli-linux-x64-musl@2.12.4':
resolution: {integrity: sha512-jmZ1pr0xEqUhuEusWtt9Yt+GF6lCnGHUmIL+KIknpbjK/XQ2qkhDBhaxK/JMHM2A8dAacVXCxXJk2EXpwhQUfA==}
engines: {node: '>= 10'}
cpu: [x64]
os: [linux]
libc: [musl]
'@tauri-apps/cli-win32-arm64-msvc@2.12.4':
resolution: {integrity: sha512-fGo8pgEHZxdSYgZ/J98m1usJ7NHKmKbq7k6uT0x1rpOq6Bg2YVzzpaAblWk710f5LHYBJIL5QIFS5IrD+4gmTg==}
engines: {node: '>= 10'}
cpu: [arm64]
os: [win32]
'@tauri-apps/cli-win32-ia32-msvc@2.12.4':
resolution: {integrity: sha512-ezl8sQIcjYsye3TUnTH5VcWmWzccZASlQm7hlZt0dYyj1XD0qpVW47u2xYVrIKui0F8uQv/7QGZixdWiClBsbg==}
engines: {node: '>= 10'}
cpu: [ia32]
os: [win32]
'@tauri-apps/cli-win32-x64-msvc@2.12.4':
resolution: {integrity: sha512-DJhDeCqjLDNMWYFy7ZS8cfeAHX2RK0RbQMLiA3bMVVkXRDJ4NBYiHriGqsUhsr9iG41aTb+dJGkFPmPw1gWwVw==}
engines: {node: '>= 10'}
cpu: [x64]
os: [win32]
'@tauri-apps/cli@2.12.4':
resolution: {integrity: sha512-JI9bHfudSRJikGOrjbXEm6RjzzvmKuLc+JixB1NE8hNzQkNlCCIC3pTES3uypkR9lxHrsbxzcnSwhI2IxBQphw==}
engines: {node: '>= 10'}
hasBin: true
'@vitejs/plugin-vue@6.0.10':
resolution: {integrity: sha512-b80aUQh3n+qEzzZm5oQp3rT2QImeCx58K6eFl/RkJ3d65KW0kTuv5lNsLRVAjbW9YRUpo/wzmvzMgV34bTAItA==}
engines: {node: ^20.19.0 || >=22.12.0}
peerDependencies:
vite: ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0
vue: ^3.2.25 || ^3.6.0-rc.10
'@volar/language-core@2.4.30':
resolution: {integrity: sha512-73fjwEV8wat6aOZ6U/y/hqtE30ocrIWECg67b0txGczOMNw+MffLmvJ5fnFfN9drVUEYZzLdaNo6VAy6G6avMw==}
'@volar/language-service@2.4.30':
resolution: {integrity: sha512-w/xDsASiqC71ggCOm7sTDXDNk/l72XEptodeRC68tgZ0e5QM4hM3zAqBGC7mBctvhrpYwKfMG+t9xcUo2hEFtA==}
peerDependencies:
typescript: <7
peerDependenciesMeta:
typescript:
optional: true
'@volar/source-map@2.4.30':
resolution: {integrity: sha512-zym1ob/KwDDyN+0jGVtxwbxJSRRnUvv5HspCtz3yEfVVdCG4/dzxJktMGPAgemqRuVs81O0o/y0q3qOUErR8kg==}
'@volar/typescript@2.4.30':
resolution: {integrity: sha512-/DgA5tgYFPfrLFuSjIMXMGHk1LQv2+P8eny6+BhGNzFJELWIW7UZlc56ZLIRFhLsPpMfIFxM8/HvOPBggrjTZg==}
peerDependencies:
typescript: <7
peerDependenciesMeta:
typescript:
optional: true
'@vue/compiler-core@3.5.45':
resolution: {integrity: sha512-XGHJrM6ufZARAc/w+tyOswStw9tdKiqCKBScI4gGaNxD+aaGu/HQWgKJ+JItjRLPqenQ7iE7G8AJC7T5ew1p+g==}
'@vue/compiler-dom@3.5.45':
resolution: {integrity: sha512-LbP2d19GSOYGPmvMBBCVJVlv7TKtjM1Cfeyu3cYia720pknZP+1cLX7H5MVatvruT6MuJhiPuNbQBW/MDn/EwA==}
'@vue/compiler-sfc@3.5.45':
resolution: {integrity: sha512-MKFjb2UX0M/l/jhfzqMLrI8VM4pfvFKG3pqFZkSZFHRLtNld/O4RtUPZFWSwhro/14qP88UQEkWzHxAZAQ0tsw==}
'@vue/compiler-ssr@3.5.45':
resolution: {integrity: sha512-RF5sbZOfYz5AK00tOJUn2PwFXR2fS1u2HVzI8D9VF9rGAFxuGBqg2bB1kJ3ZHMprqSltXnT9MZE1IsqjSM8oew==}
'@vue/language-core@3.3.14':
resolution: {integrity: sha512-kRB+3hHg0c+BdD1XLAvwjVMQd5pC05zijSlPDRI3ERvC/s04JlRs5upy2KjeMg/9m9oD5zuMVh9yVvkKfZqoJg==}
'@vue/reactivity@3.5.45':
resolution: {integrity: sha512-WqkyubNWpI4OYBOipSrjIssMdJO8K1i9Zts/Wm8Er10/0msOEwCyWWWvZnAI7WW3kQsTong6DJp8Cbb+vd4cPA==}
'@vue/runtime-core@3.5.45':
resolution: {integrity: sha512-bzIO3+FABjpj85uIKSc+Qnj36/sxDNI3tcH9i6w6xKA1k6e0ejv0G0jMCfeJBvK3yGL5XbJ3DMZj+ClqyCHFYw==}
'@vue/runtime-dom@3.5.45':
resolution: {integrity: sha512-ZvRTFMDgfqTDYWvJfoVpQTJx1RN5M6l7Pyd6wfdY2NaXzbPQVh9ezeQYFbNPP6bIcRVn2SqSSR25N/jSW69BFw==}
'@vue/server-renderer@3.5.45':
resolution: {integrity: sha512-1fNXUHhhsWf4EVL4XixbGBU5mKdiIXJAB82feHRTyPPo6ZUEYWIJuEeUl3mVV6QDBp50HJOX4obLhxYXlrjrzA==}
'@vue/shared@3.5.45':
resolution: {integrity: sha512-ue9fgHmVNPlP7iW3+cxoBX/Cnlw53dHlVSw0JKGY6z1lObg8pHoj928M2nzG4/yVsMZ3NaRZ2s2z61uC16NDwQ==}
alien-signals@3.2.1:
resolution: {integrity: sha512-I8FjmltrfnDFoZedi5CG8DghVYNhzb/Ijluz7tCSJH0xpd0484Kowhbb1XDYOxfJpU1p5wnM2X54dA+IfGyD1g==}
csstype@3.2.3:
resolution: {integrity: sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==}
detect-libc@2.1.2:
resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==}
engines: {node: '>=8'}
entities@7.0.1:
resolution: {integrity: sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==}
engines: {node: '>=0.12'}
estree-walker@2.0.2:
resolution: {integrity: sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==}
fdir@6.5.0:
resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==}
engines: {node: '>=12.0.0'}
peerDependencies:
picomatch: ^3 || ^4
peerDependenciesMeta:
picomatch:
optional: true
fsevents@2.3.3:
resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}
engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
os: [darwin]
lightningcss-android-arm64@1.33.0:
resolution: {integrity: sha512-gEpRTalKdosp4Bb8qWtc2iOgE5SeIHlpS1up9bFq2wAyYhl1UdTObYiHe98zEM9SQvSoqQZ1IQD0JNpg3Ml5pg==}
engines: {node: '>= 12.0.0'}
cpu: [arm64]
os: [android]
lightningcss-darwin-arm64@1.33.0:
resolution: {integrity: sha512-Sciaz8eenNTKn9b3t7+xr0ipTp9YxKQY4npwQ3mrRuL0BAVHBLyZxofhaKBAVtzmtRZ/zTyo0/to4B1uWG/Djg==}
engines: {node: '>= 12.0.0'}
cpu: [arm64]
os: [darwin]
lightningcss-darwin-x64@1.33.0:
resolution: {integrity: sha512-Z5UPAxzrjlWNNyGy6i65cJzzvgJ5D3T6wMvs+gWpY9d7qRhANrxqAp6LhxIgZhWEw18RfJTGcRxjuLIBr+m8XQ==}
engines: {node: '>= 12.0.0'}
cpu: [x64]
os: [darwin]
lightningcss-freebsd-x64@1.33.0:
resolution: {integrity: sha512-QQM/Ti/hQajJwCY+RiWuCZ9sdtI/XQk7nDK5vC8kkdwixezOlDgvDx7+RT+QjK6FcFT4MpsuoBnHIo/O3StRRg==}
engines: {node: '>= 12.0.0'}
cpu: [x64]
os: [freebsd]
lightningcss-linux-arm-gnueabihf@1.33.0:
resolution: {integrity: sha512-N7FVBe6iS24MlM6R/4RBTxGhQheZGs7tiQ9U32UtF75NzP5Q7xWPRqLBCKxlRQRk3rY1jCIPLzx7WzOhuUIRLQ==}
engines: {node: '>= 12.0.0'}
cpu: [arm]
os: [linux]
lightningcss-linux-arm64-gnu@1.33.0:
resolution: {integrity: sha512-j2v/itmy4HlNxlc6voKXYgBqNi0Ng2LShg4z7GufpEgs05P+2suBVyi9I6YHq5uoVFx9ETin3eCEhLVyXGQnKg==}
engines: {node: '>= 12.0.0'}
cpu: [arm64]
os: [linux]
libc: [glibc]
lightningcss-linux-arm64-musl@1.33.0:
resolution: {integrity: sha512-yiO5ROMuYQgXbC60yjZU5CYSFZGKXL0HFATXt9mHJn1+zW55oCtMI9NfcVhYLMFDL7gV7oBPon/EmMMGg2OvtQ==}
engines: {node: '>= 12.0.0'}
cpu: [arm64]
os: [linux]
libc: [musl]
lightningcss-linux-x64-gnu@1.33.0:
resolution: {integrity: sha512-ar+Ju7LmcN0Jo4FpL4hpFybwNG9/3A/Br5KW2n2jyODg3MEZXaDYADdemoNS+BDNfMgKvylJLj4S5tyRActuAg==}
engines: {node: '>= 12.0.0'}
cpu: [x64]
os: [linux]
libc: [glibc]
lightningcss-linux-x64-musl@1.33.0:
resolution: {integrity: sha512-RYiYbkokw0trfKqqzfF55lginwEPrD3OJDfTuJzFs1MK6iFnDenaz1fqLLtX4ITG3OktJQXOeTaw1awrBAlZPw==}
engines: {node: '>= 12.0.0'}
cpu: [x64]
os: [linux]
libc: [musl]
lightningcss-win32-arm64-msvc@1.33.0:
resolution: {integrity: sha512-1K+MPfLSFVpphzpdbfkhlWk6wBrTObBzS2T6db10PNOZgR9GoVsAWzwNyuhUYYbTp23j+4RrncfujZ4uAzXvwA==}
engines: {node: '>= 12.0.0'}
cpu: [arm64]
os: [win32]
lightningcss-win32-x64-msvc@1.33.0:
resolution: {integrity: sha512-OlEICDx/Xl0FqSp4bry8zFnCvGpig3Gl4gCquvYwHuqJKEC1+n9NgDniFvqHGmMv1ZkqDJrDqKKSykTDX+ehuA==}
engines: {node: '>= 12.0.0'}
cpu: [x64]
os: [win32]
lightningcss@1.33.0:
resolution: {integrity: sha512-WkUDrojuJs0xkgGf2udWxa3yGBRxPtxUkB79i6aCZLRgc7PM8fZe9TosfPDcvEpQZbuFASnHYmRLBLUbmLOIIA==}
engines: {node: '>= 12.0.0'}
magic-string@0.30.21:
resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==}
muggle-string@0.4.1:
resolution: {integrity: sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ==}
nanoid@3.3.20:
resolution: {integrity: sha512-uKdg2G3GNCKQn9byYOpxbGqrT2fGO5KRt5J/8b3pok8rT6qxGWF6hxMyJiEYtAf+FVyYuD9hRaDqX5uPFYJ4ZQ==}
engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1}
hasBin: true
path-browserify@1.0.1:
resolution: {integrity: sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==}
picocolors@1.1.1:
resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==}
picomatch@4.0.7:
resolution: {integrity: sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==}
engines: {node: '>=12'}
postcss@8.5.32:
resolution: {integrity: sha512-LJlKCCAUFKOuZxipUdYw1NzIITEsPcgyOG9LkvRJvuKj/bRzbuRY0ARXvL0pWGpsZvn8jku+LMep2eU0seHp8g==}
engines: {node: ^10 || ^12 || >=14}
rolldown@1.2.16:
resolution: {integrity: sha512-bWvlMpFKiTfDKfnK7FC2MPgPeWCf/Kpwsq49ApdW+FQaBZb6O6dZ4MAPbPUjp7hYQrw/RobqCzn64BRrQecGHw==}
engines: {node: ^20.19.0 || >=22.12.0}
hasBin: true
source-map-js@1.2.2:
resolution: {integrity: sha512-KGj/8Y43x35aZVDtt+J4mK1hoLGHULMYfSkODJNQjNDC3oW1PqPoxMwo0pLUsWM/UEGzON/NxeHywEfNXNP3Vw==}
engines: {node: '>=0.10.0'}
tinyglobby@0.2.17:
resolution: {integrity: sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==}
engines: {node: '>=12.0.0'}
typescript@6.0.3:
resolution: {integrity: sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==}
engines: {node: '>=14.17'}
hasBin: true
vite@8.3.6:
resolution: {integrity: sha512-UI7dK29NnS54Fk+mmo7o+jI6U8Fp7hDl+X5Q1k45WH+d4dSlbLVUETGQ+hfkNgvLQGyoElPj837nZyv4MBc0VA==}
engines: {node: ^20.19.0 || >=22.12.0}
hasBin: true
peerDependencies:
'@types/node': ^20.19.0 || >=22.12.0
'@vitejs/devtools': ^0.7.1 || ^0.8.0
esbuild: ^0.27.0 || ^0.28.0
jiti: '>=1.21.0'
less: ^4.0.0
sass: ^1.70.0
sass-embedded: ^1.70.0
stylus: '>=0.54.8'
sugarss: ^5.0.0
terser: ^5.16.0
tsx: ^4.8.1
yaml: ^2.4.2
peerDependenciesMeta:
'@types/node':
optional: true
'@vitejs/devtools':
optional: true
esbuild:
optional: true
jiti:
optional: true
less:
optional: true
sass:
optional: true
sass-embedded:
optional: true
stylus:
optional: true
sugarss:
optional: true
terser:
optional: true
tsx:
optional: true
yaml:
optional: true
vscode-jsonrpc@10.0.0:
resolution: {integrity: sha512-USSfxg0vDIpTQqlQBGxF3mBARyoS8cU7LHLpbYNh6dOJt32dlskxPWB0Irrh5TllTmyf7oNLAvqDqzklbwwnpA==}
engines: {node: '>=14.17.0'}
vscode-languageserver-protocol@3.18.5:
resolution: {integrity: sha512-FW4fBMzZ99N8xeob4py0l050wgCoRgTpEq5Xcsb9lM1bc29UKGR/wSV+4knaqFxssFHajy7OzNiKP/m3U1ZEuA==}
vscode-languageserver-textdocument@1.0.16:
resolution: {integrity: sha512-qeNEuOi9a3qkqRf7Gfez2WL2VwlBTLCNekHBGO9kxPVUp9XuY15yfTJ9jwvOwKI0I2MhUUfZq95NSp+LK1CLQg==}
vscode-languageserver-types@3.18.5:
resolution: {integrity: sha512-kPd6+JQNz3HMJvjKlqUxERSlZHAntl/aGpsk7ImwIh0ewDKDcjgAEyVSYciPiOJD3ftbK9IrfiqUeTZLSbCizw==}
vscode-uri@3.2.0:
resolution: {integrity: sha512-m2gXo3bn0G1kT9InzMf07fTbqMbGtyckj3bH5ktLO+1Ssv+yiATZ4dhwaQv9UZWxJh6E9IFGnQyjgWVDWVBDrg==}
vue-tsc@3.3.14:
resolution: {integrity: sha512-URAu2H9AuMZMg9GCgnqbaHHHd8pBZRAwNV2e2yYS8VDsoTVXHiOSo663OS6DkEvauQ2yixn5TPFJ9WV9QIspkA==}
hasBin: true
peerDependencies:
typescript: '>=5.0.0'
vue@3.5.45:
resolution: {integrity: sha512-3cvsib8m9c0vB24+MDKsgcW4+Da4xaBl9Z/5Tbm2pmSIsRPxcil4cdXjXlVsmJ2g64XJo5h+IRd7rsdGT9pZaw==}
peerDependencies:
typescript: '*'
peerDependenciesMeta:
typescript:
optional: true
snapshots:
'@babel/helper-string-parser@7.29.13': {}
'@babel/helper-validator-identifier@7.29.7': {}
'@babel/parser@7.29.13':
dependencies:
'@babel/types': 7.29.11
'@babel/types@7.29.11':
dependencies:
'@babel/helper-string-parser': 7.29.13
'@babel/helper-validator-identifier': 7.29.7
'@jridgewell/sourcemap-codec@1.6.0': {}
'@oxc-project/types@0.156.0': {}
'@rolldown/binding-android-arm-eabi@1.2.16':
optional: true
'@rolldown/binding-android-arm64@1.2.16':
optional: true
'@rolldown/binding-darwin-arm64@1.2.16':
optional: true
'@rolldown/binding-darwin-x64@1.2.16':
optional: true
'@rolldown/binding-freebsd-x64@1.2.16':
optional: true
'@rolldown/binding-linux-arm-gnueabihf@1.2.16':
optional: true
'@rolldown/binding-linux-arm64-gnu@1.2.16':
optional: true
'@rolldown/binding-linux-arm64-musl@1.2.16':
optional: true
'@rolldown/binding-linux-ppc64-gnu@1.2.16':
optional: true
'@rolldown/binding-linux-s390x-gnu@1.2.16':
optional: true
'@rolldown/binding-linux-x64-gnu@1.2.16':
optional: true
'@rolldown/binding-linux-x64-musl@1.2.16':
optional: true
'@rolldown/binding-openharmony-arm64@1.2.16':
optional: true
'@rolldown/binding-win32-arm64-msvc@1.2.16':
optional: true
'@rolldown/binding-win32-x64-msvc@1.2.16':
optional: true
'@rolldown/pluginutils@1.0.1': {}
'@tauri-apps/api@2.12.4': {}
'@tauri-apps/cli-darwin-arm64@2.12.4':
optional: true
'@tauri-apps/cli-darwin-x64@2.12.4':
optional: true
'@tauri-apps/cli-linux-arm-gnueabihf@2.12.4':
optional: true
'@tauri-apps/cli-linux-arm64-gnu@2.12.4':
optional: true
'@tauri-apps/cli-linux-arm64-musl@2.12.4':
optional: true
'@tauri-apps/cli-linux-riscv64-gnu@2.12.4':
optional: true
'@tauri-apps/cli-linux-x64-gnu@2.12.4':
optional: true
'@tauri-apps/cli-linux-x64-musl@2.12.4':
optional: true
'@tauri-apps/cli-win32-arm64-msvc@2.12.4':
optional: true
'@tauri-apps/cli-win32-ia32-msvc@2.12.4':
optional: true
'@tauri-apps/cli-win32-x64-msvc@2.12.4':
optional: true
'@tauri-apps/cli@2.12.4':
optionalDependencies:
'@tauri-apps/cli-darwin-arm64': 2.12.4
'@tauri-apps/cli-darwin-x64': 2.12.4
'@tauri-apps/cli-linux-arm-gnueabihf': 2.12.4
'@tauri-apps/cli-linux-arm64-gnu': 2.12.4
'@tauri-apps/cli-linux-arm64-musl': 2.12.4
'@tauri-apps/cli-linux-riscv64-gnu': 2.12.4
'@tauri-apps/cli-linux-x64-gnu': 2.12.4
'@tauri-apps/cli-linux-x64-musl': 2.12.4
'@tauri-apps/cli-win32-arm64-msvc': 2.12.4
'@tauri-apps/cli-win32-ia32-msvc': 2.12.4
'@tauri-apps/cli-win32-x64-msvc': 2.12.4
'@vitejs/plugin-vue@6.0.10(vite@8.3.6)(vue@3.5.45(typescript@6.0.3))':
dependencies:
'@rolldown/pluginutils': 1.0.1
vite: 8.3.6
vue: 3.5.45(typescript@6.0.3)
'@volar/language-core@2.4.30':
dependencies:
'@volar/source-map': 2.4.30
'@volar/language-service@2.4.30(typescript@6.0.3)':
dependencies:
'@volar/language-core': 2.4.30
vscode-languageserver-protocol: 3.18.5
vscode-languageserver-textdocument: 1.0.16
vscode-uri: 3.2.0
optionalDependencies:
typescript: 6.0.3
'@volar/source-map@2.4.30': {}
'@volar/typescript@2.4.30(typescript@6.0.3)':
dependencies:
'@volar/language-core': 2.4.30
'@volar/language-service': 2.4.30(typescript@6.0.3)
path-browserify: 1.0.1
vscode-uri: 3.2.0
optionalDependencies:
typescript: 6.0.3
'@vue/compiler-core@3.5.45':
dependencies:
'@babel/parser': 7.29.13
'@vue/shared': 3.5.45
entities: 7.0.1
estree-walker: 2.0.2
source-map-js: 1.2.2
'@vue/compiler-dom@3.5.45':
dependencies:
'@vue/compiler-core': 3.5.45
'@vue/shared': 3.5.45
'@vue/compiler-sfc@3.5.45':
dependencies:
'@babel/parser': 7.29.13
'@vue/compiler-core': 3.5.45
'@vue/compiler-dom': 3.5.45
'@vue/compiler-ssr': 3.5.45
'@vue/shared': 3.5.45
estree-walker: 2.0.2
magic-string: 0.30.21
postcss: 8.5.32
source-map-js: 1.2.2
'@vue/compiler-ssr@3.5.45':
dependencies:
'@vue/compiler-dom': 3.5.45
'@vue/shared': 3.5.45
'@vue/language-core@3.3.14':
dependencies:
'@volar/language-core': 2.4.30
'@vue/compiler-dom': 3.5.45
'@vue/shared': 3.5.45
alien-signals: 3.2.1
muggle-string: 0.4.1
path-browserify: 1.0.1
picomatch: 4.0.7
'@vue/reactivity@3.5.45':
dependencies:
'@vue/shared': 3.5.45
'@vue/runtime-core@3.5.45':
dependencies:
'@vue/reactivity': 3.5.45
'@vue/shared': 3.5.45
'@vue/runtime-dom@3.5.45':
dependencies:
'@vue/reactivity': 3.5.45
'@vue/runtime-core': 3.5.45
'@vue/shared': 3.5.45
csstype: 3.2.3
'@vue/server-renderer@3.5.45':
dependencies:
'@vue/compiler-ssr': 3.5.45
'@vue/runtime-dom': 3.5.45
'@vue/shared': 3.5.45
'@vue/shared@3.5.45': {}
alien-signals@3.2.1: {}
csstype@3.2.3: {}
detect-libc@2.1.2: {}
entities@7.0.1: {}
estree-walker@2.0.2: {}
fdir@6.5.0(picomatch@4.0.7):
optionalDependencies:
picomatch: 4.0.7
fsevents@2.3.3:
optional: true
lightningcss-android-arm64@1.33.0:
optional: true
lightningcss-darwin-arm64@1.33.0:
optional: true
lightningcss-darwin-x64@1.33.0:
optional: true
lightningcss-freebsd-x64@1.33.0:
optional: true
lightningcss-linux-arm-gnueabihf@1.33.0:
optional: true
lightningcss-linux-arm64-gnu@1.33.0:
optional: true
lightningcss-linux-arm64-musl@1.33.0:
optional: true
lightningcss-linux-x64-gnu@1.33.0:
optional: true
lightningcss-linux-x64-musl@1.33.0:
optional: true
lightningcss-win32-arm64-msvc@1.33.0:
optional: true
lightningcss-win32-x64-msvc@1.33.0:
optional: true
lightningcss@1.33.0:
dependencies:
detect-libc: 2.1.2
optionalDependencies:
lightningcss-android-arm64: 1.33.0
lightningcss-darwin-arm64: 1.33.0
lightningcss-darwin-x64: 1.33.0
lightningcss-freebsd-x64: 1.33.0
lightningcss-linux-arm-gnueabihf: 1.33.0
lightningcss-linux-arm64-gnu: 1.33.0
lightningcss-linux-arm64-musl: 1.33.0
lightningcss-linux-x64-gnu: 1.33.0
lightningcss-linux-x64-musl: 1.33.0
lightningcss-win32-arm64-msvc: 1.33.0
lightningcss-win32-x64-msvc: 1.33.0
magic-string@0.30.21:
dependencies:
'@jridgewell/sourcemap-codec': 1.6.0
muggle-string@0.4.1: {}
nanoid@3.3.20: {}
path-browserify@1.0.1: {}
picocolors@1.1.1: {}
picomatch@4.0.7: {}
postcss@8.5.32:
dependencies:
nanoid: 3.3.20
picocolors: 1.1.1
source-map-js: 1.2.2
rolldown@1.2.16:
dependencies:
'@oxc-project/types': 0.156.0
'@rolldown/pluginutils': 1.0.1
optionalDependencies:
'@rolldown/binding-android-arm-eabi': 1.2.16
'@rolldown/binding-android-arm64': 1.2.16
'@rolldown/binding-darwin-arm64': 1.2.16
'@rolldown/binding-darwin-x64': 1.2.16
'@rolldown/binding-freebsd-x64': 1.2.16
'@rolldown/binding-linux-arm-gnueabihf': 1.2.16
'@rolldown/binding-linux-arm64-gnu': 1.2.16
'@rolldown/binding-linux-arm64-musl': 1.2.16
'@rolldown/binding-linux-ppc64-gnu': 1.2.16
'@rolldown/binding-linux-s390x-gnu': 1.2.16
'@rolldown/binding-linux-x64-gnu': 1.2.16
'@rolldown/binding-linux-x64-musl': 1.2.16
'@rolldown/binding-openharmony-arm64': 1.2.16
'@rolldown/binding-win32-arm64-msvc': 1.2.16
'@rolldown/binding-win32-x64-msvc': 1.2.16
source-map-js@1.2.2: {}
tinyglobby@0.2.17:
dependencies:
fdir: 6.5.0(picomatch@4.0.7)
picomatch: 4.0.7
typescript@6.0.3: {}
vite@8.3.6:
dependencies:
lightningcss: 1.33.0
picomatch: 4.0.7
postcss: 8.5.32
rolldown: 1.2.16
tinyglobby: 0.2.17
optionalDependencies:
fsevents: 2.3.3
vscode-jsonrpc@10.0.0: {}
vscode-languageserver-protocol@3.18.5:
dependencies:
vscode-jsonrpc: 10.0.0
vscode-languageserver-types: 3.18.5
vscode-languageserver-textdocument@1.0.16: {}
vscode-languageserver-types@3.18.5: {}
vscode-uri@3.2.0: {}
vue-tsc@3.3.14(typescript@6.0.3):
dependencies:
'@volar/typescript': 2.4.30(typescript@6.0.3)
'@vue/language-core': 3.3.14
typescript: 6.0.3
vue@3.5.45(typescript@6.0.3):
dependencies:
'@vue/compiler-dom': 3.5.45
'@vue/compiler-sfc': 3.5.45
'@vue/runtime-dom': 3.5.45
'@vue/server-renderer': 3.5.45
'@vue/shared': 3.5.45
optionalDependencies:
typescript: 6.0.3
+7
View File
@@ -0,0 +1,7 @@
# Generated by Cargo
# will have compiled files and executables
/target/
# Generated by Tauri
# will have schema files for capabilities auto-completion
/gen/schemas
File diff suppressed because it is too large. Load diff
+23
View File
@@ -0,0 +1,23 @@
[package]
name = "helper-tray"
version = "0.1.0"
description = "PoC «Штиль Помощник»: Tauri только с иконкой в трее (#1.8)"
authors = ["T&B.Soft"]
edition = "2024"
[lib]
name = "helper_tray_lib"
crate-type = ["staticlib", "cdylib", "rlib"]
[build-dependencies]
tauri-build = { version = "2", features = [] }
[dependencies]
tauri = { version = "2", features = ["tray-icon"] }
[profile.release]
codegen-units = 1
lto = true
opt-level = 3
panic = "abort"
strip = true
+3
View File
@@ -0,0 +1,3 @@
fn main() {
tauri_build::build()
}
@@ -0,0 +1,7 @@
{
"$schema": "../gen/schemas/desktop-schema.json",
"identifier": "helper-windows",
"description": "Окна Помощника, создаваемые динамически из меню трея. Команды приложения не входят в ACL, плагинов нет — разрешений не нужно",
"windows": ["win-*"],
"permissions": []
}
Binary file not shown.

After

Width:  |  Height:  |  Size: 1.6 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 567 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 536 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.4 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 777 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 1020 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 848 B

Binary file not shown.
Binary file not shown.

After

Width:  |  Height:  |  Size: 37 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.5 KiB

+199
View File
@@ -0,0 +1,199 @@
use std::{
collections::HashMap,
fs::{File, OpenOptions},
io::Write,
sync::Mutex,
time::{Duration, Instant},
};
use tauri::{
AppHandle, Manager, State, WebviewUrl, WebviewWindow, Wry,
menu::{IsMenuItem, Menu, MenuItem},
tray::{TrayIcon, TrayIconBuilder},
webview::WebviewWindowBuilder,
};
struct MeasureLog {
started: Instant,
file: Mutex<Option<File>>,
}
impl MeasureLog {
fn marker(&self, text: &str) {
let line = format!("[{:>7.2}s] {}", self.started.elapsed().as_secs_f64(), text);
if let Some(f) = self.file.lock().unwrap().as_mut() {
let _ = writeln!(f, "{}", line).and_then(|_| f.flush());
}
eprintln!("{}", line);
}
}
struct AppState {
tray: Mutex<Option<TrayIcon>>,
open_started: Mutex<HashMap<String, Instant>>,
window_seq: Mutex<u32>,
last_label: Mutex<Option<String>>,
measure: MeasureLog,
}
#[tauri::command]
fn first_paint(window: WebviewWindow, state: State<'_, AppState>) -> Option<u128> {
let elapsed = state
.open_started
.lock()
.unwrap()
.remove(window.label())
.map(|t| t.elapsed().as_millis());
if let Some(ms) = elapsed {
state
.measure
.marker(&format!("window-opened {} ms={}", window.label(), ms));
}
elapsed
}
fn open_window(app: &AppHandle, view: &str) {
let state = app.state::<AppState>();
let label = {
let mut seq = state.window_seq.lock().unwrap();
*seq += 1;
format!("win-{}-{}", view, *seq)
};
let title = match view {
"report" => "Сообщить о проблеме",
"tickets" => "Мои обращения",
_ => "О программе",
};
let started = Instant::now();
match WebviewWindowBuilder::new(app, &label, WebviewUrl::App("index.html".into()))
.title(title)
.inner_size(460.0, 560.0)
.build()
{
Ok(_) => {
state
.open_started
.lock()
.unwrap()
.insert(label.clone(), started);
*state.last_label.lock().unwrap() = Some(label);
}
Err(e) => state
.measure
.marker(&format!("open-failed {}: {}", label, e)),
}
}
fn close_last_window(app: &AppHandle) {
let label = app.state::<AppState>().last_label.lock().unwrap().take();
if let Some(label) = label
&& let Some(window) = app.get_webview_window(&label)
{
let _ = window.destroy();
}
}
fn build_tray(app: &AppHandle) -> tauri::Result<TrayIcon> {
let report = MenuItem::with_id(app, "report", "Сообщить о проблеме", true, None::<&str>)?;
let tickets = MenuItem::with_id(app, "tickets", "Мои обращения", true, None::<&str>)?;
let about = MenuItem::with_id(app, "about", "О программе", true, None::<&str>)?;
// Выход только в debug-сборке: в релизном Помощнике пункта «Выход» не будет.
let quit = MenuItem::with_id(app, "quit", "Выход (debug)", true, None::<&str>)?;
let items: Vec<&dyn IsMenuItem<Wry>> = if cfg!(debug_assertions) {
vec![&report, &tickets, &about, &quit]
} else {
vec![&report, &tickets, &about]
};
let menu = Menu::with_items(app, &items)?;
TrayIconBuilder::new()
.icon(app.default_window_icon().unwrap().clone())
.tooltip("Штиль Помощник (PoC)")
.menu(&menu)
.on_menu_event(|app, event| match event.id().as_ref() {
"quit" => app.exit(0),
view @ ("report" | "tickets" | "about") => open_window(app, view),
_ => {}
})
.build(app)
}
// Отметка этапа пишется заранее, чтобы measure.ps1 успел снять ОЗУ до действия:
// два CIM-запроса в скрипте занимают ~0,5 с, поэтому запас делаем больше.
fn stage_then(app: &AppHandle, name: &str, action: impl Fn(&AppHandle) + Send + 'static) {
app.state::<AppState>().measure.marker(name);
std::thread::sleep(Duration::from_millis(1500));
let app2 = app.clone();
let _ = app.run_on_main_thread(move || action(&app2));
}
fn spawn_measure_scenario(app: AppHandle) {
std::thread::spawn(move || {
let sleep = |secs: u64| std::thread::sleep(Duration::from_secs(secs));
sleep(30);
stage_then(&app, "stage open-window-1", |a| open_window(a, "report"));
sleep(10);
stage_then(&app, "stage close-window-1", close_last_window);
sleep(10);
stage_then(&app, "stage open-window-2", |a| open_window(a, "report"));
sleep(10);
stage_then(&app, "stage close-window-2", close_last_window);
app.state::<AppState>().measure.marker("stage done");
app.exit(0);
});
}
fn measure_log_file() -> Option<File> {
let exe_dir = std::env::current_exe()
.ok()
.and_then(|p| p.parent().map(|d| d.to_path_buf()));
for dir in [exe_dir, Some(std::env::temp_dir())].into_iter().flatten() {
match OpenOptions::new()
.create(true)
.write(true)
.truncate(true)
.open(dir.join("helper-tray-poc.measure.log"))
{
Ok(f) => return Some(f),
Err(e) => eprintln!("не удалось открыть лог в {}: {}", dir.display(), e),
}
}
None
}
#[cfg_attr(mobile, tauri::mobile_entry_point)]
pub fn run() {
let measure = std::env::args().any(|a| a == "--measure-scenario");
let app = tauri::Builder::default()
.invoke_handler(tauri::generate_handler![first_paint])
.setup(move |app| {
app.manage(AppState {
tray: Mutex::new(None),
open_started: Mutex::new(HashMap::new()),
window_seq: Mutex::new(0),
last_label: Mutex::new(None),
measure: MeasureLog {
started: Instant::now(),
file: Mutex::new(if measure { measure_log_file() } else { None }),
},
});
let tray = build_tray(app.handle())?;
*app.state::<AppState>().tray.lock().unwrap() = Some(tray);
if measure {
app.state::<AppState>().measure.marker("stage app-started");
spawn_measure_scenario(app.handle().clone());
}
Ok(())
})
.build(tauri::generate_context!())
.expect("error while building tauri application");
// Трею нельзя завершаться при закрытии последнего окна (code == None);
// при программном выходе code задан — prevent_exit не вызываем,
// иначе app.exit(0) был бы заблокирован.
app.run(|_handle, event| {
if let tauri::RunEvent::ExitRequested { code, api, .. } = event
&& code.is_none()
{
api.prevent_exit();
}
});
}
+6
View File
@@ -0,0 +1,6 @@
// Prevents additional console window on Windows in release, DO NOT REMOVE!!
#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]
fn main() {
helper_tray_lib::run()
}
+29
View File
@@ -0,0 +1,29 @@
{
"$schema": "https://schema.tauri.app/config/2",
"productName": "shtil-helper-poc",
"version": "0.1.0",
"identifier": "ru.tbsoft.shtil.helper.poc",
"build": {
"beforeDevCommand": "pnpm dev",
"devUrl": "http://localhost:1420",
"beforeBuildCommand": "pnpm build",
"frontendDist": "../dist"
},
"app": {
"windows": [],
"security": {
"csp": "default-src 'self'; style-src 'self' 'unsafe-inline'; connect-src ipc: http://ipc.localhost"
}
},
"bundle": {
"active": true,
"targets": "all",
"icon": [
"icons/32x32.png",
"icons/128x128.png",
"icons/128x128@2x.png",
"icons/icon.icns",
"icons/icon.ico"
]
}
}
+138
View File
@@ -0,0 +1,138 @@
<script setup lang="ts">
import { onMounted, ref } from "vue";
import { invoke } from "@tauri-apps/api/core";
import { getCurrentWebviewWindow } from "@tauri-apps/api/webviewWindow";
// Окна создаются с меткой win-<view>-<n>: view — report | tickets | about.
const view = getCurrentWebviewWindow().label.split("-")[1] ?? "report";
const categories = [
"Не работает программа",
"Компьютер или оборудование",
"Интернет и сеть",
"Другое",
];
const category = ref("");
const description = ref("");
const sent = ref(false);
onMounted(() => {
// Двойной rAF: вторая рамка гарантирует, что первая уже отрисована.
requestAnimationFrame(() => {
requestAnimationFrame(() => {
void invoke("first_paint");
});
});
});
</script>
<template>
<main class="page">
<template v-if="view === 'report'">
<h1>Сообщить о проблеме</h1>
<div class="categories">
<button
v-for="c in categories"
:key="c"
:class="{ active: category === c }"
@click="category = c"
>
{{ c }}
</button>
</div>
<textarea
v-model="description"
rows="6"
placeholder="Опишите, что случилось"
></textarea>
<button
class="send"
:disabled="!category || !description.trim()"
@click="sent = true"
>
Отправить
</button>
<p v-if="sent" class="note">Отправка не выполняется — это прототип.</p>
</template>
<template v-else-if="view === 'tickets'">
<h1>Мои обращения</h1>
<p class="note">Заглушка прототипа. Здесь будет список обращений.</p>
</template>
<template v-else>
<h1>О программе</h1>
<p class="note">«Штиль Помощник» — прототип для замеров (#1.8).</p>
</template>
</main>
</template>
<style scoped>
.page {
padding: 20px;
display: flex;
flex-direction: column;
gap: 14px;
}
h1 {
font-size: 18px;
margin: 0;
}
.categories {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 8px;
}
button {
border: 1px solid #c7c7c7;
border-radius: 8px;
padding: 10px;
font: inherit;
background: #fff;
cursor: pointer;
}
button.active {
border-color: #2f6fdb;
background: #e8f0fc;
}
textarea {
font: inherit;
border: 1px solid #c7c7c7;
border-radius: 8px;
padding: 10px;
resize: vertical;
}
.send {
background: #2f6fdb;
color: #fff;
border-color: #2f6fdb;
}
.send:disabled {
opacity: 0.5;
cursor: default;
}
.note {
color: #666;
margin: 0;
}
</style>
<style>
:root {
font-family: "Segoe UI", system-ui, sans-serif;
font-size: 15px;
color: #1a1a1a;
}
body {
margin: 0;
}
</style>
+4
View File
@@ -0,0 +1,4 @@
import { createApp } from "vue";
import App from "./App.vue";
createApp(App).mount("#app");
+7
View File
@@ -0,0 +1,7 @@
/// <reference types="vite/client" />
declare module "*.vue" {
import type { DefineComponent } from "vue";
const component: DefineComponent<{}, {}, any>;
export default component;
}
+25
View File
@@ -0,0 +1,25 @@
{
"compilerOptions": {
"target": "ES2020",
"useDefineForClassFields": true,
"module": "ESNext",
"lib": ["ES2020", "DOM"],
"skipLibCheck": true,
/* Bundler mode */
"moduleResolution": "bundler",
"allowImportingTsExtensions": true,
"resolveJsonModule": true,
"isolatedModules": true,
"noEmit": true,
"jsx": "preserve",
/* Linting */
"strict": true,
"noUnusedLocals": true,
"noUnusedParameters": true,
"noFallthroughCasesInSwitch": true
},
"include": ["src/**/*.ts", "src/**/*.d.ts", "src/**/*.tsx", "src/**/*.vue"],
"references": [{ "path": "./tsconfig.node.json" }]
}
+10
View File
@@ -0,0 +1,10 @@
{
"compilerOptions": {
"composite": true,
"skipLibCheck": true,
"module": "ESNext",
"moduleResolution": "bundler",
"allowSyntheticDefaultImports": true
},
"include": ["vite.config.ts"]
}
+32
View File
@@ -0,0 +1,32 @@
import { defineConfig } from "vite";
import vue from "@vitejs/plugin-vue";
// @ts-expect-error type error without @types/node package
import process from "node:process";
const host = process.env.TAURI_DEV_HOST;
// https://vite.dev/config/
export default defineConfig(() => ({
plugins: [vue()],
// Vite options tailored for Tauri development and only applied in `tauri dev` or `tauri build`
//
// 1. prevent Vite from obscuring rust errors
clearScreen: false,
// 2. tauri expects a fixed port, fail if that port is not available
server: {
port: 1420,
strictPort: true,
host: host || false,
hmr: host
? {
protocol: "ws",
host,
port: 1421,
}
: undefined,
watch: {
// 3. tell Vite to ignore watching `src-tauri`
ignored: ["**/src-tauri/**"],
},
},
}));
+4
View File
@@ -0,0 +1,4 @@
[toolchain]
channel = "1.99.1"
components = ["rustfmt", "clippy"]
profile = "minimal"
+32
View File
@@ -0,0 +1,32 @@
#!/usr/bin/env node
// Проверка сообщения коммита по правилам docs/contributing.md. Вызывается lefthook (commit-msg).
import { readFileSync } from 'node:fs';
const TYPES = ['feat', 'fix', 'docs', 'chore', 'refactor', 'test', 'perf', 'build', 'ci', 'style', 'revert'];
const SCOPES = ['server', 'agent', 'helper', 'console', 'ui', 'proto', 'api', 'db', 'ci', 'docs', 'roadmap', 'tools', 'deps'];
const HEADER = new RegExp(`^(${TYPES.join('|')})(\\((${SCOPES.join('|')})\\))?!?: (.+)$`);
const REFS = /^Refs: \d+(\.\d+)+(, ?\d+(\.\d+)+)*$/m;
const lines = readFileSync(process.argv[2], 'utf8').split(/\r?\n/).filter(l => !l.startsWith('#'));
const msg = lines.join('\n').trim();
const header = lines[0]?.trim() ?? '';
if (/^(Merge|Revert|fixup!|squash!|amend!) /.test(header)) process.exit(0);
const errors = [];
const m = header.match(HEADER);
if (!m) errors.push(`заголовок должен быть «тип(область): что сделано».\n Типы: ${TYPES.join(', ')}\n Области: ${SCOPES.join(', ')}`);
else {
const desc = m[4];
if (!/[а-яё]/i.test(desc)) errors.push('описание пишется по-русски');
if (/^[А-ЯЁ]/.test(desc)) errors.push('описание начинается с маленькой буквы');
if (/\.$/.test(desc)) errors.push('в конце заголовка не ставится точка');
}
if ([...header].length > 72) errors.push(`заголовок длиннее 72 символов (${[...header].length})`);
if (lines[1]?.trim()) errors.push('после заголовка нужна пустая строка');
if (!REFS.test(msg)) errors.push('нет строки «Refs: <ID пункта>», например «Refs: 2.11.4» или «Refs: 1.2.8, 1.2.9»');
if (errors.length) {
console.error(`\nКоммит отклонён: «${header}»\n${errors.map(e => ' - ' + e).join('\n')}\n\nПример:\n feat(server): добавлен WithTenantTx для доступа к данным организации\n\n Refs: 2.11.4\n\nПравила — docs/contributing.md\n`);
process.exit(1);
}
+171
View File
@@ -0,0 +1,171 @@
#!/usr/bin/env node
// Сводка дорожной карты «Штиль» для AI-ассистентов и людей. Только чтение, без зависимостей, Node 18+.
//
// node tools/roadmap-context/roadmap-context.mjs текущий шаг + последние изменения
// node tools/roadmap-context/roadmap-context.mjs 2 обзор шага 2
// node tools/roadmap-context/roadmap-context.mjs 2.11 задача 2.11 полностью
// node tools/roadmap-context/roadmap-context.mjs --all все шаги подробно (как «Сводка для AI»)
// --remote-data брать план (data.js) с сервера, даже если есть локальный roadmap/data.js
//
// Переменные окружения: ROADMAP_URL, ROADMAP_AUTH («логин:пароль» для Basic Auth), ROADMAP_DATA.
import { readFile } from 'node:fs/promises';
import { existsSync } from 'node:fs';
import vm from 'node:vm';
const BASE = (process.env.ROADMAP_URL || 'https://locshare.ru/roadmap').replace(/\/+$/, '');
const AUTH = process.env.ROADMAP_AUTH;
const LOCAL = process.env.ROADMAP_DATA || 'roadmap/data.js';
const args = process.argv.slice(2);
const flag = n => args.includes(n);
const target = args.find(a => !a.startsWith('--'));
const STATUS = { todo: 'Не начато', doing: 'В работе', review: 'На проверке', done: 'Выполнено', blocked: 'Заблокировано' };
const KINDS = { comment: 'Комментарий', question: 'Вопрос', proposal: 'Предложение', blocker: 'Блокер', decision: 'Решение' };
const DEC = { open: 'Не обсуждали', discuss: 'Обсуждаем', accepted: 'Принято', postponed: 'Отложено' };
const PRIO = { normal: 'Обычный', high: 'Высокий', critical: 'Критичный' };
async function get(path, kind) {
const headers = AUTH ? { Authorization: 'Basic ' + Buffer.from(AUTH).toString('base64') } : {};
const r = await fetch(BASE + path, { headers, cache: 'no-store', signal: AbortSignal.timeout(15000) });
if (!r.ok) throw new Error(`${path}: HTTP ${r.status}`);
return kind === 'json' ? r.json() : r.text();
}
function evalPlan(src) {
const sandbox = { window: {} };
vm.runInNewContext(src, sandbox, { timeout: 1000 });
if (!sandbox.window.SHTIL_ROADMAP) throw new Error('data.js не содержит window.SHTIL_ROADMAP');
return sandbox.window.SHTIL_ROADMAP;
}
async function loadPlan(warn) {
const hasLocal = existsSync(LOCAL) && !flag('--remote-data');
const remote = await get('/roadmap/data.js', 'text').catch(e => (hasLocal ? null : Promise.reject(e)));
if (!hasLocal) return { plan: evalPlan(remote), source: BASE + '/roadmap/data.js' };
const local = await readFile(LOCAL, 'utf8');
if (remote !== null && remote.replace(/\r\n/g, '\n') !== local.replace(/\r\n/g, '\n'))
warn.push(`Локальный ${LOCAL} отличается от data.js на сервере: подтяните main или обновите сервер.`);
return { plan: evalPlan(local), source: LOCAL };
}
const strip = s => String(s ?? '')
.replace(/<\/(p|div|tr|pre|ul|ol|table)>/gi, '\n').replace(/<br\s*\/?>/gi, '\n')
.replace(/<li>/gi, '\n- ').replace(/<t[dh][^>]*>/gi, ' | ').replace(/<[^>]+>/g, '')
.replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').replace(/&#92;/g, '\\').replace(/&amp;/g, '&')
.replace(/[ \t]+\n/g, '\n').replace(/\n{3,}/g, '\n\n').trim();
const oneLine = s => strip(s).replace(/\s*\n\s*/g, ' ');
const day = iso => (iso ? String(iso).slice(0, 10) : '—');
const indent = s => String(s).replace(/\n/g, '\n ');
function build(plan, P) {
const nameOf = id => P.members?.[id]?.name || id || '—';
const steps = plan.phases.flatMap(ph => (ph.steps || []).map(st => ({ ...st, phase: ph })));
const tasks = Object.fromEntries(steps.flatMap(st => (st.tasks || []).map(t => [t.id, { t, step: st }])));
const tstate = id => ({ status: 'todo', assignees: [], priority: 'normal', ...(P.tasks?.[id] || {}) });
const live = (sec, id) => Object.entries(P[sec] || {}).map(([k, v]) => ({ id: k, ...v })).filter(x => x.task === id && !x.deleted);
const items = id => [
...(tasks[id].t.subtasks || []).map(([sid, text]) => ({ id: sid, text })),
...live('custom', id).map(c => ({ id: c.id, text: c.text, own: nameOf(c.by) })),
];
const done = iid => !!P.items?.[iid]?.done;
const stats = id => { const it = items(id); return { done: it.filter(i => done(i.id)).length, total: it.length }; };
const comments = id => live('comments', id).sort((a, b) => String(a.created_at).localeCompare(String(b.created_at)));
const answer = (id, i) => P.answers?.[`${id}~${i}`];
function taskLine(id) {
const { t } = tasks[id], st = tstate(id), s = stats(id), cs = comments(id);
const q = (t.discuss || []).length, qa = (t.discuss || []).filter((_, i) => answer(id, i + 1)?.text).length;
const parts = [`${s.done}/${s.total}`];
if (st.assignees.length) parts.push(st.assignees.map(nameOf).join(', '));
if (st.priority !== 'normal') parts.push('приоритет: ' + PRIO[st.priority]);
if (st.due) parts.push('срок ' + st.due);
if (t.decision) parts.push('решение: ' + DEC[P.decisions?.[id]?.status || 'open']);
if (q) parts.push(`ответов на вопросы ${qa}/${q}`);
const blk = cs.filter(c => c.kind === 'blocker' && !c.resolved).length;
const oq = cs.filter(c => c.kind === 'question' && !c.resolved).length;
if (blk) parts.push(`БЛОКЕРЫ: ${blk}`);
if (oq) parts.push(`открытые вопросы в обсуждении: ${oq}`);
return `- [${STATUS[st.status] || st.status}] ${id} ${t.title} · ${parts.join(' · ')}`;
}
function stepBlock(st, detailed) {
const all = (st.tasks || []).map(t => stats(t.id)).reduce((a, s) => ({ d: a.d + s.done, n: a.n + s.total }), { d: 0, n: 0 });
const cur = plan.meta.current?.step === st.id ? ' ← ТЕКУЩИЙ' : '';
const L = [`## Шаг ${st.id} · ${st.title} (${st.period}, версия ${st.version})${cur} — пунктов ${all.d}/${all.n}`, oneLine(st.goal)];
if (!st.tasks) { if (st.preview) L.push('Планируется: ' + st.preview.join('; ')); return L; }
if (st.outcome) L.push('Результат шага: ' + st.outcome.join('; '));
L.push('');
(st.tasks || []).forEach(t => (detailed ? L.push(...taskDetail(t.id), '') : L.push(taskLine(t.id))));
return L;
}
function taskDetail(id) {
const { t, step } = tasks[id], st = tstate(id), s = stats(id);
const L = [`### [${id}] ${t.title}`,
`Шаг ${step.id} · области: ${(t.area || []).map(a => plan.areas[a] || a).join(', ')} · тип: ${plan.types[t.type] || t.type}${t.adr ? ' · ADR-' + t.adr : ''}`,
`Статус: ${STATUS[st.status]} · пункты ${s.done}/${s.total}` + (st.assignees.length ? ' · исполнители: ' + st.assignees.map(nameOf).join(', ') : '') + (st.due ? ' · срок ' + st.due : '') + (st.priority !== 'normal' ? ' · приоритет: ' + PRIO[st.priority] : '')];
if (t.why) L.push('', '**Зачем:** ' + oneLine(t.why));
if (t.body) L.push('', '**Описание:**', strip(t.body));
if (t.recommend) L.push('', '**Рекомендация:**', strip(t.recommend));
if (t.discuss?.length) {
L.push('', '**Вопросы:**');
t.discuss.forEach((q, i) => { const a = answer(id, i + 1); L.push(`- В${i + 1}: ${oneLine(q)}`, a?.text ? ` Ответ (${nameOf(a.by)}, ${day(a.at)}): ${indent(a.text)}` : ' Ответа нет'); });
}
if (t.decision) { const d = P.decisions?.[id] || {}; L.push('', `**Решение [${DEC[d.status || 'open']}]:** ${d.text ? indent(d.text) : '—'}`); }
L.push('', '**Выполнение:**', ...items(id).map(i => `- [${done(i.id) ? 'x' : ' '}] ${i.own ? `«${i.text}» (свой пункт, ${i.own}, ${i.id})` : `${i.id} ${oneLine(i.text)}`}`));
if (t.done) L.push('', '**Готово, когда:** ' + oneLine(t.done));
if (t.artifacts?.length) L.push('**Артефакты:** ' + t.artifacts.join(', '));
const n = P.notes?.[id];
if (n?.text?.trim()) L.push('', `**Заметка (${nameOf(n.by)}):**`, n.text.trim());
const cs = comments(id);
if (cs.length) { L.push('', '**Обсуждение:**'); cs.forEach(c => L.push(`- ${day(c.created_at)} ${nameOf(c.author)} [${KINDS[c.kind || 'comment']}${c.resolved ? ', решено' : ''}]: ${indent(c.text)}`)); }
const ls = live('links', id);
if (ls.length) L.push('', '**Ссылки:** ' + ls.map(l => (l.title ? l.title + ' — ' : '') + l.url).join('; '));
return L;
}
function recent(limit) {
const ev = [];
for (const [k, v] of Object.entries(P.items || {})) if (v?.done) ev.push([v.at, v.by, `отметил(а) пункт ${k}`]);
for (const [k, v] of Object.entries(P.tasks || {})) ev.push([v.at, v.by, `задача ${k}: ${STATUS[v.status] || v.status}`]);
for (const [k, v] of Object.entries(P.decisions || {})) ev.push([v.at, v.by, `решение ${k}: ${DEC[v.status || 'open']}${v.text ? ' — ' + oneLine(v.text).slice(0, 120) : ''}`]);
for (const [k, v] of Object.entries(P.answers || {})) if (v?.text) ev.push([v.at, v.by, `ответ на ${k.replace('~', ' В')}: ${oneLine(v.text).slice(0, 120)}`]);
for (const c of Object.values(P.comments || {})) if (!c.deleted) ev.push([c.created_at, c.author, `${KINDS[c.kind || 'comment']} в ${c.task}: ${oneLine(c.text).slice(0, 120)}`]);
return ev.filter(e => e[0]).sort((a, b) => String(b[0]).localeCompare(String(a[0]))).slice(0, limit)
.map(([at, by, text]) => `- ${String(at).slice(0, 16).replace('T', ' ')} ${nameOf(by)}: ${text}`);
}
return { steps, tasks, stepBlock, taskDetail, recent, nameOf };
}
async function main() {
const warn = [];
const [{ plan, source }, P] = await Promise.all([
loadPlan(warn),
get('/api/progress', 'json').catch(e => { throw new Error(`прогресс недоступен (${e.message}). Попросите пользователя вставить «Настройки → Сводка для AI».`); }),
]);
const R = build(plan, P);
const cur = plan.meta.current || {};
const out = [`# Дорожная карта «Штиль» · ревизия ${P.revision ?? '—'} · прогресс от ${day(P.updated_at)} · план от ${plan.meta.updated} (${source})`,
`Текущая фаза ${cur.phase}, шаг ${cur.step}. Команда: ${Object.values(P.members || {}).filter(m => !m.archived).map(m => m.name + (m.role ? ` (${m.role})` : '')).join(', ') || '—'}`];
if (warn.length) out.push(...warn.map(w => '> ВНИМАНИЕ: ' + w));
out.push('');
if (target && /^\d+\.\d+$/.test(target)) {
if (!R.tasks[target]) throw new Error(`задачи ${target} нет в плане`);
out.push(...R.taskDetail(target));
} else if (flag('--all')) {
R.steps.forEach(st => out.push(...R.stepBlock(st, !!st.tasks), ''));
} else {
const id = target || cur.step;
const st = R.steps.find(s => s.id === id);
if (!st) throw new Error(`шага ${id} нет в плане`);
out.push(...R.stepBlock(st, false), '', '## Последние изменения', ...R.recent(15));
const next = R.steps.filter(s => Number(s.id) > Number(id)).slice(0, 2).map(s => `${s.id} · ${s.title}`);
if (next.length) out.push('', 'Дальше: ' + next.join('; '));
}
process.stdout.write(out.join('\n') + '\n');
}
main().catch(e => { console.error('roadmap-context: ' + e.message); process.exit(1); });