Руководство по структурированию Wiki SKIF.PRO

Раздел (уровень 1)
└── Подраздел (уровень 2)
    └── Статья (уровень 3)

Wiki SKIF.PRO
├── 📱 ДЛЯ ПОЛЬЗОВАТЕЛЕЙ (R1)
│   ├── Начало работы
│   ├── Объекты
│   ├── Геозоны
│   ├── Отчёты
│   ├── Уведомления
│   └── Мобильное приложение
│
└── 🔧 ДЛЯ ИНТЕГРАТОРОВ (R2)
    ├── Протоколы передачи данных
    ├── Webhooks и события
    ├── Импорт данных
    └── Интеграция с 1С

Объекты/
├── 👤 Для пользователей/
│   ├── [Концепция] Что такое объект в SKIF.PRO
│   ├── [Инструкция] Как создать объект
│   └── [Справочник] Карточка объекта — вкладка Основные
│
└── 🔧 Для интеграторов/
    ├── [Концепция] Объекты: модель данных и ограничения
    └── [Troubleshooting] Частые ошибки при импорте объектов

Wiki SKIF.PRO
│
├── 📱 ДЛЯ ПОЛЬЗОВАТЕЛЕЙ
│   ├── Начало работы          ← Онбординг новых пользователей (R1)
│   ├── Объекты                ← Работа с объектами через UI (R1)
│   ├── Геозоны                ← Работа с геозонами (R1)
│   ├── Отчёты                 ← Построение и настройка отчётов (R1)
│   ├── Уведомления            ← Настройка событий и оповещений (R1)
│   ├── Пользователи           ← Управление аккаунтами и правами (R1)
│   ├── Мобильное приложение   ← Документация мобильного клиента (R1)
│   ├── Администрирование      ← Для администраторов аккаунта (R1)
│   └── Биллинг                ← Тарифы, оплата, лицензии (R1)
│
└── 🔧 ДЛЯ ИНТЕГРАТОРОВ
    ├── Протоколы              ← Протоколы передачи данных с трекеров (R2)
    ├── Webhooks               ← Настройка вебхуков и событий (R2)
    ├── Импорт данных          ← Массовый импорт (R2)
    └── Интеграция с 1С        ← Коннекторы для учётных систем (R2)

Объекты/
├── [B — Концепция] Что такое объект в SKIF.PRO
├── Справочник объектов/
│   ├── [C — Справочник] Обзор справочника объектов
│   ├── [A — Инструкция] Как найти объект
│   ├── [A — Инструкция] Как создать объект
│   ├── [A — Инструкция] Как редактировать объект
│   └── [A — Инструкция] Как удалить объект
├── Карточка объекта/
│   ├── [C — Справочник] Вкладка «Основные»
│   ├── [C — Справочник] Вкладка «Датчики»
│   ├── [C — Справочник] Вкладка «Сцепки»
│   ├── [C — Справочник] Вкладка «Смены»
│   ├── [C — Справочник] Вкладка «ТО»
│   └── [C — Справочник] Вкладка «Тех. параметры»
├── Группы объектов/
│   ├── [B — Концепция] Что такое группы объектов
│   ├── [A — Инструкция] Как создать группу
│   └── [A — Инструкция] Как добавить объект в группу
└── [D — Troubleshooting] Частые проблемы с объектами

Протоколы/
├── [B — Концепция] Как устроена передача данных с трекеров
├── [B — Концепция] Поддерживаемые протоколы: обзор
├── Wialon IPS/
│   ├── [B — Концепция] Wialon IPS: структура пакетов и логика обмена
│   ├── [C — Справочник] Wialon IPS: формат сообщений и типы данных
│   └── [D — Troubleshooting] Данные не поступают по Wialon IPS
└── EGTS/
    ├── [B — Концепция] EGTS: структура и особенности
    ├── [C — Справочник] EGTS: формат сообщений
    └── [D — Troubleshooting] Ошибки при подключении по EGTS

Примеры заголовков:
✓ «Как создать объект»
✓ «Как настроить уведомление о выезде из геозоны»
✗ «Создание и редактирование объектов»
✗ «Работа с объектами»

Примеры заголовков:
Для R1:
  ✓ «Что такое объект в SKIF.PRO»
  ✓ «Как устроены права доступа»
  ✗ «Введение в раздел объектов»
  ✗ «Объекты — общая информация»

Для R2:
  ✓ «Объекты: модель данных и ограничения»
  ✓ «Как устроена передача данных с трекеров»
  ✗ «Общие сведения о протоколах»

Примеры заголовков:
Для R1:
  ✓ «Карточка объекта — вкладка Основные»
  ✓ «Форма создания геозоны: описание полей»
  ✗ «Поля объекта»
  ✗ «Настройки»

Для R2:
  ✓ «Wialon IPS: формат сообщений и типы данных»
  ✓ «Формат данных объекта при импорте»
  ✗ «Данные»
  ✗ «Параметры»

Примеры заголовков:
Для R1:
  ✓ «Трекер не выходит на связь»
  ✓ «Отчёт показывает 0 км»
  ✗ «Ошибка соединения с устройством»
  ✗ «Проблемы с расчётом пробега»

Для R2:
  ✓ «Webhook не доставляет события»
  ✓ «Данные не поступают по Wialon IPS»
  ✗ «Ошибка HTTP 502»
  ✗ «Проблемы с протоколом»

ШАГ 1. Определите аудиторию и функциональный домен
         → Кто читатель: R1 (конечный клиент) или R2 (интегратор)?
         → К какой области относится: UI / интеграция / и то и другое?

         Если R1 (клиент):
           → Раздел из блока «ДЛЯ ПОЛЬЗОВАТЕЛЕЙ»

         Если R2 (интегратор):
           → Раздел из блока «ДЛЯ ИНТЕГРАТОРОВ»

         Если домен пересекается (есть и UI, и интеграция):
           → Основной раздел + подраздел по аудитории

ШАГ 2. Определите тип статьи
         Что делает эта статья?
         → Объясняет «что это» и «зачем»  → B (Концепция)
         → Учит «как сделать»             → A (Инструкция)
         → Описывает экран / поля / формат → C (Справочник)
         → Решает проблему                → D (Troubleshooting)

ШАГ 3. Определите подраздел
         → Есть ли уже подраздел для этой темы?
             ДА → статья идёт туда
             НЕТ → создать подраздел (только если туда войдёт 3+ статьи)
                   или разместить статью напрямую в раздел

ШАГ 4. Определите позицию внутри подраздела
         → Концепция (B) → первая
         → Обзор / Справочник (C) → после концепции
         → Инструкции (A) → по сложности
         → Справочники полей (C) → после инструкций
         → Troubleshooting (D) → последняя

Объекты/
├── Объекты — всё о них    ← нарушение атомарности
├── FAQ по объектам        ← FAQ-солянка
└── Разное                 ← недопустимо

Протоколы/
├── Как устроена передача данных         ← R2
├── Wialon IPS: формат сообщений         ← R2
├── Как добавить трекер через интерфейс  ← R1 (НЕПРАВИЛЬНО!)
└── Частые ошибки подключения            ← R2

❌ «Как создать объект» — и здесь же таблица с описанием всех полей
✓ «Как создать объект» → ссылка на «Карточка объекта — вкладка Основные»

❌ См. статью «Протокол обмена данными с трекерами»
✓ > 🔧 Техническая статья для интеграторов: «Протокол обмена данными с трекерами»