From 23016079e01cd91d53f1255bd62b4e7b10a9450e Mon Sep 17 00:00:00 2001
From: yeg <1347747024@qq.com>
Date: 星期日, 06 九月 2026 17:16:20 +0800
Subject: [PATCH] 整理对比报表验收后注释

---
 src/views/ReportCompareForm.vue |    2 ++
 src/api/compareReports.ts       |    6 ++++++
 2 files changed, 8 insertions(+), 0 deletions(-)

diff --git a/src/api/compareReports.ts b/src/api/compareReports.ts
index 708f4db..d48f333 100644
--- a/src/api/compareReports.ts
+++ b/src/api/compareReports.ts
@@ -9,6 +9,7 @@
   createdAt: number
 }
 
+/** 读取授权用户可见的全部报表摘要,筛选和分页由现有列表处理。 */
 export async function listCompareReports() {
   return (await request<ApiResponse & { rows: CompareReportSummary[] }>('/system/compare-report/list')).rows
 }
@@ -60,23 +61,28 @@
   displayUnits: Record<string, string>
 }
 
+/** 按报表新增权限读取检测完成测试中的可选来源。 */
 export async function getCompareSources() {
   return (await request<ApiResponse & { data: CompareCandidate[] }>('/system/compare-report/sources')).data
 }
+/** 由后端校验所选范围并返回当前有效测量与业务字段。 */
 export async function previewCompareReport(selections: CompareSelection[]) {
   return (await request<ApiResponse & { data: CompareItem[] }>('/system/compare-report/preview', {
     method: 'POST', body: JSON.stringify(selections),
   })).data
 }
+/** 提交来源身份和展示设置;保存时由后端重读测量并生成独立首版。 */
 export async function createCompareReport(data: CreateCompareReport) {
   return (await request<ApiResponse & { data: SavedCompareReport }>('/system/compare-report', {
     method: 'POST', body: JSON.stringify(data),
   })).data
 }
+/** 读取已保存快照,不依赖来源测试仍存在或保持原值。 */
 export async function getCompareReport(id: number) {
   return (await request<ApiResponse & { data: SavedCompareReport }>(`/system/compare-report/${id}`)).data
 }
 
+/** 按完整所选范围区分比对项,同一电池的不同循环或工步不合并。 */
 export function compareSelectionKey(item: CompareSelection) {
   return `${item.testId}|${item.testBatteryId}|${item.cycleNo}|${item.stepNo ?? ''}|${item.logicalNo ?? ''}`
 }
diff --git a/src/views/ReportCompareForm.vue b/src/views/ReportCompareForm.vue
index 32b029f..5b9151d 100644
--- a/src/views/ReportCompareForm.vue
+++ b/src/views/ReportCompareForm.vue
@@ -124,6 +124,7 @@
 
 function metricValues(key: CompareMetricKey): Array<Array<[number, number | null]>> {
   const field: Record<CompareMetricKey, keyof PersistedTestRecord> = { voltage: 'voltage', current: 'current', positiveVoltage: 'positivePotential', negativeVoltage: 'negativePotential', temperature: 'temperature' }
+  // 各来源设备时间按比对项零点转为相对秒,测量仅在展示时换算毫单位,保留缺失值。
   return sourceItems.value.map(item => item.records.flatMap(row => {
     const time = key === 'voltage' || key === 'current' ? row.deviceTime : row.collectorDeviceTime
     if (time == null || item.zeroTime == null) return []
@@ -177,6 +178,7 @@
 }
 
 detailFields.value.forEach(ensureDetailFieldValues)
+// 搜索跳转和浏览器后退会复用详情组件,旧请求的结果不能覆盖新报表。
 watch(editingId, async (id, _previous, onCleanup) => {
   let cancelled = false
   onCleanup(() => { cancelled = true })

--
Gitblit v1.7.1