Merge remote-tracking branch 'origin/main'

# Conflicts:
#	frontend/src/api/aireport/testReport/index.ts
#	frontend/src/api/aireport/testReport/interface/index.ts
#	frontend/src/views/aireport/testReport/components/ReportTaskFormDialog.vue
#	frontend/src/views/aireport/testReport/components/ReportTaskLedgerImportPanel.vue
#	frontend/src/views/aireport/testReport/contracts/check-test-report-page-contract.mjs
#	frontend/src/views/aireport/testReport/index.vue

frontend/build/getEnv.ts

@@ -30,7 +30,9 @@ export function wrapperEnv(envConf: Recordable): ViteEnv {
     if (envName === "VITE_PROXY") {
       try {
         realName = JSON.parse(realName);
-      } catch (error) {}
+      } catch (error) {
+        // Keep the original string when the proxy config is not valid JSON.
+      }
     }
     ret[envName] = realName;
   }

frontend/src/types/vite-plugin-eslint.d.ts

@@ -0,0 +1,7 @@
+declare module 'vite-plugin-eslint' {
+    import type { Plugin } from 'vite'
+
+    const eslintPlugin: (options?: Record<string, unknown>) => Plugin
+
+    export default eslintPlugin
+}

frontend/src/views/aireport/testReport/components/ReportTaskBaseInfoStep.vue

@@ -0,0 +1,221 @@
+<template>
+    <div class="form-panel">
+        <el-form ref="formRef" :model="formModel" :rules="formRules" label-width="108px" class="report-task-form">
+            <el-row :gutter="16">
+                <el-col :xs="24" :sm="12">
+                    <el-form-item label="报告编号" prop="no">
+                        <el-input v-model="localFormModel.no" maxlength="32" clearable placeholder="请输入报告编号" />
+                    </el-form-item>
+                </el-col>
+                <el-col :xs="24" :sm="12">
+                    <el-form-item label="委托单位" prop="clientUnitId">
+                        <el-select v-model="localFormModel.clientUnitId" filterable clearable placeholder="请选择委托单位">
+                            <el-option v-for="option in clientUnitSelectOptions" :key="option.value" :label="option.label" :value="option.value" />
+                        </el-select>
+                    </el-form-item>
+                </el-col>
+                <el-col :xs="24" :sm="12">
+                    <el-form-item label="报告模板" prop="reportModelId">
+                        <el-select v-model="localFormModel.reportModelId" filterable clearable placeholder="请选择报告模板">
+                            <el-option v-for="option in reportModelSelectOptions" :key="option.value" :label="option.label" :value="option.value" />
+                        </el-select>
+                    </el-form-item>
+                </el-col>
+                <el-col :xs="24" :sm="12">
+                    <el-form-item label="检测公司" prop="createUnit">
+                        <el-select v-model="localFormModel.createUnit" filterable clearable placeholder="请选择检测公司">
+                            <el-option v-for="option in companySelectOptions" :key="option.value" :label="option.label" :value="option.value" />
+                        </el-select>
+                    </el-form-item>
+                </el-col>
+                <el-col :xs="24" :sm="12">
+                    <el-form-item label="合同编号" prop="contractNumber">
+                        <el-input v-model="localFormModel.contractNumber" maxlength="32" clearable placeholder="请输入合同编号" />
+                    </el-form-item>
+                </el-col>
+                <el-col :xs="24" :sm="12">
+                    <el-form-item label="测试依据" prop="standardIds">
+                        <el-select v-model="localFormModel.standardIds" multiple filterable clearable collapse-tags placeholder="请选择测试依据">
+                            <el-option v-for="option in standardSelectOptions" :key="option.value" :label="option.label" :value="option.value" />
+                        </el-select>
+                    </el-form-item>
+                </el-col>
+                <el-col :xs="24" :sm="12">
+                    <el-form-item label="联系电话" prop="phonenumber">
+                        <el-input v-model="localFormModel.phonenumber" maxlength="32" clearable placeholder="请输入联系电话" />
+                    </el-form-item>
+                </el-col>
+            </el-row>
+        </el-form>
+
+        <div class="summary-strip">
+            <div class="summary-item">
+                <span class="summary-label">导入状态</span>
+                <el-tag :type="canSubmit ? 'success' : 'warning'">
+                    {{ canSubmit ? '已准备提交' : '待完成正式导入' }}
+                </el-tag>
+            </div>
+            <div class="summary-item">
+                <span class="summary-label">监测点数</span>
+                <span class="summary-value">{{ importSummary.pointCount }}</span>
+            </div>
+            <div class="summary-item">
+                <span class="summary-label">分组数</span>
+                <span class="summary-value">{{ importSummary.groupCount }}</span>
+            </div>
+            <div class="summary-item">
+                <span class="summary-label">汇总文件</span>
+                <span class="summary-value">{{ importSummary.summaryFileName }}</span>
+            </div>
+        </div>
+    </div>
+</template>
+
+<script setup lang="ts">
+import type { FormInstance, FormRules } from 'element-plus'
+import { computed, reactive, ref, watch } from 'vue'
+import type { ReportTask } from '@/api/aireport/testReport/interface'
+import { checkReportTaskLedgerPrepared } from '../utils/testReport'
+import type { ReportTaskFormModel } from '../utils/testReportForm'
+
+defineOptions({
+    name: 'ReportTaskBaseInfoStep'
+})
+
+const props = defineProps<{
+    formModel: ReportTaskFormModel
+    record: ReportTask.ReportTaskRecord | null
+    clientUnitOptions: Array<{ label: string; value: string }>
+    reportModelOptions: Array<{ label: string; value: string }>
+    companyOptions: Array<{ label: string; value: string }>
+    standardOptions: Array<{ label: string; value: string }>
+    preparedState: ReportTask.ReportTaskLedgerPreparedState
+}>()
+
+const emit = defineEmits<{
+    (event: 'register-form', value: FormInstance | undefined): void
+    (event: 'update:form-model', value: ReportTaskFormModel): void
+}>()
+
+const formRef = ref<FormInstance>()
+const localFormModel = reactive<ReportTaskFormModel>({ ...props.formModel })
+
+const formRules: FormRules = {
+    no: [{ required: true, message: '请输入报告编号', trigger: 'blur' }],
+    clientUnitId: [{ required: true, message: '请选择委托单位', trigger: 'change' }],
+    reportModelId: [{ required: true, message: '请选择报告模板', trigger: 'change' }],
+    createUnit: [{ required: true, message: '请选择检测公司', trigger: 'change' }],
+    contractNumber: [{ required: true, message: '请输入合同编号', trigger: 'blur' }],
+    standardIds: [{ required: true, message: '请选择测试依据', trigger: 'change' }]
+}
+
+const ensureCurrentOption = (
+    options: Array<{ label: string; value: string }>,
+    value: string,
+    fallbackLabel: string
+) => {
+    if (!value || options.some(option => option.value === value)) return options
+    return [...options, { label: fallbackLabel || value, value }]
+}
+
+const clientUnitSelectOptions = computed(() =>
+    ensureCurrentOption(props.clientUnitOptions, localFormModel.clientUnitId, props.record?.clientUnitName || '')
+)
+const reportModelSelectOptions = computed(() =>
+    ensureCurrentOption(props.reportModelOptions, localFormModel.reportModelId, props.record?.reportModelName || '')
+)
+const companySelectOptions = computed(() =>
+    ensureCurrentOption(props.companyOptions, localFormModel.createUnit, props.record?.createUnit || '')
+)
+const standardSelectOptions = computed(() => {
+    const optionMap = new Map(props.standardOptions.map(option => [option.value, option]))
+    const extraOptions = localFormModel.standardIds.filter(item => !optionMap.has(item)).map(item => ({ label: item, value: item }))
+    return [...props.standardOptions, ...extraOptions]
+})
+
+const canSubmit = computed(() => checkReportTaskLedgerPrepared(props.preparedState))
+const importSummary = computed(() => {
+    const importResult = props.preparedState.latestImportResult
+    const snapshot = props.preparedState.snapshot
+
+    return {
+        pointCount: String(importResult?.pointCount ?? snapshot?.rowCount ?? '-'),
+        groupCount: String(importResult?.groupCount ?? snapshot?.groupSummary?.length ?? '-'),
+        summaryFileName: importResult?.summaryFileName || snapshot?.summaryFileName || '-'
+    }
+})
+
+watch(
+    formRef,
+    value => {
+        emit('register-form', value)
+    },
+    { immediate: true }
+)
+
+watch(
+    () => props.formModel,
+    value => {
+        Object.assign(localFormModel, value)
+    },
+    { deep: true }
+)
+
+watch(
+    localFormModel,
+    value => {
+        emit('update:form-model', { ...value, standardIds: [...value.standardIds] })
+    },
+    { deep: true }
+)
+</script>
+
+<style scoped lang="scss">
+.form-panel {
+    border: 1px solid var(--el-border-color-light);
+    border-radius: 12px;
+    padding: 18px;
+    background: var(--el-fill-color-blank);
+}
+
+.summary-strip {
+    display: grid;
+    grid-template-columns: repeat(4, minmax(0, 1fr));
+    gap: 12px;
+    margin-top: 8px;
+}
+
+.summary-item {
+    padding: 12px 14px;
+    border-radius: 10px;
+    background: var(--el-fill-color-light);
+}
+
+.summary-label {
+    display: block;
+    margin-bottom: 6px;
+    font-size: 12px;
+    color: var(--el-text-color-secondary);
+}
+
+.summary-value {
+    font-size: 14px;
+    font-weight: 600;
+    color: var(--el-text-color-primary);
+}
+
+:deep(.report-task-form .el-form-item) {
+    margin-bottom: 18px;
+}
+
+:deep(.el-select),
+:deep(.el-input) {
+    width: 100%;
+}
+
+@media (max-width: 900px) {
+    .summary-strip {
+        grid-template-columns: 1fr;
+    }
+}
+</style>

