# wallpaper-admin-web

**Repository Path**: theOS/wallpaper-admin-web

## Basic Information

- **Project Name**: wallpaper-admin-web
- **Description**: 前后端分离的壁纸摄影图库项目-后台管理端
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 3
- **Created**: 2021-03-05
- **Last Updated**: 2023-11-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# wallpaper-admin-web
<p>
  <a href="https://gitee.com/theOS/wallpaper-swarm"><img src="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-d312c7f9-984b-40d2-a02e-6ef169da1d29/4fb8d7b5-6d3b-4df9-ac39-07bd467a3412.svg" alt="后台项目"></a>
  <a href="https://gitee.com/theOS/wallpaper-admin-web"><img src="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-d312c7f9-984b-40d2-a02e-6ef169da1d29/0778dac7-70a2-4437-aaef-f88540a33cc3.svg" alt="管理端前台"></a>
  <a href="https://gitee.com/theOS/wallpaper-uniapp-wx"><img src="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-d312c7f9-984b-40d2-a02e-6ef169da1d29/11d2af06-ce1f-4ce3-b694-b00234f55094.svg" alt="uni-app用户端"></a>
  <a href="https://theos.gitee.io/"><img src="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-d312c7f9-984b-40d2-a02e-6ef169da1d29/0f2f32ac-c0c6-4075-97f1-ff1ab60b02b7.svg" alt="文档地址"></a>
</p>


## 前言

该项目为前后端分离项目的管理端前端部分，后端项目`wallpaper-swarm`地址：[传送门](https://gitee.com/theOS/wallpaper-swarm)。

用户端微信小程序，基于uni-app：[传送门](https://gitee.com/theOS/wallpaper-uniapp-wx)

## 项目介绍

`wallpaper-admin-web`是wallpaper-swarm系统的管理端前端项目，基于Vue+Element实现。主要包括专辑管理、图片管理、排行置顶、轮播图管理、权限管理、设置等功能。

![后台管理系统功能演示](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-d312c7f9-984b-40d2-a02e-6ef169da1d29/137e7077-35c0-4b2e-b776-dae853b1daf4.png)

### 技术选型

技术 | 说明 | 官网
----|----|----
Vue | 前端框架 | [https://vuejs.org/](https://vuejs.org/)
Vue-router | 路由框架 | [https://router.vuejs.org/](https://router.vuejs.org/)
Vuex | 全局状态管理框架 | [https://vuex.vuejs.org/](https://vuex.vuejs.org/)
Element | 前端UI框架 | [https://element.eleme.io/](https://element.eleme.io/)
Axios | 前端HTTP框架 | [https://github.com/axios/axios](https://github.com/axios/axios)
v-charts | 基于Echarts的图表框架 | [https://v-charts.js.org/](https://v-charts.js.org/)
Js-cookie | cookie管理工具 | [https://github.com/js-cookie/js-cookie](https://github.com/js-cookie/js-cookie)
nprogress | 进度条控件 | [https://github.com/rstacruz/nprogress](https://github.com/rstacruz/nprogress)
vue-element-admin | 项目脚手架参考 | [https://github.com/PanJiaChen/vue-element-admin](https://github.com/PanJiaChen/vue-element-admin)

### 项目布局

``` lua
src -- 源码目录
├── api -- axios网络请求定义
├── assets -- 静态图片资源文件
├── components -- 通用组件封装
├── icons -- svg矢量图片文件
├── router -- vue-router路由配置
├── store -- vuex的状态管理
├── styles -- 全局css样式
├── utils -- 工具类
└── views -- 前端页面
    ├── home -- 首页
    ├── layout -- 通用页面加载框架
    ├── login -- 登录页
    ├── album -- 专辑模块页面
    ├── tags -- 标签模块页面
    └── cms -- 内容模块页面
```

## 搭建步骤
- 下载node并安装：[https://nodejs.org/dist/v12.14.0/node-v12.14.0-x64.msi](https://nodejs.org/dist/v12.14.0/node-v12.14.0-x64.msi);

- 该项目为前后端分离项目，访问本地访问接口需搭建后台环境，搭建请参考后端项目[传送门](https://gitee.com/theOS/wallpaper-swarm);

- 所有接口都需要通过网关访问，需要将`config/dev.env.js`文件中的`BASE_API`改为[http://localhost:8201/service-service](http://localhost:8201/service-service)；

- 克隆源代码到本地，使用vscode打开，并完成编译;

- 在vscode命令行中运行命令：npm install,下载相关依赖;

- 在vscode命令行中运行命令：npm run dev,运行项目;

- 访问地址：[http://localhost:8090](http://localhost:8090) 即可打开后台管理系统页面;

- 具体部署过程请参考：[wallpaper前端项目的安装与部署](https://theos.gitee.io/#/deploy/wallpaper_deploy_web)

- `注意`：如果遇到无法运行npm命令，需要配置npm的环境变量，如在path变量中添加：C:\Users\zhaiqinglong\AppData\Roaming\npm

## 一些问题

### node-sass无法下载导致构建失败

由于node-sass的源使用的是Github上面的，经常无法访问，我们构建的时候需要单独设置node-sass的下载地址。

```bash
# linux
SASS_BINARY_SITE=https://npm.taobao.org/mirrors/node-sass/ npm install node-sass
# window
set SASS_BINARY_SITE=https://npm.taobao.org/mirrors/node-sass&& npm install node-sass
```

### 有些依赖无法下载导致构建失败

由于npm源访问慢的问题，有些源可能会无法下载，改用淘宝的npm源即可解决。

```bash
# 设置为淘宝的镜像源
npm config set registry https://registry.npm.taobao.org
# 设置为官方镜像源
npm config set registry https://registry.npmjs.org
```


## 许可证

[Apache License 2.0](https://github.com/macrozheng/mall-admin-web/blob/master/LICENSE)

Copyright (c) 2018-2021 theOS