Skip to content

Latest commit

 

History

History
161 lines (129 loc) · 6.76 KB

README.md

File metadata and controls

161 lines (129 loc) · 6.76 KB
Raw

后台管理系统 vue-admin-spa（注意：本项目已停更，如有需要可以前往最新vue3.0版本，功能更多、更全 ）

使用到的技术栈：vue + vue-resource + vue-router + vuex(spa必备) + element-ui + ES6 + webpack + npm

测试地址 （如果无法打开，可尝试将 DNS 修改为 114.114.114.114 即可）

前言

本项目借鉴vue脚手架和三个项目（取长补短）搭建而成，并且不断完善，目的是为了更接近和适合大家的项目需求，更适合2次开发，以下几点重写过：

  • 登陆注册（含MD5加密）

  • 权限控制，菜单根据用户接口回来的权限数据进行显隐，手敲地址栏，会跳到404（地址栏错误）或401（地址栏正确但无权限），并可以在系统设置中动态修改权限

  • 切换主题，完全支持用户手动切换主题和记住主题

  • 全部数据进行本地json模拟，二次开发者，只需要把json路径替换成实际接口路径即可，即使是新手也能轻松搞定撸后台管理系统

  • 全部动态操作的按钮点击元素，都已经在控制台打印出相关参数，实际开发时把这些参数按需提交给后端接口即可

  • 新增了学生模块，使用的是本地真正api接口，

  • 新增了机构管理模块，使用的mockjs接口，附上真正开发的js逻辑（包含校验和提交接口等），实际开发时把真正逻辑代码恢复即可

说明

  • 开源目的：提供给基于底层的2次开发者，供更多人学习和参考，少走弯路。
  • 需求定制：这个项目作为底层框架开源，目前只具备了些基本功能，如有其他功能需求可联系群主。
  • 贡献加入：欢迎更多开发者加入这个底层开发，一起贡献和维护，详情联系群主。
  • 及时交流：为了方便大家技术交流,本项目新建了一个qq群--645582193

**有问题可以先提交到issue或者进群讨论

如果觉得此项目对你有所帮助，记得点击右上方的Star噢 ^_^

功能(部分数据进行本地json模拟，部分采用mockjs，由于豆瓣api近期封锁故使用豆瓣api部分功能暂时无法预览)

  • 系统说明
  • 登录/注销
  • 密码修改
  • 个人主页
  • 头像上传
  • 权限验证
  • 修改权限
  • 侧边栏
  • 面包屑
  • 富文本编辑器
  • 切换主题（点击头像下拉）
  • 表单校验、提交
  • 列表增删改查、排序、导出(后台管理系统基本功能)
  • 401，404重定向页面
  • 导出excel
  • views-tab
  • PC端更多功能即将开放……

开发

    # 克隆代码
    git clone https://github.com/lss5270/vue-admin-spa.git
    # 安装依赖
    npm install
    #or 直接解压node_modules.7z到当前位置 （比较适合新手）。

    # 本地开发 开启服务
    npm run dev
    #or 直接双击start.bat（比较适合新手）

浏览器访问 http://localhost:2018

发布

  
    # 构建生产环境
    npm run build:prod
    #or 直接双击build.bat（比较适合新手）

模拟运行正式环境

    # nginx环境下运行
    1.准备nginx环境，自行到nginx官网（https://nginx.org/）下载，并解压
    2.双击build.bat后根目录生成一个dist包，把dist整个文件夹拷贝到nginx解压后的html下
    3.启动nginx服务：双击nginx.exe
    4.访问入口：http://localhost/dist/index.html
    ………
    
    8.关闭nginx服务：直接删进程
    
    # tomcat环境下运行
    参照nginx步骤即可

关于图标

    本项目使用了两套图标系统，具体使用方法参照以下官方链接:
    1.http://element.eleme.io/#/zh-CN/component/icon
    2.http://fontawesome.io/icons/
    使用方法：
    a.在index.html中引入<link href="//cdn.bootcss.com/font-awesome/4.7.0/css/font-awesome.css" rel="stylesheet">
    b.在使用图标的地方放置图标<i class="fa fa-home" aria-hidden="true"></i>

关于UI系统

    由于bootstrap不支持mvvm已弃用，本项目使用了全新的elementUI系统，具体使用方法参照以下官方链接:
    1.http://element.eleme.io/#/zh-CN/component/installation

关于.vue文件中背景图片路径，打包到生产环境路径404的问题修复

    具体修复方法，参照Issues中的 #6问题

关于学生模块的api接口

    1.学生模块功能使用了本地api接口，若想正常运行，请下载另外一个node项目（https://github.com/lss5270/vue-admin-spa-api），并且在本地启动该node 项目。
    2.该node项目源码，相当于其他后端语言（例如java）提供增删查改接口的源代码。
    3.不懂如何使用node项目的同学，可进群讨论
    

目录结构

├── build                      // 构建相关  
├── config                     // 配置相关
├── src                        // 源代码
│   ├── assets                 // 主题 字体等静态资源
│   ├── components             // 全局公用组件。不直接显示
│   ├── global                 // 全局指令
│   ├── filtres                // 全局filter
│   ├── router                 // 路由
│   ├── store                  // 全局store管理
│   ├── utils                  // 全局公用方法
│   ├── view                   // view视图层
│   ├── App.vue                // 入口页面
│   └── main.js                // 入口 加载组件 初始化等
├── static                     // 第三方不打包资源
│   ├── jquery
│   ├── Tinymce                // 富文本
│   ├── dataJson               // 模拟接口json
│   └── theme                  // 主题文件
├── .babelrc                   // babel-loader 配置
├── eslintrc.js                // eslint 配置项
├── .gitignore                 // git 忽略项
├── favicon.ico                // favicon图标
├── index.html                 // html模板
└── package.json               // package.json

状态管理

目前只有用户信息、菜单权限、app配置相关状态使用vuex存储在全局，其它数据都由每个业务组件自己管理。

License

MIT

Copyright (c) 2017-present, LSS