python-admin-vben/
├── apps/                               # 业务应用核心
│   ├── generator/                      # 简陋的model代码生成器模块
│   ├── modules/                        # 业务模块集合
│   │   ├── sys/                        # 系统基础模块
│   │   │   ├── basis/                  # 系统基础功能
│   │   │   │   ├── crud/               # CURD 操作封装
│   │   │   │   ├── models/             # 数据库模型定义
│   │   │   │   ├── params/             # 请求参数校验模型
│   │   │   │   ├── routers/            # 接口路由定义
│   │   │   │   │   └── __init__.py     # 当前接口路由定义导入
│   │   │   │   ├── schemas/            # 数据传输模型
│   │   │   ├── monitor/                # 系统监控模块
│   │   │   ├── scheduler/              # 定时任务模块
│   │   └── [其他业务模块]/               # 自定义业务模块（如订单/商品等）
│   └── app_router.py                   # 应用模块路由总入口
├── config/                             # 配置中心
│   ├── .env                            # 环境变量配置
│   ├── .env.dev                        # 开发环境变量配置
│   ├── .env.docker                     # docker环境变量配置
│   ├── .env.prod                       # 生产环境变量配置
│   └── settings.py                     # 系统配置
├── core/                               # 核心框架
│   ├── common/                         # 通用业务逻辑
│   ├── constants/                      # 全局常量
│   ├── framework/                      # 框架扩展（中间件、认证等）
│   ├── utils/                          # 工具函数库
├── lib/                                # 第三方依赖库
├── docker/                             # docker部署
│   ├── Dockerfile                      # 项目服务构建
│   ├── docker-compose.yml              # docker-compose 部署编排
│   ├── script.sh                       # 部署以及操作命令脚本
├── main.py                             # 项目启动入口
└── requirements.txt                    # Python 依赖声明
 

- 进入项目根目录
- 创建虚拟环境 python3 -m venv .venv
- 激活虚拟环境 source .venv/bin/activate
- 安装依赖 pip3 install -r requirements.txt
 
- 如果安装依赖提示 WARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager, possibly rendering your system unusable. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv. Use the --root-user-action option if you know what you are doing and want to suppress this warning
- 可以使用虚拟环境下的pip进行安装 ./.venv/bin/pip install -r requirements.txt，或者不使用root用户改用普通用户进行安装
 

[Unit]
Description=fastapi service
After=network.target
 
[Service]
Type=simple
WorkingDirectory=/home/project/python-admin-vben
# 生产环境关键配置
Environment="ENV_FILE=prod"
 
ExecStart=/home/project/python-admin-vben/.venv/bin/python main.py
 
Restart=always
 
RestartSec=5
KillSignal=SIGINT
SyslogIdentifier=fastapi-identifier
User=root
 
[Install]
WantedBy=multi-user.target
 

systemctl daemon-reload
systemctl start fastapi
systemctl status fastapi