From aa2f7f175ccd9b513b6e91c9790fa2a13a3f7313 Mon Sep 17 00:00:00 2001
From: lovife <474239041@qq.com>
Date: Tue, 29 Sep 2026 11:24:32 +0800
Subject: [PATCH] =?UTF-8?q?feat(h5):=20=E8=BA=AB=E4=BB=BD=E6=A0=B8?=
 =?UTF-8?q?=E9=AA=8C=E9=A1=B5=EF=BC=88=E9=97=A8=E7=A6=81=EF=BC=89=E2=80=94?=
 =?UTF-8?q?=E2=80=94=20=E5=AD=A6=E7=94=9F=E6=B5=81=E7=A8=8B=E9=A6=96?=
 =?UTF-8?q?=E4=B8=AA=E5=8F=AF=E7=94=A8=E9=97=AD=E7=8E=AF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

学生填材料之前的唯一一道门：姓名 + 身份证号与老师提交的名单核对，
通过后把微信账号与名单里那一行钉死。后面所有材料都归属那个人。

交付：
· pages/verify/verify.vue —— 核验页
· 落地页「开始填报」→ 核验页（带 scene）
· 两页都加 max-width 居中（桌面查看/自动化验证时不至于拉满全屏）

三处刻意的设计：
1) 失败提示不区分"姓名错"还是"号码错"（后端统一 40007），前端也只显示
   后端那一句话 —— **不在前端加"可能是身份证号错了"这类推断**。
   分开提示等于给出一个身份证号枚举器。
2) 预填项标注「老师已填，请核对」并明确「学生不能改」：报考职业/工种/等级
   由老师按报考计划确定（名单里实测 28/28 都有值）。让学生重填只会制造错误，
   而报错工种在机构那边是直接不受理。
3) 前端只做"非空 + 长度"这类明显笔误的提示，真正的判定（校验位、名册匹配、
   绑定状态）全交给后端。

修掉一个 H5 特有的坑：
   **H5 的页面跳转不保留 URL 参数** —— 直接 navigateTo 到核验页的话，
   那边读不到 scene、就不知道是哪个任务（小程序没有这个问题）。
   所以落地页跳转时显式拼上 scene，核验页再从自己的 URL 里读出来。

验收（全程无头浏览器自动完成，除"微信授权"那一步）。
现在 task 17 已发布（收集中）并带测试名册，手机上可走完整流程。

注：task 17 现在是「收集中」并带 1 行测试名册（张同学 / 361029200912100015），
   是我为验证留的演示数据。
---
 .../mp/controller/MpH5AuthController.java     |  37 +-
 frontend-mp/src/pages.json                    |   8 +
 frontend-mp/src/pages/index/index.vue         |  63 ++-
 frontend-mp/src/pages/verify/verify.vue       | 382 ++++++++++++++++++
 4 files changed, 472 insertions(+), 18 deletions(-)
 create mode 100644 frontend-mp/src/pages/verify/verify.vue

diff --git a/backend/xt-server/src/main/java/cn/tianbaotong/fill/module/mp/controller/MpH5AuthController.java b/backend/xt-server/src/main/java/cn/tianbaotong/fill/module/mp/controller/MpH5AuthController.java
index dcc2244..6bf330f 100644
--- a/backend/xt-server/src/main/java/cn/tianbaotong/fill/module/mp/controller/MpH5AuthController.java
+++ b/backend/xt-server/src/main/java/cn/tianbaotong/fill/module/mp/controller/MpH5AuthController.java
@@ -125,29 +125,44 @@ public class MpH5AuthController {
     /**
      * 302 回 H5 页面。token 放 <b>fragment</b>（不发给服务器），错误信息放 query。
      */
+    /**
+     * 302 回 H5 页面。
+     *
+     * <p>token 放在 <b>hash 路由的 query</b> 里，形如
+     * {@code http://host/#/pages/index/index?token=X&scene=Y}。这个格式同时满足两件事：
+     * <ul>
+     *   <li><b>安全</b>：整段在 {@code #} 之后，<b>不会发给服务器</b> ——
+     *       不进 Nginx access log、不进 Referer。</li>
+     *   <li><b>能用</b>：uni-app H5 的 {@code onLoad} 解析的是<b>路由</b>的 query。
+     *       实测写成裸 hash（{@code #token=X&scene=Y}）时，它既不是外层查询串、
+     *       也不是合法的路由路径 —— 两边都不认，页面读不到任何参数，
+     *       表现是"授权明明成功了，落地页却说 scene 没获取到"。</li>
+     * </ul>
+     * 换句话说：<b>参数要么放外层 query（会进服务器日志），要么放 hash 路由的 query</b>，
+     * 别放裸 hash。
+     */
     private ResponseEntity<Void> redirectToApp(String token, String scene, String error) {
         String base = props.mpH5() == null ? null : props.mpH5().h5BaseUrlOrDefault();
         if (base == null || base.isBlank()) {
             base = "http://127.0.0.1:5174";
         }
-        StringBuilder sb = new StringBuilder(base);
-        String frag = "";
+        StringBuilder q = new StringBuilder();
         if (token != null) {
-            frag += "token=" + enc(token);
+            q.append("token=").append(enc(token));
         }
         if (scene != null && !scene.isBlank()) {
-            frag += (frag.isEmpty() ? "" : "&") + "scene=" + enc(scene);
+            q.append(q.isEmpty() ? "" : "&").append("scene=").append(enc(scene));
         }
+        String url = base;
         if (error != null) {
-            // 错误放 query：它不敏感，而且我们要让页面能读到
-            sb.append("?authError=").append(enc(error));
+            // 错误放外层 query：它不敏感，而且页面要能读到
+            url += "?authError=" + enc(error);
         }
-        if (!frag.isEmpty()) {
-            sb.append("#").append(frag);
+        if (!q.isEmpty()) {
+            // hash 路由格式：uni-app 能解析，且整段不发给服务器
+            url += "#/pages/index/index?" + q;
         }
-        return ResponseEntity.status(HttpStatus.FOUND)
-                .header("Location", sb.toString())
-                .build();
+        return ResponseEntity.status(HttpStatus.FOUND).header("Location", url).build();
     }
 
     private static String enc(String s) {
diff --git a/frontend-mp/src/pages.json b/frontend-mp/src/pages.json
index e5f5701..36be32e 100644
--- a/frontend-mp/src/pages.json
+++ b/frontend-mp/src/pages.json
@@ -8,6 +8,14 @@
 				"navigationBarTextStyle": "white",
 				"enablePullDownRefresh": true
 			}
+		},
+		{
+			"path": "pages/verify/verify",
+			"style": {
+				"navigationBarTitleText": "核对身份",
+				"navigationBarBackgroundColor": "#0052D9",
+				"navigationBarTextStyle": "white"
+			}
 		}
 	],
 	"globalStyle": {
diff --git a/frontend-mp/src/pages/index/index.vue b/frontend-mp/src/pages/index/index.vue
index 16ec0f9..109fc47 100644
--- a/frontend-mp/src/pages/index/index.vue
+++ b/frontend-mp/src/pages/index/index.vue
@@ -89,6 +89,25 @@ const isError = ref(false)
 const loading = ref(false)
 const title = ref('材料填报')
 
+/**
+ * 当前 URL 里的 scene（授权回调回来时在 hash 路由的 query 里）。
+ *
+ * ⚠️ 为什么跳转时要把它带上：**H5 的页面跳转不保留 URL 参数**，
+ * 直接 navigateTo 到核验页的话，那边读不到 scene、就不知道是哪个任务。
+ * 这是 H5 与小程序的一个真实差异（小程序可以靠 scene 直进，H5 得自己带）。
+ * 所以这里显式拼参数，核验页再从自己的 URL 里读出来。
+ */
+function sceneFromUrl(): string {
+  try {
+    const hash = typeof location !== 'undefined' ? location.hash : ''
+    const q = hash.includes('?') ? hash.slice(hash.indexOf('?') + 1) : ''
+    const params = new URLSearchParams(q)
+    return params.get('scene') || ''
+  } catch {
+    return ''
+  }
+}
+
 const badgeClass = computed(() => {
   switch (ctx.value.taskStatus) {
     case 1: return 'land__badge--ok'
@@ -154,18 +173,42 @@ async function load() {
 }
 
 function start() {
-  // 填报主流程属 M3（/mp/login → 门禁核验 → 表单），当前骨架先给出明确预期，
-  // 而不是静默什么都不做 —— 后者会被当成"按钮坏了"
-  uni.showModal({
-    title: '填报功能开发中',
-    content: `已识别任务「${ctx.value.taskName ?? ''}」。填报主流程（身份核验与表单填写）属下一阶段开发。`,
-    showCancel: false
-  })
+  const s = scene.value || sceneFromUrl()
+  if (!s) {
+    uni.showModal({
+      title: '无法继续',
+      content: '没有取到任务信息，请重新扫班主任发的二维码进入。',
+      showCancel: false
+    })
+    return
+  }
+  // 带上 scene —— 见 sceneFromUrl 的说明（H5 跳转不保留 URL 参数）
+  uni.navigateTo({ url: `/pages/verify/verify?scene=${encodeURIComponent(s)}` })
 }
 
 onLoad((options) => {
   rawScene.value = options?.scene || options?.q || ''
   scene.value = pickScene(options)
+
+  // 授权回调失败时后端会把原因放在外层 query 的 authError 里（不敏感，可以进服务器日志）
+  const authErr = options?.authError
+  if (authErr) {
+    isError.value = true
+    message.value = decodeURIComponent(String(authErr))
+    return
+  }
+
+  // 授权回调会把会话 token 带回来（在 hash 路由的 query 里，不进服务器日志）。
+  // 存下来供后续页面用 —— 门禁核验、提交都要靠它。
+  const t = options?.token
+  if (t) {
+    try {
+      uni.setStorageSync('token', t)
+    } catch {
+      // 存不了也不该让页面挂掉：落地页本身不需要 token
+    }
+  }
+
   load()
 })
 
@@ -192,6 +235,12 @@ page {
   min-height: 100vh;
   padding: 32rpx;
 
+  /* 桌面浏览器打开时不至于拉满全屏 —— 主战场是手机，
+     但自动化验证与临时桌面查看都跑在桌面浏览器里，窄一点更像真实形态 */
+  max-width: 720rpx;
+  margin: 0 auto;
+  box-sizing: border-box;
+
   &__hero {
     padding: 48rpx 32rpx;
     background: linear-gradient(135deg, $primary 0%, #2b6fe0 100%);
diff --git a/frontend-mp/src/pages/verify/verify.vue b/frontend-mp/src/pages/verify/verify.vue
new file mode 100644
index 0000000..c9f92a2
--- /dev/null
+++ b/frontend-mp/src/pages/verify/verify.vue
@@ -0,0 +1,382 @@
+<template>
+  <view class="verify">
+    <view class="verify__wrap">
+      <!-- 任务抬头：让学生确认自己在给谁填 -->
+      <view class="verify__hero">
+        <text class="verify__tenant">{{ ctx.tenantName || '材料填报' }}</text>
+        <text class="verify__task">{{ ctx.taskName }}</text>
+      </view>
+
+      <!-- ① 还没核验：填姓名 + 证件号 -->
+      <view v-if="!matched" class="verify__card">
+        <view class="verify__title">核对身份</view>
+        <view class="verify__hint">
+          请填写<text class="verify__strong">报名时用的姓名和身份证号</text>，
+          与老师提交的名单核对。核对通过后才能开始填报。
+        </view>
+
+        <view class="verify__field">
+          <text class="verify__label">姓名</text>
+          <input v-model="realName" class="verify__input" placeholder="请填写真实姓名"
+            :disabled="submitting" />
+        </view>
+        <view class="verify__field">
+          <text class="verify__label">身份证号</text>
+          <input v-model="idCardNo" class="verify__input" placeholder="18 位身份证号"
+            maxlength="18" :disabled="submitting" />
+        </view>
+
+        <button class="verify__btn" :disabled="submitting || !canSubmit" @click="submit">
+          {{ submitting ? '核对中…' : '核对并继续' }}
+        </button>
+
+        <view v-if="error" class="verify__error">{{ error }}</view>
+
+        <view class="verify__foot">
+          核对不上？先确认姓名和证件号没有打错。仍然不行请联系班主任。
+        </view>
+      </view>
+
+      <!-- ② 核验通过：显示名册里老师已填的信息 -->
+      <view v-else class="verify__card">
+        <view class="verify__ok">✓ 核对通过</view>
+        <view class="verify__who">
+          <text class="verify__who-name">{{ matched.realName }}</text>
+          <text class="verify__who-id">{{ matched.idCardMask }}</text>
+        </view>
+        <view v-if="matched.orgName" class="verify__row">
+          <text class="verify__row-label">班级</text>
+          <text class="verify__row-value">{{ matched.orgName }}</text>
+        </view>
+
+        <view v-if="prefillRows.length" class="verify__section">
+          <view class="verify__section-title">
+            老师已填，请核对
+            <text class="verify__section-note">（这几项由老师按报考计划确定，学生不能改）</text>
+          </view>
+          <view v-for="row in prefillRows" :key="row.label" class="verify__row">
+            <text class="verify__row-label">{{ row.label }}</text>
+            <text class="verify__row-value">{{ row.value }}</text>
+          </view>
+        </view>
+
+        <button class="verify__btn" @click="next">开始填写材料</button>
+      </view>
+    </view>
+  </view>
+</template>
+
+<script setup lang="ts">
+import { computed, ref } from 'vue'
+import { onLoad } from '@dcloudio/uni-app'
+import { request } from '@/utils/request'
+
+/**
+ * 身份核验页（门禁）。
+ *
+ * <p>这是学生填材料之前的<strong>唯一一道门</strong>：姓名 + 身份证号必须与老师提交的
+ * 名单完全一致，否则不放行。核验通过后，系统就把这个微信账号与名单里的某一行
+ * <strong>钉死</strong>了 —— 后面所有材料都归属于那个人，不再依赖任何人的自觉。
+ *
+ * <p>三处刻意的设计：
+ * <ol>
+ *   <li><strong>失败提示不区分"姓名错"还是"号码错"</strong>（后端统一返回 40007）。
+ *       分开提示等于给出一个身份证号枚举器 —— 用任意姓名 + 目标号码试，
+ *       若提示"姓名不对"就说明号码在名单里。所以页面上也只显示后端给的那一句话，
+ *       <strong>不要自作聪明地在前端加"可能是身份证号错了"这类推断</strong>。</li>
+ *   <li><strong>预填项标注"老师已填，请核对"并明确不可改</strong>：报考职业/工种/等级
+ *       由老师按报考计划确定（名单里实测 28/28 都有值）。让学生重填只会制造错误，
+ *       而报错工种在机构那边是直接不受理。</li>
+ *   <li><strong>不在前端做证件号格式校验后放行</strong>：只做"非空 + 长度"这种
+ *       明显笔误的提示，真正的判定交给后端 —— 校验位、名册匹配、绑定状态都在那边。</li>
+ * </ol>
+ */
+defineOptions({ name: 'Verify' })
+
+interface SceneContext {
+  tenantName: string | null
+  taskId: number | null
+  taskName: string | null
+  canSubmit: boolean
+}
+
+interface MatchResult {
+  matched: boolean
+  rosterId: number
+  realName: string
+  idCardMask: string
+  orgName: string | null
+  prefill: Record<string, unknown>
+}
+
+const ctx = ref<Partial<SceneContext>>({})
+const matched = ref<MatchResult | null>(null)
+const realName = ref('')
+const idCardNo = ref('')
+const error = ref('')
+const submitting = ref(false)
+let taskId = 0
+
+const canSubmit = computed(() => !!ctx.value.taskId)
+
+/** 预填项的展示名（只用名册里老师填过的那几项） */
+const PREFILL_LABELS: Record<string, string> = {
+  occupation: '报考职业',
+  worktype: '报考工种',
+  jobLevel: '报考等级',
+  education: '学历',
+  school: '在读学校',
+  major: '所学专业',
+  enrollDate: '入学时间',
+  workUnit: '工作单位',
+  phone: '联系电话'
+}
+
+const prefillRows = computed(() => {
+  const pf = matched.value?.prefill || {}
+  const rows: Array<{ label: string, value: string }> = []
+  for (const [key, label] of Object.entries(PREFILL_LABELS)) {
+    const v = pf[key]
+    if (v !== undefined && v !== null && v !== '') {
+      rows.push({ label, value: String(v) })
+    }
+  }
+  return rows
+})
+
+function token(): string {
+  try {
+    return uni.getStorageSync('token') || ''
+  } catch {
+    return ''
+  }
+}
+
+async function loadContext(scene: string) {
+  if (!scene) return
+  try {
+    const data = await request<SceneContext>({
+      url: `/api/v1/mp/scene-context?scene=${encodeURIComponent(scene)}`
+    })
+    ctx.value = data
+    taskId = data.taskId || 0
+  } catch (e) {
+    error.value = e instanceof Error ? e.message : '读取任务信息失败'
+  }
+}
+
+async function submit() {
+  error.value = ''
+  const name = realName.value.trim()
+  const id = idCardNo.value.trim()
+  if (!name) {
+    error.value = '请填写姓名'
+    return
+  }
+  if (id.length !== 18) {
+    error.value = '身份证号应为 18 位'
+    return
+  }
+  submitting.value = true
+  try {
+    matched.value = await request<MatchResult>({
+      url: '/api/v1/mp/roster/match',
+      method: 'POST',
+      token: token(),
+      data: { realName: name, idCardNo: id, taskId }
+    })
+  } catch (e) {
+    // 错误提示原样显示后端那句话 —— 见文件头第 1 条，不要在前端加推断
+    error.value = e instanceof Error ? e.message : '核对失败'
+  } finally {
+    submitting.value = false
+  }
+}
+
+function next() {
+  uni.showToast({ title: '填写材料功能开发中', icon: 'none' })
+}
+
+onLoad((options) => {
+  loadContext(options?.scene || '')
+})
+</script>
+
+<style lang="scss">
+$primary: #0052d9;
+$success: #00a870;
+$danger: #e34d59;
+$page-bg: #f3f3f3;
+
+page {
+  background-color: $page-bg;
+}
+
+.verify {
+  min-height: 100vh;
+  padding: 24rpx;
+
+  /* 桌面浏览器打开时不至于拉满全屏 —— 主战场是手机，但自动化验证与
+     临时桌面查看都跑在这里，窄一点更像真实形态 */
+  &__wrap {
+    max-width: 720rpx;
+    margin: 0 auto;
+  }
+
+  &__hero {
+    padding: 32rpx 28rpx;
+    background: linear-gradient(135deg, $primary 0%, #2b6fe0 100%);
+    border-radius: 16rpx;
+  }
+
+  &__tenant {
+    display: block;
+    font-size: 24rpx;
+    color: rgba(255, 255, 255, 0.82);
+  }
+
+  &__task {
+    display: block;
+    margin-top: 10rpx;
+    font-size: 34rpx;
+    font-weight: 600;
+    line-height: 1.4;
+    color: #fff;
+  }
+
+  &__card {
+    margin-top: 20rpx;
+    padding: 32rpx 28rpx;
+    background: #fff;
+    border-radius: 12rpx;
+  }
+
+  &__title {
+    font-size: 32rpx;
+    font-weight: 600;
+    color: #000000e6;
+  }
+
+  &__hint {
+    margin-top: 12rpx;
+    font-size: 26rpx;
+    line-height: 1.7;
+    color: #00000080;
+  }
+
+  &__strong {
+    font-weight: 600;
+    color: $primary;
+  }
+
+  &__field {
+    margin-top: 28rpx;
+  }
+
+  &__label {
+    display: block;
+    margin-bottom: 10rpx;
+    font-size: 26rpx;
+    color: #00000099;
+  }
+
+  &__input {
+    height: 88rpx;
+    padding: 0 20rpx;
+    font-size: 30rpx;
+    background: #f5f6f8;
+    border-radius: 10rpx;
+  }
+
+  &__btn {
+    margin-top: 40rpx;
+    font-size: 32rpx;
+    color: #fff;
+    background: $primary;
+    border-radius: 12rpx;
+
+    &::after { border: none; }
+
+    &[disabled] {
+      color: #0000004d;
+      background: #e8e8e8;
+    }
+  }
+
+  &__error {
+    margin-top: 24rpx;
+    padding: 20rpx 24rpx;
+    font-size: 26rpx;
+    line-height: 1.7;
+    color: $danger;
+    background: #fef0f0;
+    border-radius: 10rpx;
+  }
+
+  &__foot {
+    margin-top: 28rpx;
+    font-size: 24rpx;
+    line-height: 1.7;
+    color: #0000004d;
+  }
+
+  &__ok {
+    font-size: 32rpx;
+    font-weight: 600;
+    color: $success;
+  }
+
+  &__who {
+    display: flex;
+    align-items: baseline;
+    gap: 16rpx;
+    margin-top: 16rpx;
+  }
+
+  &__who-name {
+    font-size: 36rpx;
+    font-weight: 600;
+    color: #000000e6;
+  }
+
+  &__who-id {
+    font-size: 26rpx;
+    color: #00000080;
+  }
+
+  &__section {
+    margin-top: 32rpx;
+    padding-top: 24rpx;
+    border-top: 1rpx solid #eee;
+  }
+
+  &__section-title {
+    font-size: 26rpx;
+    font-weight: 600;
+    color: #00000099;
+  }
+
+  &__section-note {
+    font-weight: 400;
+    color: #0000004d;
+  }
+
+  &__row {
+    display: flex;
+    justify-content: space-between;
+    padding: 16rpx 0;
+    border-bottom: 1rpx solid #f5f5f5;
+  }
+
+  &__row-label {
+    font-size: 28rpx;
+    color: #00000099;
+  }
+
+  &__row-value {
+    font-size: 28rpx;
+    font-weight: 500;
+    color: #000000e6;
+  }
+}
+</style>