# config.example.yaml
# ============================================================================
# 复制本文件为 config.yaml 并填入真实凭据后使用：
#   cp config.example.yaml config.yaml
#
# 说明：
#   - config.yaml 已被 .gitignore 忽略，不会提交到仓库，可安全存放凭据。
#   - 所有配置项均设有默认值，未填写时会自动回退到默认行为，不会报错。
# ============================================================================

# ----------------------------------------------------------------------------
# 调试模式：用于单网点联调，仅挂载并启动指定网点，其余网点不加载。
# ----------------------------------------------------------------------------
debug:
  # 是否启用调试模式（true=仅启动 target_site 一个网点；false=全量启动所有网点）。
  enabled: false

  # 调试模式下要单独启动的网点名称。
  # 仅在 enabled: true 时生效。可选值：顺心 / 百世 / 中通 / 韵达。
  # 留空或不匹配时将回退为全量模式。
  target_site: ""

# ----------------------------------------------------------------------------
# 顺心捷达 (https://sxne.sxjdfreight.com)
# ----------------------------------------------------------------------------
shunxin:
  # 应到 / 实到数据的查询时间范围（单位：天，向前回溯 N 天至今天）。
  query_days: 1

# ----------------------------------------------------------------------------
# 百世快运 (https://v5.800best.com)
# ----------------------------------------------------------------------------
baishi:
  # 应到未到数据导出时需要填写的“登录密码”。
  # 留空会导致导出授权校验失败，无法下载数据。
  password: "YOUR_PASSWORD_HERE"

# ----------------------------------------------------------------------------
# 中通快运 (https://ws.zto56.com/)
# ----------------------------------------------------------------------------
zto:
  # 应到货物数据的查询时间范围（单位：天，向前回溯 N 天至今天）。
  # 建议保持 1。设置过大且超出日历视窗时，会自动降级为仅查询当天。
  query_days: 1

# ----------------------------------------------------------------------------
# 韵达快运 (https://ky-sso.yunda56.com)
# ----------------------------------------------------------------------------
yunda:
  # 自动登录的账号与密码（由 site_yunda.yunda_login 读取并填入登录表单）。
  # 留空时自动登录会填入空串导致登录失败，届时可在浏览器中改为手动登录。
  # 真实凭据仅写进被 .gitignore 忽略的 config.yaml，切勿提交示例值。
  username: "YOUR_USERNAME_HERE"
  password: "YOUR_PASSWORD_HERE"

  # 应到 / 实到数据的查询时间范围（单位：天，向前回溯 N 天至今天）。
  query_days: 1