# Kong decK 使用说明

## 前置
- 已安装并启动 Kong（DB 模式，推荐 Postgres）
- 安装 decK：参考官方文档

## 目录
- 配置文件：`deck.yaml`

## 常用命令
```bash
# 校验配置
deck validate --state deck.yaml

# 直接导入（会覆盖已有同名资源）
deck sync --state deck.yaml

# 以 diff 方式查看变更
deck diff --state deck.yaml
```

## 本地开发说明
- services.host 使用 `host.docker.internal:3001` 将请求转发到宿主机运行的 NestJS
- 若 Kong 与后端同在宿主机，可将 host 改为 `localhost`

## 插件
- correlation-id：统一请求 ID（上游未传则生成），下游透传
- rate-limiting：示例每分钟 300 次，可据环境覆盖
- prometheus：开启 Kong 指标，抓取地址 `:8001/metrics`

## 环境差异化
- 建议按环境拆分 `deck.dev.yaml`、`deck.prod.yaml` 或使用 CI 注入变量
- 关键变量：上游 host/port、限流阈值、超时、JWT 公钥/密钥

## 与后端配合
- 后端会记录并透传 `X-Request-ID` / `traceparent`
- Kong 可作为北向入口，/api 与 /adminapi 分流 