20 — Контроль качества и актуализация
Контроль качества и актуализация базы знаний ITG
Назначение
Проверка доступности BookStack, структуры книги ITG и актуальности эксплуатационных инструкций. Книга HomeLab (ID 2) исключена из любых операций записи.
Подтверждённая структура на 11.10.2026
- Книга ITG: ID 4; глав: 5; страниц:
20.21. - Главы: 25 (4 страницы), 26 (4), 27 (3), 28 (5), 29 (
3)4). - Навигация ID 5 находится в корне.
- MCP: 9 инструментов, включая создание главы и перенос страницы.
Автоматизированный контрольконтроль: фактическое состояние
Workflow n8n ITG — BookStack health and quality gate (план)ID puOTAOvlbzAiH0ze) активен, проверяет публичную страницу книги и навигацию, сохраняет результаты и отпечаток содержимого. Ожидаемая структура в коде: 21 страница и 5 глав. Последний автоматический запуск 11.10.2026, execution 136, завершился ошибкой на Get ITG wiki: getaddrinfo EAI_AGAIN wiki.karpiev.ru. До устранения DNS-сбоя ежедневная проверка не считается работающей. Ручные успешные запуски до него не заменяют подтверждение запуска по расписанию. Время триггера настроено на 09:00 в часовом поясе workflow; в данных запуска указан America/New_York, фактическое соответствие требуемому часовому поясу нужно проверить.
Регламент проверок
- Ежедневно: HTTP-проверка доступности страницы книги и ожидаемого содержимого.
- Еженедельно: сверка списка страниц и глав с BookStack API, поиск пропавших и перемещённых страниц.
- После изменений: проверка ссылок, соответствия инструкций текущим конфигурациям, наличия владельца и даты проверки.
- При расхождениях: журнал инцидента и уведомление; изменения документации только после подтверждения фактов.
- Ежемесячно: ревизия резервного копирования, восстановления и прав доступа.
Критерии качества
- Не менее
2021страниц,страницы, 5 глав, страница ID 5 в корне (пока структура не изменена намеренно). - Все страницы находятся в книге ID 4.
- Отсутствуют секреты в тексте страниц.
- Есть источник фактов, дата проверки и процедура отката для критичных сервисов.
- Не публиковать автоматически непроверенные данные из внешних источников.
Защита от ложных обновлений
- Данные из MCP и API считать снимком на момент проверки.
- Если API недоступен, не заменять страницы пустыми данными.
- Изменения проводить по принципу diff → проверка → запись → повторное чтение.
- Для массовой записи требуется журнал и резервная копия.
Статус
Документ регламента создан. Фактическая готовность автоматизации определяется отдельно по выполнению и тестам workflow n8n.