feat(signing): 接入工作台任务操作与审计

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

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import type { SigningTaskRecord } from '@/api/workbench/types'
+import type { SigningTaskEvent, SigningTaskRecord } from '@/api/workbench/types'
 
 import SigningDocumentPreview from './SigningDocumentPreview.vue'
 import TaskAuditTimeline from './TaskAuditTimeline.vue'
@@ -8,6 +8,10 @@ import type { SigningTaskAction } from '../types'
 defineProps<{
   task: SigningTaskRecord | null
   loading: boolean
+  auditEvents: SigningTaskEvent[]
+  auditLoading: boolean
+  auditError: boolean
+  allowLocalSigning: boolean
 }>()
 
 const emit = defineEmits<{
@@ -27,6 +31,7 @@ const emit = defineEmits<{
         <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>
@@ -38,12 +43,21 @@ const emit = defineEmits<{
               转为短信发送
             </button>
           </template>
+          <span v-else class="action-hint">手写板设备签署接口待接入</span>
+        </template>
 
         <template v-else-if="task.status === 'pending' && task.method === 'sms'">
-          <button type="button" class="action-button" @click="emit('action', 'online-sign')">
+          <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"
             type="button"
             class="action-button action-button--ghost"
             @click="emit('action', 'switch-method')"
@@ -59,7 +73,7 @@ const emit = defineEmits<{
           </button>
         </template>
 
-        <template v-else-if="task.status === 'expired'">
+        <template v-else-if="task.status === 'expired' || task.status === 'failed'">
           <button type="button" class="action-button" @click="emit('action', 'reopen')">
             ↻ 重新发起
           </button>
@@ -90,7 +104,12 @@ const emit = defineEmits<{
         </template>
 
         <button
-          v-if="task.status === 'pending' || task.status === 'expired' || task.status === 'signing'"
+          v-if="
+            task.status === 'pending' ||
+            task.status === 'expired' ||
+            task.status === 'signing' ||
+            task.status === 'failed'
+          "
           type="button"
           class="action-button action-button--danger"
           @click="emit('action', 'void')"
@@ -100,7 +119,7 @@ const emit = defineEmits<{
       </div>
 
       <SigningDocumentPreview :task="task" />
-      <TaskAuditTimeline :task="task" />
+      <TaskAuditTimeline :events="auditEvents" :loading="auditLoading" :error="auditError" />
     </template>
 
     <div v-else class="detail-empty">
@@ -131,6 +150,15 @@ const emit = defineEmits<{
   font-size: 12px;
 }
 
+.action-hint {
+  padding: 8px 12px;
+  color: var(--mut);
+  font-size: 12px;
+  background: #f7fafb;
+  border: 1px dashed var(--line);
+  border-radius: 7px;
+}
+
 .action-button {
   flex-shrink: 0;
   padding: 8px 16px;

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

@@ -19,6 +19,7 @@ const statusLabels: Record<SigningTaskRecord['status'], string> = {
   rejected: '已拒签',
   expired: '已超时',
   void: '已作废',
+  failed: '处理失败',
 }
 
 function getStatusClass(task: SigningTaskRecord) {
@@ -217,6 +218,11 @@ function getVisitClass(type: SigningTaskRecord['visitType']) {
   background: var(--err-l);
 }
 
+.task-status--failed {
+  color: #a15c19;
+  background: #fff3df;
+}
+
 .task-status--void {
   color: #8a9aa3;
   background: #eceef0;

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

@@ -1,49 +1,34 @@
 <script setup lang="ts">
-import { computed } from 'vue'
+import type { SigningTaskEvent } from '@/api/workbench/types'
 
-import type { SigningTaskRecord } from '@/api/workbench/types'
+defineProps<{
-
+  events: SigningTaskEvent[]
-const props = defineProps<{
+  loading: boolean
-  task: SigningTaskRecord
+  error: boolean
 }>()
-
-const events = computed(() => {
-  const result = [
-    {
-      time: props.task.updatedAt,
-      text: `张文静发起签署任务（${props.task.method === 'pad' ? '手写板' : '线上短信'}）`,
-    },
-  ]
-
-  if (props.task.status === 'signing') {
-    result.push({ time: props.task.updatedAt, text: '已打开签名采集，等待患者完成签名' })
-  }
-
-  if (props.task.signedAt) {
-    result.push({
-      time: props.task.signedAt,
-      text: `患者 ${props.task.patientName} 完成签名，系统自动合成并双留存`,
-    })
-  }
-
-  if (props.task.status === 'void') {
-    result.push({
-      time: props.task.updatedAt,
-      text: `任务已作废${props.task.voidReason ? `，原因：${props.task.voidReason}` : ''}，全程可审计`,
-    })
-  }
-
-  return result
-})
 </script>
 
 <template>
   <section class="audit-card">
     <strong>操作留痕</strong>
-    <ol class="audit-list">
+
-      <li v-for="event in events" :key="`${event.time}-${event.text}`">
+    <div v-if="loading" class="audit-state">正在加载操作留痕…</div>
+    <div v-else-if="error" class="audit-state audit-state--error">
+      操作留痕加载失败，请稍后刷新重试
+    </div>
+    <div v-else-if="!events.length" class="audit-state">暂无操作留痕</div>
+
+    <ol v-else class="audit-list">
+      <li v-for="event in events" :key="event.id">
         <time>{{ event.time }}</time>
+        <span class="audit-event-content">
           <span>{{ event.text }}</span>
+          <small v-if="event.attemptNo || event.reason">
+            <template v-if="event.attemptNo">第 {{ event.attemptNo }} 次</template>
+            <template v-if="event.attemptNo && event.reason"> · </template>
+            <template v-if="event.reason">{{ event.reason }}</template>
+          </small>
+        </span>
       </li>
     </ol>
   </section>
@@ -62,6 +47,16 @@ const events = computed(() => {
   font-size: 12px;
 }
 
+.audit-state {
+  padding: 8px 0 1px;
+  color: var(--mut);
+  font-size: 12px;
+}
+
+.audit-state--error {
+  color: var(--err);
+}
+
 .audit-list {
   display: flex;
   flex-direction: column;
@@ -83,4 +78,15 @@ const events = computed(() => {
   flex-shrink: 0;
   color: var(--mut);
 }
+
+.audit-event-content {
+  display: inline-flex;
+  gap: 4px;
+  flex-wrap: wrap;
+}
+
+.audit-event-content small {
+  color: var(--mut);
+  font-size: 11px;
+}
 </style>

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

@@ -6,8 +6,10 @@ import { useRoute } from 'vue-router'
 import {
   completeSigningTask,
   getSigningTaskDetail,
+  getSigningTaskEvents,
   getSigningTasks,
   getSigningTemplates,
+  isSigningMockEnabled,
   reopenSigningTask,
   resendSigningSms,
   updateSigningTaskMethod,
@@ -16,6 +18,7 @@ import {
 import type {
   SigningDateRange,
   SigningMethod,
+  SigningTaskEvent,
   SigningTaskRecord,
   SigningTaskStatus,
   SigningTemplate,
@@ -43,6 +46,7 @@ const STATUS_VALUES: SigningTaskStatus[] = [
   'rejected',
   'expired',
   'void',
+  'failed',
 ]
 const DATE_RANGE_VALUES: SigningDateRange[] = ['today', 'yesterday', '3d', '7d', 'all']
 
@@ -53,6 +57,7 @@ const statusLabels: Record<SigningTaskStatus, string> = {
   rejected: '已拒签',
   expired: '已超时',
   void: '已作废',
+  failed: '处理失败',
 }
 
 const filter = reactive<SigningFilterForm>({
@@ -70,9 +75,12 @@ const tasks = ref<SigningTaskRecord[]>([])
 const total = ref(0)
 const selectedTaskId = ref<string | null>(null)
 const selectedTask = ref<SigningTaskRecord | null>(null)
+const taskEvents = ref<SigningTaskEvent[]>([])
 const templates = ref<SigningTemplate[]>([])
 const loading = ref(true)
 const detailLoading = ref(false)
+const eventsLoading = ref(false)
+const eventsError = ref(false)
 const newDialogVisible = ref(false)
 const signatureDialogVisible = ref(false)
 const onlineDialogVisible = ref(false)
@@ -121,6 +129,11 @@ const documentOptions = computed<SigningFilterOption[]>(() => [
   ...templates.value.map((template) => ({ label: template.name, value: template.id })),
 ])
 
+const signingApiOptions = computed(() => ({
+  campus: appStore.selectedCampus,
+  templates: templates.value,
+}))
+
 function getQueryString(value: unknown) {
   return typeof value === 'string' ? value : ''
 }
@@ -154,26 +167,47 @@ async function loadTaskDetail(id: string | null) {
 
   if (!id) {
     selectedTask.value = null
+    taskEvents.value = []
     detailLoading.value = false
+    eventsLoading.value = false
+    eventsError.value = false
     return
   }
 
   detailLoading.value = true
+  eventsLoading.value = true
+  eventsError.value = false
+  taskEvents.value = []
 
   try {
-    const detail = await getSigningTaskDetail(id)
+    const [detailResult, eventsResult] = await Promise.allSettled([
+      getSigningTaskDetail(id, signingApiOptions.value),
+      getSigningTaskEvents(id),
+    ])
 
     if (requestId === detailRequestId) {
-      selectedTask.value = detail
+      if (detailResult.status === 'rejected') {
+        throw detailResult.reason
+      }
+
+      selectedTask.value = detailResult.value
+
+      if (eventsResult.status === 'fulfilled') {
+        taskEvents.value = eventsResult.value
+      } else {
+        eventsError.value = true
+      }
     }
   } catch {
     if (requestId === detailRequestId) {
       selectedTask.value = null
+      taskEvents.value = []
       ElMessage.error('签署任务详情加载失败，请稍后重试')
     }
   } finally {
     if (requestId === detailRequestId) {
       detailLoading.value = false
+      eventsLoading.value = false
     }
   }
 }
@@ -183,11 +217,14 @@ async function loadTasks(preferredTaskId?: string) {
   loading.value = true
 
   try {
-    const response = await getSigningTasks({
+    const response = await getSigningTasks(
+      {
         ...filter,
         page: 1,
         pageSize: 50,
-    })
+      },
+      signingApiOptions.value,
+    )
 
     if (requestId !== listRequestId) {
       return
@@ -249,11 +286,21 @@ async function handleTaskAction(action: SigningTaskAction) {
   }
 
   if (action === 'pad-sign') {
+    if (!isSigningMockEnabled) {
+      ElMessage.info('手写板设备签署接口待接入')
+      return
+    }
+
     signatureDialogVisible.value = true
     return
   }
 
   if (action === 'online-sign') {
+    if (!isSigningMockEnabled) {
+      ElMessage.info('线上签署页面接口待接入')
+      return
+    }
+
     onlineDialogVisible.value = true
     return
   }
@@ -280,6 +327,11 @@ async function handleTaskAction(action: SigningTaskAction) {
 
   try {
     if (action === 'switch-method') {
+      if (!isSigningMockEnabled) {
+        ElMessage.info('当前后端未提供切换签署方式接口，请作废后重新创建任务')
+        return
+      }
+
       const method: SigningMethod = task.method === 'pad' ? 'sms' : 'pad'
       await refreshTask(
         await updateSigningTaskMethod(task.id, method),
@@ -289,12 +341,24 @@ async function handleTaskAction(action: SigningTaskAction) {
     }
 
     if (action === 'resend-sms') {
-      await refreshTask(await resendSigningSms(task.id), '短信已重新发送')
+      await refreshTask(
+        await resendSigningSms(task.id, {
+          ...signingApiOptions.value,
+          expectedRowVersion: task.rowVersion,
+        }),
+        '短信已重新发送',
+      )
       return
     }
 
     if (action === 'reopen') {
-      await refreshTask(await reopenSigningTask(task.id), '签署任务已重新发起')
+      await refreshTask(
+        await reopenSigningTask(task.id, {
+          ...signingApiOptions.value,
+          expectedRowVersion: task.rowVersion,
+        }),
+        '签署任务已重新发起',
+      )
     }
   } catch {
     ElMessage.error('任务操作失败，请稍后重试')
@@ -339,7 +403,13 @@ async function confirmVoidTask(reason: string) {
   }
 
   try {
-    await refreshTask(await voidSigningTask(task.id, reason), '签署任务已作废')
+    await refreshTask(
+      await voidSigningTask(task.id, reason, {
+        ...signingApiOptions.value,
+        expectedRowVersion: task.rowVersion,
+      }),
+      '签署任务已作废',
+    )
     voidDialogVisible.value = false
   } catch {
     ElMessage.error('任务作废失败，请稍后重试')
@@ -350,6 +420,11 @@ async function handleOnlineResend() {
   await handleTaskAction('resend-sms')
 }
 
+async function initializePage() {
+  await loadTemplates()
+  await loadTasks()
+}
+
 async function handleTaskCreated(task: SigningTaskRecord) {
   await loadTasks(task.id)
 }
@@ -375,7 +450,7 @@ watch(
 
 onMounted(() => {
   syncFilterFromRoute()
-  void Promise.all([loadTemplates(), loadTasks()])
+  void initializePage()
 })
 </script>
 
@@ -412,7 +487,15 @@ onMounted(() => {
         :loading="loading"
         @select="selectTask"
       />
-      <SigningTaskDetail :task="selectedTask" :loading="detailLoading" @action="handleTaskAction" />
+      <SigningTaskDetail
+        :task="selectedTask"
+        :loading="detailLoading"
+        :audit-events="taskEvents"
+        :audit-loading="eventsLoading"
+        :audit-error="eventsError"
+        :allow-local-signing="isSigningMockEnabled"
+        @action="handleTaskAction"
+      />
     </div>
 
     <NewSigningTaskDialog