# 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](https://github.com/mars485/itgroup-modx-mcp). Текущая версия и развёртывание требуют отдельной сверки с рабочей системой.
- Google Drive: поиск возвращает в том числе журналы и резервные копии. Их содержимое и вложения BookStack не аудировались; считать их подтверждённой документацией нельзя.
- Изображений, вставленных через Markdown в 21 проверенной странице, нет. Отдельные файлы BookStack MCP не перечисляет, поэтому отсутствие вложений не подтверждено.
- Из текста страниц не выявлены очевидные токены или приватные ключи. Проверка прав доступа и OAuth allowlist по конфигурации сервера остаётся открытой.