qnc-server-tob/static/images

推广二维码背景图片说明

目录结构

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 使用示例

# 生成推广二维码
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）下执行