frontend/src/views/aireport/testReport/components/ReportTaskCompleteStep.vue

@@ -0,0 +1,53 @@
+<template>
+    <div class="complete-panel">
+        <el-result
+            icon="success"
+            :title="mode === 'create' ? '报告任务新增完成' : '报告任务编辑完成'"
+            sub-title="文件导入与基础信息保存均已完成，本次结果已同步刷新到列表。"
+        />
+
+        <el-descriptions :column="2" border>
+            <el-descriptions-item label="报告编号">{{ formModel.no || '-' }}</el-descriptions-item>
+            <el-descriptions-item label="委托单位">{{ resolveCurrentOptionLabel(clientUnitOptions, formModel.clientUnitId) }}</el-descriptions-item>
+            <el-descriptions-item label="检测公司">{{ resolveCurrentOptionLabel(companyOptions, formModel.createUnit) }}</el-descriptions-item>
+            <el-descriptions-item label="监测点数">{{ importSummary.pointCount }}</el-descriptions-item>
+            <el-descriptions-item label="分组数">{{ importSummary.groupCount }}</el-descriptions-item>
+            <el-descriptions-item label="汇总文件">{{ importSummary.summaryFileName }}</el-descriptions-item>
+        </el-descriptions>
+    </div>
+</template>
+
+<script setup lang="ts">
+import type { ReportTask } from '@/api/aireport/testReport/interface'
+import type { ReportTaskFormModel } from '../utils/testReportForm'
+
+defineOptions({
+    name: 'ReportTaskCompleteStep'
+})
+
+const props = defineProps<{
+    mode: 'create' | 'edit'
+    formModel: ReportTaskFormModel
+    preparedState: ReportTask.ReportTaskLedgerPreparedState
+    clientUnitOptions: Array<{ label: string; value: string }>
+    companyOptions: Array<{ label: string; value: string }>
+}>()
+
+const resolveCurrentOptionLabel = (options: Array<{ label: string; value: string }>, value: string) =>
+    options.find(option => option.value === value)?.label || value || '-'
+
+const importSummary = {
+    pointCount: String(props.preparedState.latestImportResult?.pointCount ?? props.preparedState.snapshot?.rowCount ?? '-'),
+    groupCount: String(props.preparedState.latestImportResult?.groupCount ?? props.preparedState.snapshot?.groupSummary?.length ?? '-'),
+    summaryFileName: props.preparedState.latestImportResult?.summaryFileName || props.preparedState.snapshot?.summaryFileName || '-'
+}
+</script>
+
+<style scoped lang="scss">
+.complete-panel {
+    border: 1px solid var(--el-border-color-light);
+    border-radius: 12px;
+    padding: 18px;
+    background: var(--el-fill-color-blank);
+}
+</style>

frontend/src/views/aireport/testReport/components/ReportTaskImportStep.vue

@@ -0,0 +1,263 @@
+<template>
+    <div class="report-task-step">
+        <div class="panel-block">
+            <div class="section-header">
+                <div class="section-title">文件导入</div>
+                <div class="section-desc">基于上一阶段校验通过的批次执行正式导入。</div>
+            </div>
+
+            <el-alert
+                v-if="preparedState.pendingRevalidate"
+                title="文件已变更，当前不能继续导入，请先返回上一步重新校验。"
+                type="warning"
+                :closable="false"
+                show-icon
+                class="section-alert"
+            />
+
+            <el-descriptions :column="3" border>
+                <el-descriptions-item label="sessionId">{{ resolveReportTaskText(preparedState.validateSessionId) }}</el-descriptions-item>
+                <el-descriptions-item label="校验批次">{{ resolveReportTaskText(preparedState.validatedBatchId) }}</el-descriptions-item>
+                <el-descriptions-item label="汇总文件">
+                    {{ resolveReportTaskText(preparedState.validateResult?.summaryFileName || snapshot?.summaryFileName) }}
+                </el-descriptions-item>
+                <el-descriptions-item label="已上传文件数">
+                    {{ resolveReportTaskText(preparedState.validateResult?.uploadedFileCount) }}
+                </el-descriptions-item>
+                <el-descriptions-item label="监测点数">
+                    {{ resolveReportTaskText(preparedState.validateResult?.pointCount || snapshot?.rowCount) }}
+                </el-descriptions-item>
+                <el-descriptions-item label="可继续补传">
+                    <el-tag :type="preparedState.validateResult?.canContinueUpload ? 'warning' : 'info'">
+                        {{ preparedState.validateResult?.canContinueUpload ? '是' : '否' }}
+                    </el-tag>
+                </el-descriptions-item>
+            </el-descriptions>
+
+            <div class="action-bar">
+                <el-button type="primary" :icon="UploadFilled" :loading="importing" :disabled="disabled || !canImport" @click="handleImport">
+                    执行导入
+                </el-button>
+            </div>
+        </div>
+
+        <div v-if="latestImportResult" class="panel-block">
+            <div class="section-header">
+                <div class="section-title">导入结果</div>
+                <div class="section-desc">只有正式导入成功后才允许进入基础信息维护。</div>
+            </div>
+
+            <el-descriptions :column="3" border>
+                <el-descriptions-item label="当前阶段">{{ resolveReportTaskText(latestImportResult.currentStage) }}</el-descriptions-item>
+                <el-descriptions-item label="导入状态">
+                    <el-tag :type="latestImportResult.success ? 'success' : 'warning'">
+                        {{ latestImportResult.success ? '成功' : '未完成' }}
+                    </el-tag>
+                </el-descriptions-item>
+                <el-descriptions-item label="导入批次">{{ resolveReportTaskText(latestImportResult.batchId) }}</el-descriptions-item>
+                <el-descriptions-item label="汇总文件">{{ resolveReportTaskText(latestImportResult.summaryFileName) }}</el-descriptions-item>
+                <el-descriptions-item label="总文件数">{{ resolveReportTaskText(latestImportResult.totalFileCount) }}</el-descriptions-item>
+                <el-descriptions-item label="已上传文件数">{{ resolveReportTaskText(latestImportResult.uploadedFileCount) }}</el-descriptions-item>
+                <el-descriptions-item label="监测点数">{{ resolveReportTaskText(latestImportResult.pointCount) }}</el-descriptions-item>
+                <el-descriptions-item label="分组数">{{ resolveReportTaskText(latestImportResult.groupCount) }}</el-descriptions-item>
+                <el-descriptions-item label="临时目录">{{ resolveReportTaskText(latestImportResult.tempStoragePath) }}</el-descriptions-item>
+                <el-descriptions-item label="Excel 附件数">{{ resolveReportTaskText(latestImportResult.excelAttachmentCount) }}</el-descriptions-item>
+                <el-descriptions-item label="Word 附件数">{{ resolveReportTaskText(latestImportResult.wordAttachmentCount) }}</el-descriptions-item>
+                <el-descriptions-item label="设备新增 / 复用">
+                    {{ `${latestImportResult.deviceAddedCount || 0} / ${latestImportResult.deviceReuseCount || 0}` }}
+                </el-descriptions-item>
+                <el-descriptions-item label="委托单位新增 / 复用" :span="2">
+                    {{ `${latestImportResult.clientAddedCount || 0} / ${latestImportResult.clientReuseCount || 0}` }}
+                </el-descriptions-item>
+            </el-descriptions>
+
+            <el-alert
+                v-if="latestImportResult.failReasons?.length"
+                :title="`存在 ${latestImportResult.failReasons.length} 条导入提示`"
+                type="warning"
+                :closable="false"
+                show-icon
+                class="section-alert"
+            >
+                <template #default>
+                    <div v-for="reason in latestImportResult.failReasons" :key="reason" class="fail-reason">{{ reason }}</div>
+                </template>
+            </el-alert>
+
+            <el-table v-if="orderedStages.length" :data="orderedStages" border size="small" max-height="240" class="stage-table">
+                <el-table-column prop="stage" label="阶段" width="150" />
+                <el-table-column label="结果" width="120">
+                    <template #default="{ row }">
+                        <el-tag :type="row.success ? 'success' : 'warning'">{{ row.success ? '成功' : '未通过' }}</el-tag>
+                    </template>
+                </el-table-column>
+                <el-table-column prop="message" label="说明" min-width="280" show-overflow-tooltip />
+            </el-table>
+        </div>
+
+        <div v-if="snapshot" class="panel-block">
+            <div class="section-header">
+                <div class="section-title">已保存快照</div>
+                <div class="section-desc">编辑场景可参考当前任务最近一次已保存的导入摘要。</div>
+            </div>
+
+            <el-descriptions :column="2" border>
+                <el-descriptions-item label="汇总文件">{{ resolveReportTaskText(snapshot.summaryFileName) }}</el-descriptions-item>
+                <el-descriptions-item label="导入模式">{{ resolveReportTaskText(snapshot.importMode) }}</el-descriptions-item>
+                <el-descriptions-item label="监测点 Sheet">{{ resolveReportTaskText(snapshot.sheetSummary?.pointSheet) }}</el-descriptions-item>
+                <el-descriptions-item label="监测点行数">{{ resolveReportTaskText(snapshot.rowCount) }}</el-descriptions-item>
+            </el-descriptions>
+        </div>
+    </div>
+</template>
+
+<script setup lang="ts">
+import { UploadFilled } from '@element-plus/icons-vue'
+import { ElMessage } from 'element-plus'
+import { computed, ref } from 'vue'
+import { importReportTaskLedgerApi } from '@/api/aireport/testReport'
+import type { ReportTask } from '@/api/aireport/testReport/interface'
+import { hasValidatedLedgerBatch } from '../utils/reportTaskFlow'
+import {
+    TEST_REPORT_LEDGER_IMPORT_STAGE_ORDER,
+    checkReportTaskLedgerPrepared,
+    getReportTaskErrorMessage,
+    normalizeReportTaskLedgerImportResult,
+    resolveReportTaskText
+} from '../utils/testReport'
+
+defineOptions({
+    name: 'ReportTaskImportStep'
+})
+
+type ReportTaskLogType = 'info' | 'success' | 'warning' | 'error'
+
+const props = defineProps<{
+    disabled?: boolean
+    preparedState: ReportTask.ReportTaskLedgerPreparedState
+    snapshot: ReportTask.ReportTaskLedgerImportSnapshot | null
+}>()
+
+const emit = defineEmits<{
+    (event: 'change', value: ReportTask.ReportTaskLedgerPreparedState): void
+    (event: 'log', payload: { type: ReportTaskLogType; message: string }): void
+}>()
+
+const importing = ref(false)
+const latestImportResult = computed(() => props.preparedState.latestImportResult)
+const canImport = computed(() => hasValidatedLedgerBatch(props.preparedState))
+const orderedStages = computed(() => {
+    const stageMap = new Map((latestImportResult.value?.stages || []).map(stage => [stage.stage, stage]))
+
+    return TEST_REPORT_LEDGER_IMPORT_STAGE_ORDER.map(stage => {
+        const currentStage = stageMap.get(stage)
+        return {
+            stage,
+            success: currentStage?.success ?? false,
+            message: currentStage?.message || ''
+        }
+    }).filter(stage =>
+        stage.stage === '文件导入' || stage.stage === '基础资料维护' || stage.stage === '完成' ? stage.message || stage.success : false
+    )
+})
+
+const pushLog = (type: ReportTaskLogType, message: string) => emit('log', { type, message })
+
+const updatePreparedState = (patch: Partial<ReportTask.ReportTaskLedgerPreparedState>) => {
+    emit('change', {
+        ...props.preparedState,
+        ...patch
+    })
+}
+
+const handleImport = async () => {
+    if (importing.value) return
+
+    if (!canImport.value) {
+        const message = '请先完成文件校验并拿到导入批次后再执行正式导入'
+        ElMessage.warning(message)
+        pushLog('warning', message)
+        return
+    }
+
+    importing.value = true
+    pushLog('info', `开始执行正式导入，校验批次：${props.preparedState.validatedBatchId}`)
+
+    try {
+        // 关键业务节点：创建和编辑都统一使用 ledger/validate -> ledger/import，只有正式导入成功后才允许继续执行 add/update。
+        const response = await importReportTaskLedgerApi(props.preparedState.draftId, {
+            batchId: props.preparedState.validatedBatchId
+        })
+        const normalizedResult = normalizeReportTaskLedgerImportResult(response)
+
+        updatePreparedState({
+            latestImportResult: normalizedResult,
+            hasImported: Boolean(normalizedResult.success),
+            pendingRevalidate: false
+        })
+
+        if (
+            !checkReportTaskLedgerPrepared({
+                ...props.preparedState,
+                latestImportResult: normalizedResult,
+                hasImported: Boolean(normalizedResult.success),
+                pendingRevalidate: false
+            })
+        ) {
+            const message = '正式导入未完成，请根据导入结果修正后重新处理'
+            ElMessage.warning(message)
+            pushLog('warning', message)
+            normalizedResult.failReasons?.forEach(reason => pushLog('warning', reason))
+            return
+        }
+
+        ElMessage.success('正式导入成功')
+        pushLog('success', '正式导入成功，可以进入基础信息维护步骤')
+    } catch (error) {
+        const message = getReportTaskErrorMessage(error, '正式导入失败')
+        ElMessage.error(message)
+        pushLog('error', message)
+    } finally {
+        importing.value = false
+    }
+}
+</script>
+
+<style scoped lang="scss">
+.report-task-step {
+    display: flex;
+    flex-direction: column;
+    gap: 16px;
+    min-height: 0;
+}
+
+.panel-block {
+    border: 1px solid var(--el-border-color-light);
+    border-radius: 12px;
+    padding: 16px;
+    background: var(--el-fill-color-blank);
+}
+
+.section-header {
+    margin-bottom: 14px;
+}
+
+.section-title {
+    font-size: 15px;
+    font-weight: 600;
+    color: var(--el-text-color-primary);
+}
+
+.section-desc {
+    margin-top: 4px;
+    font-size: 12px;
+    color: var(--el-text-color-secondary);
+}
+
+.section-alert,
+.stage-table,
+.fail-reason + .fail-reason,
+.action-bar {
+    margin-top: 12px;
+}
+</style>

