# mro

**Repository Path**: sunshineqq/mro

## Basic Information

- **Project Name**: mro
- **Description**: 工业品商城
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-25
- **Last Updated**: 2026-03-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MRO工业品电商平台

基于 Vue3 + Go + MySQL 的MRO工业品电商平台解决方案。

## 技术栈

| 层级 | 技术 |
|------|------|
| 前端 | Vue3 + Vite + Pinia + Element Plus |
| 后端 | Go + Gin + GORM |
| 数据库 | MySQL 8.0 |

## 项目结构

```
mro/
├── frontend/                # Vue3前端
│   ├── src/
│   │   ├── api/            # API封装
│   │   ├── views/          # 页面组件
│   │   │   ├── home/       # 商城首页
│   │   │   ├── product/    # 商品页
│   │   │   ├── cart/       # 购物车
│   │   │   ├── order/      # 订单
│   │   │   ├── user/       # 用户中心
│   │   │   └── admin/      # 管理后台
│   │   ├── stores/         # Pinia状态管理
│   │   └── router/         # 路由配置
│   └── package.json
├── backend/                 # Go后端
│   ├── cmd/                # 入口文件
│   ├── internal/
│   │   ├── handlers/       # HTTP处理函数
│   │   ├── models/         # 数据模型
│   │   └── middleware/     # 中间件
│   └── go.mod
├── backend-tp8-backup/      # ThinkPHP8后端(备份)
└── README.md
```

## 快速开始

### 1. 初始化数据库

```sql
CREATE DATABASE mro_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE mro_db;
```

修改 `backend/cmd/main.go` 中的数据库连接配置：
```go
dsn := "root:password@tcp(127.0.0.1:3306)/mro_db?charset=utf8mb4&parseTime=True&loc=Local"
```

### 2. 启动后端

```bash
cd backend
go mod tidy
go run cmd/main.go
```

后端服务将在 `http://localhost:8080` 启动。

### 3. 启动前端

```bash
cd frontend
npm install
npm run dev
```

前端将在 `http://localhost:3000` 启动。

## 核心功能

### 商城功能
- 商品分类浏览、多级分类
- 商品搜索、筛选
- 商品详情、SKU选择
- 购物车
- 订单创建与管理
- 用户地址管理

### 管理后台
- 商品管理（增删改查）
- 订单管理（查看、发货、完成）
- 用户管理

## API接口

| 方法 | 路径 | 说明 | 认证 |
|------|------|------|------|
| GET | /api/categories | 获取分类列表 | 否 |
| GET | /api/brands | 获取品牌列表 | 否 |
| GET | /api/products | 获取商品列表 | 否 |
| GET | /api/products/:id | 商品详情 | 否 |
| POST | /api/login | 用户登录 | 否 |
| POST | /api/register | 用户注册 | 否 |
| GET | /api/cart | 获取购物车 | 是 |
| POST | /api/cart | 加入购物车 | 是 |
| DELETE | /api/cart/:id | 删除购物车商品 | 是 |
| GET | /api/addresses | 获取地址列表 | 是 |
| POST | /api/addresses | 创建地址 | 是 |
| PUT | /api/addresses/:id | 更新地址 | 是 |
| DELETE | /api/addresses/:id | 删除地址 | 是 |
| POST | /api/orders | 创建订单 | 是 |
| GET | /api/orders | 我的订单 | 是 |
| GET | /api/orders/:id | 订单详情 | 是 |

### 管理后台API

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | /api/admin/categories | 创建分类 |
| POST | /api/admin/brands | 创建品牌 |
| POST | /api/admin/products | 创建商品 |
| PUT | /api/admin/products/:id | 更新商品 |
| DELETE | /api/admin/products/:id | 删除商品 |
| GET | /api/admin/all-orders | 订单列表 |
| PUT | /api/admin/orders/:id/status | 更新订单状态 |
| GET | /api/admin/users | 用户列表 |

## 开发计划

- [x] 项目基础架构
- [x] 用户认证
- [x] 商品管理
- [x] 购物车
- [x] 订单流程
- [x] 管理后台
- [ ] 支付集成
- [ ] 短信/邮件通知
- [ ] 数据统计