打印日志优化

李曜臣
1 parent 76aa233f
Showing 3 changed files with 24 additions and 5 deletions
美国版/Food Labeling Management Code/Yi.Abp.Net8/module/food-labeling-us/FoodLabeling.Application.Contracts/Dtos/UsAppLabeling/PrintLogItemDto.cs
美国版/Food Labeling Management Code/Yi.Abp.Net8/module/food-labeling-us/FoodLabeling.Application/Services/UsAppLabelingAppService.cs
项目相关文档/标签模块接口对接说明.md
@@ -32,6 +32,9 @@ public class PrintLogItemDto
     /// <summary>模板尺寸（来自 fl_label_template.Width/Height/Unit）</summary>
     public string? LabelSizeText { get; set; }
+    /// <summary>本次任务落库的渲染模板 JSON（fl_label_print_task.RenderTemplateJson）</summary>
+    public string? RenderTemplateJson { get; set; }
+
     /// <summary>
     /// 本次打印的内容快照（来自 fl_label_print_data，按 PrintTaskId 关联）
     /// </summary>
@@ -774,6 +774,7 @@ public class UsAppLabelingAppService : ApplicationService, IUsAppLabelingAppServ
                 TemplateWidth = tpl.Width,
                 TemplateHeight = tpl.Height,
                 TemplateUnit = tpl.Unit,
+                t.RenderTemplateJson,
                 t.PrintedAt,
                 t.CreationTime
             });
@@ -826,6 +827,7 @@ public class UsAppLabelingAppService : ApplicationService, IUsAppLabelingAppServ
             ProductName = string.IsNullOrWhiteSpace(x.ProductName) ? "无" : x.ProductName.Trim(),
             TypeName = x.TypeName ?? string.Empty,
             LabelSizeText = FormatLabelSizeWithUnit(x.TemplateWidth, x.TemplateHeight, x.TemplateUnit),
+            RenderTemplateJson = x.RenderTemplateJson,
             PrintDataList = dataMap.TryGetValue(x.Id, out var list) ? list : new List<PrintLogDataItemDto>(),
             PrintedAt = x.PrintedAt ?? x.CreationTime,
             OperatorName = operatorName,
@@ -907,6 +907,7 @@ curl -X POST &quot;http://localhost:19001/api/app/us-app-labeling/preview&quot; \
 | `labelCode` | string | 是 | 标签编码（`fl_label.LabelCode`） |
 | `productId` | string | 否 | 打印用产品Id；不传则默认取该标签绑定的第一个产品（用于模板解析） |
 | `printQuantity` | number | 否 | 打印份数；`<=0` 按 1 处理 |
+| `clientRequestId` | string | 否 | 客户端幂等请求Id；同一个值重复调用会直接返回首次创建的 `batchId/taskIds`，避免重复写库 用法:前端/客户端每次点击 Print 生成一个稳定的 clientRequestId（比如 uuid） |
 | `baseTime` | string | 否 | 业务基准时间（用于 DATE/TIME 元素计算） |
 | `printInputJson` | object | 否 | 打印输入（用于模板 PRINT_INPUT 元素），key 建议与模板元素 `inputKey` 对齐 |
 | `printerId` | string | 否 | 打印机Id（可选，用于追踪） |
@@ -916,11 +917,11 @@ curl -X POST &quot;http://localhost:19001/api/app/us-app-labeling/preview&quot; \
 #### 数据落库说明
 - **任务表**：`fl_label_print_task`
-  - 插入 1 条任务记录（`locationId / labelCode / productId / labelTypeId / templateCode / printQuantity / baseTime / printer...` 等）。
+  - **一份打印 = 一条任务**：当 `printQuantity = N` 时，后端会插入 **N 条任务记录**（同一次点击 Print 共享一个 `BatchId`，并记录 `CopyIndex=1..N`）。
+  - 任务表会保存：本次打印的输入、命中的模板默认值、以及整份 resolved 后的模板快照 JSON，便于追溯/重打。
 - **明细表**：`fl_label_print_data`
-  - 按 `printQuantity` 插入 N 条明细记录（`copyIndex = 1..N`）。
-  - `printInputJson`：保存本次打印的原始输入（JSON 字符串）。
-  - `renderDataJson`：保存本次解析后的模板预览结构（`LabelTemplatePreviewDto`，包含 resolved 后的 `elements[].config`），供追溯/重打使用。
+  - **按组件写快照**：每个任务会按模板 `elements[]` 逐个插入明细记录（`ElementId/ElementName/RenderValue/RenderConfigJson`）。
+  - 适用于按组件维度审计/统计/追溯。
 > 模板解析的数据源来自 `fl_label_template` + `fl_label_template_element`，与预览接口一致。
@@ -928,8 +929,11 @@ curl -X POST &quot;http://localhost:19001/api/app/us-app-labeling/preview&quot; \
 | 字段 | 类型 | 说明 |
 |---|---|---|
-| `taskId` | string | 打印任务Id（用于后续查询/重打/统计） |
+| `taskId` | string | 第 1 份打印任务Id（兼容旧逻辑） |
 | `printQuantity` | number | 实际写入的份数 |
+| `batchId` | string | 本次点击 Print 的批次Id |
+| `taskIds` | string[] | 本次生成的所有任务Id（长度=printQuantity） |
+
 #### 错误与边界
@@ -1017,10 +1021,20 @@ curl -X POST &quot;http://localhost:19001/api/app/us-app-labeling/print&quot; \
 | `productName` | string | 产品名（来自 fl_product.ProductName；无则 “无”） |
 | `typeName` | string | 标签类型名称（来自 fl_label_type.TypeName） |
 | `labelSizeText` | string | 模板尺寸（宽高+单位，如 `2.00x2.00inch` / `6.00x4.00cm`） |
+| `renderTemplateJson` | string | 本次任务落库的渲染模板 JSON（`fl_label_print_task.RenderTemplateJson`） |
+| `printDataList` | PrintLogDataItemDto[] | 本次打印内容快照（来自 fl_label_print_data，按 taskId 关联） |
 | `printedAt` | string | 打印时间（PrintedAt ?? CreationTime） |
 | `operatorName` | string | 操作人姓名（当前登录账号 Name） |
 | `locationName` | string | 门店名称 |
+`PrintLogDataItemDto`：
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `elementId` | string | 模板组件Id（fl_label_print_data.ElementId） |
+| `renderValue` | string | 最终渲染值（fl_label_print_data.RenderValue） |
+| `renderConfigJson` | object | 最终渲染配置（fl_label_print_data.RenderConfigJson 反序列化） |
+
 #### curl
 ```bash