diff --git a/scripts/check-pages.mjs b/scripts/check-pages.mjs index eea42ba..d660de9 100644 --- a/scripts/check-pages.mjs +++ b/scripts/check-pages.mjs @@ -5,6 +5,7 @@ * 1. `PAGE_REGISTRY[].path` 必须真实存在于 `src/pages.json`(含 subPackages) * 2. `PAGE_REGISTRY[].key` 不能重复 * 3. `pages.json` 里已注册但没有登记进 `PAGE_REGISTRY` 的页面 → 告警(不阻断) + * 4. 需要登录抽屉的页面是否挂了 `` → 告警(不阻断,见文末) * * 为什么需要:小程序页面必须在 `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:需要登录抽屉的页面必须挂载 (仅告警) ── +/** + * 为什么查这个:`usePageAuth.goLogin()` 是「**就地弹抽屉**」而不是跳页 —— + * 它只把 store 的 `authView` 置上,真正渲染抽屉的是页面自己的 ``。 + * 漏挂的症状极具迷惑性:点「去登录」毫无反应,切到别的页面反而弹出登录框。 + * (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 +} + +/** 需要抽屉:调了就地弹抽屉的方法,或使用了包装器 ``(其内部会调 goLogin) */ +const NEEDS_DRAWER_RE = /\bgoLogin\b|\brequireLogin\s*\(|\bshowAuthModal\s*\(|]/ +/** 已挂载抽屉 */ +const HAS_DRAWER_RE = /]/ + +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() / ,` + + '但没有挂载 :点「去登录」会没反应(抽屉无处渲染)' + ) +} + // ── 输出 ── for (const warn of warnings) console.warn(`⚠ ${warn}`) for (const error of errors) console.error(`✖ ${error}`) diff --git a/src/api/user/user.ts b/src/api/user/user.ts index f79c6c1..9ba1cc0 100644 --- a/src/api/user/user.ts +++ b/src/api/user/user.ts @@ -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> { + return request({ + 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> { + return request({ + url: SYSTEM_URL, + method: 'POST', + params: gatewayParams('wechat.getUserAgreementText'), + data, + toastError: false + }) +} diff --git a/src/components/agreement-modal/agreement-modal.vue b/src/components/agreement-modal/agreement-modal.vue new file mode 100644 index 0000000..5577d19 --- /dev/null +++ b/src/components/agreement-modal/agreement-modal.vue @@ -0,0 +1,269 @@ + + + + + diff --git a/src/components/login-panel/login-panel.vue b/src/components/login-panel/login-panel.vue index f92e10c..66040de 100644 --- a/src/components/login-panel/login-panel.vue +++ b/src/components/login-panel/login-panel.vue @@ -217,38 +217,15 @@ - - - 用户须知 - - - {{ AGREEMENT_TEXT }} - - - - - - 请向下滑动阅读至底部 - - - - - + @@ -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; - } - } -} diff --git a/src/pages/mine/user-info.vue b/src/pages/mine/user-info.vue index 4135c29..1ad5925 100644 --- a/src/pages/mine/user-info.vue +++ b/src/pages/mine/user-info.vue @@ -113,6 +113,17 @@ 在电脑端登录页凭此登录码登录本账号 + + + + + @@ -206,6 +217,21 @@ + + + + + + @@ -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) + /* ───────────── ⑤ 退出登录 ───────────── */ /** diff --git a/src/store/modules/agreement.ts b/src/store/modules/agreement.ts new file mode 100644 index 0000000..f09c7da --- /dev/null +++ b/src/store/modules/agreement.ts @@ -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 | 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 { + 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 { + 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 + } + } +}) diff --git a/微信小程序开发清单.md b/微信小程序开发清单.md index eeac9db..eadb2bc 100644 --- a/微信小程序开发清单.md +++ b/微信小程序开发清单.md @@ -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` 没有模板 → 需在页面里各引一次 `` -(当前:首页、「我的」、`pagesA/demo/required`、`pagesA/test/index`)。 +(当前:首页、「我的」、**用户信息 `pages/mine/user-info`**、确认登录、`pagesA/demo/required`、`pagesA/test/index`)。 + +⚠️ **漏挂是个很坑的 bug**(2026-09-23 实测踩过):`goLogin()` 是「就地弹抽屉」而不是跳页, +它只把 store 的 `authView` 置上,**真正渲染抽屉的是页面自己的 ``**。 +漏挂的症状是「点『去登录』毫无反应,切到别的页面反而弹出登录框」—— +因为状态是全局的,谁挂了谁显示。 +现已加自动校验:`npm run check:pages` 会扫描所有 `.vue`, +凡用了 `goLogin()` / `requireLogin()` / `showAuthModal()` / `` 却没挂 `` 的一律告警 +(`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 标签走 ``,纯文本仍走 ``(保住中文排版) + - 文案变化(兜底 → 后端)会**重新量高度**并重置已读:否则在很短的兜底文案上就把已读置真, + 等长正文回来用户不滑也能同意(合规缺口) + - 状态在 `store/modules/agreement.ts`:会话内内存缓存 + 并发复用,`load(true)` 可强刷 + - 弹窗高度固定 460rpx + 内部滚动,文案变长变短都不用改结构 + - 未使用:`wechat.setUserAgreement`(设置端在 PC 后台,小程序端只读) ### 14.5 登录页保留