frontend/src/views/aireport/testReport/components/ReportTaskPrepareStep.vue

@@ -0,0 +1,588 @@
+<template>
+    <div class="report-task-step">
+        <div class="panel-block">
+            <div class="section-header">
+                <div class="section-title">文件准备</div>
+                <div class="section-desc">先选择台账汇总与附件，再执行校验并根据会话结果决定是否继续补传。</div>
+            </div>
+
+            <el-alert
+                v-if="preparedState.pendingRevalidate"
+                title="文件已变更，之前的校验与导入结果已失效，请重新执行校验。"
+                type="warning"
+                :closable="false"
+                show-icon
+                class="section-alert"
+            />
+
+            <div class="toolbar">
+                <div class="toolbar-actions">
+                    <el-upload
+                        :auto-upload="false"
+                        :show-file-list="false"
+                        multiple
+                        accept=".xls,.xlsx,.doc,.docx"
+                        :disabled="disabled || validating"
+                        @change="handleFileChange"
+                        @remove="handleFileRemove"
+                    >
+                        <template #trigger>
+                            <el-button type="primary" plain :icon="FolderOpened" :disabled="disabled || validating">选择文件</el-button>
+                        </template>
+                    </el-upload>
+
+                    <el-button type="primary" :icon="Select" :loading="validating" :disabled="disabled" @click="handleValidateFiles">
+                        执行校验
+                    </el-button>
+                </div>
+
+                <div v-if="selectedFiles.length" class="file-summary-grid">
+                    <div class="file-summary-card">
+                        <span class="file-summary-label">汇总台账</span>
+                        <span class="file-summary-value">{{ summaryLedgerFileName || '未选择' }}</span>
+                    </div>
+                    <div class="file-summary-card">
+                        <span class="file-summary-label">附件数量</span>
+                        <span class="file-summary-value">{{ otherAttachmentFiles.length }}</span>
+                    </div>
+                </div>
+
+                <el-button class="toolbar-download" type="primary" plain :icon="Download" :disabled="disabled || validating" @click="handleDownloadTemplate">
+                    下载模板
+                </el-button>
+            </div>
+
+            <el-alert
+                title="该步骤只负责 ledger/validate；只有校验通过且返回导入批次后，才允许进入正式导入。"
+                type="info"
+                :closable="false"
+                show-icon
+                class="section-alert"
+            />
+
+            <div v-if="selectedFiles.length" class="file-table-wrap">
+                <el-table :data="selectedFiles" border size="small" height="100%" class="file-table">
+                    <el-table-column type="index" label="序号" width="68" />
+                    <el-table-column prop="name" label="文件名称" min-width="280" show-overflow-tooltip />
+                    <el-table-column label="文件大小" width="140">
+                        <template #default="{ row }">{{ formatFileSize(row.size) }}</template>
+                    </el-table-column>
+                    <el-table-column label="文件类型" width="120">
+                        <template #default="{ row }">{{ resolveFileTypeText(row.name) }}</template>
+                    </el-table-column>
+                    <el-table-column label="操作" width="100" fixed="right">
+                        <template #default="{ $index }">
+                            <el-button link type="danger" :disabled="disabled || validating" @click="removeSelectedFile($index)">删除</el-button>
+                        </template>
+                    </el-table-column>
+                </el-table>
+            </div>
+
+            <el-empty v-else description="尚未选择待校验文件" :image-size="88" />
+        </div>
+
+        <div v-if="validateResult" class="panel-block">
+            <div class="section-header">
+                <div class="section-title">校验结果</div>
+                <div class="section-desc">按会话、监测点、附件三层展示本次校验结果。</div>
+            </div>
+
+            <el-descriptions :column="3" border>
+                <el-descriptions-item label="sessionId">{{ resolveReportTaskText(validateResult.sessionId) }}</el-descriptions-item>
+                <el-descriptions-item label="导入批次">{{ resolveReportTaskText(validateResult.batchId) }}</el-descriptions-item>
+                <el-descriptions-item label="校验状态">
+                    <el-tag :type="validateResult.success ? 'success' : 'warning'">
+                        {{ validateResult.success ? '通过' : '未通过' }}
+                    </el-tag>
+                </el-descriptions-item>
+                <el-descriptions-item label="汇总文件">{{ resolveReportTaskText(validateResult.summaryFileName) }}</el-descriptions-item>
+                <el-descriptions-item label="已上传文件数">{{ resolveReportTaskText(validateResult.uploadedFileCount) }}</el-descriptions-item>
+                <el-descriptions-item label="监测点数">{{ resolveReportTaskText(validateResult.pointCount) }}</el-descriptions-item>
+                <el-descriptions-item label="缺失附件数">{{ resolveReportTaskText(validateResult.missingAttachmentCount) }}</el-descriptions-item>
+                <el-descriptions-item label="可继续补传">
+                    <el-tag :type="validateResult.canContinueUpload ? 'warning' : 'info'">
+                        {{ validateResult.canContinueUpload ? '是' : '否' }}
+                    </el-tag>
+                </el-descriptions-item>
+                <el-descriptions-item label="临时目录">{{ resolveReportTaskText(validateResult.tempStoragePath) }}</el-descriptions-item>
+            </el-descriptions>
+
+            <div v-if="validateResult.failReasons?.length || validateResult.missingSheets?.length || validateResult.orphanAttachmentNames?.length" class="warning-grid">
+                <el-alert
+                    v-if="validateResult.failReasons?.length"
+                    :title="`存在 ${validateResult.failReasons.length} 条校验提示`"
+                    type="warning"
+                    :closable="false"
+                    show-icon
+                >
+                    <template #default>
+                        <div v-for="reason in validateResult.failReasons" :key="reason" class="fail-reason">{{ reason }}</div>
+                    </template>
+                </el-alert>
+
+                <el-alert
+                    v-if="validateResult.missingSheets?.length"
+                    :title="`缺少 ${validateResult.missingSheets.length} 个必需 sheet`"
+                    type="warning"
+                    :closable="false"
+                    show-icon
+                >
+                    <template #default>
+                        <div class="tag-list">
+                            <el-tag v-for="sheet in validateResult.missingSheets" :key="sheet" type="danger" effect="plain">{{ sheet }}</el-tag>
+                        </div>
+                    </template>
+                </el-alert>
+
+                <el-alert
+                    v-if="validateResult.orphanAttachmentNames?.length"
+                    :title="`存在 ${validateResult.orphanAttachmentNames.length} 个孤儿附件`"
+                    type="warning"
+                    :closable="false"
+                    show-icon
+                >
+                    <template #default>
+                        <div class="tag-list">
+                            <el-tag v-for="fileName in validateResult.orphanAttachmentNames" :key="fileName" type="warning" effect="plain">
+                                {{ fileName }}
+                            </el-tag>
+                        </div>
+                    </template>
+                </el-alert>
+            </div>
+
+            <div class="sheet-summary-grid">
+                <div class="sheet-summary-card">
+                    <span class="sheet-summary-label">requiredSheets</span>
+                    <div class="tag-list">
+                        <el-tag v-for="sheet in validateResult.requiredSheets" :key="sheet" effect="plain">{{ sheet }}</el-tag>
+                    </div>
+                </div>
+                <div class="sheet-summary-card">
+                    <span class="sheet-summary-label">existingSheets</span>
+                    <div class="tag-list">
+                        <el-tag v-for="sheet in validateResult.existingSheets" :key="sheet" type="success" effect="plain">{{ sheet }}</el-tag>
+                    </div>
+                </div>
+            </div>
+
+            <el-table v-if="validatePoints.length" :data="validatePoints" border size="small" max-height="320" class="stage-table">
+                <el-table-column type="expand" width="48">
+                    <template #default="{ row }">
+                        <div class="attachment-panel">
+                            <div class="attachment-header">attachments</div>
+                            <el-table :data="row.attachments || []" border size="small">
+                                <el-table-column prop="attachmentName" label="附件名" min-width="220" show-overflow-tooltip />
+                                <el-table-column prop="attachmentType" label="类型" width="100" />
+                                <el-table-column label="上传" width="80">
+                                    <template #default="{ row: attachment }">
+                                        <el-tag :type="attachment.uploaded ? 'success' : 'info'">{{ attachment.uploaded ? '是' : '否' }}</el-tag>
+                                    </template>
+                                </el-table-column>
+                                <el-table-column label="缺失" width="80">
+                                    <template #default="{ row: attachment }">
+                                        <el-tag :type="attachment.missing ? 'danger' : 'success'">{{ attachment.missing ? '是' : '否' }}</el-tag>
+                                    </template>
+                                </el-table-column>
+                                <el-table-column label="允许补传" width="100">
+                                    <template #default="{ row: attachment }">
+                                        <el-tag :type="attachment.reuploadAllowed ? 'warning' : 'info'">
+                                            {{ attachment.reuploadAllowed ? '是' : '否' }}
+                                        </el-tag>
+                                    </template>
+                                </el-table-column>
+                                <el-table-column prop="message" label="说明" min-width="220" show-overflow-tooltip />
+                            </el-table>
+                        </div>
+                    </template>
+                </el-table-column>
+                <el-table-column prop="rowNo" label="行号" width="80" />
+                <el-table-column prop="pointKey" label="点位标识" min-width="180" show-overflow-tooltip />
+                <el-table-column prop="substationName" label="站点" min-width="140" show-overflow-tooltip />
+                <el-table-column prop="pointName" label="点位" min-width="140" show-overflow-tooltip />
+                <el-table-column label="完整" width="90">
+                    <template #default="{ row }">
+                        <el-tag :type="row.complete ? 'success' : 'warning'">{{ row.complete ? '是' : '否' }}</el-tag>
+                    </template>
+                </el-table-column>
+                <el-table-column prop="missingAttachmentCount" label="缺失附件" width="100" />
+                <el-table-column label="设备匹配" width="110">
+                    <template #default="{ row }">
+                        <el-tag :type="row.testDeviceNoValid ? 'success' : 'danger'">{{ row.testDeviceNoValid ? '通过' : '未通过' }}</el-tag>
+                    </template>
+                </el-table-column>
+                <el-table-column prop="testDeviceNoMessage" label="设备说明" min-width="180" show-overflow-tooltip />
+                <el-table-column label="委托单位匹配" width="120">
+                    <template #default="{ row }">
+                        <el-tag :type="row.clientUnitNameValid ? 'success' : 'danger'">{{ row.clientUnitNameValid ? '通过' : '未通过' }}</el-tag>
+                    </template>
+                </el-table-column>
+                <el-table-column prop="clientUnitNameMessage" label="委托单位说明" min-width="180" show-overflow-tooltip />
+            </el-table>
+        </div>
+    </div>
+</template>
+
+<script setup lang="ts">
+import { Download, FolderOpened, Select } from '@element-plus/icons-vue'
+import { ElMessage, type UploadFile, type UploadFiles } from 'element-plus'
+import { computed, ref } from 'vue'
+import { downloadReportTaskLedgerTemplateApi, validateReportTaskLedgerApi } from '@/api/aireport/testReport'
+import type { ReportTask } from '@/api/aireport/testReport/interface'
+import { useDownloadWithServerFileName } from '@/hooks/useDownload'
+import {
+    getReportTaskErrorMessage,
+    isReportTaskLedgerAttachmentFileName,
+    isReportTaskLedgerSummaryFileName,
+    normalizeReportTaskLedgerValidateResult,
+    resolveReportTaskText
+} from '../utils/testReport'
+
+defineOptions({
+    name: 'ReportTaskPrepareStep'
+})
+
+type ReportTaskLogType = 'info' | 'success' | 'warning' | 'error'
+
+const props = defineProps<{
+    draftId: string
+    disabled?: boolean
+    preparedState: ReportTask.ReportTaskLedgerPreparedState
+}>()
+
+const emit = defineEmits<{
+    (event: 'change', value: ReportTask.ReportTaskLedgerPreparedState): void
+    (event: 'log', payload: { type: ReportTaskLogType; message: string }): void
+}>()
+
+const validating = ref(false)
+const selectedFiles = ref<UploadFile[]>([])
+const validateResult = computed(() => props.preparedState.validateResult)
+const validatePoints = computed(() => validateResult.value?.points || [])
+const summaryLedgerFileName = computed(() => {
+    const summaryFile = selectedFiles.value.find(file => isReportTaskLedgerSummaryFileName(file.name))
+    return summaryFile?.name || ''
+})
+const otherAttachmentFiles = computed(() => selectedFiles.value.filter(file => !isReportTaskLedgerSummaryFileName(file.name)))
+
+const pushLog = (type: ReportTaskLogType, message: string) => emit('log', { type, message })
+
+const updatePreparedState = (patch: Partial<ReportTask.ReportTaskLedgerPreparedState>) => {
+    emit('change', {
+        ...props.preparedState,
+        ...patch
+    })
+}
+
+const markResultsDirty = () => {
+    updatePreparedState({
+        validateSessionId: '',
+        validateResult: null,
+        latestImportResult: null,
+        hasImported: false,
+        validatedBatchId: '',
+        pendingRevalidate: true
+    })
+}
+
+const formatFileSize = (size?: number) => {
+    if (!size) return '0 B'
+    if (size < 1024) return `${size} B`
+    if (size < 1024 * 1024) return `${(size / 1024).toFixed(1)} KB`
+    return `${(size / (1024 * 1024)).toFixed(1)} MB`
+}
+
+const resolveFileTypeText = (fileName: string) => {
+    const normalizedName = String(fileName || '').trim().toLowerCase()
+    if (isReportTaskLedgerSummaryFileName(normalizedName)) return '汇总台账'
+    if (normalizedName.endsWith('.doc') || normalizedName.endsWith('.docx')) return 'Word 附件'
+    if (normalizedName.endsWith('.xls') || normalizedName.endsWith('.xlsx')) return 'Excel 附件'
+    return '未知'
+}
+
+const handleFileChange = (_file: UploadFile, files: UploadFiles) => {
+    selectedFiles.value = [...files]
+    pushLog('info', `已选择 ${selectedFiles.value.length} 个待校验文件`)
+
+    if (props.preparedState.validateResult || props.preparedState.latestImportResult || props.preparedState.hasImported) {
+        markResultsDirty()
+        pushLog('warning', '导入文件已变更，需要重新执行文件校验和正式导入')
+    }
+}
+
+const handleFileRemove = (_file: UploadFile, files: UploadFiles) => {
+    selectedFiles.value = [...files]
+    pushLog('info', `已更新待校验文件列表，当前剩余 ${selectedFiles.value.length} 个文件`)
+
+    if (props.preparedState.validateResult || props.preparedState.latestImportResult || props.preparedState.hasImported) {
+        markResultsDirty()
+        pushLog('warning', '导入文件已变更，需要重新执行文件校验和正式导入')
+    }
+}
+
+const removeSelectedFile = (index: number) => {
+    selectedFiles.value.splice(index, 1)
+    pushLog('info', `已删除第 ${index + 1} 个待校验文件`)
+
+    if (props.preparedState.validateResult || props.preparedState.latestImportResult || props.preparedState.hasImported) {
+        markResultsDirty()
+        pushLog('warning', '导入文件已变更，需要重新执行文件校验和正式导入')
+    }
+}
+
+const handleDownloadTemplate = async () => {
+    try {
+        await useDownloadWithServerFileName(downloadReportTaskLedgerTemplateApi, '台账信息汇总', undefined, false, '.xlsx')
+        pushLog('success', '台账导入模板下载成功')
+    } catch (error) {
+        const message = getReportTaskErrorMessage(error, '台账模板下载失败')
+        ElMessage.error(message)
+        pushLog('error', message)
+    }
+}
+
+const handleValidateFiles = async () => {
+    if (validating.value) return
+
+    if (!props.draftId) {
+        const message = '报告任务 ID 缺失，无法执行文件校验'
+        ElMessage.error(message)
+        pushLog('error', message)
+        return
+    }
+
+    if (!selectedFiles.value.length) {
+        const message = '请先选择待校验的台账汇总与附件文件'
+        ElMessage.warning(message)
+        pushLog('warning', message)
+        return
+    }
+
+    const invalidFile = selectedFiles.value.find(file => !isReportTaskLedgerAttachmentFileName(file.name))
+    if (invalidFile) {
+        const message = '仅支持导入 .xls、.xlsx、.doc、.docx 文件'
+        ElMessage.warning(message)
+        pushLog('warning', `${message}，异常文件：${invalidFile.name}`)
+        return
+    }
+
+    const formData = new FormData()
+    selectedFiles.value.forEach(file => {
+        if (file.raw) {
+            formData.append('files', file.raw)
+        }
+    })
+
+    if (!formData.getAll('files').length) {
+        const message = '未检测到可上传的文件内容'
+        ElMessage.warning(message)
+        pushLog('warning', message)
+        return
+    }
+
+    validating.value = true
+    const validateId = props.preparedState.validateSessionId || props.draftId
+    pushLog('info', `开始执行文件校验，本次共上传 ${selectedFiles.value.length} 个文件，会话标识：${validateId}`)
+
+    try {
+        // 关键业务节点：首次校验使用当前草稿 ID，后续补传必须复用后端返回的 sessionId。
+        const response = await validateReportTaskLedgerApi(validateId, formData)
+        const normalizedResult = normalizeReportTaskLedgerValidateResult(response)
+        const nextSessionId = String(normalizedResult.sessionId || validateId)
+        const nextBatchId = normalizedResult.success && normalizedResult.batchId ? String(normalizedResult.batchId) : ''
+
+        updatePreparedState({
+            validateSessionId: nextSessionId,
+            validateResult: normalizedResult,
+            latestImportResult: null,
+            hasImported: false,
+            validatedBatchId: nextBatchId,
+            pendingRevalidate: false
+        })
+
+        if (!normalizedResult.success || !nextBatchId) {
+            const message = normalizedResult.canContinueUpload
+                ? '文件校验未通过，请按结果补传后继续使用当前 sessionId 重试'
+                : '文件校验未通过，请根据校验结果修正后重新校验'
+            ElMessage.warning(message)
+            pushLog('warning', message)
+            normalizedResult.failReasons?.forEach(reason => pushLog('warning', reason))
+            return
+        }
+
+        ElMessage.success('文件校验通过')
+        pushLog('success', `文件校验通过，可进入正式导入步骤，batchId：${nextBatchId}`)
+    } catch (error) {
+        const message = getReportTaskErrorMessage(error, '文件校验失败')
+        ElMessage.error(message)
+        pushLog('error', message)
+    } finally {
+        validating.value = false
+    }
+}
+</script>
+
+<style scoped lang="scss">
+.report-task-step {
+    display: flex;
+    flex-direction: column;
+    flex: 1;
+    gap: 16px;
+    height: 100%;
+    min-height: 0;
+}
+
+.panel-block {
+    border: 1px solid var(--el-border-color-light);
+    border-radius: 12px;
+    padding: 16px;
+    background: var(--el-fill-color-blank);
+}
+
+.panel-block:first-child {
+    flex: 1;
+    display: flex;
+    flex-direction: column;
+    min-height: 0;
+}
+
+.section-header {
+    margin-bottom: 14px;
+}
+
+.section-title {
+    font-size: 15px;
+    font-weight: 600;
+    color: var(--el-text-color-primary);
+}
+
+.section-desc {
+    margin-top: 4px;
+    font-size: 12px;
+    color: var(--el-text-color-secondary);
+}
+
+.section-alert,
+.file-table,
+.stage-table,
+.fail-reason + .fail-reason,
+.warning-grid,
+.sheet-summary-grid {
+    margin-top: 12px;
+}
+
+.file-table-wrap {
+    flex: 1;
+    min-height: 0;
+    margin-top: 12px;
+}
+
+.file-table {
+    height: 100%;
+    margin-top: 0;
+}
+
+.toolbar {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+    flex-wrap: wrap;
+}
+
+.toolbar-actions {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+    flex-wrap: wrap;
+}
+
+.toolbar-download {
+    margin-left: auto;
+}
+
+.file-summary-grid {
+    display: flex;
+    align-items: center;
+    justify-content: flex-end;
+    gap: 12px;
+    flex: 1;
+    min-width: 0;
+    overflow: hidden;
+}
+
+.file-summary-grid > * {
+    flex-shrink: 0;
+}
+
+.file-summary-card,
+.sheet-summary-card {
+    display: inline-flex;
+    align-items: center;
+    gap: 12px;
+    max-width: 260px;
+    min-height: 32px;
+    padding: 0 12px;
+    border: 1px solid var(--el-border-color-light);
+    border-radius: 10px;
+    background: var(--el-fill-color-light);
+    overflow: hidden;
+}
+
+.file-summary-label,
+.sheet-summary-label {
+    font-size: 12px;
+    color: var(--el-text-color-secondary);
+    flex-shrink: 0;
+}
+
+.file-summary-value {
+    font-size: 14px;
+    font-weight: 600;
+    color: var(--el-text-color-primary);
+    overflow: hidden;
+    white-space: nowrap;
+    text-overflow: ellipsis;
+}
+
+.warning-grid {
+    display: grid;
+    gap: 12px;
+}
+
+.sheet-summary-grid {
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    gap: 12px;
+}
+
+.sheet-summary-card {
+    display: flex;
+    align-items: flex-start;
+    gap: 8px;
+    max-width: none;
+    min-height: 72px;
+    padding: 12px;
+}
+
+.tag-list {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 8px;
+}
+
+.attachment-panel {
+    padding: 8px 16px 16px;
+    background: var(--el-fill-color-lighter);
+}
+
+.attachment-header {
+    margin-bottom: 8px;
+    font-size: 12px;
+    font-weight: 600;
+    color: var(--el-text-color-secondary);
+}
+
+:deep(.el-empty) {
+    flex: 1;
+}
+</style>

