Уведомления и лента активности

Зачем это нужно

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

В Nextdocs две разных ленты, которые решают разные задачи:

• Уведомления (колокольчик 🔔 в правом верхнем углу) —
  персональные события, адресованные вам. Требуют вашего
  внимания.

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

Уведомления (колокольчик)

Что приходит

• Упоминание через @ — когда кто-то написал @Ваше Имя в
  тексте страницы или в комментарии.

• Выдача прав — админ проекта дал вам доступ к новому ресурсу.

• Изменение роли — вы были Editor, стали Admin (или наоборот).

• Отзыв доступа — у вас забрали доступ к проекту.

• Приглашение на проект — вас пригласили на новый проект.

Где смотреть

• Колокольчик в верхнем правом углу. Badge показывает число
  непрочитанных. Клик открывает выпадающий список.

• Toast-всплывайки — если событие произошло прямо сейчас и вы
  онлайн, в нижней центральной части экрана покажется карточка с
  превью и кнопкой «Open». Клик — переход. Через 4 секунды сама
  скрывается (но сохраняется в колокольчике).

Вкладки

В выпадающем списке две вкладки:

• Unread — только непрочитанные (по умолчанию).

• All — полная история, включая прочитанные, до 50 последних
  записей.

Статусы

• Непрочитано — кружок-индикатор слева. Клик по уведомлению
  автоматически помечает прочитанным.

• Прочитано — без индикатора, чуть приглушённое.

• Mark all read — кнопка, чистит badge одним щелчком.

Клик по уведомлению

Что происходит:

• mention в странице — навигация на страницу, скролл к месту
  упоминания (курсор встаёт туда).

• mention в комментарии — навигация на страницу, правая панель
  открывается на комментариях, scroll на конкретный коммент,
  подсветка.

• access_granted / role_changed — на страницу проекта /
  ресурса, о котором речь.

Если вы откроете уведомление через toast, оно тоже помечается
прочитанным (через ~2 секунды, после того как бэк успел сохранить
запись).

Лента активности (Activity feed)

Где смотреть

На странице проекта в правом верхнем сайдбаре — иконка-пульс. Клик
открывает выпадающее окошко с последними 50 событиями этого
проекта.

Что попадает в ленту

События, которые тут записываются (все участники проекта видят
ленту одинаково):

• page_created / renamed / moved / deleted — события по дереву
  страниц.

• repo_attached / detached — привязка-отвязка репозиториев.

• mention — когда кто-то кого-то упомянул (запись вида «Alice
  mentioned Bob», клик → страница с упоминанием).

• comment_created / resolved / deleted — новые комментарии,
  решения, удаления.

• page_edited — агрегированное событие раз в сутки: «Alice
  edited Design overview and 4 more». Суммирует всё редактирование
  одного автора за день, чтобы лента не забивалась micro-events.

Каждый элемент показывает: кто, что, когда. Клик по событию с
page_id — переход на соответствующую страницу (если это комментарий
— прямо к комментарию через deep link).

Пагинация

Вначале — последние 50. Внизу кнопка Load more подтягивает
следующий блок. Лимит глубины: 6 месяцев назад (дальше — нет).

Live-обновления

Когда вы открыли активный feed и в проекте что-то случилось —
событие сразу появится вверху списка без перезагрузки.

Отличие от истории страницы

Похожие идеи, разные scope'ы:

• History (правая вкладка) — показывает только эту страницу,
  включая content edits, полезна для rollback / diff.

• Activity feed — показывает весь проект, без возможности
  rollback, полезна для ориентации «что происходит».

Recently Visited

Связанная фича: виджет Recently visited на экране /projects.
Это ваши личные последние посещённые страницы, в хронологическом
порядке. Не путайте с activity feed проекта — это про ваш собственный
scroll-back.

• По умолчанию виджет свёрнут.

• Кликните «Recently visited» чтобы развернуть.

• В списке — последние 9 страниц, в трёх колонках.

• Клик — переход.

Запись «посещено» появляется только если вы провели на странице
дольше ~10 секунд (иначе перелистывание через поиск засорило бы
список).

Digest и уведомления о редактировании

Ежедневный агрегат «Alice edited 3 pages» — автоматический,
запускается в полночь по локальному времени сервера. Может быть
триггернут вручную:

POST /api/internal/activity/digest
Header: X-Service-Secret: <secret>
Body: { "project_id": 42 }   # опционально

Это может понадобиться, если нужно «догнать» ленту после импорта.

Privacy

• Notifications приватны для вас.

• Activity feed виден всем участникам проекта. Если вы не хотите,
  чтобы ваши действия попадали в ленту — это сейчас невозможно
  (только ограничить создание самих действий: не редактировать
  чужое, не комментировать).

Типовые сценарии

Просыпаетесь утром. Открываете Nextdocs, badge у колокольчика:
«3 непрочитанных». Видите: «Alice mentioned you at Design
overview». Клик — попадаете на страницу, видите уточнение, отвечаете
в комментарии.

Возвращаетесь после отпуска. Открываете нужный проект, нажимаете
на иконку activity. Видите: «Bob renamed pages, Alice attached a
new repository, 4 new comments resolved». Понимаете общую картину
за 30 секунд вместо чтения всей истории.

Отслеживаете статус спеки. Написали спеку, отправили команде на
ревью. В activity feed видно, кто её комментирует. Если никто не
трогал сутки — напоминаете явно.

Ограничения

• Уведомления храним 90 дней.

• Activity feed храним 6 месяцев.

• Push-уведомления (браузерные) и email-дайджест пока не
  подключены.

• Настройки «выключить всё» пока нет — можно только пометить all
  read.