{"id":22050078,"url":"https://github.com/zhangbinhub/acp-admin","last_synced_at":"2025-05-08T23:11:04.380Z","repository":{"id":43301840,"uuid":"161803334","full_name":"zhangbinhub/acp-admin","owner":"zhangbinhub","description":"使用vue全家桶(Vue+Vue-router+Vuex+axios)、ElementUI 样式库构建的前端项目。该项目是前后端分离架构中的“前端部分”","archived":false,"fork":false,"pushed_at":"2022-03-12T13:11:05.000Z","size":13058,"stargazers_count":27,"open_issues_count":0,"forks_count":15,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-31T19:12:21.664Z","etag":null,"topics":["axios","cropperjs","echarts","element-plus","nodejs","vue-cli3","vue-cli4","vue-router","vue3","vuex"],"latest_commit_sha":null,"homepage":"","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zhangbinhub.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-12-14T15:23:25.000Z","updated_at":"2025-01-06T07:21:20.000Z","dependencies_parsed_at":"2022-07-22T00:46:54.853Z","dependency_job_id":null,"html_url":"https://github.com/zhangbinhub/acp-admin","commit_stats":null,"previous_names":[],"tags_count":42,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhangbinhub%2Facp-admin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhangbinhub%2Facp-admin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhangbinhub%2Facp-admin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhangbinhub%2Facp-admin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zhangbinhub","download_url":"https://codeload.github.com/zhangbinhub/acp-admin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253160776,"owners_count":21863630,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["axios","cropperjs","echarts","element-plus","nodejs","vue-cli3","vue-cli4","vue-router","vue3","vuex"],"created_at":"2024-11-30T14:17:50.152Z","updated_at":"2025-05-08T23:11:04.363Z","avatar_url":"https://github.com/zhangbinhub.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# acp-admin\n\n**此工程已不再更新，由于某些不可抗因素，已转移至https://gitee.com/zhangbinhub/acp-admin**\n\n###### v5.1.3 [版本更新日志](doc/version_history.md)\n\n## 浏览器兼容性\n\n\u003e 由于js-base64 3.0及以上版本不再支持IE，因此从4.2.0开始不再支持IE\n\n支持的浏览器：\n\n- Chrome latest（推荐，完美）\n- Firefox latest（完全支持）\n- Edge（完全支持）\n\n## 简介\n\n使用vue全家桶(Vue+Vue-router+Vuex+axios)、ElementUI样式库构建的前端项目。该项目是前后端分离架构中的“前端部分”\n。[后端工程](https://github.com/zhangbinhub/acp-admin-cloud)\n\n## 相关组件官方文档\n\n- [Vue 3](https://v3.cn.vuejs.org/)\n- [Vue CLI 5](https://cli.vuejs.org/zh/)\n- [Element-plus](https://element-plus.gitee.io/#/zh-CN)\n- [echarts](https://www.echartsjs.com/index.html)\n- [cropperJs](https://github.com/fengyuanchen/cropperjs)\n\n## 技术栈\n\n- webpack 5\n- nodejs\n- vue3\n- vue cli 5\n- vuex\n- vue-router\n- axios\n- echarts\n- cropperJs\n- mockjs\n- js-sha256\n- js-base64\n- vue-json-editor\n- Element-plus\n\n## 总体架构\n\n![Architecture diagram](doc/images/总体架构.jpg)\n\n#### 说明\n\n- 前后端交互 HttpStatus Code 说明\n\n| HttpStatus | 描述          |\n|------------|-------------|\n| 200        | 请求成功        |\n| 201        | 资源创建成功      |\n| 400        | 业务错误        |\n| 401        | token（登录）失效 |\n| 403        | 权限不足        |\n| 404        | 找不到资源       |\n| 500        | 系统异常        |\n\n## 部署运行\n\n该工程默认运行于 nodejs 中，也可根据实际需要运行在其他 web 容器\n\n## 一、环境搭建\n\n##### （一）安装 [node.js](http://nodejs.cn)，并验证\n\n``` bash\nnode -v\n```\n\n##### （二）设置淘宝 npm 镜像\n\n```bash\nnpm config set registry https://registry.npm.taobao.org\n```\n\n##### （三）安装升级插件\n\n```bash\nnpm install -g npm-check-updates\n```\n\n## 二、依赖插件\n\n##### （一）安装\n\n``` bash\nnpm install\n```\n\n##### （二）更新\n\n``` bash\nncu -u\nnpm install\n```\n\n## 三、开发\n\n##### （一）国际化\n\n- 语言包路径：src/lang\n- 在语言包路径下新增或修改语言属性\n- 在 src/lang/index.js 中加载新的语言包\n\n##### （二）mock\n\n- 如果要使用 mock，在 src/main.js 中加入 import './mock' 即可\n- src/mock 中添加或修改 mock 信息\n- src/mock/index.js 中引入，并配置相应的 url 拦截策略\n\n##### （三）配置文件\n\n1、全局工程配置文件\n\n[vue.config.js](vue.config.js)\n\n[配置参考](https://cli.vuejs.org/zh/config/#css-loaderoptions)\n\n2、项目配置文件\n\n- 持久化组件：vuex\n- 路径：src/store\n- 入口：[src/store/index.js](src/store/index.js)\n- 系统信息配置文件：[src/store/config/appInfo.js](src/store/config/appInfo.js)\n\n##### （四）静态资源\n\n- 路径：src/assets\n\n##### （五）Router\n\n- 组件：vue-router\n- 路径：src/router\n- 入口：[src/router/index.js](src/router/index.js)\n- 路由配置及说明：[src/router/routers.js](src/router/routers.js)\n\n##### （六）http 请求\n\n- 组件：axios、vue-axios\n- 入口及全局配置：[src/plugins/plugin-axios.js](src/plugins/axios/plugin-axios.js)\n- 请求 api\n- 路径：src/api\n- 入口：[src/api/index.js](src/api/index.js)\n- api 编写：新增或修改文件，在[src/api/ApiLists.js](src/api/ApiLists.js)中引入并配置\n\n##### （七）页面布局\n\n- 独立页面路径：src/components/pages\n- 布局框架：src/components/layout\n- 框架内页面：src/components/views\n- 测试页面：src/components/test\n- src/components 下其他路径存放自定义组件\n\n## 四、部署\n\n##### （一）编译打包\n\n- 工程根目录下运行\n\n```\nnpm run build\n```\n\n- 执行成功后工程根目录下会出现dist文件夹，将dist文件夹中的所有文件复制到nginx的html下即可\n- 如果部署在nginx里html的根目录，访问url为 http://nginxHost:port\n- 如果部署在nginx里html的子目录（如platform/admin），访问url为 http://nginxHost:port/platform/admin\n\n##### （二）nginx配置\n\n假如工程部署在nginx中，需要修改nginx.conf，增加后端接口的反向代理\n\n- 代理后端 gateway\n\n```\nlocation ~ ^.*/v1/api/(.*)$ {\n  set $delimeter \"\";\n  if ( $args != \"\" ) {\n    set $delimeter \"?\";\n  }\n  proxy_pass http://host:port/$1${delimeter}$args;\n  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n  proxy_read_timeout 3600s;\n}\n```\n\n## 五、界面展示\n\n- 登录\n  ![images](doc/images/pages/login.png)\n- 首页\n  ![images](doc/images/pages/index.png)\n- 个人信息\n  ![images](doc/images/pages/userinfo.png)\n- 头像裁剪\n  ![images](doc/images/pages/avatar.png)\n- 应用配置\n  ![images](doc/images/pages/appconfig.png)\n  ![images](doc/images/pages/appedit.png)\n  ![images](doc/images/pages/appupdate.png)\n- 菜单配置\n  ![images](doc/images/pages/menu.png)\n- 模块功能配置\n  ![images](doc/images/pages/module.png)\n- 机构配置\n  ![images](doc/images/pages/org.png)\n- 角色配置\n  ![images](doc/images/pages/role.png)\n- 运行参数配置\n  ![images](doc/images/pages/runtime.png)\n  ![images](doc/images/pages/runtimeedit.png)\n- 用户配置\n  ![images](doc/images/pages/userlist.png)\n- 用户编辑\n  ![images](doc/images/pages/useredit.png)\n- 404页面\n  ![images](doc/images/pages/404.png)\n- 500页面\n  ![images](doc/images/pages/500.png)\n- 后台日志文件查询、下载\n  ![images](doc/images/pages/logfile.png)\n- 路由配置\n  ![images](doc/images/pages/route.png)\n  ![images](doc/images/pages/routeEdit.png)\n  ![images](doc/images/pages/routeRefresh.png)\n- 路由日志\n  ![images](doc/images/pages/routeLog.png)\n- 操作日志\n  ![images](doc/images/pages/operateLog.png)\n- 登录日志\n  ![images](doc/images/pages/loginLog.png)\n- demo\n    - 文件上传\n      ![images](doc/images/pages/upload.png)\n\n### Customize configuration\n\nSee [Configuration Reference](https://cli.vuejs.org/config/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhangbinhub%2Facp-admin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzhangbinhub%2Facp-admin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhangbinhub%2Facp-admin/lists"}