.env.example

# FastAPI Admin v3 环境配置示例
# 复制此文件为 .env 并修改配置值

# ==================== 环境配置 ====================
# 运行环境: dev(开发), test(测试), prod(生产)
ENV=dev
# 调试模式: True(启用), False(禁用)，生产环境应设为 False
DEBUG=True

# ==================== 应用配置 ====================
# 应用监听地址
APP_HOST=0.0.0.0
# 应用监听端口
APP_PORT=8000
# API 版本前缀
API_V1_STR=/api/v1
# JWT 密钥 (至少 32 字符，生产环境必须更换！)
# 可使用命令生成: python -c "import secrets; print(secrets.token_urlsafe(32))"
SECRET_KEY=your-secret-key-at-least-32-characters
# Access Token 过期时间 (分钟)
ACCESS_TOKEN_EXPIRE_MINUTES=30
# Refresh Token 过期时间 (天)
REFRESH_TOKEN_EXPIRE_DAYS=7
# JWT 加密算法
ALGORITHM=HS256
# 允许的主机列表 (JSON 数组格式)
ALLOWED_HOSTS=["*"]

# ==================== CORS 配置 ====================
# 允许的跨域来源 (JSON 数组格式)，生产环境应配置具体域名
CORS_ORIGINS=["*"]
# 是否允许携带凭据 (Cookie)
CORS_ALLOW_CREDENTIALS=True
# 允许的 HTTP 方法
CORS_ALLOW_METHODS=["*"]
# 允许的 HTTP 请求头
CORS_ALLOW_HEADERS=["*"]

# ==================== 缓存配置 ====================
# 缓存后端: memory(内存), redis(Redis)
CACHE_BACKEND=memory
# Redis 连接 URL (仅 CACHE_BACKEND=redis 时使用)
REDIS_URL=redis://localhost:6379/0
# 默认缓存过期时间 (秒)
CACHE_DEFAULT_TTL=300

# ==================== 定时任务配置 ====================
# 定时任务后端: apscheduler(轻量, 进程内), celery(分布式), none(禁用)
SCHEDULER_BACKEND=apscheduler
# 定时任务时区  
SCHEDULER_TIMEZONE=Asia/Shanghai
# Celery 配置 (仅当 SCHEDULER_BACKEND=celery 时需要)
CELERY_BROKER_URL=redis://localhost:6379/1
CELERY_RESULT_BACKEND=redis://localhost:6379/2

# ==================== 数据库配置 ====================
# PostgreSQL 连接字符串
# 格式: postgres://用户名:密码@主机:端口/数据库名
DATABASE_URL=postgres://username:password@localhost:5432/fastapi_admin_v3
# 连接池大小
DB_POOL_SIZE=20
# 连接池最大溢出数
DB_MAX_OVERFLOW=10
# 连接回收时间 (秒)
DB_POOL_RECYCLE=3600

# ==================== 初始化配置 ====================
# 初始超级管理员用户名
FIRST_SUPERUSER=admin
# 初始超级管理员密码 (生产环境必须更换！)
FIRST_SUPERUSER_PASSWORD=123456
# 初始超级管理员邮箱
FIRST_SUPERUSER_EMAIL=admin@example.com
# 初始超级管理员手机号
FIRST_SUPERUSER_PHONE=13800000000