Техническое задание: Интеграция API онлайн-записи для медицинского сайта

1. Общая архитектура и реализация

Интеграция должна быть выполнена в рамках экосистемы WordPress. Основные требования к архитектуре:

  • Предпочтительный способ: Разработка отдельного, изолированного плагина WordPress. Условное название плагина: online-booking-integration.
  • Нежелательный способ: Встраивание логики в пользовательскую тему (кастомную тему).

2. Функциональные требования к плагину

2.1. Административная часть (бэкенд)

Плагин должен предоставлять в админ-панели WordPress раздел настроек со следующими параметрами:

  • Авторизационный токен (API-ключ) для доступа к внешнему сервису.
  • Базовый URL-адрес внешнего API.
  • Время жизни кэша (TTL) для различных типов данных.
  • Настройки лимитов запросов (rate limiting).

2.2. Слой взаимодействия с фронтендом (BFF - Backend For Frontend)

Плагин должен реализовывать собственные REST API endpoints (точки доступа) на стороне WordPress. Эти endpoints будут использоваться фронтендом сайта (JavaScript) для получения данных в удобном формате. Их задачи:

  • Обращение к внешнему API онлайн-записи.
  • Кэширование и нормализация (приведение к единому формату) полученных ответов.
  • Возврат структурированных данных для отображения на сайте.

2.3. Пользовательская часть (фронтенд)

Плагин должен предоставлять механизмы для легкого встраивания виджета онлайн-записи в контент сайта:

  • Поддержка шорткода (shortcode) для вставки в любую страницу или пост.
  • Создание блока Гутенберга для визуального редактирования.
  • Виджет должен автоматически подтягивать контекст (например, данные конкретного врача или услуги) при размещении на соответствующих шаблонах.

2.4. Дополнительные возможности (опционально)

  • Реализация фоновых задач (CRON) или механизма для периодического обновления ("прогрева") справочников (списки врачей, услуг, расписания) для ускорения работы и снижения нагрузки на внешний API.

3. Технические ограничения

  • Запрещено размещать логику интеграции напрямую в файлах темы.
  • Запрещено делать прямые вызовы внешнего API со стороны фронтенда (браузера пользователя). Все запросы должны проходить через endpoints плагина на стороне WordPress.