frontend/src/views/aireport/testReport/contracts/check-ledger-summary-file-contract.mjs

@@ -0,0 +1,40 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import assert from 'node:assert/strict'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const pageDir = path.resolve(__dirname, '..')
+const utilsFile = path.join(pageDir, 'utils/testReport.ts')
+const panelFile = path.join(pageDir, 'components/ReportTaskPrepareStep.vue')
+
+const read = file => fs.readFileSync(file, 'utf8')
+
+const utilsSource = read(utilsFile)
+const panelSource = read(panelFile)
+
+assert.match(
+    utilsSource,
+    /export const TEST_REPORT_LEDGER_SUMMARY_FILE_BASE_NAME = '台账信息汇总'/,
+    'utils/testReport.ts should define the ledger summary base file name constant'
+)
+
+assert.match(
+    utilsSource,
+    /export const isReportTaskLedgerSummaryFileName = \(fileName: string\) =>[\s\S]*includes\(TEST_REPORT_LEDGER_SUMMARY_FILE_BASE_NAME\.toLowerCase\(\)\)[\s\S]*isReportTaskExcelFileName\(normalizedName\)/,
+    'utils/testReport.ts should treat any Excel file containing 台账信息汇总 as the summary ledger file'
+)
+
+assert.match(
+    panelSource,
+    /isReportTaskLedgerSummaryFileName/,
+    'ReportTaskPrepareStep.vue should reuse the shared summary ledger matcher'
+)
+
+assert.doesNotMatch(
+    panelSource,
+    /const isSummaryLedgerFileName =/,
+    'ReportTaskPrepareStep.vue should not keep a local exact-match summary file matcher'
+)
+
+console.log('ledger summary file contract passed')

