CaiYouHui_backend

这是CaiYouHui的fastapi后端实现

1. 架构设计（三层架构）

┌─────────────────┐
│   API 路由层     │ ← 处理 HTTP 请求/响应
│   (api/v1/*.py) │
└────────┬────────┘
         │ 调用
┌────────▼────────┐
│   Service 层    │ ← 业务逻辑处理
│  (services/*.py)│
└────────┬────────┘
         │ 使用
┌────────▼────────┐
│   Core 工具层   │ ← 通用工具函数
│  (core/*.py)    │
└─────────────────┘

2. 完整的项目结构

app/
├── api/
│   └── v1/
│       ├── auth.py              # API路由层：只处理HTTP
│       └── users.py
├── services/                    # 服务层：业务逻辑
│   ├── auth_service.py          # 认证相关业务逻辑
│   ├── user_service.py          # 用户相关业务逻辑
│   └── __init__.py
├── core/                        # 核心层：通用工具
│   ├── auth.py                  # 认证工具函数
│   ├── security.py              # 安全工具函数
│   └── __init__.py
├── dependencies/                # 依赖注入
│   └── auth.py                  # 认证依赖
├── models/                      # 数据模型
│   └── user.py
└── schemas/                     # Pydantic模型
    └── user.py


3. 调用链总结

HTTP请求 → API路由层 → 服务层 → 核心工具层
   ↓           ↓          ↓          ↓
auth.py   → auth_service.py → core/auth.py
   ↓
返回HTTP响应