Hooke / manulife-weapp

Go to a project
Toggle navigation Toggle navigation pinning
Switch branch/tag
api-integration-log.md 18.3 KB

接口联调工作记录

记录接口文档更新情况和页面实际调试情况

📊 总体进度

  • 总接口数: 14
  • 已完成: 9 (64.3%)
  • 联调中: 0 (0%)
  • 已废弃: 3 (21.4%)
  • 后端开发中: 2 (14.3%)
  • 有阻塞: 0

📝 接口联调明细

用户中心模块

接口 1: 小程序授权

接口信息

  • 接口名称: miniProgramAuthAPI
  • 接口路径: /srv/?a=openid
  • 请求方法: POST
  • 负责页面: src/utils/openid.js (全局工具)
  • 负责人: 后端团队

接口文档更新记录

日期 版本 变更内容 变更原因 文档链接
2026-02-03 v1.0 初始版本 - 查看

页面调试情况

日期 调试页面 问题记录 解决方案 状态
2026-02-03 src/utils/openid.js 无 - ✅ 已完成

接口状态: ✅ 已完成

备注:

  • 调用 wx.login 获取 code，后端返回 openid
  • 授权成功后自动将 sessionid 写入本地存储
  • 如果用户已绑定账号，授权接口会自动登录并返回用户信息
  • 实现位置：src/utils/openid.js:miniProgramAuth()

接口 2: 查询登录状态

接口信息

  • 接口名称: loginStatusAPI
  • 接口路径: /srv/?a=user&t=login_status
  • 请求方法: GET
  • 负责页面: src/stores/user.js (全局状态管理)
  • 负责人: 后端团队

接口文档更新记录

日期 版本 变更内容 变更原因 文档链接
2026-02-03 v1.0 初始版本 - 查看

页面调试情况

日期 调试页面 问题记录 解决方案 状态
2026-02-03 src/stores/user.js 无 - ✅ 已完成

接口状态: ✅ 已完成

备注:

  • 返回 is_login (是否登录) 和 is_openid (是否已授权) 两个字段
  • 小程序启动时调用，用于判断是否需要展示登录页
  • 实现位置：src/stores/user.js:checkLoginStatus()

接口 3: 获取个人信息

接口信息

  • 接口名称: getProfileAPI
  • 接口路径: /srv/?a=user&t=get_profile
  • 请求方法: GET
  • 负责页面: src/pages/mine/index.vue
  • 负责人: 后端团队

接口文档更新记录

日期 版本 变更内容 变更原因 文档链接
2026-02-03 v1.0 初始版本 - 查看

页面调试情况

日期 调试页面 问题记录 解决方案 状态
2026-02-03 src/pages/mine/index.vue 无 - ✅ 已完成

接口状态: ✅ 已完成

备注:

  • 返回用户信息：id、avatar_url、name
  • 在"我的"页面加载时调用
  • 401 自动跳转登录页（由 request.js 拦截器处理）
  • 实现位置：src/pages/mine/index.vue:fetchUserProfile()

接口 4: 退出登录

接口信息

  • 接口名称: logoutAPI
  • 接口路径: /srv/?a=user&t=logout
  • 请求方法: POST
  • 负责页面: src/pages/mine/index.vue
  • 负责人: 后端团队

接口文档更新记录

日期 版本 变更内容 变更原因 文档链接
2026-02-03 v1.0 初始版本 - 查看

页面调试情况

日期 调试页面 问题记录 解决方案 状态
2026-02-03 src/pages/mine/index.vue 无 - ✅ 已完成

接口状态: ✅ 已完成

备注:

  • 解绑 openid 并清除登录状态
  • 调用成功后清除本地状态并跳转到首页
  • 实现位置：src/pages/mine/index.vue:handleLogout()

接口 5: 登录（邮箱账号密码）

接口信息

  • 接口名称: loginAPI
  • 接口路径: /srv/?a=user&t=login
  • 请求方法: POST
  • 负责页面: src/pages/login/index.vue
  • 负责人: 后端团队

接口文档更新记录

日期 版本 变更内容 变更原因 文档链接
2026-02-03 v1.0 初始版本 - 查看

页面调试情况

日期 调试页面 问题记录 解决方案 状态
2026-02-03 src/pages/login/index.vue 无 - ✅ 已完成
2026-02-03 src/pages/login/index.vue 联调完成 接口正常工作 ✅ 已完成

