This commit is contained in:
yin 2026-09-23 18:07:38 +08:00
parent 90e89fe984
commit 2458987224
7 changed files with 659 additions and 153 deletions

View File

@ -5,6 +5,7 @@
* 1. `PAGE_REGISTRY[].path` 必须真实存在于 `src/pages.json`(含 subPackages)
* 2. `PAGE_REGISTRY[].key` 不能重复
* 3. `pages.json` 里已注册但没有登记进 `PAGE_REGISTRY` 的页面 → 告警(不阻断)
* 4. 需要登录抽屉的页面是否挂了 `<auth-modal />` → 告警(不阻断,见文末)
*
* 为什么需要:小程序页面必须在 `pages.json` **编译期**注册,
* 一旦静态路由表与 `pages.json` 漂移,用户点入口就会跳转失败(且只在真机上才暴露)。
@ -14,11 +15,12 @@
* 注释掉的示例条目(整行 `//` 开头)会被自动忽略。
*/
import { readFileSync } from 'node:fs'
import { readFileSync, readdirSync } from 'node:fs'
import { fileURLToPath } from 'node:url'
import { join } from 'node:path'
const ROOT = fileURLToPath(new URL('..', import.meta.url))
const SRC_DIR = join(ROOT, 'src')
const PAGES_JSON = join(ROOT, 'src/pages.json')
const REGISTRY_TS = join(ROOT, 'src/router/pages.ts')
@ -178,6 +180,45 @@ for (const path of registered) {
}
}
// ── 校验 4:需要登录抽屉的页面必须挂载 <auth-modal />(仅告警) ──
/**
* 为什么查这个:`usePageAuth.goLogin()` 是「**就地弹抽屉**」而不是跳页 ——
* 它只把 store 的 `authView` 置上,真正渲染抽屉的是页面自己的 `<auth-modal />`。
* 漏挂的症状极具迷惑性:点「去登录」毫无反应,切到别的页面反而弹出登录框。
* (2026-09-23 实测踩过:新增的 `pages/mine/user-info.vue` 漏挂)
*/
function collectVueFiles(dir, acc = []) {
for (const entry of readdirSync(dir, { withFileTypes: true })) {
const full = join(dir, entry.name)
if (entry.isDirectory()) collectVueFiles(full, acc)
else if (entry.isFile() && entry.name.endsWith('.vue')) acc.push(full)
}
return acc
}
/** 需要抽屉:调了就地弹抽屉的方法,或使用了包装器 `<auth-gate>`(其内部会调 goLogin) */
const NEEDS_DRAWER_RE = /\bgoLogin\b|\brequireLogin\s*\(|\bshowAuthModal\s*\(|<auth-gate[\s>]/
/** 已挂载抽屉 */
const HAS_DRAWER_RE = /<auth-modal[\s/>]/
for (const file of collectVueFiles(SRC_DIR)) {
// 抽屉自身、以及 auth-gate 包装器(抽屉由使用它的页面负责挂)跳过
if (file.includes(join('components', 'auth-modal'))) continue
if (file.includes(join('components', 'auth-gate'))) continue
// uni-app 的 App.vue **没有模板**(只用来注册 401 处理器,里面调了 showAuthModal),
// 本来就没地方挂组件 —— 抽屉一律由「当前页面」自己挂
if (file === join(SRC_DIR, 'App.vue')) continue
const text = readFileSync(file, 'utf8')
if (!NEEDS_DRAWER_RE.test(text)) continue
if (HAS_DRAWER_RE.test(text)) continue
warnings.push(
`${file.slice(SRC_DIR.length + 1)} 用了 goLogin() / requireLogin() / showAuthModal() / <auth-gate>,` +
'但没有挂载 <auth-modal />:点「去登录」会没反应(抽屉无处渲染)'
)
}
// ── 输出 ──
for (const warn of warnings) console.warn(`⚠ ${warn}`)
for (const error of errors) console.error(`✖ ${error}`)

View File

@ -206,6 +206,31 @@ export interface WechatLoginCodeResult {
[key: string]: any
}
/**
* 用户须知(`wechat.getUserAgreement` / `wechat.getUserAgreementText` 的返回)
*/
export interface WechatAgreementResult {
/** 小程序 AppID */
appid: string
/**
* 用户须知**富文本**内容
*
* 后端存的是 longText 富文本,实际可能是 HTML,也可能是纯文本;
* 渲染侧自行判断(见 `login-panel.vue` 的 `isRichAgreement`)。
*/
text: string
/** 小程序名称(仅 `getUserAgreement` 返回) */
nickname?: string
/** 是否命中后端缓存(仅 `getUserAgreementText` 返回,后端 Redis 缓存 24h) */
from_cache?: boolean
}
/** 按 AppID 取用户须知的入参(`wechat.getUserAgreementText`) */
export interface WechatAgreementTextParams {
/** 小程序 AppID(`wx.getAccountInfoSync().miniProgram.appId`,**字符串**) */
appId: string
}
// ────────────────────────────── 接口 ──────────────────────────────
/** 账号密码登录 */
@ -427,3 +452,49 @@ export function wechatGetMyLoginCode(): Promise<BizResponse<WechatLoginCodeResul
redirectOn401: false
})
}
/**
* 获取**当前登录仓库**小程序的用户须知(**需登录**,带仓库上下文)
*
* 后端按 `ctx.user.store_id` 取仓库启用的 `wms_wechat_app`,返回其 `user_agreement` 富文本;
* 仓库未绑定小程序时返回「无小程序,需要先绑定」。
*
* ⚠️ 需要**业务登录**(未绑定的微信登录态没有仓库上下文)——
* 未登录 / 未绑定时请用免登录的 `wechatGetUserAgreementText()`。
*
* ⚠️ `toastError: false`:须知属于「锦上添花」的展示内容,拉不到就用本地兜底文案,
* 不应给用户弹错误提示(更不能因此阻断登录)。
*/
export function wechatGetUserAgreement(): Promise<BizResponse<WechatAgreementResult>> {
return request<WechatAgreementResult>({
url: SYSTEM_URL,
method: 'POST',
params: gatewayParams('wechat.getUserAgreement'),
data: {},
auth: true,
// 拉须知失败不能把用户踢去登录(登录前就要看须知才是常态)
redirectOn401: false,
toastError: false
})
}
/**
* 获取**指定小程序 AppID** 的用户须知(**免登录**)
*
* 后端按 `appid` 查 `wms_wechat_app.user_agreement`,Redis 缓存 24h(返回 `from_cache`)。
* 小程序端**登录前**就要展示《用户须知》(登录抽屉里勾选),
* 所以这条免登录接口才是主链路,`getUserAgreement` 用于已登录时的仓库维度取值。
*
* ⚠️ 同样 `toastError: false`:失败静默,调用方回退本地兜底文案。
*/
export function wechatGetUserAgreementText(
data: WechatAgreementTextParams
): Promise<BizResponse<WechatAgreementResult>> {
return request<WechatAgreementResult>({
url: SYSTEM_URL,
method: 'POST',
params: gatewayParams('wechat.getUserAgreementText'),
data,
toastError: false
})
}

