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>
Showing
1 changed file
with
39 additions
and
27 deletions
| ... | @@ -5,10 +5,10 @@ | ... | @@ -5,10 +5,10 @@ |
| 5 | ## 📊 总体进度 | 5 | ## 📊 总体进度 |
| 6 | 6 | ||
| 7 | - **总接口数**: 14 | 7 | - **总接口数**: 14 |
| 8 | -- **已完成**: 7 (50%) | 8 | +- **已完成**: 9 (64.3%) |
| 9 | - **联调中**: 0 (0%) | 9 | - **联调中**: 0 (0%) |
| 10 | - **已废弃**: 3 (21.4%) | 10 | - **已废弃**: 3 (21.4%) |
| 11 | -- **后端开发中**: 4 (28.6%) | 11 | +- **后端开发中**: 2 (14.3%) |
| 12 | - **有阻塞**: 0 | 12 | - **有阻塞**: 0 |
| 13 | 13 | ||
| 14 | --- | 14 | --- |
| ... | @@ -330,7 +330,7 @@ | ... | @@ -330,7 +330,7 @@ |
| 330 | - **接口名称**: `listAPI` | 330 | - **接口名称**: `listAPI` |
| 331 | - **接口路径**: `/srv/?a=feedback&t=list` | 331 | - **接口路径**: `/srv/?a=feedback&t=list` |
| 332 | - **请求方法**: GET | 332 | - **请求方法**: GET |
| 333 | -- **负责页面**: `src/pages/feedback/index.vue`(待确认) | 333 | +- **负责页面**: `src/pages/feedback-list/index.vue` |
| 334 | - **负责人**: 后端团队 | 334 | - **负责人**: 后端团队 |
| 335 | 335 | ||
| 336 | **接口文档更新记录** | 336 | **接口文档更新记录** |
| ... | @@ -343,21 +343,27 @@ | ... | @@ -343,21 +343,27 @@ |
| 343 | 343 | ||
| 344 | | 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 | | 344 | | 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 | |
| 345 | |------|---------|---------|---------|------| | 345 | |------|---------|---------|---------|------| |
| 346 | -| 2026-02-03 | - | 后端开发中 | - | ⏳ 后端开发中 | | 346 | +| 2026-02-03 | `src/pages/feedback-list/index.vue` | 生命周期钩子导入错误 | `useShow` → `useDidShow` | ✅ 已解决 | |
| 347 | +| 2026-02-03 | `src/pages/feedback-list/index.vue` | `onMounted` 导入错误 | 从 Vue 导入而非 Taro | ✅ 已解决 | | ||
| 348 | +| 2026-02-03 | `src/pages/feedback-list/index.vue` | 图片显示错误 | `images` 改为数组格式处理 | ✅ 已解决 | | ||
| 349 | +| 2026-02-03 | `src/pages/feedback-list/index.vue` | NutUI Loading 组件报错 | 使用自定义 CSS spinner | ✅ 已解决 | | ||
| 350 | +| 2026-02-03 | `src/pages/feedback-list/index.vue` | 联调完成 | 列表加载、分页、图片预览均正常 | ✅ 已完成 | | ||
| 347 | 351 | ||
| 348 | -**接口状态**: ⏳ 后端开发中 | 352 | +**接口状态**: ✅ 已完成 |
| 349 | 353 | ||
| 350 | **备注**: | 354 | **备注**: |
| 351 | -- 参数:page(页码)、limit(每页数量) | 355 | +- 参数:page(页码,从0开始)、limit(每页数量) |
| 352 | - 返回反馈列表,包含状态、类别、图片、回复等信息 | 356 | - 返回反馈列表,包含状态、类别、图片、回复等信息 |
| 353 | -- 后端接口开发中 | 357 | +- 实现位置:`src/pages/feedback-list/index.vue:183-214` |
| 358 | +- 列表支持分页加载和滚动到底部自动加载更多 | ||
| 359 | +- 使用 `useDidShow` 实现从提交页返回时自动刷新列表 | ||
| 354 | 360 | ||
| 355 | --- | 361 | --- |
| 356 | 362 | ||
| 357 | #### 接口 2: 提交意见反馈 | 363 | #### 接口 2: 提交意见反馈 |
| 358 | 364 | ||
| 359 | **接口信息** | 365 | **接口信息** |
| 360 | -- **接口名称**: `submitFeedbackAPI` | 366 | +- **接口名称**: `addAPI` |
| 361 | - **接口路径**: `/srv/?a=feedback&t=add` | 367 | - **接口路径**: `/srv/?a=feedback&t=add` |
| 362 | - **请求方法**: POST | 368 | - **请求方法**: POST |
| 363 | - **负责页面**: `src/pages/feedback/index.vue` | 369 | - **负责页面**: `src/pages/feedback/index.vue` |
| ... | @@ -368,19 +374,24 @@ | ... | @@ -368,19 +374,24 @@ |
| 368 | | 日期 | 版本 | 变更内容 | 变更原因 | 文档链接 | | 374 | | 日期 | 版本 | 变更内容 | 变更原因 | 文档链接 | |
| 369 | |------|------|---------|---------|---------| | 375 | |------|------|---------|---------|---------| |
| 370 | | 2026-02-03 | v1.0 | 初始版本 | - | [查看](#) | | 376 | | 2026-02-03 | v1.0 | 初始版本 | - | [查看](#) | |
| 377 | +| 2026-02-03 | v1.1 | 更新接口名称 | `submitFeedbackAPI` → `addAPI` | [查看](docs/api-specs/feedback/add.md) | | ||
| 378 | +| 2026-02-03 | v1.2 | 更新参数格式 | `images` 改为数组格式 | [查看](docs/api-specs/feedback/add.md) | | ||
| 379 | +| 2026-02-03 | v1.3 | 移除 contact 参数 | 不再需要联系方式字段 | [查看](docs/api-specs/feedback/add.md) | | ||
| 371 | 380 | ||
| 372 | **页面调试情况** | 381 | **页面调试情况** |
| 373 | 382 | ||
| 374 | | 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 | | 383 | | 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 | |
| 375 | |------|---------|---------|---------|------| | 384 | |------|---------|---------|---------|------| |
| 376 | -| 2026-02-03 | - | 后端开发中 | - | ⏳ 后端开发中 | | 385 | +| 2026-02-03 | `src/pages/feedback/index.vue` | 联调完成 | 支持类型选择、图片上传、表单验证 | ✅ 已完成 | |
| 377 | 386 | ||
| 378 | -**接口状态**: ⏳ 后端开发中 | 387 | +**接口状态**: ✅ 已完成 |
| 379 | 388 | ||
| 380 | **备注**: | 389 | **备注**: |
| 381 | -- 参数:category(反馈类别)、note(反馈内容)、contact(联系方式)、images(图片) | 390 | +- 参数:category(反馈类别)、note(反馈内容)、images(图片数组,可选) |
| 382 | -- 类别:1=功能建议, 3=界面设计, 5=车辆新鲜, 7=其他问题 | 391 | +- 类别:1=功能建议, 3=问题反馈, 7=其他问题 |
| 383 | -- 后端接口开发中 | 392 | +- 图片上传限制:最多3张,每张不超过5MB |
| 393 | +- 图片上传支持审核,不通过时提示用户 | ||
| 394 | +- 实现位置:`src/pages/feedback/index.vue:193-232` | ||
| 384 | 395 | ||
| 385 | --- | 396 | --- |
| 386 | 397 | ||
| ... | @@ -507,12 +518,12 @@ | ... | @@ -507,12 +518,12 @@ |
| 507 | ### 本周进度 (2026-01-27 ~ 2026-02-03) | 518 | ### 本周进度 (2026-01-27 ~ 2026-02-03) |
| 508 | 519 | ||
| 509 | - **新增接口**: 14 | 520 | - **新增接口**: 14 |
| 510 | -- **完成联调**: 7 | 521 | +- **完成联调**: 9 |
| 511 | - **已废弃**: 3 | 522 | - **已废弃**: 3 |
| 512 | - **联调中**: 0 | 523 | - **联调中**: 0 |
| 513 | -- **后端开发中**: 4 | 524 | +- **后端开发中**: 2 |
| 514 | -- **发现问题**: 1 | 525 | +- **发现问题**: 5 |
| 515 | -- **解决问题**: 1 | 526 | +- **解决问题**: 5 |
| 516 | 527 | ||
| 517 | ### 历史进度 | 528 | ### 历史进度 |
| 518 | 529 | ||
| ... | @@ -526,8 +537,8 @@ | ... | @@ -526,8 +537,8 @@ |
| 526 | 537 | ||
| 527 | ### 按状态查看 | 538 | ### 按状态查看 |
| 528 | - [✅ 已完成](#用户中心模块) - 6个接口 | 539 | - [✅ 已完成](#用户中心模块) - 6个接口 |
| 540 | +- [✅ 已完成](#意见反馈模块) - 2个接口 | ||
| 529 | - [❌ 已废弃](#通用模块) - 3个接口 | 541 | - [❌ 已废弃](#通用模块) - 3个接口 |
| 530 | -- [⏳ 后端开发中](#意见反馈模块) - 2个接口 | ||
| 531 | - [⏳ 后端开发中](#消息模块) - 2个接口 | 542 | - [⏳ 后端开发中](#消息模块) - 2个接口 |
| 532 | - [⏳ 后端开发中](#首页模块) - 1个接口 | 543 | - [⏳ 后端开发中](#首页模块) - 1个接口 |
| 533 | 544 | ||
| ... | @@ -574,13 +585,14 @@ | ... | @@ -574,13 +585,14 @@ |
| 574 | 585 | ||
| 575 | --- | 586 | --- |
| 576 | 587 | ||
| 577 | -**最后更新时间**: 2026-02-03 20:30 | 588 | +**最后更新时间**: 2026-02-03 22:00 |
| 578 | -**文档版本**: v1.5 | 589 | +**文档版本**: v1.6 |
| 579 | **更新内容**: | 590 | **更新内容**: |
| 580 | -- 更新个人资料接口联调状态:✅ 已完成 | 591 | +- 意见反馈模块联调完成:2个接口 |
| 581 | -- 通用模块接口状态调整:3个七牛云相关接口标记为 ❌ 已废弃 | 592 | + - 意见反馈列表(listAPI):✅ 已完成 |
| 582 | - - 获取七牛上传 Token | 593 | + - 提交意见反馈(addAPI):✅ 已完成 |
| 583 | - - 保存文件信息 | 594 | +- 修复问题: |
| 584 | - - 上传图片到七牛云(完整流程) | 595 | + - 生命周期钩子导入错误(useShow → useDidShow、onMounted 从 Vue 导入) |
| 585 | -- 头像上传方案调整:改用 `Taro.uploadFile` 直接上传到服务器 | 596 | + - 图片显示错误(images 改为数组格式处理) |
| 586 | -- 更新总体进度:14个接口(7个已完成,3个已废弃,4个后端开发中) | 597 | + - NutUI Loading 组件报错(改用自定义 CSS spinner) |
| 598 | +- 更新总体进度:14个接口(9个已完成,3个已废弃,2个后端开发中) | ... | ... |
-
Please register or login to post a comment