frontend/src/views/aireport/testReport/utils/reportTaskFlow.ts

@@ -0,0 +1,88 @@
+import type { ReportTask } from '@/api/aireport/testReport/interface'
+import { checkReportTaskLedgerPrepared } from './testReport'
+
+export type ReportTaskFlowStep = 'prepare' | 'import' | 'form' | 'done'
+
+export interface ReportTaskFlowStepOption {
+    index: number
+    value: ReportTaskFlowStep
+    title: string
+    description: string
+}
+
+export const REPORT_TASK_FLOW_STEPS: ReportTaskFlowStepOption[] = [
+    {
+        index: 1,
+        value: 'prepare',
+        title: '文件选择与校验',
+        description: '准备台账文件并完成校验'
+    },
+    {
+        index: 2,
+        value: 'import',
+        title: '文件导入',
+        description: '使用已校验批次执行正式导入'
+    },
+    {
+        index: 3,
+        value: 'form',
+        title: '基础信息维护',
+        description: '填写并确认任务基础信息'
+    },
+    {
+        index: 4,
+        value: 'done',
+        title: '完成',
+        description: '查看结果并结束本次流程'
+    }
+]
+
+export const createEmptyLedgerPreparedState = (): ReportTask.ReportTaskLedgerPreparedState => ({
+    draftId: '',
+    validateSessionId: '',
+    validateResult: null,
+    latestImportResult: null,
+    snapshot: null,
+    hasImported: false,
+    validatedBatchId: '',
+    pendingRevalidate: false
+})
+
+export const hasValidatedLedgerBatch = (state: ReportTask.ReportTaskLedgerPreparedState | null | undefined) =>
+    Boolean(state?.draftId && state?.validatedBatchId && state?.validateResult?.success && !state?.pendingRevalidate)
+
+export const resolveInitialFlowStep = (
+    mode: 'create' | 'edit',
+    state: ReportTask.ReportTaskLedgerPreparedState
+): ReportTaskFlowStep => {
+    if (mode === 'edit' && checkReportTaskLedgerPrepared(state)) {
+        return 'form'
+    }
+
+    return 'prepare'
+}
+
+export const canReachFlowStep = (
+    step: ReportTaskFlowStep,
+    state: ReportTask.ReportTaskLedgerPreparedState,
+    currentStep: ReportTaskFlowStep
+) => {
+    if (step === 'prepare') return true
+    if (step === 'import') {
+        return hasValidatedLedgerBatch(state) || state.hasImported || Boolean(state.snapshot) || currentStep === 'import' || currentStep === 'form' || currentStep === 'done'
+    }
+    if (step === 'form') return checkReportTaskLedgerPrepared(state) || currentStep === 'form' || currentStep === 'done'
+    return currentStep === 'done'
+}
+
+export const resolveFlowStepStatus = (
+    step: ReportTaskFlowStep,
+    currentStep: ReportTaskFlowStep,
+    state: ReportTask.ReportTaskLedgerPreparedState
+) => {
+    if (currentStep === step) return 'active'
+    if (step === 'prepare' && (hasValidatedLedgerBatch(state) || currentStep === 'form' || currentStep === 'done')) return 'done'
+    if (step === 'import' && (checkReportTaskLedgerPrepared(state) || currentStep === 'done')) return 'done'
+    if (step === 'form' && currentStep === 'done') return 'done'
+    return 'pending'
+}

