# +======================================================================
# | 模块: 项目依赖清单
# | 说明: 基于 FastAPI 的 DjangoAdmin 企业数字化开发平台所需 Python 包
# +======================================================================

# ============================================================
# Web 框架核心
# ============================================================
fastapi==0.140.0          # FastAPI 核心框架
uvicorn==0.51.0           # ASGI 服务器
requests==2.34.2

# ============================================================
# 数据库与 ORM
# ============================================================
SQLAlchemy==2.0.51        # ORM 核心
alembic>=1.13.0           # 数据库迁移工具

# ============================================================
# 数据库驱动（DB_DRIVER 切换）
# ============================================================
PyMySQL==1.2.0            # MySQL 驱动
psycopg[binary]>=3.1      # PostgreSQL 驱动
pymssql>=2.3.0            # SQL Server 驱动
oracledb>=2.0             # Oracle 驱动

# ============================================================
# 缓存与消息队列
# ============================================================
redis==8.0.1              # Redis 客户端
hiredis==3.4.0            # Redis 高性能解析器

# ============================================================
# 认证与安全
# ============================================================
PyJWT==2.13.0             # JWT 令牌处理
bcrypt==4.3.0             # 密码加密
bleach==6.4.0             # HTML 清洗（防 XSS）
tinycss2==1.5.1           # CSS 解析（bleach 依赖）

# ============================================================
# 配置与数据处理
# ============================================================
python-dotenv==1.2.2      # 环境变量加载
pydantic==2.13.4          # 数据验证
python-multipart==0.0.32  # 文件上传解析

# ============================================================
# 文件与图片处理
# ============================================================
openpyxl==3.1.5           # Excel 读写
Pillow==12.3.0            # 图片处理（验证码生成）

# ============================================================
# 任务调度
# ============================================================
APScheduler==3.11.2       # 定时任务调度

# ============================================================
# 工具库
# ============================================================
py-ip2region==3.0.4       # IP 地理位置查询
pypinyin==0.55.0          # 中文转拼音（代码生成器）

# ============================================================
# 测试依赖
# ============================================================
pytest>=7.4               # 测试框架
pytest-asyncio>=0.23      # 异步测试支持
httpx>=0.27               # HTTP 客户端（测试）
aiosqlite>=0.19           # SQLite 异步驱动（测试）
fakeredis>=2.20           # Redis 模拟（测试）