readme完善

xiangpei

2025-05-09 679ffb6a91492c56eab2c1df81343ec0dde88eed

readme完善

 README.md

@@ -1,241 +1,59 @@
## Lilishop B2B2C商城系统
# 项目说明

#### 欢迎交流需求，交流业务，交流技术（基础问题自行解决，其他问题先看文档后提问）

#### 不用削尖脑袋往老群里加，老群活跃度较低，很多潜水党，新群相对而言活跃一些 :tw-1f606: :tw-1f606: :tw-1f606: :tw-1f606: :tw-1f606: :tw-1f606: 

#### PS： **演示站点所有环境均部署master分支。如果有演示站点问题，可以反馈，如果演示站点没问题本地运行有问题，需自行处理** 

##### 交流 qq 1群 961316482（已满）
##### 交流 qq 2群 875294241（已满）
##### 交流 qq 3群 263785057（已满）
##### 交流 qq 4群 674617534 (已满)
##### 交流 qq 5群 594675235 

##### 体验 公众号/小程序/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)

## 如何在本地环境运行lilishop-ui部署视频
https://www.bilibili.com/video/BV1B28EeJEnP/

## 如何在服务器上部署lilishop-ui
https://www.bilibili.com/video/BV1WD87eoE9F/
该项目使用开源项目进行二开，仓库地址：https://github.com/lilishop?tab=repositories


## 开发项目

#### 安装Node.js
保证`node`版本`14`,推荐 14.17.0
# 项目结构

可以使用 `yarn` 或者 `npm` 进行安装
![image-20250509153725687](https://xiangpeitop.oss-cn-chengdu.aliyuncs.com/blogimgs/image-20250509153725687.png)

#### yarn 安装/启动
项目是一个主目录，buyer、im、manage、seller都是一个独立运行的项目。



# 环境要求

node版本为14（请使用nvm进行node版本管理）



# 依赖下载

如果用的idea，

![image-20250509154133415](https://xiangpeitop.oss-cn-chengdu.aliyuncs.com/blogimgs/image-20250509154133415.png)



如果用的vscode：CTRL + ~  键可调出命令行



在命令行中，通过 cd 命令分别进入到buyer、im、manage、seller目录

```
// 如果没有 yarn 安装yarn
npm install yarn -g

// 切换源
yarn config set registry https://registry.npmmirror.com

// 以buyer项目为例
cd buyer

yarn install

yarn dev
# 不用输完整，按下tab键自动补全，回车进入
cd buy
```

#### npm 安装/启动
然后执行npm install



# 运行

要运行谁就cd到对应目录下：buyer、im、manage、seller

```
npm config set registry https://registry.npmmirror.com

// 以buyer项目为例
cd buyer

npm run install

npm run 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 镜像源重试
npm run build
```


### 商城介绍
**官网**：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)


### 商城前端功能展示

#### 商城移动端

<img src="https://static.pickmall.cn/images/other/app.gif" alt="移动端功能展示" style="zoom:50%;" />

#### 平台管理端

![管理端功能展示](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群联系群主。



### 交流群

##### 交流 qq 1群 961316482（已满）
##### 交流 qq 2群 875294241（已满）
##### 交流 qq 3群 263785057（已满）
##### 交流 qq 4群 674617534（已满）
##### 交流 qq 5群 594675235 

### 附录
有人有自己的学习视频、学习记录文档、希望宣传关联开源项目等均可以私聊仓库所有者。

类似：

清晨敲代码同学的分析: https://blog.csdn.net/vaevaevae233/category_12103567.html