liufumingren b2eea28001 feat(微信网关): 扫码登录 / 绑定微信 / 工作台扫码登入,废弃自建登录码
对接 https://gateway.gztbyc.com:二维码与「扫码确认」由网关提供,本服务只负责
申请临时码 → 验签收通知 → 落地自己的业务。

- 新增 service/wx_gateway.js + controller/gateway/notify.js(POST /api/wechat-gateway/notify,验签 401 / 会话过期 200 ignored)
- 新增 controller/web/wx_gateway.js(登录二维码 / 长轮询 / SVG+GIF / 个人中心绑定与解绑)
- 新表 wechat_gateway_bindings(uk(app_key, openid)):一个微信只绑一个账号,解绑是软删,
  再绑定走 restore 复用(否则会撞唯一键报 Validation error)
- 「这个微信已绑别的账号」策略:原账号正常 → 拒绝并提示对方账号名;原账号禁用/已删 → 直接改绑;
  拿不到原账号 → 运维接口 GET/DELETE /api/internal/wechat-bindings 强制解绑
- 主体成员改为「扫码绑定」:管理员出二维码 → 成员微信扫码 → 已有账号直接继承(自动建的临时账号删掉),
  没有账号则由服务端建号并绑成其登录方式;subject_members.temp_user_id 记录临时账号
- 废弃自建登录码:删除 GET /api/wechat/login(6 位串码)与 workstations.login_code(迁移 20261028121000),
  工作台改扫码登入,成员绑定码与 /wechat?bind= 手机确认页下线
- 前端:登录页/个人中心/主体成员/工作台全部切到网关;桌面端登录窗改网关二维码 + 长轮询
- 测试:wx-gateway.test.js 覆盖登录/绑定/解绑-再绑/禁用账号改绑/运维强制解绑/成员绑定/工作台登入

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-29 17:20:05 +08:00

67 lines
2.3 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
const { Controller } = require('egg');
/**
* 扫码登录的**公开**接口(发码 / 查码)—— 谁来调都行,不需要令牌
*
* 面向:Win 客户端、设备端、任何想自己画二维码显示的前端。
* 确认环节在 `app/controller/client/wechat.js`(需要 user JWT);设备端扫码登录在 `app/controller/device/auth.js`。
*
* ⚠️ 登录页扫码登录、主体成员绑定、个人中心绑定微信都已改走微信登录网关(`/api/wechat-gateway/*`),
* 这里只剩「设备扫码登录」在用(手机页 `/wechat?spm=…` 点确认)。
*/
class WechatAuthController extends Controller {
/**
* GET /api/wechat/qrcode.svg?code=xxxxxx —— 登录码的二维码(SVG,**本地生成**,零外链)
*
* 内容是本站地址 `/wechat?spm=1.0.<码>.1`(设备扫码登录的手机页)。
*/
async qrcode() {
const { ctx } = this;
const code = String(ctx.query.code || '');
const origin = ctx.app.config.email.siteUrl || ctx.origin;
const content = ctx.service.wechatLogin.qrContent({ code, origin });
ctx.set('Cache-Control', 'no-store');
ctx.type = 'image/svg+xml; charset=utf-8';
ctx.body = ctx.service.wechatLogin.qrSvg(content);
}
/**
* GET /api/wechat/status —— 查串码状态(**无需登录**,小程序/网页先问一下再决定怎么提示)
*
* query: `?code=` 或 `?spm=`(也可以直接把二维码里扫到的整条地址丢进来)
* 返回 `data.status`:pending(待扫码)/ confirmed(已被确认)/ expired(不存在或已过期,即“没这个码”)
*/
async status() {
const { ctx } = this;
const svc = ctx.service.wechatLogin;
const code = svc.parseSpm(ctx.query.code || ctx.query.spm);
if (!code) {
ctx.status = 422;
ctx.body = {
ok: false,
status: 'bad_format',
message: `登录码格式不对(${Number(ctx.app.config.wechat.codeLength || 6)} 位数字 + 字母)`,
};
return;
}
const state = await svc.statusOf(code);
ctx.body = {
ok: true,
data: {
status: state.status,
code,
spm: svc.spm(code),
qrUrl: `/api/wechat/qrcode.svg?code=${encodeURIComponent(code)}`,
expiresIn: state.expiresIn,
},
};
}
}
module.exports = WechatAuthController;