
cameo是一个开源项目(fastapi-admin/fastapiadmin/fastapi_admin),用于帮助开发者快速搭建fastapi项目,并且自带了一个admin应用(前后端分离,前端使用vue3的开源框架naive-ui-admin),参考django-admin设计,使用tortoise-orm作为数据库操作框架,支持mysql,sqlite,postgresql等多种数据库,实现RBAC权限管理模式,增删改查api自动生成。
前后端依赖安装
# 事先安装python3.13
# 克隆源码
git clone https://github.com/croonyy/cameo.git
# 进入到项目目录 cd cameo
# 安装python环境依赖,如果依赖下载慢,请自行更换pip镜像源
pip install -r requirements.txt
# 初始化数据库
aerich upgrade
#执行脚本,创建admin用户(密码可后续自行更改),和模型权限
python init_data.py
# 前端安装
# 进入到/front目录 cd front
pnpm install# 1、运行后端服务
# 如果是python虚拟环境,请先激活虚拟环境 conda activate [python_env_name]
# 进入到项目目录下,执行
python run.py
# 2、运行前端服务
# 进入到前端目录下 cd front
pnpm run dev
# 3、访问
# 浏览器访问后端接口文档
http://localhost:3014/udadmin/docs
# 浏览器访问前端页面
http://localhost:1992/
自动生成的模型增删改查接口

前端导航页

模型list页面

模型修改页面

模型list页面

模型修改页面

模型添加页面
├── apps # app目录,推荐一个app创建一个文件夹,可参考源码样例,也可自行组织app代码结构
├── app1 # 样例app
├── ...
├── udadmin # admin应用
├── ...
├── config
├── settings.py # 项目配置文件
├── db
├── db.sqlite3 # 默认数据库为sqlite3,此为数据库文件
├── init
├── front # 前端根目录
├── ...
├── migrations # 数据库迁移文件,如若更换数据库,需要重新生成
├── app1 # 一个app会生成一个文件夹
├── udadmin
├── notes # 笔记
├── ...
├── static # 静态文件
├── docs-ui # 为了swagger文档从本地加载,文件本地化
├── images # 项目展示图片
├── favicon.ico
├── test # 测试代码
├── ...
├── tools # 工具代码
├── locate_print.py
├── objdoc.py
├── timer.py
├── .gitignore
├── cert.pem
├── init_data.py # 初始化数据库的用户和权限的脚本
├── key.pem
├── main.py
├── pyproject.toml
├── README.en.md
├── README.md
├── requirements.txt # python环境依赖
├── run.py # 主入口,python run.py 启动项目
├── vscode_extensions.txt # vscode 插件原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。