# api-key-tasks

密钥过期检查与自动生成新密钥的**独立定时任务**进程。从 backend-admin 拆出，单独部署运行。

- **职责**：按配置间隔检查当前密钥是否即将过期，若即将过期则自动生成新密钥并写入 `api_keys` 表。
- **配置**：使用与 backend-admin 相同的数据库与 `system_config` 配置（如 `key_expiry_check_interval_seconds`、`key_advance_generate_minutes`、`key_expire_minutes`）。

## 运行方式

**推荐：使用启动脚本（可从任意目录执行）**

```bash
# 在 api-key-tasks 目录下
./start.sh

# 或在项目根目录下
./api-key-tasks/start.sh
```

**手动运行**（在项目根目录 `steam` 下）：

```bash
PYTHONPATH=backend-admin python api-key-tasks/run.py
```

或先进入本目录并安装依赖后：

```bash
cd api-key-tasks
pip install -r requirements.txt
./start.sh
```

需保证：

- 当前工作目录或环境能加载到 `backend-admin/.env`（或通过环境变量提供数据库等配置）。
- 数据库、`system_config` 表与 backend-admin 一致。

## 停止

Ctrl+C 或发送 SIGTERM，任务会优雅退出。

## 与 backend-admin 的关系

- backend-admin：负责密钥的**生成与管理**（含管理端手动轮换、配置），不再运行密钥过期检查定时任务。
- api-key-tasks：仅运行上述定时任务，不提供 HTTP 服务。