20 — Контроль качества и актуализация
Контроль качества и актуализация базы знаний ITG
Назначение
Проверка доступности BookStack, структуры книги ITG и актуальности эксплуатационных инструкций. Книга HomeLab (ID 2) исключена из любых операций записи.
Подтверждённая структура на 11.10.2026
- Книга ITG: ID 4; глав: 5; страниц: 21.
- Главы: 25 (4 страницы), 26 (4), 27 (3), 28 (5), 29 (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, поиск пропавших и перемещённых страниц.
- После изменений: проверка ссылок, соответствия инструкций текущим конфигурациям, наличия владельца и даты проверки.
- При расхождениях: журнал инцидента и уведомление; изменения документации только после подтверждения фактов.
- Ежемесячно: ревизия резервного копирования, восстановления и прав доступа.
Критерии качества
- Не менее 21 страницы, 5 глав, страница ID 5 в корне (пока структура не изменена намеренно).
- Все страницы находятся в книге ID 4.
- Отсутствуют секреты в тексте страниц.
- Есть источник фактов, дата проверки и процедура отката для критичных сервисов.
- Не публиковать автоматически непроверенные данные из внешних источников.
Защита от ложных обновлений
- Данные из MCP и API считать снимком на момент проверки.
- Если API недоступен, не заменять страницы пустыми данными.
- Изменения проводить по принципу diff → проверка → запись → повторное чтение.
- Для массовой записи требуется журнал и резервная копия.
Статус
Документ регламента создан. Фактическая готовность автоматизации определяется отдельно по выполнению и тестам workflow n8n.
Источники и ограничения аудита 11.10.2026
- Состав книги, тексты и привязка страниц: чтение BookStack MCP, книга ID 4. Проверены 21 страница и 5 глав; пустых страниц в этом составе нет.
- Доступные чаты проекта и смежные чаты сверялись по доступной истории Codex; полный архив проекта через этот интерфейс не гарантирован.
- GitHub: найден приватный репозиторий mars485/itgroup-modx-mcp. Текущая версия и развёртывание требуют отдельной сверки с рабочей системой.
- Google Drive: поиск возвращает в том числе журналы и резервные копии. Их содержимое и вложения BookStack не аудировались; считать их подтверждённой документацией нельзя.
- Изображений, вставленных через Markdown в 21 проверенной странице, нет. Отдельные файлы BookStack MCP не перечисляет, поэтому отсутствие вложений не подтверждено.
- Из текста страниц не выявлены очевидные токены или приватные ключи. Проверка прав доступа и OAuth allowlist по конфигурации сервера остаётся открытой.