from pydantic_settings import BaseSettings from typing import Optional from pathlib import Path import os class Settings(BaseSettings): """应用配置""" # 应用基础配置 APP_NAME: str = "zkxw 管理骨架" DEBUG: bool = True API_V1_PREFIX: str = "/api" # 数据库配置 DATABASE_URL: str = "mysql+pymysql://root:password@localhost:3306/sanqiang" # JWT配置 SECRET_KEY: str = "your-secret-key-change-in-production-please-use-random-string" ALGORITHM: str = "HS256" ACCESS_TOKEN_EXPIRE_MINUTES: int = 30 * 24 # 30天 # CORS配置 BACKEND_CORS_ORIGINS: list = [ "http://localhost:5173", # art-design-pro 开发服务器 "http://localhost:8080", "http://localhost:8081", # uni-app H5 端口被占用时常用 "http://localhost:8082", "http://127.0.0.1:5173", "http://127.0.0.1:8080", "http://127.0.0.1:8081", "http://127.0.0.1:8082", "http://localhost:3000", # Web开发 "http://localhost:3006", # Web开发 "http://127.0.0.1:3000", "http://127.0.0.1:3006", ] # 文件存储配置 STORAGE_TYPE: str = "local" # local, qiniu, oss, minio # 本地存储配置 LOCAL_UPLOAD_DIR: str = "uploads" LOCAL_STORAGE_URL: str = "/uploads" # Redis 配置(用于登录会话与 refreshToken 吊销) # 未配置 REDIS_HOST 时,后端会保持兼容:仍然只校验 JWT,不强制会话吊销。 REDIS_HOST: str = "" REDIS_PORT: int = 6379 REDIS_DB: int = 0 REDIS_PASSWORD: str = "" REDIS_TIMEOUT_SEC: int = 30 REDIS_SSL_ENABLED: bool = False # 七牛云存储配置 (生产环境推荐) QINIU_ACCESS_KEY: str = "" QINIU_SECRET_KEY: str = "" QINIU_BUCKET: str = "" QINIU_DOMAIN: str = "" # 阿里云OSS配置 (可选) OSS_ACCESS_KEY_ID: str = "" OSS_ACCESS_KEY_SECRET: str = "" OSS_BUCKET: str = "" OSS_ENDPOINT: str = "" OSS_DOMAIN: str = "" # MinIO配置 MINIO_ENDPOINT: str = "" MINIO_ACCESS_KEY: str = "" MINIO_SECRET_KEY: str = "" MINIO_BUCKET: str = "" MINIO_SECURE: bool = False MINIO_BASE_URL: str = "" # 微信支付配置 (生产环境必需) WXPAY_MCHID: str = "" # 商户号 WXPAY_APPID: str = "" # 公众号AppID WXPAY_MINI_APPID: str = "" # 小程序AppID WXPAY_API_KEY: str = "" # API密钥 (V2) WXPAY_SANDBOX: bool = False # 是否使用沙箱环境 WXPAY_NOTIFY_URL: str = "https://your-domain.com/api/payment/notify" # 支付回调地址 WXPAY_REFUND_NOTIFY_URL: str = "https://your-domain.com/api/payment/refund-notify" # 退款回调地址 # V3 API 证书配置 WXPAY_CERT_PATH: str = "" # API证书(apiclient_cert.pem)路径 WXPAY_PRIVATE_KEY_PATH: str = "" # API私钥(apiclient_key.pem)路径 WXPAY_SERIAL_NO: str = "" # 证书序列号 # SSL证书配置 (退款必需) WXPAY_SSL_CERT: str = "" # SSL证书路径 WXPAY_SSL_KEY: str = "" # SSL私钥路径 # 微信小程序配置 WXPAY_SECRET: str = "" # 小程序Secret # 微信模板消息ID配置 WX_TEMPLATE_ORDER_STATUS: str = "" # 订单状态通知模板ID WX_TEMPLATE_DELIVERY_NOTICE: str = "" # 配送通知模板ID WX_TEMPLATE_PAYMENT_SUCCESS: str = "" # 支付成功通知模板ID WX_TEMPLATE_REFUND_RESULT: str = "" # 退款结果通知模板ID WX_TEMPLATE_DELIVERY_WARNING: str = "" # 配送时效预警模板ID # 与 docs/sql/zkxw.sql 基线一致:登录按租户 + sys_user.user_no DEFAULT_TENANT_NO: str = "zkxw" # 已废弃:无角色用户固定为 guest,不可通过环境变量提升为 super_admin WEB_AUTH_DEFAULT_ROLE: str = "guest" # 登录 RSA:私钥 PEM(多实例建议配置同一私钥;留空则各 Worker 共用内置默认密钥 login_rsa_default.pem) LOGIN_RSA_PRIVATE_KEY_PEM: str = "" # 是否允许明文 username/password 登录(仅建议本地排障临时开启;生产务必 false) LOGIN_ALLOW_PLAINTEXT_LOGIN: bool = False # 加密载荷内时间戳允许偏差(秒),防简单重放 LOGIN_ENCRYPT_TS_SKEW_SEC: int = 300 # 临时文件目录 TEMP_FILE_DIR: str = "temp_files" # 全量 API 请求日志(中间件写入 sys_api_request_log) API_REQUEST_LOG_ENABLED: bool = True API_REQUEST_LOG_MAX_BODY: int = 65536 API_REQUEST_LOG_MAX_BODY_BYTES: int = 131072 # Web API 请求/响应加密配置 API_ENCRYPT_ENABLED: bool = False API_ENCRYPT_FAIL_OPEN: bool = True API_ENCRYPT_FIXED_SECRET: str = "" API_ENCRYPT_TS_SKEW_SEC: int = 300 API_ENCRYPT_NONCE_TTL_SEC: int = 300 API_ENCRYPT_EXCLUDE_PATHS: str = ( "/," "/health," "/docs," "/openapi.json," "/api/web/auth/login-rsa-public-key," "/api/web/auth/login," "/api/web/auth/refresh-token," "/api/web/admin/attachment/upload," "/api/web/admin/products/upload-image," "/api/web/admin/categories/upload-image," "/api/web/admin/users/upload-avatar," "/api/web/auth/upload-avatar," "/api/invoice/download" ) class Config: # 支持通过 ENV_FILE 指定环境文件;未指定时回退到 backend/.env _default_env_file = Path(__file__).resolve().parents[2] / ".env" env_file = os.getenv("ENV_FILE", str(_default_env_file)) case_sensitive = True settings = Settings()