Commit 4ee32ff6 authored by Junling Bu's avatar Junling Bu
Browse files

doc: 增加轻商城文档

parent 1b1a8945
...@@ -2,7 +2,7 @@ ...@@ -2,7 +2,7 @@
又一个小商场系统。 又一个小商场系统。
litemall = Spring Boot后端 + Vue管理员前端 + 微信小程序用户前端 litemall = Spring Boot后端 + Vue管理员前端 + 微信小程序用户前端 + Vue用户移动端
* [文档](https://linlinjava.gitbook.io/litemall) * [文档](https://linlinjava.gitbook.io/litemall)
* [贡献](https://linlinjava.gitbook.io/litemall/contribute) * [贡献](https://linlinjava.gitbook.io/litemall/contribute)
...@@ -20,6 +20,12 @@ litemall = Spring Boot后端 + Vue管理员前端 + 微信小程序用户前端 ...@@ -20,6 +20,12 @@ litemall = Spring Boot后端 + Vue管理员前端 + 微信小程序用户前端
![](./doc/pic/litemall_wx_demo.png) ![](./doc/pic/litemall_wx_demo.png)
> 注意:此实例是测试小商场,开发者请不要尝试购买商品、付款、退款操作。 > 注意:此实例是测试小商场,开发者请不要尝试购买商品、付款、退款操作。
### 轻商场实例
目前未部署
![](./doc/pic/5.gif)
### 管理后台实例 ### 管理后台实例
![](./doc/pic/4.png) ![](./doc/pic/4.png)
...@@ -122,6 +128,20 @@ litemall = Spring Boot后端 + Vue管理员前端 + 微信小程序用户前端 ...@@ -122,6 +128,20 @@ litemall = Spring Boot后端 + Vue管理员前端 + 微信小程序用户前端
> 这里只是最简启动方式,而小商场的微信登录、微信支付等功能需开发者设置才能运行, > 这里只是最简启动方式,而小商场的微信登录、微信支付等功能需开发者设置才能运行,
> 更详细方案请参考[文档](https://linlinjava.gitbook.io/litemall/project)。 > 更详细方案请参考[文档](https://linlinjava.gitbook.io/litemall/project)。
6. 启动轻商城前端
打开命令行,输入以下命令
```bash
npm install -g cnpm --registry=https://registry.npm.taobao.org
cd litemall/litemall-vue
cnpm install
cnpm run dev
```
此时,浏览器(建议采用chrome 手机模式)打开,输入网址`http://localhost:6255`, 此时进入轻商场。
注意:
> 现在功能很不稳定,处在开发阶段。
## 开发计划 ## 开发计划
当前版本[v1.3.0](https://linlinjava.gitbook.io/litemall/changelog) 当前版本[v1.3.0](https://linlinjava.gitbook.io/litemall/changelog)
...@@ -139,6 +159,7 @@ V 2.0.0 完成以下目标: ...@@ -139,6 +159,7 @@ V 2.0.0 完成以下目标:
1. 小商城和管理后台完成所有基本业务; 1. 小商城和管理后台完成所有基本业务;
2. 管理后台实现统计功能、日志功能、权限功能; 2. 管理后台实现统计功能、日志功能、权限功能;
3. 业务代码和细节代码进行调整优化; 3. 业务代码和细节代码进行调整优化;
4. 轻商城的开发;
V 3.0.0 完成以下目标: V 3.0.0 完成以下目标:
...@@ -169,20 +190,26 @@ V 3.0.0 完成以下目标: ...@@ -169,20 +190,26 @@ V 3.0.0 完成以下目标:
项目介绍: 一个基于Vue和Element的后台集成方案 项目介绍: 一个基于Vue和Element的后台集成方案
项目参考:litemall项目的litemall-admin模块的前端框架基于项目修改扩展。 项目参考:litemall项目的litemall-admin模块的前端框架基于vue-element-admin项目修改扩展。
3. [mall-admin-web](https://github.com/macrozheng/mall-admin-web) 3. [mall-admin-web](https://github.com/macrozheng/mall-admin-web)
项目介绍:mall-admin-web是一个电商后台管理系统的前端项目,基于Vue+Element实现。 项目介绍:mall-admin-web是一个电商后台管理系统的前端项目,基于Vue+Element实现。
项目参考:litemall项目的litemall-admin模块的一些页面布局样式参考了项目。 项目参考:litemall项目的litemall-admin模块的一些页面布局样式参考了mall-admin-web项目。
4. [biu](https://github.com/CaiBaoHong/biu) 4. [biu](https://github.com/CaiBaoHong/biu)
项目介绍:管理后台项目开发脚手架,基于vue-element-admin和springboot搭建,前后端分离方式开发和部署。 项目介绍:管理后台项目开发脚手架,基于vue-element-admin和springboot搭建,前后端分离方式开发和部署。
项目参考:litemall项目的权限管理功能参考了项目。 项目参考:litemall项目的权限管理功能参考了biu项目。
5. [vant--mobile-mall](https://github.com/qianzhaoy/vant--mobile-mall)
项目介绍:基于有赞 vant 组件库的移动商城。
项目参考:litemall项目的litemall-vue模块基于vant--mobile-mall项目开发。
## 问题 ## 问题
![](doc/pic/qq.png) ![](doc/pic/qq.png)
......
...@@ -7,4 +7,5 @@ ...@@ -7,4 +7,5 @@
* [1. 系统架构](./project.md) * [1. 系统架构](./project.md)
* [2. 基础系统](./platform.md) * [2. 基础系统](./platform.md)
* [3. 小商场](./wxmall.md) * [3. 小商场](./wxmall.md)
* [4. 管理后台](./admin.md) * [4. 管理后台](./admin.md)
\ No newline at end of file * [5. 轻商城](./mobmall.md)
\ No newline at end of file
# 5 litemall轻商城
litemall轻商城,是商城移动版本。
技术:
* 轻商城前端,即litemall-vue模块
* power by vue-cli3
* Vue + Vue-router + Vant + Sass
* axios
* vee-validate
* fastclick
* babel-polyfill
* @xkeshi/vue-countdown
* Vant
* 轻商城前端,即litemall-wx-api模块,也就是和小商城后端是一样的。
* Spring Boot 2.x
* Spring MVC
* [weixin-java-tools](https://gitee.com/binary/weixin-java-tools)
## 5.1 litemall-wx-api
可以阅读3.1
## 3.2 litemall-vue
这里的代码基于[vant--mobile-mall](https://github.com/qianzhaoy/vant--mobile-mall)
文档未完成。
\ No newline at end of file
...@@ -2,30 +2,35 @@ ...@@ -2,30 +2,35 @@
## 1.1 简介 ## 1.1 简介
litemall是一个简单的商场系统,基于现有的开源项目,重新实现一个完整的前后端项目,包含小程序客户端和网页管理端。 litemall是一个简单的商场系统,基于现有的开源项目,重新实现一个完整的前后端项目,包含小程序客户端、移动客户端和网页管理端。
![](./pic1/1-1.png) ![](./pic1/1-1.png)
项目的架构是个系统和个模块: 项目的架构是个系统和个模块:
* 基础系统子系统(platform) * 基础系统子系统(platform)
由数据库、litemall-core模块、litemall-db模块和litemall-all模块组成; 由数据库、litemall-core模块、litemall-db模块和litemall-all模块组成;
* 小商场子系统(wxmall) * 小商场子系统(wxmall,即weixin mall)
由litemall-wx-api模块、litemall-wx模块和renard-wx模块组成; 由litemall-wx-api模块、litemall-wx模块和renard-wx模块组成;
* 管理后台子系统(admin) * 轻商城子系统(mobmall,即mobile mall)
由litemall-admin-api模块和litemall-admin模块组成。 由litemall-wx-api模块和litemall-vue模块组成。
注意,目前这里移动商城子系统的后端和小商场子系统是一样的。
*商城系统(mall) * 简商城系统(webmall)
这里仅列出,目前没有开发计划。 这里仅列出,目前没有开发计划。
* 管理后台子系统(admin)
而六个模块的开发设计到三种技术栈: 由litemall-admin-api模块和litemall-admin模块组成。
而九个模块的开发设计到三种技术栈:
* Spring Boot技术栈 * Spring Boot技术栈
...@@ -38,19 +43,20 @@ litemall是一个简单的商场系统,基于现有的开源项目,重新实 ...@@ -38,19 +43,20 @@ litemall是一个简单的商场系统,基于现有的开源项目,重新实
* Vue技术栈 * Vue技术栈
采用VSC开发工具,开发litemall-admin模块。 采用VSC开发工具,开发litemall-admin模块和litemall-vue模块
## 1.2 系统功能 ## 1.2 系统功能
从业务功能上,目前由个业务模块组成: 从业务功能上,目前由个业务模块组成:
* 会员业务模块 * 会员业务模块
* 商场业务模块 * 商场业务模块
* 商品业务模块 * 商品业务模块
* 推广业务模块 * 推广业务模块
* 系统业务模块 * 系统业务模块
* 配置业务模块
### 1.2.1 小程序端功能 ### 1.2.1 小商城功能
* 首页 * 首页
* 专题列表、专题详情 * 专题列表、专题详情
...@@ -68,7 +74,29 @@ litemall是一个简单的商场系统,基于现有的开源项目,重新实 ...@@ -68,7 +74,29 @@ litemall是一个简单的商场系统,基于现有的开源项目,重新实
* 地址列表、地址添加、地址删除 * 地址列表、地址添加、地址删除
* 收藏、足迹、关于 * 收藏、足迹、关于
### 1.2.2 管理平台功能 ### 1.2.1 轻商城功能
**目前还在开发中,不稳定**
以下是准备完成的功能:
* 首页
* 专题列表、专题详情
* 分类列表、分类详情
* 品牌列表、品牌详情
* 新品首发、人气推荐
* 团购
* 搜索
* 商品详情
* 商品评价列表、商品评价
* 购物车
* 下单
* 个人
* 订单列表、订单详情
* 地址列表、地址添加、地址删除
* 收藏、足迹、关于
### 1.2.3 管理平台功能
* 会员管理 * 会员管理
* 会员管理 * 会员管理
...@@ -98,11 +126,15 @@ litemall是一个简单的商场系统,基于现有的开源项目,重新实 ...@@ -98,11 +126,15 @@ litemall是一个简单的商场系统,基于现有的开源项目,重新实
* 系统管理 * 系统管理
* 管理员 * 管理员
* 对象存储 * 对象存储
* 权限管理(待定) * 权限管理
* 定时任务(待定) * 定时任务(待定)
* 参数管理(待定) * 操作日志
* 系统日志(待定) * 配置管理
* 统计管理 * 商场配置
* 小程序配置
* 运费配置
* 订单配置
* 统计报表
* 用户统计 * 用户统计
* 订单统计 * 订单统计
* 商品统计 * 商品统计
...@@ -607,6 +639,10 @@ litemall: ...@@ -607,6 +639,10 @@ litemall:
当配置好信息以后,开发者可以litemall-core模块的`ExpressTest`测试类中设置快递公司编码和 当配置好信息以后,开发者可以litemall-core模块的`ExpressTest`测试类中设置快递公司编码和
真实测试快递单号,独立启动`ExpressTest`测试类查询物流信息。 真实测试快递单号,独立启动`ExpressTest`测试类查询物流信息。
注意:
> 一部分快递公司(例如顺丰速运、申通快递等)的轨迹查询在开发环境下不支持,
> 具体支持情况或者使用限制请阅读[官方资料](http://www.kdniao.com/UserCenter/v2/UserHome.aspx)
#### 1.4.5.9 对象存储配置 #### 1.4.5.9 对象存储配置
对象存储,即存储和下载文件。 对象存储,即存储和下载文件。
......
# liteMall 移动商城
- 本项目是小程序的 vue 版本,样式大体相同,欢迎有能力的人贡献更优秀的代码
> 使用有赞移动端 Vue 组件库 — [Vant](https://www.youzanyun.com/zanui/vant#/zh-CN/component/intro)
## Vue相关库与插件
- power by vue-cli3
- Vue + Vue-router + Vant + Sass
- axios
- vee-validate
- fastclick
- babel-polyfill
- @xkeshi/vue-countdown
## Build Script
``` bash
# install dependencies
npm install
# serve with hot reload at localhost:6255 九键输入法的 「mall」= 「6255」
npm run serve
# build for production with minification : build result at /dist
npm run build
# build for production and view the bundle analyzer report
npm run build -- --report
```
- 简单预览:
[![AqVx1g.md.png](https://s2.ax1x.com/2019/04/12/AqVx1g.md.png)](https://imgchr.com/i/AqVx1g)
[![AqZZ3F.md.gif](https://s2.ax1x.com/2019/04/12/AqZZ3F.md.gif)](https://imgchr.com/i/AqZZ3F)
### 一些 Tips
- 手机浏览或 chrome 手机模式:开发/浏览 体验更佳
- 运行项目
```bash
npm i && npm run serve
```
- 打包项目
```bash
# /dist copy to you http server
npm run build
```
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