2.4 KiB
2.4 KiB
微信绑定功能 TODO
任务目标
实现微信公众号扫码绑定/解绑账号功能,前后端联调。
后端接口设计(参考)
一、user.getBindWechatCode — 获取微信绑定二维码及轮询状态
请求: POST /system,params: { method: 'user.getBindWechatCode', v, timestamp }
逻辑:
- 查询 ye4s 数据库,判断当前账号是否已绑定微信。
- 若已绑定,直接返回绑定信息(status: 'bound',nickname 等)。
- 若未绑定:
- 优先从缓存中读取该账号对应的随机码
code,避免重复查数据库。 - 若缓存无随机码,则生成新随机码写入缓存(key:
wechat:bind:{accountId},TTL 可设 5 分钟)。 - 返回随机码 + 公众号二维码 URL(将
code作为 state 参数带入)。
- 优先从缓存中读取该账号对应的随机码
- 微信用户扫码关注后,公众号后台回调将 openid 与 code 关联,更新缓存状态为
scanned/bound。 - 前端通过轮询本接口,命中缓存即可感知状态变化,无需重复查数据库。
返回结构(建议):
{
"code": 0,
"data": {
"status": "waiting | scanned | bound | expired",
"bindCode": "随机码(未绑定时返回)",
"qrUrl": "微信公众号带参二维码地址",
"nickname": "(已绑定时返回微信昵称)",
"openid": "(已绑定时返回openid)"
}
}
二、user.unbindWechat — 解除微信绑定
请求: POST /system,params: { method: 'user.unbindWechat', v, timestamp }
逻辑:
- 根据当前登录账号,删除 ye4s 数据库中对应的微信绑定关联记录。
- 同步清除缓存中的绑定随机码。
- 返回操作结果。
返回结构(建议):
{
"code": 0,
"data": { "success": true }
}
前端任务
- 更新
src/api/profile.ts:新增getBindWechatCode/unbindWechat接口 - 重构
src/views/profile/components/Bind.vue:- 打开弹窗时调用
getBindWechatCode获取二维码 URL 及 bindCode - 轮询(3s interval)
getBindWechatCode检测 status 变化 - status 变为
bound时关闭弹窗,刷新绑定状态 - 调用
unbindWechat实现解绑
- 打开弹窗时调用
临时文件列表(任务完成后删除)
temp/wechat-bind/TODO.md(本文件)
回归清理
任务完成、联调通过后:
- 删除
temp/wechat-bind/目录及其所有文件