Files
chatballs/env.example
T
AndreyandClaude Fable 5.1 1a61780dec 🚚 chore!: переименование инфраструктуры CustoCRM/hub → Chatballs с миграцией
- каталог code/custocrm → code/chatballs; CLI custocrm → chatballs; пакеты
  hub_platform → chatballs, hub_backend → chatballs_backend (app labels прежние)
- переменные CUS_* и CUSTOCRM_* → CHATBALLS_*; образы chatballs-*; compose-проект
  и база chatballs (были edevs_hub); роли Postgres chatballs_* (были custocrm_*);
  схема RLS chatballs и GUC chatballs.organization_id; cookie chatballs_*
- CI: APP_DIR code/chatballs, DEPLOY_ROOT /opt/chatballs
- deploy/migrate/rename-to-chatballs.sh — миграция существующей установки без
  потери данных: остановка старого проекта, .env (с резервной копией),
  переименование суперпользователя initdb через временную роль, остальных ролей,
  базы, схемы и функции RLS; проверено на локальном стеке
- dev-стек хранит Postgres в bind-mount data/postgres, как prod (именованный том
  compose.dev был устаревшим снимком и вводил в заблуждение)
- снятие демо удаляет объекты, созданные поверх демо-данных тестировавшим
  (звонки по демо-диалогу), вместо падения на PROTECT
- реальные домены *.custocrm.ru и идентификаторы документов не тронуты

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-05 22:21:12 +03:00

132 lines
5.9 KiB
Plaintext

