Документация из кода и её поддержка
Гермес поддерживает документацию в актуальном состоянии: генерирует и обновляет описания из кода и изменений, подсвечивает устаревшее. Документация перестаёт отставать от продукта.
Как это происходит — процесс по шагам
Схема запускается сама и идёт по кругу. Нажмите на любой шаг — чтобы остановиться и прочитать его подробнее.
Сколько это приносит — формула Q × P
Q — документ/мес (атомарных единиц процесса). P — деньги на одной единице (экономия времени). Эффект = Q × P за месяц.
Малая · до ~50 человек
30 × 500 ₽
15 тыс ₽/мес
Средняя · ~50–500 человек
250 × 650 ₽
163 тыс ₽/мес
Крупная · 500+ человек
2 000 × 820 ₽
1.6 млн ₽/мес
Спецификация сценария (по Вигерсу)
- ID сценария
- HERMES-UC-063
- Название
- Документация из кода и её поддержка
- Действующее лицо
- Разработчик / технический писатель
- Заинтересованные стороны
- Разработчик — доки не отстают от кода
- Новые сотрудники — актуальная документация
- Поддержка — меньше вопросов из-за устаревших доков
- Предусловия
- Доступ к коду и репозиторию документации
- Заданы формат и структура доков
- Триггер
- Изменения в коде/API, влияющие на документацию
- Основной сценарий
- 1.Гермес определяет затронутые изменением разделы.
- 2.Готовит или обновляет соответствующие тексты.
- 3.Передаёт инженеру на проверку и принятие.
- 4.Помечает давно не обновлявшиеся разделы.
- Расширения и исключения
- 2aНужны доменные пояснения — агент запрашивает их у автора кода.
- 3aРевьюер отклонил — текст дорабатывается по замечаниям.
- Постусловия
- Документация соответствует текущему состоянию
- Устаревшее подсвечено
- Бизнес-правила
- Публикация — после ревью
- Единый стиль документации
- Частота
- По изменениям + периодический аудит
- Допущения
- Документация ведётся в репозитории
Операционная модель — стоимость владения за 3 года
Совокупная стоимость владения (TCO) за 36 месяцев против эффекта Q × P. Числа выше — по облачным ценам токенов OpenRouter (модель уровня сценария — Gemini 3 Flash Preview), инференс учтён отдельной строкой. Инфраструктура и надзор делятся на все сценарии — здесь показана доля, относимая на этот; для одного отдельного сценария на своём сервере она была бы выше. Самообучение удешевляет токены по годам, эффект выходит на полную мощность не сразу. Лицензия Гермеса — 0 ₽ (MIT); self-hosting на своих весах меняет плату за токены на GPU и электричество. Числа — оценка для прикидки, не оферта.
Малая · до ~50 человек
TCO 3 года
98 тыс ₽
Эффект 3 года
495 тыс ₽
Чистыми
397 тыс ₽
ROI
5.1×
Окупаемость
3 мес
| Год | Затраты | Эффект | Чистыми |
|---|---|---|---|
| 1 | 46 тыс ₽ | 126 тыс ₽ | 80 тыс ₽ |
| 2 | 26 тыс ₽ | 180 тыс ₽ | 154 тыс ₽ |
| 3 | 26 тыс ₽ | 189 тыс ₽ | 163 тыс ₽ |
| Итого | 98 тыс ₽ | 495 тыс ₽ | 397 тыс ₽ |
Из чего складывается в месяц: инфраструктура 600 ₽ (доля общей установки) · инференс 43 ₽ · надзор 2 тыс ₽ (доля) · плюс внедрение 20 тыс ₽ разово · лицензия ПО 0 ₽ (MIT). Оценка.
Средняя · ~50–500 человек
TCO 3 года
302 тыс ₽
Эффект 3 года
5.4 млн ₽
Чистыми
5.1 млн ₽
ROI
17.8×
Окупаемость
1 мес
| Год | Затраты | Эффект | Чистыми |
|---|---|---|---|
| 1 | 138 тыс ₽ | 1.4 млн ₽ | 1.2 млн ₽ |
| 2 | 82 тыс ₽ | 1.9 млн ₽ | 1.9 млн ₽ |
| 3 | 82 тыс ₽ | 2.0 млн ₽ | 2.0 млн ₽ |
| Итого | 302 тыс ₽ | 5.4 млн ₽ | 5.1 млн ₽ |
Из чего складывается в месяц: инфраструктура 2 тыс ₽ (доля общей установки) · инференс 357 ₽ · надзор 5 тыс ₽ (доля) · плюс внедрение 55 тыс ₽ разово · лицензия ПО 0 ₽ (MIT). Оценка.
Крупная · 500+ человек
TCO 3 года
839 тыс ₽
Эффект 3 года
54 млн ₽
Чистыми
53 млн ₽
ROI
64.5×
Окупаемость
1 мес
| Год | Затраты | Эффект | Чистыми |
|---|---|---|---|
| 1 | 364 тыс ₽ | 14 млн ₽ | 13 млн ₽ |
| 2 | 239 тыс ₽ | 20 млн ₽ | 19 млн ₽ |
| 3 | 236 тыс ₽ | 21 млн ₽ | 20 млн ₽ |
| Итого | 839 тыс ₽ | 54 млн ₽ | 53 млн ₽ |
Из чего складывается в месяц: инфраструктура 5 тыс ₽ (доля общей установки) · инференс 3 тыс ₽ · надзор 13 тыс ₽ (доля) · плюс внедрение 120 тыс ₽ разово · лицензия ПО 0 ₽ (MIT). Оценка.