feat(fleet): attach scoped evidence to measured trip records

file/src/main/java/com/baiyue/file/service/BusinessFileCategory.java

@@ -7,7 +7,8 @@ import java.util.Arrays;
 
 /** File-owned storage policy. Business visibility and lifecycle remain in the calling service. */
 enum BusinessFileCategory {
-    FLEET_DRIVER_LICENSE(false, FormatPolicy.LICENSE, Limits.STANDARD, BusinessIdPolicy.POSITIVE_LONG),
+    FLEET_DRIVER_LICENSE(false, FormatPolicy.PDF_IMAGE, Limits.STANDARD, BusinessIdPolicy.POSITIVE_LONG),
+    FLEET_TRIP_OPERATION_EVIDENCE(false, FormatPolicy.PDF_IMAGE, Limits.STANDARD, BusinessIdPolicy.POSITIVE_LONG),
     FLEET_VEHICLE_RECORD_PHOTO(false, FormatPolicy.IMAGE, Limits.STANDARD, BusinessIdPolicy.POSITIVE_LONG),
     DELIVERY_LOADING_PHOTO(true, FormatPolicy.ARBITRARY, Limits.CUSTOMS, BusinessIdPolicy.POSITIVE_LONG),
     DELIVERY_BOL(true, FormatPolicy.ARBITRARY, Limits.CUSTOMS, BusinessIdPolicy.POSITIVE_LONG),
@@ -62,6 +63,9 @@ enum BusinessFileCategory {
     }
 
     void validateOwner(long tenantId) {
+        if (this == FLEET_TRIP_OPERATION_EVIDENCE && tenantId != 0) {
+            throw new BizException(ResultCode.BAD_REQUEST, "出车实测凭证必须归属平台");
+        }
         if (this == FINANCE_VEHICLE_VOUCHER && tenantId != 0) {
             throw new BizException(ResultCode.BAD_REQUEST, "公司车辆付款凭证必须归属平台");
         }
@@ -105,7 +109,7 @@ enum BusinessFileCategory {
         return Long.toString(value);
     }
 
-    enum FormatPolicy { STANDARD, ARBITRARY, XLSX, PDF, LICENSE, IMAGE }
+    enum FormatPolicy { STANDARD, ARBITRARY, XLSX, PDF, PDF_IMAGE, IMAGE }
     private enum BusinessIdPolicy { POSITIVE_LONG, ORDER_BATCH_NO }
     private static final class Limits {
         private static final long STANDARD = 10L * 1024 * 1024;

file/src/main/java/com/baiyue/file/service/BusinessFileStorage.java

@@ -66,8 +66,8 @@ public class BusinessFileStorage {
         } else {
             if (formatPolicy == BusinessFileCategory.FormatPolicy.IMAGE && !java.util.Set.of("image/jpeg", "image/png").contains(type))
                   throw bad("图片附件仅支持JPG、PNG");
-            if (formatPolicy == BusinessFileCategory.FormatPolicy.LICENSE && !java.util.Set.of("application/pdf", "image/jpeg", "image/png").contains(type))
-                throw bad("驾驶证附件仅支持PDF、JPG、PNG");
+            if (formatPolicy == BusinessFileCategory.FormatPolicy.PDF_IMAGE && !java.util.Set.of("application/pdf", "image/jpeg", "image/png").contains(type))
+                throw bad("附件仅支持PDF、JPG、PNG");
             extension = TYPES.get(type);
             if (extension == null) throw bad("附件仅支持TXT、PDF、JPG、PNG");
             verifyContent(file, type);

file/src/main/resources/openapi/fleet-trip-operation-evidence-v1.yaml

@@ -0,0 +1,12 @@
+openapi: 3.0.3
+info:
+  title: 出车实测凭证归属契约
+  version: 1.0.0
+  description: >-
+    复用InternalBusinessFileController的内部业务文件上传、元数据和内容接口，不新增公网File路径。
+    businessType固定FLEET_TRIP_OPERATION_EVIDENCE，tenantId固定0，businessId固定Lastleg车次内部主键。
+    凭证为选填；上传时只接受非空PDF/JPG/PNG，最大10MiB，校验MIME与内容签名。
+    文件按平台、业务类型、车次及文件ID隔离；Lastleg持有当前/历史实测版本的附件引用及读写权限。
+    上传不自动保存实测记录，也不变更出车、库存、费用或签收事实；历史对象不硬删除。
+    Lastleg读取时先确认附件属于可见实测版本，再读取内容；不返回内部存储路径或匿名文件URL。
+paths: {}