# shopping_openspec_claudecode

**Repository Path**: PaoManX/shopping_openspec_claudecode

## Basic Information

- **Project Name**: shopping_openspec_claudecode
- **Description**: xxx
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-27
- **Last Updated**: 2026-03-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 购物小程序全栈项目

基于 uni-app + Vue3 + GoFrame2 的购物小程序全栈解决方案，支持微信小程序、支付宝小程序、H5 三端。

## 项目结构

```
├── shopping-service/    # GoFrame2 后端服务
├── shopping-app/        # uni-app 用户端小程序
├── shopping-admin/      # Vue3 管理端 Web
└── openspec/            # OpenSpec 规格文档
```

## 技术栈

| 模块 | 技术 |
|------|------|
| 用户端 | uni-app + Vue3 + Pinia + uni-ui |
| 管理端 | Vue3 + Element Plus + Pinia + TypeScript |
| 后端 | GoFrame2 + MySQL + Redis + JWT |
| 数据库 | MySQL 8.0 |
| 缓存 | Redis |

## 快速开始

### 环境要求

- Go 1.21+
- Node.js 18+
- MySQL 8.0+
- Redis 6.0+

### 1. 数据库初始化

```bash
# 创建数据库
mysql -u root -p -e "CREATE DATABASE shopping DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;"

# 导入表结构
mysql -u root -p shopping < shopping-service/resource/sql/schema.sql
```

### 2. 启动后端

```bash
cd shopping-service

# 修改配置 (数据库、Redis连接信息)
vim manifest/config/config.yaml

# 运行
go run main.go
```

后端服务地址：http://localhost:8000
Swagger 文档：http://localhost:8000/swagger

### 3. 启动用户端 H5

```bash
cd shopping-app
npm install
npm run dev:h5
```

用户端访问：http://localhost:5173

微信小程序编译：
```bash
npm run dev:mp-weixin
# 用微信开发者工具打开 dist/dev/mp-weixin
```

### 4. 启动管理端

```bash
cd shopping-admin
npm install
npm run dev
```

管理端访问：http://localhost:5174

## 默认账号

| 角色 | 用户名 | 密码 |
|------|--------|------|
| 管理员 | admin | admin123 |

## 功能模块

### 用户端
- 用户登录/注册（微信、支付宝、手机号）
- 商品浏览、搜索、分类
- 购物车管理
- 订单创建、支付（模拟）、查询
- 收货地址管理
- 个人中心

### 管理端
- 商品管理（CRUD、上下架）
- 订单管理（发货、取消、退款）
- 用户管理（查看、禁用）

## API 端点

### 公开接口
| 方法 | 路径 | 说明 |
|------|------|------|
| POST | /user/register | 用户注册 |
| POST | /user/login | 用户登录 |
| GET | /category/list | 分类列表 |
| GET | /product/list | 商品列表 |
| GET | /product/detail | 商品详情 |

### 用户接口 (需 Token)
| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /user/info | 用户信息 |
| POST | /cart/add | 添加购物车 |
| GET | /cart/list | 购物车列表 |
| POST | /order/create | 创建订单 |
| GET | /order/list | 订单列表 |

### 管理接口 (需管理员 Token)
| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /admin/products | 商品列表 |
| POST | /admin/product | 创建商品 |
| GET | /admin/orders | 订单列表 |
| GET | /admin/users | 用户列表 |

## 项目截图

> 用户端和管理端页面已完整实现

## 开发说明

- 后端使用 GoFrame2 的规范目录结构
- 前端使用 Pinia 进行状态管理
- JWT Token 认证，支持 Redis 黑名单
- 统一的错误码和响应格式

## License

MIT