---
## 项目简介
**一店云（OneShop Cloud）** 是一套面向中小企业与开发者的 **开源云商城系统**。
项目基于 **RuoYi（若依）框架进行深度改造**，采用 **前后端分离 + 多端统一** 的架构设计，
覆盖商品、订单、会员等商城核心业务能力，支持 **管理后台（PC）+ 商城用户端（uni-app）** 的完整形态。
一店云并非演示型项目，而是一套 **可长期维护、可二次开发、可持续演进** 的商城基础设施，
适用于 **自建商城 / 私域电商 / 行业系统 / SaaS 平台** 等应用场景。
---
## 核心特性
- 🚀 基于若依体系深度改造，架构成熟、稳定可靠
- 🧩 商城业务模块化设计，职责清晰，便于扩展
- 🔐 Spring Security + Token 鉴权，权限控制到菜单/按钮级
- 🛒 覆盖商品、订单、会员的完整交易链路
- 📱 uni-app 一套代码，支持 H5 / 小程序 / App 多端
- ☁️ 支持私有化部署，具备云原生演进空间
- 🧑💻 面向二次开发友好，适合长期维护与定制
---
## 功能概览（社区版）
- **商品管理**：分类 / 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. 初始化数据库（执行 `db/` 目录下 SQL）
2. 修改 `ruoyi-admin` 配置（MySQL / Redis）
3. 启动后端服务
4. 启动 `ruoyi-ui` 管理后台
5. 使用 HBuilderX 运行 `uniapp` 项目
---
## Roadmap
* [ ] 多租户 / 多商户架构
* [ ] 拼团 / 秒杀 / 分销等营销能力
* [ ] BI 数据分析与经营看板
* [ ] Docker / Docker Compose 一键部署
* [ ] 事件驱动的订单状态体系
---
## 社区版 vs 企业版
### 社区版（开源）
* 商城基础能力（商品 / 订单 / 会员）
* 若依完整后台能力
* 遵循 AGPL-3.0 开源协议
### 企业版（规划中）
* 多租户隔离与商户体系
* 高级营销与业务扩展能力
* 数据分析与经营报表
* 私有化部署与技术支持
---
## 客服与技术支持
