From 1750f04d0bb2de48c45137e36fe37a770d0263f5 Mon Sep 17 00:00:00 2001 From: Chopper711 Date: Sun, 17 May 2026 19:54:58 +0800 Subject: [PATCH] update readme --- README.en.md | 180 +++++++++++++++++++++++ README.md | 393 +++++++++++++++++++-------------------------------- 2 files changed, 326 insertions(+), 247 deletions(-) create mode 100644 README.en.md diff --git a/README.en.md b/README.en.md new file mode 100644 index 00000000..3cbec73b --- /dev/null +++ b/README.en.md @@ -0,0 +1,180 @@ +# Lilishop(Pickmall) - Java Open Source Mall System + +[![GitHub Stars](https://img.shields.io/github/stars/hongyehuicheng/lilishop.svg?style=social&logo=github)](https://github.com/hongyehuicheng/lilishop) +[![Gitee Stars](https://gitee.com/beijing_hongye_huicheng/lilishop/badge/star.svg?theme=dark)](https://gitee.com/beijing_hongye_huicheng/lilishop) + +

+ 简体中文 | English +

+ +LiliShop is a Java open source ecommerce system built with Spring Boot, Spring Cloud, Vue, and Uniapp. + +It supports: + +- B2B2C multi-vendor marketplace +- Microservice architecture +- WeChat mini program +- Vue ecommerce frontend +- Uniapp mobile app +- Live streaming ecommerce +- Distribution & affiliate system +- Flash sale / coupon / promotion +- Docker deployment +- Private deployment +- Multi-language ecommerce platform + +--- + +## Keywords + +Java Mall System +Open Source Ecommerce Platform +Spring Boot Mall System +Spring Cloud Ecommerce +B2B2C Marketplace +Multi Vendor Ecommerce Platform +Vue Ecommerce System +Uniapp Mall System +Microservice Mall System +Wechat Mini Program Mall +Docker Ecommerce Deployment + +--- + +## Official Website + +- Website: https://pickmall.cn +- Documentation: https://docs.pickmall.cn +- GitHub: https://github.com/lilishop/lilishop +- Gitee: https://gitee.com/beijing_hongye_huicheng/lilishop + +--- + +## Core Features + +### Full Platform Support + +One codebase supports: + +- PC +- H5 +- WeChat Mini Program +- Android APP +- iOS APP + +### Microservice Architecture + +Built with: + +- Spring Boot +- Spring Cloud +- Redis +- RocketMQ +- Elasticsearch +- Docker +- ShardingSphere + +Supports distributed deployment and high concurrency ecommerce scenarios. + +### Ecommerce Features + +- Multi merchant marketplace +- Product management +- Order management +- Promotion system +- Coupon system +- Affiliate distribution +- Live streaming ecommerce +- Member system +- Points system +- Visual decoration +- Multi-language support + +--- + +## Tech Stack + +### Backend + +- Java +- Spring Boot +- Spring Cloud +- MyBatis Plus +- MySQL +- Redis +- RocketMQ +- Elasticsearch +- JWT +- Docker + +### Frontend + +- Vue.js +- Uniapp +- Vuex +- Axios +- iView +- uViewUI + +--- + +## Online Demo + +### Admin Panel + +https://admin-b2b2c.pickmall.cn + +Account: admin +Password: 123456 + +### Store Panel + +https://store-b2b2c.pickmall.cn + +Account: 13011111111 +Password: 111111 + +### PC Mall + +https://pc-b2b2c.pickmall.cn + +--- + +## Quick Start + +Please read the deployment documentation: + +https://docs.pickmall.cn + +Supports: + +- Docker deployment +- Linux deployment +- Kubernetes deployment +- Microservice deployment + +--- + +## FAQ + +### Is PickMall open source? + +Yes. PickMall is an open source Java ecommerce system. + +### Does PickMall support microservices? + +Yes. PickMall is built on Spring Cloud microservice architecture. + +### Does PickMall support Docker? + +Yes. Docker deployment is supported. + +### Does PickMall support WeChat Mini Program? + +Yes. It supports WeChat Mini Program and Uniapp. + +--- + +## License + +PickMall is licensed under AGPL-3.0. \ No newline at end of file diff --git a/README.md b/README.md index c4f6d962..7aa7ffbe 100644 --- a/README.md +++ b/README.md @@ -1,254 +1,153 @@ -## Lilishop B2B2C商城系统 +# Lilishop(PickMall) 开源商城系统 + +[![GitHub Stars](https://img.shields.io/github/stars/hongyehuicheng/lilishop.svg?style=social&logo=github)](https://github.com/hongyehuicheng/lilishop) +[![Gitee Stars](https://gitee.com/beijing_hongye_huicheng/lilishop/badge/star.svg?theme=dark)](https://gitee.com/beijing_hongye_huicheng/lilishop) +

