webapp/app/core/config.py

from functools import lru_cache
from pydantic_settings import BaseSettings, SettingsConfigDict
from pydantic import Field


class Settings(BaseSettings):
    # -----------------------
    # App
    # -----------------------
    app_name: str = "MyApp"
    env: str = "PROD"
    debug: bool = False

    # -----------------------
    # Database / Cache
    # -----------------------
    database_url: str = Field(..., description="Async database DSN")
    redis_url: str

    # -----------------------
    # Security / API Keys
    # -----------------------
    openai_api_key: str
    stripe_api_key: str
    stripe_webhook_secret: str
    telegram_api_token: str = Field("", description="Telegram bot API token")
    wechat_api_token: str = Field("", description="Wechat webhook API token")
    whatsapp_api_base_url: str = Field("https://waha.text.skin", description="Whatsapp API base url")
    whatsapp_api_key: str = Field("", description="Whatsapp API key")
    whatsapp_session: str = Field("default", description="Whatsapp session")

    model_config = SettingsConfigDict(
        env_file=".env",
        env_file_encoding="utf-8",
        case_sensitive=False,
    )


@lru_cache
def get_settings() -> Settings:
    """
    避免多次实例化 Settings（FastAPI 官方推荐）
    """
    return Settings()


settings = get_settings()