feat(followup-audio): soft delete unadopted recordings and expose extraction doubts

admin/src/api/followupAudio.ts

@@ -75,6 +75,8 @@ export interface FollowupTaskSummary {
     version: number
     created_at: number | string
     expires_at: number | string
+    can_delete?: boolean
+    delete_block_reason?: string
     can_retry: boolean
     audio_available: boolean
     preview_only?: boolean
@@ -130,6 +132,7 @@ export const followupAudioUploadComplete = (uploadId: string, signal?: AbortSign
 export const followupAudioCreate = (data: { diagnosis_id: number; upload_id: string; recorded_at: string; model_key: string; channel_roles?: FollowupChannelRoles }, signal?: AbortSignal) => post<{ task_id: number; status: string; reused?: boolean; reuse_message?: string }>('create', data, signal)
 export const followupAudioSaveDraft = (data: { id: number; version: number; items: FollowupReviewItem[]; channel_roles?: FollowupChannelRoles }, signal?: AbortSignal) => post<FollowupTaskDetail>('saveDraft', data, signal)
 export const followupAudioApply = (data: { id: number; version: number; items: FollowupReviewItem[] }, signal?: AbortSignal) => post<{ id: number; status: 'applied'; applied_items: unknown[] }>('apply', data, signal)
+export const followupAudioDelete = (data: { id: number; version: number }, signal?: AbortSignal) => post<{ id: number; status: 'deleted'; version: number }>('delete', data, signal)
 export const followupAudioRetry = (id: number, signal?: AbortSignal) => post<{ id: number; status: string }>('retry', { id }, signal)
 /** The existing request interceptor puts the token in a header, never in the audio URL. */
 export async function followupAudioBlob(id: number, signal?: AbortSignal): Promise<Blob> {

admin/src/views/tcm/diagnosis/components/FollowupAudioPanel.vue

@@ -34,8 +34,8 @@
                 <el-table-column label="状态" width="145">
                     <template #default="{ row }"><el-tag size="small" :type="statusType(row.status)">{{ followupTaskStatus(row) }}</el-tag><div v-if="row.transcript_available && (row.status === 'failed' || row.status === 'needs_reconciliation')" class="task-time">转写已保留</div></template>
                 </el-table-column>
-                <el-table-column label="操作" width="65" align="right">
-                    <template #default="{ row }"><el-button link type="primary" :disabled="busy" @click="openTask(row.id)">查看</el-button></template>
+                <el-table-column label="操作" width="112" align="right">
+                    <template #default="{ row }"><el-button link type="primary" :disabled="busy" @click="openTask(row.id)">查看</el-button><el-button v-if="!viewOnly && row.can_delete !== undefined" link type="danger" :disabled="busy || !canDeleteTask(row)" :title="row.delete_block_reason || '删除未入单录音任务'" @click="deleteRecording(row)">删除</el-button></template>
                 </el-table-column>
             </el-table>
         </div>
@@ -43,7 +43,7 @@
         <section v-if="selectedId && detail" class="task-detail" aria-label="录音任务详情">
             <div class="detail-heading">
                 <div class="recording-title"><h3>{{ detail.file_name }}</h3><span>通话时间 {{ detail.recorded_at }}</span></div>
-                <el-tag size="small" :type="statusType(detail.status)">{{ followupTaskStatus(detail) }}</el-tag>
+                <div class="detail-actions"><el-tag size="small" :type="statusType(detail.status)">{{ followupTaskStatus(detail) }}</el-tag><el-button v-if="!viewOnly && detail.can_delete !== undefined" link type="danger" :disabled="busy || !canDeleteTask(detail)" :title="detail.delete_block_reason || '删除未入单录音任务'" @click="deleteRecording(detail)">删除录音</el-button></div>
             </div>
             <p v-if="detail.status === 'running' || detail.status === 'queued'" class="processing-state" role="status">{{ followupProgressText(detail) }}</p>
             <el-alert v-if="detail.error_message || detail.status === 'failed'" :type="detail.status === 'failed' ? 'error' : 'warning'" :closable="false" :title="detail.error_message || '任务处理失败，不能写入；请先核对失败原因。'" />
@@ -56,6 +56,7 @@
                 <p>{{ detail.summary || '暂无回访摘要' }}</p>
                 <div class="summary-counts"><span>{{ detail.status === 'applied' ? '已写入' : '已选' }} <strong>{{ selectedCount }}</strong> 项</span><span>待核实 <strong>{{ pendingCount }}</strong> 项</span></div>
             </div>
+            <el-alert v-if="detail.status === 'review' && !reviewItems.length" type="warning" :closable="false" title="未生成可写入信息" :description="detail.uncertainties.length ? `本次提炼保留了 ${detail.uncertainties.length} 条待核实原因，已展示在下方。请结合原文回听核对，尤其注意声道角色是否相符。` : '请查看回访摘要并回听录音；本次没有可供确认写入的结构化候选。'" show-icon />
             <section v-if="hasStereo" class="channel-role-box" aria-label="声道角色人工标注">
                 <div v-if="savedChannelRoles !== 'unconfirmed' && !editingRoles && !roleDirty" class="role-summary"><span>{{ savedChannelRoles === 'left_service' ? '左客服端 / 右患者或家属端' : '右客服端 / 左患者或家属端' }} · 已确认</span><el-button v-if="canEditReview" link type="primary" @click="editingRoles = true">修改</el-button></div>
                 <label v-else>声道角色（人工确认）<el-select :model-value="channelRoles" :disabled="!canEditReview || (busy && mutation !== 'save')" @update:model-value="setChannelRoles"><el-option label="角色待确认" value="unconfirmed" /><el-option label="左客服端 / 右患者或家属端" value="left_service" /><el-option label="右客服端 / 左患者或家属端" value="right_service" /></el-select></label>
@@ -144,7 +145,7 @@
 import { computed, nextTick, onBeforeUnmount, onMounted, ref, watch } from 'vue'
 import { ElMessage, ElMessageBox } from 'element-plus'
 import {
-    FollowupAudioError, followupAudioApply, followupAudioBlob, followupAudioCreate,
+    FollowupAudioError, followupAudioDelete, followupAudioApply, followupAudioBlob, followupAudioCreate,
     followupAudioDetail, followupAudioLists, followupAudioRetry, followupAudioSaveDraft,
     followupAudioUploadChunk, followupAudioUploadComplete, followupAudioUploadSession,
     type FollowupAudioChannel, type FollowupCapabilities, type FollowupChannelRoles, type FollowupReviewItem, type FollowupTaskDetail, type FollowupTaskSummary
@@ -194,7 +195,7 @@ const uploading = ref(false)
 const uploadProgress = ref(0)
 const uploadStage = ref('')
 const createUncertain = ref(false)
-const mutation = ref<'save' | 'apply' | 'retry' | ''>('')
+const mutation = ref<'save' | 'apply' | 'retry' | 'delete' | ''>('')
 const errorMessage = ref('')
 const audioUrl = ref('')
 const audioElement = ref<HTMLAudioElement | null>(null)
@@ -270,9 +271,25 @@ function setChannelRoles(value: unknown) {
     if (!canEditReview.value || (busy.value && mutation.value !== 'save') || !hasStereo.value || !['unconfirmed', 'left_service', 'right_service'].includes(String(value))) return
     channelRoles.value = value as FollowupChannelRoles
 }
-async function readDetail(id: number, preserve = false) {
+function taskUnavailable(error: unknown): boolean {
+    return error instanceof FollowupAudioError && (error.code === 'FOLLOWUP_AUDIO_TASK_UNAVAILABLE' || error.message.includes('FOLLOWUP_AUDIO_TASK_UNAVAILABLE'))
+}
+function forgetUnavailableTask(id: number) {
+    if (selectedId.value !== id) return
+    stop(); resetRoles(); selectedId.value = 0; detail.value = null; reviewItems.value = []; snapshot.value = '[]'; detailSections.value = []
+    tasks.value = tasks.value.filter(row => row.id !== id)
+    errorMessage.value = '录音已删除或不再可访问，已关闭本页缓存与播放；未写入病例。'
+    void refresh()
+}
+async function readDetail(id: number, preserve = false, verifyOnly = false) {
     const ticket = scope.capture()
-    const fresh = await followupAudioDetail(id, ticket.signal)
+    let fresh: FollowupTaskDetail
+    try { fresh = await followupAudioDetail(id, ticket.signal) }
+    catch (error) {
+        if (scope.current(ticket) && id === selectedId.value && taskUnavailable(error)) { forgetUnavailableTask(id); return }
+        throw error
+    }
+    if (verifyOnly && detail.value && fresh.version === detail.value.version && fresh.status === detail.value.status) return
     if (!scope.current(ticket) || id !== selectedId.value || (detail.value && fresh.version < detail.value.version)) return
     preserve = preserve || (!!detail.value && dirty.value)
     const newlyApplied = detail.value?.status === 'review' && fresh.status === 'applied'
@@ -292,6 +309,9 @@ async function refresh() {
         const updated = tasks.value.find(task => task.id === selectedId.value)
         if (updated && (!detail.value || updated.version > detail.value.version || (updated.version >= detail.value.version && updated.status !== detail.value.status) || updated.status === 'running')) {
             await readDetail(updated.id, dirty.value)
+        } else if (!updated && selectedId.value && detail.value) {
+            // A limited list can omit older tasks; only an authoritative detail denial revokes them.
+            await readDetail(selectedId.value, false, true)
         }
     } catch (error) { if (scope.current(ticket)) errorMessage.value = followupError(error) }
     finally {
@@ -382,6 +402,7 @@ async function submitUpload() {
 }
 async function handleReviewError(error: unknown) {
     const ticket = scope.capture()
+    if (taskUnavailable(error) && detail.value) { forgetUnavailableTask(detail.value.id); return }
     errorMessage.value = followupError(error)
     const stale = error instanceof FollowupAudioError && error.code === 'FOLLOWUP_AUDIO_STALE_REVIEW'
     if (stale || /STALE_REVIEW|版本|快照|已变化/.test(errorMessage.value)) {
@@ -488,6 +509,35 @@ async function applySelected() {
     } catch (error) { if (scope.current(ticket)) await handleReviewError(error) }
     finally { if (scope.current(ticket)) { mutation.value = ''; await refresh() } }
 }
+function canDeleteTask(task: FollowupTaskSummary): boolean {
+    return !props.viewOnly && featureEnabled.value && task.can_delete === true && ['review', 'failed'].includes(task.status)
+}
+async function deleteRecording(task: FollowupTaskSummary) {
+    if (busy.value || !canDeleteTask(task)) return
+    const ticket = scope.capture(), diagnosisId = props.diagnosisId, id = task.id, version = task.version
+    const current = () => scope.current(ticket) && diagnosisId === props.diagnosisId
+    clearAutosave(); clearTimer(); mutation.value = 'delete'; errorMessage.value = ''
+    let confirmed = false
+    try {
+        await ElMessageBox.confirm('删除后，该录音任务及审核草稿将从列表移除，未保存修改会丢弃；不删除或回滚病例。原录音和转写仍按原保留期限清理。重新上传同一文件将创建新的分析任务。确认删除？', '删除录音任务', { type: 'warning', confirmButtonText: '确认删除', cancelButtonText: '保留录音' })
+        if (!current() || !canDeleteTask(task)) return
+        confirmed = true
+        await followupAudioDelete({ id, version }, ticket.signal)
+        if (!current()) return
+        // Fence pending playback, autosaves and reads; deletion never revives a stale draft.
+        if (selectedId.value === id) {
+            stop(); resetRoles(); selectedId.value = 0; detail.value = null; reviewItems.value = []; snapshot.value = '[]'; detailSections.value = []
+        }
+        tasks.value = tasks.value.filter(row => row.id !== id)
+        errorMessage.value = ''
+        ElMessage.success('录音任务已删除，未修改病例。原资料按保留策略清理。')
+        await refresh()
+    } catch (error) {
+        if (confirmed && current()) errorMessage.value = followupError(error)
+    } finally {
+        if (current()) { mutation.value = ''; scheduleAutosave(); await refresh() }
+    }
+}
 async function retryTask() {
     if (!detail.value?.can_retry || detail.value.status !== 'failed' || !canUpload.value || busy.value) return
     const ticket = scope.capture()
@@ -577,6 +627,7 @@ h3 { margin: 0; font-size: 14px; font-weight: 600; }
 .detail-heading { align-items: flex-start; }
 .recording-title { min-width: 0; }
 .recording-title h3 { overflow-wrap: anywhere; line-height: 1.6; }
+.detail-actions { display: flex; align-items: center; gap: 12px; flex-wrap: wrap; }
 .detail-heading :deep(.el-tag) { flex-shrink: 0; }
 .detail-loading { padding: 32px; text-align: center; color: var(--el-text-color-secondary); }
 .processing-state, .applied-note { margin: 0; color: var(--el-text-color-secondary); font-size: 13px; }

admin/src/views/tcm/diagnosis/components/FollowupAudioReview.vue

@@ -32,8 +32,8 @@
                 </el-table-column>
             </el-table>
         </div>
-        <section v-if="group === 'pending' && uncertainties?.length" class="uncertainty-list" aria-label="原文待核实信息">
-            <strong>原文中还需补充的信息</strong>
+        <section v-if="(group === 'pending' || !items.length) && uncertainties?.length" class="uncertainty-list" aria-label="原文待核实信息">
+            <strong>本次未能确认的信息与原因</strong>
             <ul><li v-for="(value, index) in uncertainties" :key="index">{{ uncertaintyText(value) }}</li></ul>
         </section>
         <section ref="reviewWorkspace" class="review-workspace" tabindex="-1" aria-label="同页核对与回听">