Commit 4581d750 authored by Junling Bu's avatar Junling Bu
Browse files

doc

parent 983a858b
...@@ -6,7 +6,7 @@ litemall = Spring Boot后端 + Vue管理员前端 + 微信小程序用户前端 ...@@ -6,7 +6,7 @@ litemall = Spring Boot后端 + Vue管理员前端 + 微信小程序用户前端
* [文档](https://linlinjava.gitbook.io/litemall) * [文档](https://linlinjava.gitbook.io/litemall)
* [贡献](https://linlinjava.gitbook.io/litemall/contribute) * [贡献](https://linlinjava.gitbook.io/litemall/contribute)
* [FAQ](https://linlinjava.gitbook.io/litemall/7) * [FAQ](https://linlinjava.gitbook.io/litemall/faq)
## 上架实例 ## 上架实例
...@@ -120,11 +120,12 @@ litemall = Spring Boot后端 + Vue管理员前端 + 微信小程序用户前端 ...@@ -120,11 +120,12 @@ litemall = Spring Boot后端 + Vue管理员前端 + 微信小程序用户前端
这里存在两套小商场前端litemall-wx和renard-wx,开发者可以分别导入和测试。 这里存在两套小商场前端litemall-wx和renard-wx,开发者可以分别导入和测试。
注意: 注意:
> 这里只是最简启动方式,而且小商场的微信登录会失败,更详细方案请参考文档。 > 这里只是最简启动方式,而小商场的微信登录、微信支付等功能需要开发者进行相应设置才能运行,
> 更详细方案请参考[文档](https://linlinjava.gitbook.io/litemall/project)。
## 开发计划 ## 开发计划
当前版本[v1.2.0](./CHANGELOG.md) 当前版本[v1.2.0](https://linlinjava.gitbook.io/litemall/changelog)
目前项目开发中,存在诸多不足,以下是目前规划的开发计划。 目前项目开发中,存在诸多不足,以下是目前规划的开发计划。
...@@ -149,8 +150,8 @@ V 3.0.0 完成以下目标: ...@@ -149,8 +150,8 @@ V 3.0.0 完成以下目标:
## 警告 ## 警告
> 1. 本项目仅用于学习练习 > 1. 本项目仅用于学习练习
> 2. 项目目前还不完善,仍处在开发中,不承担任何使用后果 > 2. 项目目前还不完善,仍处在开发中,不承担任何使用后果
> 3. 项目代码开源[MIT](./LICENSE),项目文档采用 [署名-禁止演绎 4.0 国际协议许可](https://creativecommons.org/licenses/by-nd/4.0/deed.zh) > 3. 项目代码开源[MIT](./LICENSE),项目文档采用 [署名-禁止演绎 4.0 国际协议许可](https://creativecommons.org/licenses/by-nd/4.0/deed.zh)
## 致谢 ## 致谢
...@@ -189,7 +190,7 @@ V 3.0.0 完成以下目标: ...@@ -189,7 +190,7 @@ V 3.0.0 完成以下目标:
* 开发者有问题或者好的建议可以用Issues反馈交流,请给出详细信息 * 开发者有问题或者好的建议可以用Issues反馈交流,请给出详细信息
* 在开发交流群中应讨论开发、业务和合作问题 * 在开发交流群中应讨论开发、业务和合作问题
* 如果真的需要QQ群里提问,请在提问前先完成以下过程: * 如果真的需要QQ群里提问,请在提问前先完成以下过程:
* 请仔细阅读本项目文档,特别是是[**FAQ**](./doc/FAQ.md),查看能否解决; * 请仔细阅读本项目文档,特别是是[**FAQ**](https://linlinjava.gitbook.io/litemall/faq),查看能否解决;
* 请阅读[提问的智慧](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/master/README-zh_CN.md) * 请阅读[提问的智慧](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/master/README-zh_CN.md)
* 请百度或谷歌相关技术; * 请百度或谷歌相关技术;
* 请查看相关技术的官方文档,例如微信小程序的官方文档; * 请查看相关技术的官方文档,例如微信小程序的官方文档;
......
...@@ -12,12 +12,12 @@ ...@@ -12,12 +12,12 @@
原因: 原因:
目前账号的appid是本人申请,同时小程序未上线,因此开发者如果微信登录肯定会失败。 小程序未上线之前,开发者必须设置自己申请的appid,否则微信登录肯定会失败。
解决: 解决:
1. 如果只是体验商品购买流程,开发者可以采用账号注册登录方式。 1. 如果只是体验商品购买流程,开发者可以采用账号注册登录方式。
2. 开发者在litemall-wx和litemall-wx-api模块的appid信息设置成自己申请的信息。 2. 开发者在litemall-wx、renard-wx和litemall-core模块的appid信息设置成自己申请的信息。
### 1.2 appid已经修改,微信登陆仍然失败 ### 1.2 appid已经修改,微信登陆仍然失败
...@@ -55,7 +55,7 @@ ...@@ -55,7 +55,7 @@
现象: 现象:
本人手机测试正常,而第三者手机测试不正常。 开发者自己手机测试正常,而第三者手机测试不正常。
解决: 解决:
......
...@@ -167,6 +167,8 @@ litemall是一个简单的商场系统,基于现有的开源项目,重新实 ...@@ -167,6 +167,8 @@ litemall是一个简单的商场系统,基于现有的开源项目,重新实
先不开发和测试这样业务功能,等其他功能开发完毕和部署测试成功以后,再来开发这些线上环境才能 先不开发和测试这样业务功能,等其他功能开发完毕和部署测试成功以后,再来开发这些线上环境才能
运行的功能,此时会有一个好的基础。 运行的功能,此时会有一个好的基础。
接下来,分别从开发阶段、部署阶段和上线阶段三种阶段,分别介绍不同的方案实践要点。
## 1.4 开发方案 ## 1.4 开发方案
![](pic1/1-2.png) ![](pic1/1-2.png)
...@@ -184,14 +186,30 @@ litemall是一个简单的商场系统,基于现有的开源项目,重新实 ...@@ -184,14 +186,30 @@ litemall是一个简单的商场系统,基于现有的开源项目,重新实
数据库环境设置过程如下: 数据库环境设置过程如下:
1. 安装MySQL 1. 安装MySQL;
2. 创建数据库、用户权限、数据库表和测试数据 2. 创建数据库、用户权限、数据库表和测试数据;
数据库文件存放在litemall-db/sql文件夹中,请开发者在MySQL中
按照顺序运行以下脚本:
* litemall_schema.sql,用于创建数据库、用户和权限;
* litemall_table.sql,用于创建表;
* litemall_data.sql,用于导入测试数据。
数据库文件存放在litemall-db/sql文件夹中,其中litemall_schema.sql创建数据库和用户权限, 注意:
litemall_table.sql则创建表,litemall_data.sql则是测试数据 > 建议采用命令行或者MySQL Workbench。如果采用Navicat可能导入失败
注意:建议采用命令行或者MySQL Workbench。如果采用navicat可能导入失败。 如果开发者运行litemall_schema.sql失败,可以打开该文件:
```
drop database if exists litemall;
drop user if exists 'litemall'@'localhost';
create database litemall default character set utf8mb4 collate utf8mb4_unicode_ci;
use litemall;
create user 'litemall'@'localhost' identified by 'litemall123456';
grant all privileges on litemall.* to 'litemall'@'localhost';
flush privilege
```
可以看到几个命令,用于创建数据库、用户和访问权限,因此开发者可以利用
命令或者工具完成这里的功能即可。
### 1.4.2 Spring Boot开发环境 ### 1.4.2 Spring Boot开发环境
...@@ -249,12 +267,11 @@ litemall是一个简单的商场系统,基于现有的开源项目,重新实 ...@@ -249,12 +267,11 @@ litemall是一个简单的商场系统,基于现有的开源项目,重新实
如果出现JSON数据,则litemall-all模块运行正常。 如果出现JSON数据,则litemall-all模块运行正常。
注意: 注意:
> 1. 在上述开发步骤中,既介绍了Maven命令方式,也介绍了IDEA方式, > 1. 上述步骤中,既介绍了Maven命令方式,也介绍了IDEA方式,
> 但是仍然建议开发者开发阶段采用IDEA。 > 但是建议开发者开发阶段采用IDEA。
> 2. 以上是本人开发过程中采用的一些步骤,开发者可不拘泥于这些步骤。 > 2. 上述步骤只是一种实践方式,开发者可不拘泥于这些步骤,多实践。
> 如果开发者没有按照本人步骤开发而出现相关问题,也请**不要**咨询, > 当然,如果开发者不采用这里步骤而出现问题,请自行解决。
> 本人**没有**相关解决经验。 > 3. 开发者使用IDEA导入项目或者运行项目时可能会出现**软件卡顿**的现象,这通常是litemall-admin的
> 3. 开发者使用IDEA导入项目或者运行项目的时候会出现软件卡顿的现象,这通常是litemall-admin的
> node_modules文件夹内自动下载了大量的litemall-admin的依赖库,当IDEA尝试索引该文件夹内的大量文件时 > node_modules文件夹内自动下载了大量的litemall-admin的依赖库,当IDEA尝试索引该文件夹内的大量文件时
> 则出现IDEA卡顿的现象,具体解决方式可以参见[FAQ](./FAQ.md) > 则出现IDEA卡顿的现象,具体解决方式可以参见[FAQ](./FAQ.md)
...@@ -290,7 +307,7 @@ litemall是一个简单的商场系统,基于现有的开源项目,重新实 ...@@ -290,7 +307,7 @@ litemall是一个简单的商场系统,基于现有的开源项目,重新实
4. 请确定litemall-all模块已经运行,然后点击`登录`,如果能够成功登录,则表明管理后台的前端和后端对接成功,运行正常。 4. 请确定litemall-all模块已经运行,然后点击`登录`,如果能够成功登录,则表明管理后台的前端和后端对接成功,运行正常。
目前本人采用VSC(Visual Studio Code)开发litemall-admin项目,开发者也可以采用其他熟悉的IDE。 本项目采用VSC(Visual Studio Code)开发litemall-admin模块,开发者也可以采用其他熟悉的IDE。
### 1.4.5 项目配置 ### 1.4.5 项目配置
...@@ -1044,7 +1061,6 @@ http://www.example.com ...@@ -1044,7 +1061,6 @@ http://www.example.com
3. 重启nginx 3. 重启nginx
注意: 注意:
> 本人对nginx也不了解,仅仅依靠网络知识配置了简单的效果。
> 更多配置方法和功能,请开发者自行学习。 > 更多配置方法和功能,请开发者自行学习。
### 1.6.3 小商场上线 ### 1.6.3 小商场上线
...@@ -1124,8 +1140,7 @@ litemall-admin编译得到的前端文件在第一次加载时相当耗时,这 ...@@ -1124,8 +1140,7 @@ litemall-admin编译得到的前端文件在第一次加载时相当耗时,这
#### 1.6.6.4 nginx优化 #### 1.6.6.4 nginx优化
本人对nginx不是很熟悉,而nginx还存在很多可以调整优化的部分,这里建议开发者 建议开发者根据自己业务或架构情况优化。
根据自己业务或架构情况优化。
## 1.7 项目管理 ## 1.7 项目管理
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment