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