"""应用全局配置模块。 通过 pydantic-settings 从 .env 文件和环境变量加载配置, 使用 lru_cache 保证全局单例。所有配置项均可通过环境变量覆盖。 """ from functools import lru_cache from pathlib import Path from pydantic import Field from pydantic_settings import BaseSettings, SettingsConfigDict BASE_DIR = Path(__file__).resolve().parents[2] ENV_FILE = BASE_DIR / ".env" class Settings(BaseSettings): """应用配置类,包含数据库、JWT、OSS、AI、微信等全部配置项。 属性: app_env: 运行环境(dev/test/prod)。 secret_key: JWT 签名密钥。 jwt_expire_minutes: JWT 有效期(分钟)。 mysql_*: MySQL 数据库连接配置。 aliyun_oss_*: 阿里云 OSS 文件存储配置。 ai_provider: AI 服务提供方(mock/aliyun)。 wechat_*: 微信小程序通知配置。 llm_parse_*: 大模型解析订单配置。 """ model_config = SettingsConfigDict( env_file=str(ENV_FILE), env_file_encoding="utf-8", extra="ignore", ) app_env: str = Field(default="dev", alias="APP_ENV") app_name: str = Field(default="order-flow", alias="APP_NAME") api_prefix: str = Field(default="/api", alias="API_PREFIX") secret_key: str = Field(default="change-me", alias="SECRET_KEY") jwt_expire_minutes: int = Field(default=1440, alias="JWT_EXPIRE_MINUTES") auth_token_store_path: str = Field(default="D:/tmp/order-flow-auth/revoked_tokens.json", alias="AUTH_TOKEN_STORE_PATH") cors_allow_origins: str = Field(default="http://localhost:5173", alias="CORS_ALLOW_ORIGINS") mysql_host: str = Field(default="127.0.0.1", alias="MYSQL_HOST") mysql_port: int = Field(default=3306, alias="MYSQL_PORT") mysql_database: str = Field(default="order_flow", alias="MYSQL_DATABASE") mysql_user: str = Field(default="order_user", alias="MYSQL_USER") mysql_password: str = Field(default="password", alias="MYSQL_PASSWORD") sql_echo: bool = Field(default=False, alias="SQL_ECHO") redis_host: str = Field(default="127.0.0.1", alias="REDIS_HOST") redis_port: int = Field(default=6379, alias="REDIS_PORT") redis_db: int = Field(default=0, alias="REDIS_DB") redis_password: str = Field(default="", alias="REDIS_PASSWORD") aliyun_oss_bucket: str = Field(default="bucket-name", alias="ALIYUN_OSS_BUCKET") aliyun_oss_endpoint: str = Field(default="oss-cn-hangzhou.aliyuncs.com", alias="ALIYUN_OSS_ENDPOINT") aliyun_oss_public_base_url: str = Field(default="https://cdn.example.com", alias="ALIYUN_OSS_PUBLIC_BASE_URL") aliyun_oss_access_key_id: str = Field(default="xxx", alias="ALIYUN_OSS_ACCESS_KEY_ID") aliyun_oss_access_key_secret: str = Field(default="xxx", alias="ALIYUN_OSS_ACCESS_KEY_SECRET") oss_signed_url_expire_seconds: int = Field(default=3600, alias="OSS_SIGNED_URL_EXPIRE_SECONDS") oss_upload_max_image_mb: int = Field(default=10, alias="OSS_UPLOAD_MAX_IMAGE_MB") oss_upload_max_video_mb: int = Field(default=200, alias="OSS_UPLOAD_MAX_VIDEO_MB") ai_provider: str = Field(default="mock", alias="AI_PROVIDER") aliyun_ai_region: str = Field(default="cn-hangzhou", alias="ALIYUN_AI_REGION") aliyun_ai_access_key_id: str = Field(default="xxx", alias="ALIYUN_AI_ACCESS_KEY_ID") aliyun_ai_access_key_secret: str = Field(default="xxx", alias="ALIYUN_AI_ACCESS_KEY_SECRET") logistics_trace_provider: str = Field(default="internal", alias="LOGISTICS_TRACE_PROVIDER") logistics_trace_endpoint: str = Field(default="", alias="LOGISTICS_TRACE_ENDPOINT") logistics_trace_path: str = Field(default="", alias="LOGISTICS_TRACE_PATH") logistics_trace_app_code: str = Field(default="", alias="LOGISTICS_TRACE_APPCODE") kuaidi100_key: str = Field(default="", alias="KUAIDI100_KEY") kuaidi100_customer: str = Field(default="", alias="KUAIDI100_CUSTOMER") kuaidi100_secret: str = Field(default="", alias="KUAIDI100_SECRET") kuaidi100_userid: str = Field(default="", alias="KUAIDI100_USERID") wechat_app_id: str = Field(default="", alias="WECHAT_APP_ID") wechat_app_secret: str = Field(default="", alias="WECHAT_APP_SECRET") wechat_template_order_status: str = Field(default="", alias="WECHAT_TEMPLATE_ORDER_STATUS") wechat_template_approval: str = Field(default="", alias="WECHAT_TEMPLATE_APPROVAL") wechat_template_task_assigned: str = Field(default="", alias="WECHAT_TEMPLATE_TASK_ASSIGNED") wechat_template_logistics_timeout: str = Field(default="", alias="WECHAT_TEMPLATE_LOGISTICS_TIMEOUT") wechat_template_arrears: str = Field(default="", alias="WECHAT_TEMPLATE_ARREARS") wechat_template_inactive_customer: str = Field(default="", alias="WECHAT_TEMPLATE_INACTIVE_CUSTOMER") llm_parse_enabled: bool = Field(default=True, alias="LLM_PARSE_ENABLED") llm_parse_model: str = Field(default="qwen-plus", alias="LLM_PARSE_MODEL") llm_parse_api_key: str = Field(default="", alias="LLM_PARSE_API_KEY") llm_parse_api_url: str = Field( default="https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions", alias="LLM_PARSE_API_URL", ) @property def cors_origins(self) -> list[str]: """将逗号分隔的 CORS 白名单字符串解析为列表。""" return [item.strip() for item in self.cors_allow_origins.split(",") if item.strip()] @lru_cache def get_settings() -> Settings: """获取全局配置单例,首次调用时从 .env 加载,后续调用返回缓存。 Returns: Settings: 应用配置实例。 """ return Settings()