liufumingren 08d9ea103b chore(微信): 移除自建微信授权表 wechat_oauth / wechat_mp_accounts
微信侧接入已统一到登录网关,自建的两套都下线:

- 删除表:wechat_oauth(自建公众号网页授权 + 运维手工维护的绑定关系)、
  wechat_mp_accounts(小程序 code2Session 一键登录);迁移 20261029100000(up 删表、down 按原结构重建)
- 删除代码:service/{wechat,wechat_mp}.js、controller/web/wechat_mp.js、model/{wechat_oauth,wechat_mp_account}.js、
  service/user.js#findByOpenid、user 模型的 hasMany WechatOauth、公众号 OAuth 回调与 /api/web/auth/wechat/*
- 删除环境变量:WECHAT_APPID/SECRET/REDIRECT_URI/API_BASE、WX_MP_*(config.wechat 只剩设备扫码登录用到的串码/二维码参数)
- 小程序:去掉「微信一键登录」tab,只留账号密码登录(删 utils/wechat.ts 与 wechatLogin 调用)
- sql/schema.sql 同步去掉 wechat_oauth 建表

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

6.6 KiB
Raw Blame History

云仓视频溯源 · 微信小程序

uni-app + Vue3 + TypeScript + Vite 的微信小程序,复用后端 backend/ 的用户端接口(/api/web/*)。 当前是基础脚手架:底部抽屉登录、首页统计、扫码记录、个人中心。

运行

cd miniprogram
npm install
npm run dev:mp-weixin        # 产物在 dist/dev/mp-weixin,watch 模式

微信开发者工具 → 导入项目 → 选 miniprogram/dist/dev/mp-weixin,AppID 用你自己的(或测试号)。 本地联调时在「详情 → 本地设置」勾选 不校验合法域名、web-view(业务域名)、TLS 版本以及 HTTPS 证书。

发布:

npm run build:mp-weixin      # 产物在 dist/build/mp-weixin

小程序 AppID 填在 src/manifest.json 的 mp-weixin.appid(appid 留空时开发者工具会让你选测试号)。

后端地址

小程序没有 Vite 同源代理,必须请求完整地址。src/api/client.ts 的规则:

  • 配了 VITE_API_BASE → 用它;
  • 没配 → 默认 http://127.0.0.1:7300(本机后端)。

本地需要改地址时,复制 .env.example 为 .env.development(已被根 .gitignore 忽略):

VITE_API_BASE=http://127.0.0.1:7300

发布时用 .env.production 指向 https 域名,并在小程序后台「开发设置 → 服务器域名」把它加入 request 合法域名 (微信要求域名已备案,且不能带端口/路径)。

登录时机(小程序审核要求)

不允许一打开就强制登录,登录只在「用户点了需要登录的功能」或「接口真的返回 401」时出现。 策略集中在 src/config/auth.ts:

配置 默认 说明
pageGuards ['pages/records/index'] 必须登录才能使用的页面
autoPromptOnEnter true 进入 pageGuards 页面时弹一次登录(同一次进入不重复弹)
apiRequireAuth true 业务接口是否必须登录
promptOnUnauthorized true 请求拿到 401 时是否自动弹登录

配套行为:

  • App.vue 启动时不做任何拦截;首页对游客展示功能介绍 + 「登录 / 注册」按钮;
  • 个人中心游客态展示欢迎卡片,点「登录 / 注册」跳整页登录(不自动跳转);
  • 扫码记录属于 pageGuards:切到该 tab 才弹抽屉(关掉后本页不再自动弹,可点「登录查看」);
  • 游客页面不会发需要登录的业务请求,所以不会出现「一进来就 401 → 弹窗」;
  • 令牌过期(401)会清登录态并按 promptOnUnauthorized 弹登录。

页面与接口

页面 路径 游客可用 登录后接口
首页(统计) pages/index/index 是(功能介绍) GET /api/web/subjects、GET /api/web/stats
扫码记录 pages/records/index 否(pageGuards) GET /api/web/records、GET /api/web/devices
个人中心 pages/profile/index 是(欢迎卡片) GET /api/web/me、PUT /api/web/me、GET /api/web/subjects
登录(整页兜底) pages/login/index 是 GET /api/agreements/current、POST /api/web/auth/login
登录抽屉 components/LoginDrawer.vue 是 同上(与整页登录共用 LoginPanel)

登录没有独立页面:它是一张从底部弹出的抽屉卡片(src/components/LoginDrawer.vue), 在首页 / 记录两个 tab 页各引入一次,状态由 src/composables/useLoginDrawer.ts 共享。 不会一进入小程序就弹出:只有点页面里的「登录」按钮、进入需要登录的页面、或接口返回 401 时才弹(见上面「登录时机」)。 打开时隐藏原生 tabBar,登录成功后关闭并留在当前页。

登录面板(src/components/LoginPanel.vue)只有一种登录方式:

  • 账号登录:用户名 / 手机号 / 邮箱 + 密码。
  • 小程序的「微信一键登录」(uni.login() → POST /api/web/auth/wechat/login)已下线:后端移除了 wechat_mp_accounts 表与整套小程序 code2Session 逻辑,微信侧接入统一走 Web 端的「微信登录网关」(扫码登录 / 绑定微信)。

H5 预览时接口走 Vite 的 /api 反代(vite.config.ts 的 server.proxy),不需要后端开 CORS。

个人中心例外:那里的「登录」跳整页登录 src/pages/login/index.vue(navigateTo), 用于抽屉在某些真机 / 低版本基础库上弹不出来的兜底;登录成功 navigateBack 回到个人中心并自动刷新。 个人中心页没有挂 LoginDrawer,401 也统一跳到整页登录(useLoginDrawer 里按当前路由判断)。

表单逻辑只有一份:src/components/LoginPanel.vue(抽屉与整页登录共用)。

登录前必须同意协议:

  • 面板只显示一行「我已阅读并同意《用户协议》v1.0.0」,点协议名弹出独立的协议弹窗 src/components/AgreementDialog.vue(不占登录面板高度);
  • 弹窗正文是 scroll-view,「我已阅读并同意」按钮在正文末尾,不滑到最后点不到;
  • 点完才打勾,勾选前登录按钮不可用;每次打开登录面都会清空勾选,需要重新阅读同意;
  • 登录请求带 client: 'mini_program' + agreements: [{ code, versionId }],后端校验版本并写入 user_agreements;
  • 服务端返回 428 agreement_required(协议版本更新)时,面板会自动拉新正文并要求重新勾选。

约定

  • 令牌与用户存在本地:packs_token / packs_user;当前主体 id 存在 packs_subject_id。
  • 业务接口都会带 Authorization: Bearer <user JWT> 和 X-Subject-Id(见 src/api/client.ts)。
  • 401 清令牌,并按 AUTH_POLICY.promptOnUnauthorized 弹登录(不跳页);400 subject_required / 403 subject_expired 由页面自己提示。
  • 登录 / 退出后 authVersion 自增,页面 watch 它刷新或清空数据。
  • 主体(租户)是设备与扫码记录的归属单位:小程序里只做切换,创建主体仍在 Web 端。
  • 微信扫码登录 / 绑定微信走 Web 端的登录网关(/api/web/auth/wechat-gateway/*),小程序里没有扫码入口;视频回放仍未接入。

H5 预览(可选,方便不装开发者工具时看页面)

npm run dev:h5     # http://127.0.0.1:7304
npm run build:h5

H5 页面同样直连 VITE_API_BASE(后端未开 CORS,浏览器跨域会被拦;仅用于看静态样式)。