feat: enrich piece assignment labels and document previews

app/shared/modelUtils.ts

@@ -202,11 +202,27 @@ const sanitizePieces = (pieces: any[]): ComponentModelPiece[] => {
         ? piece.reference.trim()
         : undefined
 
-      if (!typePieceId && !typePieceLabel && !reference) {
+      const rawFamilyCode = typeof piece?.familyCode === 'string'
+        ? piece.familyCode.trim()
+        : typeof piece?.typePiece?.code === 'string'
+          ? piece.typePiece.code.trim()
+          : ''
+      const familyCode = rawFamilyCode.length > 0 ? rawFamilyCode : undefined
+
+      const rawRole = typeof piece?.role === 'string' ? piece.role.trim() : ''
+      const role = rawRole.length > 0 ? rawRole : undefined
+
+      if (!typePieceId && !typePieceLabel && !reference && !familyCode) {
         return null
       }
 
       const result: ComponentModelPiece = {}
+      if (role) {
+        result.role = role
+      }
+      if (familyCode) {
+        result.familyCode = familyCode
+      }
       if (reference !== undefined) {
         result.reference = reference
       }
@@ -519,6 +535,8 @@ const hydratePieces = (pieces: any[]): ComponentModelPiece[] => {
     typePieceId: piece?.typePieceId ?? piece?.typePiece?.id ?? '',
     typePieceLabel: piece?.typePieceLabel ?? piece?.typePiece?.name ?? '',
     reference: piece?.reference ?? '',
+    familyCode: piece?.familyCode ?? piece?.typePiece?.code ?? '',
+    role: piece?.role ?? '',
   }))
 }
 
@@ -590,6 +608,8 @@ const mapComponentPieces = (pieces: any[]): ComponentModelPiece[] => {
     reference: piece?.reference ?? '',
     typePieceId: piece?.typePieceId ?? piece?.typePiece?.id ?? '',
     typePieceLabel: piece?.typePieceLabel ?? piece?.typePiece?.name ?? '',
+    familyCode: piece?.familyCode ?? piece?.typePiece?.code ?? '',
+    role: piece?.role ?? '',
   }))
 }