=========== V3.0.1 ==========
- 稳定版 - 可以基于此版本作为其他项目的底座
This commit is contained in:
@@ -53,3 +53,11 @@
|
||||
- 问题:点「刷新数据」按钮提示成功,但实际数据没更新。
|
||||
- 根因:`refreshStatistics` 调用 `statisticsStore.fetchStatistics()` 未传 `forceRefresh=true`,5分钟缓存有效期内直接返回旧数据。
|
||||
- 修复:改为 `fetchStatistics(true)` 强制跳过缓存。
|
||||
|
||||
## README.md 修改
|
||||
|
||||
- 项目名称从"WebSoftAdmin"改为"小程序商城后台管理系统"。
|
||||
- 项目域名更新为 https://shop.websoft.top。
|
||||
- 去掉 CMS 内容管理系统的介绍部分(文章管理、一键排版、媒体库等)。
|
||||
- 更新技术栈版本号对齐 package.json(AntDv 4.x、Vite 8.x、TS 5.x、Pinia 2.x)。
|
||||
- 补充门店/经销商/会员管理等商城核心功能描述,对齐实际 views/shop 目录结构。
|
||||
|
||||
141
README.md
141
README.md
@@ -1,84 +1,89 @@
|
||||
<div align="center">
|
||||
<h1>🌐 WebSoftAdmin</h1>
|
||||
<p><strong>基于 Vue 3 + Ant Design Vue 的企业级后台管理系统</strong></p>
|
||||
<h1>🛒 小程序商城后台管理系统</h1>
|
||||
<p><strong>基于 Vue 3 + Ant Design Vue 的企业级小程序商城后台</strong></p>
|
||||
|
||||
<p>
|
||||
<img src="https://img.shields.io/badge/Vue-3.x-4FC08D" alt="Vue">
|
||||
<img src="https://img.shields.io/badge/Ant%20Design%20Vue-3.x-1890FF" alt="Ant Design Vue">
|
||||
<img src="https://img.shields.io/badge/TypeScript-4.x-3178C6" alt="TypeScript">
|
||||
<img src="https://img.shields.io/badge/Vite-4.x-646CFF" alt="Vite">
|
||||
<img src="https://img.shields.io/badge/Ant%20Design%20Vue-4.x-1890FF" alt="Ant Design Vue">
|
||||
<img src="https://img.shields.io/badge/TypeScript-5.x-3178C6" alt="TypeScript">
|
||||
<img src="https://img.shields.io/badge/Vite-8.x-646CFF" alt="Vite">
|
||||
<img src="https://img.shields.io/badge/License-MIT-blue" alt="License">
|
||||
</p>
|
||||
</div>
|
||||
|
||||
## 📖 项目简介
|
||||
|
||||
WebSoftAdmin 是一个基于 **Vue 3 + Ant Design Vue** 构建的现代化企业级后台管理系统,采用最新的前端技术栈:
|
||||
小程序商城后台管理系统是一个基于 **Vue 3 + Ant Design Vue** 构建的现代化企业级商城管理平台,为小程序商城提供完整的后台管理能力,涵盖商品、订单、会员、经销商、门店、营销活动等核心业务模块。
|
||||
|
||||
- **前端框架**:Vue 3 + TypeScript + Vite
|
||||
- **UI 组件库**:Ant Design Vue 3.x
|
||||
- **富文本编辑器**:TinyMCE(支持图片/视频上传、一键排版)
|
||||
- **图表库**:ECharts + G2
|
||||
- **工具库**:Lodash、Day.js、CryptoJS
|
||||
|
||||
|
||||
|
||||
## 项目演示
|
||||
| 后台管理系统 | https://shop.websoft.top |
|
||||
|--------|--------------------------------------------------------------------------------------------------------------------------------------|
|
||||
| https://websoft.top/?inviteCode=github) |
|
||||
| 关注公众号 |  |
|
||||
|
||||
- **UI 组件库**:Ant Design Vue 4.x + EleAdmin Pro
|
||||
- **状态管理**:Pinia
|
||||
- **图表库**:ECharts + @antv/g2
|
||||
- **工具库**:Lodash、Day.js、CryptoJS、ExcelJS
|
||||
|
||||
**项目域名**:[https://shop.websoft.top](https://shop.websoft.top)
|
||||
|
||||
**官方产品介绍**:[https://websoft.top/shop](https://websoft.top/shop)
|
||||
|
||||
## 🛠️ 技术栈
|
||||
|
||||
### 核心技术
|
||||
|
||||
| 技术 | 版本 | 说明 |
|
||||
|------|------|------|
|
||||
| Vue | 3.x | 渐进式 JavaScript 框架 |
|
||||
| TypeScript | 4.x | JavaScript 的超集 |
|
||||
| Vite | 4.x | 下一代前端构建工具 |
|
||||
| Ant Design Vue | 3.2.11 | 企业级 UI 设计语言 |
|
||||
| EleAdmin Pro | 1.10.1 | 企业级组件库 |
|
||||
| TypeScript | 5.x | JavaScript 的超集 |
|
||||
| Vite | 8.x | 下一代前端构建工具 |
|
||||
| Ant Design Vue | 4.x | 企业级 UI 设计语言 |
|
||||
| EleAdmin Pro | 1.11+ | 企业级组件库 |
|
||||
| Pinia | 2.x | Vue 3 状态管理库 |
|
||||
|
||||
### 功能组件
|
||||
|
||||
- **TinyMCE** - 富文本编辑器,支持图片/视频上传
|
||||
- **ECharts** - 数据可视化图表库
|
||||
- **CropperJS** - 图片裁剪组件
|
||||
- **ExcelJS** - Excel 文件处理
|
||||
- **ExcelJS / xlsx** - Excel 文件导入导出
|
||||
- **Ali OSS** - 阿里云对象存储
|
||||
- **qrcode / jsbarcode** - 二维码与条形码生成
|
||||
|
||||
## 📋 环境要求
|
||||
|
||||
### 基础环境
|
||||
- 🟢 **Node.js 16+**
|
||||
- 📦 **npm 8+ / yarn 1.22+**
|
||||
|
||||
- 🟢 **Node.js 18+**
|
||||
- 📦 **npm 8+ / yarn 1.22+ / pnpm 8+**
|
||||
- 🌐 **现代浏览器**(Chrome 63+、Firefox、Safari、Edge)
|
||||
|
||||
### 开发工具
|
||||
|
||||
- **推荐**:VS Code / WebStorm
|
||||
- **插件**:Vetur / Volar(Vue 3 支持)
|
||||
- **插件**:Volar(Vue 3 支持)
|
||||
|
||||
## 🚀 快速开始
|
||||
|
||||
### 1. 克隆项目
|
||||
|
||||
```bash
|
||||
git clone https://github.com/websoft-top/paopao-vue.git
|
||||
cd paopao-vue
|
||||
git clone <仓库地址>
|
||||
cd guilixu-admin
|
||||
```
|
||||
|
||||
### 2. 安装依赖
|
||||
|
||||
```bash
|
||||
# 使用 npm
|
||||
npm install
|
||||
|
||||
# 或使用 yarn
|
||||
yarn install
|
||||
|
||||
# 或使用 pnpm(推荐)
|
||||
pnpm install
|
||||
```
|
||||
|
||||
### 3. 配置环境变量
|
||||
|
||||
```bash
|
||||
# 复制环境变量示例文件
|
||||
cp .env.example .env
|
||||
@@ -88,6 +93,7 @@ cp .env.example .env
|
||||
```
|
||||
|
||||
### 4. 启动开发服务器
|
||||
|
||||
```bash
|
||||
# 开发模式
|
||||
npm run dev
|
||||
@@ -99,6 +105,7 @@ yarn dev
|
||||
访问 `http://localhost:3000` 即可看到管理后台。
|
||||
|
||||
### 5. 构建生产版本
|
||||
|
||||
```bash
|
||||
# 生产构建
|
||||
npm run build
|
||||
@@ -112,6 +119,7 @@ npm run serve
|
||||
项目使用环境变量来管理敏感信息和配置。请按照以下步骤配置:
|
||||
|
||||
### 必需配置
|
||||
|
||||
```bash
|
||||
# API 配置
|
||||
VITE_API_URL=https://your-api.com/api # 后端 API 地址
|
||||
@@ -124,51 +132,54 @@ VITE_TENANT_ID=your_tenant_id # 租户 ID
|
||||
```
|
||||
|
||||
### 可选配置
|
||||
|
||||
```bash
|
||||
# 高德地图 (如需使用地图功能)
|
||||
VITE_MAP_KEY=your_map_key # 高德地图 Key
|
||||
VITE_MAP_CODE=your_map_security_code # 高德地图安全密钥
|
||||
|
||||
# WebSoftAdmin 授权 (商业版功能)
|
||||
# EleAdmin Pro 授权 (商业版功能)
|
||||
VITE_LICENSE_CODE=your_license_code # 授权码
|
||||
```
|
||||
|
||||
### 获取配置信息
|
||||
- **高德地图密钥**:访问 [高德开放平台](https://lbs.amap.com/) 申请
|
||||
- **WebSoftAdmin 授权码**:联系 [官方网站](https://websoft.top/) 获取
|
||||
- **其他 API 配置**:根据您的后端服务配置
|
||||
|
||||
## 🎯 核心功能
|
||||
|
||||
### 📝 内容管理系统
|
||||
- **文章管理**:支持富文本编辑、图片/视频上传
|
||||
- **一键排版**:智能文章格式优化,包含10种专业排版样式
|
||||
- **媒体库**:图片/视频文件管理,支持分组和搜索
|
||||
- **首行缩进**:中文段落格式智能切换
|
||||
|
||||
### 🛒 商城管理
|
||||
- **商品管理**:商品信息编辑、规格设置
|
||||
- **订单管理**:订单流程跟踪
|
||||
|
||||
- **商品管理**:商品信息编辑、规格设置、SKU 管理、商品分类
|
||||
- **订单管理**:订单流程跟踪、订单商品管理
|
||||
- **库存管理**:商品库存监控
|
||||
- **优惠券管理**:优惠券创建与发放、用户优惠券管理
|
||||
- **营销活动**:活动管理、活动报名、积分商品
|
||||
- **礼品管理**:商城礼品配置
|
||||
|
||||
### 👥 用户权限
|
||||
- **用户管理**:用户信息维护
|
||||
- **角色权限**:基于角色的访问控制
|
||||
### 🏪 门店与经销商
|
||||
|
||||
- **门店管理**:门店信息、门店围栏、门店骑手、门店仓库
|
||||
- **经销商体系**:经销商申请、经销商用户、经销商订单、经销商资金与提现
|
||||
- **分销设置**:经销商推荐人、分销海报、分销配置
|
||||
|
||||
### 👥 会员管理
|
||||
|
||||
- **会员注册**:会员注册管理
|
||||
- **会员权益**:权益包管理、权益兑换
|
||||
- **会员推荐**:推荐人关系管理
|
||||
|
||||
### 👤 用户权限
|
||||
|
||||
- **用户管理**:用户信息维护、用户分组
|
||||
- **角色权限**:基于角色的访问控制(RBAC)
|
||||
- **菜单管理**:动态菜单配置
|
||||
- **组织架构**:组织与部门管理
|
||||
|
||||
## 🎨 富文本编辑器特色功能
|
||||
### ⚙️ 系统管理
|
||||
|
||||
### 📸 媒体上传
|
||||
- **图片上传**:支持拖拽、粘贴、文件选择
|
||||
- **视频上传**:支持多种视频格式
|
||||
- **媒体库**:统一的媒体文件管理
|
||||
- **OSS 存储**:阿里云对象存储集成
|
||||
|
||||
### ✨ 智能排版
|
||||
- **一键排版**:10种专业排版优化
|
||||
- **首行缩进**:中文段落格式切换
|
||||
- **样式优化**:标题、段落、列表、表格等元素美化
|
||||
- **响应式**:适配不同屏幕尺寸
|
||||
- **系统配置**:商城设置、提现配置
|
||||
- **支付管理**:支付配置、订单支付
|
||||
- **字典管理**:数据字典维护
|
||||
- **缓存管理**:缓存清理
|
||||
- **域名管理**:域名白名单配置
|
||||
- **操作记录**:登录记录、操作日志
|
||||
|
||||
## 🏗️ 项目结构
|
||||
|
||||
@@ -176,11 +187,17 @@ VITE_LICENSE_CODE=your_license_code # 授权码
|
||||
src/
|
||||
├── components/ # 公共组件
|
||||
├── views/ # 页面组件
|
||||
│ ├── cms/ # 内容管理
|
||||
│ ├── shop/ # 商城管理
|
||||
│ └── system/ # 系统管理
|
||||
│ ├── shop/ # 商城管理(商品、订单、门店、经销商、会员等)
|
||||
│ ├── system/ # 系统管理(用户、角色、菜单、字典、支付等)
|
||||
│ ├── passport/ # 登录认证
|
||||
│ ├── user/ # 用户中心
|
||||
│ └── result/ # 结果页
|
||||
├── router/ # 路由配置
|
||||
├── store/ # 状态管理
|
||||
├── store/ # Pinia 状态管理
|
||||
├── utils/ # 工具函数
|
||||
└── assets/ # 静态资源
|
||||
```
|
||||
|
||||
## 📄 License
|
||||
|
||||
[MIT](LICENSE)
|
||||
|
||||
Reference in New Issue
Block a user