View File

@ -0,0 +1,269 @@
<template>
<!--
用户须知弹窗(登录面板与「用户信息」页共用)
两种模式:
- `agree`(默认,登录前勾协议):**必须滑到底部**才能点「我已知晓并同意」
- `view`(已登录后查看):只读,按钮直接是「关闭」,不要求滑动
正文由后端下发(`wechat.getUserAgreement` / `wechat.getUserAgreementText`,
见 `store/modules/agreement.ts`);两条链路都失败时回退本地兜底文案。
-->
<up-popup :show="show" mode="center" :round="16" @close="close">
<view class="agreement">
<view class="agreement__title">用户须知</view>
<scroll-view
class="agreement__body"
scroll-y
:lower-threshold="16"
@scrolltolower="onScrollLower"
>
<view class="agreement__inner">
<!--
后端下发的是**富文本**(HTML)→ 用 rich-text;
纯文本 / 本地兜底文案走 text(能用上本组件的中文排版)
-->
<rich-text v-if="isRichText" class="agreement__rich" :nodes="text"></rich-text>
<text v-else class="agreement__text">{{ text }}</text>
</view>
</scroll-view>
<view class="agreement__action">
<view v-if="!readEnough" class="agreement__tip">
<up-icon name="arrow-downward" color="#f0a020" size="14"></up-icon>
<text>请向下滑动阅读至底部</text>
</view>
<up-button
type="primary"
shape="circle"
:text="mode === 'view' ? '关 闭' : '我已知晓并同意'"
:class="{ 'is-disabled': !readEnough }"
@click="onConfirm"
></up-button>
</view>
</view>
</up-popup>
</template>
<script setup lang="ts">
/**
* 用户须知弹窗(共享组件)
*
* 为什么要抽出来:须知有两个使用场景 ——
* ① 登录面板里「勾选协议」(`mode="agree"`,需滑到底才能同意)
* ② 已登录后在「用户信息」页查看(`mode="view"`,只读)
* 两个场景的正文来源、富文本判断、滑到底判定、兜底文案完全一样,抽一份避免漂移。
*
* 加载时机:**打开时才拉**(`watch(show)` → `agreementStore.load()`),
* 不参与启动链路;store 内部有会话内缓存,重复打开不会重复请求。
*/
import { computed, getCurrentInstance, ref, watch } from 'vue'
import { useAgreementStore } from '@/store/modules/agreement'
const props = withDefaults(
defineProps<{
/** 受控显示(父组件用 `v-model:show`) */
show: boolean
/** `agree` = 需滑到底才能同意;`view` = 只读查看 */
mode?: 'agree' | 'view'
/** `agree` 模式下:父组件若已同意过,打开时不必再逼着滑一遍 */
alreadyAgreed?: boolean
}>(),
{
mode: 'agree',
alreadyAgreed: false
}
)
const emit = defineEmits<{
(e: 'update:show', value: boolean): void
/** `agree` 模式下滑到底并点了「我已知晓并同意」 */
(e: 'agree'): void
}>()
const agreementStore = useAgreementStore()
/** 当前组件实例:`createSelectorQuery().in()` 量高度时要用 */
const instance = getCurrentInstance()
/**
* 用户须知**本地兜底文案**
*
* 正文由后端下发(各仓库 / 小程序可自行配置与审计)。这段本地文案只在
* **两条链路均不可用**时展示:未配置、接口不可用、非微信端(拿不到 AppID)等。
*
* ⚠️ 必须保留兜底:须知接口挂了不能让用户连登录都做不到(协议勾选是登录前置条件)。
*/
const AGREEMENT_FALLBACK_TEXT = `欢迎使用 WMS 仓储管理系统小程序。
一、账号与权限
1. 本小程序仅供仓库工作人员及经授权的用户使用,账号由管理员统一分配。
2. 请妥善保管账号与密码,勿转借他人;因账号外借、泄露造成的操作记录与损失,由账号持有人承担。
3. 您有多个身份(仓库 / 货主 / 平台)时,请确认当前身份后再操作,切换身份后的操作记录同样计入对应身份。
二、数据与操作记录
4. 登录后产生的操作记录(入库、出库、盘点、调拨等)将作为业务凭据留存,请如实操作。
5. 为保证数据准确,请勿在未授权设备上登录;发现账号异常请及时联系管理员。
三、个人信息
6. 为完成登录与身份识别,我们会获取您的微信授权标识、账号、姓名及所属组织信息,仅用于本系统内的身份校验与业务处理。
7. 我们不会将上述信息用于本系统以外的用途,也不会向无关第三方提供。
四、其他
8. 使用中如遇权限不足、功能异常,请联系所属仓库主管或系统管理员。
9. 本须知的解释权归系统运营方所有,内容如有调整将在本小程序内公示。
继续使用即表示您已阅读并同意上述全部内容。`
/** 实际展示的正文:后端下发优先,拿不到用本地兜底 */
const text = computed(() => agreementStore.text || AGREEMENT_FALLBACK_TEXT)
/**
* 是否按**富文本**渲染
*
* 后端字段是 longText 富文本,实际可能是 HTML 也可能是纯文本,
* 这里做个保守判断(出现 HTML 标签才走 rich-text),纯文本仍用 `text` 以便套用本组件样式。
*/
const isRichText = computed(() => /<[a-z][^>]*>/i.test(text.value))
/** 是否已滑到底部(或内容本来就不足一屏) */
const readDone = ref(false)
/** 是否满足「可同意」的条件 —— 查看模式恒满足 */
const readEnough = computed(() => props.mode === 'view' || readDone.value)
/** 滑到底部(`scroll-view` 的 scrolltolower)→ 视为已读完 */
const onScrollLower = () => {
readDone.value = true
}
/**
* 量一下内容高度:不足一屏时直接算已读
*
* 否则短文案永远触发不了 `scrolltolower`,用户会被卡在「点不动同意」上。
* (只读模式不需要,直接跳过。)
*/
const measure = () => {
if (props.mode === 'view') return
uni
.createSelectorQuery()
.in(instance?.proxy as never)
.select('.agreement__body')
.boundingClientRect()
.select('.agreement__inner')
.boundingClientRect()
.exec((res) => {
const body = res?.[0] as { height?: number } | null
const inner = res?.[1] as { height?: number } | null
if (!body?.height || !inner?.height) return
if (inner.height <= body.height + 2) readDone.value = true
})
}
const close = () => {
emit('update:show', false)
}
/** 点按钮:`agree` 模式没滑到底则只提示;否则关弹窗(并通知父组件已同意) */
const onConfirm = () => {
if (!readEnough.value) {
uni.$u.toast('请滑动阅读至底部后再同意')
return
}
close()
if (props.mode === 'agree') emit('agree')
}
// 打开时:复位已读状态(已同意过 / 只读模式直接算已读)+ 拉正文 + 量高度
watch(
() => props.show,
(visible) => {
if (!visible) return
readDone.value = props.mode === 'view' ? true : props.alreadyAgreed
// 正文走后端下发(store 内部已兜住失败,界面先用本地兜底文案)
agreementStore.load().catch(() => {})
// 弹窗有约 300ms 进场动画,等渲染完再量内容高度
setTimeout(measure, 350)
},
{ immediate: true }
)
/**
* 正文变化(本地兜底 → 后端富文本)后重新判定「是否已读完」
*
* 否则可能在很短的兜底文案上就把 `readDone` 置真,
* 等长正文加载回来后用户不滑动也能点「同意」(合规缺口)。
*/
watch(text, () => {
if (!props.show) return
readDone.value = props.mode === 'view' ? true : props.alreadyAgreed
setTimeout(measure, 120)
})
</script>
<style lang="scss" scoped>
.agreement {
width: 620rpx;
padding: 40rpx 36rpx 32rpx;
box-sizing: border-box;
&__title {
font-size: 34rpx;
font-weight: 600;
color: #303133;
text-align: center;
}
&__body {
/* 固定高度 + 内部滚动:长文本不会把弹窗撑出屏幕,同时强迫滑到底才能同意 */
height: 460rpx;
margin-top: 24rpx;
padding: 24rpx;
box-sizing: border-box;
border-radius: 12rpx;
background-color: #f7fafd;
}
&__text {
font-size: 26rpx;
line-height: 44rpx;
color: #5d6f82;
/* 保留换行(文案里的 \n) */
white-space: pre-wrap;
}
/*
富文本(后端下发 HTML 时用)
⚠️ rich-text 是原生组件,内部节点样式以 HTML 自带的 inline style 为准,
这里只做基础兜底(字号 / 行高 / 颜色),保证没带样式的正文也能看清。
*/
&__rich {
font-size: 26rpx;
line-height: 44rpx;
color: #5d6f82;
}
&__tip {
display: flex;
align-items: center;
justify-content: center;
margin-bottom: 16rpx;
font-size: 24rpx;
color: #f0a020;
}
&__action {
margin-top: 32rpx;
/* 未滑到底:按钮灰态。仍可点,点了会提示原因 —— 比 disabled 更好定位 */
.is-disabled {
opacity: 0.5;
}
}
}
</style>

