# Поддержка RAGRAF

Страница отвечает на один вопрос: чего можно ждать и чего ждать нельзя.
Обещания здесь не округляются в свою пользу.

## Community (то, что доступно всем)

| Что | Как |
|---|---|
| Сообщить о дефекте | обращение в трекер проекта с командой и выводом |
| Сообщить о расхождении документа с кодом | там же, со ссылкой `файл:строка` |
| Задать вопрос по использованию | там же |

**Чего нет:** сроков ответа, гарантии исправления и канала с обязательством
реакции. Community поддерживается по возможности: воспроизводимый дефект с
командой и выводом разбирается быстрее, чем описание «не работает». Это
описание порядка работы, а не SLA.

## Платная поддержка

Появляется в изданиях **Pro** и **Enterprise**: сроки реакции, сопровождение
внедрения, помощь с коннекторами и общим индексом. На 24.10.2026 эти издания
не выпущены, поэтому платной поддержки сейчас нет — и продавать её раньше
времени мы не будем.

## Уязвимости

О найденной уязвимости пишите на **mid1977@gmail.com**, а не в публичный трекер:
публичное обращение раскрывает проблему раньше исправления. В обращении полезны
версия, команда воспроизведения и то, что видно снаружи (файл, эндпоинт, ответ).

Отдельный файл `SECURITY.md` с моделью угроз появится в публикуемом дереве на
следующем этапе подготовки к выпуску; до этого действует адрес выше. Хранилище
секретов и его границы уже описаны в
[`SECRETS-VAULT.md`](docs/03_implementation/SECRETS-VAULT.md).

## Что мы считаем хорошим сообщением

- воспроизводимый дефект: команда, вывод, версия, ревизия индекса;
- расхождение документа с кодом со ссылкой `файл:строка`;
- случай деградации, который продукт не назвал (молчаливая потеря, ложный
  режим `full`, отчёт, расходящийся со своими числами).

Предложения по архитектуре обсуждаются охотнее, чем большие патчи без
предварительного разговора. Условия вклада — в [`CLA.md`](CLA.md).

## Уровни поддержки (черновик, ждёт решения владельца)

Уровни описаны в `docs/03_implementation/legal/SLA.md`. Пока это **черновик**: сроки
реакции и исправления в нём помечены как решения владельца, а не выдуманы.
Действует только то, что написано выше: Community — по возможности, без сроков.

Что уже можно утверждать по факту, потому что это проверяется командами:

| Утверждение | Чем проверяется |
|---|---|
| журнал доступа к секретам нельзя переписать, а порчу видно | `python tools/ragraf.py secrets audit --verify` (цепочка хэшей) |
| выгрузка журнала подписана и проверяема | `python tools/ragraf.py secrets audit --export <файл>` |
| панель отказывает чужому источнику | `python tests/test_admin_origin.py` |
| состав поставки и SBOM сходятся с кодом | `python tools/release/sbom.py --out <файл>`, `python tools/release/verify_release.py --tree <дерево>` |
| офлайн-набор ставится без сети | `pwsh -File scripts/install-airgap.ps1 -Set <набор> -SelfTest` |