zhibo/模块文档/01-用户系统模块.md

# 用户系统模块接口文档

## 模块概述
用户系统模块提供用户注册、登录、资料管理等基础功能。

---

## 接口列表

### 1. 账号密码登录

**接口路径**: `POST /api/front/login`

**请求参数**:
```json
{
  "account": "手机号",
  "password": "密码"
}
```

**返回参数**:
```json
{
  "code": 200,
  "msg": "success",
  "data": {
    "token": "JWT令牌",
    "uid": 用户ID,
    "nikeName": "昵称",
    "phone": "手机号"
  }
}
```

---

### 2. APP用户注册

**接口路径**: `POST /api/front/register`

**请求参数**:
```json
{
  "phone": "手机号",
  "password": "密码",
  "verificationCode": "验证码(可选)",
  "nickname": "昵称(可选)"
}
```

**返回参数**:
```json
{
  "code": 200,
  "msg": "success",
  "data": {
    "token": "JWT令牌",
    "uid": 用户ID,
    "nikeName": "昵称",
    "phone": "手机号"
  }
}
```

---

### 3. 发送短信验证码

**接口路径**: `POST /api/front/sendCode`

**请求参数**:
```
phone=手机号 (FormUrlEncoded格式)
```

**返回参数**:
```json
{
  "code": 200,
  "msg": "发送成功"
}
```

---

### 4. 获取用户信息

**接口路径**: `GET /api/front/user`

**请求头**:
```
Authorization: Bearer {token}
```

**请求参数**: 无

**返回参数**:
```json
{
  "code": 200,
  "msg": "success",
  "data": {
    "uid": 用户ID,
    "nickname": "昵称",
    "avatar": "头像URL",
    "phone": "手机号",
    "balance": 余额,
    "integral": 积分,
    "experience": 经验值,
    "level": 等级
  }
}
```

---

### 5. 更新用户资料

**接口路径**: `POST /api/front/user/edit`

**请求头**:
```
Authorization: Bearer {token}
```

**请求参数**:
```json
{
  "nickname": "昵称",
  "avatar": "头像URL"
}
```

**返回参数**:
```json
{
  "code": 200,
  "msg": "success"
}
```

---

### 6. 上传头像

**接口路径**: `POST /api/front/user/upload/image`

**请求头**:
```
Authorization: Bearer {token}
Content-Type: multipart/form-data
```

**请求参数**:
```
file: 图片文件
model: "user"
pid: 7
```

**返回参数**:
```json
{
  "code": 200,
  "msg": "success",
  "data": {
    "url": "图片URL",
    "name": "文件名",
    "size": 文件大小
  }
}
```

---

### 7. 退出登录

**接口路径**: `GET /api/front/logout`

**请求头**:
```
Authorization: Bearer {token}
```

**请求参数**: 无

**返回参数**:
```json
{
  "code": 200,
  "msg": "success"
}
```