sum-admin食用指南

食用方法

1、下载配置包

从百度云或者GitHub或者码云上面将全部代码下载下来，

0、python环境准备

• python3（最好3.6.5）
• pycharm（建议的工具）

1、进入项目后端目录

cd sun_admin

2、下载依赖

pip install -r requirement.txt

3、配置数据库（这里我用的pycharm原生数据库）

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}

4、构建项目，建表

python3 manege.py makemigrations
python3 manege.py migrate

5、运行项目

python3 manage.py runserver

6、至此集成管理系统配置完成，有以下要点注意

• 登录函数可以将密码在前端或者后端加密
• 前端页面可以集成到管理系统，详细参考前端配置

2、配置自己的项目

• 打开自己的项目，将xadmin拷贝到项目根目录下

• 关闭CSRF验证属性（后面会给其他验证方法）

• 再setting.py中注册xadmin及其相关组件

  INSTALLED_APPS = [
  	...(其他的注册组件)
      'xadmin.apps.XadminConfig',
      'rest_framework',
      'corsheaders',
      'django_filters',
  ]

• 在每一个APP下面新建一个xadmin.py，引入相关APP类似于admin注册组件一样注册自己的model表（在这里以学生表为列）

  from xadmin.service import xadmin
  from .models import Student，Lab
  
  class StudentConf(xadmin.ModelXadmin):
  	# 主页展示字段，可以自定义函数
      list_display = ["student_number", "name", "stu_class", "state", 'time']
  
  xadmin.site.register(Student, StudentConf)
  
  
  class LabConf(xadmin.ModelXadmin):
      # 自定义函数时会传入一个当前项目obj，名称是is_header显示
      def lab_title(self, obj=None, is_header=False):
          if is_header:
              return "实验报告"
          return obj.get_lab_display()
  
      list_display = ["id", lab_title, "student", "time", "score", "teacher", "state"]
  
  xadmin.site.register(Lab, LabConf)

• 注册路由

  from xadmin.service import xadmin
  
  urlpatterns = [
      ......
      url(r'^admin/', admin.site.urls),
      url(r'^xadmin/', xadmin.site.urls),
  	......
  ]

3、配置前端

• 前端需求

  • Vue3.0
  • node.js
  • npm

• 进入前端项目根目录

cd django-Admin

• 下载依赖项（可进入package.json中查看各个插件版本）

npm install

• 运行项目

npm run dev

• 然后访问http://localhost:8080，或自动跳转至登录页面。登录成功后跳转到index页面，账号密码自己在后台管理系统中设置即可

4、统一环境

用户可以根据自己的需求完善代码，代码完善后通过

npm run build

来生成产品化的页面，然后集成到django项目之中即可。