接口状态: ✅ 已完成

备注:

  • 邮箱账号密码登录
  • 参数：uuid（邮箱）、password（密码）
  • 登录成功后获取用户信息
  • 实现位置：src/stores/user.js:login()

接口 6: 更新个人资料

接口信息

  • 接口名称: updateProfileAPI
  • 接口路径: /srv/?a=user&t=update_profile
  • 请求方法: POST
  • 负责页面: src/pages/avatar/index.vue
  • 负责人: 后端团队

接口文档更新记录

日期 版本 变更内容 变更原因 文档链接
2026-02-03 v1.0 初始版本 - 查看

页面调试情况

日期 调试页面 问题记录 解决方案 状态
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（已废弃）

接口信息

  • 接口名称: qiniuTokenAPI
  • 接口路径: /srv/?a=upload
  • 请求方法: POST
  • 负责页面: src/pages/avatar/index.vue（已废弃）
  • 负责人: 后端团队

接口文档更新记录

日期 版本 变更内容 变更原因 文档链接
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: 保存文件信息（已废弃）

接口信息

  • 接口名称: saveFileAPI
  • 接口路径: /srv/?a=upload&t=save_file
  • 请求方法: POST
  • 负责页面: src/pages/avatar/index.vue（已废弃）
  • 负责人: 后端团队

接口文档更新记录

日期 版本 变更内容 变更原因 文档链接
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: 上传图片到七牛云（完整流程）（已废弃）

接口信息

  • 接口名称: uploadImageToQiniuAPI
  • 接口路径: 封装接口（内部调用 qiniuTokenAPI、七牛上传、saveFileAPI）
  • 请求方法: 封装函数
  • 负责页面: src/pages/avatar/index.vue（已废弃）
  • 负责人: 后端团队

接口文档更新记录

日期 版本 变更内容 变更原因 文档链接
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）
  • 新上传流程：
    1. 使用 Taro.chooseImage 选择图片
    2. 使用 Taro.uploadFile 直接上传到服务器
    3. 服务器返回图片 URL（支持图片审核）
  • 实现位置：src/api/common.js:77-150（已废弃）
  • 新实现位置：src/pages/avatar/index.vue:75-115

意见反馈模块

接口 1: 意见反馈列表

接口信息

  • 接口名称: listAPI
  • 接口路径: /srv/?a=feedback&t=list
  • 请求方法: GET
  • 负责页面: src/pages/feedback-list/index.vue
  • 负责人: 后端团队

接口文档更新记录

日期 版本 变更内容 变更原因 文档链接
2026-02-03 v1.0 初始版本 - 查看

页面调试情况

日期 调试页面 问题记录 解决方案 状态
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（页码，从0开始）、limit（每页数量）
  • 返回反馈列表，包含状态、类别、图片、回复等信息
  • 实现位置：src/pages/feedback-list/index.vue:183-214
  • 列表支持分页加载和滚动到底部自动加载更多
  • 使用 useDidShow 实现从提交页返回时自动刷新列表

接口 2: 提交意见反馈

接口信息

  • 接口名称: addAPI
  • 接口路径: /srv/?a=feedback&t=add
  • 请求方法: POST
  • 负责页面: src/pages/feedback/index.vue
  • 负责人: 后端团队

接口文档更新记录

日期 版本 变更内容 变更原因 文档链接
2026-02-03 v1.0 初始版本 - 查看
2026-02-03 v1.1 更新接口名称 submitFeedbackAPI → addAPI 查看
2026-02-03 v1.2 更新参数格式 images 改为数组格式 查看
2026-02-03 v1.3 移除 contact 参数 不再需要联系方式字段 查看

页面调试情况

日期 调试页面 问题记录 解决方案 状态
2026-02-03 src/pages/feedback/index.vue 联调完成 支持类型选择、图片上传、表单验证 ✅ 已完成

接口状态: ✅ 已完成

备注:

  • 参数：category（反馈类别）、note（反馈内容）、images（图片数组，可选）
  • 类别：1=功能建议, 3=问题反馈, 7=其他问题
  • 图片上传限制：最多3张，每张不超过5MB
  • 图片上传支持审核，不通过时提示用户
  • 实现位置：src/pages/feedback/index.vue:193-232

消息模块

接口 1: 我的消息列表

接口信息

  • 接口名称: myListAPI
  • 接口路径: /srv/?a=website_msg&t=my_list
  • 请求方法: GET
  • 负责页面: 待确认
  • 负责人: 后端团队

