Интеграция стороннего сервиса

Интегрируй сервис {{service}} в проект. Use case: {{use_case}}.

Шаги

1. Прочитай официальную документацию — основные концепции, рекомендуемый SDK, тестовый режим.
2. Запланируй интеграцию, не пиши код сразу. Определи:
   • Где живёт код интеграции (отдельный модуль в lib/)
   • Какие методы сервиса используем
   • Какие данные сохраняем у себя
   • Обработка ошибок: retry, timeouts, fallback
   • Где хранятся секреты (.env.local)
3. Секреты
   • Добавь переменные в .env.example (без значений)
   • Документируй где получить ключи
   • Никогда не коммить реальные ключи
4. Реализация
   • Создай типизированный клиент в lib/{{service}}.ts
   • Все вызовы через один файл (легче менять)
   • В каждой функции — обработка ошибок и логирование
5. Тестовый режим
   • Используй sandbox / test mode, если есть
   • Документируй как переключаться между test и prod
6. Webhook'и (если есть)
   • Endpoint в app/api/webhooks/{{service}}/route.ts
   • Верификация подписи (важно!)
   • Идемпотентность обработки
7. Документация
   • Короткий README в директории интеграции
   • Что сделать чтобы локально работало
   • Известные подводные камни

Контрольный список перед PR

• Секреты не в коде
• .env.example обновлён
• Все ошибки обрабатываются
• Webhook верифицирует подпись
• Логирование без чувствительных данных
• Документация написана

Не делай: прямые вызовы из компонентов. Всё через серверные actions или API routes.