docs: ТЗ v2 — QR-доступ, меню разделов, коммит по дереву, агент со стражем, общие алерты

ADR-011 (QR-приглашения), ADR-012 (командная модель), ADR-013 (агент логов).

Refs #24

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-13 22:50:31 +03:00
co-authored by Claude Opus 5.5
parent af1585c634
commit d34bc33aeb
5 changed files with 364 additions and 200 deletions
+9 -5
View File
@@ -4,20 +4,24 @@
- [ ] **Официальное ТЗ** — сверить с [`SPEC.md`](SPEC.md), расхождения → ADR.
- [ ] **LLM:** какую модель берём (YandexGPT / OpenAI / локальная) и кто платит за токены? Архитектура не зависит (ADR-008).
- [ ] **anytask:** что именно интегрировать — отправку решений, оценки, уведомления? (SPEC F-61)
- [ ] **anytask:** что именно интегрировать — отправку решений, оценки, уведомления? (SPEC X-2)
- [ ] **Чужой код на сервере Vobot:** ок ли временно (ADR-005), или сразу берём отдельный VPS под приложения?
- [ ] **Доступ:** кто в белом списке на защите — только мы или вся группа/преподаватель?
- [ ] **Сеть для приложений:** нужен ли интернет скриптам пользователей (например, свои боты)? По умолчанию выключен.
- [ ] **Приглашения:** хватает одноразового QR на 24 ч, или нужен ещё «групповой» QR на N входов для защиты (преподаватель + группа)?
- [ ] **Сеть для сервисов:** нужен ли интернет сервисам (например, свои боты)? По умолчанию выключен.
- [ ] **Ветки в репозитории загрузок:** v2 — коммит только в `main`. Нужен ли выбор ветки?
## Решено
- ~~Кто может пользоваться ботом~~ — только по QR-приглашению → ADR-011.
- ~~Проекты с владельцами или общий репозиторий~~ — общий, командная модель → ADR-012.
- ~~Container registry на SourceCraft~~ — есть, но требует биллинга Yandex Cloud → ADR-004.
- ~~Как бот узнаёт статус CI~~ — polling API → ADR-003.
- ~~Где деплоим~~ — Compose где угодно, основной хост — VPS vobot → SPEC §5.1.
## Идеи
- Еженедельная сводка по проектам (SPEC F-62).
- Откат на ревизию (SPEC F-60).
- Еженедельная сводка (SPEC X-3).
- История и откат файла (SPEC X-1).
- Личная «тишина» для алертов (SPEC AL-7).
- Бейдж статуса CI в README загрузок.
- Экспорт метрик в Prometheus (на хосте уже есть мониторинг Vobot).