feat(testReport): 新增台账导入功能并重构报告任务表单

- 新增台账导入面板组件，支持Excel模板下载和批量导入
- 在报告任务表单中集成三步式流程（导入→填写→完成）
- 添加导入结果预览和分组报告状态展示功能
- 扩展API接口支持台账导入和分组报告查询
- 优化表单验证逻辑，移除送资数据必填限制
- 集成日志面板实时显示导入过程状态
- 更新测试报告页面契约验证规则
- 添加监测点数和分组数统计展示
- 实现台账准备状态检查和快照功能

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/api/aireport/testReport/index.ts

@@ -8,7 +8,7 @@ export const listReportTasksApi = (params: ReportTask.ReportTaskListParams) => {
     return http.post(`${REPORT_TASK_BASE_URL}/list`, params)
 }
 
-export const createReportTaskApi = (params: ReportTask.ReportTaskSaveRequest) => {
+export const createReportTaskApi = (params: ReportTask.ReportTaskAddParam) => {
     return http.post<boolean>(`${REPORT_TASK_BASE_URL}/add`, params)
 }
 
@@ -30,3 +30,22 @@ export const exportReportTasksApi = (params: ReportTask.ReportTaskListParams): P
 export const submitReportTaskAuditApi = (params: ReportTask.ReportTaskAuditRequest) => {
     return http.post<boolean>(`${REPORT_TASK_BASE_URL}/submit-audit`, params)
 }
+
+export const downloadReportTaskLedgerTemplateApi = (): Promise<AxiosResponse<Blob>> =>
+    http.get(`${REPORT_TASK_BASE_URL}/ledger/template`, undefined, {
+        responseType: 'blob'
+    }) as unknown as Promise<AxiosResponse<Blob>>
+
+export const validateReportTaskLedgerApi = (id: string, formData: FormData) => {
+    return http.post<ReportTask.ReportTaskLedgerValidateResult>(`${REPORT_TASK_BASE_URL}/${id}/ledger/validate`, formData, {
+        headers: { 'Content-Type': 'multipart/form-data' }
+    })
+}
+
+export const importReportTaskLedgerApi = (id: string, params: ReportTask.ReportTaskLedgerImportRequest) => {
+    return http.post<ReportTask.ReportTaskLedgerImportResult>(`${REPORT_TASK_BASE_URL}/${id}/ledger/import`, params)
+}
+
+export const listReportTaskGroupReportsApi = (id: string) => {
+    return http.get<ReportTask.ReportTaskGroupReportRecord[]>(`${REPORT_TASK_BASE_URL}/${id}/group-report/list`)
+}

frontend/src/api/aireport/testReport/interface/index.ts

@@ -1,4 +1,14 @@
 export namespace ReportTask {
+    export type ReportTaskState = '01' | '02' | '03' | '04' | '05'
+    export type ReportTaskGenerateState = 0 | 1 | 2
+    export type ReportTaskGroupReportGenerateState = 0 | 1 | 2 | 3
+    export type ReportTaskLedgerImportStage =
+        | '选择文件'
+        | '校验文件'
+        | '文件导入'
+        | '基础资料维护'
+        | '完成'
+
     export interface ReportTaskRecord {
         id?: string
         no?: string | null
@@ -15,25 +25,31 @@ export namespace ReportTask {
         checkerName?: string | null
         checkTime?: string | null
         checkResult?: string | null
+        state?: ReportTaskState | null
         status?: number
+        pointCount?: number | null
+        groupCount?: number | null
+        reportGenerateState?: ReportTaskGenerateState | null
         createBy?: string | null
         createByName?: string | null
         createTime?: string | null
         updateBy?: string | null
         updateByName?: string | null
         updateTime?: string | null
+        groupReports?: ReportTaskGroupReportRecord[] | null
     }
 
     export interface ReportTaskListParams {
         keyword?: string
         searchBeginTime?: string
         searchEndTime?: string
+        state?: ReportTaskState | ''
         timeRange?: string[]
         pageNum?: number
         pageSize?: number
     }
 
-    export interface ReportTaskSaveRequest {
+    export interface ReportTaskAddParam {
         id?: string
         no: string
         clientUnitId: string
@@ -45,8 +61,155 @@ export namespace ReportTask {
         phonenumber?: string
     }
 
+    export interface ReportTaskSaveRequest extends ReportTaskAddParam {}
+
     export interface ReportTaskAuditRequest {
         id: string
         checkResult?: string
     }
+
+    export interface ReportTaskLedgerImportStageRecord {
+        stage?: ReportTaskLedgerImportStage | string | null
+        success?: boolean | null
+        message?: string | null
+    }
+
+    export interface ReportTaskLedgerImportSnapshotGroupRecord {
+        groupNo?: number | null
+        count?: number | null
+    }
+
+    export interface ReportTaskLedgerImportSnapshot {
+        version?: string | null
+        importMode?: string | null
+        summaryFileName?: string | null
+        sheetSummary?: {
+            pointSheet?: string | null
+            deviceSheetPresent?: boolean | null
+            clientSheetPresent?: boolean | null
+        } | null
+        rowCount?: number | null
+        groupSummary?: ReportTaskLedgerImportSnapshotGroupRecord[] | null
+        baseDataSummary?: {
+            deviceAddedCount?: number | null
+            deviceReuseCount?: number | null
+            clientAddedCount?: number | null
+            clientReuseCount?: number | null
+        } | null
+    }
+
+    export interface ReportTaskLedgerValidateAttachment {
+        attachmentName?: string | null
+        attachmentType?: string | null
+        referenced?: boolean | null
+        uploaded?: boolean | null
+        missing?: boolean | null
+        reuploadAllowed?: boolean | null
+        message?: string | null
+    }
+
+    export interface ReportTaskLedgerValidatePoint {
+        rowNo?: number | null
+        pointKey?: string | null
+        substationName?: string | null
+        pointName?: string | null
+        complete?: boolean | null
+        missingAttachmentCount?: number | null
+        testDeviceNoValid?: boolean | null
+        testDeviceNoMessage?: string | null
+        clientUnitNameValid?: boolean | null
+        clientUnitNameMessage?: string | null
+        attachments?: ReportTaskLedgerValidateAttachment[] | null
+    }
+
+    export interface ReportTaskLedgerValidateResult {
+        sessionId?: string | null
+        batchId?: string | null
+        success?: boolean | null
+        summaryFileName?: string | null
+        summaryFilePresent?: boolean | null
+        tempStoragePath?: string | null
+        uploadedFileCount?: number | null
+        pointCount?: number | null
+        missingAttachmentCount?: number | null
+        canContinueUpload?: boolean | null
+        requiredSheets?: string[] | null
+        existingSheets?: string[] | null
+        missingSheets?: string[] | null
+        orphanAttachmentNames?: string[] | null
+        failReasons?: string[] | null
+        points?: ReportTaskLedgerValidatePoint[] | null
+    }
+
+    export interface ReportTaskLedgerImportResult {
+        batchId?: string | null
+        currentStage?: ReportTaskLedgerImportStage | string | null
+        success?: boolean | null
+        summaryFileName?: string | null
+        tempStoragePath?: string | null
+        totalFileCount?: number
+        uploadedFileCount?: number
+        pointCount?: number
+        excelAttachmentCount?: number
+        wordAttachmentCount?: number
+        deviceAddedCount?: number
+        deviceReuseCount?: number
+        clientAddedCount?: number
+        clientReuseCount?: number
+        groupCount?: number
+        failReasons?: string[] | null
+        stages?: ReportTaskLedgerImportStageRecord[] | null
+    }
+
+    export interface ReportTaskLedgerImportRequest {
+        batchId: string
+    }
+
+    export interface ReportTaskPointRecord {
+        id?: string
+        groupNo?: number | null
+        substationName?: string | null
+        pointName?: string | null
+        monitorTime?: string | null
+        voltageLevel?: string | null
+        ptRatio?: string | null
+        ctRatio?: string | null
+        baseShortCircuitCapacity?: string | null
+        minShortCircuitCapacity?: string | null
+        protocolCapacity?: string | null
+        powerSupplyCapacity?: string | null
+        excelAttachmentName?: string | null
+    }
+
+    export interface ReportTaskPointGroupItem {
+        groupNo: number
+        pointIds: string[]
+    }
+
+    export interface ReportTaskGroupSaveRequest {
+        groups: ReportTaskPointGroupItem[]
+    }
+
+    export interface ReportTaskGroupReportRecord {
+        id?: string
+        groupNo?: number | null
+        reportName?: string | null
+        reportFileName?: string | null
+        reportStoragePath?: string | null
+        generateState?: ReportTaskGroupReportGenerateState | null
+        generateMessage?: string | null
+        generateTime?: string | null
+        sortNo?: number | null
+    }
+
+    export interface ReportTaskLedgerPreparedState {
+        draftId: string
+        validateSessionId: string
+        validateResult: ReportTaskLedgerValidateResult | null
+        latestImportResult: ReportTaskLedgerImportResult | null
+        snapshot: ReportTaskLedgerImportSnapshot | null
+        hasImported: boolean
+        validatedBatchId: string
+        pendingRevalidate: boolean
+    }
 }

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/ReportTaskDetailDialog.vue

@@ -1,5 +1,5 @@
 <template>
-    <el-dialog v-model="visibleProxy" title="报告任务详情" width="760px" append-to-body destroy-on-close>
+    <el-dialog v-model="visibleProxy" title="报告任务详情" width="880px" append-to-body destroy-on-close>
         <div v-loading="loading" class="report-task-detail-dialog">
             <el-descriptions class="detail-descriptions" :column="2" border>
                 <el-descriptions-item label="报告编号">{{ resolveReportTaskText(detail?.no) }}</el-descriptions-item>
@@ -14,6 +14,8 @@
                     {{ resolveReportTaskStandardText(detail?.standard, standardLabelMap) }}
                 </el-descriptions-item>
                 <el-descriptions-item label="送资数据" :span="2">{{ resolveReportTaskText(detail?.data) }}</el-descriptions-item>
+                <el-descriptions-item label="监测点数量">{{ resolveReportTaskText(detail?.pointCount) }}</el-descriptions-item>
+                <el-descriptions-item label="分组数量">{{ resolveReportTaskText(detail?.groupCount) }}</el-descriptions-item>
                 <el-descriptions-item label="审核人">{{ resolveReportTaskText(detail?.checkerName) }}</el-descriptions-item>
                 <el-descriptions-item label="审核时间">{{ resolveReportTaskText(detail?.checkTime) }}</el-descriptions-item>
                 <el-descriptions-item label="审核意见" :span="2">{{ resolveReportTaskText(detail?.checkResult) }}</el-descriptions-item>
@@ -26,6 +28,24 @@
                 </el-descriptions-item>
                 <el-descriptions-item label="更新时间">{{ resolveReportTaskText(detail?.updateTime) }}</el-descriptions-item>
             </el-descriptions>
+
+            <div class="group-report-section">
+                <div class="group-report-title">分组报告生成状态</div>
+                <el-empty v-if="!groupReports.length" description="暂无分组报告记录" :image-size="88" />
+                <el-table v-else :data="groupReports" border size="small">
+                    <el-table-column prop="groupNo" label="分组号" width="100" />
+                    <el-table-column prop="reportName" label="报告名称" min-width="180" show-overflow-tooltip />
+                    <el-table-column label="生成状态" width="120">
+                        <template #default="{ row }">
+                            <el-tag :type="resolveReportTaskGroupReportGenerateStateTagType(row.generateState)">
+                                {{ resolveReportTaskGroupReportGenerateStateText(row.generateState) }}
+                            </el-tag>
+                        </template>
+                    </el-table-column>
+                    <el-table-column prop="generateMessage" label="生成消息" min-width="180" show-overflow-tooltip />
+                    <el-table-column prop="generateTime" label="生成时间" min-width="160" show-overflow-tooltip />
+                </el-table>
+            </div>
         </div>
         <template #footer>
             <el-button type="primary" @click="visibleProxy = false">关闭</el-button>
@@ -38,6 +58,8 @@ import { computed } from 'vue'
 import type { ReportTask } from '@/api/aireport/testReport/interface'
 import {
     resolveReportTaskCreateUnitText,
+    resolveReportTaskGroupReportGenerateStateTagType,
+    resolveReportTaskGroupReportGenerateStateText,
     resolveReportTaskStandardText,
     resolveReportTaskText
 } from '../utils/testReport'
@@ -50,6 +72,7 @@ const props = defineProps<{
     visible: boolean
     loading: boolean
     detail: ReportTask.ReportTaskRecord | null
+    groupReports: ReportTask.ReportTaskGroupReportRecord[]
     companyLabelMap: Record<string, string>
     standardLabelMap: Record<string, string>
 }>()
@@ -65,6 +88,7 @@ const visibleProxy = computed({
 
 const companyLabelMap = computed(() => props.companyLabelMap)
 const standardLabelMap = computed(() => props.standardLabelMap)
+const groupReports = computed(() => props.groupReports || [])
 </script>
 
 <style scoped lang="scss">
@@ -80,4 +104,15 @@ const standardLabelMap = computed(() => props.standardLabelMap)
 .report-task-detail-dialog :deep(.detail-descriptions .el-descriptions__label.el-descriptions__cell.is-bordered-label) {
     width: 112px;
 }
+
+.group-report-section {
+    margin-top: 16px;
+}
+
+.group-report-title {
+    margin-bottom: 12px;
+    font-size: 15px;
+    font-weight: 600;
+    color: var(--el-text-color-primary);
+}
 </style>

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

@@ -2,127 +2,164 @@
     <el-dialog
         v-model="visibleProxy"
         :title="mode === 'create' ? '新增报告任务' : '编辑报告任务'"
-        width="720px"
+        width="1080px"
         append-to-body
         destroy-on-close
-        @closed="resetForm"
+        class="report-task-flow-dialog"
+        @closed="resetFlow"
     >
-        <el-form ref="formRef" :model="formModel" :rules="formRules" label-width="108px" class="report-task-form">
+        <div class="report-task-form-dialog">
-            <el-row :gutter="16">
+            <div class="flow-nav">
-                <el-col :xs="24" :sm="12">
+                <button
-                    <el-form-item label="报告编号" prop="no">
+                    v-for="step in REPORT_TASK_FLOW_STEPS"
-                        <el-input v-model="formModel.no" maxlength="32" clearable placeholder="请输入报告编号" />
+                    :key="step.value"
-                    </el-form-item>
+                    type="button"
-                </el-col>
+                    class="flow-step"
-                <el-col :xs="24" :sm="12">
+                    :class="[`is-${resolveFlowStepStatus(step.value, currentStep, ledgerPreparedState)}`, { 'is-clickable': canReachFlowStep(step.value, ledgerPreparedState, currentStep) }]"
-                    <el-form-item label="委托单位" prop="clientUnitId">
+                    :disabled="!canReachFlowStep(step.value, ledgerPreparedState, currentStep)"
-                        <el-select v-model="formModel.clientUnitId" filterable clearable placeholder="请选择委托单位">
+                    @click="handleStepClick(step.value)"
-                            <el-option
+                >
-                                v-for="option in clientUnitSelectOptions"
+                    <span class="flow-step-index">{{ step.index }}</span>
-                                :key="option.value"
+                    <span class="flow-step-content">
-                                :label="option.label"
+                        <span class="flow-step-title">{{ step.title }}</span>
-                                :value="option.value"
+                        <span class="flow-step-desc">{{ step.description }}</span>
-                            />
+                    </span>
-                        </el-select>
+                </button>
-                    </el-form-item>
+            </div>
-                </el-col>
+
-                <el-col :xs="24" :sm="12">
+            <div class="report-task-form-body">
-                    <el-form-item label="报告模板" prop="reportModelId">
+                <div class="flow-main">
-                        <el-select v-model="formModel.reportModelId" filterable clearable placeholder="请选择报告模板">
+                    <ReportTaskPrepareStep
-                            <el-option
+                        v-if="currentStep === 'prepare'"
-                                v-for="option in reportModelSelectOptions"
+                        :draft-id="activeDraftId"
-                                :key="option.value"
+                        :disabled="saving"
-                                :label="option.label"
+                        :prepared-state="ledgerPreparedState"
-                                :value="option.value"
+                        @change="handleLedgerPreparedChange"
-                            />
+                        @log="handleLog"
-                        </el-select>
+                    />
-                    </el-form-item>
+
-                </el-col>
+                    <ReportTaskImportStep
-                <el-col :xs="24" :sm="12">
+                        v-else-if="currentStep === 'import'"
-                    <el-form-item label="检测公司" prop="createUnit">
+                        :disabled="saving"
-                        <el-select v-model="formModel.createUnit" filterable clearable placeholder="请选择检测公司">
+                        :prepared-state="ledgerPreparedState"
-                            <el-option
+                        :snapshot="ledgerPreparedState.snapshot"
-                                v-for="option in companySelectOptions"
+                        @change="handleLedgerPreparedChange"
-                                :key="option.value"
+                        @log="handleLog"
-                                :label="option.label"
+                    />
-                                :value="option.value"
+
-                            />
+                    <ReportTaskBaseInfoStep
-                        </el-select>
+                        v-else-if="currentStep === 'form'"
-                    </el-form-item>
+                        :form-model="formModel"
-                </el-col>
+                        :record="record"
-                <el-col :xs="24" :sm="12">
+                        :client-unit-options="clientUnitOptions"
-                    <el-form-item label="合同编号" prop="contractNumber">
+                        :report-model-options="reportModelOptions"
-                        <el-input v-model="formModel.contractNumber" maxlength="32" clearable placeholder="请输入合同编号" />
+                        :company-options="companyOptions"
-                    </el-form-item>
+                        :standard-options="standardOptions"
-                </el-col>
+                        :prepared-state="ledgerPreparedState"
-                <el-col :xs="24" :sm="12">
+                        @register-form="handleRegisterForm"
-                    <el-form-item label="测试依据" prop="standardIds">
+                        @update:form-model="handleFormModelChange"
-                        <el-select
+                    />
-                            v-model="formModel.standardIds"
+
-                            multiple
+                    <ReportTaskCompleteStep
-                            filterable
+                        v-else
-                            clearable
+                        :mode="mode"
-                            collapse-tags
+                        :form-model="formModel"
-                            placeholder="请选择测试依据"
+                        :prepared-state="ledgerPreparedState"
-                        >
+                        :client-unit-options="clientUnitOptions"
-                            <el-option
+                        :company-options="companyOptions"
-                                v-for="option in standardSelectOptions"
+                    />
-                                :key="option.value"
+                </div>
-                                :label="option.label"
+
-                                :value="option.value"
+                <aside class="log-floating-panel" :class="{ 'is-collapsed': !logPanelExpanded }">
-                            >
+                    <el-button
-                                <div class="standard-option">
+                        class="log-panel-collapse-toggle"
-                                    <el-checkbox
+                        type="primary"
-                                        class="standard-option-checkbox"
+                        :icon="logPanelExpanded ? ArrowRight : ArrowLeft"
-                                        :model-value="formModel.standardIds.includes(option.value)"
+                        circle
-                                    />
+                        @click="logPanelExpanded = !logPanelExpanded"
-                                    <span class="standard-option-label">{{ option.label }}</span>
+                    />
+
+                    <div v-show="logPanelExpanded" class="log-panel-body-wrapper">
+                        <div class="log-panel">
+                            <div class="log-panel-header">
+                                <div class="log-title">异常日志</div>
+                            </div>
+
+                            <div class="log-panel-body">
+                                <div class="log-popover-body">
+                                    <div v-if="logEntries.length" class="log-list">
+                                        <div v-for="entry in logEntries" :key="entry.id" class="log-item">
+                                            <div class="log-meta">
+                                                <el-tag size="small" :type="resolveLogTagType(entry.type)">{{ resolveLogTypeText(entry.type) }}</el-tag>
+                                                <span class="log-time">{{ entry.time }}</span>
+                                            </div>
+                                            <el-tooltip :content="entry.message" placement="top-start">
+                                                <div class="log-message">{{ entry.message }}</div>
+                                            </el-tooltip>
+                                        </div>
+                                    </div>
+                                    <el-empty v-else description="当前暂无日志输出" :image-size="60" class="log-empty" />
                                 </div>
-                            </el-option>
+                            </div>
-                        </el-select>
+                        </div>
-                    </el-form-item>
+                    </div>
-                </el-col>
+                </aside>
-                <el-col :xs="24" :sm="12">
+            </div>
-                    <el-form-item label="联系电话" prop="phonenumber">
+        </div>
-                        <el-input v-model="formModel.phonenumber" maxlength="32" clearable placeholder="请输入联系电话" />
+
-                    </el-form-item>
-                </el-col>
-                <el-col :span="24">
-                    <el-form-item label="送资数据" prop="data">
-                        <el-input
-                            v-model="formModel.data"
-                            type="textarea"
-                            :rows="4"
-                            maxlength="256"
-                            show-word-limit
-                            placeholder="请输入送资数据"
-                        />
-                    </el-form-item>
-                </el-col>
-            </el-row>
-        </el-form>
         <template #footer>
-            <el-button :disabled="saving" @click="visibleProxy = false">取消</el-button>
+            <el-button :disabled="saving" @click="visibleProxy = false">{{ currentStep === 'done' ? '关闭' : '取消' }}</el-button>
-            <el-button type="primary" :loading="saving" @click="submitForm">确定</el-button>
+
+            <template v-if="currentStep === 'prepare'">
+                <el-button type="primary" :disabled="!canGoToImport" @click="goToImportStep">下一步</el-button>
+            </template>
+
+            <template v-else-if="currentStep === 'import'">
+                <el-button type="primary" plain :disabled="saving" @click="goToPrepareStep">上一步</el-button>
+                <el-button type="primary" :disabled="!canGoToForm" @click="goToFormStep">下一步</el-button>
+            </template>
+
+            <template v-else-if="currentStep === 'form'">
+                <el-button type="primary" plain :disabled="saving" @click="goToImportStep">返回导入</el-button>
+                <el-button type="primary" :loading="saving" :disabled="!canSubmit" @click="submitForm">提交</el-button>
+            </template>
         </template>
     </el-dialog>
 </template>
 
 <script setup lang="ts">
-import { type FormInstance, type FormRules } from 'element-plus'
+import { ArrowLeft, ArrowRight } from '@element-plus/icons-vue'
+import { ElMessage, type FormInstance } from 'element-plus'
 import { computed, reactive, ref, watch } from 'vue'
 import type { ReportTask } from '@/api/aireport/testReport/interface'
-import { parseReportTaskStandardIds, stringifyReportTaskStandardIds } from '../utils/testReport'
+import ReportTaskBaseInfoStep from './ReportTaskBaseInfoStep.vue'
+import ReportTaskCompleteStep from './ReportTaskCompleteStep.vue'
+import ReportTaskImportStep from './ReportTaskImportStep.vue'
+import ReportTaskPrepareStep from './ReportTaskPrepareStep.vue'
+import {
+    REPORT_TASK_FLOW_STEPS,
+    canReachFlowStep,
+    createEmptyLedgerPreparedState,
+    hasValidatedLedgerBatch,
+    resolveFlowStepStatus,
+    resolveInitialFlowStep,
+    type ReportTaskFlowStep
+} from '../utils/reportTaskFlow'
+import { buildReportTaskFormContext, buildReportTaskSavePayload, createDefaultReportTaskFormModel } from '../utils/testReportForm'
+import { checkReportTaskLedgerPrepared, getReportTaskErrorMessage } from '../utils/testReport'
 
 defineOptions({
     name: 'ReportTaskFormDialog'
 })
 
+type ReportTaskLogType = 'info' | 'success' | 'warning' | 'error'
+
 const props = defineProps<{
     visible: boolean
     mode: 'create' | 'edit'
     record: ReportTask.ReportTaskRecord | null
     saving: boolean
+    saveSuccessVersion: number
     clientUnitOptions: Array<{ label: string; value: string }>
     reportModelOptions: Array<{ label: string; value: string }>
     companyOptions: Array<{ label: string; value: string }>
@@ -132,139 +169,569 @@ const props = defineProps<{
 const emit = defineEmits<{
     (event: 'update:visible', value: boolean): void
     (event: 'submit', value: ReportTask.ReportTaskSaveRequest): void
+    (event: 'refresh-options'): void
 }>()
 
 const formRef = ref<FormInstance>()
-const formModel = reactive({
+const activeDraftId = ref('')
-    id: '',
+const currentStep = ref<ReportTaskFlowStep>('prepare')
-    no: '',
+const logPanelExpanded = ref(false)
-    clientUnitId: '',
+const logEntries = ref<Array<{ id: string; type: ReportTaskLogType; time: string; message: string }>>([])
-    reportModelId: '',
+const ledgerPreparedState = reactive(createEmptyLedgerPreparedState())
-    createUnit: '',
+const formModel = reactive(createDefaultReportTaskFormModel())
-    contractNumber: '',
+const lastHandledSaveSuccessVersion = ref(0)
-    standardIds: [] as string[],
-    data: '',
-    phonenumber: ''
-})
-
-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' }],
-    data: [{ required: true, message: '请输入送资数据', trigger: 'blur' }]
-}
 
 const visibleProxy = computed({
     get: () => props.visible,
     set: value => emit('update:visible', value)
 })
 
-const ensureCurrentOption = (
+const canGoToImport = computed(() => hasValidatedLedgerBatch(ledgerPreparedState))
-    options: Array<{ label: string; value: string }>,
+const canVisitImport = computed(() => canGoToImport.value || ledgerPreparedState.hasImported || Boolean(ledgerPreparedState.snapshot))
-    value: string,
+const canGoToForm = computed(() => checkReportTaskLedgerPrepared(ledgerPreparedState))
-    fallbackLabel: string
+const canSubmit = computed(() => !props.saving && checkReportTaskLedgerPrepared(ledgerPreparedState))
-) => {
-    if (!value || options.some(option => option.value === value)) return options
 
-    return [...options, { label: fallbackLabel || value, value }]
+const buildLogId = () => window.crypto?.randomUUID?.() || `${Date.now()}-${Math.random().toString(16).slice(2)}`
+
+const pushLog = (type: ReportTaskLogType, message: string) => {
+    logEntries.value.push({
+        id: buildLogId(),
+        type,
+        time: new Date().toLocaleTimeString('zh-CN', { hour12: false }),
+        message
+    })
 }
 
-const clientUnitSelectOptions = computed(() =>
+const handleLog = (payload: { type: ReportTaskLogType; message: string }) => {
-    ensureCurrentOption(props.clientUnitOptions, formModel.clientUnitId, props.record?.clientUnitName || '')
+    pushLog(payload.type, payload.message)
-)
+}
-const reportModelSelectOptions = computed(() =>
-    ensureCurrentOption(props.reportModelOptions, formModel.reportModelId, props.record?.reportModelName || '')
-)
-const companySelectOptions = computed(() =>
-    ensureCurrentOption(props.companyOptions, formModel.createUnit, props.record?.createUnit || '')
-)
-const standardSelectOptions = computed(() => {
-    const optionMap = new Map(props.standardOptions.map(option => [option.value, option]))
-    const extraOptions = formModel.standardIds
-        .filter(item => !optionMap.has(item))
-        .map(item => ({ label: item, value: item }))
 
-    return [...props.standardOptions, ...extraOptions]
+const handleRegisterForm = (value: FormInstance | undefined) => {
-})
+    formRef.value = value
+}
 
-const resetForm = () => {
+const handleFormModelChange = (value: typeof formModel) => {
+    Object.assign(formModel, value)
+}
+
+const resolveLogTagType = (type: ReportTaskLogType) => {
+    if (type === 'success') return 'success'
+    if (type === 'warning') return 'warning'
+    if (type === 'error') return 'danger'
+    return 'info'
+}
+
+const resolveLogTypeText = (type: ReportTaskLogType) => {
+    if (type === 'success') return '成功'
+    if (type === 'warning') return '警告'
+    if (type === 'error') return '错误'
+    return '信息'
+}
+
+const resetFlow = () => {
     formRef.value?.clearValidate()
-    formModel.id = ''
+    Object.assign(formModel, createDefaultReportTaskFormModel())
-    formModel.no = ''
+    activeDraftId.value = ''
-    formModel.clientUnitId = ''
+    currentStep.value = 'prepare'
-    formModel.reportModelId = ''
+    logPanelExpanded.value = false
-    formModel.createUnit = ''
+    logEntries.value = []
-    formModel.contractNumber = ''
+    Object.assign(ledgerPreparedState, createEmptyLedgerPreparedState())
-    formModel.standardIds = []
-    formModel.data = ''
-    formModel.phonenumber = ''
 }
 
-const fillForm = () => {
+const fillFlowContext = async () => {
-    formModel.id = props.record?.id || ''
+    try {
-    formModel.no = props.record?.no || ''
+        const context = buildReportTaskFormContext(props.mode, props.record)
-    formModel.clientUnitId = props.record?.clientUnitId || ''
+        Object.assign(formModel, context.formModel)
-    formModel.reportModelId = props.record?.reportModelId || ''
+        activeDraftId.value = context.draftId
-    formModel.createUnit = props.record?.createUnit || ''
+        Object.assign(ledgerPreparedState, {
-    formModel.contractNumber = props.record?.contractNumber || ''
+            draftId: context.draftId,
-    formModel.standardIds = parseReportTaskStandardIds(props.record?.standard)
+            validateSessionId: '',
-    formModel.data = props.record?.data || ''
+            validateResult: null,
-    formModel.phonenumber = props.record?.phonenumber || ''
+            latestImportResult: null,
+            snapshot: context.snapshot,
+            hasImported: context.hasPreparedImport,
+            validatedBatchId: '',
+            pendingRevalidate: false
+        })
+
+        currentStep.value = resolveInitialFlowStep(props.mode, ledgerPreparedState)
+        if (currentStep.value === 'form') {
+            pushLog('info', '编辑场景检测到已有导入结果，默认进入基础信息维护步骤')
+        } else {
+            pushLog('info', '已进入文件选择与校验步骤，请先完成文件准备')
+        }
+
+        if (context.snapshot) {
+            pushLog('info', `已加载最近一次导入快照：${context.snapshot.summaryFileName || '未命名汇总文件'}`)
+        }
+    } catch (error) {
+        const message = getReportTaskErrorMessage(error, '报告任务初始化失败')
+        ElMessage.error(message)
+        pushLog('error', message)
+    }
+}
+
+const goToPrepareStep = () => {
+    currentStep.value = 'prepare'
+    pushLog('info', '已返回文件选择与校验步骤')
+}
+
+const goToImportStep = () => {
+    if (!canVisitImport.value) {
+        pushLog('warning', '当前文件校验尚未通过，不能进入正式导入步骤')
+        return
+    }
+
+    currentStep.value = 'import'
+    pushLog('info', '已切换到文件导入步骤')
+}
+
+const goToFormStep = () => {
+    if (!canGoToForm.value) {
+        pushLog('warning', '当前正式导入尚未完成，不能进入基础信息维护步骤')
+        return
+    }
+
+    currentStep.value = 'form'
+    pushLog('info', '已切换到基础信息维护步骤')
+}
+
+const handleLedgerPreparedChange = (value: ReportTask.ReportTaskLedgerPreparedState) => {
+    const wasReadyForImport = hasValidatedLedgerBatch(ledgerPreparedState)
+    const wasReadyForSubmit = checkReportTaskLedgerPrepared(ledgerPreparedState)
+
+    Object.assign(ledgerPreparedState, {
+        ...value,
+        draftId: activeDraftId.value
+    })
+
+    if (!wasReadyForImport && hasValidatedLedgerBatch(ledgerPreparedState) && currentStep.value === 'prepare') {
+        currentStep.value = 'import'
+        pushLog('success', '文件校验已通过，已自动进入正式导入步骤')
+        return
+    }
+
+    if (!wasReadyForSubmit && checkReportTaskLedgerPrepared(ledgerPreparedState)) {
+        emit('refresh-options')
+        currentStep.value = 'form'
+        pushLog('success', '正式导入已完成，已自动进入基础信息维护步骤')
+    }
+}
+
+const handleStepClick = (step: ReportTaskFlowStep) => {
+    if (!canReachFlowStep(step, ledgerPreparedState, currentStep.value)) return
+    if (step === 'prepare') {
+        goToPrepareStep()
+        return
+    }
+    if (step === 'import') {
+        goToImportStep()
+        return
+    }
+    if (step === 'form') {
+        goToFormStep()
+    }
 }
 
 watch(
     () => [props.visible, props.mode, props.record?.id],
-    ([visible]) => {
+    async ([visible]) => {
-        if (visible) fillForm()
+        if (!visible) return
+        resetFlow()
+        await fillFlowContext()
     },
     { immediate: true }
 )
 
+watch(
+    () => props.saveSuccessVersion,
+    value => {
+        if (!props.visible || !value || value === lastHandledSaveSuccessVersion.value) return
+
+        lastHandledSaveSuccessVersion.value = value
+        currentStep.value = 'done'
+        pushLog('success', props.mode === 'create' ? '报告任务新增成功，流程已完成' : '报告任务编辑成功，流程已完成')
+    }
+)
+
 const submitForm = async () => {
     const valid = await formRef.value?.validate().catch(() => false)
+    if (!valid) {
+        pushLog('warning', '基础信息校验未通过，请检查必填项')
+        return
+    }
 
-    if (!valid) return
+    if (!checkReportTaskLedgerPrepared(ledgerPreparedState)) {
+        const message = '请先完成正式导入后再提交基础信息'
+        ElMessage.warning(message)
+        pushLog('warning', message)
+        return
+    }
 
-    emit('submit', {
+    // 关键业务节点：当前弹窗只接受已完成 ledger/validate -> ledger/import 的任务，再执行最终 add/update 保存基础信息。
-        id: formModel.id || undefined,
+    pushLog('info', props.mode === 'create' ? '开始提交新增任务基础信息' : '开始提交编辑后的任务基础信息')
-        no: formModel.no.trim(),
+    emit('submit', buildReportTaskSavePayload(activeDraftId.value, formModel))
-        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
-    })
 }
 </script>
 
 <style scoped lang="scss">
-:deep(.report-task-form .el-form-item) {
+.report-task-form-dialog {
-    margin-bottom: 18px;
+    position: relative;
-}
-
-:deep(.el-select),
-:deep(.el-textarea),
-:deep(.el-input) {
-    width: 100%;
-}
-
-.standard-option {
     display: flex;
+    flex-direction: column;
+    gap: 16px;
+    height: 560px;
+    min-height: 0;
+}
+
+.flow-nav {
+    display: grid;
+    grid-template-columns: repeat(4, minmax(0, 1fr));
+    gap: 0;
+    padding: 16px 18px 12px;
+    border: 1px solid #d9ebe7;
+    border-radius: 10px;
+    background: #fff;
+}
+
+.flow-step {
+    position: relative;
+    display: flex;
+    flex-direction: column;
     align-items: center;
-    gap: 8px;
+    gap: 6px;
+    padding: 0 12px 10px;
+    border: none;
+    background: transparent;
+    text-align: center;
+    transition: color 0.2s ease;
 }
 
-.standard-option-checkbox {
+.flow-step::before,
-    pointer-events: none;
+.flow-step::after {
+    content: '';
+    position: absolute;
+    top: 12px;
+    width: calc(50% - 18px);
+    height: 1px;
+    background: #cfd5df;
 }
 
-.standard-option-label {
+.flow-step::before {
+    left: 0;
+}
+
+.flow-step::after {
+    right: 0;
+}
+
+.flow-step:first-child::before,
+.flow-step:last-child::after {
+    display: none;
+}
+
+.flow-step.is-clickable {
+    cursor: pointer;
+}
+
+.flow-step:disabled {
+    cursor: default;
+}
+
+.flow-step.is-active .flow-step-title,
+.flow-step.is-active .flow-step-desc {
+    color: #67c23a;
+}
+
+.flow-step.is-done .flow-step-index {
+    border-color: var(--el-color-success);
+    background: rgba(103, 194, 58, 0.1);
+    color: var(--el-color-success);
+}
+
+.flow-step.is-done::after,
+.flow-step.is-done + .flow-step::before {
+    background: rgba(103, 194, 58, 0.45);
+}
+
+.flow-step-index {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 26px;
+    height: 26px;
+    border: 2px solid #b8bec9;
+    border-radius: 50%;
+    background: #fff;
+    font-size: 16px;
+    font-weight: 600;
+    line-height: 1;
+    color: #a9b0bb;
+    flex-shrink: 0;
+    z-index: 1;
+}
+
+.flow-step.is-active .flow-step-index {
+    border-color: #67c23a;
+    background: rgba(103, 194, 58, 0.1);
+    color: #67c23a;
+}
+
+.flow-step-content {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 6px;
+}
+
+.flow-step-title {
+    font-size: 16px;
+    font-weight: 600;
+    line-height: 1.2;
+    color: #a9b0bb;
+}
+
+.flow-step-desc {
+    font-size: 12px;
+    line-height: 1.25;
+    color: #b9bfc9;
+}
+
+.report-task-form-body {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    min-height: 0;
+    flex: 1;
+    overflow: hidden;
+}
+
+.flow-main {
+    display: flex;
     flex: 1;
     min-width: 0;
+    min-height: 0;
+    overflow: auto;
+}
+
+.log-floating-panel {
+    position: absolute;
+    top: 12px;
+    right: 12px;
+    bottom: 12px;
+    z-index: 4000;
+    display: flex;
+    flex-direction: column;
+    align-items: flex-end;
+    width: 300px;
+    min-height: 0;
+    transition: width 0.2s ease;
+}
+
+.log-floating-panel.is-collapsed {
+    width: 0;
+}
+
+.log-panel-collapse-toggle {
+    position: absolute;
+    top: 12px;
+    left: -28px;
+    flex-shrink: 0;
+    z-index: 4001;
+}
+
+.log-panel-body-wrapper {
+    position: relative;
+    flex: 1;
+    min-height: 0;
+    width: 100%;
+    z-index: 4000;
+    isolation: isolate;
+}
+
+.log-floating-panel.is-collapsed .log-panel-body-wrapper {
+    display: none;
+}
+
+.log-panel {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    width: 100%;
+    height: 100%;
+    border: 1px solid var(--el-border-color-light);
+    border-radius: 12px;
+    background: var(--el-fill-color-blank);
+    overflow: hidden;
+    box-shadow: var(--el-box-shadow-light);
+}
+
+.log-panel-header {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 100%;
+    min-height: 46px;
+    padding: 0 16px;
+    background: linear-gradient(180deg, #eef3ff 0%, #e6ecff 100%);
+}
+
+.log-title {
+    flex: 1;
+    font-size: 15px;
+    font-weight: 600;
+    color: #2f4fb7;
+}
+
+.log-panel-body {
+    position: relative;
+    display: flex;
+    flex: 1;
+    min-height: 0;
+    border-top: 1px solid #d9e3ff;
+    background: #fff;
+    z-index: 1;
+}
+
+.log-popover-body {
+    position: relative;
+    flex: 1;
+    min-height: 0;
+    overflow: auto;
+    padding: 0;
+    background: #fff;
+    z-index: 1;
+}
+
+.log-list {
+    display: flex;
+    flex-direction: column;
+}
+
+.log-item {
+    display: grid;
+    grid-template-columns: 116px minmax(0, 1fr);
+    border-top: 1px solid var(--el-border-color-lighter);
+}
+
+.log-item:first-child {
+    border-top: none;
+}
+
+.log-meta,
+.log-message {
+    padding: 8px 10px;
+}
+
+.log-meta {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    border-right: 1px solid var(--el-border-color-lighter);
+    background: #f6f8ff;
+    white-space: nowrap;
+}
+
+.log-time {
+    font-size: 11px;
+    color: var(--el-text-color-secondary);
+    line-height: 1;
+}
+
+.log-message {
+    font-size: 12px;
+    line-height: 1.2;
+    color: var(--el-text-color-primary);
+    overflow: hidden;
+    white-space: nowrap;
+    text-overflow: ellipsis;
+}
+
+.log-empty {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    height: 100%;
+    min-height: 180px;
+}
+
+:deep(.report-task-flow-dialog .el-dialog__body) {
+    display: flex;
+    min-height: 0;
+    overflow: hidden;
+}
+
+:deep(.report-task-flow-dialog .el-dialog) {
+    display: flex;
+    flex-direction: column;
+    max-height: calc(100vh - 40px);
+}
+
+:deep(.report-task-flow-dialog .el-table__fixed),
+:deep(.report-task-flow-dialog .el-table__fixed-right),
+:deep(.report-task-flow-dialog .el-table__fixed-right-patch) {
+    z-index: 1;
+}
+
+:deep(.report-task-flow-dialog .el-table__body-wrapper),
+:deep(.report-task-flow-dialog .el-scrollbar),
+:deep(.report-task-flow-dialog .el-scrollbar__bar),
+:deep(.report-task-flow-dialog .el-scrollbar__thumb) {
+    z-index: 1 !important;
+}
+
+@media (max-width: 900px) {
+    .flow-nav {
+        grid-template-columns: 1fr;
+        gap: 14px;
+        padding: 16px;
+    }
+
+    .flow-step {
+        flex-direction: row;
+        align-items: center;
+        justify-content: flex-start;
+        padding: 0;
+        text-align: left;
+    }
+
+    .flow-step::before,
+    .flow-step::after {
+        display: none;
+    }
+
+    .flow-step-content {
+        align-items: flex-start;
+    }
+
+    .log-floating-panel {
+        position: static;
+        align-items: stretch;
+        width: 100%;
+        min-height: 220px;
+    }
+
+    .log-floating-panel.is-collapsed {
+        width: 100%;
+        min-height: 0;
+    }
+
+    .log-panel-collapse-toggle {
+        position: static;
+        align-self: flex-end;
+    }
+
+    .log-panel-header {
+        padding: 0 14px;
+    }
+
+    .log-item {
+        grid-template-columns: 1fr;
+    }
+
+    .log-meta {
+        border-right: none;
+        border-bottom: 1px solid var(--el-border-color-lighter);
+    }
 }
 </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/contracts/check-test-report-page-contract.mjs

@@ -21,75 +21,97 @@ assertFileIncludes(path.join(srcDir, 'constants/dictCodes.ts'), ['TEST_REPORT_CO
 
 assertFileIncludes(path.join(apiDir, 'index.ts'), [
     "const REPORT_TASK_BASE_URL = '/api/test-report'",
-    'listReportTasksApi',
+    'validateReportTaskLedgerApi',
-    'createReportTaskApi',
+    'importReportTaskLedgerApi',
-    'updateReportTaskApi',
+    'downloadReportTaskLedgerTemplateApi'
-    'deleteReportTasksApi',
-    'getReportTaskDetailApi',
-    'exportReportTasksApi',
-    'submitReportTaskAuditApi'
 ])
 
 assertFileIncludes(path.join(apiDir, 'interface/index.ts'), [
-    'export namespace ReportTask',
+    'ReportTaskLedgerValidateResult',
-    'ReportTaskRecord',
+    'ReportTaskLedgerImportRequest',
-    'ReportTaskListParams',
+    'validateSessionId',
-    'ReportTaskSaveRequest',
+    'validateResult',
-    'ReportTaskAuditRequest',
+    'validatedBatchId',
-    'standard?: string[] | string | null',
+    'pendingRevalidate'
-    'standard: string[]'
 ])
 
-assertFileIncludes(path.join(pageDir, 'utils/testReport.ts'), [
+assertFileIncludes(path.join(pageDir, 'utils/reportTaskFlow.ts'), [
-    'normalizeReportTaskListParams',
+    'REPORT_TASK_FLOW_STEPS',
-    'normalizeReportTaskPage',
+    'createEmptyLedgerPreparedState',
-    'parseReportTaskStandardIds',
+    'hasValidatedLedgerBatch',
-    'stringifyReportTaskStandardIds',
+    'resolveInitialFlowStep',
-    'resolveReportTaskStandardText',
+    'canReachFlowStep',
-    'buildDictSelectOptions',
+    'resolveFlowStepStatus'
-    'value?: string[] | string | null',
+])
-    "return text ? [text] : []"
+
+assertFileIncludes(path.join(pageDir, 'utils/testReportForm.ts'), [
+    'createDefaultReportTaskFormModel',
+    'buildReportTaskFormContext',
+    'buildReportTaskSavePayload'
+])
+
+assertFileIncludes(path.join(pageDir, 'components/ReportTaskPrepareStep.vue'), [
+    "name: 'ReportTaskPrepareStep'",
+    'validateReportTaskLedgerApi',
+    'downloadReportTaskLedgerTemplateApi',
+    'selectedFiles',
+    'validateResult',
+    'sessionId',
+    'canContinueUpload',
+    'points',
+    'attachments',
+    '执行校验'
+])
+
+assertFileIncludes(path.join(pageDir, 'components/ReportTaskImportStep.vue'), [
+    "name: 'ReportTaskImportStep'",
+    'importReportTaskLedgerApi',
+    'validatedBatchId',
+    '执行导入',
+    'ledger/validate -> ledger/import'
+])
+
+assertFileIncludes(path.join(pageDir, 'components/ReportTaskBaseInfoStep.vue'), [
+    "name: 'ReportTaskBaseInfoStep'",
+    'register-form',
+    'formRules',
+    'summary-strip'
+])
+
+assertFileIncludes(path.join(pageDir, 'components/ReportTaskCompleteStep.vue'), [
+    "name: 'ReportTaskCompleteStep'",
+    '报告任务新增完成',
+    '报告任务编辑完成'
 ])
 
 assertFileIncludes(path.join(pageDir, 'components/ReportTaskFormDialog.vue'), [
     "name: 'ReportTaskFormDialog'",
-    'clientUnitId',
+    'ReportTaskPrepareStep',
-    'reportModelId',
+    'ReportTaskImportStep',
-    'createUnit',
+    'ReportTaskBaseInfoStep',
-    'standardIds',
+    'ReportTaskCompleteStep',
-    'stringifyReportTaskStandardIds',
+    'REPORT_TASK_FLOW_STEPS',
-    'el-checkbox',
+    'createEmptyLedgerPreparedState',
-    'standard-option-checkbox'
+    'buildReportTaskFormContext',
-])
+    'buildReportTaskSavePayload',
-
+    'ledger/validate -> ledger/import',
-assertFileIncludes(path.join(pageDir, 'components/ReportTaskDetailDialog.vue'), [
+    'log-floating-panel',
-    "name: 'ReportTaskDetailDialog'",
+    'el-tooltip',
-    '报告任务详情',
+    'text-overflow: ellipsis',
-    'resolveReportTaskCreateUnitText',
+    'height: 560px',
-    'resolveReportTaskStandardText',
+    'max-height: calc(100vh - 40px)',
-    'table-layout: fixed'
+    'display: flex',
-])
+    'padding: 16px 18px 12px',
-
+    'gap: 6px',
-assertFileIncludes(path.join(pageDir, 'components/ReportTaskAuditDialog.vue'), [
+    'padding: 0 12px 10px',
-    "name: 'ReportTaskAuditDialog'",
+    '.flow-main {\n    display: flex;\n    flex: 1;\n    min-width: 0;\n    min-height: 0;\n    overflow: auto;\n}'
-    'checkResult',
-    '提交审核'
 ])
 
 assertFileIncludes(path.join(pageDir, 'index.vue'), [
     "name: 'ReportTaskPage'",
-    '<ProTable',
     'ReportTaskFormDialog',
-    'ReportTaskDetailDialog',
+    '@refresh-options',
-    'ReportTaskAuditDialog',
+    'ledger/validate -> ledger/import -> add/update'
-    'listReportTasksApi',
-    'submitReportTaskAuditApi',
-    'exportReportTasksApi',
-    'DICT_CODES.TEST_REPORT_COMPANY',
-    'DICT_CODES.TEST_REPORT_STANDARD',
-    'type="primary" :icon="Plus"',
-    'type="danger"',
-    'type="primary" plain'
 ])
 
 console.log('testReport page contract passed')

frontend/src/views/aireport/testReport/index.vue

@@ -35,10 +35,12 @@
             :mode="formMode"
             :record="currentRecord"
             :saving="formSaving"
+            :save-success-version="formSaveSuccessVersion"
             :client-unit-options="clientUnitOptions"
             :report-model-options="reportModelOptions"
             :company-options="companyOptions"
             :standard-options="standardOptions"
+            @refresh-options="refreshFormOptions"
             @submit="handleSaveReportTask"
         />
 
@@ -46,6 +48,7 @@
             v-model:visible="detailDialogVisible"
             :loading="detailLoading"
             :detail="detailRecord"
+            :group-reports="detailGroupReports"
             :company-label-map="companyLabelMap"
             :standard-label-map="standardLabelMap"
         />
@@ -67,12 +70,13 @@ import type { Dict, ResPage } from '@/api/interface'
 import ProTable from '@/components/ProTable/index.vue'
 import type { ColumnProps, ProTableInstance } from '@/components/ProTable/interface'
 import {
+    createReportTaskApi,
     deleteReportTasksApi,
     exportReportTasksApi,
     getReportTaskDetailApi,
+    listReportTaskGroupReportsApi,
     listReportTasksApi,
     submitReportTaskAuditApi,
-    createReportTaskApi,
     updateReportTaskApi
 } from '@/api/aireport/testReport'
 import type { ReportTask } from '@/api/aireport/testReport/interface'
@@ -89,6 +93,12 @@ import {
     buildDictSelectOptions,
     buildOptionLabelMap,
     getReportTaskErrorMessage,
+    getReportTaskGenerateStateTagType,
+    getReportTaskGenerateStateText,
+    getReportTaskStateTagType,
+    getReportTaskStateText,
+    REPORT_TASK_STATE_OPTIONS,
+    normalizeReportTaskGroupReportList,
     normalizeReportTaskListParams,
     normalizeReportTaskPage,
     resolveReportTaskCreateUnitText,
@@ -107,17 +117,20 @@ const formDialogVisible = ref(false)
 const detailDialogVisible = ref(false)
 const auditDialogVisible = ref(false)
 const formSaving = ref(false)
+const formSaveSuccessVersion = ref(0)
 const detailLoading = ref(false)
 const auditSaving = ref(false)
 const formMode = ref<'create' | 'edit'>('create')
 const currentRecord = ref<ReportTask.ReportTaskRecord | null>(null)
 const detailRecord = ref<ReportTask.ReportTaskRecord | null>(null)
+const detailGroupReports = ref<ReportTask.ReportTaskGroupReportRecord[]>([])
 const currentAuditRecord = ref<ReportTask.ReportTaskRecord | null>(null)
 const clientUnitOptions = ref<Array<{ label: string; value: string }>>([])
 const reportModelOptions = ref<Array<{ label: string; value: string }>>([])
 
 const companyOptions = computed(() => buildDictSelectOptions(dictStore.getDictData(DICT_CODES.TEST_REPORT_COMPANY)))
 const standardOptions = computed(() => buildDictSelectOptions(dictStore.getDictData(DICT_CODES.TEST_REPORT_STANDARD)))
+const stateOptions = REPORT_TASK_STATE_OPTIONS
 const companyLabelMap = computed(() => buildOptionLabelMap(companyOptions.value))
 const standardLabelMap = computed(() => buildOptionLabelMap(standardOptions.value))
 const requiredDictCodes = [DICT_CODES.TEST_REPORT_COMPANY, DICT_CODES.TEST_REPORT_STANDARD]
@@ -158,6 +171,25 @@ const columns = reactive<ColumnProps<ReportTask.ReportTaskRecord>[]>([
             }
         }
     },
+    {
+        prop: 'state',
+        label: '报告状态',
+        minWidth: 120,
+        enum: stateOptions,
+        search: {
+            el: 'select',
+            order: 3,
+            props: {
+                clearable: true,
+                placeholder: '请选择报告状态'
+            }
+        },
+        render: ({ row }) => (
+            <el-tag type={getReportTaskStateTagType(row.state)} effect="light">
+                {getReportTaskStateText(row.state)}
+            </el-tag>
+        )
+    },
     { prop: 'no', label: '报告编号', minWidth: 180, fixed: 'left', render: ({ row }) => resolveReportTaskText(row.no) },
     { prop: 'clientUnitName', label: '委托单位', minWidth: 160, render: ({ row }) => resolveReportTaskText(row.clientUnitName) },
     { prop: 'reportModelName', label: '报告模板', minWidth: 160, render: ({ row }) => resolveReportTaskText(row.reportModelName) },
@@ -175,6 +207,18 @@ const columns = reactive<ColumnProps<ReportTask.ReportTaskRecord>[]>([
         showOverflowTooltip: true,
         render: ({ row }) => resolveReportTaskStandardText(row.standard, standardLabelMap.value)
     },
+    {
+        prop: 'reportGenerateState',
+        label: '生成状态',
+        minWidth: 120,
+        render: ({ row }) => (
+            <el-tag type={getReportTaskGenerateStateTagType(row.reportGenerateState)} effect="light">
+                {getReportTaskGenerateStateText(row.reportGenerateState)}
+            </el-tag>
+        )
+    },
+    { prop: 'pointCount', label: '监测点数', minWidth: 100, render: ({ row }) => resolveReportTaskText(row.pointCount) },
+    { prop: 'groupCount', label: '分组数', minWidth: 100, render: ({ row }) => resolveReportTaskText(row.groupCount) },
     { prop: 'phonenumber', label: '联系电话', minWidth: 140, render: ({ row }) => resolveReportTaskText(row.phonenumber) },
     { prop: 'checkerName', label: '审核人', minWidth: 120, render: ({ row }) => resolveReportTaskText(row.checkerName) },
     { prop: 'checkTime', label: '审核时间', minWidth: 120, render: ({ row }) => resolveReportTaskText(row.checkTime) },
@@ -201,7 +245,7 @@ const ensureReportTaskDictOptionsReady = async () => {
         }
     })
 
-    // 关键业务节点：检测公司和测试依据展示依赖字典缓存，需要在页面缺失时补载后再做 ID 到名称映射。
+    // 关键业务节点：检测公司和测试依据展示依赖字典缓存，缺失时必须先补齐再做 ID 到名称映射。
     dictStore.setDictData(Array.from(nextDictMap.values()))
 }
 
@@ -243,6 +287,10 @@ const ensureFormOptionsReady = async () => {
     }
 }
 
+const refreshFormOptions = async () => {
+    await ensureFormOptionsReady()
+}
+
 const getTableList = async (params: ReportTask.ReportTaskListParams = {}) => {
     const response = await listReportTasksApi(normalizeReportTaskListParams(params))
     const pageData = normalizeReportTaskPage<ReportTask.ReportTaskRecord>(
@@ -280,7 +328,7 @@ const openEditDialog = async (row: ReportTask.ReportTaskRecord) => {
     formMode.value = 'edit'
 
     try {
-        // 关键业务节点：编辑表单提交时依赖 clientUnitId、reportModelId、createUnit、standard 等原始值，不能只用列表展示字段回填。
+        // 关键业务节点：编辑表单提交仍依赖原始 clientUnitId、reportModelId、createUnit、standard 等字段，不能只回填列表展示文本。
         const response = await getReportTaskDetailApi(row.id)
         currentRecord.value = unwrapReportTaskPayload<ReportTask.ReportTaskRecord>(response)
         formDialogVisible.value = true
@@ -296,12 +344,18 @@ const openDetailDialog = async (row: ReportTask.ReportTaskRecord) => {
     }
 
     detailRecord.value = null
+    detailGroupReports.value = []
     detailDialogVisible.value = true
     detailLoading.value = true
 
     try {
-        const response = await getReportTaskDetailApi(row.id)
+        const [detailResponse, groupReportsResponse] = await Promise.all([
-        detailRecord.value = unwrapReportTaskPayload<ReportTask.ReportTaskRecord>(response)
+            getReportTaskDetailApi(row.id),
+            listReportTaskGroupReportsApi(row.id)
+        ])
+
+        detailRecord.value = unwrapReportTaskPayload<ReportTask.ReportTaskRecord>(detailResponse)
+        detailGroupReports.value = normalizeReportTaskGroupReportList(groupReportsResponse)
     } catch (error) {
         ElMessage.error(getReportTaskErrorMessage(error, '报告任务详情查询失败'))
     } finally {
@@ -323,6 +377,7 @@ const handleSaveReportTask = async (params: ReportTask.ReportTaskSaveRequest) =>
     formSaving.value = true
 
     try {
+        // 关键业务节点：文件校验与正式导入已在弹窗内完成，页面层这里只执行最终 add/update，整体顺序为 ledger/validate -> ledger/import -> add/update。
         if (formMode.value === 'create') {
             await createReportTaskApi(params)
             ElMessage.success('报告任务新增成功')
@@ -331,7 +386,7 @@ const handleSaveReportTask = async (params: ReportTask.ReportTaskSaveRequest) =>
             ElMessage.success('报告任务编辑成功')
         }
 
-        formDialogVisible.value = false
+        formSaveSuccessVersion.value += 1
         refreshReportTasks()
     } catch (error) {
         ElMessage.error(getReportTaskErrorMessage(error, '报告任务保存失败'))
@@ -400,11 +455,12 @@ const handleExport = async () => {
         ElMessage.error(getReportTaskErrorMessage(error, '报告任务导出失败'))
     }
 }
+
 onMounted(async () => {
     try {
         await ensureReportTaskDictOptionsReady()
     } catch (error) {
-        ElMessage.error(getReportTaskErrorMessage(error, '鎶ュ憡浠诲姟瀛楀吀鍔犺浇澶辫触'))
+        ElMessage.error(getReportTaskErrorMessage(error, '报告任务字典加载失败'))
     }
 })
 </script>

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,6 +1,54 @@
+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: '生成中',
+    2: '生成成功',
+    3: '生成失败'
+}
+export const REPORT_TASK_GROUP_REPORT_GENERATE_STATUS_TAG_TYPE_MAP: Record<
+    number,
+    'warning' | 'success' | 'danger' | undefined
+> = {
+        0: undefined,
+        1: 'warning',
+        2: 'success',
+        3: 'danger'
+    }
+
 export const resolveReportTaskText = (value: unknown) => {
     if (value === null || value === undefined) return '-'
 
@@ -18,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
     }
@@ -53,6 +102,216 @@ export const getReportTaskErrorMessage = (error: unknown, fallback: string) => {
     return fallback
 }
 
+export const isReportTaskExcelFileName = (fileName: string) => {
+    const normalizedName = String(fileName || '').trim().toLowerCase()
+    return TEST_REPORT_EXCEL_EXTENSIONS.some(extension => normalizedName.endsWith(extension))
+}
+
+export const isReportTaskWordFileName = (fileName: string) => {
+    const normalizedName = String(fileName || '').trim().toLowerCase()
+    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)
+
+export const normalizeReportTaskPointList = (
+    response: ResultData<ReportTask.ReportTaskPointRecord[]> | ReportTask.ReportTaskPointRecord[] | null | undefined
+) => {
+    const payload = unwrapReportTaskPayload<ReportTask.ReportTaskPointRecord[] | null | undefined>(
+        response as ResultData<ReportTask.ReportTaskPointRecord[]>
+    )
+
+    return Array.isArray(payload) ? payload : []
+}
+
+export const normalizeReportTaskLedgerImportResult = (
+    response:
+        | ResultData<ReportTask.ReportTaskLedgerImportResult>
+        | ReportTask.ReportTaskLedgerImportResult
+        | null
+        | undefined
+): ReportTask.ReportTaskLedgerImportResult => {
+    const payload = unwrapReportTaskPayload<ReportTask.ReportTaskLedgerImportResult | null | undefined>(
+        response as ResultData<ReportTask.ReportTaskLedgerImportResult>
+    )
+
+    const stageList = Array.isArray(payload?.stages) ? payload.stages : []
+
+    return {
+        batchId: payload?.batchId || undefined,
+        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,
+        deviceAddedCount: payload?.deviceAddedCount ?? 0,
+        deviceReuseCount: payload?.deviceReuseCount ?? 0,
+        clientAddedCount: payload?.clientAddedCount ?? 0,
+        clientReuseCount: payload?.clientReuseCount ?? 0,
+        groupCount: payload?.groupCount ?? 0,
+        failReasons: Array.isArray(payload?.failReasons) ? payload.failReasons.filter(Boolean) : [],
+        stages: stageList.map(stage => ({
+            stage: stage?.stage || undefined,
+            success: stage?.success ?? false,
+            message: stage?.message || ''
+        }))
+    }
+}
+
+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[]>
+        | ReportTask.ReportTaskGroupReportRecord[]
+        | null
+        | undefined
+) => {
+    const payload = unwrapReportTaskPayload<ReportTask.ReportTaskGroupReportRecord[] | null | undefined>(
+        response as ResultData<ReportTask.ReportTaskGroupReportRecord[]>
+    )
+
+    return Array.isArray(payload) ? payload : []
+}
+
+export const normalizeReportTaskLedgerSnapshot = (
+    value: string | ReportTask.ReportTaskLedgerImportSnapshot | null | undefined
+): ReportTask.ReportTaskLedgerImportSnapshot | null => {
+    if (!value) return null
+
+    const snapshot =
+        typeof value === 'string'
+            ? (() => {
+                  try {
+                      return JSON.parse(value) as ReportTask.ReportTaskLedgerImportSnapshot
+                  } catch {
+                      return null
+                  }
+              })()
+            : value
+
+    if (!snapshot || typeof snapshot !== 'object') return null
+
+    return {
+        version: snapshot.version || undefined,
+        importMode: snapshot.importMode || undefined,
+        summaryFileName: snapshot.summaryFileName || undefined,
+        sheetSummary: snapshot.sheetSummary
+            ? {
+                  pointSheet: snapshot.sheetSummary.pointSheet || undefined,
+                  deviceSheetPresent: snapshot.sheetSummary.deviceSheetPresent ?? false,
+                  clientSheetPresent: snapshot.sheetSummary.clientSheetPresent ?? false
+              }
+            : null,
+        rowCount: snapshot.rowCount ?? 0,
+        groupSummary: Array.isArray(snapshot.groupSummary)
+            ? snapshot.groupSummary.map(item => ({
+                  groupNo: item?.groupNo ?? null,
+                  count: item?.count ?? 0
+              }))
+            : [],
+        baseDataSummary: snapshot.baseDataSummary
+            ? {
+                  deviceAddedCount: snapshot.baseDataSummary.deviceAddedCount ?? 0,
+                  deviceReuseCount: snapshot.baseDataSummary.deviceReuseCount ?? 0,
+                  clientAddedCount: snapshot.baseDataSummary.clientAddedCount ?? 0,
+                  clientReuseCount: snapshot.baseDataSummary.clientReuseCount ?? 0
+              }
+            : null
+    }
+}
+
+export const resolveReportTaskGroupReportGenerateStateText = (value: number | null | undefined) => {
+    if (value === null || value === undefined) return '-'
+
+    return REPORT_TASK_GROUP_REPORT_GENERATE_STATUS_TEXT_MAP[value] || String(value)
+}
+
+export const resolveReportTaskGroupReportGenerateStateTagType = (value: number | null | undefined) => {
+    if (value === null || value === undefined) return undefined
+
+    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.pendingRevalidate)
+
 export const buildDictSelectOptions = (dictData: Dict[] = []) =>
     dictData
         .filter(item => item.id && item.name)
@@ -90,6 +349,57 @@ export const parseReportTaskStandardIds = (value?: string[] | string | null) =>
 export const stringifyReportTaskStandardIds = (value: string[]) =>
     value.map(item => String(item).trim()).filter(Boolean)
 
+export const normalizeReportTaskGroupSavePayload = (
+    pointList: ReportTask.ReportTaskPointRecord[],
+    pointGroupMap: Record<string, number | string | null | undefined>
+): ReportTask.ReportTaskGroupSaveRequest => {
+    const groupedPointMap = new Map<number, string[]>()
+
+    pointList.forEach(point => {
+        const pointId = String(point.id || '').trim()
+        if (!pointId) return
+
+        const rawGroupNo = pointGroupMap[pointId]
+        const groupNo = Number(rawGroupNo)
+        if (!Number.isInteger(groupNo) || groupNo <= 0) return
+
+        const groupPointIds = groupedPointMap.get(groupNo) || []
+        groupPointIds.push(pointId)
+        groupedPointMap.set(groupNo, groupPointIds)
+    })
+
+    return {
+        groups: Array.from(groupedPointMap.entries())
+            .sort(([groupNoA], [groupNoB]) => groupNoA - groupNoB)
+            .map(([groupNo, pointIds]) => ({
+                groupNo,
+                pointIds
+            }))
+    }
+}
+
+export const checkReportTaskGroupingCompleted = (
+    pointList: ReportTask.ReportTaskPointRecord[],
+    payload: ReportTask.ReportTaskGroupSaveRequest | null | undefined
+) => {
+    if (!pointList.length || !payload?.groups?.length) return false
+
+    const pointIds = pointList.map(point => String(point.id || '').trim()).filter(Boolean)
+    if (!pointIds.length) return false
+
+    const groupedIds = payload.groups.flatMap(group => group.pointIds.map(pointId => String(pointId || '').trim()).filter(Boolean))
+    if (groupedIds.length !== pointIds.length) return false
+
+    const uniqueGroupedIds = new Set(groupedIds)
+    if (uniqueGroupedIds.size !== pointIds.length) return false
+
+    const pointIdSet = new Set(pointIds)
+    const hasInvalidPointId = Array.from(uniqueGroupedIds).some(pointId => !pointIdSet.has(pointId))
+    if (hasInvalidPointId) return false
+
+    return payload.groups.every(group => Number.isInteger(group.groupNo) && group.groupNo > 0 && group.pointIds.length > 0)
+}
+
 export const resolveReportTaskCreateUnitText = (
     value: string | null | undefined,
     companyLabelMap: Record<string, string>

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'],
+                include: ['crypto']
-                globals: {
-                    crypto: true
-                }
             })
         ],
         // 基础配置