跟新文档

README.md

@@ -77,6 +77,48 @@ litemall = Spring Boot后端 + Vue管理员前端 + 微信小程序用户前端
 
 ![](doc/pic/4.png)
 
+### 快速启动
+
+1. 配置最小开发环境：
+    * [MySQL](https://dev.mysql.com/downloads/mysql/)
+    * [JDK1.8或以上](http://www.oracle.com/technetwork/java/javase/overview/index.html)
+    * [Maven](https://maven.apache.org/download.cgi)
+    * [Nodejs](https://nodejs.org/en/download/)
+    * [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)
+    
+2. 数据库依次导入litemall-db/sql下的数据库文件
+    * litemall_schema.sql
+    * litemall_table.sql
+    * litemall_data.sql
+
+3. 启动小商场和管理后台的后台服务
+
+    打开命令行，输入以下命令
+    ```bash
+    cd litemall
+    mvn install
+    mvn package
+    cd ./litemall-all
+    mvn spring-boot:run
+    ```
+    
+4. 启动管理后台前端
+
+    打开命令行，输入以下命令
+    ```bash
+    cd litemall/litemall-admin
+    cnpm install
+    cnpm run dev
+    ```
+    此时，浏览器打开，输入网址`http://localhost:9527`, 此时进入管理后台登录页面。
+    
+5. 启动小商城前端
+   
+   打开微信开发者工具，导入litemall-wx模块,点击`编译`即可，此时可以预览小商场效果。
+
+注意：
+> 这里只是最简启动方式，而且小商场的微信登录会失败，更详细方案请参考文档。
+
 ## 开发计划
 
 目前项目开发中，存在诸多不足，以下是目前规划的开发计划。
@@ -99,9 +141,6 @@ V 3.0.0 完成以下目标：
 2. 后台服务加强安全功能、配置功能
 3. 缓存功能以及优化一些性能
 
-警告：
-> **以上仅仅是个人规划的开发计划，实际可能出现任何情况，例如能力有限而放弃开发。**
-
 ## 警告
 
 > 1. 本项目仅用于学习练习
@@ -121,16 +160,14 @@ V 3.0.0 完成以下目标：
 
 ![](doc/pic/qq.png)
 
-开发者有问题或者好的建议可以用Issues反馈交流，请给出详细信息，本人会尽可能解决。
- * 如果问题是共性问题（如代码bug或文档不全），本人会及时解决。
- * 如果问题是个人问题（如开发者了解不深入或者没有相关技术），请见谅（本人也是百度和谷歌）。
+ * 开发者有问题或者好的建议可以用Issues反馈交流，请给出详细信息
+ * 在开发交流群中应讨论开发、业务和合作问题
  * 如果真的需要QQ群里提问，请在提问前先完成以下过程：
-    * 请仔细阅读本项目文档，特别是是[**FAQ**](./doc/7.md)，查看能否解决；
+    * 请仔细阅读本项目文档，特别是是[**FAQ**](./doc/FAQ.md)，查看能否解决；
     * 请阅读[提问的智慧](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/master/README-zh_CN.md)；
     * 请百度或谷歌相关技术；
     * 请查看相关技术的官方文档，例如微信小程序的官方文档；
     * 请提问前尽可能做一些DEBUG或者思考分析，然后提问时给出详细的错误相关信息以及个人对问题的理解。
- * 在开发交流群中应讨论开发、业务和合作问题。
 
 ## 相关项目
 

doc/5.md

-
-# 5 litemall商场网站
-
-目前不开发
-
-## 5.1 litemall-web-api
-
-## 5.2 litemall-web

doc/6.md

-# 6 下一步计划
-
-6.1节涉及到技术层面需要改进的部分，而6.2节则是业务方面未实现的部分，这两个部分的代码都会在本项目中实现。而6.3节会进一步完善本项目的安全和性能，但是不一定会在本项目中实现，因为会增加相当大的复杂性。
-
-## 6.1 技术
-
-### 6.1.1 ENUM
-数据库中涉及到枚举类型的字段，目前设置成VARCHAR。
-下一步应该设计不同的业务enum类型，然后mybatis自定义BaseTypeHandler来处理不同的枚举类型。
-
-### 6.1.2 litemall-db AutoConig
-目前，litemall-admin-api和litemall-wx-api引入litemall-db的时候，需要在Application类中显式注解查找包和MapperScan来对litemall-db中的mapper查找，此外需要在application.properties配置文件中完成对数据库、数据池等配置。
-例如
-```
-@SpringBootApplication(scanBasePackages={"org.linlinjava.litemall.admin","org.linlinjava.litemall.db"})
-@MapperScan("org.linlinjava.litemall.db.dao")
-public class Application {
-
-    public static void main(String[] args) {
-        SpringApplication.run(Application.class, args);
-    }
-
-}
-```
-下一步，应该自动部署，即引入litemall-db则会自动引入对mapper的查找，
-同时自动部署对数据库、PageHelper和Druid的配置。
-
-### 6.1.3 统一对日期时间域的处理
-目前，数据库的日期时间域有的采用DATE,有的是DATETIME，而对应Java用LocalDate和LocalDateTime。
-下一步应该根据具体业务功能采用合适的。
-
-### 6.1.4 vue-element-admin跟新
-目前的vue-element-admin基于element 2.0.8, 因此element的很多修复没有跟新。
-
-### 6.1.n 代码重构
-
-技术不断迭代开发中，应该在业务基本完成和功能基本完善以后，
-重新审视代码架构和技术，或者重构代码，或者采用更为合理的技术。
-
-## 6.2 业务
- 
-### 6.2.1 支付模块
-
-目前微信支付模块因缺乏支付权限而不能开发。
-
-### 6.2.3 监控管理
-
-项目运行的整个运行过程应该需要监控管理
-
-### 6.2.4 权限管理
-
-目前安全实现非常粗糙，仅仅依赖管理员的名称和密码。
-更好的做法是引入角色权限机制。
-
-## 6.3 企业级
-
-### 6.3.1 安全（必须）
-
-尽在系统所有业务功能完整实现以后。
-
-### 6.3.2 性能（建议）
-
-仅在系统所有业务功能完整实现以后。
-
-性能的提升存在多种方案。
-
-目前考虑到的技术方案：
-
-* 采用内存数据库，如redis，缓存一些改动较少的数据，例如行政区域数据。
-* 数据库方面可以引入冗余，例如首页的数据可以先从其他表更新到一个独立的表。
-
-### 6.3.3 对象存储云服务（建议）
-
-仅在系统所有业务功能完整实现以后。
-
-对象存储云服务不一定是必须的：
-
-* 局域网中只能采用内部对象存储服务
-* 对象存储云服务也是一笔开销
-* 引入对象存储云服务也增加了一定的复杂性
-* 导致对具体云平台的耦合
-
-当然，对象存储云服务的益处也是毋庸置疑的，因此建议部署使用。
-
-### 6.3.4 云数据库（必须）
-
-同上，如果仅在局域网中部署项目，那么数据库的部署也只能是在局域网中，但是在互联网中部署应用，数据的重要性和优先级是最高的，采用云数据库可以方便带来其提供的安全和性能服务。
-
-### 6.3.5 短信服务（必须）
-
-真正的项目里面肯定需要短信功能。
-
-### 6.3.6 推荐系统（可选）
-
-目前的关键字是管理员设置，然后用户的搜索时匹配关键字，因此需要专业的推荐系统。
-
-Apache Solor
-
-### 6.3.7 Spring Boot 2.0
-
-### 6.3.8 Spring Cloud
-
-### 6.3.8 定时任务模块
-
-### 6.3.9 单点登录模块
-
-### 6.3.10 消息队列
\ No newline at end of file

doc/7.md → doc/FAQ.md

-# 7. 常见问题
+# 常见问题
 
-## 7.1 小商城
+## 小商城
 
-### 7.1.1 小程序微信登录失败
+### 小程序微信登录失败
 
 原因：
 
@@ -13,7 +13,7 @@
 1. 如果只是体验商品购买流程，开发者可以采用账号注册登录方式。
 2. 开发者在litemall-wx和litemall-wx-api模块的appid等信息设置成自己申请的信息。
 
-#### 7.1.1.1 appid已经修改，微信登陆仍然失败
+#### appid已经修改，微信登陆仍然失败
 
 现象：
 
@@ -27,7 +27,7 @@
 
 微信开发者工具中修改appid以后，请关闭litemall-wx项目或者微信开发者工具，重新启动导入litemall-wx。
 
-### 7.1.2 手机真机测试不正常
+### 手机真机测试不正常
 
 现象：
 
@@ -45,7 +45,7 @@
    * 小商场的后台服务未启动
 2. 手机小商场的**调试功能**开启
 
-### 7.1.3 第三方手机测试不正常
+### 第三方手机测试不正常
 
 现象：
 
@@ -57,7 +57,7 @@
 2. 第三者手机小商场的**调试功能**开启
 3. 在微信小程序平台设置第三者的微信账号是**体验者**
 
-### 7.1.4 微信支付失败
+### 微信支付失败
 
 现象：
 
@@ -67,18 +67,18 @@
 
 开发者必须拥有商户支付权限，然后设置好以下信息：
 ```
-wx.app-id=
-wx.app-secret=
-wx.mch-id=
-wx.mch-key=
-wx.notify-url=
+litemall.wx.app-id=
+litemall.wx.app-secret=
+litemall.wx.mch-id=
+litemall.wx.mch-key=
+litemall.wx.notify-url=
 ```
 
 解决方案：
 
 参考`3.0 小商场环境`，设置相应支付配置信息
 
-### 7.1.5 支付成功，但商品仍未付款
+### 支付成功，但商品仍未付款
 
 现象：
 
@@ -99,9 +99,9 @@ wx.notify-url=
 
 2. 如果开发者已经上线服务，请确认`wx.notify-url`所指向的访问链接可以正常工作。
 
-## 7.2 管理后台
+## 管理后台
 
-### 7.2.1 Invalid bound statement
+### Invalid bound statement
 
 现象：
 
@@ -123,11 +123,11 @@ mvn clean
 mvn package
 ```
 
-## 7.3 基础系统
+## 基础系统
 
-## 7.4 项目
+## 项目
 
-### 7.4.1 项目导入IDEA时卡顿
+### 项目导入IDEA时卡顿
 
 现象：
 
@@ -142,4 +142,4 @@ node_modules是litemall-admin所依赖的项目库，可能有近200M的文件
 解决方案：
 
 右键把node_modules设置Excluded
-![](./pic7/excluded.png)    
+![](./pic/excluded.png)    

doc/README.md

@@ -3,10 +3,8 @@
 * [介绍](../README.md)
 * [更新日志](../CHANGELOG.md)
 * [贡献指南](../CONTRIBUTE.md)
-* [1. 系统架构](./1.md)
-* [2. 基础系统](./2.md)
-* [3. 小商场](./3.md)
-* [4. 管理后台](./4.md)
-* [5. 商场](./5.md)
-* [6. 下一步计划](./6.md)
+* [FAQ](./FAQ.md)
+* [1. 系统架构](./project.md)
+* [2. 基础系统](./platform.md)
+* [3. 小商场](./wxmall.md)
+* [4. 管理后台](./admin.md)
\ No newline at end of file
-* [7. FAQ](./7.md)
\ No newline at end of file

doc/4.md → doc/admin.md

@@ -7,7 +7,7 @@
   * vuex
   * vue-router
   * axios
-  * element-ui
+  * element
   * vue-element-admin
   * 其他，见package.json
 * 后台管理后端, 即litemall-admin-api模块
@@ -16,32 +16,20 @@
 
 目前存在的问题：
 
-* `严重`业务功能重新设计，例如即使是管理员也不能删除修改用户的相关数据
-* `严重`商品和货品管理，特别是添加一个商品
 * `缺失`支持微信登录
-* `缺失`后台采用事务
 * `缺失`首页中实现一些小组件，同时点击能够跳转相应页面
 * `缺失`商品评价中管理员回复功能
 * `缺失`支持导出表所有数据
-* `改善`返回的时间日期，在前端显示20180101T0000格式，效果不好
 * `改善`管理员登录页面打开慢，优化速度
-* `改善`大部分页面仅仅是一个表CRUD的效果，交互性一般。
-  例如，显示商品的时候，只是简单显示表中保存的类目ID和品牌商ID，
-  更好的效果可能是显示对应的类目名称和品牌商名称，
-  同时能够显示更详细的类目信息和品牌商信息。
-* `改善`页面中图片数据目前是显示地址，更好地做法应该是显示小图片，
-  同时支持点击放大的效果
 * `改善`地址优化，目前每一次点击都会请求后台，应该缓存已有的数据
-* `改善`查询时排序功能
 * `改善`vue和vue-element-admin等及时更新
 * `功能`系统角色和权限
 * `功能`系统日志功能
 * `功能`系统数据字典功能
 * `功能`系统栏目管理功能
-* `功能`支持国际化???
+* `功能`支持国际化
 * `功能`支持数据库备份
 
-
 ## 4.1 litemall-admin-api
 
 本节介绍管理后台的后台服务模块。

doc/2.md → doc/platform.md

@@ -7,8 +7,6 @@
 * litemall-db模块
 * litemall-all模块
 
-实际上，litemall**真正的基础系统**是litemall-core模块和litemall-db模块。
-
 litemall-all模块则只是一个包裹模块，几乎没有任何代码。该模块的作用是融合两个spring boot模块
 和litemall-admin模块静态文件到一个单独spring boot应用中，并最终打包成war格式的项目安装包。
 

doc/3.md → doc/wxmall.md

@@ -12,12 +12,6 @@
 
 目前发现存在的一些问题：
   
-* `严重`账号登录和注册中验证码
-
-  注意：
-  > 这里之所以没有实现，是因为需要接入云平台的短信服务。
-  > 后期可能接入腾讯的短信服务。
-  
 * `缺失`优惠券功能
 * `缺失`商品评价中管理员回复功能，进一步地用户之间相互评价回复
 * `缺失`后台服务返回的token存在有效期，小商场应该自动刷新
@@ -36,7 +30,6 @@
 * `改善`商品的订单中支持订单号搜索功能
 * `改善`在一些内容比较多的页面中支持“顶部”功能
 * `功能`目前已经有账号登录页面，可以再支持手机短信登录方式。
-* `功能`个人页面支持联系客服
 * `功能`个人页面支持帮助中心
 * `功能`推荐功能，基于用户的一些信息，在合适的页面给出推荐商品
 
@@ -50,10 +43,12 @@
 
 开发者在微信小程序官网申请以后，可以有app-id和app-secret信息。
 
-1. 在litemall-wx-api模块的src/main/resources的资源文件中设置
+1. 在litemall-core模块的src/main/resources的资源文件中设置
 ```
-wx.app-id=开发者申请的app-id
-wx.app-secret=开发者申请的app-secret
+litemall
+    wx
+        app-id=开发者申请的app-id
+        app-secret=开发者申请的app-secret
 ```
 
 2. 在litemall-wx模块的project.config.json文件中设置