View File

@ -217,38 +217,15 @@
</view>
<!--
用户须知弹窗
必须滑动到底部才能同意:`scrolltolower` 到底 → `agreementRead` 置真。
(内容不足一屏时会在打开后自动置真,否则用户永远滚不到底也就永远点不了)
用户须知弹窗(共享组件)
登录前的勾选场景:`mode="agree"` —— 必须滑到底部才能同意;
正文来源(后端下发 / 本地兜底)与滑到底判定都在组件内部,本页只关心「同意」。
-->
<up-popup :show="showAgreement" mode="center" :round="16" @close="showAgreement = false">
<view class="agreement">
<view class="agreement__title">用户须知</view>
<scroll-view
class="agreement__body"
scroll-y
:lower-threshold="16"
@scrolltolower="onAgreementLower"
>
<view class="agreement__inner">
<text class="agreement__text">{{ AGREEMENT_TEXT }}</text>
</view>
</scroll-view>
<view class="agreement__action">
<view v-if="!agreementRead" class="agreement__tip">
<up-icon name="arrow-downward" color="#f0a020" size="14"></up-icon>
<text>请向下滑动阅读至底部</text>
</view>
<up-button
type="primary"
shape="circle"
text="我已知晓并同意"
:class="{ 'is-disabled': !agreementRead }"
@click="onAgreeConfirm"
></up-button>
</view>
</view>
</up-popup>
<agreement-modal
v-model:show="showAgreement"
:already-agreed="agreed"
@agree="onAgreeConfirm"
></agreement-modal>
</view>
</template>
@ -272,9 +249,10 @@
* - 失败提示由 `utils/request` 统一 toast,组件内不重复提示。
*/
import { getCurrentInstance, reactive, ref } from 'vue'
import { reactive, ref } from 'vue'
import { useUserStore } from '@/store/modules/user'
import WechatBindForm from '@/components/wechat-bind-form/wechat-bind-form.vue'
import AgreementModal from '@/components/agreement-modal/agreement-modal.vue'
/** u-form 实例上本项目实际用到的方法 */
interface FormInstance {
@ -302,45 +280,13 @@ const emit = defineEmits<{
const userStore = useUserStore()
/** 当前组件实例:`createSelectorQuery().in()` 查子节点尺寸时要用 */
const instance = getCurrentInstance()
/**
* 用户须知
*
* 目前是前端静态文案;如果后续要由后端下发(可配置、可审计),
* 换成请求接口即可,弹窗结构与勾选逻辑都不用动。
*/
const AGREEMENT_TEXT = `欢迎使用 WMS 仓储管理系统小程序。
一、账号与权限
1. 本小程序仅供仓库工作人员及经授权的用户使用,账号由管理员统一分配。
2. 请妥善保管账号与密码,勿转借他人;因账号外借、泄露造成的操作记录与损失,由账号持有人承担。
3. 您有多个身份(仓库 / 货主 / 平台)时,请确认当前身份后再操作,切换身份后的操作记录同样计入对应身份。
二、数据与操作记录
4. 登录后产生的操作记录(入库、出库、盘点、调拨等)将作为业务凭据留存,请如实操作。
5. 为保证数据准确,请勿在未授权设备上登录;发现账号异常请及时联系管理员。
三、个人信息
6. 为完成登录与身份识别,我们会获取您的微信授权标识、账号、姓名及所属组织信息,仅用于本系统内的身份校验与业务处理。
7. 我们不会将上述信息用于本系统以外的用途,也不会向无关第三方提供。
四、其他
8. 使用中如遇权限不足、功能异常,请联系所属仓库主管或系统管理员。
9. 本须知的解释权归系统运营方所有,内容如有调整将在本小程序内公示。
继续使用即表示您已阅读并同意上述全部内容。`
/** 当前视图:'wechat' | 'account' | 'register' */
const view = ref<'wechat' | 'account' | 'register'>(props.initialView)
/** 是否已勾选《用户须知》 */
const agreed = ref(false)
/** 用户须知弹窗 */
/** 用户须知弹窗(正文加载与滑到底判定都在 `agreement-modal` 内部) */
const showAgreement = ref(false)
/** 用户须知是否已滑到【底部】(没滑到底就不允许同意) */
const agreementRead = ref(false)
/** 微信登录后尚未绑定 WMS 账号 → 面板切到绑定步骤 */
const wxBinding = ref(false)
@ -363,48 +309,19 @@ const PLACEHOLDER_STYLE = 'color: #c0c4cc'
// ────────────────────────── 协议勾选 ──────────────────────────
const openAgreement = () => {
// 已经同意过就不必再逼着滑一遍(只有「还没同意」时才要求读到最底部)
agreementRead.value = agreed.value
showAgreement.value = true
// 弹窗有约 300ms 进场动画,等渲染完再量内容高度
setTimeout(measureAgreement, 350)
}
/** 滑到底部(`scroll-view` 的 scrolltolower)→ 视为已读完 */
const onAgreementLower = () => {
agreementRead.value = true
}
/**
* 量一下内容高度:不足一屏时直接算已读
* 打开用户须知弹窗
*
* 否则短文案永远触发不了 `scrolltolower`,用户会被卡在「点不动同意」上。
* 正文加载(后端下发 → 本地兜底)、富文本判断、滑到底判定、已同意过不再逼着滑一遍
* 全部在 `components/agreement-modal/` 里;本页只负责「同意」这个业务结果。
*/
const measureAgreement = () => {
uni
.createSelectorQuery()
.in(instance?.proxy as never)
.select('.agreement__body')
.boundingClientRect()
.select('.agreement__inner')
.boundingClientRect()
.exec((res) => {
const body = res?.[0] as { height?: number } | null
const inner = res?.[1] as { height?: number } | null
if (!body?.height || !inner?.height) return
if (inner.height <= body.height + 2) agreementRead.value = true
})
const openAgreement = () => {
showAgreement.value = true
}
/** 弹窗里点「我已知晓并同意」→ 勾上并关闭(没滑到底则只提示,不置勾) */
/** 弹窗里点「我已知晓并同意」→ 勾上(弹窗已自行关闭) */
const onAgreeConfirm = () => {
if (!agreementRead.value) {
uni.$u.toast('请滑动阅读至底部后再同意')
return
}
agreed.value = true
showAgreement.value = false
}
/** 未同意协议时的统一拦截(微信登录 / 账号登录 / 注册都走这里) */
@ -687,53 +604,4 @@ const handleRegister = () => {
}
}
/* ── 用户须知弹窗 ── */
.agreement {
width: 620rpx;
padding: 40rpx 36rpx 32rpx;
box-sizing: border-box;
&__title {
font-size: 34rpx;
font-weight: 600;
color: #303133;
text-align: center;
}
&__body {
/* 固定高度 + 内部滚动:长文本不会把弹窗撑出屏幕,同时强迫滑到底才能同意 */
height: 460rpx;
margin-top: 24rpx;
padding: 24rpx;
box-sizing: border-box;
border-radius: 12rpx;
background-color: #f7fafd;
}
&__text {
font-size: 26rpx;
line-height: 44rpx;
color: #5d6f82;
/* 保留换行(文案里的 \n) */
white-space: pre-wrap;
}
&__tip {
display: flex;
align-items: center;
justify-content: center;
margin-bottom: 16rpx;
font-size: 24rpx;
color: #f0a020;
}
&__action {
margin-top: 32rpx;
/* 未滑到底:按钮灰态。仍可点,点了会提示原因 —— 比 disabled 更好定位 */
.is-disabled {
opacity: 0.5;
}
}
}
</style>

View File

@ -113,6 +113,17 @@
<view class="card__note">在电脑端登录页凭此登录码登录本账号</view>
</view>
<!-- ⑥ 用户须知(登录后也能随时查看;已登录时取当前仓库小程序的配置) -->
<view class="card">
<up-cell
title="用户须知"
value="查看"
is-link
:border="false"
@click="agreementVisible = true"
></up-cell>
</view>
<!-- ⑤ 退出登录(从「我的」页移来:细项统一收在本页) -->
<view class="footer">
<up-button type="info" :plain="true" text="退出登录" @click="onLogout"></up-button>
@ -206,6 +217,21 @@
</view>
</up-popup>
<!--
用户须知(**只读**模式:已登录后随时查看,不要求滑到底)
正文与滑到底判定都在组件内部;已登录时它会优先取「当前仓库小程序」的配置
-->
<agreement-modal v-model:show="agreementVisible" mode="view"></agreement-modal>
<!--
登录抽屉(登录入口)
⚠️ 硬约束:`usePageAuth.goLogin()` 是「**就地弹抽屉**」而不是跳页(见 `composables/usePageAuth.ts`),
它只改 store 的 `authView`;**每个会调 `goLogin()` / `requireLogin()` 的页面都必须自己挂一份
`<auth-modal />`**,否则会出现「点了去登录没反应、回其他页面反而弹出登录框」(因为抽屉内容没了)。
同款挂载点:`pages/index/index.vue`、`pages/mine/mine.vue`、`pages/login/confirm-login.vue` 等。
-->
<auth-modal></auth-modal>
<!-- 头像规格化用的画布:旧版 canvas-id API 取不到未渲染的节点,故移到屏外(不能用 v-if) -->
<canvas :canvas-id="AVATAR_CANVAS_ID" class="avatar-canvas"></canvas>
</view>
@ -232,6 +258,8 @@ import { getToken } from '@/utils/auth'
import { AVATAR_CANVAS_ID, avatarFileToPngBase64 } from '@/utils/avatar'
import WechatBindForm from '@/components/wechat-bind-form/wechat-bind-form.vue'
import EmptyState from '@/components/empty-state/empty-state.vue'
import AuthModal from '@/components/auth-modal/auth-modal.vue'
import AgreementModal from '@/components/agreement-modal/agreement-modal.vue'
const userStore = useUserStore()
@ -447,6 +475,11 @@ const onCopyLoginCode = () => {
uni.setClipboardData({ data: loginCode.value })
}
/* ───────────── ⑥ 用户须知 ───────────── */
/** 须知弹窗(只读);正文加载与滑到底判定都在 `agreement-modal` 内部 */
const agreementVisible = ref(false)
/* ───────────── ⑤ 退出登录 ───────────── */
/**

View File

@ -0,0 +1,194 @@
/**
* 用户须知 Store(《用户须知》富文本)
*
* 数据来源两条链路(见 `api/user/user.ts`):
* 1. **已业务登录** → `wechat.getUserAgreement`:按登录仓库取启用小程序,权威,另带小程序昵称
* 2. 其余情况(未登录 / 未绑定 / 上一条失败)→ `wechat.getUserAgreementText({ appId })`:
* **免登录**,按当前小程序运行时 AppID 取 —— 登录抽屉里也要展示须知,所以这条是主链路
*
* 设计取舍:
* - **拉不到不阻断业务**:调用方(`components/login-panel`)始终能拿到文案 ——
* 两条链路都失败时用它自己的**本地兜底文案**。须知接口挂了不能让用户连登录都做不到。
* - **不弹错误 toast**(api 层 `toastError: false`):须知只是展示内容,静默降级即可。
* - **会话内内存缓存**:后端已缓存 24h,前端只在本次会话缓存(`loaded`),
* 不落 storage;需要强制刷新时传 `force`。
*
* ⚠️ 本 store **不在 `resetToken()` 里被清**(避免与 user store 形成循环依赖):
* 须知是按「小程序 / 仓库」维度而非账号维度,登出后文案一般不变;
* 真要重拉,调用 `load(true)`。
*/
import { defineStore } from 'pinia'
import {
wechatGetUserAgreement as apiGetUserAgreement,
wechatGetUserAgreementText as apiGetUserAgreementText
} from '@/api/user/user'
import type { WechatAgreementResult } from '@/api/user/user'
import { getMiniProgramAppid } from '@/utils/wechat'
import { useUserStore } from './user'
/**
* 进行中的请求(放 store 外,不进 state、不需要响应式)
*
* 作用:**并发复用**。登录抽屉可能被反复开关,或抽屉与登录页同时挂载登录面板,
* 不加管控会重复发请求。
*/
let inFlight: Promise<string> | null = null
/**
* 仓库维度接口(`wechat.getUserAgreement`)本次会话是否已被判定**不可用**
*
* 仓库未绑定小程序 / 未授权 / 未配置协议时它会稳定失败,若每次打开须知都先打一趟再回退,
* 网络面板上就是「两个接口都调了」(且每次多一次必失败的请求)。
* 故失败一次就记下,本次会话不再重试;`load(true)` 或 `reset()` 会清掉以便重试。
*/
let warehouseUnavailable = false
/** 当前 `text` 来自哪条链路(决定要不要在登录后升级) */
type AgreementSource = '' | 'appid' | 'warehouse'
interface AgreementState {
/** 用户须知富文本('' = 尚未拿到,调用方回退本地文案) */
text: string
/** 小程序昵称(仅仓库维度接口返回;展示用,可空) */
nickname: string
/**
* `text` 的来源
*
* 用于「登录后升级」:未登录时只能拿到「按 AppID」的版本,
* 登录后仓库维度才是权威(后端按登录仓库取启用小程序),需要重拉一次覆盖。
*/
source: AgreementSource
/** 是否**成功**拉到过内容(失败保持 false,便于下次自动重试) */
loaded: boolean
/** 是否有请求在飞(UI 可据此显示加载态) */
loading: boolean
}
export const useAgreementStore = defineStore('agreement', {
state: (): AgreementState => ({
text: '',
nickname: '',
source: '',
loaded: false,
loading: false
}),
getters: {
/** 是否已拿到后端配置的须知(false 时调用方应回退本地兜底文案) */
hasText: (state): boolean => !!state.text
},
actions: {
/**
* 拉取用户须知(并发复用 + 会话内缓存)
* @param force 强制重新拉取(后端有 24h 缓存,一般不需要)
* @return 富文本内容;拉不到返回 '',由调用方回退本地兜底文案
*/
async load(force = false): Promise<string> {
const userStore = useUserStore()
// 显式强刷时重置「仓库维度不可用」标记,让它再试一次
if (force) warehouseUnavailable = false
/**
* 是否需要「升级」
*
* 已**业务登录**时,仓库维度(`getUserAgreement`)才是权威来源;
* 若手上只有登录前拿到的「按 AppID」版本(`source = 'appid'`),
* 就不能因为 `loaded` 为真而跳过 —— 否则仓库维度接口永远轮不上。
*
* ⚠️ 但若它已判定不可用,就不能反复重入(否则每次打开都要白跑一遍)。
*/
const needUpgrade =
!warehouseUnavailable &&
userStore.isLogin &&
!userStore.isWechatUnbound &&
this.source !== 'warehouse'
if (!force && this.loaded && !needUpgrade) return this.text
if (inFlight && !force) return inFlight
this.loading = true
inFlight = this.fetchText()
try {
return await inFlight
} finally {
inFlight = null
this.loading = false
}
},
/**
* 真正发请求:**先仓库维度(需登录),失败再按 AppID(免登录)**
*
* 两步都失败时不抛错 —— 须知不是关键路径,让调用方用兜底文案继续走。
*/
async fetchText(): Promise<string> {
const userStore = useUserStore()
// 仓库维度接口需要业务登录态(未绑定的微信登录态没有仓库上下文)
const canUseWarehouseApi =
userStore.isLogin && !userStore.isWechatUnbound && !warehouseUnavailable
if (canUseWarehouseApi) {
try {
const resp = await apiGetUserAgreement()
this.apply(resp.data, 'warehouse')
// 拿到内容才算成功;返回空则继续往下走(落回按 AppID 取)
if (this.text) return this.text
console.warn('[agreement] wechat.getUserAgreement 返回内容为空,改用按 AppID 取')
} catch (err) {
// 仓库未绑定小程序 / 未授权 / 仓库无协议配置等 → 落回按 AppID 的免登录接口。
// 这里**必须留日志**:接口静默降级(toastError: false)会让「为什么两个接口都调了」很难排查
warehouseUnavailable = true
console.warn(
'[agreement] wechat.getUserAgreement 不可用(按仓库取),已回退按 AppID 取:',
err
)
}
}
const appid = getMiniProgramAppid()
if (appid) {
try {
const resp = await apiGetUserAgreementText({ appId: appid })
this.apply(resp.data, 'appid')
} catch (err) {
// 静默降级(不打扰用户),但要留日志:否则「为什么显示的是本地文案」很难查
console.warn('[agreement] wechat.getUserAgreementText 也失败,将使用本地兜底文案:', err)
}
}
// 只有真拿到内容才算「已加载」;否则保留 loaded=false,下次打开弹窗会再试
if (this.text) {
this.loaded = true
} else {
// 两条链路都拿不到(如后台未配置 user_agreement)—— 界面展示本地兜底文案
console.warn('[agreement] 两条链路都没取到用户须知,界面展示本地兜底文案')
}
return this.text
},
/** 写入返回值(只覆盖接口真正回传的字段,避免把已有内容冲成空) */
apply(data?: WechatAgreementResult | null, source: AgreementSource = ''): void {
if (!data) return
if (typeof data.text === 'string' && data.text) {
this.text = data.text
// 来源只在正文真的被写入时更新,否则会把上一版的来源误标
this.source = source
}
if (data.nickname) this.nickname = data.nickname
},
/** 清空缓存(需要重新拉取时用;见文件头注释的取舍说明) */
reset(): void {
this.text = ''
this.nickname = ''
this.source = ''
this.loaded = false
// 一并允许重新探测仓库维度接口
warehouseUnavailable = false
}
}
})

View File

@ -36,6 +36,7 @@
| 微信一键登录 | ✅ 已完成 | `wechat.loginByCode`(不是 `user.loginByCode`);AppID 运行时取(`wx.getAccountInfoSync`,适配开放平台模板多仓库);token 立即落地(未绑定也算免登录态);绑定可跳过、入口常驻「我的」页 |
| 微信资料(昵称/头像) | ✅ 已完成(2026-09-22) | `wechat.updateInfo`(改昵称)+ `wechat.uploadHeadimg`(传头像);走微信「头像昵称填写能力」(`chooseAvatar` + `input type=nickname`),头像经 `utils/avatar.ts` 裁剪转 PNG(<500K)后上传;入口仅未绑定态可见 |
| 我的登录码(电脑端登录) | ✅ 已完成(2026-09-22) | `wechat.getMyLoginCode`(无入参,码**稳定不变**);入口在「我的」页(需微信登录态);同时新增登录渠道记录 `login_channel` |
| 用户须知(协议文案) | ✅ 已完成(2026-09-23) | 弹窗抽为共享组件 `components/agreement-modal/`(`agree` 勾选 / `view` 只读);入口两处:登录面板勾选区 + 「用户信息」页;正文后端下发(免登录按 AppID / 已登录按仓库),本地常量仅兵底 |
> 📄 **配套文档**:`页面渲染框架-设计与任务清单.md` —— 菜单 / 权限 / 页面渲染的决策与任务清单(第 12 节为摘要)
> ⚠️ **已知坑**:同时跑两个 `dev:mp-weixin` 进程会写坏产物,导致预览报
@ -783,7 +784,15 @@ I --> J["PC / 工作台轮询取回 → 登录为该账号"]
| 内容 | `components/login-panel/` | tab(**第一个是微信登录**)+ 协议勾选 + 注册视图 + 绑定步骤 |
**挂载**:uni-app 的 `App.vue` 没有模板 → 需在页面里各引一次 `<auth-modal />`
(当前:首页、「我的」、`pagesA/demo/required`、`pagesA/test/index`)。
(当前:首页、「我的」、**用户信息 `pages/mine/user-info`**、确认登录、`pagesA/demo/required`、`pagesA/test/index`)。
⚠️ **漏挂是个很坑的 bug**(2026-09-23 实测踩过):`goLogin()` 是「就地弹抽屉」而不是跳页,
它只把 store 的 `authView` 置上,**真正渲染抽屉的是页面自己的 `<auth-modal />`**。
漏挂的症状是「点『去登录』毫无反应,切到别的页面反而弹出登录框」——
因为状态是全局的,谁挂了谁显示。
现已加自动校验:`npm run check:pages` 会扫描所有 `.vue`,
凡用了 `goLogin()` / `requireLogin()` / `showAuthModal()` / `<auth-gate>` 却没挂 `<auth-modal />` 的一律告警
(`App.vue` 与抽屉/`auth-gate` 组件自身已排除)。
⚠️ **原生 tabBar 必须手动藏**:微信小程序的 tabBar 是**原生组件**,层级恒在
`position: fixed` 之上 —— 抽屉弹出时会被它切掉一截(看起来没贴到屏幕底部),改 `z-index` 无效。
@ -812,8 +821,29 @@ I --> J["PC / 工作台轮询取回 → 登录为该账号"]
- 内容不足一屏时(`.agreement__inner` 高度 ≤ `.agreement__body`)在打开后**自动算已读** ——
否则短文案永远触发不了 `scrolltolower`,用户会被卡在「点不了同意」上
- **已同意过**再打开则不要求再滑一遍(`agreementRead = agreed`)
- 文案是前端静态常量(`login-panel` 的 `AGREEMENT_TEXT`),后端下发时替换即可
(弹窗高度固定 460rpx + 内部滚动,文案变长变短都不用改结构)
- [x] 文案改为**后端下发**(2026-09-23),本地常量降为**兜底**:
- 弹窗抽为**共享组件** `components/agreement-modal/`,两种模式:
`mode="agree"`(登录前勾选,**必须滑到底**才能同意)/ `mode="view"`(已登录后只读查看,不要求滑动)
- 两个入口:① 登录面板的协议勾选区;② **「用户信息」页的「用户须知」行**(已登录也能随时查看)
- 主链路:`wechat.getUserAgreementText({ appId })` —— **免登录**,按当前小程序运行时 AppID 取;
登录抽屉里就要看须知(此时未登录),所以必须走这条
- 已**业务登录**时优先:`wechat.getUserAgreement` —— 按登录仓库取启用小程序,另带小程序昵称;
失败(如仓库未绑定小程序 / 未授权 / 仓库无协议配置)自动落回上一条
- ⚠️ 所以已登录时会看到「**两个接口都调了**」:第一个失败才会走第二个(成功则提前 return)
- 失败时打 `console.warn('[agreement] ...')` 并记下 `warehouseUnavailable`,
**本次会话不再重复探测**(否则每次打开须知都白跑一趟必失败的请求);`load(true)` / `reset()` 会清标记重试
- ⚠️ **登录后要升级**:先拿到的是「按 AppID」的版本(`source='appid'`),
登录后仓库维度才是权威 ⇒ `load()` 发现来源不是 `warehouse` 时会**再拉一次覆盖**,
否则因为 `loaded` 缓存短路,仓库维度那条永远轮不上(2026-09-23 实测发现)
- ⚠️ 两条都失败时用组件内的 `AGREEMENT_FALLBACK_TEXT`:
须知接口挂了不能让用户连登录都做不到(协议勾选是登录前置条件)
- api 层两个接口都 `toastError: false`(静默降级,不打扰用户)+ `redirectOn401: false`
- 渲染:后端是 longText 富文本 ⇒ 出现 HTML 标签走 `<rich-text>`,纯文本仍走 `<text>`(保住中文排版)
- 文案变化(兜底 → 后端)会**重新量高度**并重置已读:否则在很短的兜底文案上就把已读置真,
等长正文回来用户不滑也能同意(合规缺口)
- 状态在 `store/modules/agreement.ts`:会话内内存缓存 + 并发复用,`load(true)` 可强刷
- 弹窗高度固定 460rpx + 内部滚动,文案变长变短都不用改结构
- 未使用:`wechat.setUserAgreement`(设置端在 PC 后台,小程序端只读)
### 14.5 登录页保留