---
## 项目简介
**一店云（OneShop Cloud）** 是一套面向中小企业与开发者的 **开源云商城系统**。
项目基于 **RuoYi（若依）框架进行深度改造**，采用 **前后端分离 + 多端统一** 的架构设计，
覆盖商品、订单、会员等商城核心业务能力，支持 **管理后台（PC）+ 商城用户端（uni-app）** 的完整形态。
一店云并非演示型项目，而是一套 **可长期维护、可二次开发、可持续演进** 的商城基础设施，
适用于 **自建商城 / 私域电商 / 行业系统 / SaaS 平台** 等应用场景。
---
商城目前在持续开发中，会持续跟新代码结构，目前完成了基础电商的功能和装修的功能
## 核心特性
- 🚀 基于若依体系深度改造，使用mybatis-plus ,大大程度上降低了代码的数量架构成熟、稳定可靠
- 🧩 商城业务模块化设计，职责清晰，便于扩展
- 🔐 Spring Security + Token 鉴权，权限控制到菜单/按钮级
- 🛒 覆盖商品、订单、会员的完整交易链路
- 📱 uni-app 一套代码，支持 H5 / 小程序 / App 多端
- ☁️ 支持私有化部署，
- 🧑💻 面向二次开发友好，适合长期维护与定制
- :orange_book: 整合了支付、OSS存储、APP版本管理等内容，通过几行代码就能实现支付以及存储配置
- :notebook_with_decorative_cover: 整改了ruoyi-ui 增加了OSS图片配置，实现图片和附件上传
---
## 功能概览（社区版）
- **商品管理**：分类 / SKU / 库存 / 上下架
- **交易链路**：购物车 / 下单 / 支付 / 发货 / 售后
- **订单中心**：订单状态流转 / 超时自动关闭
- **会员体系**：会员信息 / 收货地址
- **系统能力**：权限 / 字典 / 参数 / 日志 / 定时任务
> 社区版聚焦“商城核心能力 + 稳定基础设施”，高级营销与多租户能力在企业版规划中。
---
## 项目结构
```bash
yidian-cloud/
├─ bin/ # 运维 / 启动脚本
├─ db/ # 数据库脚本（初始化 / 升级）
├─ doc/ # 项目文档（架构 / 部署）
│
├─ ruoyi-admin/ # 后端启动入口
├─ ruoyi-common/ # 公共模块（工具类 / 常量）
├─ ruoyi-framework/ # 框架核心（鉴权 / 安全）
├─ ruoyi-generator/ # 代码生成器
├─ ruoyi-mall/ # 商城核心业务模块 ⭐
├─ ruoyi-quartz/ # 定时任务模块
├─ ruoyi-shunlu/ # 一店云扩展模块 ⭐
├─ ruoyi-system/ # 系统管理模块
│
├─ ruoyi-ui/ # 管理后台前端（Vue）
│
├─ uniapp/ # 商城用户端（uni-app）⭐
│ ├─ api/ # 接口封装
│ ├─ components/ # 公共组件
│ ├─ pages/ # 页面目录
│ ├─ static/ # 静态资源
│ └─ App.vue
│
└─ README.md
````
---
## 模块说明
### 后端模块
* **ruoyi-admin**：应用启动入口，统一 API 出口
* **ruoyi-framework**：认证鉴权、安全控制、全局拦截
* **ruoyi-system**：用户、角色、菜单、字典、参数配置
* **ruoyi-mall**：商品、订单、会员等商城核心业务
* **ruoyi-quartz**：订单超时关闭、自动确认等定时任务
* **ruoyi-shunlu**：行业定制与商业扩展能力承载模块
### 管理端（PC）
* 商品管理 / 订单管理
* 会员管理 / 系统配置
* 权限管理 / 数据字典 / 日志审计
### 用户端（uni-app）
* 首页 / 商品浏览
* 购物车 / 下单支付
* 订单管理 / 个人中心
---
## 快速开始
1. 初始化数据库（执行 `sql/` 目录下 SQL）
2. 修改 `ruoyi-admin` 配置（MySQL / Redis）
3. 启动后端服务
4. 启动 `ruoyi-ui` 管理后台
5. 使用 HBuilderX 运行 `uniapp` 项目
## 系统使用截图
- 后台使用地址：[点击访问](http://shunlushop.shunluwang.com/index)
- 演示账号：ry
- 演示密码：123456
> 温馨提示：当前演示环境暂未做账号权限限制，请大家仅用于学习与功能体验，勿恶意删除/篡改数据。开源不易，感谢支持 🙏
