114 lines
3.9 KiB
Markdown
114 lines
3.9 KiB
Markdown
|
# 工作日志 - 前后端接口对接
|
|||
|
|
|
|||
|
|
> 日期: 2024年12月26日
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 一、完成的工作
|
|||
|
|
|
|||
|
|
### 1. Android端接口扩展
|
|||
|
|
|
|||
|
|
将 `ApiService.java` 从原来的 6 个接口扩展到 42 个接口，覆盖以下模块：
|
|||
|
|
|
|||
|
|
- 用户认证（4个）
|
|||
|
|
- 用户信息（2个）
|
|||
|
|
- 直播间（6个）
|
|||
|
|
- 直播弹幕（2个）
|
|||
|
|
- 礼物打赏（5个）
|
|||
|
|
- 私聊会话（8个）
|
|||
|
|
- 好友管理（6个）
|
|||
|
|
- 文件上传（1个）
|
|||
|
|
- 在线状态（5个）
|
|||
|
|
- 离线消息（3个）
|
|||
|
|
|
|||
|
|
### 2. 新增数据模型类（17个）
|
|||
|
|
|
|||
|
|
| 文件名 | 说明 |
|
|||
|
|
|--------|------|
|
|||
|
|
| UserInfoResponse.java | 用户信息响应 |
|
|||
|
|
| UserEditRequest.java | 修改用户资料请求 |
|
|||
|
|
| GiftResponse.java | 礼物信息 |
|
|||
|
|
| UserBalanceResponse.java | 用户余额 |
|
|||
|
|
| SendGiftRequest.java | 赠送礼物请求 |
|
|||
|
|
| SendGiftResponse.java | 赠送礼物响应 |
|
|||
|
|
| RechargeOptionResponse.java | 充值选项 |
|
|||
|
|
| CreateRechargeRequest.java | 创建充值订单请求 |
|
|||
|
|
| CreateRechargeResponse.java | 创建充值订单响应 |
|
|||
|
|
| ConversationResponse.java | 会话信息 |
|
|||
|
|
| PrivateMessageResponse.java | 私信消息 |
|
|||
|
|
| SendMessageRequest.java | 发送消息请求 |
|
|||
|
|
| FriendResponse.java | 好友信息 |
|
|||
|
|
| FriendRequestResponse.java | 好友请求 |
|
|||
|
|
| SearchUserResponse.java | 搜索用户结果 |
|
|||
|
|
| PageResponse.java | 分页响应 |
|
|||
|
|
| FileUploadResponse.java | 文件上传响应 |
|
|||
|
|
|
|||
|
|
### 3. 字段匹配修复
|
|||
|
|
|
|||
|
|
检查并修复了 Android 端数据模型与后端返回字段的匹配问题：
|
|||
|
|
|
|||
|
|
| 文件 | 修改内容 |
|
|||
|
|
|------|----------|
|
|||
|
|
| ConversationResponse | 字段改为 id, title, lastMessage, timeText, unreadCount, muted, avatarUrl, otherUserId |
|
|||
|
|
| PrivateMessageResponse | 字段改为 messageId, userId, username, avatarUrl, message, timestamp, status, isSystemMessage |
|
|||
|
|
| SendMessageRequest | 字段改为 message, messageType |
|
|||
|
|
| CreateRechargeRequest | 字段改为 optionId, coinAmount, price |
|
|||
|
|
| UserInfoResponse | 匹配后端 UserCenterResponse |
|
|||
|
|
| UserEditRequest | 简化为 nickname, avatar |
|
|||
|
|
|
|||
|
|
### 4. Git配置修改
|
|||
|
|
|
|||
|
|
修改 `.gitignore`，注释掉 `**/*.jks` 和 `**/*.keystore`，允许签名文件上传到公司仓库。
|
|||
|
|
|
|||
|
|
### 5. 文档编写
|
|||
|
|
|
|||
|
|
- `zhibo/android-app/接口文档.md` - 完整的接口说明文档
|
|||
|
|
- `zhibo/接口对接状态.md` - 三端接口对接状态表格
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 二、接口对接状态
|
|||
|
|
|
|||
|
|
| 端 | 已打通 | 未打通 | 完成度 |
|
|||
|
|
|----|--------|--------|--------|
|
|||
|
|
| Android ↔ 后端 | 42 | 0 | 100% |
|
|||
|
|
| Vue Admin ↔ 后端 | 20+ | 0 | 100% |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 三、待完成事项
|
|||
|
|
|
|||
|
|
1. 支付SDK集成（微信/支付宝）
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 四、修改的文件清单
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
zhibo/
|
|||
|
|
├── .gitignore # 修改：注释jks规则
|
|||
|
|
├── 接口对接状态.md # 新增
|
|||
|
|
├── 工作日志-接口对接.md # 新增
|
|||
|
|
└── android-app/
|
|||
|
|
├── 接口文档.md # 新增
|
|||
|
|
└── app/src/main/java/.../net/
|
|||
|
|
├── ApiService.java # 修改：扩展接口
|
|||
|
|
├── ConversationResponse.java # 修改：字段匹配
|
|||
|
|
├── PrivateMessageResponse.java # 修改：字段匹配
|
|||
|
|
├── SendMessageRequest.java # 修改：字段匹配
|
|||
|
|
├── CreateRechargeRequest.java # 修改：字段匹配
|
|||
|
|
├── UserInfoResponse.java # 修改：字段匹配
|
|||
|
|
├── UserEditRequest.java # 修改：字段匹配
|
|||
|
|
├── GiftResponse.java # 新增
|
|||
|
|
├── UserBalanceResponse.java # 新增
|
|||
|
|
├── SendGiftRequest.java # 新增
|
|||
|
|
├── SendGiftResponse.java # 新增
|
|||
|
|
├── RechargeOptionResponse.java # 新增
|
|||
|
|
├── CreateRechargeResponse.java # 新增
|
|||
|
|
├── FriendResponse.java # 新增
|
|||
|
|
├── FriendRequestResponse.java # 新增
|
|||
|
|
├── SearchUserResponse.java # 新增
|
|||
|
|
├── PageResponse.java # 新增
|
|||
|
|
└── FileUploadResponse.java # 新增
|
|||
|
|
```
|