frontend/src/views/aireport/testReport/utils/testReport.ts

@@ -1,15 +1,38 @@
+import type { TagProps } from 'element-plus'
 import type { Dict, ResultData, ResPage } from '@/api/interface'
 import type { ReportTask } from '@/api/aireport/testReport/interface'
 
+type TagType = TagProps['type']
+
 export const TEST_REPORT_EXCEL_EXTENSIONS = ['.xls', '.xlsx']
 export const TEST_REPORT_WORD_EXTENSIONS = ['.doc', '.docx']
+export const TEST_REPORT_LEDGER_SUMMARY_FILE_BASE_NAME = '台账信息汇总'
 export const TEST_REPORT_LEDGER_IMPORT_STAGE_ORDER: ReportTask.ReportTaskLedgerImportStage[] = [
     '选择文件',
     '校验文件',
-    '文件上传',
+    '文件导入',
     '基础资料维护',
     '完成'
 ]
+export const REPORT_TASK_STATE_MAP: Record<ReportTask.ReportTaskState, { text: string; tagType: TagType }> = {
+    '01': { text: '编制中', tagType: 'info' },
+    '02': { text: '审核中', tagType: 'warning' },
+    '03': { text: '已通过', tagType: 'success' },
+    '04': { text: '已退回', tagType: 'danger' },
+    '05': { text: '已删除', tagType: 'info' }
+}
+export const REPORT_TASK_STATE_OPTIONS: Array<{ label: string; value: ReportTask.ReportTaskState }> = [
+    { label: '编制中', value: '01' },
+    { label: '审核中', value: '02' },
+    { label: '已通过', value: '03' },
+    { label: '已退回', value: '04' },
+    { label: '已删除', value: '05' }
+]
+export const REPORT_TASK_GENERATE_STATE_MAP: Record<ReportTask.ReportTaskGenerateState, { text: string; tagType: TagType }> = {
+    0: { text: '未生成', tagType: 'info' },
+    1: { text: '生成中', tagType: 'warning' },
+    2: { text: '已生成', tagType: 'success' }
+}
 export const REPORT_TASK_GROUP_REPORT_GENERATE_STATUS_TEXT_MAP: Record<number, string> = {
     0: '未生成',
     1: '生成中',
@@ -43,6 +66,7 @@ export const normalizeReportTaskListParams = (
         keyword: String(params.keyword || '').trim() || undefined,
         searchBeginTime: searchBeginTime || params.searchBeginTime || undefined,
         searchEndTime: searchEndTime || params.searchEndTime || undefined,
+        state: params.state || undefined,
         pageNum: params.pageNum || 1,
         pageSize: params.pageSize || 10
     }
@@ -88,6 +112,11 @@ export const isReportTaskWordFileName = (fileName: string) => {
     return TEST_REPORT_WORD_EXTENSIONS.some(extension => normalizedName.endsWith(extension))
 }
 
+export const isReportTaskLedgerSummaryFileName = (fileName: string) => {
+    const normalizedName = String(fileName || '').trim().toLowerCase()
+    return normalizedName.includes(TEST_REPORT_LEDGER_SUMMARY_FILE_BASE_NAME.toLowerCase()) && isReportTaskExcelFileName(normalizedName)
+}
+
 export const isReportTaskLedgerAttachmentFileName = (fileName: string) =>
     isReportTaskExcelFileName(fileName) || isReportTaskWordFileName(fileName)
 
@@ -119,7 +148,9 @@ export const normalizeReportTaskLedgerImportResult = (
         currentStage: payload?.currentStage || undefined,
         success: payload?.success ?? false,
         summaryFileName: payload?.summaryFileName || undefined,
+        tempStoragePath: payload?.tempStoragePath || undefined,
         totalFileCount: payload?.totalFileCount ?? 0,
+        uploadedFileCount: payload?.uploadedFileCount ?? 0,
         pointCount: payload?.pointCount ?? 0,
         excelAttachmentCount: payload?.excelAttachmentCount ?? 0,
         wordAttachmentCount: payload?.wordAttachmentCount ?? 0,
@@ -137,6 +168,61 @@ export const normalizeReportTaskLedgerImportResult = (
     }
 }
 
+export const normalizeReportTaskLedgerValidateResult = (
+    response:
+        | ResultData<ReportTask.ReportTaskLedgerValidateResult>
+        | ReportTask.ReportTaskLedgerValidateResult
+        | null
+        | undefined
+): ReportTask.ReportTaskLedgerValidateResult => {
+    const payload = unwrapReportTaskPayload<ReportTask.ReportTaskLedgerValidateResult | null | undefined>(
+        response as ResultData<ReportTask.ReportTaskLedgerValidateResult>
+    )
+
+    return {
+        sessionId: payload?.sessionId || undefined,
+        batchId: payload?.batchId || undefined,
+        success: payload?.success ?? false,
+        summaryFileName: payload?.summaryFileName || undefined,
+        summaryFilePresent: payload?.summaryFilePresent ?? false,
+        tempStoragePath: payload?.tempStoragePath || undefined,
+        uploadedFileCount: payload?.uploadedFileCount ?? 0,
+        pointCount: payload?.pointCount ?? 0,
+        missingAttachmentCount: payload?.missingAttachmentCount ?? 0,
+        canContinueUpload: payload?.canContinueUpload ?? false,
+        requiredSheets: Array.isArray(payload?.requiredSheets) ? payload.requiredSheets.filter(Boolean) : [],
+        existingSheets: Array.isArray(payload?.existingSheets) ? payload.existingSheets.filter(Boolean) : [],
+        missingSheets: Array.isArray(payload?.missingSheets) ? payload.missingSheets.filter(Boolean) : [],
+        orphanAttachmentNames: Array.isArray(payload?.orphanAttachmentNames) ? payload.orphanAttachmentNames.filter(Boolean) : [],
+        failReasons: Array.isArray(payload?.failReasons) ? payload.failReasons.filter(Boolean) : [],
+        points: Array.isArray(payload?.points)
+            ? payload.points.map(point => ({
+                  rowNo: point?.rowNo ?? null,
+                  pointKey: point?.pointKey || undefined,
+                  substationName: point?.substationName || undefined,
+                  pointName: point?.pointName || undefined,
+                  complete: point?.complete ?? false,
+                  missingAttachmentCount: point?.missingAttachmentCount ?? 0,
+                  testDeviceNoValid: point?.testDeviceNoValid ?? false,
+                  testDeviceNoMessage: point?.testDeviceNoMessage || undefined,
+                  clientUnitNameValid: point?.clientUnitNameValid ?? false,
+                  clientUnitNameMessage: point?.clientUnitNameMessage || undefined,
+                  attachments: Array.isArray(point?.attachments)
+                      ? point.attachments.map(attachment => ({
+                            attachmentName: attachment?.attachmentName || undefined,
+                            attachmentType: attachment?.attachmentType || undefined,
+                            referenced: attachment?.referenced ?? false,
+                            uploaded: attachment?.uploaded ?? false,
+                            missing: attachment?.missing ?? false,
+                            reuploadAllowed: attachment?.reuploadAllowed ?? false,
+                            message: attachment?.message || undefined
+                        }))
+                      : []
+              }))
+            : []
+    }
+}
+
 export const normalizeReportTaskGroupReportList = (
     response:
         | ResultData<ReportTask.ReportTaskGroupReportRecord[]>
@@ -210,9 +296,21 @@ export const resolveReportTaskGroupReportGenerateStateTagType = (value: number |
     return REPORT_TASK_GROUP_REPORT_GENERATE_STATUS_TAG_TYPE_MAP[value]
 }
 
+export const getReportTaskStateText = (state?: string | null) =>
+    REPORT_TASK_STATE_MAP[state as ReportTask.ReportTaskState]?.text || '未知状态'
+
+export const getReportTaskStateTagType = (state?: string | null): TagType =>
+    REPORT_TASK_STATE_MAP[state as ReportTask.ReportTaskState]?.tagType || 'info'
+
+export const getReportTaskGenerateStateText = (state?: number | null) =>
+    REPORT_TASK_GENERATE_STATE_MAP[state as ReportTask.ReportTaskGenerateState]?.text || '未知状态'
+
+export const getReportTaskGenerateStateTagType = (state?: number | null): TagType =>
+    REPORT_TASK_GENERATE_STATE_MAP[state as ReportTask.ReportTaskGenerateState]?.tagType || 'info'
+
 export const checkReportTaskLedgerPrepared = (
     state: ReportTask.ReportTaskLedgerPreparedState | null | undefined
-) => Boolean(state?.draftId && state.hasImported && !state.pendingReimport)
+) => Boolean(state?.draftId && state.hasImported && !state.pendingRevalidate)
 
 export const buildDictSelectOptions = (dictData: Dict[] = []) =>
     dictData

frontend/src/views/aireport/testReport/utils/testReportForm.ts

@@ -0,0 +1,72 @@
+import type { ReportTask } from '@/api/aireport/testReport/interface'
+import { generateUUID } from '@/utils'
+import { normalizeReportTaskLedgerSnapshot, parseReportTaskStandardIds, stringifyReportTaskStandardIds } from './testReport'
+
+export interface ReportTaskFormModel {
+    id: string
+    no: string
+    clientUnitId: string
+    reportModelId: string
+    createUnit: string
+    contractNumber: string
+    standardIds: string[]
+    data: string
+    phonenumber: string
+}
+
+export const createDefaultReportTaskFormModel = (): ReportTaskFormModel => ({
+    id: '',
+    no: '',
+    clientUnitId: '',
+    reportModelId: '',
+    createUnit: '',
+    contractNumber: '',
+    standardIds: [],
+    data: '',
+    phonenumber: ''
+})
+
+export const buildReportTaskDraftId = (mode: 'create' | 'edit', record: ReportTask.ReportTaskRecord | null) => {
+    if (mode === 'edit') {
+        return String(record?.id || '').trim()
+    }
+
+    return window.crypto?.randomUUID?.() || generateUUID()
+}
+
+export const buildReportTaskFormContext = (mode: 'create' | 'edit', record: ReportTask.ReportTaskRecord | null) => {
+    const snapshot = normalizeReportTaskLedgerSnapshot(record?.data)
+    const formModel = createDefaultReportTaskFormModel()
+
+    formModel.id = record?.id || ''
+    formModel.no = record?.no || ''
+    formModel.clientUnitId = record?.clientUnitId || ''
+    formModel.reportModelId = record?.reportModelId || ''
+    formModel.createUnit = record?.createUnit || ''
+    formModel.contractNumber = record?.contractNumber || ''
+    formModel.standardIds = parseReportTaskStandardIds(record?.standard)
+    formModel.data = record?.data || ''
+    formModel.phonenumber = record?.phonenumber || ''
+
+    return {
+        formModel,
+        snapshot,
+        draftId: buildReportTaskDraftId(mode, record),
+        hasPreparedImport: Boolean(snapshot || Number(record?.pointCount) > 0)
+    }
+}
+
+export const buildReportTaskSavePayload = (
+    draftId: string,
+    formModel: ReportTaskFormModel
+): ReportTask.ReportTaskSaveRequest => ({
+    id: draftId || formModel.id || undefined,
+    no: formModel.no.trim(),
+    clientUnitId: formModel.clientUnitId,
+    reportModelId: formModel.reportModelId,
+    createUnit: formModel.createUnit,
+    contractNumber: formModel.contractNumber.trim(),
+    standard: stringifyReportTaskStandardIds(formModel.standardIds),
+    data: formModel.data.trim(),
+    phonenumber: formModel.phonenumber.trim() || undefined
+})

frontend/tsconfig.node.json

@@ -5,7 +5,10 @@
     "vitest.config.*",
     "cypress.config.*",
     "nightwatch.conf.*",
-    "playwright.config.*"
+    "playwright.config.*",
+    "build/**/*.ts",
+    "build/**/*.d.ts",
+    "src/types/**/*.d.ts"
   ],
   "compilerOptions": {
     "composite": true,

frontend/vite.config.ts

@@ -1,4 +1,5 @@
-import { ConfigEnv, defineConfig, loadEnv, UserConfig } from 'vite'
+import { defineConfig, loadEnv } from 'vite'
+import type { ConfigEnv, UserConfig } from 'vite'
 import { createSvgIconsPlugin } from 'vite-plugin-svg-icons'
 import vue from '@vitejs/plugin-vue'
 import path from 'path'
@@ -61,10 +62,7 @@ export default defineConfig(({ mode }: ConfigEnv): UserConfig => {
                 // dts: "src/types/components.d.ts",
             }),
             nodePolyfills({
-                include: ['crypto'],
-                globals: {
-                    crypto: true
-                }
+                include: ['crypto']
             })
         ],
         // 基础配置