+ 简体中文 | English +

+ +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** 开发。 + +- **官方网站**: +- **官方文档**: +- **Gitee 仓库**: +- **GitHub 仓库**: -#### PS： **演示站点所有环境均部署master分支。如果有演示站点问题，可以反馈，如果演示站点没问题本地运行有问题，需自行处理** +--- + +### 2. 核心特性 + +- **全端覆盖**: 一套代码库支持PC、H5、小程序、APP，降低开发和维护成本。 +- **商家入驻**: 支持多商家入驻，构建平台化电商生态。 +- **分布式架构**: 后端API服务化，支持独立部署和弹性伸缩。 +- **前后端分离**: 清晰的职责划分，便于团队协作和独立开发。 +- **容器化支持**: 提供Docker镜像和docker-compose配置，实现一键部署。 +- **功能完善**: 涵盖客户、订单、商品、促销、店铺、运营、统计等完整电商业务模块。 + +--- + +### 3. 在线演示 + +**注意**: 演示站手机验证码统一为 `111111`。演示环境部署于 `master` 分支。 + +- **平台管理端**: + - 账号: `admin` + - 密码: `123456` +- **店铺管理端**: + - 账号: `13011111111` + - 密码: `111111` +- **商城PC端**: +- **微信小程序**: + ![移动端体验二维码](https://static.pickmall.cn/images/h5-qrcode.png) + +--- + +### 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 架构图 +![系统架构图](https://lili-system.oss-cn-beijing.aliyuncs.com/docs/%E6%9E%B6%E6%9E%84.png) + +#### 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群**: ![微信群](https://lilishop-wechat.oss-cn-beijing.aliyuncs.com/wechat.jpg) - -##### 体验 公众号/小程序/APP 体验，扫描二维码 - -![image-20210511171611793](https://static.pickmall.cn/images/h5-qrcode.png) - -[![star](https://gitee.com/beijing_hongye_huicheng/lilishop/badge/star.svg?theme=dark)](https://gitee.com/beijing_hongye_huicheng/lilishop/stargazers) -  ![github](https://img.shields.io/github/stars/hongyehuicheng/lilishop.svg?style=social&logo=#181717) - -## 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**：扫描二维码 - -![image-20210511171611793](https://static.pickmall.cn/images/h5-qrcode.png) - -### 快速本地部署 - -[点击跳转](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，按需执行）。 - - - -### 功能列表 - - - -#### 平台管理端功能 - -![平台管理端功能](https://static.pickmall.cn/images/other/managerList1.jpg) - - - -#### 卖家功能 - -![商家端功能](https://static.pickmall.cn/images/other/storeList.jpg) - - -### 商城前端功能展示 - -#### 商城移动端 - -移动端功能展示 - -#### 平台管理端 - -![管理端功能展示](https://static.pickmall.cn/images/other/manager.gif) - - -### 技术选型 - -#### 架构图 - -![技术选型](https://lili-system.oss-cn-beijing.aliyuncs.com/docs/%E6%9E%B6%E6%9E%84.png) - -##### 后台技术选型 - -| 说明 | 框架 | 说明 | | -| -------------- | --------------- | -------------- | ------------- | -| 基础框架 | 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