@vue/tsconfig@0.1.3 仍设 importsNotUsedAsValues / preserveValueImports,TS 5.5 起已删除; 它的 moduleResolution=Node 与 baseUrl 在 TS 6 也已弃用(VS Code 报 4 个错)。 - tsconfig 改成自包含:moduleResolution=bundler,paths 不再需要 baseUrl - typescript ^6.0.3、vue-tsc ^3.3.13,移除未再使用的 @vue/tsconfig - 已验证:npm run type-check / build:h5 / build:mp-weixin 均通过 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
云仓视频溯源 · 微信小程序
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、POST /api/web/auth/wechat/login |
| 登录抽屉 | components/LoginDrawer.vue |
是 | 同上(与整页登录共用 LoginPanel) |
登录没有独立页面:它是一张从底部弹出的抽屉卡片(src/components/LoginDrawer.vue),
在首页 / 记录两个 tab 页各引入一次,状态由 src/composables/useLoginDrawer.ts 共享。
不会一进入小程序就弹出:只有点页面里的「登录」按钮、进入需要登录的页面、或接口返回 401 时才弹(见上面「登录时机」)。
打开时隐藏原生 tabBar,登录成功后关闭并留在当前页。
登录面板有两个 tab(src/components/LoginPanel.vue):
- 微信登录(默认,优先):点「微信一键登录」→
uni.login()拿 code →POST /api/web/auth/wechat/login; 首次登录后端按 openid 自动建账号(firstTime),提示「已为你创建账号」; - 账号登录:用户名 / 手机号 / 邮箱 + 密码。
H5 / 开发者工具里 uni.login 拿不到 code,可设 VITE_WX_MOCK_OPENID=<openid> 走后端 mock(仅本地联调)。
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 端。
- 微信一键登录走小程序自己的后端模块(
/api/web/auth/wechat/*),与公众号扫码登录(wechat_oauth)分开;视频回放仍未接入。
H5 预览(可选,方便不装开发者工具时看页面)
npm run dev:h5 # http://127.0.0.1:7304
npm run build:h5
H5 页面同样直连 VITE_API_BASE(后端未开 CORS,浏览器跨域会被拦;仅用于看静态样式)。