使用CodeBuddy构建内部抽奖工具

- 报名提交：姓名、手机号、平台、链接/截图地址
- 管理后台API：列表、抽奖、导出CSV、查看中奖名单
- 简易防刷：同一手机号或IP在可配置时间窗内限制提交次数
- 配置通过 `.env` 管理，敏感变量仅在服务端读取

## 后端
- Python 3.11+
- FastAPI + Uvicorn（异步 API 与 ASGI 服务器）
- SQLAlchemy + PyMySQL（ORM 与 MySQL/MariaDB 驱动）
- Pydantic / pydantic-settings（数据校验与配置管理）
- python-dotenv（本地加载环境变量）
## 前端
- 静态 HTML / CSS / 原生 JavaScript
- Fetch API（与后端接口交互）
## 配套工具
- Logging（标准库日志记录）
- CSV 工具（导出报名数据）
- `.env` 配置与 `requirements.txt` 依赖清单

"使用Python FastAPI开发一个抽奖活动系统，包含以下功能模块：
1. 报名功能：
- 前端表单收集：姓名、联系方式、来源平台（微博/小红书/抖音等）、推文链接或截图地址
- 后端API接口：接收并存储报名数据
2. 管理后台：
- 查看所有报名者列表
- 随机抽取指定数量的中奖者
- 导出报名数据为CSV文件
3. API接口设计：
- 提交报名信息
- 获取报名列表
- 执行抽奖操作
- 获取中奖名单
4. 安全防护：
- 实现简易防刷机制：同一手机号或IP地址10分钟内只能提交1次（时间可配置）
- 数据库凭证通过.env文件管理，避免明文暴露
- 确保敏感配置只在服务端读取
5. 数据库配置：
- 使用MySQL数据库
- 连接参数包括主机、端口、用户名和密码
- 通过环境变量配置数据库连接信息
请使用FastAPI框架实现上述功能，确保代码结构清晰，包含必要的错误处理和日志记录。"

python -m pip install -r requirements.txt

uvicorn app.main:app --host 0.0.0.0 --port 8000

# 抽奖活动系统 (FastAPI + MySQL)
## 功能概述
- 报名提交：姓名、手机号、平台、链接/截图地址
- 管理后台API：列表、抽奖、导出CSV、查看中奖名单
- 简易防刷：同一手机号或IP在可配置时间窗内限制提交次数
- 配置通过 `.env` 管理，敏感变量仅在服务端读取
## 运行步骤
1. 准备 MySQL 数据库（建议 UTF8MB4）：
   - 创建数据库：`CREATE DATABASE lottery_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;`
2. 复制 `.env.example` 为 `.env` 并填入实际值。
3. 安装依赖：
   ```bash
   pip install -r requirements.txt
   ```
4. 启动服务：
   ```bash
   uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
   ```
   - 用户报名页：http://localhost:8000/index.html
   - 管理后台页：http://localhost:8000/admin.html
   - 管理接口需在请求头携带 `x-admin-token`
## API 设计
- POST `/api/participants` 提交报名
- GET `/api/participants` 报名列表
- POST `/api/admin/raffle` 执行抽奖（需 `x-admin-token`）
- GET `/api/admin/winners` 中奖名单（需 `x-admin-token`）
- GET `/api/admin/participants/export` 导出报名CSV（需 `x-admin-token`）
## 安全与防护
- 环境变量见 `.env.example`；生产中请确保 `.env` 不被提交或暴露
- 简易防刷使用内存存储，如需分布式部署，建议替换为 Redis
## 前端对接
- 可直接用任意前端表单 POST 至 `/api/participants`
- 管理端可用任意 HTTP 客户端携带 `x-admin-token` 访问