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 @@
+
+
+
+
+ 用户须知
+
+
+
+
+
+ {{ text }}
+
+
+
+
+
+
+ 请向下滑动阅读至底部
+
+
+
+
+
+
+
+
+
+
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 @@
在电脑端登录页凭此登录码登录本账号
+
+
+
+
+
+
+
+
+
+
+
@@ -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 登录页保留