mirror of
https://gitee.com/beijing_hongye_huicheng/lilishop-ui.git
synced 2026-11-07 17:38:55 +08:00
docs: 更新项目 README 与开源许可说明
This commit is contained in:
pikachu1995@126.com
251
README.md
251
README.md
@@ -1,158 +1,181 @@
|
||||
# Lilishop(PickMall) 开源商城系统
|
||||
<div align="center">
|
||||
<img src="./manager/src/assets/logo.png" width="180" alt="Lilishop Logo" />
|
||||
<h1>Lilishop(PickMall) 开源商城系统 - Web 前端 (Vue 3)</h1>
|
||||
|
||||
[](https://github.com/lilishop/lilishop)
|
||||
[](https://gitee.com/beijing_hongye_huicheng/lilishop)
|
||||
[](./LICENSE)
|
||||
[](https://vuejs.org/)
|
||||
<p>
|
||||
<a href="https://github.com/lilishop/lilishop"><img src="https://img.shields.io/github/stars/lilishop/lilishop.svg?style=social&logo=github" alt="GitHub Stars" /></a>
|
||||
<a href="https://gitee.com/beijing_hongye_huicheng/lilishop"><img src="https://gitee.com/beijing_hongye_huicheng/lilishop/badge/star.svg?theme=dark" alt="Gitee Stars" /></a>
|
||||
<a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License" /></a>
|
||||
<a href="https://vuejs.org/"><img src="https://img.shields.io/badge/Vue-3.5-brightgreen.svg" alt="Vue 3" /></a>
|
||||
<a href="https://element-plus.org/"><img src="https://img.shields.io/badge/Element%20Plus-2.x-409EFF.svg" alt="Element Plus" /></a>
|
||||
<a href="https://pinia.vuejs.org/"><img src="https://img.shields.io/badge/Pinia-4.x-yellow.svg" alt="Pinia" /></a>
|
||||
</p>
|
||||
|
||||
<p align="right">
|
||||
简体中文 | <a href="./README.en.md">English</a>
|
||||
</p>
|
||||
<p>
|
||||
<a href="https://pickmall.cn">🏠 官方网站</a> ·
|
||||
<a href="https://bdwx2tfwwt.feishu.cn/wiki/space/7675179368632617952?ccm_open_type=lark_wiki_spaceLink&open_tab_from=wiki_home">📖 产品文档</a> ·
|
||||
<a href="#2-在线演示">💻 在线演示</a> ·
|
||||
<a href="#7-社区与支持">💬 微信交流群</a>
|
||||
</p>
|
||||
|
||||
<p>
|
||||
<b>简体中文</b> | <a href="./README.en.md">English</a>
|
||||
</p>
|
||||
</div>
|
||||
|
||||
LILISHOP 是基于 Spring Boot / Spring Cloud / Vue / Uniapp 开发的 Java 开源商城系统，支持 B2B2C 多商户商城、小程序商城、微服务商城、直播电商、分销返佣、秒杀活动、Docker 私有化部署。
|
||||
> ⭐ **如果觉得项目不错，请点击右上角 `Star` 收藏支持！您的 Star 是我们持续开源迭代的最大动力！**
|
||||
|
||||
## 核心特性
|
||||
**LILISHOP** 是基于 Spring Boot / Vue 3 / uni-app 开发的开源商城系统，支持 B2B2C 多商户商城、微信小程序商城、H5 商城、APP 商城、直播电商、分销返佣、秒杀活动。
|
||||
|
||||
- Java商城系统
|
||||
- 开源商城系统
|
||||
- Spring Boot 4商城系统
|
||||
- SpringCloud微服务商城
|
||||
- B2B2C商城源码
|
||||
- 多商户商城系统
|
||||
- 小程序商城源码
|
||||
- Uniapp商城系统
|
||||
- Vue商城系统
|
||||
- Docker商城部署
|
||||
- 多语言商城
|
||||
|
||||
适用于：
|
||||
|
||||
- 企业级商城系统
|
||||
- 私有化商城部署
|
||||
- Java商城系统二次开发
|
||||
- 开源商城源码学习
|
||||
- 多商户电商平台
|
||||
---
|
||||
|
||||
### 1. 项目简介
|
||||
|
||||
**Lilishop** 是一款功能完善的B2B2C多商户商城系统，采用前后端分离架构，全端代码开源。
|
||||
后端基于 **Spring Boot 4**（Java 21）构建，具备高内聚、低耦合的特性，支持分布式部署。
|
||||
前端覆盖PC、H5、小程序和APP，基于 **Vue** 和 **uni-app** 开发。
|
||||
|
||||
- **官方网站**: <https://pickmall.cn>
|
||||
- **官方文档**: <https://docs.pickmall.cn>
|
||||
- **Gitee 仓库**: <https://gitee.com/beijing_hongye_huicheng/lilishop-ui>
|
||||
- **GitHub 仓库**: <https://github.com/lilishop/lilishop>
|
||||
|
||||
本仓库为 **PC / 商家端 / 运营端 / IM Web** 源码（`lilishop-ui`）。
|
||||
### ✨ 为什么选择 Lilishop
|
||||
- 🟢 **真 MIT 协议**：支持免费商用与私有化闭源二开，无版权后顾之忧。
|
||||
- 🚀 **Vue 3 全新栈**：全面基于 `Vue 3.5 + Pinia 4 + Vue Router 4 + Element Plus` 构建，告别老旧 Vue 2 架构。
|
||||
- 🧩 **四端合一生产级闭环**：完整覆盖 **PC 买家端 (`buyer`)**、**商家端 (`seller`)**、**平台运营管理端 (`manager`)** 与 **在线客服端 (`im`)**，支持拖拽式可视化楼层装修与多维数据统计报表。
|
||||
|
||||
---
|
||||
|
||||
### 2. 核心特性
|
||||
## 1. 项目简介
|
||||
|
||||
- **全端覆盖**: 一套代码库支持PC、H5、小程序、APP，降低开发和维护成本。
|
||||
- **商家入驻**: 支持多商家入驻，构建平台化电商生态。
|
||||
- **分布式架构**: 后端API服务化，支持独立部署和弹性伸缩。
|
||||
- **前后端分离**: 清晰的职责划分，便于团队协作和独立开发。
|
||||
- **容器化支持**: 提供Docker镜像和docker-compose配置，实现一键部署。
|
||||
- **功能完善**: 涵盖客户、订单、商品、促销、店铺、运营、统计等完整电商业务模块。
|
||||
**Lilishop** 是一款功能完善的 B2B2C 多商户商城系统，采用前后端分离架构，全端代码开源。
|
||||
后端基于 **Spring Boot 4**（Java 21）构建，具备高内聚、低耦合的特性，支持分布式部署；前端覆盖 PC、管理后台、H5、小程序和 APP，基于 **Vue 3** 和 **uni-app** 开发。
|
||||
|
||||
本仓库（`lilishop-ui`）为 **Web 前端源码仓库**，包含 **PC 商城端、商家后台、平台管理后台、IM 在线客服** 四个独立子工程。
|
||||
|
||||
- **官方网站**: <https://pickmall.cn>
|
||||
- **官方文档**: [产品文档](https://bdwx2tfwwt.feishu.cn/wiki/space/7675179368632617952?ccm_open_type=lark_wiki_spaceLink&open_tab_from=wiki_home)
|
||||
- **Gitee 仓库**: <https://gitee.com/beijing_hongye_huicheng>
|
||||
- **GitHub 主仓库**: <https://github.com/lilishop/lilishop>
|
||||
|
||||
---
|
||||
|
||||
### 3. 在线演示
|
||||
## 2. 在线演示
|
||||
|
||||
**注意**: 演示站手机验证码统一为 `111111`。演示环境部署于 `master` 分支。
|
||||
> **注意**: 演示站手机验证码统一为 `111111`。演示环境部署于 `master` 分支。
|
||||
|
||||
- **平台管理端**: <https://admin-b2b2c.pickmall.cn>
|
||||
- 账号: `admin`
|
||||
- 密码: `123456`
|
||||
- **店铺管理端**: <https://store-b2b2c.pickmall.cn>
|
||||
- 账号: `13011111111`
|
||||
- 密码: `111111`
|
||||
- **商城PC端**: <https://pc-b2b2c.pickmall.cn>
|
||||
- **微信小程序**:
|
||||
|
||||
| 演示站点 | 访问地址 | 演示账号 |
|
||||
| :--- | :--- | :--- |
|
||||
| **平台运营管理端 (`manager`)** | <https://admin-b2b2c.pickmall.cn> | 账号：`admin` / 密码：`123456` |
|
||||
| **商家店铺管理端 (`seller`)** | <https://store-b2b2c.pickmall.cn> | 账号：`13011111111` / 密码：`111111` |
|
||||
| **商城 PC 买家端 (`buyer`)** | <https://pc-b2b2c.pickmall.cn> | 可使用手机号验证码 `111111` 登录 |
|
||||
| **移动端 H5 (`uni-app`)** | <https://m-b2b2c.pickmall.cn> | 可使用手机号验证码 `111111` 登录 |
|
||||
|
||||
| 微信小程序 | 移动端 H5（[点击直接访问](https://m-b2b2c.pickmall.cn)） |
|
||||
| :---: | :---: |
|
||||
| <img src="https://static.pickmall.cn/images/h5-qrcode.png" width="180" alt="微信小程序体验码" /> | <img src="https://lilishop-wechat.oss-cn-beijing.aliyuncs.com/h5-qrcode.png" width="180" alt="移动端 H5 体验二维码" /> |
|
||||
| 微信扫码体验小程序 | 手机扫码或访问 <https://m-b2b2c.pickmall.cn> |
|
||||
|
||||
---
|
||||
|
||||
### 4. 快速开始
|
||||
## 3. 核心特性与技术栈
|
||||
|
||||
#### 环境准备与部署
|
||||
详细的本地部署指南，请参考官方文档：
|
||||
[**部署文档 -> 环境准备**](https://docs.pickmall.cn/deply/deply.html)
|
||||
### 核心特性
|
||||
- **四端协同**: 涵盖平台管理端、商家管理端、PC 买家商城端、IM 客服端，角色边界清晰，开箱即用。
|
||||
- **可视化拖拽装修**: 管理端与商家端内置可视化楼层编辑器（基于 `vuedraggable`），可同步配置 PC 端与移动端首页/专题页。
|
||||
- **多商户入驻与结算**: 完整的商家入驻审核、商品审核、拆单发货、促销报名、财务对账与结算台账体系。
|
||||
- **多维经营分析**: 集成 `@antv/g2` 图表引擎，提供营业概况、商品同比环比、会员分析、营销与分销数据统计。
|
||||
- **即时通讯客服**: 集成腾讯云 IM / WebSocket 在线客服系统，支持买家、商家与平台实时沟通。
|
||||
|
||||
#### 数据库初始化
|
||||
- **推荐方式**: 使用项目提供的 `docker-compose` 配置，可自动完成数据库（MySQL、Redis 等）的部署与初始化。
|
||||
- **手动方式**: 如果您选择手动部署，SQL脚本位于以下地址。请确保获取与您代码版本一致的SQL文件。
|
||||
[**数据库脚本 (Gitee)**](https://gitee.com/beijing_hongye_huicheng/docker/tree/master/init/mysql)
|
||||
### Web 前端技术栈
|
||||
| 类别 | 技术选型 | 说明 |
|
||||
| :--- | :--- | :--- |
|
||||
| 核心框架 | `Vue 3.5` + `Vue Router 4` | 基于 Composition API 的现代响应式前端框架 |
|
||||
| 状态管理 | `Pinia 4` | 轻量、类型友好的 Vue 3 官方状态管理库 |
|
||||
| UI 组件库 | `Element Plus 2.x` | 企业级中后台与桌面端 UI 组件库 |
|
||||
| 网络请求 | `Axios 1.x` | 统一请求/响应拦截、Token 刷新与异常提示 |
|
||||
| 数据可视化 | `@antv/g2` | 运营端与商家端数据统计图表渲染 |
|
||||
| 可视化拖拽 | `vuedraggable 4` | 商城首页及专题楼层可视化拖拽装修 |
|
||||
| 即时通讯 | `@tencentcloud/chat` / `sockjs-client` | 在线客服消息收发与实时通知 |
|
||||
| 音视频播放 | `dplayer` + `hls.js` | 商品视频与直播流播放支持 |
|
||||
| 构建与样式 | `Vue CLI 5` + `Webpack 5` + `Sass / Less` | 模块化工程构建与全局主题样式定制 |
|
||||
|
||||
---
|
||||
|
||||
### 5. 架构文档边界
|
||||
## 4. 目录结构
|
||||
|
||||
本仓库首页不再维护不完整的系统架构图和技术栈表，避免与实际源码、部署形态和分支差异产生偏差。当前仓库主要说明 PC / 商家端 / 运营端 / IM Web 前端源码定位、在线演示和部署入口。
|
||||
|
||||
完整架构请以官方文档及四个源码仓库为准：
|
||||
|
||||
- 后端源码：`lilishop`
|
||||
- PC / 商家端 / 运营端 / IM Web：`lilishop-ui`
|
||||
- H5 / 小程序 / APP：`lilishop-uniapp`
|
||||
- 部署、SQL、镜像与启动脚本：`docker`
|
||||
```text
|
||||
lilishop-ui
|
||||
├── buyer/ # 【PC 买家商城端】源码工程
|
||||
│ ├── public/ # 静态资源与全局配置文件 (config.js)
|
||||
│ └── src/
|
||||
│ ├── api/ # 买家端接口定义（商品、购物车、订单、会员、促销等）
|
||||
│ ├── components/ # 公共业务组件（楼层渲染、导航栏、商品卡片等）
|
||||
│ ├── pages/ # PC 商城各业务页面（首页、商品详情、结算、个人中心等）
|
||||
│ ├── router/ # 路由配置与守卫
|
||||
│ ├── stores/ # Pinia 状态管理
|
||||
│ └── utils/ # 请求封装与通用工具函数
|
||||
├── seller/ # 【商家店铺管理端】源码工程
|
||||
│ ├── public/ # 静态资源与全局配置
|
||||
│ └── src/
|
||||
│ ├── api/ # 商家端接口定义
|
||||
│ ├── components/ # 商家端公共组件与装修组件
|
||||
│ ├── views/ # 商家端业务视图（商品管理、订单发货、售后、促销、店铺设置、统计等）
|
||||
│ ├── router/ # 动态权限路由
|
||||
│ └── stores/ # Pinia 状态管理
|
||||
├── manager/ # 【平台运营管理端】源码工程
|
||||
│ ├── public/ # 静态资源与全局配置
|
||||
│ └── src/
|
||||
│ ├── api/ # 运营端接口定义
|
||||
│ ├── components/ # 平台公共组件、富文本、可视化楼层装修编辑器
|
||||
│ ├── views/ # 运营端业务视图（会员、商品、订单、商家、营销、分销、财务、统计、系统设置）
|
||||
│ ├── router/ # 菜单与权限路由
|
||||
│ └── stores/ # Pinia 状态管理
|
||||
├── im/ # 【IM 在线客服 Web 端】源码工程
|
||||
│ └── src/
|
||||
│ ├── api/ # 客服会话与消息接口
|
||||
│ ├── components/ # 聊天窗口、消息列表、商品/订单卡片组件
|
||||
│ ├── im-server/ # WebSocket / IM 连接服务管理
|
||||
│ └── views/ # 客服工作台页面
|
||||
├── build.sh # 多端统一构建脚本
|
||||
└── docker-build.sh # Docker 镜像构建脚本
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 6. 功能列表
|
||||
## 5. 配套源码仓库
|
||||
|
||||
[功能清单](https://bdwx2tfwwt.feishu.cn/sheets/FFQKscQKDhUx60to1k9cbMngnYb?from=from_copylink)
|
||||
本仓库专注于 **PC / 商家端 / 运营端 / IM Web**（`lilishop-ui`）。完整系统由以下四个核心仓库组成：
|
||||
|
||||
| 仓库名称 | 职责说明 | 仓库地址 |
|
||||
| :--- | :--- | :--- |
|
||||
| **`lilishop`** | 后端服务源码（Spring Boot 4 / Java 21） | [Gitee](https://gitee.com/beijing_hongye_huicheng/lilishop) · [GitHub](https://github.com/lilishop/lilishop) |
|
||||
| **`lilishop-ui`** | PC 商城 / 商家端 / 运营管理端 / IM Web 前端 | [Gitee](https://gitee.com/beijing_hongye_huicheng/lilishop-ui) |
|
||||
| **`lilishop-uniapp`** | 买家端 H5 / 微信小程序 / Android & iOS APP | [Gitee](https://gitee.com/beijing_hongye_huicheng/lilishop-uniapp) |
|
||||
| **`docker`** | 容器化部署编排、镜像与数据库脚本 | [Gitee](https://gitee.com/beijing_hongye_huicheng/docker) · [MySQL 脚本](https://gitee.com/beijing_hongye_huicheng/docker/tree/master/init/mysql) |
|
||||
|
||||
---
|
||||
|
||||
### 7. 开源与授权
|
||||
## 6. 开源与授权
|
||||
|
||||
1. **开源协议**: 本项目遵循 `AGPL-3.0` 开源协议。
|
||||
2. **使用范围**: 仅允许用于个人学习、研究和非商业用途。
|
||||
3. **禁止行为**: 禁止将本项目的代码和资源用于任何形式的商业销售。
|
||||
4. **商业授权**: 如需商业使用，必须获得官方授权。授权为一次性永久授权，并提供持续的版本升级服务。详情请联系官网客服。
|
||||
5. **软件著作权**: 本软件受国家计算机软件著作权保护（登记号：2021SR0805085）。
|
||||
本项目遵循 [MIT](./LICENSE) 开源协议，版权归 **北京宏业汇成科技有限公司** 所有。允许个人及企业免费用于学习、研究、修改和商业用途（需保留原始版权和许可声明）。
|
||||
|
||||
---
|
||||
|
||||
### 8. 社区与支持
|
||||
## 7. 社区与支持
|
||||
|
||||
我们欢迎任何形式的交流与贡献。在提问前，请先查阅 [官方文档](https://docs.pickmall.cn/) ，并参考 [《提问的智慧》](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/master/README-zh_CN.md) 以便高效沟通。
|
||||
我们欢迎任何形式的交流与贡献。在提问前，请先查阅 [产品文档](https://bdwx2tfwwt.feishu.cn/wiki/space/7675179368632617952?ccm_open_type=lark_wiki_spaceLink&open_tab_from=wiki_home)，并参考 [《提问的智慧》](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/master/README-zh_CN.md) 以便高效沟通。
|
||||
|
||||
- **[在线客服](https://work.weixin.qq.com/kfid/kfc4d8dc24a73c15f44)**
|
||||
- **微信交流群**:
|
||||
|
||||
- **[在线客服](https://work.weixin.qq.com/kfid/kfc4d8dc24a73c15f44)**
|
||||
- **微信交流群**:
|
||||
<img src="https://lilishop-wechat.oss-cn-beijing.aliyuncs.com/wechat.jpg" width="200" alt="微信群" />
|
||||
|
||||
---
|
||||
|
||||
### 9. 升级计划
|
||||
## 8. 升级计划
|
||||
|
||||
以下功能将陆续在后续版本中发布：✅ 已完成 · 🔜 规划中
|
||||
### ✅ 已完成特性
|
||||
| 功能模块 | 功能模块 |
|
||||
| :--- | :--- |
|
||||
| ✅ 商品定时上下架 | ✅ 商品分组 / 会员分组 |
|
||||
| ✅ 商品虚拟销量 | ✅ 专用发票（发票上传） |
|
||||
| ✅ 置顶评论 | ✅ 客户等级体系 |
|
||||
| ✅ 购物卡 | ✅ 腾讯云-云直播 |
|
||||
| ✅ 卡密商品 | ✅ 二级分销 |
|
||||
| ✅ 定时任务管理 | ✅ 预约服务商品 |
|
||||
| ✅ 主题色管理 | ✅ 商家发货改造（整单/拆单/无需配送） |
|
||||
| ✅ 多维统计（营业/商品/会员/积分/储值/营销/分销） | ✅ 经营报表（店铺业绩/商品同比环比/订单明细/销售汇总） |
|
||||
|
||||
- ✅ 商品定时上下架
|
||||
- ✅ 商品分组
|
||||
- ✅ 会员分组
|
||||
- ✅ 商品虚拟销量
|
||||
- ✅ 专用发票（发票上传）
|
||||
- ✅ 置顶评论
|
||||
- ✅ 客户等级
|
||||
- ✅ 购物卡
|
||||
- ✅ 腾讯云-云直播
|
||||
- ✅ 统计：营业概况、商品概况、会员概况、积分分析、储值分析、营销概况、分销统计
|
||||
- ✅ 经营报表（店铺业绩报表、商品同比环比报表、销售订单明细报表、商品销售汇总报表）
|
||||
- ✅ 卡密商品
|
||||
- ✅ 二级分销
|
||||
- ✅ 定时任务管理
|
||||
- ✅ 服务商品
|
||||
- ✅ 主题色管理
|
||||
- 🔜 店铺结算汇总
|
||||
- 🔜 支付方式汇总
|
||||
- 🔜 结算台账
|
||||
- 🔜 钱包流水
|
||||
- 🔜 财务汇总
|
||||
### 🔜 近期规划中
|
||||
- 🔜 店铺结算汇总 & 结算台账
|
||||
- 🔜 支付方式汇总 & 钱包流水 & 财务汇总
|
||||
- 🔜 微信小店对接
|
||||
- 🔜 抖店对接
|
||||
|
||||
Reference in New Issue
Block a user