# ITG — База знаний

Централизованная документация ITG: проекты, инфраструктура, интеграции, процессы и инструкции.

# 00 — Навигация

# ITG — База знаний

## Быстрая навигация

### Проекты и CRM
- [Проекты](https://wiki.karpiev.ru/books/itg-baza-znanii/page/01-proekty) · ID 6
- [CRM](https://wiki.karpiev.ru/books/itg-baza-znanii/page/05-crm) · ID 15
- [Twenty: объекты](https://wiki.karpiev.ru/books/itg-baza-znanii/page/12-twenty-crm-struktura-dannyx) · ID 17
- [CRM: диагностика и follow-up](https://wiki.karpiev.ru/books/itg-baza-znanii/page/18-crm-diagnostika-i-follow-up) · ID 23

### Инфраструктура
- [Инфраструктура](https://wiki.karpiev.ru/books/itg-baza-znanii/page/02-infrastruktura) · ID 7
- [ZimaOS и Docker](https://wiki.karpiev.ru/books/itg-baza-znanii/page/06-zimaos-i-docker) · ID 10
- [Реестр сервисов](https://wiki.karpiev.ru/books/itg-baza-znanii/page/11-reestr-servisov-itg) · ID 16
- [Docker: безопасное обновление](https://wiki.karpiev.ru/books/itg-baza-znanii/page/16-docker-bezopasnoe-obnovlenie) · ID 21

### Сайт и MODX
- [MODX и сайт](https://wiki.karpiev.ru/books/itg-baza-znanii/page/07-modx-i-sait-itg) · ID 11
- [MODX: фактическая структура](https://wiki.karpiev.ru/books/itg-baza-znanii/page/13-modx-proverennaia-struktura) · ID 18
- [MODX: публикация и откат](https://wiki.karpiev.ru/books/itg-baza-znanii/page/19-modx-publikaciia-i-otkat) · ID 24

### Интеграции и аналитика
- [Интеграции](https://wiki.karpiev.ru/books/itg-baza-znanii/page/03-integracii-i-avtomatizaciia) · ID 8
- [MCP и ChatGPT](https://wiki.karpiev.ru/books/itg-baza-znanii/page/08-mcp-i-chatgpt) · ID 12
- [BookStack MCP: эксплуатация](https://wiki.karpiev.ru/books/itg-baza-znanii/page/17-bookstack-mcp-ekspluataciia) · ID 22
- [n8n](https://wiki.karpiev.ru/books/itg-baza-znanii/page/09-n8n-i-avtomatizaciia) · ID 13
- [Аналитика](https://wiki.karpiev.ru/books/itg-baza-znanii/page/10-veb-analitika-i-reklama) · ID 14

### Эксплуатация
- [Регламенты](https://wiki.karpiev.ru/books/itg-baza-znanii/page/04-reglamenty-i-instrukcii) · ID 9
- [Резервные копии](https://wiki.karpiev.ru/books/itg-baza-znanii/page/14-rezervnoe-kopirovanie-i-vosstanovlenie) · ID 19
- [Инциденты](https://wiki.karpiev.ru/books/itg-baza-znanii/page/15-diagnostika-i-incidenty) · ID 20


- [Контроль качества и актуализация](https://wiki.karpiev.ru/books/itg-baza-znanii/page/20-kontrol-kacestva-i-aktualizaciia) · ID 30

## Стандарты документации
1. Проверенные факты отделять от рекомендаций и планов.
2. Не публиковать токены, пароли, ключи, конфиденциальные данные.
3. Для изменения фиксировать резервную копию, результат проверки и откат.
4. Для каждого сервиса поддерживать ответственного, каталог конфигурации, мониторинг и процедуру восстановления.

## Текущий статус
Книга содержит **21 страницу**, включая эту навигацию: 20 страниц в пяти главах и эта страница в корне. Состав и привязка страниц повторно проверены через MCP 11.10.2026. Инструменты создания глав и переноса страниц уже доступны; HomeLab (книга ID 2) не изменять.

# 01 — Проекты и CRM

Раздел базы знаний ITG

# 01 — Проекты

# Проекты ITG

## ITG — веб-студия
- Основной сайт: https://itgsystem.ru
- Услуги: разработка и модернизация сайтов, SEO, реклама, аналитика, автоматизация.
- Приоритетные сегменты: агентства недвижимости и малый бизнес.

## CRM
- **Twenty CRM:** https://crm.itgsystem.online — рабочая self-hosted CRM.
- **StudioFlow:** собственный проект CRM на FastAPI и PostgreSQL.

## Прочие направления
- ITG USA — развитие веб-услуг на рынке США.
- AI Prompt Service — сервис генерации промптов.
- Автоматизированный аудит сайтов — отчёт, отправка клиенту и фиксация в CRM.

## Шаблон карточки проекта
- Цель и аудитория
- Репозиторий и окружения
- Текущий статус (подтвердить)
- Ответственные и зависимости
- Следующие задачи
- Риски и критерии готовности

# 05 — CRM

# CRM ITG

## Назначение
Управление клиентами, компаниями, сделками и задачами.

## Процесс
1. Зафиксировать обращение.
2. Назначить ответственного.
3. Запланировать следующий контакт.
4. Отметить результат.

## Документация
Описать этапы воронки, поля, роли и порядок резервного копирования.

# 12 — Twenty CRM: структура данных

# Twenty CRM — схема объектов

**Источник:** чтение метаданных подключённого Twenty CRM, 11.10.2026.

## Обнаружено 28 типов объектов
Ключевые бизнес-объекты:
- `companies` — компании.
- `people` — контакты.
- `opportunities` — сделки.
- `tasks` — задачи.
- `notes` — заметки.
- `attachments` — вложения.
- `workspace_members` — участники рабочего пространства.
- `timeline_activities` — история активности.
- `dashboards` — панели.

Дополнительные типы: `agent_chat_thread_targets`, `agent_chat_threads`, `blocklists`, `calendar_channel_event_associations`, `calendar_event_participants`, `calendar_event_targets`, `calendar_events`, `call_recordings`, `message_campaigns`, `message_channel_message_association_message_folders`, `message_channel_message_associations`, `message_list_members`, `message_lists`, `message_participants`, `message_thread_targets`, `message_threads`, `messages`, `note_targets`, `task_targets`.

## Рекомендуемый процесс
Компания → контакт → сделка → задача follow-up → результат → следующее действие.

## Требует уточнения
- Фактические поля каждого объекта и обязательность.
- Этапы и статусы сделок.
- Пользовательские поля следующего контакта.
- Права доступа и API-лимиты.

Это реестр типов, а не подтверждение настроенных связей и автоматизаций.

# 18 — CRM: диагностика и follow-up

# CRM — диагностика и follow-up

## Подтверждённая схема объектов Twenty
Метаданные подключения показывают `companies`, `people`, `opportunities`, `tasks`, `notes`, `workspace_members`.

## Минимальный сценарий продаж
1. Создать или найти компанию.
2. Создать или найти контакт.
3. Зарегистрировать сделку.
4. Назначить ответственного.
5. Указать следующее действие и срок.
6. После контакта зафиксировать результат и следующую задачу.

## Контроль follow-up
- Задача не должна оставаться без ответственного.
- Просроченные контакты должны попадать в отдельное представление.
- Дубли контактов и сделок нужно проверять до автоматического создания.
- Тестовые заявки маркировать отдельно.

## Диагностика недоступности
1. Проверить страницу входа CRM.
2. Проверить контейнеры приложения и базы.
3. Проверить логи ошибок.
4. Проверить внутреннее подключение и внешний прокси.
5. Проверить чтение списка контактов после восстановления.

## Не подтверждено
Точные названия пользовательских полей, правила воронки, текущие резервные копии и график уведомлений. Заполнять только после чтения актуальной конфигурации.

**Статус:** инструкция подготовлена; реальные операции CRM не изменялись.

# 02 — Инфраструктура

Раздел базы знаний ITG

# 02 — Инфраструктура

# Инфраструктура ITG

## Компоненты
- **ZimaOS:** домашний сервер для контейнерных сервисов.
- **Docker Compose:** управление сервисами.
- **Nginx Proxy Manager:** обратный прокси.
- **Cloudflare:** DNS и внешний доступ к доменам.
- **OpenWrt:** маршрутизация локальной сети.
- **BookStack:** https://wiki.karpiev.ru — документация.
- **Twenty CRM:** https://crm.itgsystem.online.

## Стандарт документации сервиса
1. Назначение и адрес сервиса.
2. Путь к Compose-конфигурации.
3. Сети, тома, зависимости.
4. Процедура обновления и отката.
5. Резервное копирование и восстановление.
6. Мониторинг, логи, алерты.

## Безопасность
Не публиковать ключи, токены, пароли, файлы .env и приватные SSH-ключи. Хранить секреты отдельно в менеджере секретов.

# 06 — ZimaOS и Docker

# ZimaOS и Docker — ITG

## Назначение
Домашняя инфраструктура для приложений ITG: CRM, документация, автоматизация и MCP-сервисы.

## Известная конфигурация
- ZimaOS и Docker Compose.
- Nginx Proxy Manager для обратного прокси.
- Cloudflare для DNS и внешнего доступа.
- OpenWrt для локальной сети.
- Для Docker на ZimaOS ранее требовался `sudo`.
- Рабочий каталог Docker CLI: `/DATA/AppData/docker-cli-config`.

## Команды обслуживания
```bash
sudo env DOCKER_CONFIG=/DATA/AppData/docker-cli-config docker ps
sudo env DOCKER_CONFIG=/DATA/AppData/docker-cli-config docker compose ps
sudo env DOCKER_CONFIG=/DATA/AppData/docker-cli-config docker logs --tail 50 ИМЯ_КОНТЕЙНЕРА
```

Выполнять `docker compose` из каталога конкретного сервиса.

## Стандарт контейнерного проекта
- Один постоянный каталог проекта в `/DATA/AppData/`.
- Compose-файл и отдельный `.env` с ограниченными правами.
- Том для данных, который сохраняется при пересоздании контейнера.
- Healthcheck и политика перезапуска, где применимо.
- Резервная копия конфигурации и данных до изменений.

## Диагностика HTTP
1. Проверить процесс/контейнер.
2. Проверить адрес, который слушает приложение внутри контейнера: `0.0.0.0` для Docker port mapping.
3. Проверить проброс портов и Docker-сети.
4. Проверить Nginx Proxy Manager.
5. Проверить DNS, TLS и правила Cloudflare.

## Безопасность
Не публиковать административные порты, Docker API и внутренние сервисы без авторизации. Не размещать секреты в BookStack.

**Требует актуализации:** полный инвентарь контейнеров, томов, бэкапов и схема сетей.

# 11 — Реестр сервисов ITG

# Реестр сервисов ITG

## Подтверждённые адреса и назначения
| Сервис | Адрес | Назначение |
|---|---|---|
| BookStack | https://wiki.karpiev.ru | База знаний |
| ITG BookStack MCP | https://mcp-wiki.karpiev.ru/mcp | Инструменты BookStack для ChatGPT |
| Twenty CRM | https://crm.itgsystem.online | Управление продажами |
| ITG сайт | https://itgsystem.ru | Публичный сайт студии |

## Проверка доступности 11.10.2026
- `https://wiki.karpiev.ru/books/itg-baza-znanii`: HTTP 200.
- `https://mcp-wiki.karpiev.ru/mcp` без авторизации: HTTP 401; проверка OAuth через авторизованный клиент выполнена отдельными вызовами MCP.
- `https://itgsystem.ru`: HTTP 200.
- `https://crm.itgsystem.online`: HTTP 404 при GET и HEAD. Работоспособность CRM не подтверждена; проверить маршрут прокси и актуальный адрес. Это результат внешней проверки, внутреннее состояние контейнеров не проверялось.

## Инфраструктура (по предыдущей конфигурации)
- ZimaOS: контейнерные приложения.
- Nginx Proxy Manager: обратный прокси.
- Cloudflare: DNS и проксирование.
- OpenWrt: домашняя сеть.

## Шаблон инвентаризации
| Поле | Значение |
|---|---|
| Имя сервиса | |
| Назначение | |
| URL | |
| Каталог Compose | |
| Docker-образы и версии | |
| Тома данных | |
| База данных | |
| Ответственный | |
| Резервная копия | |
| Последняя проверка | |

**Важно:** адреса не являются подтверждением текущей доступности. Перед эксплуатационными действиями проверять реальное состояние.

# 16 — Docker: безопасное обновление

# Docker — безопасное обновление сервиса ITG

## Область применения
Контейнерные сервисы ZimaOS. Процедура не заменяет инструкции конкретного приложения.

## Перед обновлением
1. Уточнить каталог Compose и текущую версию образа.
2. Проверить доступное место и статус томов.
3. Сохранить резервные копии конфигурации и данных.
4. Зафиксировать план отката и окно обслуживания.

## Команды проверки
```bash
sudo env DOCKER_CONFIG=/DATA/AppData/docker-cli-config docker compose ps
sudo env DOCKER_CONFIG=/DATA/AppData/docker-cli-config docker compose config --quiet
sudo env DOCKER_CONFIG=/DATA/AppData/docker-cli-config docker compose images
```

## Обновление
Выполнять из существующего каталога проекта, только после проверки резервных копий:
```bash
sudo env DOCKER_CONFIG=/DATA/AppData/docker-cli-config docker compose pull
sudo env DOCKER_CONFIG=/DATA/AppData/docker-cli-config docker compose up -d
```

## Проверка
```bash
sudo env DOCKER_CONFIG=/DATA/AppData/docker-cli-config docker compose ps
sudo env DOCKER_CONFIG=/DATA/AppData/docker-cli-config docker compose logs --tail 100
```
Проверить реальную бизнес-операцию приложения.

## Откат
Вернуть зафиксированную версию образа и совместимые данные из резервной копии. Не откатывать схему БД вслепую: миграции могут быть необратимыми.

**Статус:** инструкция подготовлена, на боевом сервисе не выполнялась.

# 03 — Сайт и MODX

Раздел базы знаний ITG

# 07 — MODX и сайт ITG

# MODX и сайт ITG

## Назначение
Управление содержимым сайта и интеграциями через MCP.

## Известные адреса
- Основной сайт: https://itgsystem.ru
- Интеграция MODX MCP разворачивалась в ZimaOS.
- Ранее использовались MODX Revolution, MariaDB и отдельный MCP-сервис.

## Содержание документации
### Сайт
- Структура страниц и шаблонов.
- Формы заявок, уведомления, цели аналитики.
- SEO: индексируемые страницы, canonical, sitemap, robots.txt.
- Двуязычность RU/EN, где применяется.

### MCP
- Список инструментов управления ресурсами и содержимым.
- Права API-токена и ограничения записи.
- Тестовые запросы и диагностика ошибок.
- Логирование изменений и откат.

## Процедура публикации
1. Проверить изменения в тестовой среде или черновике.
2. Убедиться, что формы, кнопки и ссылки работают.
3. Проверить адаптивность, метаданные и индексирование.
4. Исключить тестовые заявки из реальной аналитики.
5. Зафиксировать дату и автора изменения.

## Безопасность
Не раскрывать MODX API-токены, ключи MCP и конфигурацию базы данных.

**Примечание:** фактическую архитектуру текущего публичного сайта и CMS необходимо сверить отдельно: в проекте ранее использовались несколько реализаций.

# 13 — MODX: проверенная структура

# MODX — фактическая структура

**Источник:** MCP MODX, чтение ресурсов и шаблонов, 11.10.2026.

## Ресурсы
MCP вернул **40 ресурсов**, включая опубликованные и черновики.

Подтверждённые примеры:
- ID 1: главная RU, опубликована.
- ID 3: главная EN, опубликована.
- ID 4: раздел «Услуги» RU.
- ID 16: раздел «Services» EN.
- ID 28: «Lead API», опубликован, шаблон 0.
- ID 32: «Сайты для агентств недвижимости», опубликован.
- ID 34: «XML Sitemap», опубликован, шаблон 0.
- ID 39: «Разработка сайтов в Орске», опубликован.
- ID 40: «Разработка сайтов в Новотроицке», опубликован.
- ID 41: «HVAC Website Design & Development», опубликован.
- ID 45: «IT GROUP Analytics», опубликован.

## Шаблоны
- ID 1: **IT GROUP — Brand System** — адаптивный шаблон с SEO, header/footer и мобильной навигацией.
- ID 2: **IT GROUP — Brand System backup 2026-10-09** — резервная копия шаблона.

## Правила работы
- Не менять резервный шаблон без отдельного решения.
- Перед изменением страницы фиксировать ID, контекст, шаблон и статус публикации.
- Не публиковать черновики автоматически.
- После правок проверять RU и EN версии, формы и SEO.

**Примечание:** список является снимком состояния, а не гарантией неизменности.

# 19 — MODX: публикация и откат

# MODX — публикация и откат

## Снимок конфигурации
Подключение MODX вернуло 40 ресурсов и 2 шаблона. Шаблон ID 1 — IT GROUP Brand System, ID 2 — резервная копия от 09.10.2026.

## Порядок изменения
1. Определить ID ресурса, контекст RU/EN и статус публикации.
2. Сохранить текущую версию содержимого или шаблона.
3. Изменить только требуемый ресурс.
4. Проверить результат на публичном URL.
5. Проверить мобильную версию, формы, навигацию и SEO.
6. Записать дату, причину и результат изменения.

## Правила
- Черновики не публиковать без подтверждения.
- Резервный шаблон не изменять.
- Технические страницы должны соответствовать требованиям поисковых систем и правилам доступа.
- Не применять разные версии содержимого поисковым роботам и посетителям с целью манипулирования индексацией.

## Откат
Восстановить предыдущую версию ресурса или шаблона из проверенного снимка. После отката очистить кеш при необходимости и повторить проверки.

**Статус:** регламент готов; никаких изменений публичного сайта не производилось.

# 04 — Интеграции и аналитика

Раздел базы знаний ITG

# 03 — Интеграции и автоматизация

# Интеграции и автоматизация ITG

## MCP
- **ITG BookStack MCP:** инструменты поиска, чтения, создания и обновления страниц, получения списков книг и полок, создания книг.
- **ITG MODX MCP:** управление содержимым сайта.
- **Яндекс Директ и аналитика:** интеграции для рекламных и аналитических задач.

## n8n
Направления автоматизации: заявки с сайта, создание/обновление записей CRM, экспресс-аудит сайтов, отчёты, уведомления.

## Карточка интеграции
- Системы-участники и схема потока данных
- Событие запуска и API-методы
- Поля и преобразования
- Авторизация (только способ, без секретов)
- Повторные попытки и обработка ошибок
- Логи, алерты и тестовые сценарии
- Ответственный и дата последней проверки

## Правило
Тестовый трафик и тестовые заявки маркировать отдельно от реальных.

# 08 — MCP и ChatGPT

# MCP и ChatGPT — ITG

## Назначение
MCP предоставляет ChatGPT контролируемый доступ к рабочим системам ITG.

## ITG BookStack MCP
- Документация: https://wiki.karpiev.ru
- MCP endpoint: https://mcp-wiki.karpiev.ru/mcp
- Проект на ZimaOS: `/DATA/AppData/bookstack-mcp`
- Docker-контейнер: `bookstack-mcp`
- Локальный проброс: `127.0.0.1:18765` → порт 8000 контейнера.
- Авторизация: GitHub OAuth через FastMCP (требуется периодическая проверка ограничений доступа).
- Название подключения: **ITG BookStack MCP**.

## Проверенные операции
- Поиск по BookStack.
- Получение списка книг и полок.
- Чтение страницы.
- Создание и обновление страницы.
- Создание книги.

## Проверка доступности
```bash
curl -sS -o /dev/null -w '%{http_code}\n' https://mcp-wiki.karpiev.ru/mcp
```
Без авторизации `401` ожидаем, но **сам по себе этот код не доказывает корректность OAuth-потока или ограничений пользователей**.

## Безопасность
- Не публиковать MCP без надёжной аутентификации.
- Проверять, что авторизация ограничивает доступ только нужным пользователям.
- Хранить Client Secret и BookStack API-токены вне документации.
- Разделять права чтения и изменения по возможности.
- После обновлений проверять `tools/list` и реальные операции.

## Рекомендации
- Добавить инструменты управления полками и главами.
- Вести журнал изменения схемы MCP.
- Документировать политику доступа и отзыв токенов.

**Статус:** инструменты BookStack MCP доступны в ChatGPT; полный аудит политики OAuth ещё требуется.

# 09 — n8n и автоматизация

# n8n — автоматизация ITG

## Назначение
Связать сайт, CRM, аналитику, электронную почту и уведомления в воспроизводимые процессы.

## Приоритетные сценарии
### 1. Заявка с сайта → Twenty CRM
- Получить заявку из формы.
- Проверить обязательные поля.
- Найти существующую компанию/контакт.
- Создать или обновить запись в CRM.
- Создать задачу follow-up.
- Записать идентификатор события и статус обработки.

### 2. Экспресс-аудит сайта
- Получить URL и контактные данные.
- Проверить валидность URL и разрешённые адреса.
- Запустить разрешённые проверки производительности и SEO.
- Сформировать отчёт.
- Отправить клиенту и сохранить ссылку в CRM.

### 3. Уведомления
- Ошибка автоматизации.
- Новая заявка.
- Просроченный follow-up.
- Изменение статуса интеграции.

## Стандарт workflow
- Уникальный ID события и идемпотентность.
- Таймауты, ретраи и обработка ошибок.
- Секреты только в credentials/хранилище секретов.
- Отдельные тестовые данные.
- Наблюдаемость: журнал выполнения и алерты.
- Явные критерии успешного завершения.

## Фактический инвентарь на 11.10.2026
Через n8n MCP доступно **15 workflow**, из них **3 активных**:
- `itgC8Digest20261007` — IT GROUP — Daily Follow-up digest.
- `itgC7901e7a356f6` — IT GROUP — Twenty opportunity events.
- `puOTAOvlbzAiH0ze` — ITG — BookStack health and quality gate.

Автоматизация аудита сайтов представлена отдельными **неактивными** ручными сценариями: intake (`acvtlYyojy35oxdg`), просмотр очереди (`BIPJOHreI2sCqGPb`), проверка URL (`TnGks4RmPM2KCkVA`), классификатор событий (`q2jEfj4lgS5lBSyy`). Их описания явно ограничивают сетевые вызовы и запись в CRM; полноценный производственный процесс экспресс-аудита этим не подтверждён. Активный контроль BookStack имел ошибку DNS при запуске по расписанию 11.10.2026; детали в [регламенте контроля качества](https://wiki.karpiev.ru/books/itg-baza-znanii/page/20-kontrol-kacestva-i-aktualizaciia).

## Дальнейшая работа
- Актуализировать инвентарь workflows при изменениях.
- Описать webhook-адреса и контракт входных данных без секретов.
- Настроить тестовые сценарии и оповещения.
- Связать статусы выполнения с CRM.

**Статус:** проектная документация, а не подтверждение фактического развёртывания каждого сценария.

# 10 — Веб-аналитика и реклама

# Веб-аналитика и реклама ITG

## Системы
Яндекс Метрика, Google Analytics 4, Яндекс Директ и Twenty CRM.

## Путь клиента
Рекламный переход → посещение сайта → заявка → сделка в CRM → оплата.

## Измерения
- Отправка формы и запрос бесплатного аудита.
- Нажатие на телефон и переход в мессенджер.
- Источник, кампания и UTM-метки.
- Лиды, продажи, расходы и стоимость привлечения.

## Качество данных
Отдельно маркировать тестовые обращения, исключать дубли событий, сопоставлять заявки сайта с CRM и проверять корректность целей.

## Регламент
До изменения рекламных кампаний проверять ограничения бюджета и статус публикации. Включение рекламы требует отдельного подтверждения.

*Названия событий и действующие настройки необходимо сверить с аналитическими системами.*

# 17 — BookStack MCP: эксплуатация

# ITG BookStack MCP — эксплуатационная инструкция

## Подтверждённые сведения
- Книга ITG: https://wiki.karpiev.ru/books/itg-baza-znanii
- Endpoint MCP: https://mcp-wiki.karpiev.ru/mcp
- Каталог: `/DATA/AppData/bookstack-mcp`
- Docker Compose, сервис `bookstack-mcp`.
- FastMCP, GitHub OAuth.

## Проверка конфигурации
```bash
cd /DATA/AppData/bookstack-mcp
sudo env DOCKER_CONFIG=/DATA/AppData/docker-cli-config docker compose ps
sudo env DOCKER_CONFIG=/DATA/AppData/docker-cli-config docker compose logs --tail 50
```

## Обновление кода
1. Сохранить копию `server.py` и Compose-файла.
2. Проверить синтаксис Python.
3. Пересобрать контейнер из существующего каталога.
4. Проверить доступность endpoint и авторизованный вызов списка инструментов.
5. В ChatGPT обновить подключение при изменении состава инструментов.

## Проверенные инструменты
- bookstack_search
- bookstack_books_list
- bookstack_shelves_list
- bookstack_page_get
- bookstack_page_create
- bookstack_page_update
- bookstack_book_create
- bookstack_chapter_create
- bookstack_page_move

## Доступные операции структуры
`bookstack_chapter_create` и `bookstack_page_move` доступны в подключении. Перенос ограничен страницами и главами книги ITG (ID 4); HomeLab (ID 2) не изменять. Доступность инструментов подтверждена 11.10.2026, настройка OAuth allowlist требует отдельной проверки.

## Безопасность
GitHub OAuth сам по себе не доказывает, что доступ ограничен нужным аккаунтом. Проверить allowlist и права BookStack API.

**Статус:** часть сведений подтверждена рабочими вызовами; настройки доступа требуют аудита.

# 05 — Эксплуатация и безопасность

Раздел базы знаний ITG

# 04 — Регламенты и инструкции

# Регламенты и инструкции ITG

## Изменения сервисов
1. Зафиксировать текущее состояние и цель изменения.
2. Сделать резервную копию затрагиваемых файлов и данных.
3. Применить минимальное изменение.
4. Проверить логи, HTTP-ответы и ключевые операции.
5. Зафиксировать результат и процедуру отката.

## Инциденты
- Определить затронутый сервис и симптомы.
- Проверить статус контейнера, логи, DNS, прокси и сетевую доступность.
- Восстановить работоспособность, затем документировать первопричину.

## Безопасность
- Не вставлять секреты в команды, которые попадают в историю оболочки или скриншоты.
- Использовать минимально необходимые права доступа.
- Не открывать внутренние API в интернет без проверки авторизации.

## Шаблон инструкции
**Цель:**

**Предусловия:**

**Команды:**

**Проверка результата:**

**Откат:**

**Дата последней проверки:**

# 14 — Резервное копирование и восстановление

# Резервное копирование ITG

## Цель
Обеспечить восстановление сервиса и данных после ошибки обновления, отказа хранилища или повреждения базы.

## Что сохранять
- Compose-файлы и версионированные конфигурации без секретов в публичных репозиториях.
- Файлы переменных окружения — только в защищённой резервной копии.
- PostgreSQL и MariaDB — согласованные дампы или штатные средства резервирования.
- Постоянные Docker volumes с файлами приложения.
- Настройки прокси, DNS и перечень доменов.

## Регламент (предложение)
1. Инвентаризировать все постоянные данные.
2. Настроить ежедневные резервные копии БД и регулярные копии файлов.
3. Хранить отдельную копию вне основного сервера.
4. Проверять завершение заданий и размер архивов.
5. Ежемесячно выполнять тест восстановления в изолированной среде.
6. Фиксировать RPO/RTO каждого сервиса.

## Чек-лист восстановления
- Определить дату и причину инцидента.
- Выбрать проверенный архив.
- Развернуть совместимую версию приложения.
- Восстановить базу и файлы.
- Проверить вход, чтение и создание тестовых данных.
- Проверить интеграции и очистить тестовые записи.

**Статус:** регламент подготовлен; автоматическое резервное копирование и тест восстановления не подтверждены.

# 15 — Диагностика и инциденты

# Диагностика сервисов ITG

## Типовые симптомы
- **502/504:** проверить приложение, upstream и настройки прокси.
- **401/403:** проверить авторизацию и права; не отключать защиту для устранения ошибки.
- **404:** проверить маршрут и контекст приложения.
- **500:** проверить логи и доступность зависимостей.
- **Нет данных в мониторинге:** проверить источник данных, запрос и временной диапазон, прежде чем объявлять сервис недоступным.

## Последовательность
1. Зафиксировать URL, время и текст ошибки.
2. Проверить доступность сервиса из внутренней сети.
3. Проверить статус контейнеров и последние ошибки.
4. Проверить БД и очереди.
5. Проверить Nginx Proxy Manager и TLS.
6. Проверить Cloudflare и DNS.
7. После исправления проверить бизнес-операцию, а не только HTTP-код.

## Карточка инцидента
- Дата/время
- Сервис
- Симптом
- Масштаб влияния
- Первопричина
- Временное решение
- Постоянное исправление
- Проверка результата
- Действия для предотвращения повтора

Не записывать секреты, cookie и приватные данные в инцидентные отчёты.

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