mall-admin 是一个基于 vue3-element-admin 升级的 Vue3 版本的商城管理前端工程。它采用了主流的前端技术栈包括 Vue3、Vite3、TypeScript、Vue Router、Pinia、Volar 和 Element Plus 等,以实现一套完整的商城管理系统。

1. 项目优势

简单易上手

mall-admin 基于 vue-element-admin 进行升级,对于已经熟悉该框架的开发者来说,极易上手并降低了学习成本。

实际接口支持

与许多其他前端工程不同的是,mall-admin 提供了完整适配的微服务权限系统线上接口,这意味着它可以直接应用于真实的企业级前后端接入场景,而非仅仅使用 Mock 数据。

功能全面

mall-admin 提供了丰富的功能,包括国际化、动态路由、按钮权限控制、主题大小切换、Echarts 图表和 wangEditor 富文本编辑器等。

完善的 TypeScript 支持

mall-admin 对 TypeScript 的支持非常全面,无论是组件还是 API 调用层面,都提供了完整的 TypeScript 类型支持。

主流 Vue3 生态和前端技术栈

mall-admin 借助 Vue3 生态和常用前端技术栈,对一些常用组件进行了简洁封装,使开发更加高效。

全面的项目文档支持

如果你是从零开始使用该项目,mall-admin 提供了全面的项目文档支持,帮助你快速上手并了解项目的各项功能和配置。

全栈技术支持

除了提供微服务接口和 Vue3 管理前端,mall-admin 还支持 uni-app 移动端和 K8S 持续集成交付等全栈技术应用。

2. 技术栈

  • Vue3:渐进式 JavaScript 框架。
  • TypeScript:JavaScript 的一个超集,提供了静态类型检查以增强代码的可读性和可维护性。
  • Vite:快速的前端开发与构建工具,提供了快速的冷启动、热模块替换和按需编译等特性。
  • Element Plus:基于 Vue 3 的组件库,为开发者和设计师提供了丰富的 UI 组件。
  • Pinia:新一代的状态管理工具,提供了更好的类型推导和开发体验。
  • Vue Router:Vue.js 的官方路由管理器,用于实现前端路由功能。

3. 环境准备

在开始使用 mall-admin 之前,需要进行一些环境准备。

安装 Node.js

请确保你已经安装了 Node.js,并且版本在 16+。

开发工具

推荐使用 VSCode 作为开发工具,并安装以下必要插件:

  • Vue Language Features (Volar):提供 Vue 语言支持。
  • TypeScript Vue Plugin (Volar):提供 TypeScript 支持。

4. 项目启动

在开始开发之前,有两种情况需要注意:

  • 如果后端接口尚未启动或者本地没有部署后端接口,需要修改 vite.config.ts 文件中的代理地址为 http://localhost:9999,以便与后端进行通信。
  • 在开始前,请先执行 npm install 命令,安装所需的依赖。

启动项目的命令如下:

npm run dev

5. 项目部署

在完成开发并进行测试之后,你可能希望将 mall-admin 部署到生产环境中。下面是一些关于项目部署的指南。

本地打包

首先,你需要执行以下命令对项目进行打包:

npm run build:prod

该命令会生成一个名为 dist 的文件夹,其中包含了所有打包后的静态文件。

Nginx 配置

接下来,我们需要配置 Nginx 以便将静态文件正确地提供给客户端。假设你已经安装好了 Nginx,并拥有一个服务器配置文件(通常是位于 /etc/nginx/nginx.conf 或 /etc/nginx/sites-available 目录下)。

请将以下代码添加到你的 Nginx 服务器配置文件中,用于配置代理和路由转发:

server {
    listen 80;
    server_name localhost;

    location / {
        root /usr/share/nginx/html/web;
        index index.html index.htm;
    }

    # 代理转发请求至网关,prod-api标识解决跨域问题
    location /prod-api/ {
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_pass https://api.youlai.tech/;
    }
}

请根据你的实际情况修改 listen、server_name 和 root 等配置项。

启动 Nginx

完成配置后,使用以下命令启动 Nginx 服务:

sudo service nginx start

访问项目

现在,你可以通过浏览器访问以下地址来查看部署后的 mall-admin 项目:

http://localhost:9527

请确保该地址与你在 Nginx 配置文件中设置的 server_name 一致。

结语

通过本文,我们介绍了 mall-admin 商城管理前端工程的特点、技术栈以及环境准备和部署过程。希望这篇文章对你理解和使用 mall-admin 有所帮助。如果你对该项目有更多的疑问或需求,请参考官方文档或咨询开发者。祝你在商城管理前端开发中取得成功!