From b983c2ff9accc0f685bfc9e6aaa48a2d4281a18f Mon Sep 17 00:00:00 2001
From: yeg <1347747024@qq.com>
Date: 星期日, 06 九月 2026 17:58:22 +0800
Subject: [PATCH] 整理对比报表版本编辑验收后注释
---
battery-business/src/main/java/com/battery/business/report/CompareReportEditRequest.java | 2 +-
battery-business/src/main/java/com/battery/business/report/CompareReportService.java | 4 ++--
2 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/battery-business/src/main/java/com/battery/business/report/CompareReportEditRequest.java b/battery-business/src/main/java/com/battery/business/report/CompareReportEditRequest.java
index c5d9e5b..ca84e20 100644
--- a/battery-business/src/main/java/com/battery/business/report/CompareReportEditRequest.java
+++ b/battery-business/src/main/java/com/battery/business/report/CompareReportEditRequest.java
@@ -22,7 +22,7 @@
public void rejectUnknown(String field, Object value)
{ throw new ServiceException("报表编辑不允许提交字段：" + field); }
- /** 主动更新只携带已有基准和原因，来源范围由后端快照确定。 */
+ /** 主动更新只携带基准和原因，来源范围由后端确定；原因长度为系统追加的摘要前缀预留空间。 */
public record Refresh(@Positive int baseVersionNo, @NotBlank @Size(max = 480) String changeSummary)
{
/** 来源和测量不得由调用方替换。 */
diff --git a/battery-business/src/main/java/com/battery/business/report/CompareReportService.java b/battery-business/src/main/java/com/battery/business/report/CompareReportService.java
index f0bdf0b..91932f8 100644
--- a/battery-business/src/main/java/com/battery/business/report/CompareReportService.java
+++ b/battery-business/src/main/java/com/battery/business/report/CompareReportService.java
@@ -120,7 +120,7 @@
return result;
}
- /** 普通编辑追加展示版本，测量、来源身份和单位完全沿用基准快照。 */
+ /** 以最新版本为基准追加展示版本，测量、来源身份和单位完全沿用快照。 */
@Transactional(rollbackFor = Exception.class)
public Map<String, Object> edit(long id, CompareReportEditRequest request, long operatorId, String operatorName)
{
@@ -133,7 +133,7 @@
return get(id);
}
- /** 仅主动更新重读来源；人工表格值仍保留在设置中，不覆盖本次测量快照。 */
+ /** 基准必须为最新版本且来源仍有效；重读来源生成新快照，保留独立的人工表格值。 */
@Transactional(rollbackFor = Exception.class)
public Map<String, Object> refresh(long id, CompareReportEditRequest.Refresh request, long operatorId, String operatorName)
{
--
Gitblit v1.7.1