# 推广二维码背景图片说明

## 目录结构

```
static/images/
├── tg_qrcode_1.jpg  # promote 类型的背景图片（推广）
├── yq_qrcode_1.png  # invitation 类型的背景图片（邀请）
└── README.md
```

## 支持的二维码类型

-   `promote`: 使用 tg_qrcode_1.jpg 作为背景（推广二维码）
-   `invitation`: 使用 yq_qrcode_1.png 作为背景（邀请二维码）

## 路径计算说明

程序运行时的路径计算：

-   工作目录：`D:\Code\qnc-project\qnc-server`
-   相对路径：`static/images`
-   完整路径示例：
    -   promote: `D:\Code\qnc-project\qnc-server\static\images\tg_qrcode_1.jpg`
    -   invitation: `D:\Code\qnc-project\qnc-server\static\images\yq_qrcode_1.png`

## 背景图片要求

-   格式：支持 PNG、JPEG 等常见格式
-   尺寸：建议不小于 600x600 像素
-   设计：考虑到二维码会放置在图片中心，请在设计时预留中心区域

## API 使用示例

```bash
# 生成推广二维码
GET /api/v1/agent/promotion/qrcode?qrcode_type=promote&qrcode_url=https://example.com/promotion/12345

# 生成邀请二维码
GET /api/v1/agent/promotion/qrcode?qrcode_type=invitation&qrcode_url=https://example.com/invite/67890
```

## 注意事项

1. 确保 tg_qrcode_1.jpg 和 yq_qrcode_1.png 文件存在于此目录下
2. 二维码会自动添加白色半透明背景以确保可读性
3. 二维码大小会根据背景图片尺寸自动调整，范围在 120px-300px 之间
4. 默认二维码类型是 `promote`
5. 程序启动时必须在项目根目录（qnc-server）下执行