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

doc

parent 983a858b
......@@ -6,7 +6,7 @@ litemall = Spring Boot后端 + Vue管理员前端 + 微信小程序用户前端
* [文档](https://linlinjava.gitbook.io/litemall)
* [贡献](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管理员前端 + 微信小程序用户前端
这里存在两套小商场前端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 完成以下目标:
## 警告
> 1. 本项目仅用于学习练习
> 2. 项目目前还不完善,仍处在开发中,不承担任何使用后果
> 3. 项目代码开源[MIT](./LICENSE),项目文档采用 [署名-禁止演绎 4.0 国际协议许可](https://creativecommons.org/licenses/by-nd/4.0/deed.zh)
> 2. 项目目前还不完善,仍处在开发中,不承担任何使用后果
> 3. 项目代码开源[MIT](./LICENSE),项目文档采用 [署名-禁止演绎 4.0 国际协议许可](https://creativecommons.org/licenses/by-nd/4.0/deed.zh)
## 致谢
......@@ -189,7 +190,7 @@ V 3.0.0 完成以下目标:
* 开发者有问题或者好的建议可以用Issues反馈交流,请给出详细信息
* 在开发交流群中应讨论开发、业务和合作问题
* 如果真的需要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)
* 请百度或谷歌相关技术;
* 请查看相关技术的官方文档,例如微信小程序的官方文档;
......
......@@ -12,12 +12,12 @@
原因:
目前账号的appid是本人申请,同时小程序未上线,因此开发者如果微信登录肯定会失败。
小程序未上线之前,开发者必须设置自己申请的appid,否则微信登录肯定会失败。
解决:
1. 如果只是体验商品购买流程,开发者可以采用账号注册登录方式。
2. 开发者在litemall-wx和litemall-wx-api模块的appid信息设置成自己申请的信息。
2. 开发者在litemall-wx、renard-wx和litemall-core模块的appid信息设置成自己申请的信息。
### 1.2 appid已经修改,微信登陆仍然失败
......@@ -55,7 +55,7 @@
现象:
本人手机测试正常,而第三者手机测试不正常。
开发者自己手机测试正常,而第三者手机测试不正常。
解决:
......
......@@ -167,6 +167,8 @@ litemall是一个简单的商场系统,基于现有的开源项目,重新实
先不开发和测试这样业务功能,等其他功能开发完毕和部署测试成功以后,再来开发这些线上环境才能
运行的功能,此时会有一个好的基础。
接下来,分别从开发阶段、部署阶段和上线阶段三种阶段,分别介绍不同的方案实践要点。
## 1.4 开发方案
![](pic1/1-2.png)
......@@ -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开发环境
......@@ -249,12 +267,11 @@ litemall是一个简单的商场系统,基于现有的开源项目,重新实
如果出现JSON数据,则litemall-all模块运行正常。
注意:
> 1. 在上述开发步骤中,既介绍了Maven命令方式,也介绍了IDEA方式,
> 但是仍然建议开发者开发阶段采用IDEA。
> 2. 以上是本人开发过程中采用的一些步骤,开发者可不拘泥于这些步骤。
> 如果开发者没有按照本人步骤开发而出现相关问题,也请**不要**咨询,
> 本人**没有**相关解决经验。
> 3. 开发者使用IDEA导入项目或者运行项目的时候会出现软件卡顿的现象,这通常是litemall-admin的
> 1. 上述步骤中,既介绍了Maven命令方式,也介绍了IDEA方式,
> 但是建议开发者开发阶段采用IDEA。
> 2. 上述步骤只是一种实践方式,开发者可不拘泥于这些步骤,多实践。
> 当然,如果开发者不采用这里步骤而出现问题,请自行解决。
> 3. 开发者使用IDEA导入项目或者运行项目时可能会出现**软件卡顿**的现象,这通常是litemall-admin的
> node_modules文件夹内自动下载了大量的litemall-admin的依赖库,当IDEA尝试索引该文件夹内的大量文件时
> 则出现IDEA卡顿的现象,具体解决方式可以参见[FAQ](./FAQ.md)
......@@ -290,7 +307,7 @@ litemall是一个简单的商场系统,基于现有的开源项目,重新实
4. 请确定litemall-all模块已经运行,然后点击`登录`,如果能够成功登录,则表明管理后台的前端和后端对接成功,运行正常。
目前本人采用VSC(Visual Studio Code)开发litemall-admin项目,开发者也可以采用其他熟悉的IDE。
本项目采用VSC(Visual Studio Code)开发litemall-admin模块,开发者也可以采用其他熟悉的IDE。
### 1.4.5 项目配置
......@@ -1044,7 +1061,6 @@ http://www.example.com
3. 重启nginx
注意:
> 本人对nginx也不了解,仅仅依靠网络知识配置了简单的效果。
> 更多配置方法和功能,请开发者自行学习。
### 1.6.3 小商场上线
......@@ -1124,8 +1140,7 @@ litemall-admin编译得到的前端文件在第一次加载时相当耗时,这
#### 1.6.6.4 nginx优化
本人对nginx不是很熟悉,而nginx还存在很多可以调整优化的部分,这里建议开发者
根据自己业务或架构情况优化。
建议开发者根据自己业务或架构情况优化。
## 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