voidea/docs/env-management.md

Управление переменными окружения

Принцип

Все настройки, которые меняются между окружениями — в переменных окружения. Никаких hardcoded значений.

Формат: .env

# === Core ===
PROJECT_NAME=VoIdea
PROJECT_ENV=production

# === Server ===
SERVER_HOST=0.0.0.0
SERVER_PORT=8020

# === Database (PostgreSQL only) ===
DATABASE_URL=postgresql+asyncpg://voidea:password@localhost:5432/voidea

# === JWT ===
JWT_SECRET_KEY=your-secret-key
JWT_ALGORITHM=HS256

# === AI ===
AI_YANDEX_KEY=
AI_YANDEX_FOLDER_ID=
AI_GIGACHAT_CLIENT_ID=
AI_GIGACHAT_SECRET=

Валидация при старте

# app/core/config.py
class Settings(BaseSettings):
    model_config = SettingsConfigDict(env_file=".env", extra="ignore")

    database_url: str = "postgresql+asyncpg://voidea:password@localhost:5432/voidea"
    jwt_secret_key: str = ""

    @property
    def sync_database_url(self) -> str:
        return self.database_url.replace("+asyncpg", "")

Синхронизация .env.example

• .env.example в репозитории
• Обновляется при каждом добавлении переменной
• Все переменные с комментариями
• Чувствительные значения пустые
• Секции разделены # === Name ===

Secrets management

Окружение	Где хранить
Local	.env (в .gitignore)
Production	GitHub Secrets / 1Password