api-integration-log.md
17 KB
接口联调工作记录
记录接口文档更新情况和页面实际调试情况
📊 总体进度
- 总接口数: 14
- 已完成: 7 (50%)
- 联调中: 0 (0%)
- 已废弃: 3 (21.4%)
- 后端开发中: 4 (28.6%)
- 有阻塞: 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） - 不再需要七牛云上传流程，简化了实现
备注:
- 原完整上传流程：
- 读取本地文件为 base64
- 获取七牛上传 token（调用
qiniuTokenAPI） - 上传到七牛云（调用
qiniuUploadAPI） - 保存文件信息到服务器（调用
saveFileAPI）
- 新上传流程：
- 使用
Taro.chooseImage选择图片 - 使用
Taro.uploadFile直接上传到服务器 - 服务器返回图片 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/index.vue（待确认） - 负责人: 后端团队
接口文档更新记录
| 日期 | 版本 | 变更内容 | 变更原因 | 文档链接 |
|---|---|---|---|---|
| 2026-02-03 | v1.0 | 初始版本 | - | 查看 |
页面调试情况
| 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 |
|---|---|---|---|---|
| 2026-02-03 | - | 后端开发中 | - | ⏳ 后端开发中 |
接口状态: ⏳ 后端开发中
备注:
- 参数：page（页码）、limit（每页数量）
- 返回反馈列表，包含状态、类别、图片、回复等信息
- 后端接口开发中
接口 2: 提交意见反馈
接口信息
-
接口名称:
submitFeedbackAPI -
接口路径:
/srv/?a=feedback&t=add - 请求方法: POST
-
负责页面:
src/pages/feedback/index.vue - 负责人: 后端团队
接口文档更新记录
| 日期 | 版本 | 变更内容 | 变更原因 | 文档链接 |
|---|---|---|---|---|
| 2026-02-03 | v1.0 | 初始版本 | - | 查看 |
页面调试情况
| 日期 | 调试页面 | 问题记录 | 解决方案 | 状态 |
|---|---|---|---|---|
| 2026-02-03 | - | 后端开发中 | - | ⏳ 后端开发中 |
接口状态: ⏳ 后端开发中
备注:
- 参数：category（反馈类别）、note（反馈内容）、contact（联系方式）、images（图片）
- 类别：1=功能建议, 3=界面设计, 5=车辆新鲜, 7=其他问题
- 后端接口开发中
消息模块
接口 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
- 完成联调: 7
- 已废弃: 3
- 联调中: 0
- 后端开发中: 4
- 发现问题: 1
- 解决问题: 1
历史进度
| 周 | 完成数 | 新增数 | 废弃数 | 问题数 |
|---|---|---|---|---|
| 2026-01-27 ~ 2026-02-03 | 7 | 14 | 3 | 0 |
📌 快速索引
按状态查看
按模块查看
- 用户中心 - ✅ 6个已完成
- 通用 - ❌ 3个已废弃
- 意见反馈 - ⏳ 2个后端开发中
- 消息 - ⏳ 2个后端开发中
- 首页 - ⏳ 1个后端开发中
- 产品详情 - ⏳ 未开始
- 知识库 - ⏳ 未开始
- 家办 - ⏳ 未开始
- 签单 - ⏳ 未开始
按负责人查看
📖 使用说明
状态标识
- ✅ 已完成 - 接口正常工作，测试通过
- 🔄 联调中 - 正在调试，部分功能可用
- ⏳ 未开始 - 尚未开始联调
- ⚠️ 有阻塞 - 遇到阻塞问题，无法继续
优先级标识
- 🔴 高优先级 - 影响核心功能，需要立即处理
- 🟡 中优先级 - 影响次要功能，需要尽快处理
- 🟢 低优先级 - 优化类问题，可以稍后处理
记录时机
- 接口文档更新时: 记录到"接口文档更新记录"表格
- 页面联调时: 记录到"页面调试情况"表格
- 发现问题: 记录到对应接口的调试情况，并同步到"问题汇总"
- 解决问题: 更新调试情况的状态，并从"问题汇总"中移除或标记为已解决
维护建议
- 定期更新: 每天结束前更新当天的工作记录
- 同步会议: 在前后端对接会议上，根据此文档讨论问题
- 版本控制: 重要的接口变更应该提交到 Git，便于追溯
最后更新时间: 2026-02-03 20:30 文档版本: v1.5 更新内容:
- 更新个人资料接口联调状态：✅ 已完成
- 通用模块接口状态调整：3个七牛云相关接口标记为 ❌ 已废弃
- 获取七牛上传 Token
- 保存文件信息
- 上传图片到七牛云（完整流程）
- 头像上传方案调整：改用
Taro.uploadFile直接上传到服务器 - 更新总体进度：14个接口（7个已完成，3个已废弃，4个后端开发中）