Files
mall4j/doc/README.md
liaoanqi 28ffd7c567 屏蔽联系客服按钮
更新文档
2022-11-14 09:28:01 +08:00

128 lines
4.9 KiB
Markdown
Raw 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.

# 编写的原因
写在前面,很多加入我们群里的人,都会问我们源码在哪里,现在仔细回答一下
1. 我们已经声明了这是一个前后端分离的商城而且分离的很彻底java的后台管理系统不是jsp使用vue写的所以商城的后台管理在vue这个项目 https://gitee.com/gz-yami/mall4v ,启动完java不要访问java的端口启动vue访问vue的端口页面就能看到后台管理就能上商品了
2. 和上面一样的,很多人问,前端的浏览商品的页面在哪里,其实就在这里 https://gitee.com/gz-yami/mall4m
3. 有人会问你是不是将上面两个链接藏起来了上面两个项目的链接都在readme里面写着可是很多人都不读。
4. swagger文档怎么访问不了其实路径是/doc.html
5. 我们开源的刚上线直接申请通过了推荐项目第一天就有100个星星一个月就有1k的星星大家都不是傻的这代码是能用的拜托...后来没怎么维护(整个流程都是好的,整个功能都是好的,都不知道维护啥),现在又开始维护了,星星也没了(如果你悄悄拿去做外包项目,觉得这个项目对你有用,就给个星星呗)
## 先确定我们下载的项目有几个项目
- mall4jj代表javajava项目这里面包含了小程序/后台vue连接需要的接口。
- mall4vv代表vue项目是后台管理员界面使用的前端项目因为前后端分离的
- mall4mm代表mini小程序项目这里的项目是小程序的项目
- mall4uniuni代表uniappH5项目这里的项目是H5的项目
- jvmjava虚拟机啦~
## 1.java开发环境安装
### 1.1开发环境
以下版本是最低要求的!!! 提问问题前请注意开发环境!!
| 工具 | 版本 |
| ------ |------|
| jdk | 1.8+ |
| mysql | 5.7+ |
| redis | 4.0+ |
| nodejs | 8-12 |
### 1.2 安装jdk + mysql + redis + maven
如果不了解怎么安装jdk的可以参考 [菜鸟教程的java相关](https://www.runoob.com/java/java-environment-setup.html)
如果不了解怎么安装mysql的可以参考 [菜鸟教程的mysql相关](https://www.runoob.com/mysql/mysql-install.html)
如果不了解怎么安装maven的可以参考 [菜鸟教程的maven相关]( https://www.runoob.com/maven/maven-setup.html )
如果对于redis的安装并不了解的可以参考 [菜鸟教程的redis相关](https://www.runoob.com/redis/redis-install.html)
安装相对简单网上也有很多教程这里就不多讲述。安装完按需对redis进行配置后启动redis服务即可。
### 2.启动
- 推荐使用idea安装lombok插件后使用idea导入maven项目
- 将yami_shop.sql导入到mysql中修改`application-dev.yml`更改 datasource.url、user、password
- 将mysql配置为不区分表名大小写
- 通过修改`shop.properties` 修改七牛云、阿里大于等信息
- 修改`api.properties` 修改当前接口所在域名,用于支付回调
- 启动redis端口6379
- 通过`WebApplication`启动项目后台接口,`ApiApplication` 启动项目前端接口
## 3.vue开发环境安装
这是一套正常的vue启动流程。如果你无法理解可能要先学习一下vue...
#### 3.1 安装nodejs + 淘宝npm镜像
如果不了解怎么安装nodejs的可以参考 [菜鸟教程的nodejs相关](https://www.runoob.com/nodejs/nodejs-install-setup.html)
安装cnpm淘宝镜像使用命令行输入回车
```bash
npm install -g cnpm --registry=https://registry.npm.taobao.org
```
#### 3.2 安装依赖启动项目
使用vs code打开vue项目进入到该项目的根目录根目录有`package.json` 的文件)
使用cnpm安装依赖请勿直接使用npm安装依赖除非你能确定你的网络能够畅快访问外网使用命令行输入回车
```bash
cnpm i
```
平台端修改文件`.env.production`(生产环境)/ `.env.development`(开发环境)
里面的`VUE_APP_BASE_API`为api接口请求地址 `VUE_APP_RESOURCES_URL`为静态资源文件url
```json
// api接口请求地址
VUE_APP_BASE_API = 'http://192.168.1.120:8086'
// 静态资源文件url
VUE_APP_RESOURCES_URL = 'https://img.mall4j.com/'
```
移动端修改文件`utils\config.js`
里面的`domain`为api接口请求地址 `picDomain`为静态资源文件url
注意如果启动uni项目或者小程序默认后台api服务端口号为8086
如果启动后台项目默认后台admin服务端口号为8085请对照仔细填写后再启动如遇401状态码仔细检查端口号是否配置正确
运行dev环境
```bash
npm run dev
```
运行dev环境(H5)
```bash
npm run dev:h5
```
## 4.文档
这代码有没有文档呀?
当然有啦你已经下载了在doc这个文件夹上实在不知道我就给链接出来咯
### [https://gitee.com/gz-yami/mall4j/tree/master/doc](https://gitee.com/gz-yami/mall4j/tree/master/doc)