Секреты и переменные окружения

Проект использует Doppler для управления секретами и переменными окружения.

Требуемые переменные

Переменная	Описание	Обязательная
API_URL	URL бэкенд API	Да
WEBHOOK_BASE_URL	Base URL для вебхуков интеграций	Да
INNGEST_DASHBOARD_URL	URL дашборда Inngest	Нет (default: https://app.inngest.com)

Установка Doppler CLI

# macOS
brew install dopplerhq/cli/doppler

# Linux
curl -Ls https://cli.doppler.com/install.sh | sh

# Windows (через scoop)
scoop install doppler

После установки авторизуйтесь:

doppler login

Настройка проекта

# Связать локальную директорию с Doppler проектом
doppler setup

При первом запуске выберите:

• Project: integ-admin
• Config: local (для разработки)

Примеры значений

Local (локальная разработка)

API_URL=http://localhost:3000/api
WEBHOOK_BASE_URL=http://localhost:3001
INNGEST_DASHBOARD_URL=https://app.inngest.com

Локальная разработка без Doppler

Для быстрого старта без Doppler, создайте файл .env.local:

API_URL=http://localhost:3000/api
WEBHOOK_BASE_URL=http://localhost:3001

И запустите генерацию с флагом local:

npm run generate:env -- local

Dev (development окружение)

API_URL=https://api.integ.dev.happ.tools/api
WEBHOOK_BASE_URL=https://api.integ.dev.happ.tools
INNGEST_DASHBOARD_URL=https://app.inngest.com

Prod (production окружение)

API_URL=https://api.integ.happ.tools/api
WEBHOOK_BASE_URL=https://api.integ.happ.tools
INNGEST_DASHBOARD_URL=https://app.inngest.com

Где получить значения

API_URL

Окружение	Значение	Источник
Local	http://localhost:3000/api	Локальный запуск integ-api
Dev	https://api.integ.dev.happ.tools/api	Cloudflare Workers (dev)
Prod	https://api.integ.happ.tools/api	Cloudflare Workers (prod)

Как получить:

• Local: Запустите integ-api локально на порту 3000
• Dev/Prod: URL деплоится автоматически через Cloudflare Workers. Проверьте в Cloudflare Dashboard → Workers & Pages → integ-api

WEBHOOK_BASE_URL

Окружение	Значение	Источник
Local	http://localhost:3001	Локальный webhook сервер
Dev	https://api.integ.dev.happ.tools	Cloudflare Workers (dev)
Prod	https://api.integ.happ.tools	Cloudflare Workers (prod)

Как получить:

• Local: Используйте ngrok или локальный туннель для тестирования вебхуков
• Dev/Prod: URL деплоится автоматически. Проверьте в Cloudflare Dashboard

INNGEST_DASHBOARD_URL

Окружение	Значение	Источник
Все	https://app.inngest.com	Inngest Dashboard

Как получить:

• Стандартный URL дашборда Inngest. Не требует изменений между окружениями.
• Для доступа к конкретному проекту используйте URL вида: https://app.inngest.com/env/{env-id}

Генерация environment файлов

После настройки Doppler, сгенерируйте файлы окружения:

# Для локальной разработки
npm run generate:env -- local

# Для dev окружения
npm run generate:env -- dev

# Для production
npm run generate:env -- prod

Команда загрузит секреты из Doppler и создаст файл src/environments/environment.ts.

Doppler Dashboard

• Проект в Doppler: integ-admin
• Управление секретами: Doppler Dashboard → Projects → integ-admin → Configs

Структура конфигов в Doppler

integ-admin/
├── local     # Локальная разработка
├── dev       # Development окружение
└── prod      # Production окружение

Добавление новых секретов

1. Добавьте переменную в Doppler Dashboard для всех нужных конфигов (local/dev/prod)
2. Обновите скрипт scripts/generate-env.script.ts для использования новой переменной
3. Обновите интерфейс environment в src/environments/environment.ts
4. Обновите эту документацию

Безопасность

Важно

• Никогда не коммитьте реальные секреты в репозиторий
• Файлы environment.ts генерируются динамически и не должны содержать production секретов в git
• Используйте Doppler для безопасного хранения и передачи секретов

Troubleshooting

Ошибка "doppler: command not found"

Установите Doppler CLI:

brew install dopplerhq/cli/doppler

Ошибка авторизации

Переавторизуйтесь в Doppler:

doppler logout
doppler login

Ошибка "project not found"

Проверьте настройку проекта:

doppler setup

И выберите правильный проект integ-admin.