# U-FastAPI-Admin

**Repository Path**: charmer21/u-fastapi-admin

## Basic Information

- **Project Name**: U-FastAPI-Admin
- **Description**: 基于FastAPI+Tortoise-orm的通用中后台管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-03-14
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

> 当前包含的功能如下：
> 1. 统一响应体格式：{"code": 200, "message": "", "data": None, "trace_id": ""}
> 2. 统一异常处理，所有异常
> 3. 增加trace_id全链路追踪

# 安装本项目
1、安装依赖
```
pip install -r requirements.txt
```

2、创建配置文件
```
cp -r .env.example .env
```

# 项目目录结构
```
project-root/
├── app/                       # 主应用目录
│   ├── core/                 # 核心基础组件
│   │   ├── config.py         # 配置文件（使用pydantic的BaseSettings）
│   │   ├── database.py       # Tortoise-ORM数据库配置
│   │   ├── security.py       # 安全相关（JWT/认证等）
│   │   └── middleware.py     # 自定义中间件
│   │
│   ├── routers/              # 路由入口
│   │   ├── admin.py          # 后台管理路由
│   │   ├── auth.py           # 认证相关路由
│   │   └── __init__.py
│   │
│   ├── models/               # Tortoise数据模型
│   │   ├── system/           # 系统模块模型
│   │   │   ├── user.py       # 用户模型
│   │   │   └── role.py       # 角色模型
│   │   └── __init__.py
│   │
│   ├── schemas/              # Pydantic模型（请求/响应模型）
│   ├── services/             # 业务逻辑层
│   ├── utils/                # 工具类库
│   ├── dependencies.py       # 依赖注入项
│   └── main.py               # 应用入口
│
├── tests/                    # 测试目录
├── static/                   # 静态文件
├── migrations/               # 数据库迁移目录（使用aerich）
├── requirements.txt          # 依赖列表
└── .env                      # 环境变量

```