# lyshop

**Repository Path**: oywb33/lyshop

## Basic Information

- **Project Name**: lyshop
- **Description**: No description available
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-17
- **Last Updated**: 2026-08-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LYShop 零云商城

开源插件化多端商城系统，基于 Go + Vue3 + uni-app。

[![CI](https://github.com/ijry/lyshop/actions/workflows/ci.yml/badge.svg)](https://github.com/ijry/lyshop/actions/workflows/ci.yml)
[![Docs](https://github.com/ijry/lyshop/actions/workflows/docs.yml/badge.svg)](https://ijry.github.io/lyshop/)
[![License: MIT](https://img.shields.io/badge/License-MIT-red.svg)](LICENSE)

![LYShop 零云商城官网首页](assets/showcase/docs-home-hero.png)

## 在线演示

- [PC 商城演示](https://ijry.github.io/lyshop/web-demo/)
- [管理后台演示](https://ijry.github.io/lyshop/admin-demo/)（账号 admin / admin123）
- [H5 移动端演示](https://ijry.github.io/lyshop/)（右下角浮窗）
- [项目文档](https://ijry.github.io/lyshop/)

## 特性

- **完全插件化** — 商品、订单、营销、IM、支付等均为独立插件，config.yaml 一行开关
- **多端覆盖** — PC Web + H5 + 微信小程序 + App（iOS/Android）+ 管理后台
- **驱动抽象层** — 支付、短信、OAuth、存储、AI 统一接口，一行代码切换服务商
- **AI 生图** — 通义万象 / 文心 / DALL-E 多模型聚合生成商品图
- **AI 生图工作流** — 商品编辑页内直接生成封面/轮播/详情图，支持参考图（按模型能力禁用）
- **IM 客服** — WebSocket 实时通信，多坐席，断线重连，声音提醒
- **营销引擎** — 价格计算管线，秒杀/拼团/砍价/优惠券（可叠加）/积分/分销（2级返利）
- **RBAC 权限** — 角色 + 细粒度权限，菜单按权限动态过滤
- **本机单机版** — 支持 SQLite + 内嵌前端资源 + Windows GUI 启动器
- **一键部署** — Docker Compose，MySQL + Redis + Nginx 全容器化

## 技术栈

| 层级 | 技术 |
|------|------|
| 后端 | Go + Gin + GORM + SQLite/MySQL + Redis |
| 管理后台 | Vue3 + Vite + TailwindCSS + shadcn-vue |
| PC 商城 | Vue3 + Vite + UnoCSS |
| 移动端 | uni-app + uview-plus 3.x + UnoCSS |
| 文档站 | VitePress |
| 部署 | Docker Compose + Nginx |

## 目录结构

```
lyshop/
├── server/        # Go 后端（插件化架构）
├── admin/         # Vue3 管理后台
├── web/           # Vue3 PC 商城前端
├── app/           # uni-app 移动端（H5/小程序/App）
├── docs-site/     # VitePress 文档站
└── docker-compose.yml
```

## 插件列表

| 插件 | 类型 | 说明 |
|------|------|------|
| `product` | 功能 | 商品管理、多规格 SKU、分类 |
| `order` | 功能 | 购物车、订单、支付、售后 |
| `marketing` | 功能 | 优惠券、秒杀、拼团、砍价、满减、积分、分销 |
| `im` | 功能 | WebSocket IM 客服 |
| `wms` | 功能 | 仓储管理 |
| `ai_image` | 功能 | AI 生成商品图 |
| `decor` | 功能 | 店铺装修 |
| `checkin` | 功能 | 每日签到 |
| `message` | 功能 | 消息中心 |
| `wechat_pay` | 驱动 | 微信支付 |
| `alipay` | 驱动 | 支付宝支付 |
| `sms` | 驱动 | 短信（阿里云/腾讯云） |
| `wechat_auth` | 驱动 | 微信登录 |
| `storage_local` | 驱动 | 本地存储 |
| `storage_oss` | 驱动 | 阿里云 OSS |
| `storage_cos` | 驱动 | 腾讯云 COS |
| `storage_qiniu` | 驱动 | 七牛云 |

## 快速开始

### 1. 后端

```bash
cd server
cp ../config.example.yaml ../config.yaml  # 编辑配置
go mod tidy
go run main.go
# 首次启动自动建表 + 创建超管 admin/admin123
# 默认使用 SQLite（lyshop.db），如需 MySQL 可改 database.dsn
```

### 2. 管理后台

```bash
cd admin
npm install
npm run dev        # http://localhost:9527
npm run dev:demo   # mock 演示模式
```

### 3. PC 商城

```bash
cd web
npm install
npm run dev        # http://localhost:9529
npm run dev:demo   # mock 演示模式
```

### 4. 移动端

```bash
cd app
npm install --legacy-peer-deps
npm run dev:h5       # H5 开发
npm run dev:h5:demo  # mock 演示模式
```

### 5. Docker 一键部署

```bash
cp config.example.yaml config.yaml
docker compose up -d
```

### 6. 本机单机（内嵌前端 + GUI 壳）

```bash
# 1) 构建前端并嵌入到后端资源目录（web/admin/h5）
pwsh -File scripts/build-standalone.ps1

# 2) 产物在 dist/
# - lyshop.exe
# - lyshop-gui.exe
```

启动 `lyshop-gui.exe` 后可直接在本机打开：

- 商城：`http://127.0.0.1:8080/`
- 后台：`http://127.0.0.1:8080/admin/`
- H5：`http://127.0.0.1:8080/h5/`

说明：

- 默认 `database.dsn: lyshop.db`（SQLite）。
- `redis.addr` 留空时会自动启用进程内嵌 Redis，适合个人单机使用。

## 文档

- [功能介绍](https://ijry.github.io/lyshop/guide/features)
- [部署文档](https://ijry.github.io/lyshop/deploy/)
- [接口文档](https://ijry.github.io/lyshop/api/)
- [二次开发](https://ijry.github.io/lyshop/dev/secondary-development)

## 最近修复（2026-05-24）

- H5 商品页改为 `u-tabs + up-waterfall`，修复 tab 样式异常并统一瀑布流展示。
- H5 首页装修数据兼容 `components` 数组/字符串两种格式，轮播改本地静态资源，解决轮播空白。
- 收货地址页新增可提交表单，演示模式保存失败时也返回成功反馈，生产模式按真实接口结果处理。
- 订单页演示数据支持按 `status` 查询参数过滤，顶部 tab 切换可见结果变化。
- H5 客服输入区改为底部固定，未连通 WebSocket 时启用本地自动回复兜底。
- PC 客服入口统一改为弹窗会话（悬浮按钮/商品详情/页脚），不再跳转新页面。
- 商品详情主链路切换为 `JSON blocks`（`version + blocks`），管理后台使用自定义详情编辑器。
- 订单接口升级：前后台列表与详情统一返回 `items + amount_breakdown`，PC/H5/后台均新增订单详情页。
- 商品编辑页 AI 助手支持“插入到当前编辑位置”提示，并支持封面/轮播/详情/介绍图目标类型。
- 接口层以现有订单资源升级为主，新增订单详情与后台发货等必要路由，继续保持统一语义。
- 部署配置无新增项，无需额外环境变量。

## License

[MIT](LICENSE)