MagicShop.Net商城系统电脑桌面端文档

创建人:何兴淘 Tel:17338622299 543405234@qq.com

创建时间:2024-09-01 00:45:04 更新时间:2024-09-01 01:10:05

1、源代码和开发工具

1、架构说明

商城pc端主要考虑SEO优化,采用服务端渲染。 nuxt 是一个vue 生态里面非常棒的服务端渲染框架.

商城支持多语言

1.1、使用到技术如下

nuxt 版本3.0.0

vue 版本:3.2

vue-i18n 版本:9.2.2 多语言切换

naive-ui: pc 端UI 框架

@pinia/nuxt:^0.4.3 状态管理

为主要技术

nuxt 学习地址:https://nuxt.com

注意点,pc 端项目由于采用的yarn 来增加和管理npm包 因为需要使用npm 安装yarn

npm i -g yarn

1.2、项目运行方式

  1. 从SVN仓库clone项目代码

  2. 执行yarn 还原npm 包

  3. 执行yarn dev 运行项目

  4. 执行yarn build 打包项目

1.3、目录说明

  1. assets 放置样式 比如css sass

  2. components 放置组件 放置一些公用组件、

  3. composables 放置一些可组合的 公用的方法 目前放置了服务(service)

  4. consts 定义放置常量

  5. enum 放置枚举

  6. env 放置环境变量,开发环境 和生产环境 服务地址 分开放置

  7. layouts 布局模板,比如商城的顶部和尾部,

  8. locales 放置多语言文件 比如英文 中文

  9. middleware 放置中间件,可以处理用户的权限和做些全局的处理

  10. model 模型, 对应后台的模型

  11. pages 页面, 商城的页面

  12. plugins 插件,放置一些多语言,项目启动的一些处理,

  13. public 公开的,放置写公开的,比如图片,js 不需要参与编译的

  14. store 状态管理,放置页面一些数据的状态,让其他页面共享

  15. utils 帮助类, 目前主要放置了 http 请求帮助类

  16. app.vue 跟组件

  17. nuxt.config nuxt 相关配置

2、文件结构

通过SVN及GIT仓库下拉代码后,可以看到如下代码结构:

3、IIS下部署文档

由于PC 端采用的是服务端和客户端混合渲染模式,因此启动服务,需要使用node 启动,IIS 做反向代理 (或者nginx) ,使用PM2 做进程管理

3.1、步骤流程

1、windows服务器先安装node。

2、复制文件到服务器新建文件夹,并使用node尝试跑起来。没问题的情况下,关闭node测试运行项目。

3、使用node安装pm2,使用pm2将项目跑起来,并常驻后台。

4、iis内新建站点指向到文件夹,并使用url转发进行反向代理到pm2跑起来的站点。

 

3.2、服务器需要安装

1.Application Request Routing 作为 反向代理 下载地址 https://www.iis.net/downloads/microsoft/application-request-routing

2.下载nodejs 推荐版本为16.14.0 http://nodejs.cn/download 使用node -v 查询版本

3. 安装PM2 用管理员启动cmd,或者powerShell 全局安装pm2

npm i pm2 -g 使用pm2 -v 查看版本 img

4.设置pm2 自启动 (当服务器故障 或者重新启动的时候,pm2 服务自动重启) npm install pm2-windows-startup -g

5.设置pm2 开机自启动 pm2-startup install

6.进入项目根目录 开发环境 需要安装 按照步骤2 安装node 环境

3.3、项目使用yarn 来管理npm 包

1安装 npm i -g yarn

使用 yarn -v 查看版本 img

2.使用yarn 来还原npm 包

进入项目根目录 执行 yarn 这个命令还原包 img 3.使用yarn build 构建pc 生产版本 img 打包成功如下图 img

在根目录下 打开命令窗口 执行 node .output/server/index.mjs 可以使用node 启动 查看打包后的项目

img

7.进入项目.output 目录,将目录下所以内容 拷贝服务器上某个目录,作为部署的目录 (可以在跟目录下执行,node ./server/index.mjs 启动服务) img

9.将项目跟目录下 ecosystem.config.js 复制到服务器部署目录的根目录 如上图

3.4、根目录执行 pm2 start

如果需要指定端口号启动,则需要修改ecosystem.config.js文件 env 环境变量 PORT,HOST

