# schoolGin

**Repository Path**: bbso1/school-gin

## Basic Information

- **Project Name**: schoolGin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-12-29
- **Last Updated**: 2024-12-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 校园二手交易平台后端

这是一个基于 Go 语言和 Gin 框架开发的校园二手交易平台后端 API 服务。

## 功能特性

### 用户系统
- 用户注册/登录
- JWT 认证
- 用户角色管理（普通用户/管理员）
- 用户资料管理
- 头像上传

### 交易系统
- 发布商品
- 商品列表/详情
- 商品搜索
- 商品状态管理
- 多图片上传
- 收藏功能

### 社交功能
- 私信系统
- 商品评论
- 系统通知

### 管理后台
- 用户管理
- 商品管理
- 消息管理
- 数据统计

## 技术栈

- Go 1.16+
- Gin Web Framework
- GORM
- MySQL
- JWT

## 项目结构 

├── config/ # 配置相关

├── handlers/ # 请求处理器

├── middleware/ # 中间件

├── models/ # 数据模型

├── utils/ # 工具函数

├── uploads/ # 上传文件目录

├── main.go # 入口文件

└── README.md

## 快速开始

### 环境要求

- Go 1.16+
- MySQL 5.7+

### 安装

1. 克隆项目

bash

git clone [项目地址]

cd [项目目录]

2. 安装依赖

bash

go mod tidy

3. 配置数据库

sql

CREATE DATABASE campus_trade;

4. 修改配置

编辑 `config/database.go` 文件，配置数据库连接信息。

5. 运行项目

bash

go run main.go

服务将在 `http://localhost:8091` 启动

## API 文档

### 认证相关

#### 用户注册

http

POST /auth/register

Content-Type: application/json

{

"username": "string",

"password": "string",

"nickname": "string",

"phone": "string",

"email": "string"

}

#### 用户登录

http

POST /auth/login

Content-Type: application/json

{

"username": "string",

"password": "string"

}

### 商品相关

#### 获取商品列表

http

GET /trades

Authorization: Bearer <token>

#### 发布商品

http

POST /trades

Authorization: Bearer <token>

Content-Type: application/json

{

"title": "string",

"description": "string",

"price": number,

"original_price": number,

"condition": "string",

"contact": "string"

}

更多 API 详情请参考代码中的路由定义。

## 数据模型

### User 用户

- ID: 用户ID
- Username: 用户名
- Password: 密码（加密存储）
- Nickname: 昵称
- Avatar: 头像
- Role: 角色（user/admin）
- Status: 状态（normal/disabled）

### Trade 商品

- ID: 商品ID
- Title: 标题
- Description: 描述
- Price: 价格
- OriginalPrice: 原价
- Condition: 成色
- Status: 状态（在售/已售出/已下架）
- SellerID: 卖家ID

### Message 私信

- ID: 消息ID
- SenderID: 发送者ID
- ReceiverID: 接收者ID
- Content: 内容
- IsRead: 是否已读

## 注意事项

1. 所有请求（除登录注册外）需要在请求头中携带 token：

http

Authorization: Bearer <token>

2. 图片上传限制：

- 支持格式：jpg/jpeg/png
- 单个文件大小限制：5MB
- 商品最多9张图片

3. 用户权限：

- 普通用户：发布/管理自己的商品
- 管理员：管理所有用户和商品

## 开发团队

- 后端开发：[你的名字]
- 前端开发：[前端开发者]

## 许可证

MIT License

这样就在