Где создать страницу
Откройте /projects/{projectUuid}/knowledge и нажмите Создать страницу. Можно также открыть панель документации рядом с конкретной сущностью через EntityKnowledgePanel и создать страницу оттуда.
Какие поля заполнить
- Заголовок — понятное название, например «Документация: новогодняя короткая ссылка».
- Тип страницы — ARTICLE, RUNBOOK, SCENARIO_DOC или ENTITY_DOC.
- Комментарий к версии — что изменилось в этой версии.
- Видимость — PROJECT или COMPANY.
- Текст документации — заполняется через EditorJS; картинки загружаются через cdp_files.
Как писать полезную страницу
- Начинайте с ответа «зачем существует объект».
- Добавляйте владельца и дату последней проверки.
- Фиксируйте опасные действия: что нельзя менять без согласования.
- Добавляйте ссылки на связанные отчёты, события, сценарии и внешние документы.
Технически: пользователь работает во frontend через REST в gateway. Внутри CDP используется контур gateway → cdp_knowledge; картинки и вложения проходят через cdp_files, связи хранятся как anchors на сущности CDP. Пользователю это нужно знать только для диагностики: если UI показывает ошибку, смотрите route, HTTP-статус gateway и связанный сервис.