img

  1. 使用pm2 list 查询部署

img

 

  1. 可以使用pm2 info 0 (0 是进程Id) 查询部署情况 和内存使用、

img

3.如果项目启动失败,则安装上图 查看error log path 查看部署异常 4使用 http://localhost:3000/login 查询是否部署成功

3.5、服务器使用iis 做反向代理

1.安装 Application Request Routing 作为 反向代理 下载地址 https://www.iis.net/downloads/microsoft/application-request-routing

  1. 启用iis 反向代理

img

3.双击 Application Request Routing img

4点击右边Proxy servce Proxy setting 勾上 Enable img

5.在iis 管理新增网站

img

6部署物理路径 选择 服务器上部署pc 端文件夹 参考 步骤 7 img

确认服务器是否含有路由重写模块,如果没有则需要按照路由重新模块

https://www.iis.net/downloads/microsoft/application-request-routing

7.选择刚刚创建的网站 双击URL 重写 img

8添加规则 选择反向代理 img

9.填写本地需要代理的地址 img

10.完整参考如下图

点开条件 添加逻辑分组

模式为:正则表达式,^中间为h5的域名$

img

4、vscode 进行PC开发

4.1、VSCode 简介

VSCode 全称 Visual Studio Code,是微软出的一款轻量级代码编辑器,免费、开源,插件丰富、而且功能强大。它支持几乎所有主流的程序语言的语法高亮、智能代码补全、自定义热键、括号匹配、代码片段、代码对比 Diff、GIT 等特性,支持插件扩展,并针对网页开发和云端应用开发做了优化。软件跨平台支持 Win、Mac 以及 Linux。

项目存放的文件夹目录不能含有中文,否则项目运行将会报错

PC端商城端口是3000 ,H5端端商城是3001,项目运行起来之前,先把api 服务中的appsetting.json 添加 http://localhost:3000(http://localhost:3001/)运行跨域 如果后端API 项目部署部署https。 切记 将env 文件夹下面的env.dev env.pro 环境变量地址写为https

下载地址 https://code.visualstudio.com/download img

4.2、PC端 商城介绍

由于项目采用的vue 生态中的nuxt 框架 ,是进行服务端渲染,可以做SEO优化

nuxt3 学习地址 官方地址:https://nuxt.com/blog/v3 中文地址:https://nuxt.com.cn/ vue3 的学习地址 https://cn.vuejs.org/guide/quick-start.html#try-vue-online UI 组件 native-ui https://www.naiveui.com/zh-CN/os-theme native-ui 偏向PC端交互,pc 端商城用的是 native-ui ,pc端商城的UI库只有 native-ui

typescript 1.是一种开发时类型约束,跟C# 一样是强类型的,避免一个类型走天下,可以在开发阶段避免很多问题2.强类型好处,可以很确定的看出字段类型,接口返回的模型,,智能提示

官网地址 https://www.typescriptlang.org/ 中文地址:https://nodejs.cn/typescript/

4.3、PC端 开发环境准备

1:安装node 版本 安装地址 https://nodejs.org/download/release/v16.14.0/ img

根据自己的32位还是64位 进行安装对应的版本 安装好后 执行 node -v 查看版本 入下图 说明node 安装成功 2由于项目是用yarn 来管理npm 包,切记使用npm 来管理 npm 包 大家可以自行了解下 yarn 跟 npm 的区别 安装yarn 执行 如下命令

安装成功 执行 yarn -v 查看版本 则说明安装成功 img 3.克隆项目成功后,进入项目根目录 如下图, 执行yarn install 切记一定要执行yarn install img

如图 正在还原npm 包, img

3由于网络关系,如果某个npm 包还原失败后,重新执行yarn install 直到所有的npm 包还原成功,还原成功后,将会出现 node_modules img 4项目还原成功后,使用vscode 打开项目 入下图 img 5.打开项目后,安装键盘 Ctrl+J 快捷键 打开控制台窗口 然后执行yarn dev 如下图 将会出现ip 地址和端口号 img 6第一次启动 比较慢,由于要编译所有的npm 包,,运行成后,在浏览器输入 http://localhost:3001/ 将会出现预览界面, 7项目启动成功,每次修改,保存后,由于会热更新,浏览器会自动刷新,将会看到自己最新的更改(如果浏览器没有及时刷新则自己手动刷新下浏览器) img