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, фактическое соответствие требуемому часовому поясу нужно проверить.

Регламент проверок

1. Ежедневно: HTTP-проверка доступности страницы книги и ожидаемого содержимого.
2. Еженедельно: сверка списка страниц и глав с BookStack API, поиск пропавших и перемещённых страниц.
3. После изменений: проверка ссылок, соответствия инструкций текущим конфигурациям, наличия владельца и даты проверки.
4. При расхождениях: журнал инцидента и уведомление; изменения документации только после подтверждения фактов.
5. Ежемесячно: ревизия резервного копирования, восстановления и прав доступа.

Критерии качества

• Не менее 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 по конфигурации сервера остаётся открытой.