# Instance configuration Chatballs (ADR-HUB-0028 / SPEC-HUB-0019 §7.2).
# Поставляется в release bundle. Копируется в instance/.env и редактируется
# под конкретный экземпляр. Image references НЕ здесь — они в release.env (CI).
# Здесь нет initial OWNER password и нет demo-флага (см. SPEC §7.2 запреты).
COMPOSE_PROJECT_NAME=chatballs
# --- Instance identity / gateway ---
CHATBALLS_APP_DOMAIN=app.example.com
CHATBALLS_PLATFORM_DOMAIN=platform.example.com
CHATBALLS_HELP_BASE_DOMAIN=help.example.com
CHATBALLS_HELP_PUBLIC_SCHEME=https
CHATBALLS_HELP_PUBLIC_PORT=
# Необязательный отдельный IPv4 для A-записей собственных доменов.
# По умолчанию используется CHATBALLS_WEB_LISTENING_IP.
CHATBALLS_HELP_PUBLIC_IPV4=203.0.113.10
CHATBALLS_ACME_EMAIL=admin@example.com
CHATBALLS_ADMIN_PORT=18001
# IP web-gateway. Оставьте 0.0.0.0 без profile calls. Для calls укажите
# отдельный публичный IP, отличный от CHATBALLS_TURN_LISTENING_IP.
CHATBALLS_WEB_LISTENING_IP=0.0.0.0
# Опциональные profiles: calls (coturn), и в будущем voice.
# COMPOSE_PROFILES=calls
# --- Django core ---
CHATBALLS_ENV=production
CHATBALLS_DEBUG=false
# Коробочная поставка. Облачный контур использует CLOUD.
CHATBALLS_DELIVERY_MODE=SELF_HOSTED
CHATBALLS_SECRET_KEY=change-me-long-random-secret
# Шифрование секретов в БД (Fernet-ключ): Fernet.generate_key().
CHATBALLS_FIELD_ENCRYPTION_KEY=
CHATBALLS_APP_ALLOWED_HOSTS=app.example.com
CHATBALLS_APP_CSRF_TRUSTED_ORIGINS=https://app.example.com
CHATBALLS_PLATFORM_ALLOWED_HOSTS=platform.example.com
CHATBALLS_PLATFORM_CSRF_TRUSTED_ORIGINS=https://platform.example.com
CHATBALLS_CORS_ALLOWED_ORIGINS=https://app.example.com
INTERNAL_UI_BASE_URL=https://app.example.com
# Host headers для Docker healthchecks должны входить в surface ALLOWED_HOSTS.
CHATBALLS_APP_HEALTHCHECK_HOST=app.example.com
CHATBALLS_PLATFORM_HEALTHCHECK_HOST=platform.example.com
# Транспортная безопасность (вне CHATBALLS_DEBUG включается автоматически).
CHATBALLS_COOKIE_SECURE=true
CHATBALLS_SSL_REDIRECT=true
CHATBALLS_HSTS_SECONDS=31536000
CHATBALLS_COOKIE_SAMESITE=Lax
# --- PostgreSQL / Redis ---
# C04 RLS: три раздельные DB-roles (app/platform/migration). Runtime-роли app и
# platform — NOBYPASSRLS, не владельцы tenant-tables; миграции выполняются под
# migration-role (через CHATBALLS_DB_ROLE=migration в compose). Пароли СГЕНЕРИРОВАТЬ,
# не использовать значения по умолчанию. См. deploy/postgres/init-runtime-roles.sh.
POSTGRES_DB=chatballs
POSTGRES_USER=chatballs
POSTGRES_PASSWORD=change-me-db-password
POSTGRES_APP_USER=chatballs_app
POSTGRES_APP_PASSWORD=change-me-app-db-password
POSTGRES_PLATFORM_USER=chatballs_platform
POSTGRES_PLATFORM_PASSWORD=change-me-platform-db-password
POSTGRES_MIGRATION_USER=chatballs_migration
POSTGRES_MIGRATION_PASSWORD=change-me-migration-db-password
POSTGRES_HOST=postgres
POSTGRES_PORT=5432
# psycopg connection pool per процесс (backend работает под ASGI, где
# CONN_MAX_AGE-соединения осиротевают в thread-pool). Значения по умолчанию
# заданы в settings_database.py; переопределять обычно не нужно.
# CHATBALLS_DB_POOL_MAX=0 отключает пул целиком.
#CHATBALLS_DB_POOL_MIN=1
#CHATBALLS_DB_POOL_MAX=4
#CHATBALLS_DB_POOL_TIMEOUT=10
REDIS_URL=redis://redis:6379/0
# --- Tenant-owned object storage (C04) ---
# Production ТРЕБУЕТ S3-compatible backend (settings hard-fails без него вне
# debug/testing). Ключи хранятся как organizations/{organization_public_id}/...
# CHATBALLS_S3_BUCKET обязателен; endpoint/region/credentials — для провайдера
# (Yandex Object Storage, MinIO, AWS S3 и т.п.).
CHATBALLS_STORAGE_BACKEND=s3
CHATBALLS_S3_BUCKET=
CHATBALLS_S3_ENDPOINT_URL=
CHATBALLS_S3_REGION=
CHATBALLS_S3_ACCESS_KEY=
CHATBALLS_S3_SECRET_KEY=
CHATBALLS_S3_ADDRESSING_STYLE=path
CHATBALLS_S3_URL_EXPIRY_SECONDS=900
# --- P2P calls (profile calls) ---
# Включается только при COMPOSE_PROFILES=calls. Параметры coturn обязательны,
# если profile активен.
CHATBALLS_CALL_INVITE_TTL_SECONDS=300
CHATBALLS_CALL_ACCESS_TTL_SECONDS=3600
CHATBALLS_CALL_CONNECT_GRACE_SECONDS=120
CHATBALLS_CALL_RECONNECT_GRACE_SECONDS=60
CHATBALLS_CALL_STUN_URLS=
# Публичные TURN endpoints (через запятую). Пусто -> только STUN/direct.
CHATBALLS_CALL_TURN_URLS=
# Общий static-auth-secret между backend и coturn.
CHATBALLS_CALL_TURN_SECRET=
CHATBALLS_CALL_TURN_TTL_SECONDS=3600
CHATBALLS_CALL_TURN_REALM=app.example.com
# Публичный IP coturn listener/relay. ОТДЕЛЬНЫЙ от web IP, чтобы TURN занял 443.
CHATBALLS_TURN_EXTERNAL_IP=
CHATBALLS_TURN_LISTENING_IP=
CHATBALLS_TURN_LISTENING_PORT=3478
CHATBALLS_TURN_TLS_PORT=443
CHATBALLS_TURN_MIN_PORT=49160
CHATBALLS_TURN_MAX_PORT=49200
# --- AI provider ---
CHATBALLS_OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
CHATBALLS_CUSTOAI_API_KEY=
CHATBALLS_CUSTOAI_BASE_URL=https://ai.api.cloud.yandex.net/v1
CHATBALLS_CUSTOAI_MODEL=gpt://b1g89tr9t8iedhnl8pgg/yandexgpt-5.1/latest
CHATBALLS_AI_REQUEST_TIMEOUT=30
CHATBALLS_AI_MAX_RETRIES=2
CHATBALLS_AI_GLOBAL_DAILY_COST_LIMIT_MICROS=0
# --- Email ---
EMAIL_BACKEND=django.core.mail.backends.smtp.EmailBackend
EMAIL_HOST=
EMAIL_PORT=587
EMAIL_HOST_USER=
EMAIL_HOST_PASSWORD=
EMAIL_USE_TLS=true
DEFAULT_FROM_EMAIL=Chatballs <no-reply@example.com>
# --- Gunicorn ---
CHATBALLS_GUNICORN_WORKERS=3
CHATBALLS_GUNICORN_TIMEOUT=60