dingdanquanliucheng/backend/.env.example

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

# 运行环境：dev(开发) / prod(生产) / test(测试)
APP_ENV=dev
# 应用名称，用于标识服务
APP_NAME=order-flow
# API 路由前缀，所有接口都会以此路径开头
API_PREFIX=/api
# 后端服务公网访问地址（用于生成文件URL等绝对路径，生产环境必填）
BASE_URL=http://127.0.0.1:8000

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

# 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

# LLM 解析 API Key（DashScope 通义千问）
LLM_PARSE_API_KEY=
# LLM 模型名称（默认 qwen-plus）
LLM_PARSE_MODEL=qwen-plus
# LLM API 地址（默认 dashscope 兼容模式）
LLM_PARSE_API_URL=https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions

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

# 物流查询服务商：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

# ==================== 微信小程序订阅消息 ====================

# 微信小程序 AppID
WECHAT_APP_ID=
# 微信小程序 AppSecret
WECHAT_APP_SECRET=
# 订单状态变更通知模板 ID
WECHAT_TEMPLATE_ORDER_STATUS=TkCDtUd1d2MPzMMy_QwvaoHxvweBY-uA9p3jk3nsKi0
# 审批通知模板 ID
WECHAT_TEMPLATE_APPROVAL=xNlOt-_6jMTh5VKf9F_pX4aMtwpjXZKUBBTp8QtzTag
# 任务分配通知模板 ID
WECHAT_TEMPLATE_TASK_ASSIGNED=uzivHUxL1A3cBguMvC6HDO4aXqvmCV8X3o538SpDEX4
# 物流超时通知模板 ID
WECHAT_TEMPLATE_LOGISTICS_TIMEOUT=1NtPbIS_LtmsJhl4V4V3poWO_EZYYFNbKoLzO1TLTDc
# 欠款提醒模板 ID
WECHAT_TEMPLATE_ARREARS=ulYRf4HgTXNWYSqT0KYVKJiHnG19_12tjcDXMYD2kHo
# 客户沉默提醒模板 ID
WECHAT_TEMPLATE_INACTIVE_CUSTOMER=pWYFYbZNJvnOGD-4ycNf8zxmseIiuogFAXa9biVscBc

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

# 允许跨域请求的来源地址（多个用逗号分隔，前端开发时按实际端口配置）
CORS_ALLOW_ORIGINS=http://localhost:5173,http://localhost:5174
# 日志级别：DEBUG / INFO / WARNING / ERROR / CRITICAL
LOG_LEVEL=INFO
# 本地上传文件存储目录（开发环境用，生产环境建议使用 OSS）
LOCAL_UPLOAD_DIR=D:/tmp/order-flow-oss/local-uploads