Refactor AdvowareAkte ↔ CDokumente relationship from junction table to direct n:1 relationship

- Removed CAdvowareAktenCDokumente junction table and associated service.
- Updated CDokumente entity to include foreign key cAdvowareAktenId and related fields.
- Changed relationship in CDokumente from hasMany to belongsTo.
- Updated CAdvowareAkten to reflect new direct relationship.
- Implemented CDokumente service with duplicateDocument method for document duplication.
- Refactored hooks to support new relationship and document propagation.
- Removed obsolete API routes related to the junction table.
- Added i18n translations for new fields and updated tooltips.
- Document flow and auto-linking logic enhanced for better integration with Advoware.
- Validation checks passed, and no data migration needed.

custom/Espo/Custom/Hooks/CAdvowareAkten/PropagateDocumentsUp.php

@@ -2,21 +2,19 @@
 namespace Espo\Custom\Hooks\CAdvowareAkten;
 
 use Espo\ORM\Entity;
-use Espo\Core\Hook\Hook\AfterRelate;
-use Espo\Core\Hook\Hook\AfterUnrelate;
+use Espo\Core\Hook\Hook\AfterSave;
 
 /**
- * Hook: Propagiert Dokumenten-Verknüpfungen von AdvowareAkten nach oben zu Räumungsklage/Mietinkasso
+ * Hook: Propagiert Dokumenten-Änderungen von AdvowareAkten nach oben zu Räumungsklage/Mietinkasso
+ * und auch zu AICollection
  * 
- * Wenn Dokument mit AdvowareAkten verknüpft wird:
+ * Wenn ein Dokument einer AdvowareAkte zugewiesen wird (via cAdvowareAktenId):
  * → verknüpfe mit verbundener Räumungsklage/Mietinkasso
- * → von dort propagiert es automatisch zu AIKnowledge (via deren Hooks)
+ * → verknüpfe mit AICollection
  * 
- * Wenn Dokument von AdvowareAkten entknüpft wird:
- * → entknüpfe von verbundener Räumungsklage/Mietinkasso
- * → von dort propagiert es automatisch von AIKnowledge (via deren Hooks)
+ * Improved logic: Works with direct belongsTo relationship (cAdvowareAktenId)
  */
-class PropagateDocumentsUp implements AfterRelate, AfterUnrelate
+class PropagateDocumentsUp implements AfterSave
 {
     private static array $processing = [];
     
@@ -24,94 +22,77 @@ class PropagateDocumentsUp implements AfterRelate, AfterUnrelate
         private \Espo\ORM\EntityManager $entityManager
     ) {}
     
