hookehuyr

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>
...@@ -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个后端开发中)
......