# Frame-server

**Repository Path**: zhyhdm/frame-server

## Basic Information

- **Project Name**: Frame-server
- **Description**: 项目使用Python 3.8.0，Django4.2.2开发的管理后台服务端框架
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 0
- **Created**: 2023-06-27
- **Last Updated**: 2026-07-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 开发框架

## README

## frame-server服务端框架
* 前后端分离的模式，需配合frame-admin前端管理后台框架使用。
* 考虑到市面上Django前后端分离的管理后台框架少之又少，这才参考[Saber](https://gitee.com/smallc/Saber)接口功能使用Django开发服务端框架，与[frame-admin](https://gitee.com/abcdzy123/dance-admin)服务端框架配合使用，打造一套前后端分离的管理后台框架。

## 核心技术栈

| 技术栈                          | 版本       |
|--------------------------------|------------|
| Python                         | 3.8.0      |
| Django                         | 4.2.19     |
| MySQL                          | 8          |
| Minio                          | 7.2.7      |
| djangorestframework            | 3.15.2     |
| djangorestframework-simplejwt  | 5.3.1      |

## 前端项目

| 简介                 | 地址                                                                                 |
|----------------------|-------------------------------------------------------------------------------------|
| 前端框架frame-admin  | [https://gitee.com/abcdzy123/frame-admin](https://gitee.com/abcdzy123/frame-admin)   |

## 使用
* 1、安装Python 3.8
* 2、创建数据库
```sql
create database frame charset=utf8mb4;
```
* 3、导入基本数据
```cmd
# 安装依赖
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

# 生成sql脚本
python manage.py makemigrations

# 生成数据表
python manage.py migrate

# 导入基本数据
mysql -u用户名 -p frame < 基本数据.sql

# 运行服务
python manage.py runserver 0.0.0.0:8000
```

* 4、Windows平台启动minio服务
```cmd
# 设置后台账号
set MINIO_ROOT_USER=minioadmin

# 设置后台密码
set MINIO_ROOT_PASSWORD=minioadmin

# 启动服务（--console-address管理后台地址，--address接口地址）
.\minio.exe server ..\data --console-address "127.0.0.1:9000" --address "127.0.0.1:9001"
```

## Docker 部署

### 1、准备配置文件

Docker Compose 默认会读取当前目录下的 `.env`。

```powershell
cd \frame-server

# 首次部署可先从示例配置复制一份，再按实际环境修改。
Copy-Item .env.example .env
```
### 2、启动或重新部署

使用 `.env` 部署：

```powershell
cd \frame-server
docker compose up -d --build --force-recreate
```

### 3、首次导入基础数据

后端容器启动时会自动执行数据库迁移 `python manage.py migrate --noinput`。首次部署如果需要导入 `基本数据.sql`，可在容器启动并且 MySQL 健康后执行：

```powershell
Get-Content .\基本数据.sql -Raw | docker compose exec -T mysql sh -c 'mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" "$MYSQL_DATABASE"'
```

导入后可重启后端服务：

```powershell
docker compose up -d --force-recreate server
```

## 📄 开源协议

[MIT](http://opensource.org/licenses/MIT)

Copyright (c) 2023-present, 最后一行代码