Корзина

Когда вы удаляете статью или коллекцию — они не исчезают сразу. Сначала они попадают в Корзину, где хранятся ограниченный срок (зависит от тарифа). За это время можно одним кликом восстановить случайно удалённое или, наоборот, очистить всё навсегда.

Удалённые пространства в корзину не попадают — они 30 дней хранятся в блоке «Удалённые пространства» на странице Настройки → Пространства (подробнее — в статье Пространства).

Корзина защищает вас от «фатальных» опечаток вроде «выбрал не ту папку и нажал Delete», и одновременно даёт админу единую точку для финальной очистки организации.

#Где открыть

Левое меню → Корзина (иконка корзины внизу навигации).

Бейдж справа от пункта показывает, сколько объектов сейчас в корзине.

Кто видит раздел:

• Owner организации — удалённые статьи и коллекции из всех пространств; Admin организации — из корпоративных пространств и приватных, где он участник (удалённые пространства — в Настройки → Пространства)
• Редактор или Администратор пространства (при любой роли в организации, кроме Гостя) — удалённые статьи и коллекции из пространств, где у него такая роль
• Guest и те, у кого ни в одном пространстве нет роли Редактор или Администратор, — раздел скрыт

#Что попадает в корзину

Удаление любого из двух типов объектов — это soft-delete: запись остаётся в БД с отметкой deleted_at, но скрыта от пользователей и AI-поиска. Восстановление возвращает объект «как было».

Удаление каскадное: если удалить родительскую коллекцию, все вложенные коллекции и статьи переезжают в корзину вместе с ней.

#Срок хранения по тарифам

Сколько объект пролежит в корзине до безвозвратного удаления — определяется тарифом:

После истечения срока фоновый процесс окончательно стирает объект из базы — вместе со связанными чанками, эмбеддингами и кешем AI-ответов. Восстановить будет уже нельзя.

Совет. Если по compliance нужно жёстко удалять объект сразу — используйте «Удалить навсегда» вручную, не дожидаясь cron.

#Как выглядит элемент корзины

Каждая строка корзины — это карточка с типом объекта, названием, кратким описанием, информацией кто и когда удалил, оставшимся временем и кнопками действий:

Цветовые индикаторы оставшегося времени:

• Зелёный — больше половины срока ещё впереди
• Жёлтый — осталось менее 30% срока (пора решать: восстановить или удалить навсегда)
• Красный — осталось 1–2 дня до permanent delete

#Действия с одним объектом

#Восстановить

После восстановления у объекта снимаются отметки deleted_at и deletion_scheduled_at — он снова доступен в обычном интерфейсе и попадает в поиск.

#Удалить навсегда

Безвозвратное удаление прямо сейчас, минуя retention. Появится подтверждение с явным предупреждением «это действие необратимо». Используйте, если уверены — восстановить не получится.

#Посмотреть (только для статей)

Открывает миниатюру с заголовком и первыми 800 символами содержимого. Это быстрый способ вспомнить, что внутри, не восстанавливая статью.

#Фильтры и поиск

В верхней части страницы — панель фильтров:

• Тип — статьи, коллекции или все вместе
• Поиск — по названию (нечувствительно к регистру)
• Только мои — объекты, удалённые лично вами
• Период — диапазон дат удаления (от/до)
• Постранично — до 50 элементов на страницу

#Массовые операции

Поставьте чекбоксы в нескольких карточках — внизу появится bulk action bar:

Отдельно в правом верхнем углу страницы доступна кнопка «Очистить корзину» — она стирает навсегда удалённые статьи и коллекции в пространствах, где вы администратор пространства (можно ограничить выбранным типом, например «только статьи»). Действие требует подтверждения. Содержимое удалённых пространств в корзине не показывается, и «Очистить корзину» его не затрагивает.

#Что происходит с поиском и AI пока объект в корзине

Пока статья находится между deleted_at и deletion_scheduled_at:

• В обычных результатах поиска и AI-ответах для пользователей удалённый контент не показывается
• Embeddings и кэшированные AI-ответы остаются в БД нетронутыми
• AI может процитировать удалённую статью в ответах из кэша — если такой же вопрос уже задавали до удаления и ответ закешировался

Это сознательный компромисс: мы позволяем «откатить» удаление без полной переиндексации организации (она долгая и дорогая), а за чистоту публичного поиска отвечает фильтр deleted_at IS NULL на уровне SQL-запросов.

Если нужно немедленно вычистить статью из кэша — используйте «Удалить навсегда»: cron сразу же удалит и embeddings, и связанные кэш-записи.

#Приватность и доступ

• Owner видит корзину организации целиком; Admin — всё, кроме приватных пространств, в которых он не состоит
• Редактор пространства видит только объекты из пространств, где у него роль Редактор или Администратор; Guest и те, у кого такой роли нет ни в одном пространстве, корзину не видят. Чужие пространства не показываются вовсе

Это та же модель приватности, что и в основном интерфейсе — корзина её не нарушает.

#Кто что может удалять и восстанавливать

Действия с корзиной решает роль в пространстве объекта (Space Admin / Editor / Viewer). Роль в организации важна тем, что Owner — администратор в каждом пространстве, а Guest — не выше Viewer. Столбцы таблицы — роль в пространстве объекта (последний — Admin или Owner организации):

Ключевые правила:

• Editor может класть в корзину и восстанавливать, но «удалять навсегда» статьи и коллекции — только Space Admin (и выше). Это страховка от случайной потери данных рядовым сотрудником.
• Пространства — самая мощная операция: удалить, восстановить и удалить навсегда пространство может Owner организации — любое, Admin организации — корпоративное и приватное, где он участник с ролью администратора. Space Admin одного пространства не может удалить само пространство. Удалённые пространства восстанавливаются и удаляются навсегда в Настройки → Пространства, а не в корзине.
• Viewer пространства и Guest не видят корзину этого пространства — и не могут ничего удалить или восстановить. Пользователь организации с ролью Редактор или Администратор в пространстве корзину этого пространства видит.

Важно про cross-space restore. Если вы восстанавливаете статью в другое пространство (например, исходное удалено), у вас должна быть роль не ниже Editor в целевом пространстве — иначе восстановление будет отклонено с ошибкой INSUFFICIENT_PERMISSIONS.

#Связанные разделы

• Журнал действий — события trashed / restored / permanently_deleted логируются там с указанием инициатора и времени
• Управление статьями — отсюда происходит обычное удаление, которое уносит статью в корзину
• Пространства — удалённое пространство вместе с содержимым 30 дней хранится в «Настройки → Пространства», а не в корзине