Hooke / manulife-weapp

Go to a project
Toggle navigation Toggle navigation pinning
hookehuyr
28039999 1 parent 87ee2922

docs(api-integration): 更新接口联调记录 

意见反馈模块联调完成：
- 意见反馈列表（listAPI）：✅ 已完成
- 提交意见反馈（addAPI）：✅ 已完成

修复问题记录：
- 生命周期钩子导入错误（useShow → useDidShow）
- onMounted 导入错误（从 Vue 导入）
- 图片显示错误（数组格式处理）
- NutUI Loading 组件报错（自定义 CSS spinner）

更新总体进度：9个已完成，3个已废弃，2个后端开发中

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Inline Side-by-side
Showing 1 changed file with 39 additions and 27 deletions
......@@ -5,10 +5,10 @@
## 📊 总体进度
- **总接口数**: 14
- **已完成**: 7 (50%)
- **已完成**: 9 (64.3%)
- **联调中**: 0 (0%)
- **已废弃**: 3 (21.4%)
- **后端开发中**: 4 (28.6%)
- **后端开发中**: 2 (14.3%)
- **有阻塞**: 0
---
......@@ -330,7 +330,7 @@
- **接口名称**: `listAPI`
- **接口路径**: `/srv/?a=feedback&t=list`
- **请求方法**: GET
- **负责页面**: `src/pages/feedback/index.vue`（待确认）
- **负责页面**: `src/pages/feedback-list/index.vue`
- **负责人**: 后端团队
**接口文档更新记录**
......@@ -343,21 +343,27 @@
| 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 |
|------|---------|---------|---------|------|
| 2026-02-03 | - | 后端开发中 | - | ⏳ 后端开发中 |
| 2026-02-03 | `src/pages/feedback-list/index.vue` | 生命周期钩子导入错误 | `useShow` → `useDidShow` | ✅ 已解决 |
| 2026-02-03 | `src/pages/feedback-list/index.vue` | `onMounted` 导入错误 | 从 Vue 导入而非 Taro | ✅ 已解决 |
| 2026-02-03 | `src/pages/feedback-list/index.vue` | 图片显示错误 | `images` 改为数组格式处理 | ✅ 已解决 |
| 2026-02-03 | `src/pages/feedback-list/index.vue` | NutUI Loading 组件报错 | 使用自定义 CSS spinner | ✅ 已解决 |
| 2026-02-03 | `src/pages/feedback-list/index.vue` | 联调完成 | 列表加载、分页、图片预览均正常 | ✅ 已完成 |
**接口状态**: ⏳ 后端开发中
**接口状态**: ✅ 已完成
**备注**:
- 参数：page（页码）、limit（每页数量）
- 参数：page（页码，从0开始）、limit（每页数量）
- 返回反馈列表，包含状态、类别、图片、回复等信息
- 后端接口开发中
- 实现位置：`src/pages/feedback-list/index.vue:183-214`
- 列表支持分页加载和滚动到底部自动加载更多
- 使用 `useDidShow` 实现从提交页返回时自动刷新列表
---
#### 接口 2: 提交意见反馈
**接口信息**
- **接口名称**: `submitFeedbackAPI`
- **接口名称**: `addAPI`
- **接口路径**: `/srv/?a=feedback&t=add`
- **请求方法**: POST
- **负责页面**: `src/pages/feedback/index.vue`
......@@ -368,19 +374,24 @@
| 日期 | 版本 | 变更内容 | 变更原因 | 文档链接 |
|------|------|---------|---------|---------|
| 2026-02-03 | v1.0 | 初始版本 | - | [查看](#) |
| 2026-02-03 | v1.1 | 更新接口名称 | `submitFeedbackAPI` → `addAPI` | [查看](docs/api-specs/feedback/add.md) |
| 2026-02-03 | v1.2 | 更新参数格式 | `images` 改为数组格式 | [查看](docs/api-specs/feedback/add.md) |
| 2026-02-03 | v1.3 | 移除 contact 参数 | 不再需要联系方式字段 | [查看](docs/api-specs/feedback/add.md) |
**页面调试情况**
| 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 |
|------|---------|---------|---------|------|
| 2026-02-03 | - | 后端开发中 | - | ⏳ 后端开发中 |
| 2026-02-03 | `src/pages/feedback/index.vue` | 联调完成 | 支持类型选择、图片上传、表单验证 | ✅ 已完成 |
**接口状态**: ⏳ 后端开发中
**接口状态**: ✅ 已完成
**备注**:
- 参数：category（反馈类别）、note（反馈内容）、contact（联系方式）、images（图片）
- 类别：1=功能建议, 3=界面设计, 5=车辆新鲜, 7=其他问题
- 后端接口开发中
- 参数：category（反馈类别）、note（反馈内容）、images（图片数组，可选）
- 类别：1=功能建议, 3=问题反馈, 7=其他问题
- 图片上传限制：最多3张，每张不超过5MB
- 图片上传支持审核，不通过时提示用户
- 实现位置：`src/pages/feedback/index.vue:193-232`
---
......@@ -507,12 +518,12 @@
### 本周进度 (2026-01-27 ~ 2026-02-03)
- **新增接口**: 14
- **完成联调**: 7
- **完成联调**: 9
- **已废弃**: 3
- **联调中**: 0
- **后端开发中**: 4
- **发现问题**: 1
- **解决问题**: 1
- **后端开发中**: 2
- **发现问题**: 5
- **解决问题**: 5
### 历史进度
......@@ -526,8 +537,8 @@
### 按状态查看
- [✅ 已完成](#用户中心模块) - 6个接口
- [✅ 已完成](#意见反馈模块) - 2个接口
- [❌ 已废弃](#通用模块) - 3个接口
- [⏳ 后端开发中](#意见反馈模块) - 2个接口
- [⏳ 后端开发中](#消息模块) - 2个接口
- [⏳ 后端开发中](#首页模块) - 1个接口
......@@ -574,13 +585,14 @@
---
**最后更新时间**: 2026-02-03 20:30
**文档版本**: v1.5
**最后更新时间**: 2026-02-03 22:00
**文档版本**: v1.6
**更新内容**:
- 更新个人资料接口联调状态：✅ 已完成
- 通用模块接口状态调整：3个七牛云相关接口标记为 ❌ 已废弃
- 获取七牛上传 Token
- 保存文件信息
- 上传图片到七牛云（完整流程）
- 头像上传方案调整：改用 `Taro.uploadFile` 直接上传到服务器
- 更新总体进度：14个接口（7个已完成，3个已废弃，4个后端开发中）
- 意见反馈模块联调完成：2个接口
- 意见反馈列表（listAPI）：✅ 已完成
- 提交意见反馈（addAPI）：✅ 已完成
- 修复问题：
- 生命周期钩子导入错误（useShow → useDidShow、onMounted 从 Vue 导入）
- 图片显示错误（images 改为数组格式处理）
- NutUI Loading 组件报错（改用自定义 CSS spinner）
- 更新总体进度：14个接口（9个已完成，3个已废弃，2个后端开发中）
......