docs: 更新项目 README 与开源许可说明

This commit is contained in:
pikachu1995@126.com
2026-10-20 19:07:47 +08:00
parent 0f9593d5ed
commit da95f17885
3 changed files with 272 additions and 929 deletions

View File

@@ -1,184 +1,144 @@
# Lilishop(Pickmall) - Java Open Source Mall System
<div align="center">
<img src="./manager/src/assets/logo.png" width="180" alt="Lilishop Logo" />
<h1>Lilishop(PickMall) - Web Frontend (Vue 3)</h1>
[![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)
<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.md">简体中文</a> | English
</p>
<p>
<a href="https://pickmall.cn">🏠 Official Website</a> ·
<a href="https://bdwx2tfwwt.feishu.cn/wiki/space/7675179368632617952?ccm_open_type=lark_wiki_spaceLink&open_tab_from=wiki_home">📖 Product Documentation</a> ·
<a href="#2-online-demo">💻 Online Demo</a> ·
<a href="https://github.com/lilishop/lilishop">💻 GitHub</a>
</p>
LiliShop is a Java open source ecommerce system built with Spring Boot, Spring Cloud, Vue, and Uniapp.
<p>
<a href="./README.md">简体中文</a> | <b>English</b>
</p>
</div>
It supports:
> ⭐ **If you like this project, please click `Star` in the top-right corner to support us! Your Star is our greatest motivation for continuous open-source iteration!**
- 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
**LILISHOP** is an open-source e-commerce system built with Spring Boot, Vue 3, and uni-app. It supports B2B2C multi-vendor marketplaces, WeChat Mini Programs, H5, Android/iOS Apps, live-streaming e-commerce, affiliate distribution, and flash sales.
### ✨ Why Choose Lilishop
- 🟢 **True MIT License**: Free for commercial use and private secondary development without licensing concerns.
- 🚀 **Modern Vue 3 Stack**: Built on `Vue 3.5 + Pinia 4 + Vue Router 4 + Element Plus`, leaving legacy Vue 2 templates behind.
- 🧩 **4-in-1 Production Suite**: Covers **PC Buyer Mall (`buyer`)**, **Seller Portal (`seller`)**, **Platform Admin Panel (`manager`)**, and **IM Customer Service Web (`im`)**, complete with drag-and-drop visual storefront decoration and rich analytics.
---
## Keywords
## 1. Overview
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
This repository (`lilishop-ui`) is the **Web Frontend Suite** of Lilishop, containing four standalone **Vue 3** web applications: **PC Buyer Mall, Seller Panel, Platform Admin Panel, and IM Customer Service Web**.
- **Official Website**: <https://pickmall.cn>
- **Documentation**: [Product Documentation](https://bdwx2tfwwt.feishu.cn/wiki/space/7675179368632617952?ccm_open_type=lark_wiki_spaceLink&open_tab_from=wiki_home)
- **Gitee Repository**: <https://gitee.com/beijing_hongye_huicheng>
- **GitHub Main Repository**: <https://github.com/lilishop/lilishop>
---
## Official Website
## 2. Online Demo
- Website: https://pickmall.cn
- Documentation: https://docs.pickmall.cn
- GitHub: https://github.com/lilishop/lilishop
- Gitee: https://gitee.com/beijing_hongye_huicheng/lilishop
> **Note**: The verification code for the demo environment is `111111`.
| Portal | URL | Demo Credentials |
| :--- | :--- | :--- |
| **Platform Admin Panel (`manager`)** | <https://admin-b2b2c.pickmall.cn> | `admin` / `123456` |
| **Seller / Store Panel (`seller`)** | <https://store-b2b2c.pickmall.cn> | `13011111111` / `111111` |
| **PC Buyer Mall (`buyer`)** | <https://pc-b2b2c.pickmall.cn> | SMS code: `111111` |
| **Mobile H5 (`uni-app`)** | <https://m-b2b2c.pickmall.cn> | SMS code: `111111` |
| WeChat Mini Program | Mobile H5 ([Visit Directly](https://m-b2b2c.pickmall.cn)) |
| :---: | :---: |
| <img src="https://static.pickmall.cn/images/h5-qrcode.png" width="180" alt="WeChat Mini Program QR Code" /> | <img src="https://lilishop-wechat.oss-cn-beijing.aliyuncs.com/h5-qrcode.png" width="180" alt="Mobile H5 QR Code" /> |
| Scan with WeChat | Scan or visit <https://m-b2b2c.pickmall.cn> |
---
## Core Features
## 3. Core Features & Tech Stack
### Full Platform Support
### Core Features
- **Four-Portal Synergy**: Includes Platform Admin, Seller Panel, PC Buyer Mall, and IM Web Workbench with clear role boundaries.
- **Drag-and-Drop Visual Decoration**: Built-in visual floor editor (`vuedraggable`) for customizing both PC and mobile storefronts.
- **Multi-Vendor B2B2C Operations**: Merchant onboarding, product auditing, split-order fulfillment, promotions, and financial settlement ledgers.
- **Rich Business Analytics**: Powered by `@antv/g2` for sales overview, YoY/MoM product reports, member analytics, and distribution metrics.
- **IM Customer Service**: Integrated with Tencent Cloud IM / WebSocket customer service for real-time communication.
One codebase supports:
- PC
- H5
- WeChat Mini Program
- Android APP
- iOS APP
### Microservice Architecture
Built with:
- Spring Boot
- MySQL
- Redis
- Docker
Supports standalone deployment: **buyer-api** (8888), **manager-api** (8887, includes store APIs), **im-api** (8885). Product search uses MySQL. Async messaging uses Redis queues. Scheduled tasks use Spring `@Scheduled`.
### Frontend API paths
| App | Public API prefix |
| :--- | :--- |
| Buyer | `{buyerUrl}/buyer/common/*` |
| Seller | `{sellerUrl}/store/common/*` |
| Manager | `{managerUrl}/manager/common/*` |
The legacy `common-api` and `/common/common/*` paths are removed.
### 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
### Web Tech Stack
| Category | Technology | Description |
| :--- | :--- | :--- |
| Core Framework | `Vue 3.5` + `Vue Router 4` | Modern reactive frontend framework |
| State Management | `Pinia 4` | Official Vue 3 state management library |
| UI Library | `Element Plus 2.x` | Enterprise desktop UI component library |
| HTTP Client | `Axios 1.x` | Unified request/response interceptors & auth handling |
| Data Visualization | `@antv/g2` | Interactive charts and business analytics |
| Visual Decoration | `vuedraggable 4` | Drag-and-drop page floor builder |
| Messaging & IM | `@tencentcloud/chat` / `sockjs-client` | Real-time customer service messaging |
| Video Player | `dplayer` + `hls.js` | Product video and live streaming playback |
| Build & Styling | `Vue CLI 5` + `Webpack 5` + `Sass / Less` | Modular build pipeline and theme customization |
---
## Tech Stack
## 4. Directory Structure
### Backend
- Java 21
- Spring Boot 4
- MyBatis Plus
- MySQL
- Redis
- JWT
- Docker
### Frontend
- Vue.js
- Uniapp
- Vuex
- Axios
- iView
- uViewUI
```text
lilishop-ui
├── buyer/ # [PC Buyer Mall]
│ ├── public/ # Static assets & global config (config.js)
│ └── src/
│ ├── api/ # Buyer API modules (goods, cart, order, member, promotion)
│ ├── components/ # Shared components (floor renderer, navbar, goods card)
│ ├── pages/ # PC Mall pages (Home, Product Detail, Checkout, User Center)
│ ├── router/ # Route definitions & guards
│ ├── stores/ # Pinia stores
│ └── utils/ # Request interceptors & helpers
├── seller/ # [Seller / Store Management Portal]
│ ├── public/ # Static assets & global config
│ └── src/
│ ├── api/ # Seller API modules
│ ├── components/ # Seller shared & decoration components
│ ├── views/ # Seller views (goods, orders, after-sales, promotions, store settings)
│ ├── router/ # Dynamic permission routes
│ └── stores/ # Pinia stores
├── manager/ # [Platform Admin Portal]
│ ├── public/ # Static assets & global config
│ └── src/
│ ├── api/ # Admin API modules
│ ├── components/ # Admin components, rich-text editor, visual floor builder
│ ├── views/ # Admin views (member, goods, order, seller, marketing, finance, stats, system)
│ ├── router/ # Menu & permission routes
│ └── stores/ # Pinia stores
├── im/ # [IM Customer Service Web Client]
│ └── src/
│ ├── api/ # Chat session & message APIs
│ ├── components/ # Chat window, message list, product/order cards
│ ├── im-server/ # WebSocket / IM connection manager
│ └── views/ # Customer service workbench
├── build.sh # Unified build script
└── docker-build.sh # Docker image build script
```
---
## Online Demo
## 5. Related Repositories
### 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
| Repository | Description | Links |
| :--- | :--- | :--- |
| **`lilishop`** | Backend Services (Spring Boot 4 / Java 21) | [Gitee](https://gitee.com/beijing_hongye_huicheng/lilishop) · [GitHub](https://github.com/lilishop/lilishop) |
| **`lilishop-ui`** | PC Mall / Seller / Admin / IM Web Frontend | [Gitee](https://gitee.com/beijing_hongye_huicheng/lilishop-ui) |
| **`lilishop-uniapp`** | Mobile Buyer Client (H5 / Mini Program / App) | [Gitee](https://gitee.com/beijing_hongye_huicheng/lilishop-uniapp) |
| **`docker`** | Docker Compose, Images & SQL Init Scripts | [Gitee](https://gitee.com/beijing_hongye_huicheng/docker) · [MySQL Scripts](https://gitee.com/beijing_hongye_huicheng/docker/tree/master/init/mysql) |
---
## Quick Start
## 6. License
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.
Lilishop is licensed under the [MIT](./LICENSE) License. Copyright © 2020-2026 **Beijing Hongye Huicheng Technology Co., Ltd.**