Что такое база знаний проекта
Раздел /projects/{projectUuid}/knowledge хранит внутренние страницы проекта: runbook, описание сценария, документацию конкретной короткой ссылки, правила работы с отчётом, заметки по SEO, инструкции для менеджеров и историю решений. Это не публичная документация на сайте. Это рабочая ДОКа команды по конкретным сущностям CDP.
Почему это важно
В CDP много объектов: ссылки, пиксели, сценарии, отчёты, чаты, события. Если смысл объекта хранить только в голове менеджера, через месяц никто не поймёт, зачем он создан. База знаний решает это: страница может быть привязана прямо к объекту, например к короткой ссылке на странице /projects/{projectUuid}/links/{linkUuid}.
Что стоит документировать
- Зачем создан объект.
- Кто отвечает за поддержку.
- Какие поля нельзя менять без согласования.
- Какие отчёты или события связаны с объектом.
- Что делать при ошибке или изменении бизнес-логики.
Технически: пользователь работает во frontend через REST в gateway. Внутри CDP используется контур gateway → cdp_knowledge; картинки и вложения проходят через cdp_files, связи хранятся как anchors на сущности CDP. Пользователю это нужно знать только для диагностики: если UI показывает ошибку, смотрите route, HTTP-статус gateway и связанный сервис.
