basic-framework/README.md
2023-01-04 15:17:50 +08:00

105 lines
3.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## renren-ui
- renren-ui基于vue、element-ui构建开发实现 【[renren-security](https://gitee.com/renrenio/renren-security)】 后台管理前端功能,提供一套更优的前端解决方案
- 前后端分离通过token进行数据交互可独立部署
- 动态菜单,通过菜单管理统一管理访问路由
- 后端地址https://gitee.com/renrenio/renren-security
- 演示地址:[http://demo.open.renren.io/renren-security](http://demo.open.renren.io/renren-security) (账号密码admin/admin)
<br>
![输入图片说明](public/1.png)
## 安装
您需要提前在本地安装[Node.js](https://nodejs.org/en/)版本号为14.x再使用[Git](https://git-scm.com/)克隆项目或者直接下载项目后,然后通过`终端命令行`执行以下命令。
```bash
# 切换到项目根目录
# 安装插件
npm install
# 启动项目
npm run serve
```
> 如网络不稳定,安装时出错或进度过慢!请移步 [cnpm](https://npmmirror.com/) 淘宝镜像进行安装。
启动完成后,会自动打开浏览器访问 [http://localhost:8001](http://localhost:8001),如您看到下面的页面代表`前端项目`运行成功!因为前后端分离项目,需保证`前端项目`和`后台项目`分别独立正常运行。
请留意下面的页面,其中`验证码`未能正常显示,控制台有`API请求`报错信息!这时需检查`后台项目`是否正常运行。
## 技术栈
提前了解和学习这些知识会对使用本项目有很大的帮助。
* [Node.js](https://nodejs.org/)
* [ES6](http://es6.ruanyifeng.com/)
* [Vue-cli](https://github.com/vuejs/vue-cli)
* [Vue](https://cn.vuejs.org/)
* [Vue-router](https://router.vuejs.org/zh/)
* [Vuex](https://vuex.vuejs.org/zh/)
* [Vue-i18n](https://github.com/kazupon/vue-i18n)
* [Axios](https://github.com/axios/axios)
* [Element](https://element.eleme.cn/#/zh-CN)
* [JS-cookie](https://github.com/js-cookie/js-cookie)
## 目录结构
```
├── src
│ ├── assets // 静态资源
│ ├── components // 公共组件
│ ├── element-ui // element样式
│ ├── i18n // 国际化
│ ├── icons // 图标
│ ├── mixins // 混入
│ ├── router // 路由
│ ├── store // 状态管理
│ ├── utils // 工具类
│ ├── views // 业务相关
│ ├── App.vue
│ ├── main.js // 入口
├── ...
├── package-lock.json
├── package.json
└── vue.config.js // vue-cli脚手架配置
```
<br>
## 常见问题
如何修改API请求地址
* 修改`/src/pubilc/index.html`文件中`<!-- 开发环境 -->`注释下的`window.SITE_CONFIG['apiURL']`变量值。
```
<!-- 开发环境 -->
<% if (process.env.VUE_APP_NODE_ENV === 'dev') { %>
<script>
window.SITE_CONFIG['apiURL'] = 'http://localhost:8080/renren-admin';
</script>
<% } %>
```
<br>
## 如何交流、反馈、参与贡献?
- 开发文档https://www.renren.io/guide/security
- 官方社区https://www.renren.io/community
- Gitee仓库https://gitee.com/renrenio/renren-ui
- [人人开源](https://www.renren.io)https://www.renren.io
- 如需关注项目最新动态请Watch、Star项目同时也是对项目最好的支持
- 技术讨论、二次开发等咨询、问题和建议,请移步到官方社区,我会在第一时间进行解答和回复!
- 微信扫码并关注【人人开源】,获得项目最新动态及更新提醒<br>
<br>
## 微信交流群
我们提供了微信交流群,扫码下面的二维码,关注【人人开源】公众号,回复【加群】,即可根据提示加入微信群!
<br><br>
![输入图片说明](public/wechat.jpg)
<br>
<br>