Экосистема

Календарь это не ещё одно приложение рядом с продуктами, а слой под ними. Разбираемся, где проходит граница ответственности и что из этого следует.

Где проходит граница

Продукт-источник владеет фактом

Что это за отпуск, чьё заседание, по какому делу и на каком основании. Продукт заводит факт, меняет его и отвечает за его смысл.

Календарь владеет расписанием

Когда это происходит, повторяется ли, в каком поясе началось, кто участвует и кому напомнить. Продукты не пишут эту логику у себя.

Поэтому событие продукта не редактируется в сетке Календаря: путь к правке один, ссылка обратно в карточку продукта. Иначе проекция разошлась бы с источником правды.

Продукты в реестре интеграций

Реестр хранит зарегистрированные продукты и выданные им права доступа. Ключ продукта авторизует запись событий, права доступа ограничивают её.

Два направления с A3.Meet

Инициатива по созданию комнаты может исходить с любой стороны, поэтому направления независимы.

  • Из A3.Meet в Календарь

    A3.Meet записывает событие через контракт и сразу заполняет ссылку на комнату. Календарь показывает встречу вместе с остальным расписанием.

  • Из Календаря в A3.Meet

    Человек создаёт событие с отметкой о видеовстрече, Календарь просит A3.Meet создать комнату и сохраняет полученную ссылку в этом же событии.

Интеграции с внешними видеосервисами и разбор писем на предмет бронирований в периметр продукта не входят: у Календаря нет и не будет доступа к личной почте вне A3.Mail.

Виджет вместо своей сетки

Продукту, которому нужно показать расписание внутри своего интерфейса, отдаётся встраиваемый виджет поверх выборки событий и занятости. Рисовать сетку дней у себя не нужно.

  • Кадр встраивается в интерфейс продукта-потребителя
  • Данные берутся из тех же точек контракта, что и веб-приложение
  • Сервер продукта получает короткоживущий токен виджета, сессия пользователя в кадр не передаётся
  • Ключ продуктового вызова во фронтенд не попадает

Что берётся из экосистемы, а не пишется заново

  • A3.ID

    Вход, домены, компании и подписка. Подразделения, рабочие часы и права на календари настраиваются в самом календаре.

  • Производственный календарь

    Праздники и переносы пяти стран приходят из общей библиотеки, своей таблицы праздников нет.

  • Реестр интеграций

    Модель зарегистрированных продуктов и их прав доступа повторяет ту же, что в остальных инфраструктурных продуктах.

  • Почта и уведомления

    Приглашения и напоминания уходят тем же механизмом доставки, что и остальные письма экосистемы.

Работает вместе с

Подключить свой продукт

Регистрация продукта в реестре, выдача прав доступа и первый вызов записи события описаны в документации контракта.