# AirGate

火山引擎 IAM 子账号管控平台。独立部署，带管理界面，可通过 API 对接其他系统。

## 解决什么问题

火山引擎的 IAM 子账号没有消费限额功能，子账号可以不受限地花光主账号余额。AirGate 通过额度划拨 + 阶梯告警 + 自动停用，实现对子账号的消费管控。

## 核心功能

| 功能 | 说明 |
|------|------|
| **子账号管理** | 创建 / 同步 / 停用 / 恢复 IAM 子账号 |
| **权限策略** | 查看 / 附加 / 移除 IAM 策略（Ark、TOS 等） |
| **额度划拨** | 主账号给子账号划拨额度，支持追加和扣减 |
| **阶梯告警** | 消费达到额度的 50% / 80% / 90% 时飞书通知 |
| **自动停用** | 消费达到额度 100% 时自动停用子账号 |
| **消费监控** | 定时查询 Billing API，按项目维度追踪消费 |
| **密钥安全** | 主账号 AK/SK 加密存储（AES-256），界面脱敏显示 |

## 使用前提

- 子账号的资源需要放在**独立的火山项目**下，消费才能按项目准确追踪
- 火山账单数据有 **1-2 天延迟**，划拨额度时建议预留余量

## 本地运行

```bash
# 1. 复制环境变量
cp .env.example .env
# 编辑 .env，填入 AIRGATE_ENCRYPTION_KEY（生成方式见文件内注释）

# 2. 启动后端
cd backend
python -m venv venv
venv\Scripts\activate        # Windows
pip install -r requirements.txt
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver 8101

# 3. 启动前端（另一个终端）
cd frontend
npm install
npm run dev
```

打开 `http://localhost:5174`，登录后：

1. **系统设置** → 添加火山主账号（填 AK/SK，加密存储）
2. **子账号管理** → 同步已有用户 或 创建新子账号
3. 给子账号点 **划拨** → 设置额度
4. 点 **更多 → 监控配置** → 选关联项目 + 设告警阶梯

## Docker 部署

```bash
docker-compose up -d
```

- 前端：`http://localhost:5174`
- 后端：`http://localhost:8101`

## 外部系统对接

AirDrama 等外部系统可通过 API Key 调用 AirGate 接口：

```bash
curl -H "X-API-Key: 你的key" http://airgate:8101/api/v1/iam-users/
```

在 `.env` 中设置 `AIRGATE_API_KEY` 启用。

## 技术栈

- 后端：Django 4.2 + DRF + APScheduler
- 前端：Vue 3 + Element Plus
- 加密：cryptography (Fernet)
- 部署：Docker + Nginx