-    public function afterRelate(
-        Entity $entity,
-        string $relationName,
-        Entity $foreignEntity,
-        array $columnData,
-        \Espo\ORM\Repository\Option\RelateOptions $options
-    ): void {
-        // Nur für dokumentes-Beziehung
-        if ($relationName !== 'dokumentes') {
+    public function afterSave(Entity $entity, \Espo\ORM\Repository\Option\SaveOptions $options): void
+    {
+        // Only process when cAdvowareAktenId changed
+        if (!$entity->isAttributeChanged('cAdvowareAktenId')) {
             return;
         }
         
+        $akteId = $entity->get('cAdvowareAktenId');
+        if (!$akteId) {
+            return; // Document was unlinked from Akte
+        }
+        
         // Vermeide Loops
-        $key = $entity->getId() . '-' . $foreignEntity->getId() . '-relate';
+        $key = $akteId . '-' . $entity->getId() . '-propagate';
         if (isset(self::$processing[$key])) {
             return;
         }
         self::$processing[$key] = true;
         
         try {
+            // Load AdvowareAkte
+            $akte = $this->entityManager->getEntity('CAdvowareAkten', $akteId);
+            if (!$akte) {
+                return;
+            }
+            
             // Prüfe ob Räumungsklage verknüpft ist
             $raumungsklage = $this->entityManager
                 ->getRDBRepository('CAdvowareAkten')
-                ->getRelation($entity, 'vmhRumungsklage')
+                ->getRelation($akte, 'vmhRumungsklage')
                 ->findOne();
             
             if ($raumungsklage) {
-                $this->relateDocument($raumungsklage, 'dokumentesvmhraumungsklage', $foreignEntity);
+                $this->relateDocument($raumungsklage, 'dokumentesvmhraumungsklage', $entity);
             }
             
             // Prüfe ob Mietinkasso verknüpft ist
             $mietinkasso = $this->entityManager
                 ->getRDBRepository('CAdvowareAkten')
-                ->getRelation($entity, 'mietinkasso')
+                ->getRelation($akte, 'mietinkasso')
                 ->findOne();
             
             if ($mietinkasso) {
-                $this->relateDocument($mietinkasso, 'dokumentesmietinkasso', $foreignEntity);
+                $this->relateDocument($mietinkasso, 'dokumentesmietinkasso', $entity);
             }
             
-        } catch (\Exception $e) {
-            $GLOBALS['log']->error('CAdvowareAkten PropagateDocumentsUp (relate) Error: ' . $e->getMessage());
-        } finally {
-            unset(self::$processing[$key]);
-        }
-    }
-    
-    public function afterUnrelate(
-        Entity $entity,
-        string $relationName,
-        Entity $foreignEntity,
-        \Espo\ORM\Repository\Option\UnrelateOptions $options
-    ): void {
-        // Nur für dokumentes-Beziehung
-        if ($relationName !== 'dokumentes') {
-            return;
-        }
-        
-        // Vermeide Loops
-        $key = $entity->getId() . '-' . $foreignEntity->getId() . '-unrelate';
-        if (isset(self::$processing[$key])) {
-            return;
-        }
-        self::$processing[$key] = true;
-        
-        try {
-            // Prüfe ob Räumungsklage verknüpft ist
-            $raumungsklage = $this->entityManager
-                ->getRDBRepository('CAdvowareAkten')
-                ->getRelation($entity, 'vmhRumungsklage')
-                ->findOne();
-            
+            // Also propagate to AICollection if Räumungsklage or Mietinkasso has one
             if ($raumungsklage) {
-                $this->unrelateDocument($raumungsklage, 'dokumentesvmhraumungsklage', $foreignEntity);
+                $aiKnowledge = $this->entityManager
+                    ->getRDBRepository('CVmhRumungsklage')
+                    ->getRelation($raumungsklage, 'aIKnowledge')
+                    ->findOne();
+                
+                if ($aiKnowledge) {
+                    $this->relateDocument($aiKnowledge, 'dokumentes', $entity);
+                }
             }
             
-            // Prüfe ob Mietinkasso verknüpft ist
-            $mietinkasso = $this->entityManager
-                ->getRDBRepository('CAdvowareAkten')
-                ->getRelation($entity, 'mietinkasso')
-                ->findOne();
-            
             if ($mietinkasso) {
-                $this->unrelateDocument($mietinkasso, 'dokumentesmietinkasso', $foreignEntity);
+                $aiKnowledge = $this->entityManager
+                    ->getRDBRepository('CMietinkasso')
+                    ->getRelation($mietinkasso, 'aIKnowledge')
+                    ->findOne();
+                
+                if ($aiKnowledge) {
+                    $this->relateDocument($aiKnowledge, 'dokumentes', $entity);
+                }
             }
             
         } catch (\Exception $e) {
-            $GLOBALS['log']->error('CAdvowareAkten PropagateDocumentsUp (unrelate) Error: ' . $e->getMessage());
+            $GLOBALS['log']->error('CAdvowareAkten PropagateDocumentsUp Error: ' . $e->getMessage());
         } finally {
             unset(self::$processing[$key]);
         }
@@ -134,22 +115,4 @@ class PropagateDocumentsUp implements AfterRelate, AfterUnrelate
             $relation->relate($document);
         }
     }
-    
-    /**
-     * Hilfsfunktion: Entknüpfe Dokument
-     */
-    private function unrelateDocument(Entity $parentEntity, string $relationName, Entity $document): void
-    {
-        $repository = $this->entityManager->getRDBRepository($parentEntity->getEntityType());
-        $relation = $repository->getRelation($parentEntity, $relationName);
-        
-        // Prüfe ob verknüpft
-        $isRelated = $relation
-            ->where(['id' => $document->getId()])
-            ->findOne();
-        
-        if ($isRelated) {
-            $relation->unrelate($document);
-        }
-    }
 }