hookehuyr

docs(api): 更新头像上传接口联调记录

- 更新个人资料接口状态为 ✅ 已完成
- 通用模块七牛云相关接口标记为 ❌ 已废弃(3个)
- 头像上传方案调整:改用 Taro.uploadFile 直接上传
- 更新总体进度统计

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
......@@ -5,9 +5,10 @@
## 📊 总体进度
- **总接口数**: 14
- **已完成**: 5 (35.7%)
- **已完成**: 7 (50%)
- **联调中**: 0 (0%)
- **后端开发中**: 9 (64.3%)
- **已废弃**: 3 (21.4%)
- **后端开发中**: 4 (28.6%)
- **有阻塞**: 0
---
......@@ -176,7 +177,7 @@
- **接口名称**: `updateProfileAPI`
- **接口路径**: `/srv/?a=user&t=update_profile`
- **请求方法**: POST
- **负责页面**: `src/pages/avatar/index.vue`(待确认)
- **负责页面**: `src/pages/avatar/index.vue`
- **负责人**: 后端团队
**接口文档更新记录**
......@@ -189,26 +190,28 @@
| 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 |
|------|---------|---------|---------|------|
| 2026-02-03 | - | 后端开发中 | - | ⏳ 后端开发中 |
| 2026-02-03 | `src/pages/avatar/index.vue` | 后端开发中 | - | ⏳ 后端开发中 |
| 2026-02-03 | `src/pages/avatar/index.vue` | 联调完成 | 改用直接上传方式 | ✅ 已完成 |
**接口状态**: ⏳ 后端开发中
**接口状态**: ✅ 已完成
**备注**:
- 参数:avatar_url(头像URL)
- 用于用户修改头像
- 后端接口开发中
- 联调完成,接口正常工作
- 实现位置:`src/pages/avatar/index.vue:121-163`
---
### 通用模块
#### 接口 1: 获取七牛上传 Token
#### 接口 1: 获取七牛上传 Token(已废弃)
**接口信息**
- **接口名称**: `qiniuTokenAPI`
- **接口路径**: `/srv/?a=upload`
- **请求方法**: POST
- **负责页面**: `src/pages/avatar/index.vue`待确认
- **负责页面**: `src/pages/avatar/index.vue`已废弃
- **负责人**: 后端团队
**接口文档更新记录**
......@@ -216,29 +219,36 @@
| 日期 | 版本 | 变更内容 | 变更原因 | 文档链接 |
|------|------|---------|---------|---------|
| 2026-02-03 | v1.0 | 初始版本 | - | [查看](#) |
| 2026-02-03 | v1.1 | 标记为已废弃 | 改用直接上传方式 | [查看](#) |
**页面调试情况**
| 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 |
|------|---------|---------|---------|------|
| 2026-02-03 | - | 后端开发中 | - | ⏳ 后端开发中 |
| 2026-02-03 | - | 方案调整 | 改用 Taro.uploadFile 直接上传 | ❌ 已废弃 |
**接口状态**: ⏳ 后端开发中
**接口状态**: ❌ 已废弃
**废弃原因**:
- 头像上传改用 `Taro.uploadFile` 直接上传到服务器(参考老来赛项目)
- 不再需要七牛云上传流程
- 简化了上传流程,减少了接口调用次数
**备注**:
- 参数:filename(文件名)、file(图片 base64)
- 返回七牛上传 token、upload_url、filekey
- 后端接口开发中
- 实现位置:`src/api/common.js:32`
---
#### 接口 2: 保存文件信息
#### 接口 2: 保存文件信息(已废弃)
**接口信息**
- **接口名称**: `saveFileAPI`
- **接口路径**: `/srv/?a=upload&t=save_file`
- **请求方法**: POST
- **负责页面**: `src/pages/avatar/index.vue`待确认
- **负责页面**: `src/pages/avatar/index.vue`已废弃
- **负责人**: 后端团队
**接口文档更新记录**
......@@ -246,29 +256,35 @@
| 日期 | 版本 | 变更内容 | 变更原因 | 文档链接 |
|------|------|---------|---------|---------|
| 2026-02-03 | v1.0 | 初始版本 | - | [查看](#) |
| 2026-02-03 | v1.1 | 标记为已废弃 | 改用直接上传方式 | [查看](#) |
**页面调试情况**
| 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 |
|------|---------|---------|---------|------|
| 2026-02-03 | - | 后端开发中 | - | ⏳ 后端开发中 |
| 2026-02-03 | - | 方案调整 | 改用 Taro.uploadFile 直接上传 | ❌ 已废弃 |
**接口状态**: ⏳ 后端开发中
**接口状态**: ❌ 已废弃
**废弃原因**:
- 头像上传改用 `Taro.uploadFile` 直接上传到服务器
- 不再需要七牛云上传后保存文件信息的流程
**备注**:
- 参数:format(文件格式)、hash(文件 hash)、height(图片高)、width(图片宽)、filekey(文件 key)
- 七牛上传成功后,将文件信息保存到服务器
- 后端接口开发中
- 实现位置:`src/api/common.js:53`
---
#### 接口 3: 上传图片到七牛云(完整流程)
#### 接口 3: 上传图片到七牛云(完整流程)(已废弃)
**接口信息**
- **接口名称**: `uploadImageToQiniuAPI`
- **接口路径**: 封装接口(内部调用 `qiniuTokenAPI`、七牛上传、`saveFileAPI`
- **请求方法**: 封装函数
- **负责页面**: `src/pages/avatar/index.vue`
- **负责页面**: `src/pages/avatar/index.vue`(已废弃)
- **负责人**: 后端团队
**接口文档更新记录**
......@@ -276,25 +292,33 @@
| 日期 | 版本 | 变更内容 | 变更原因 | 文档链接 |
|------|------|---------|---------|---------|
| 2026-02-03 | v1.0 | 初始版本 | - | [查看](#) |
| 2026-02-03 | v1.1 | 标记为已废弃 | 改用直接上传方式 | [查看](#) |
**页面调试情况**
| 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 |
|------|---------|---------|---------|------|
| 2026-02-03 | `src/pages/avatar/index.vue` | 后端开发中 | - | ⏳ 后端开发中 |
| 2026-02-03 | `src/pages/avatar/index.vue` | 方案调整 | 改用 Taro.uploadFile 直接上传 | ❌ 已废弃 |
**接口状态**: ⏳ 后端开发中
**接口状态**: ❌ 已废弃
**废弃原因**:
- 改用 `Taro.uploadFile` 直接上传到服务器(`/admin/?m=srv&a=upload&image_audit=1`
- 不再需要七牛云上传流程,简化了实现
**备注**:
- 完整的上传流程:
- 原完整上传流程:
1. 读取本地文件为 base64
2. 获取七牛上传 token(调用 `qiniuTokenAPI`
3. 上传到七牛云(调用 `qiniuUploadAPI`
4. 保存文件信息到服务器(调用 `saveFileAPI`
- 参数:filePath(本地文件路径)
- 返回:`{ code: 1, data: { src, hash, format, width, height } }`
- 后端接口开发中
- 实现位置:`src/api/common.js:77-150`
- 新上传流程:
1. 使用 `Taro.chooseImage` 选择图片
2. 使用 `Taro.uploadFile` 直接上传到服务器
3. 服务器返回图片 URL(支持图片审核)
- 实现位置:`src/api/common.js:77-150`(已废弃)
- 新实现位置:`src/pages/avatar/index.vue:75-115`
---
......@@ -483,33 +507,33 @@
### 本周进度 (2026-01-27 ~ 2026-02-03)
- **新增接口**: 14
- **完成联调**: 5
- **完成联调**: 7
- **已废弃**: 3
- **联调中**: 0
- **后端开发中**: 9
- **发现问题**: 0
- **解决问题**: 0
- **后端开发中**: 4
- **发现问题**: 1
- **解决问题**: 1
### 历史进度
| 周 | 完成数 | 新增数 | 问题数 |
|----|--------|--------|--------|
| 2026-01-27 ~ 2026-02-03 | 5 | 14 | 0 |
| 周 | 完成数 | 新增数 | 废弃数 | 问题数 |
|----|--------|--------|--------|--------|
| 2026-01-27 ~ 2026-02-03 | 7 | 14 | 3 | 0 |
---
## 📌 快速索引
### 按状态查看
- [✅ 已完成](#用户中心模块) - 5个接口
- [⏳ 后端开发中](#用户中心模块) - 1个接口
- [⏳ 后端开发中](#通用模块) - 3个接口
- [✅ 已完成](#用户中心模块) - 6个接口
- [❌ 已废弃](#通用模块) - 3个接口
- [⏳ 后端开发中](#意见反馈模块) - 2个接口
- [⏳ 后端开发中](#消息模块) - 2个接口
- [⏳ 后端开发中](#首页模块) - 1个接口
### 按模块查看
- [用户中心](#用户中心模块) - ✅ 5个已完成, ⏳ 1个后端开发中
- [通用](#通用模块) - ⏳ 3个后端开发中
- [用户中心](#用户中心模块) - ✅ 6个已完成
- [通用](#通用模块) - ❌ 3个已废弃
- [意见反馈](#意见反馈模块) - ⏳ 2个后端开发中
- [消息](#消息模块) - ⏳ 2个后端开发中
- [首页](#首页模块) - ⏳ 1个后端开发中
......@@ -550,8 +574,13 @@
---
**最后更新时间**: 2026-02-03 18:00
**文档版本**: v1.4
**最后更新时间**: 2026-02-03 20:30
**文档版本**: v1.5
**更新内容**:
- 新增通用模块接口:获取七牛上传 Token、保存文件信息、上传图片到七牛云(完整流程)
- 更新总体进度:14个接口(5个已完成,9个后端开发中)
- 更新个人资料接口联调状态:✅ 已完成
- 通用模块接口状态调整:3个七牛云相关接口标记为 ❌ 已废弃
- 获取七牛上传 Token
- 保存文件信息
- 上传图片到七牛云(完整流程)
- 头像上传方案调整:改用 `Taro.uploadFile` 直接上传到服务器
- 更新总体进度:14个接口(7个已完成,3个已废弃,4个后端开发中)
......