docs: ТЗ v1, архитектура, ADR-002..009, открытые вопросы

Refs #2

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-12 18:32:54 +03:00
co-authored by Claude Opus 5.5
parent 74aabba5dc
commit 018e3d26c4
4 changed files with 428 additions and 39 deletions
+16 -10
View File
@@ -2,16 +2,22 @@
## Вопросы
- [ ] Что именно делает CD: куда «доставляется» загруженный `.py` (запуск как сервис? проверка тестами?)
- [ ] Есть ли на SourceCraft container registry, или пушим образы в другое место?
- [ ] Где деплоим: VPS или локально? Нужна ли БД (пользователи, история загрузок)?
- [ ] Как бот узнаёт статус CI: polling SourceCraft API или webhook?
- [ ] Кто может загружать файлы: любой пользователь или whitelist?
- [ ] Какой LLM-провайдер для чата по логам?
- [ ] Нужна ли интеграция с anytask и в каком виде?
- [ ] **Официальное ТЗ** — сверить с [`SPEC.md`](SPEC.md), расхождения → ADR.
- [ ] **LLM:** какую модель берём (YandexGPT / OpenAI / локальная) и кто платит за токены? Архитектура не зависит (ADR-008).
- [ ] **anytask:** что именно интегрировать — отправку решений, оценки, уведомления? (SPEC F-61)
- [ ] **Чужой код на сервере Vobot:** ок ли временно (ADR-005), или сразу берём отдельный VPS под приложения?
- [ ] **Доступ:** кто в белом списке на защите — только мы или вся группа/преподаватель?
- [ ] **Сеть для приложений:** нужен ли интернет скриптам пользователей (например, свои боты)? По умолчанию выключен.
## Решено
- ~~Container registry на SourceCraft~~ — есть, но требует биллинга Yandex Cloud → ADR-004.
- ~~Как бот узнаёт статус CI~~ — polling API → ADR-003.
- ~~Где деплоим~~ — Compose где угодно, основной хост — VPS vobot → SPEC §5.1.
## Идеи
- Команда `/logs` с фильтрами (сервис, уровень, период).
- LLM формирует `grep`/запрос к логам, выполняет его в песочнице, суммирует результат.
- Алерты: падение пайплайна, рестарт контейнера, CPU/RAM выше порога.
- Еженедельная сводка по проектам (SPEC F-62).
- Откат на ревизию (SPEC F-60).
- Бейдж статуса CI в README загрузок.
- Экспорт метрик в Prometheus (на хосте уже есть мониторинг Vobot).