mirror of
https://gitee.com/beijing_hongye_huicheng/lilishop-ui.git
synced 2026-06-21 09:30:24 +08:00
update readme
This commit is contained in:
Chopper711
393
README.md
393
README.md
@@ -1,254 +1,153 @@
|
||||
## Lilishop B2B2C商城系统
|
||||
# Lilishop(PickMall) 开源商城系统
|
||||
|
||||
[](https://github.com/hongyehuicheng/lilishop)
|
||||
[](https://gitee.com/beijing_hongye_huicheng/lilishop)
|
||||
<p align="right">
|
||||
简体中文 | <a href="./README.en.md">English</a>
|
||||
</p>
|
||||
|
||||
LILISHOP 是基于 Spring Boot / Spring Cloud / Vue / Uniapp 开发的 Java 开源商城系统，支持 B2B2C 多商户商城、小程序商城、微服务商城、直播电商、分销返佣、秒杀活动、Docker 私有化部署。
|
||||
|
||||
## 核心特性
|
||||
|
||||
- Java商城系统
|
||||
- 开源商城系统
|
||||
- SpringBoot商城系统
|
||||
- SpringCloud微服务商城
|
||||
- B2B2C商城源码
|
||||
- 多商户商城系统
|
||||
- 小程序商城源码
|
||||
- Uniapp商城系统
|
||||
- Vue商城系统
|
||||
- Docker商城部署
|
||||
- 多语言商城
|
||||
|
||||
适用于：
|
||||
|
||||
- 企业级商城系统
|
||||
- 私有化商城部署
|
||||
- Java商城系统二次开发
|
||||
- 开源商城源码学习
|
||||
- 多商户电商平台
|
||||
---
|
||||
|
||||
### 1. 项目简介
|
||||
|
||||
**Lilishop** 是一款功能完善的B2B2C多商户商城系统，采用前后端分离架构，全端代码开源。
|
||||
后端基于 **SpringBoot3** 构建，具备高内聚、低耦合的特性，支持分布式部署。
|
||||
前端覆盖PC、H5、小程序和APP，基于 **Vue** 和 **uni-app** 开发。
|
||||
|
||||
- **官方网站**: <https://pickmall.cn>
|
||||
- **官方文档**: <https://docs.pickmall.cn>
|
||||
- **Gitee 仓库**: <https://gitee.com/beijing_hongye_huicheng/lilishop>
|
||||
- **GitHub 仓库**: <https://github.com/lilishop/lilishop>
|
||||
|
||||
|
||||
#### PS： **演示站点所有环境均部署master分支。如果有演示站点问题，可以反馈，如果演示站点没问题本地运行有问题，需自行处理**
|
||||
---
|
||||
|
||||
### 2. 核心特性
|
||||
|
||||
- **全端覆盖**: 一套代码库支持PC、H5、小程序、APP，降低开发和维护成本。
|
||||
- **商家入驻**: 支持多商家入驻，构建平台化电商生态。
|
||||
- **分布式架构**: 后端API服务化，支持独立部署和弹性伸缩。
|
||||
- **前后端分离**: 清晰的职责划分，便于团队协作和独立开发。
|
||||
- **容器化支持**: 提供Docker镜像和docker-compose配置，实现一键部署。
|
||||
- **功能完善**: 涵盖客户、订单、商品、促销、店铺、运营、统计等完整电商业务模块。
|
||||
|
||||
---
|
||||
|
||||
### 3. 在线演示
|
||||
|
||||
**注意**: 演示站手机验证码统一为 `111111`。演示环境部署于 `master` 分支。
|
||||
|
||||
- **平台管理端**: <https://admin-b2b2c.pickmall.cn>
|
||||
- 账号: `admin`
|
||||
- 密码: `123456`
|
||||
- **店铺管理端**: <https://store-b2b2c.pickmall.cn>
|
||||
- 账号: `13011111111`
|
||||
- 密码: `111111`
|
||||
- **商城PC端**: <https://pc-b2b2c.pickmall.cn>
|
||||
- **微信小程序**:
|
||||
|
||||
|
||||
---
|
||||
|
||||
### 4. 快速开始
|
||||
|
||||
#### 环境准备与部署
|
||||
详细的本地部署指南，请参考官方文档：
|
||||
[**部署文档 -> 环境准备**](https://docs.pickmall.cn/deply/deply.html)
|
||||
|
||||
#### 数据库初始化
|
||||
- **推荐方式**: 使用项目提供的 `docker-compose` 配置，可自动完成数据库（MySQL, Redis, Elasticsearch等）的部署与初始化。
|
||||
- **手动方式**: 如果您选择手动部署，SQL脚本位于以下地址。请确保获取与您代码版本一致的SQL文件。
|
||||
[**数据库脚本 (Gitee)**](https://gitee.com/beijing_hongye_huicheng/docker/tree/master/init/mysql)
|
||||
|
||||
---
|
||||
|
||||
### 5. 技术架构
|
||||
|
||||
#### 5.1 架构图
|
||||
|
||||
|
||||
#### 5.2 后端技术栈
|
||||
|
||||
| 技术 | 选型 | 版本 | 备注/用途 |
|
||||
| :-------------- | :-------------- | :----- | :--------- |
|
||||
| 核心框架 | Spring Boot | 3.5.6 | 简化应用开发 |
|
||||
| ORM框架 | MyBatis-Plus | 3.5.8 | 数据持久化 |
|
||||
| 数据库 | MySQL (LTS) | 8.3.0 | 关系型数据存储 |
|
||||
| 消息队列 | RocketMQ | 2.3.4 | 异步任务与解耦 |
|
||||
| 缓存 | Redis | - | 数据缓存 |
|
||||
| 搜索引擎 | Elasticsearch | - | 商品搜索 |
|
||||
| 安全框架 | Spring Security | - | 认证与授权 |
|
||||
| 分库分表 | ShardingSphere | 4.0.0 | 数据水平扩展 |
|
||||
| 定时任务 | XXL-Job | 2.3.0 | 分布式任务调度 |
|
||||
| 认证方案 | JWT | - | Token 方案 |
|
||||
|
||||
#### 5.3 前端技术栈
|
||||
|
||||
**管理端 (平台/商家)**
|
||||
|
||||
| 技术 | 选型 | 备注/用途 |
|
||||
| :--------- | :--------- | :--------- |
|
||||
| JS框架 | Vue.js | 核心框架 |
|
||||
| UI库 | iView | 界面组件 |
|
||||
| 状态管理 | Vuex | 全局状态管理 |
|
||||
| 路由 | Vue Router | 页面路由 |
|
||||
| HTTP客户端 | axios | API请求 |
|
||||
|
||||
**移动端 (H5/小程序/APP)**
|
||||
|
||||
| 技术 | 选型 | 备注/用途 |
|
||||
| :-------- | :------ | :------------- |
|
||||
| 核心框架 | uni-app | 跨平台开发框架 |
|
||||
| UI库 | uViewUI | 丰富的组件库 |
|
||||
| CSS预处理 | SCSS | 样式开发 |
|
||||
|
||||
### 6.功能列表
|
||||
|
||||
[功能清单](https://bdwx2tfwwt.feishu.cn/sheets/FFQKscQKDhUx60to1k9cbMngnYb?from=from_copylink)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### 7. 开源与授权
|
||||
|
||||
1. **开源协议**: 本项目遵循 `AGPL-3.0` 开源协议。
|
||||
2. **使用范围**: 仅允许用于个人学习、研究和非商业用途。
|
||||
3. **禁止行为**: 禁止将本项目的代码和资源用于任何形式的商业销售。
|
||||
4. **商业授权**: 如需商业使用，必须获得官方授权。授权为一次性永久授权，并提供持续的版本升级服务。详情请联系官网客服。
|
||||
5. **软件著作权**: 本软件受国家计算机软件著作权保护（登记号：2021SR0805085）。
|
||||
|
||||
---
|
||||
|
||||
### 8. 社区与支持
|
||||
|
||||
我们欢迎任何形式的交流与贡献。在提问前，请先查阅 [官方文档](https://docs.pickmall.cn/) ，并参考 [《提问的智慧》](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/master/README-zh_CN.md) 以便高效沟通。
|
||||
|
||||
- **[在线客服](https://work.weixin.qq.com/kfid/kfc4d8dc24a73c15f44)**
|
||||
- **微信交流1群（已满）**
|
||||
- **微信交流2群**:
|
||||
|
||||
|
||||
##### 体验 公众号/小程序/APP 体验，扫描二维码
|
||||
|
||||
|
||||
|
||||
[](https://gitee.com/beijing_hongye_huicheng/lilishop/stargazers)
|
||||
|
||||
|
||||
## 2025-10-10日更新
|
||||
兼容更高的node版本16
|
||||
|
||||
这里我用的是node版本 v16.20.2
|
||||
|
||||
npm版本 8.19.4
|
||||
|
||||
使用yarn install 然后执行 yarn dev
|
||||
|
||||
yarn 安装/启动
|
||||
```
|
||||
// 如果没有 yarn 安装yarn
|
||||
npm install yarn -g
|
||||
|
||||
// 切换源
|
||||
yarn config set registry https://registry.npmmirror.com
|
||||
|
||||
// 以buyer项目为例
|
||||
cd buyer
|
||||
|
||||
yarn install
|
||||
|
||||
yarn dev
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
没有二开过的项目直接拉最新代码即可，二开项目可以跟着提交记录一起同步修改 install出现问题检查的话删除 "package-lock.json" 重新install
|
||||
|
||||
Q&A 为什么不升级更高的node版本？ :因为高node版本 OpenSSL 改动 导致旧版本 Webpack 插件会失效 试了好几次如果兼容的话 需要升级Webpack5以及其他的插件 升级内容较多 为了更稳定的还是尽量少动为主
|
||||
|
||||
****
|
||||
|
||||
|
||||
## 如何在本地环境运行lilishop-ui部署视频
|
||||
https://www.bilibili.com/video/BV1B28EeJEnP/
|
||||
|
||||
## 如何在服务器上部署lilishop-ui
|
||||
https://www.bilibili.com/video/BV1WD87eoE9F/
|
||||
|
||||
|
||||
## 开发项目
|
||||
|
||||
#### 安装Node.js
|
||||
|
||||
保证`node`版本`14`,推荐 14.17.0
|
||||
|
||||
2025-10-10日拉的代码之后不限制于node版本为14，这里只是以14版本为例子
|
||||
|
||||
可以使用 `yarn` 或者 `npm` 进行安装
|
||||
|
||||
#### yarn 安装/启动
|
||||
```
|
||||
// 如果没有 yarn 安装yarn
|
||||
npm install yarn -g
|
||||
|
||||
// 切换源
|
||||
yarn config set registry https://registry.npmmirror.com
|
||||
|
||||
// 以buyer项目为例
|
||||
cd buyer
|
||||
|
||||
yarn install
|
||||
|
||||
yarn dev
|
||||
```
|
||||
|
||||
|
||||
#### FAQ
|
||||
|
||||
##### npmmirror镜像源报错 451 Unavailable For Legal Reasons
|
||||
```
|
||||
//切换其他的镜像源
|
||||
|
||||
// npm
|
||||
npm config set registry http://mirrors.cloud.tencent.com/npm/
|
||||
|
||||
// yarn
|
||||
yarn config set registry http://mirrors.cloud.tencent.com/npm/
|
||||
```
|
||||
|
||||
##### 安装不上去
|
||||
|
||||
可以按照这个思路排查一下
|
||||
|
||||
```
|
||||
1. 看下Node.js 是否是14.17.0
|
||||
2. 项目目录下是否有 package-lock.json 或者 .npmrc 或者 .yarnrc 设置了镜像源， 如果有可以删除重新install
|
||||
3. 切换当前 npm 或者 yarn 镜像源重试
|
||||
```
|
||||
|
||||
|
||||
### 商城介绍
|
||||
**官网**：https://pickmall.cn
|
||||
|
||||
Lilishop商城系统支持商家入驻，后端基于SpringBoot 研发，前端使用 Vue、uniapp开发， **系统全端全部代码开源**
|
||||
|
||||
前后端分离，支持分布式部署，支持Docker，各个API独立，并且有独立的消费者。
|
||||
|
||||
### 商城 API/消费者 聚合版
|
||||
api不需要单独部署，只需启动一个jar包就可以正常运转 如有需要，可以点击跳转
|
||||
https://gitee.com/beijing_hongye_huicheng/lilishop-simplify
|
||||
|
||||
### 开发/使用/常见问题 帮助文档
|
||||
|
||||
https://docs.pickmall.cn
|
||||
|
||||
### 项目地址
|
||||
|
||||
gitee : https://gitee.com/beijing_hongye_huicheng
|
||||
|
||||
github 镜像: https://github.com/lilishop?tab=repositories
|
||||
|
||||
商城UI 项目下3个文件夹
|
||||
buyer：买家PC端，seller：商家端，manager：后台管理端
|
||||
|
||||
|
||||
### 演示地址
|
||||
PS：手机验证码为 ‘111111’
|
||||
|
||||
**平台管理端**：https://admin-b2b2c.pickmall.cn 账号：admin/123456
|
||||
|
||||
**店铺管理端**：https://store-b2b2c.pickmall.cn 账号：13011111111/111111
|
||||
|
||||
**商城PC页面**：https://pc-b2b2c.pickmall.cn
|
||||
|
||||
**商城 小程序/公众号/APP**：扫描二维码
|
||||
|
||||
|
||||
|
||||
### 快速本地部署
|
||||
|
||||
[点击跳转](https://docs.pickmall.cn/deploy/%E8%BF%90%E8%A1%8C%E7%8E%AF%E5%A2%83%E5%87%86%E5%A4%87.html)
|
||||
|
||||
**商城数据库**
|
||||
使用docker-compose部署数据库，自动初始化数据库，不需要手动下载等操作
|
||||
|
||||
如果手动部署，才需要获取sql [点击跳转](https://gitee.com/beijing_hongye_huicheng/docker/tree/master/init/mysql) （PS：这里有与tag版本一致的sql，如果是历史版本，则docker项目也切换至历史版本获取sql即可，历史版本升级则根据java相聚的根目录DB目录下的升级sql，按需执行）。
|
||||
|
||||
|
||||
|
||||
### 功能列表
|
||||
|
||||
|
||||
|
||||
#### 平台管理端功能
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
#### 卖家功能
|
||||
|
||||
|
||||
|
||||
|
||||
### 商城前端功能展示
|
||||
|
||||
#### 商城移动端
|
||||
|
||||
<img src="https://static.pickmall.cn/images/other/app.gif" alt="移动端功能展示" style="zoom:50%;" />
|
||||
|
||||
#### 平台管理端
|
||||
|
||||
|
||||
|
||||
|
||||
### 技术选型
|
||||
|
||||
#### 架构图
|
||||
|
||||
|
||||
|
||||
##### 后台技术选型
|
||||
|
||||
| 说明 | 框架 | 说明 | |
|
||||
| -------------- | --------------- | -------------- | ------------- |
|
||||
| 基础框架 | Spring Boot | MVC框架 | Spring MVC |
|
||||
| 持久框架 | Mybatis-Plus | 程序构建 | Maven |
|
||||
| 关系型数据库 | MySQL | 消息中间件AMQP | RocketMQ |
|
||||
| 缓存 | Redis +MongoDB | 搜索引擎 | Elasticsearch |
|
||||
| 安全框架 | Spring Security | 数据库连接池 | Druid |
|
||||
| 数据库分库分表 | sharding | 定时任务 | xxl-job |
|
||||
| 负载均衡 | Nginx | 静态资源 | 阿里云OSS |
|
||||
| 短信 | 阿里云短信 | 认证 | JWT |
|
||||
| 日志处理 | Log4j | 接口规范 | RESTful |
|
||||
|
||||
##### 前端-运营后台、店铺后台
|
||||
|
||||
| 说明 | 框架 | 说明 | 框架 |
|
||||
| ---------- | ---------- | ---------- | ------- |
|
||||
| 构建工具 | webpack | JS版本 | ES6 |
|
||||
| 基础JS框架 | Vue.js | 视频播放器 | Dplayer |
|
||||
| 路由管理 | Vue Router | 状态管理 | Vuex |
|
||||
| 基础UI库 | iView | UI界面基于 | iView |
|
||||
| 网络请求 | axios | | |
|
||||
|
||||
##### 前端-移动端
|
||||
|
||||
| 说明 | 架构 | 说明 | 架构 |
|
||||
| --------- | ------- | -------- | ------- |
|
||||
| 基础UI库 | uViewui | 基础框架 | uni-app |
|
||||
| CSS预处理 | scss | 地图引擎 | amap |
|
||||
|
||||
### 版本升级
|
||||
|
||||
```
|
||||
系统后续会提供多场景解决方案。
|
||||
更多架构：微服务、Saas、中台等，都会支持。 支持差价升级商业授权
|
||||
```
|
||||
|
||||
### 商业授权
|
||||
商业版本与开源版本代码一致，没有区分
|
||||
|
||||
商业使用需要授权，授权方式可选择联系官网客服，或者qq群联系群主。
|
||||
|
||||
商业授权模式为永久授权，支持永久升级。
|
||||
|
||||
商业案例由于涉及部分多层二开关系，如需了解可以咨询销售。
|
||||
|
||||
|
||||
### 开源须知
|
||||
1.仅允许用于个人学习研究使用.
|
||||
|
||||
2.禁止将本开源的代码和资源进行任何形式任何名义的出售.
|
||||
|
||||
3.软件受国家计算机软件著作权保护（登记号：2021SR0805085）。
|
||||
|
||||
4.限制商用，如果需要商业使用请联系我们。QQ3409056806.或者加入qq群联系群主。
|
||||
|
||||
### 附录
|
||||
有人有自己的学习视频、学习记录文档、希望宣传关联开源项目等均可以私聊仓库所有者。
|
||||
|
||||
类似：
|
||||
|
||||
清晨敲代码同学的分析: https://blog.csdn.net/vaevaevae233/category_12103567.html
|
||||
|
||||
Reference in New Issue
Block a user