buff/backend

游铛铛后端API

技术栈

• 框架：FastAPI
• 数据库：MySQL 8.0
• ORM：SQLAlchemy
• 加密：cryptography (RSA)
• 文档：Swagger/OpenAPI

项目结构

backend/
├── app/
│   ├── __init__.py
│   ├── main.py              # 应用入口
│   ├── config.py            # 配置管理
│   ├── database.py          # 数据库连接
│   ├── models/              # 数据模型
│   │   ├── __init__.py
│   │   ├── user.py
│   │   ├── card.py
│   │   ├── software.py
│   │   └── ...
│   ├── schemas/             # Pydantic模型
│   │   ├── __init__.py
│   │   ├── user.py
│   │   └── ...
│   ├── api/                 # API路由
│   │   ├── __init__.py
│   │   ├── deps.py          # 依赖注入
│   │   ├── client/          # 客户端接口
│   │   │   ├── __init__.py
│   │   │   ├── auth.py
│   │   │   └── ...
│   │   └── admin/           # 管理端接口
│   │       ├── __init__.py
│   │       ├── auth.py
│   │       └── ...
│   ├── core/                # 核心功能
│   │   ├── __init__.py
│   │   ├── security.py      # 安全相关
│   │   ├── encrypt.py       # 加密工具
│   │   └── logger.py        # 日志
│   └── utils/               # 工具函数
│       ├── __init__.py
│       └── ...
├── requirements.txt
├── .env.example
└── README.md

安装依赖

pip install -r requirements.txt

配置

复制 .env.example 为 .env 并配置数据库连接信息。

运行

# 开发模式
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

# 生产模式
uvicorn app.main:app --host 0.0.0.0 --port 8000 --workers 4

API文档

启动服务后访问：

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc