dingdanquanliucheng/backend/.env.example

# ==================== 应用基础配置 ====================

# 运行环境：dev(开发) / prod(生产) / test(测试)
APP_ENV=dev
# 应用名称，用于标识服务
APP_NAME=order-flow
# API 路由前缀，所有接口都会以此路径开头
API_PREFIX=/api

# ==================== 安全与认证 ====================

# JWT 签名密钥，生产环境务必修改为随机字符串
SECRET_KEY=change-me
# JWT Token 有效期（分钟），1440 = 24小时
JWT_EXPIRE_MINUTES=1440
# 已撤销 Token 的存储路径（用于黑名单机制）
AUTH_TOKEN_STORE_PATH=D:/tmp/order-flow-auth/revoked_tokens.json

# ==================== MySQL 数据库 ====================

# 数据库主机地址（IP 或域名）
MYSQL_HOST=127.0.0.1
# 数据库端口
MYSQL_PORT=3306
# 数据库名称
MYSQL_DATABASE=order_flow
# 数据库用户名
MYSQL_USER=taiyi
# 数据库密码
MYSQL_PASSWORD=taiyi1224
# 是否在控制台打印 SQL 语句（调试用，生产环境建议关闭）
SQL_ECHO=false

# ==================== 阿里云 OSS 对象存储 ====================

# OSS 存储桶名称
ALIYUN_OSS_BUCKET=bucket-name
# OSS 访问端点（根据 Bucket 所在地域选择，如 oss-cn-hangzhou.aliyuncs.com）
ALIYUN_OSS_ENDPOINT=oss-cn-hangzhou.aliyuncs.com
# 阿里云 AccessKey ID（在 RAM 控制台获取）
ALIYUN_OSS_ACCESS_KEY_ID=xxx
# 阿里云 AccessKey Secret（与上面的 ID 配对，注意保密）
ALIYUN_OSS_ACCESS_KEY_SECRET=xxx
# OSS 文件的公网访问基地址（用于生成文件 URL）
ALIYUN_OSS_PUBLIC_BASE_URL=https://cdn.example.com
# 签名 URL 有效期（秒），超过时间后链接失效
OSS_SIGNED_URL_EXPIRE_SECONDS=3600
# 允许上传的图片最大大小（MB）
OSS_UPLOAD_MAX_IMAGE_MB=10
# 允许上传的视频最大大小（MB）
OSS_UPLOAD_MAX_VIDEO_MB=200

# ==================== AI 服务（OCR/智能识别） ====================

# AI 服务提供商：mock(模拟) / aliyun(阿里云)
AI_PROVIDER=mock
# 阿里云 AI 服务所在地域（需与 OSS 同地域或支持 AI 服务的地域）
ALIYUN_AI_REGION=cn-hangzhou
# 阿里云 AI 服务的 AccessKey ID（可与 OSS 共用，也可单独配置）
ALIYUN_AI_ACCESS_KEY_ID=xxx
# 阿里云 AI 服务的 AccessKey Secret
ALIYUN_AI_ACCESS_KEY_SECRET=xxx
# OCR 模型名称（使用默认模型时填 default）
ALIYUN_OCR_MODEL=default
# OCR 服务自定义端点地址（留空则使用默认端点）
ALIYUN_OCR_ENDPOINT=
# OCR 服务请求路径（留空则使用默认路径）
ALIYUN_OCR_PATH=
# OCR 应用码（部分 OCR 服务需要此配置）
ALIYUN_OCR_APPCODE=

# ==================== 物流轨迹查询 ====================

# 物流查询服务商：kuaidi100(快递100) / internal(内部)
LOGISTICS_TRACE_PROVIDER=internal
# 物流查询 API 基础地址
LOGISTICS_TRACE_ENDPOINT=
# 物流查询 API 路径（与基础地址拼接形成完整 URL）
LOGISTICS_TRACE_PATH=
# 快递100 API Key（在快递100开放平台申请）
KUAIDI100_KEY=xxx
# 快递100 客户编号（注册后获得）
KUAIDI100_CUSTOMER=xxx
# 快递100 签名密钥（用于 API 请求签名）
KUAIDI100_SECRET=xxx
# 快递100 用户 ID
KUAIDI100_USERID=xxx

# ==================== 跨域与日志 ====================

# 允许跨域请求的来源地址（多个用逗号分隔，前端开发时按实际端口配置）
CORS_ALLOW_ORIGINS=http://localhost:5173,http://localhost:5174
# 日志级别：DEBUG / INFO / WARNING / ERROR / CRITICAL
LOG_LEVEL=INFO