Справочник
Конфигурация, статусы и API
Environment variables, enum-состояния, ограничения и Reviews endpoint.
Environment variables
| Переменная | Назначение |
|---|---|
NEXT_PUBLIC_APP_NAME | Публичное имя приложения, build-time |
NEXT_PUBLIC_API_URL | Необязательный публичный API base URL |
DATABASE_URL | Runtime-подключение PostgreSQL |
DATABASE_SCHEMA | Схема Customer Support |
MIGRATION_DATABASE_URL | Необязательный отдельный DDL credential |
BETTER_AUTH_SECRET | Секрет Better Auth и HMAC public rate limit |
BETTER_AUTH_URL | Канонический URL приложения |
AUTH_ADMIN_NAME | Имя bootstrap Owner |
AUTH_ADMIN_EMAIL | Email bootstrap Owner |
AUTH_ADMIN_PASSWORD | Временный bootstrap password |
SMTP_HOST, SMTP_PORT, SMTP_SECURE | SMTP transport |
SMTP_USER, SMTP_PASSWORD, SMTP_FROM | SMTP credentials и From |
FEEDBACK_CREDENTIALS_ENCRYPTION_KEY | Base64-ключ AES-256-GCM |
FEEDBACK_WORKER_ENABLED | Отключает встроенный worker при отдельном процессе |
Статусы
Workflow: NEW, IN_PROGRESS, RESPONDED, RESOLVED, ARCHIVED.
Remote response: NONE, SENDING, PENDING, PUBLISHED, FAILED.
Sync run: RUNNING, SUCCESS, PARTIAL, FAILED.
Основные ограничения
| Объект | Ограничение |
|---|---|
| Initial store baseline | До 15 отзывов на источник |
| Apple rolling window | До 50 последних отзывов |
| Reply reconciliation | До 20 кандидатов за integration, последние 90 дней |
| Google reply | До 350 символов |
| Notes | До 4000 символов |
| QR comment | До 2000 символов |
| QR public JSON | До 16 KiB |
| QR rate limit | 3 успешных отправки с host за 10 минут |
| Entity email recipients | До 10 |
| App Feedback email recipients | До 20 |
Reviews API
GET /api/feedback/reviews?limit=15&newOnly=true&platform=APPLEEndpoint требует Better Auth session и feedback.read. Он читает только
PostgreSQL и не запускает provider sync.
| Параметр | Значение |
|---|---|
limit | 1–100, по умолчанию 15 |
newOnly=true | Исключить historical baseline |
platform | APPLE, GOOGLE или MINFIN |
Ответы отсортированы от новых к старым. Без сессии возвращается 401, без
permission — 403.
Команды
pnpm dev
pnpm feedback:worker
pnpm db:generate
pnpm db:migrate --name <change>
pnpm db:deploy
pnpm db:seed
pnpm db:studio
pnpm email:test -- recipient@example.com
pnpm typecheck
pnpm lint
pnpm build
pnpm check