# php-awesome-api

**Repository Path**: oshine/php-awesome-api

## Basic Information

- **Project Name**: php-awesome-api
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-23
- **Last Updated**: 2026-03-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 后端API设计文档

## 数据库结构

数据库结构：memory.sql

### 现有表
- `member` - 用户表
- `talk` - 话题表
- `comment_talk` - 评论表

### 新增表
- `section` - 栏目表
- `checkin` - 签到表

## API接口

### 1. 用户登录
- **URL**: `/api/login`
- **方法**: POST
- **参数**:
  - `username`: 用户名
  - `password`: 密码
- **返回**:
  - `token`: 登录凭证
  - `user_info`: 用户信息

### 2. 发帖
- **URL**: `/api/talk/create`
- **方法**: POST
- **参数**:
  - `title`: 标题
  - `content`: 内容
  - `section_id`: 栏目ID
  - `images`: 图片文件（可选）
- **返回**:
  - `id`: 帖子ID
  - `status`: 状态

### 3. 获取帖子列表
- **URL**: `/api/talk/list`
- **方法**: GET
- **参数**:
  - `type`: 类型（public: 公开，personal: 个人）
  - `page`: 页码
  - `limit`: 每页数量
- **返回**:
  - `list`: 帖子列表
  - `total`: 总数

### 4. 签到
- **URL**: `/api/checkin`
- **方法**: POST
- **参数**:
  - 无（使用登录凭证）
- **返回**:
  - `status`: 状态
  - `coin`: 获得的铜币

### 5. 获取栏目列表
- **URL**: `/api/section/list`
- **方法**: GET
- **返回**:
  - `list`: 栏目列表

## 业务逻辑

1. **登录**：验证用户名密码，生成token
2. **发帖**：检查用户铜币是否足够（20铜币），扣除铜币，创建帖子
3. **签到**：检查是否已签到（按天），未签到则添加签到记录，增加20铜币
4. **查看帖子**：公开帖子所有人可见，个人帖子仅本人可见

## 注意事项

- 所有API需要验证token
- 图片上传需要处理文件存储
- 铜币操作需要事务处理，确保数据一致性

注意接口返回数据时： return $this->renderJSON(0, '获取成功', ['list' => $list]);   ERROR_CODE_SUCCESS 表示成功，ERROR_CODE_FAIL表示失败