Skip to content
On this page

安装依赖环境

shell
pip install -r requirements.txt

初始化数据库

shell
aerich init-db

生成迁移文件

shell
aerich migrate

数据库迁移迁移

shell
aerich upgrade

项目开发说明

项目目录结构说明

shell
|____apps  # 项目应用目录
| |____test
| | |______init__.py
| | |____models.py # 数据库模型
| | |____schemas.py # 数据库模型序列化
| | |____views.py # 视图函数
|____common # 项目公共目录
|____config # 项目配置目录
|____files # 项目文件目录
| |____.keep # 项目文件目录占位文件
|____migration # 数据库迁移目录
| |____.keep # 数据库迁移目录占位文件
|____project # 项目服务目录
| |______init__.py
| |____server.py # 项目启动文件
|____statics # 项目静态文件目录
| |____.keep # 项目静态文件目录占位文件
|____.env.example # 项目配置示例文件
|____.gitignore # git忽略文件
|____app.py # 项目运行文件
|____pyproject.toml # 项目数据库文件
|____readme.md # 项目说明文件
|____requirements.txt # 项目依赖文件

项目运行说明

运行时项目会自动发现apps目录下的应用,然后自动注册模型与视图方法,所以只需要在apps目录下创建应用即可,不需要在project目录下注册应用。
其中模型不限制文件,但是推荐编写在models.py文件中,视图函数限制文件,需要编写在views.py文件中,每个视图函数需要编写一个装饰器,装饰器的参数为路由地址,如下所示:

python
from project.server import app_router


@app_router.get("/test")
async def test():
    return {"msg": "test"}

系统管理支持

本项目模板提供基本系统管理功能
开启该功能需要设置SYSTEM_SYSTEM_ALLOW为True,并迁移数据库
开启该功能后可以使用创建超级用户功能

创建超级用户

设置SYSTEM_SYSTEM_ALLOW为True,并迁移数据库,然后运行如下命令创建超级用户

shell
python app.py createsuperuser

智加文档规范