11

lib/common/models/api/user_api_models.dart

@@ -238,6 +238,36 @@ class ServiceFaceSyncSnapshot {
   Map<String, dynamic> toJson() => _$ServiceFaceSyncSnapshotToJson(this);
 }
 
+/// 终端批量删除服务端人脸后的幂等确认结果。
+@JsonSerializable()
+class ServiceTerminalFaceDeleteResult {
+  /// 本次实际逻辑删除的人脸样本编号。
+  final List<String> deletedSampleIds;
+
+  /// 请求前已经不存在的样本编号，本机可继续执行本地清理。
+  final List<String> alreadyAbsentSampleIds;
+
+  /// 创建一份服务端删除确认结果。
+  const ServiceTerminalFaceDeleteResult({
+    required this.deletedSampleIds,
+    required this.alreadyAbsentSampleIds,
+  });
+
+  /// 从统一网络层返回的 JSON 创建删除结果。
+  factory ServiceTerminalFaceDeleteResult.fromJson(Map<String, dynamic> json) =>
+      _$ServiceTerminalFaceDeleteResultFromJson(json);
+
+  /// 将删除结果转换为 JSON，主要供协议测试使用。
+  Map<String, dynamic> toJson() =>
+      _$ServiceTerminalFaceDeleteResultToJson(this);
+
+  /// 服务端允许本机清理的全部样本编号。
+  Set<String> get confirmedSampleIds => {
+        ...deletedSampleIds,
+        ...alreadyAbsentSampleIds,
+      };
+}
+
 @JsonSerializable()
 class ServiceTenant {
   /// id