接口文档更新记录

日期 版本 变更内容 变更原因 文档链接
2026-02-03 v1.0 初始版本 - 查看

页面调试情况

日期 调试页面 问题记录 解决方案 状态
2026-02-03 - 后端开发中 - ⏳ 后端开发中

接口状态: ⏳ 后端开发中

备注:

  • 参数：page（页码）、limit（每页数量）
  • 返回用户消息列表
  • 后端接口开发中

接口 2: 消息详情

接口信息

  • 接口名称: detailAPI
  • 接口路径: /srv/?a=website_msg&t=detail
  • 请求方法: GET
  • 负责页面: 待确认
  • 负责人: 后端团队

接口文档更新记录

日期 版本 变更内容 变更原因 文档链接
2026-02-03 v1.0 初始版本 - 查看

页面调试情况

日期 调试页面 问题记录 解决方案 状态
2026-02-03 - 后端开发中 - ⏳ 后端开发中

接口状态: ⏳ 后端开发中

备注:

  • 参数：i（消息ID）
  • 返回消息详情
  • 后端接口开发中

模块模板

复制下方模板添加新接口：

#### 接口 X: [接口名称]

**接口信息**
- **接口名称**: `xxx`
- **接口路径**: `/srv/?a=xxx`
- **请求方法**: GET/POST
- **负责页面**: `src/pages/xxx/index.vue`
- **负责人**: XXX

**接口文档更新记录**

| 日期 | 版本 | 变更内容 | 变更原因 | 文档链接 |
|------|------|---------|---------|---------|
| YYYY-MM-DD | vX.X | - | - | [查看](#) |

**页面调试情况**

| 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 |
|------|---------|---------|---------|------|
| YYYY-MM-DD | `pages/xxx/index.vue` | - | - | ⏳ 未开始 |

**接口状态**: ⏳ 未开始

**备注**:
-

🔍 问题汇总

高优先级问题 🔴

问题描述 接口名称 负责人 预计解决时间
- - - -

中优先级问题 🟡

问题描述 接口名称 负责人 预计解决时间
- - - -

低优先级问题 🟢

问题描述 接口名称 负责人 预计解决时间
- - - -

📈 进度追踪

本周进度 (2026-01-27 ~ 2026-02-03)

  • 新增接口: 14
  • 完成联调: 9
  • 已废弃: 3
  • 联调中: 0
  • 后端开发中: 2
  • 发现问题: 5
  • 解决问题: 5

历史进度

周 完成数 新增数 废弃数 问题数
2026-01-27 ~ 2026-02-03 7 14 3 0

📌 快速索引

按状态查看

按模块查看

按负责人查看

📖 使用说明

状态标识

  • ✅ 已完成 - 接口正常工作，测试通过
  • 🔄 联调中 - 正在调试，部分功能可用
  • ⏳ 未开始 - 尚未开始联调
  • ⚠️ 有阻塞 - 遇到阻塞问题，无法继续

优先级标识

  • 🔴 高优先级 - 影响核心功能，需要立即处理
  • 🟡 中优先级 - 影响次要功能，需要尽快处理
  • 🟢 低优先级 - 优化类问题，可以稍后处理

记录时机

  • 接口文档更新时: 记录到"接口文档更新记录"表格
  • 页面联调时: 记录到"页面调试情况"表格
  • 发现问题: 记录到对应接口的调试情况，并同步到"问题汇总"
  • 解决问题: 更新调试情况的状态，并从"问题汇总"中移除或标记为已解决

维护建议

  1. 定期更新: 每天结束前更新当天的工作记录
  2. 同步会议: 在前后端对接会议上，根据此文档讨论问题
  3. 版本控制: 重要的接口变更应该提交到 Git，便于追溯

最后更新时间: 2026-02-03 22:00 文档版本: v1.6 更新内容:

  • 意见反馈模块联调完成：2个接口
    • 意见反馈列表（listAPI）：✅ 已完成
    • 提交意见反馈（addAPI）：✅ 已完成
  • 修复问题：
    • 生命周期钩子导入错误（useShow → useDidShow、onMounted 从 Vue 导入）
    • 图片显示错误（images 改为数组格式处理）
    • NutUI Loading 组件报错（改用自定义 CSS spinner）
  • 更新总体进度：14个接口（9个已完成，3个已废弃，2个后端开发中）