Skip to main content

20 — Контроль качества и актуализация

Контроль качества и актуализация базы знаний ITG

Назначение

Проверка доступности BookStack, структуры книги ITG и актуальности эксплуатационных инструкций. Книга HomeLab (ID 2) исключена из любых операций записи.

Подтверждённая структура на 11.10.2026

  • Книга ITG: ID 4; глав: 5; страниц: 20.
  • Главы: 25 (4 страницы), 26 (4), 27 (3), 28 (5), 29 (3).
  • Навигация ID 5 находится в корне.
  • MCP: 9 инструментов, включая создание главы и перенос страницы.

Автоматизированный контроль (план)

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

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

  • Не менее 20 страниц, 5 глав, страница ID 5 в корне (пока структура не изменена намеренно).
  • Все страницы находятся в книге ID 4.
  • Отсутствуют секреты в тексте страниц.
  • Есть источник фактов, дата проверки и процедура отката для критичных сервисов.
  • Не публиковать автоматически непроверенные данные из внешних источников.

Защита от ложных обновлений

  • Данные из MCP и API считать снимком на момент проверки.
  • Если API недоступен, не заменять страницы пустыми данными.
  • Изменения проводить по принципу diff → проверка → запись → повторное чтение.
  • Для массовой записи требуется журнал и резервная копия.

Статус

Документ регламента создан. Фактическая готовность автоматизации определяется отдельно по выполнению и тестам workflow n8n.