Skip to content

Latest commit

 

History

History
 
 

doc

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 

编写的原因

写在前面,很多加入我们群里的人,都会问我们源码在哪里,现在仔细回答一下

  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的星星,大家都不是傻的,这代码是能用的,拜托...后来没怎么维护(整个流程都是好的,整个功能都是好的,都不知道维护啥),现在又开始维护了,星星也没了(如果你悄悄拿去做外包项目,觉得这个项目对你有用,就给个星星呗)

先确定我们下载的项目有几个项目

  • mall4j:j代表java,java项目,这里面包含了小程序/后台vue连接需要的接口。
  • mall4v:v代表vue项目,是后台管理员界面使用的前端项目,因为前后端分离的
  • mall4m:m代表mini,小程序项目,这里的项目是小程序的项目
  • mall4uni:uni代表uniapp,H5项目,这里的项目是H5的项目
  • jvm:java虚拟机啦~

1.java开发环境安装

1.1开发环境

以下版本是最低要求的!!! 提问问题前请注意开发环境!!

工具 版本
jdk 17
mysql 5.7+
redis 4.0+
nodejs 14-16
xxl-job 2.4.0

1.2 安装jdk + mysql + redis + maven

如果不了解怎么安装jdk的,可以参考 菜鸟教程的java相关

  • 教程展示的是oracle,需要自行搜索openjdk的下载链接,下载jdk17版本

如果不了解怎么安装mysql的,可以参考 菜鸟教程的mysql相关

如果不了解怎么安装maven的,可以参考 菜鸟教程的maven相关

如果对于redis的安装并不了解的,可以参考 菜鸟教程的redis相关

安装相对简单,网上也有很多教程,这里就不多讲述。安装完按需对redis进行配置,后启动redis服务即可。

2.启动

  • 推荐使用idea,安装lombok插件后,使用idea导入maven项目
  • 将yami_shop.sql导入到mysql中,修改application-dev.yml更改 datasource.url、user、password
  • 通过修改shop.properties 修改七牛云、阿里大鱼等信息
  • 修改api.properties 修改当前接口所在域名,用于支付回调
  • 启动redis,端口6379
  • 通过WebApplication启动项目后台接口,ApiApplication 启动项目前端接口
  • xxl-job定时任务,通过github或者gitee下载xxl-job的已经打包好的源码,把XxlJobConfig.class这个文件的代码注释打开,配置yml文件中相关xxl-job配置即可使用

3.vue开发环境安装

这是一套正常的vue启动流程。如果你无法理解,可能要先学习一下vue...

3.1 安装nodejs

NodeJS 项目要求最低 18.12.0,推荐 20.9.0

如果不了解怎么安装nodejs的,可以参考 菜鸟教程的nodejs相关

3.2 安装依赖启动项目

项目要求使用 pnpm 包管理工具

使用编辑器打开项目,在根目录执行以下命令安装依赖

pnpm i

如果不想使用 pnpm,请删除 package.json 文件中 preinstall 脚本后再进行安装

{
    "scripts" : {
        "preinstall": "npx only-allow pnpm"  // 使用其他包管理工具(npm、yarn、cnpm等)请删除此命令
    }
}

H5端和平台端修改文件.env.production(生产环境)/ .env.development(开发环境) 里面的VITE_APP_BASE_API为api接口请求地址, VITE_APP_RESOURCES_URL为静态资源文件url

// api接口请求地址
VITE_APP_BASE_API = 'http://127.0.0.1:8085'

// 静态资源文件url
VITE_APP_RESOURCES_URL = 'https://img.mall4j.com/'

mall4m小程序端修改文件utils\config.js,里面的domain为api接口请求地址

注意!!如果启动uni项目或者小程序,默认后台api服务端口号为8086, 如果启动后台项目,默认后台admin服务端口号为8085,请对照仔细填写后再启动,如遇401状态码,仔细检查端口号是否配置正确! 如果后台启动后,图形验证码显示“接口验证失败数过多,请稍后再试”,请F12打开network确定连接的admin服务端口号是否正确,ip或域名是否正确, 如果有配置nginx,还要确认下项目访问路径是否正确,可以通过地址+/doc.html来访问接口文档确定是否正确访问到admin服务

运行dev环境:

npm run dev

运行dev环境(H5):

npm run dev:h5

4.文档

这代码有没有文档呀? 当然有啦,你已经下载了,在doc这个文件夹上,实在不知道,我就给链接出来咯: