feat(签署方式): 扩展为手写板/短信/Pad/公众号四种并集中口径

clinical-web/src/views/workbench/home/components/TodoPanel.vue

@@ -1,4 +1,6 @@
 <script setup lang="ts">
+import { readPendingTag } from '@/utils/signing-method'
+
 import type { HomeTodoItem } from '../types'
 
 defineProps<{
@@ -15,7 +17,7 @@ function getStatusLabel(item: HomeTodoItem) {
     case 'created':
       return '待发送'
     case 'pending':
-      return item.method === 'pad' ? '待签署·手写板' : '待签署·短信'
+      return readPendingTag(item.method).text
     case 'generating':
       return '文书生成中'
     case 'overdue':
@@ -35,7 +37,8 @@ function getStatusClass(item: HomeTodoItem) {
   }
 
   if (item.status === 'pending') {
-    return item.method === 'pad' ? 'todo-status--pad' : 'todo-status--sms'
+    // 与签署工作台同口径：待签署徽标按具体方式分色
+    return `todo-status--${readPendingTag(item.method).className.replace('tg-', '')}`
   }
 
   if (item.status === 'signed') {
@@ -203,6 +206,11 @@ function getHint(item: HomeTodoItem) {
   background: var(--brand-l);
 }
 
+.todo-status--ipad {
+  color: #2b6cb0;
+  background: #e8f1fb;
+}
+
 .todo-status--sms {
   color: #7a4dbb;
   background: #f3ecfb;

clinical-web/src/views/workbench/home/types.ts

@@ -1,3 +1,5 @@
+import type { SigningMethod } from '@/api/workbench/types'
+
 export type HomeMetricTone = 'brand' | 'success' | 'warning' | 'danger'
 
 export type HomeMetricKey = 'todaySigned' | 'pending' | 'overdue' | 'templates'
@@ -21,7 +23,8 @@ export interface HomeTrendPoint {
 export type HomeTodoStatus =
   'created' | 'pending' | 'generating' | 'overdue' | 'signed' | 'voided' | 'failed'
 
-export type HomeSigningMethod = 'pad' | 'sms'
+/** 与签署任务同一套方式口径，否则新通道的任务映射到首页待办会被 TS 挡下 */
+export type HomeSigningMethod = SigningMethod
 
 export interface HomeTodoItem {
   id: string

clinical-web/src/views/workbench/records/components/SigningRecordDetailDialog.vue

@@ -5,6 +5,7 @@ import type { SigningTaskEvent, SigningTaskStatus } from '@/api/workbench/types'
 import SigningDocumentInteractive from '@/components/signing/SigningDocumentInteractive.vue'
 import SigningDocumentPreview from '@/components/signing/SigningDocumentPreview.vue'
 import TaskAuditTimeline from '@/components/signing/TaskAuditTimeline.vue'
+import { formatSigningMethod } from '@/utils/signing-method'
 
 import type { SigningRecordRow } from '../types'
 
@@ -95,7 +96,7 @@ function value(value: string | undefined) {
             <div><dt>院区</dt><dd>{{ value(record.campus) }}</dd></div>
             <div>
               <dt>签署方式</dt>
-              <dd>{{ record.method === 'pad' ? '✍️ 手写板' : '📱 短信' }}</dd>
+              <dd>{{ formatSigningMethod(record.method) }}</dd>
             </div>
             <div><dt>发起时间</dt><dd>{{ value(record.createdAt) }}</dd></div>
             <div><dt>签署完成</dt><dd>{{ value(record.signedAt) }}</dd></div>

clinical-web/src/views/workbench/records/components/SigningRecordTable.vue

@@ -2,6 +2,7 @@
 import { computed } from 'vue'
 
 import type { SigningTaskStatus } from '@/api/workbench/types'
+import { formatSigningMethod, readSigningMethod } from '@/utils/signing-method'
 
 import type { SigningRecordRow } from '../types'
 
@@ -38,14 +39,14 @@ const statusLabels: Record<SigningTaskStatus, string> = {
 /** 待签署要带出渠道：现场等着签的是手写板，等患者点链接的是短信，处理方式完全不同 */
 function getStatusLabel(row: SigningRecordRow) {
   if (row.status === 'pending') {
-    return `${statusLabels[row.status]}·${row.method === 'pad' ? '手写板' : '短信'}`
+    return `${statusLabels[row.status]}·${readSigningMethod(row.method).short}`
   }
 
   return statusLabels[row.status]
 }
 
 function getMethodLabel(row: SigningRecordRow) {
-  return row.method === 'pad' ? '✍️ 手写板' : '📱 短信'
+  return formatSigningMethod(row.method)
 }
 
 function formatTime(value: string | undefined) {

clinical-web/src/views/workbench/records/index.vue

@@ -22,6 +22,7 @@ import type {
 import { useAppStore } from '@/stores/app'
 import { useLoginStore } from '@/stores/login'
 import { downloadCsv, fileStamp, saveBlob } from '@/utils/csv-export'
+import { readSigningMethod, WORKBENCH_METHOD_FILTERS } from '@/utils/signing-method'
 import { downloadSigningPdf } from '@/utils/signing-pdf'
 
 import SigningRecordDetailDialog from './components/SigningRecordDetailDialog.vue'
@@ -65,7 +66,7 @@ const EXPORT_COLUMNS: SigningRecordExportColumn[] = [
   { label: '文档类别', value: (record) => record.category },
   { label: '科室', value: (record) => record.department },
   { label: '院区', value: (record) => record.campus },
-  { label: '签署方式', value: (record) => (record.method === 'pad' ? '手写板' : '短信线上') },
+  { label: '签署方式', value: (record) => readSigningMethod(record.method).filterLabel },
   { label: '状态', value: (record) => statusLabels[record.status] },
   { label: '发起时间', value: (record) => record.createdAt ?? '' },
   { label: '签署完成时间', value: (record) => record.signedAt ?? '' },
@@ -132,10 +133,10 @@ const statusOptions: SigningRecordFilterOption<SigningRecordFilterForm['status']
   ),
 ]
 
+/** 原型 #qMethod 只有 3 项（手写板 / 短信线上 / Pad），没有公众号 */
 const methodOptions: SigningRecordFilterOption<SigningMethod | 'all'>[] = [
   { label: '全部方式', value: 'all' },
-  { label: '手写板', value: 'pad' },
-  { label: '短信线上', value: 'sms' },
+  ...WORKBENCH_METHOD_FILTERS.map((option) => ({ label: option.label, value: option.value })),
 ]
 
 /**

clinical-web/src/views/workbench/signing/components/SigningTaskDetail.vue

@@ -4,10 +4,12 @@ import { ref } from 'vue'
 import type {
   SigningAnswers,
   SigningArtifact,
+  SigningMethod,
   SigningTaskEvent,
   SigningTaskRecord,
 } from '@/api/workbench/types'
 import type { SigningFieldProgress, SigningSignatureRequest } from '@/utils/signing-document'
+import { formatSigningMethodTitle, readSigningMethod } from '@/utils/signing-method'
 
 import SigningDocumentInteractive from '@/components/signing/SigningDocumentInteractive.vue'
 import SigningDocumentPreview from '@/components/signing/SigningDocumentPreview.vue'
@@ -38,7 +40,7 @@ defineProps<{
 }>()
 
 const emit = defineEmits<{
-  action: [action: SigningTaskAction]
+  action: [action: SigningTaskAction, targetMethod?: SigningMethod]
   downloadArtifact: [artifact: SigningArtifact]
   selectionChange: [items: string[]]
   fieldChange: [answers: SigningAnswers, progress: SigningFieldProgress]
@@ -47,6 +49,25 @@ const emit = defineEmits<{
 
 const documentRef = ref<InstanceType<typeof SigningDocumentInteractive> | null>(null)
 
+/**
+ * 原型任务详情：主按钮 = 当前方式的签署入口，另外三种方式各给一个「转为 X」的次按钮。
+ * 原型的四种方式都走这一套（`待签署` 下四个 if/else 分支，主按钮与其余三个各不相同），
+ * 所以这里按**具体取值**分支，不做「现场 / 线上」归并。
+ */
+const ALTERNATE_METHODS: readonly SigningMethod[] = ['pad', 'sms', 'ipad', 'wx']
+
+function alternateMethods(current: SigningMethod): SigningMethod[] {
+  return ALTERNATE_METHODS.filter((item) => item !== current)
+}
+
+/**
+ * 现场设备签署（手写板 / Pad）走本地采集入口；线上（短信 / 公众号）走患者端页面。
+ * 这只是**入口形态**的分组，不是取值归并 —— 按钮文案、状态标签仍按具体取值区分。
+ */
+function isOnsiteMethod(method: SigningMethod): boolean {
+  return method === 'pad' || method === 'ipad'
+}
+
 /** 供父级「导出 PDF」使用：转发到实际渲染文书的那一层 */
 function getDocumentElement() {
   return documentRef.value?.getDocumentElement() ?? null
@@ -66,61 +87,63 @@ defineExpose({ getDocumentElement })
       <div class="task-actions">
         <span class="task-action-meta">任务 {{ task.id }} · {{ task.patientName }}</span>
 
-        <template v-if="task.status === 'pending' && task.method === 'pad'">
-          <template v-if="allowLocalSigning">
-            <button type="button" class="action-button" @click="emit('action', 'pad-sign')">
-              ✍ 手写板签署
-            </button>
-            <button
-              type="button"
-              class="action-button action-button--ghost"
-              @click="emit('action', 'switch-method')"
-            >
-              转为短信发送
-            </button>
+        <template v-if="task.status === 'pending'">
+          <!-- 主按钮 = 当前方式的签署入口（原型：手写板/Pad 走现场设备，短信/公众号走线上页面） -->
+          <template v-if="isOnsiteMethod(task.method)">
+            <template v-if="allowLocalSigning">
+              <button type="button" class="action-button" @click="emit('action', 'pad-sign')">
+                {{ formatSigningMethodTitle(task.method) }}
+              </button>
+            </template>
+            <template v-else-if="canDeliveryWrite">
+              <button
+                type="button"
+                class="action-button"
+                :disabled="padSessionLoading"
+                @click="emit('action', 'create-pad-session')"
+              >
+                {{
+                  padSessionLoading ? '创建会话中…' : `创建${readSigningMethod(task.method).short}会话`
+                }}
+              </button>
+              <span v-if="padSessionStatus" class="action-hint">
+                会话状态：{{ padSessionStatus }}；等待设备适配器读取 challenge
+              </span>
+              <span v-else class="action-hint">创建会话后仍需接入厂商设备适配器完成签名采集</span>
+            </template>
           </template>
-          <template v-else-if="canDeliveryWrite">
+          <template v-else>
             <button
+              v-if="allowLocalSigning"
               type="button"
               class="action-button"
-              :disabled="padSessionLoading"
-              @click="emit('action', 'create-pad-session')"
+              @click="emit('action', 'online-sign')"
             >
-              {{ padSessionLoading ? '创建会话中…' : '创建手写板会话' }}
+              查看{{ readSigningMethod(task.method).short }}签署
             </button>
-            <span v-if="padSessionStatus" class="action-hint">
-              会话状态：{{ padSessionStatus }}；等待设备适配器读取 challenge
-            </span>
-            <span v-else class="action-hint">创建会话后仍需接入厂商设备适配器完成签名采集</span>
+            <span v-else class="action-hint">线上签署页面接口待接入</span>
           </template>
-        </template>
 
-        <template v-else-if="task.status === 'pending' && task.method === 'sms'">
+          <!-- 其余三种方式：一键转换（原型四种方式互为切换入口） -->
           <button
-            v-if="allowLocalSigning"
-            type="button"
-            class="action-button"
-            @click="emit('action', 'online-sign')"
-          >
-            📱 查看线上签署
-          </button>
-          <span v-else class="action-hint">线上签署页面接口待接入</span>
-          <button
-            v-if="allowLocalSigning"
+            v-for="target in alternateMethods(task.method)"
+            :key="target"
             type="button"
             class="action-button action-button--ghost"
-            @click="emit('action', 'switch-method')"
+            @click="emit('action', 'switch-method', target)"
           >
-            转手写板签署
+            {{ readSigningMethod(target).short }}签署
           </button>
+
           <button
-            v-if="canDeliveryWrite"
+            v-if="canDeliveryWrite && task.method === 'sms'"
             type="button"
             class="action-button action-button--ghost"
             @click="emit('action', 'resend-sms')"
           >
             重发短信
           </button>
+          <span v-else-if="task.method === 'wx'" class="action-hint">公众号推送接口待接入</span>
         </template>
 
         <template v-else-if="task.status === 'expired' && canReopen">

clinical-web/src/views/workbench/signing/components/SigningTaskList.vue

@@ -2,6 +2,7 @@
 import { computed } from 'vue'
 
 import type { SigningTaskRecord } from '@/api/workbench/types'
+import { formatSigningMethod, readPendingTag } from '@/utils/signing-method'
 
 const props = defineProps<{
   tasks: SigningTaskRecord[]
@@ -30,14 +31,20 @@ const statusLabels: Record<SigningTaskRecord['status'], string> = {
 
 function getStatusClass(task: SigningTaskRecord) {
   if (task.status === 'pending') {
-    return task.method === 'pad' ? 'task-status--pad' : 'task-status--sms'
+    // 待签署徽标按具体方式分色（原型 tg-pad / tg-ipad / tg-sms 三分支）
+    return `task-status--${readPendingTag(task.method).className.replace('tg-', '')}`
   }
 
   return `task-status--${task.status}`
 }
 
 function getMethodLabel(task: SigningTaskRecord) {
-  return task.method === 'pad' ? '✍ 手写板' : '📱 短信'
+  return formatSigningMethod(task.method)
+}
+
+/** 待签署徽标带出具体方式：现场等着签的是手写板/Pad，等患者点链接的是短信/公众号 */
+function getPendingLabel(task: SigningTaskRecord) {
+  return readPendingTag(task.method).text
 }
 
 function getVisitClass(type: SigningTaskRecord['visitType']) {
@@ -79,13 +86,7 @@ function getVisitClass(type: SigningTaskRecord['visitType']) {
           <span class="task-basic">{{ task.sex }} · {{ task.age }}岁</span>
           <span class="task-spacer" />
           <span class="task-status" :class="getStatusClass(task)">
-            {{
-              task.status === 'pending'
-                ? task.method === 'pad'
-                  ? '待签署·手写板'
-                  : '待签署·短信'
-                : statusLabels[task.status]
-            }}
+            {{ task.status === 'pending' ? getPendingLabel(task) : statusLabels[task.status] }}
           </span>
         </span>
         <span class="task-row task-row--document">📄 {{ task.documentName }}</span>
@@ -224,6 +225,12 @@ function getVisitClass(type: SigningTaskRecord['visitType']) {
   background: var(--brand-l);
 }
 
+/* 原型 .tg-ipad：平板方式单独一色，不与手写板混用 */
+.task-status--ipad {
+  color: #2b6cb0;
+  background: #e8f1fb;
+}
+
 .task-status--sms {
   color: #7a4dbb;
   background: #f3ecfb;

clinical-web/src/views/workbench/signing/index.vue

@@ -39,6 +39,12 @@ import NewSigningTaskDialog from '@/components/signing/NewSigningTaskDialog.vue'
 import { useAppStore } from '@/stores/app'
 import { useLoginStore } from '@/stores/login'
 import type { SigningFieldProgress, SigningSignatureRequest } from '@/utils/signing-document'
+import {
+  formatSigningMethodTitle,
+  readSigningMethod,
+  toggleSigningMethod,
+  WORKBENCH_METHOD_FILTERS,
+} from '@/utils/signing-method'
 import { downloadSigningPdf } from '@/utils/signing-pdf'
 
 import OnlineSigningDialog from './components/OnlineSigningDialog.vue'
@@ -156,10 +162,10 @@ const statusOptions: SigningFilterOption<SigningFilterForm['status']>[] = [
   ...STATUS_VALUES.map((status) => ({ label: statusLabels[status], value: status })),
 ]
 
+/** 原型 #qMethod 只有 3 项（手写板 / 短信线上 / Pad），没有公众号 */
 const methodOptions: SigningFilterOption<SigningFilterForm['method']>[] = [
   { label: '全部方式', value: 'all' },
-  { label: '手写板', value: 'pad' },
-  { label: '短信线上', value: 'sms' },
+  ...WORKBENCH_METHOD_FILTERS.map((option) => ({ label: option.label, value: option.value })),
 ]
 
 const visitTypeOptions: SigningFilterOption<VisitType | 'all'>[] = [
@@ -512,7 +518,7 @@ async function refreshTask(updatedTask: SigningTaskRecord | null, successMessage
   ElMessage.success(successMessage)
 }
 
-async function handleTaskAction(action: SigningTaskAction) {
+async function handleTaskAction(action: SigningTaskAction, targetMethod?: SigningMethod) {
   const task = selectedTask.value
 
   if (!task) {
@@ -535,7 +541,7 @@ async function handleTaskAction(action: SigningTaskAction) {
 
   if (action === 'pad-sign') {
     if (!isSigningMockEnabled) {
-      ElMessage.info('手写板设备签署接口待接入')
+      ElMessage.info(`${readSigningMethod(task.method).short}设备签署接口待接入`)
       return
     }
 
@@ -553,9 +559,11 @@ async function handleTaskAction(action: SigningTaskAction) {
     try {
       const session: SignDeliveryResponseDto = await createPadSigningSession(task.id)
       padSessionStatus.value = session.status
-      ElMessage.success('手写板签署会话已创建，请由设备适配器继续采集签名')
+      ElMessage.success(
+        `${readSigningMethod(task.method).short}签署会话已创建，请由设备适配器继续采集签名`,
+      )
     } catch {
-      ElMessage.error('手写板签署会话创建失败，请稍后重试')
+      ElMessage.error(`${readSigningMethod(task.method).short}签署会话创建失败，请稍后重试`)
     } finally {
       padSessionLoading.value = false
     }
@@ -623,10 +631,11 @@ async function handleTaskAction(action: SigningTaskAction) {
         return
       }
 
-      const method: SigningMethod = task.method === 'pad' ? 'sms' : 'pad'
+      // 详情页的次按钮会带上目标方式；没有目标时退回原型 switchMethod 的二选一
+      const method: SigningMethod = targetMethod ?? toggleSigningMethod(task.method)
       await refreshTask(
         await updateSigningTaskMethod(task.id, method),
-        method === 'sms' ? '已切换为短信线上签署' : '已切换为手写板签署',
+        `已切换为${formatSigningMethodTitle(method)}`,
       )
       return
     }