Increase maxLength for advowareArt field in CDokumente metadata; update microtime values in config and state files

- Created localization JSON files for multiple languages (e.g., Danish, German, Greek, English, Spanish, etc.) for CAkten and CAktenCDokumente.
- Added layout configurations for CAkten, including detail views, side panels, and bottom panels.
- Implemented metadata definitions for CAkten, including field definitions, relationship panels, and scopes.
- Introduced new JSON files for managing document relationships and listing configurations.

application/Espo/Classes/FieldValidators/Common/Host/NotInternal.php

@@ -53,7 +53,7 @@ class NotInternal implements Validator
             return null;
         }
 
-        if (!$this->hostCheck->isNotInternalHost($value)) {
+        if (!$this->hostCheck->isHostAndNotInternal($value)) {
             return Failure::create();
         }
 

application/Espo/Classes/FieldValidators/Webhook/Url/NotInternal.php

@@ -62,7 +62,7 @@ class NotInternal implements Validator
             return null;
         }
 
-        if (!$this->urlCheck->isNotInternalUrl($value)) {
+        if (!$this->urlCheck->isUrlAndNotIternal($value)) {
             return Failure::create();
         }
 

application/Espo/Classes/MassAction/User/MassUpdate.php

@@ -178,7 +178,9 @@ class MassUpdate implements MassAction
 
     private function clearRoleCache(string $id): void
     {
-        $this->fileManager->removeFile('data/cache/application/acl/' . $id . '.php');
+        $part = basename($id);
+
+        $this->fileManager->removeFile("data/cache/application/acl/$part.php");
     }
 
     private function clearPortalRolesCache(): void

application/Espo/Classes/RecordHooks/CurrencyRecordRate/AfterDelete.php

@@ -32,6 +32,7 @@ namespace Espo\Classes\RecordHooks\CurrencyRecordRate;
 use Espo\Core\Exceptions\Conflict;
 use Espo\Core\Record\DeleteParams;
 use Espo\Core\Record\Hook\DeleteHook;
+use Espo\Core\Utils\Currency\DatabasePopulator;
 use Espo\Core\WebSocket\Submission;
 use Espo\Entities\CurrencyRecordRate;
 use Espo\ORM\Entity;
@@ -46,6 +47,7 @@ class AfterDelete implements DeleteHook
     public function __construct(
         private SyncManager $syncManager,
         private Submission $submission,
+        private DatabasePopulator $databasePopulator,
     ) {}
 
     public function process(Entity $entity, DeleteParams $params): void
@@ -58,6 +60,7 @@ class AfterDelete implements DeleteHook
             throw new Conflict($e->getMessage(), previous: $e);
         }
 
+        $this->databasePopulator->process();
         $this->submission->submit('appParamsUpdate');
     }
 }

application/Espo/Classes/RecordHooks/CurrencyRecordRate/AfterSave.php

@@ -31,6 +31,7 @@ namespace Espo\Classes\RecordHooks\CurrencyRecordRate;
 
 use Espo\Core\Exceptions\Conflict;
 use Espo\Core\Record\Hook\SaveHook;
+use Espo\Core\Utils\Currency\DatabasePopulator;
 use Espo\Core\WebSocket\Submission;
 use Espo\Entities\CurrencyRecordRate;
 use Espo\ORM\Entity;
@@ -45,6 +46,7 @@ class AfterSave implements SaveHook
     public function __construct(
         private SyncManager $syncManager,
         private Submission $submission,
+        private DatabasePopulator $databasePopulator,
     ) {}
 
     public function process(Entity $entity): void
@@ -57,6 +59,7 @@ class AfterSave implements SaveHook
             throw new Conflict($e->getMessage(), previous: $e);
         }
 
+        $this->databasePopulator->process();
         $this->submission->submit('appParamsUpdate');
     }
 }

application/Espo/Classes/RecordHooks/EmailAccount/BeforeSaveValidateHosts.php

@@ -76,7 +76,7 @@ class BeforeSaveValidateHosts implements SaveHook
             return;
         }
 
-        if (!$this->hostCheck->isNotInternalHost($host)) {
+        if (!$this->hostCheck->isHostAndNotInternal($host)) {
             $message = $this->composeErrorMessage($host, $address);
 
             throw new Forbidden($message);
@@ -97,7 +97,11 @@ class BeforeSaveValidateHosts implements SaveHook
 
         $address = $host . ':' . $port;
 
-        if (!$this->hostCheck->isNotInternalHost($host)) {
+        if (in_array($address, $this->getAllowedAddressList())) {
+            return;
+        }
+
+        if (!$this->hostCheck->isHostAndNotInternal($host)) {
             $message = $this->composeErrorMessage($host, $address);
 
             throw new Forbidden($message);

application/Espo/Classes/TemplateHelpers/MarkdownText.php

@@ -32,7 +32,7 @@ namespace Espo\Classes\TemplateHelpers;
 use Espo\Core\Htmlizer\Helper;
 use Espo\Core\Htmlizer\Helper\Data;
 use Espo\Core\Htmlizer\Helper\Result;
-use Michelf\MarkdownExtra as MarkdownTransformer;
+use Espo\Core\Utils\Markdown\Markdown;
 
 class MarkdownText implements Helper
 {
@@ -44,7 +44,7 @@ class MarkdownText implements Helper
             return Result::createEmpty();
         }
 
-        $transformed = MarkdownTransformer::defaultTransform($value);
+        $transformed = Markdown::transform($value);
 
         return Result::createSafeString($transformed);
     }

application/Espo/Core/Acl/Cache/Clearer.php

@@ -63,7 +63,7 @@ class Clearer
             return;
         }
 
-        $part = $user->getId() . '.php';
+        $part = basename($user->getId() . '.php');
 
         $this->fileManager->remove('data/cache/application/acl/' . $part);
         $this->fileManager->remove('data/cache/application/aclMap/' . $part);
@@ -77,7 +77,7 @@ class Clearer
             ->find();
 
         foreach ($portals as $portal) {
-            $part = $portal->getId() . '/' . $user->getId() . '.php';
+            $part = basename($portal->getId()) . '/' . basename($user->getId() . '.php');
 
             $this->fileManager->remove('data/cache/application/aclPortal/' . $part);
             $this->fileManager->remove('data/cache/application/aclPortalMap/' . $part);

application/Espo/Core/FileStorage/Storages/EspoUploadDir.php

@@ -115,7 +115,8 @@ class EspoUploadDir implements Storage, Local
     protected function getFilePath(Attachment $attachment)
     {
         $sourceId = $attachment->getSourceId();
+        $file = basename($sourceId);
 
-        return 'data/upload/' . $sourceId;
+        return 'data/upload/' . $file;
     }
 }

application/Espo/Core/Formula/Functions/ExtGroup/MarkdownGroup/TransformType.php

@@ -33,7 +33,7 @@ use Espo\Core\Formula\EvaluatedArgumentList;
 use Espo\Core\Formula\Exceptions\BadArgumentType;
 use Espo\Core\Formula\Exceptions\TooFewArguments;
 use Espo\Core\Formula\Func;
-use Michelf\Markdown;
+use Espo\Core\Utils\Markdown\Markdown;
 
 /**
  * @noinspection PhpUnused
@@ -52,6 +52,6 @@ class TransformType implements Func
             throw BadArgumentType::create(1, 'string');
         }
 
-        return Markdown::defaultTransform($string);
+        return Markdown::transform($string);
     }
 }

application/Espo/Core/Mail/Account/GroupAccount/Service.php

@@ -89,7 +89,7 @@ class Service
         if (
             $params->getHost() &&
             !$this->addressUtil->isAllowedAddress($params) &&
-            !$this->hostCheck->isNotInternalHost($params->getHost())
+            !$this->hostCheck->isHostAndNotInternal($params->getHost())
         ) {
             throw new Forbidden("Not allowed internal host.");
         }
@@ -124,7 +124,7 @@ class Service
         if (
             $params->getHost() &&
             !$this->addressUtil->isAllowedAddress($params) &&
-            !$this->hostCheck->isNotInternalHost($params->getHost())
+            !$this->hostCheck->isHostAndNotInternal($params->getHost())
         ) {
             throw new Forbidden("Not allowed internal host.");
         }

application/Espo/Core/Mail/Account/PersonalAccount/Service.php

@@ -103,7 +103,7 @@ class Service
         if (
             $params->getHost() &&
             !$this->addressUtil->isAllowedAddress($params) &&
-            !$this->hostCheck->isNotInternalHost($params->getHost())
+            !$this->hostCheck->isHostAndNotInternal($params->getHost())
         ) {
             throw new Forbidden("Not allowed internal host.");
         }
@@ -144,7 +144,7 @@ class Service
         if (
             $params->getHost() &&
             !$this->addressUtil->isAllowedAddress($params) &&
-            !$this->hostCheck->isNotInternalHost($params->getHost())
+            !$this->hostCheck->isHostAndNotInternal($params->getHost())
         ) {
             throw new Forbidden("Not allowed host.");
         }

application/Espo/Core/Portal/Api/Starter.php

@@ -49,7 +49,9 @@ class Starter extends StarterBase
         SystemConfig $systemConfig,
         ApplicationState $applicationState
     ) {
-        $routeCacheFile = 'data/cache/application/slim-routes-portal-' . $applicationState->getPortalId() . '.php';
+        $part = basename($applicationState->getPortalId());
+
+        $routeCacheFile = 'data/cache/application/slim-routes-portal-' . $part . '.php';
 
         parent::__construct(
             $requestProcessor,

application/Espo/Core/Utils/Markdown/Markdown.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify
@@ -27,26 +27,24 @@
  * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
  ************************************************************************/
 
-namespace Espo\Core\Utils\Database\Dbal\Platforms\Keywords;
+namespace Espo\Core\Utils\Markdown;
 
-use Doctrine\DBAL\Platforms\Keywords\MariaDBKeywords;
+use Michelf\Markdown as MarkdownParser;
 
 /**
- * 'LEAD' happened to be a reserved words on some environments.
+ * @internal
  */
-final class MariaDb102Keywords extends MariaDBKeywords
+class Markdown
 {
-    /** @deprecated */
+    /**
-    public function getName(): string
+     * @internal
+     */
+    public static function transform(string $text): string
     {
-        return 'MariaDb102';
+        $parser = new MarkdownParser();
-    }
+        $parser->no_markup = true;
+        $parser->no_entities = true;
 
-    protected function getKeywords(): array
+        return $parser->transform($text);
-    {
-        return [
-            ...parent::getKeywords(),
-            'LEAD',
-        ];
     }
 }

application/Espo/Core/Utils/Security/HostCheck.php

@@ -32,30 +32,35 @@ namespace Espo\Core\Utils\Security;
 use const DNS_A;
 use const FILTER_FLAG_NO_PRIV_RANGE;
 use const FILTER_FLAG_NO_RES_RANGE;
+use const FILTER_FLAG_HOSTNAME;
+use const FILTER_VALIDATE_DOMAIN;
 use const FILTER_VALIDATE_IP;
 
 class HostCheck
 {
-    public function isNotInternalHost(string $host): bool
+    /**
+     * Validates the string is a host and it's not internal.
+     * If not a host, returns false.
+     *
+     * @since 9.3.4
+     */
+    public function isHostAndNotInternal(string $host): bool
     {
-        $records = dns_get_record($host, DNS_A);
-
         if (filter_var($host, FILTER_VALIDATE_IP)) {
             return $this->ipAddressIsNotInternal($host);
         }
 
-        if (!$records) {
+        if (!$this->isDomainHost($host)) {
-            return true;
-        }
-
-        foreach ($records as $record) {
-            /** @var ?string $idAddress */
-            $idAddress = $record['ip'] ?? null;
-
-            if (!$idAddress) {
             return false;
         }
 
+        $ipAddresses = $this->getHostIpAddresses($host);
+
+        if ($ipAddresses === []) {
+            return false;
+        }
+
+        foreach ($ipAddresses as $idAddress) {
             if (!$this->ipAddressIsNotInternal($idAddress)) {
                 return false;
             }
@@ -64,7 +69,66 @@ class HostCheck
         return true;
     }
 
-    private function ipAddressIsNotInternal(string $ipAddress): bool
+    /**
+     * @internal
+     * @since 9.3.4
+     */
+    public function isDomainHost(string $host): bool
+    {
+        $normalized = $this->normalizeIpAddress($host);
+
+        if ($normalized !== false && filter_var($normalized, FILTER_VALIDATE_IP)) {
+            return false;
+        }
+
+        if (!filter_var($host, FILTER_VALIDATE_DOMAIN, FILTER_FLAG_HOSTNAME)) {
+            return false;
+        }
+
+        if (!$this->hasNoNumericItem($host)) {
+            return false;
+        }
+
+        if (filter_var($host, FILTER_VALIDATE_DOMAIN)) {
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * @return string[]
+     * @internal
+     * @since 9.3.4
+     */
+    public function getHostIpAddresses(string $host): array
+    {
+        $records = dns_get_record($host, DNS_A);
+
+        if (!$records) {
+            return [];
+        }
+
+        $output = [];
+
+        foreach ($records as $record) {
+            /** @var ?string $idAddress */
+            $idAddress = $record['ip'] ?? null;
+
+            if (!$idAddress) {
+                continue;
+            }
+
+            $output[] = $idAddress;
+        }
+
+        return $output;
+    }
+
+    /**
+     * @internal
+     */
+    public function ipAddressIsNotInternal(string $ipAddress): bool
     {
         return (bool) filter_var(
             $ipAddress,
@@ -72,4 +136,90 @@ class HostCheck
             FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE
         );
     }
+
+    /**
+     * @deprecated Since 9.3.4. Use `isHostAndNotInternal`.
+     * @todo Remove in 9.4.0.
+     */
+    public function isNotInternalHost(string $host): bool
+    {
+        return $this->isHostAndNotInternal($host);
+    }
+
+    private function normalizeIpAddress(string $ip): string|false
+    {
+        if (!str_contains($ip, '.')) {
+            return self::normalizePart($ip);
+        }
+
+        $parts = explode('.', $ip);
+
+        if (count($parts) !== 4) {
+            return false;
+        }
+
+        $result = [];
+
+        foreach ($parts as $part) {
+            if (preg_match('/^0x[0-9a-f]+$/i', $part)) {
+                $num = hexdec($part);
+            } else if (preg_match('/^0[0-7]+$/', $part) && $part !== '0') {
+                $num = octdec($part);
+            } else if (ctype_digit($part)) {
+                $num = (int)$part;
+            } else {
+                return false;
+            }
+
+            if ($num < 0 || $num > 255) {
+                return false;
+            }
+
+            $result[] = $num;
+        }
+
+        return implode('.', $result);
+    }
+
+    private static function normalizePart(string $ip): string|false
+    {
+        if (preg_match('/^0x[0-9a-f]+$/i', $ip)) {
+            $num = hexdec($ip);
+        } elseif (preg_match('/^0[0-7]+$/', $ip) && $ip !== '0') {
+            $num = octdec($ip);
+        } elseif (ctype_digit($ip)) {
+            $num = (int) $ip;
+        } else {
+            return false;
+        }
+
+        if ($num < 0 || $num > 0xFFFFFFFF) {
+            return false;
+        }
+
+        $num = (int) $num;
+
+        return long2ip($num);
+    }
+
+
+    private function hasNoNumericItem(string $host): bool
+    {
+        $hasNoNumeric = false;
+
+        foreach (explode('.', $host) as $it) {
+            if (!is_numeric($it) && !self::isHex($it)) {
+                $hasNoNumeric = true;
+
+                break;
+            }
+        }
+
+        return $hasNoNumeric;
+    }
+
+    private function isHex(string $value): bool
+    {
+        return preg_match('/^0x[0-9a-fA-F]+$/', $value) === 1;
+    }
 }

application/Espo/Core/Utils/Security/UrlCheck.php

@@ -29,9 +29,6 @@
 
 namespace Espo\Core\Utils\Security;
 
-use const FILTER_VALIDATE_URL;
-use const PHP_URL_HOST;
-
 class UrlCheck
 {
     public function __construct(
@@ -44,9 +41,11 @@ class UrlCheck
     }
 
     /**
-     * Checks whether a URL does not follow to an internal host.
+     * Checks whether it's a URL, and it does not follow to an internal host.
+     *
+     * @since 9.3.4
      */
-    public function isNotInternalUrl(string $url): bool
+    public function isUrlAndNotIternal(string $url): bool
     {
         if (!$this->isUrl($url)) {
             return false;
@@ -58,6 +57,118 @@ class UrlCheck
             return false;
         }
 
-        return $this->hostCheck->isNotInternalHost($host);
+        return $this->hostCheck->isHostAndNotInternal($host);
+    }
+
+    /**
+     * @return ?string[] Null if not a domain name or not a URL.
+     * @internal
+     * @since 9.3.4
+     */
+    public function getCurlResolve(string $url): ?array
+    {
+        if (!$this->isUrl($url)) {
+            return null;
+        }
+
+        $host = parse_url($url, PHP_URL_HOST);
+        $port = parse_url($url, PHP_URL_PORT);
+        $scheme = parse_url($url, PHP_URL_SCHEME);
+
+        if ($port === null && $scheme) {
+            $port = match (strtolower($scheme)) {
+                'http' => 80,
+                'https'=> 443,
+                'ftp' => 21,
+                'ssh' => 22,
+                'smtp' => 25,
+                default  => null,
+            };
+        }
+
+        if ($port === null) {
+            return [];
+        }
+
+        if (!is_string($host)) {
+            return null;
+        }
+
+        if (filter_var($host, FILTER_VALIDATE_IP)) {
+            return null;
+        }
+
+        if (!$this->hostCheck->isDomainHost($host)) {
+            return null;
+        }
+
+        $ipAddresses = $this->hostCheck->getHostIpAddresses($host);
+
+        $output = [];
+
+        foreach ($ipAddresses as $ipAddress) {
+            $ipPart = $ipAddress;
+
+            if (filter_var($ipAddress, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) {
+                $ipPart = "[$ipPart]";
+            }
+
+            $output[] = "$host:$port:$ipPart";
+        }
+
+        return $output;
+    }
+
+    /**
+     * @deprecated Since 9.3.4. Use `isUrlAndNotIternal`.
+     * @todo Remove in 9.5.0.
+     */
+    public function isNotInternalUrl(string $url): bool
+    {
+        return $this->isUrlAndNotIternal($url);
+    }
+
+    /**
+     * @param string[] $resolve
+     * @param string[] $allowed An allowed address list in the `{host}:{port}` format.
+     * @internal
+     */
+    public function validateCurlResolveNotInternal(array $resolve, array $allowed = []): bool
+    {
+        if ($resolve === []) {
+            return false;
+        }
+
+        $ipAddresses = [];
+
+        foreach ($resolve as $item) {
+            $arr = explode(':', $item, 3);
+
+            if (count($arr) < 3) {
+                return false;
+            }
+
+            $ipAddress = $arr[2];
+            $port = $arr[1];
+            $domain = $arr[0];
+
+            if (in_array("$ipAddress:$port", $allowed) || in_array("$domain:$port", $allowed)) {
+                return true;
+            }
+
+            if (str_starts_with($ipAddress, '[') && str_ends_with($ipAddress, ']')) {
+                $ipAddress = substr($ipAddress, 1, -1);
+            }
+
+            $ipAddresses[] = $ipAddress;
+        }
+
+        foreach ($ipAddresses as $ipAddress) {
+            if (!$this->hostCheck->ipAddressIsNotInternal($ipAddress)) {
+                return false;
+            }
+        }
+
+        return true;
     }
 }

application/Espo/Core/Utils/TemplateFileManager.php

@@ -124,7 +124,13 @@ class TemplateFileManager
         ?string $entityType = null
     ): string {
 
+        $type = basename($type);
+        $language = basename($language);
+        $name = basename($name);
+
         if ($entityType) {
+            $entityType = basename($entityType);
+
             return "custom/Espo/Custom/Resources/templates/{$type}/{$language}/{$entityType}/{$name}.tpl";
         }
 
@@ -152,7 +158,13 @@ class TemplateFileManager
         ?string $entityType = null
     ): string {
 
+        $type = basename($type);
+        $language = basename($language);
+        $name = basename($name);
+
         if ($entityType) {
+            $entityType = basename($entityType);
+
             return "templates/{$type}/{$language}/{$entityType}/{$name}.tpl";
         }
 

application/Espo/Core/Webhook/Sender.php

@@ -95,11 +95,24 @@ class Sender
 
         if (
             !$this->addressUtil->isAllowedUrl($url) &&
-            !$this->urlCheck->isNotInternalUrl($url)
+            !$this->urlCheck->isUrlAndNotIternal($url)
         ) {
             throw new Error("URL '$url' points to an internal host, not allowed.");
         }
 
+        $resolve = $this->urlCheck->getCurlResolve($url);
+
+        if ($resolve === []) {
+            throw new Error("Could not resolve the host.");
+        }
+
+        /** @var string[] $allowedAddressList */
+        $allowedAddressList = $this->config->get('webhookAllowedAddressList') ?? [];
+
+        if ($resolve !== null && !$this->urlCheck->validateCurlResolveNotInternal($resolve, $allowedAddressList)) {
+            throw new Error("Forbidden host.");
+        }
+
         $handler = curl_init($url);
 
         if ($handler === false) {
@@ -118,6 +131,10 @@ class Sender
         curl_setopt($handler, \CURLOPT_HTTPHEADER, $headerList);
         curl_setopt($handler, \CURLOPT_POSTFIELDS, $payload);
 
+        if ($resolve) {
+            curl_setopt($handler, CURLOPT_RESOLVE, $resolve);
+        }
+
         curl_exec($handler);
 
         $code = curl_getinfo($handler, \CURLINFO_HTTP_CODE);

application/Espo/EntryPoints/Attachment.php

@@ -95,7 +95,7 @@ class Attachment implements EntryPoint
         $response
             ->setHeader('Content-Length', (string) $size)
             ->setHeader('Cache-Control', 'private, max-age=864000, immutable')
-            ->setHeader('Content-Security-Policy', "default-src 'self'")
+            ->setHeader('Content-Security-Policy', "default-src 'self'; script-src 'none'; object-src 'none';")
             ->setBody($stream);
     }
 

application/Espo/EntryPoints/Download.php

@@ -87,7 +87,7 @@ class Download implements EntryPoint
         if (in_array($type, $inlineMimeTypeList)) {
             $disposition = 'inline';
 
-            $response->setHeader('Content-Security-Policy', "default-src 'self'");
+            $response->setHeader('Content-Security-Policy', "default-src 'self'; script-src 'none'; object-src 'none';");
         }
 
         $response->setHeader('Content-Description', 'File Transfer');

application/Espo/EntryPoints/Image.php

@@ -153,7 +153,7 @@ class Image implements EntryPoint
         $response
             ->setHeader('Content-Disposition', 'inline;filename="' . $fileName . '"')
             ->setHeader('Content-Length', (string) $fileSize)
-            ->setHeader('Content-Security-Policy', "default-src 'self'");
+            ->setHeader('Content-Security-Policy', "default-src 'self'; script-src 'none'; object-src 'none';");
 
         if (!$noCacheHeaders) {
             $response->setHeader('Cache-Control', 'private, max-age=864000, immutable');
@@ -174,7 +174,9 @@ class Image implements EntryPoint
 
         $sourceId = $attachment->getSourceId();
 
-        $cacheFilePath = "data/upload/thumbs/{$sourceId}_$size";
+        $file = basename("{$sourceId}_$size");
+
+        $cacheFilePath = "data/upload/thumbs/$file";
 
         if ($useCache && $this->fileManager->isFile($cacheFilePath)) {
             return $this->fileManager->getContents($cacheFilePath);

application/Espo/Hooks/Attachment/RemoveFile.php

@@ -89,7 +89,9 @@ class RemoveFile implements AfterRemove
         $sizeList = array_keys($this->metadata->get(['app', 'image', 'sizes']) ?? []);
 
         foreach ($sizeList as $size) {
-            $filePath = "data/upload/thumbs/{$entity->getSourceId()}_{$size}";
+            $file = basename("{$entity->getSourceId()}_$size");
+
+            $filePath = "data/upload/thumbs/$file";
 
             if ($this->fileManager->isFile($filePath)) {
                 $this->fileManager->removeFile($filePath);

application/Espo/Resources/i18n/cs_CZ/Admin.json

@@ -252,9 +252,9 @@
     "upgradeVersion": "EspoCRM bude upgradováno na verzi <strong>{version}</strong>. Toto může chvíli trvat.",
     "upgradeDone": "EspoCRM bylo upgradováno na verzi <strong>{version}</strong>.",
     "downloadUpgradePackage": "Stáhnout upgradovací balíčky na [tomto]({url}) odkaze.",
-    "upgradeInfo": "Přečtěte si [dokumentaci]({url}) o tom, jak upgradovat instanci AutoCRM.",
+    "upgradeInfo": "Přečtěte si [dokumentaci]({url}) o tom, jak upgradovat instanci EspoCRM.",
     "upgradeRecommendation": "Tento způsob upgradu se nedoporučuje. Je lepší upgradovat z CLI.",
-    "newVersionIsAvailable": "K dispozici je nová verze AutoCRM {latestVersion}. Při aktualizaci instance postupujte podle [pokynů](https://www.espocrm.com/documentation/administration/upgrading/).",
+    "newVersionIsAvailable": "K dispozici je nová verze EspoCRM {latestVersion}. Při aktualizaci instance postupujte podle [pokynů](https://www.espocrm.com/documentation/administration/upgrading/).",
     "formulaFunctions": "Funkce formula skriptů",
     "rebuildRequired": "Musíte spustit znovu rebuild z CLI.",
     "cronIsDisabled": "Cron je zakázán",
@@ -293,7 +293,7 @@
     "authLog": "Historie přihlášení.",
     "attachments": "Všechny přílohy souborů uložené v systému.",
     "templateManager": "Přizpůsobte si šablony zpráv.",
-    "systemRequirements": "Systémové požadavky na AutoCRM.",
+    "systemRequirements": "Systémové požadavky na EspoCRM.",
     "apiUsers": "Oddělte uživatele pro účely integrace.",
     "jobs": "Spustit akce na pozadí.",
     "pdfTemplates": "Šablony pro tisk do PDF.",

application/Espo/Resources/i18n/cs_CZ/Global.json

@@ -168,7 +168,7 @@
     "Search": "Hledat",
     "Only My": "Pouze moje",
     "Open": "Otevřený",
-    "About": "O AutoCRM",
+    "About": "O EspoCRM",
     "Refresh": "Obnovit",
     "Remove": "Odebrat",
     "Options": "Možnosti",

application/Espo/Resources/i18n/cs_CZ/Settings.json

@@ -186,18 +186,18 @@
     "ldapBaseDn": "Výchozí základní DN používané pro vyhledávání uživatelů. Např. \"OU = uživatelé, OU = espocrm, DC = test, DC = lan\".",
     "ldapTryUsernameSplit": "Možnost rozdělit uživatelské jméno na doménu.",
     "ldapOptReferrals": "pokud by měla být sledována doporučení klientovi LDAP.",
-    "ldapCreateEspoUser": "Tato možnost umožňuje AutoCRM vytvořit uživatele z LDAP.",
+    "ldapCreateEspoUser": "Tato možnost umožňuje EspoCRM vytvořit uživatele z LDAP.",
     "ldapUserFirstNameAttribute": "Atribut LDAP, který se používá k určení křestního jména uživatele. Např. \"křestní jméno\".",
     "ldapUserLastNameAttribute": "Atribut LDAP, který se používá k určení příjmení uživatele. Např. \"sn\".",
     "ldapUserTitleAttribute": "LDAP atribut pro titul uživatele.",
     "ldapUserEmailAddressAttribute": "Atribut LDAP, který se používá k určení e-mailové adresy uživatele. Např. \"pošta\".",
     "ldapUserPhoneNumberAttribute": "LDAP atribut pro telefonní číslo uživatele.",
-    "ldapUserLoginFilter": "Filtr, který umožňuje omezit uživatele, kteří mohou používat AutoCRM. Např. \"memberOf = CN = espoGroup, OU = groups, OU = espocrm, DC = test, DC = lan\".",
+    "ldapUserLoginFilter": "Filtr, který umožňuje omezit uživatele, kteří mohou používat EspoCRM. Např. \"memberOf = CN = espoGroup, OU = groups, OU = espocrm, DC = test, DC = lan\".",
     "ldapAccountDomainName": "Doména, která se používá k autorizaci k serveru LDAP.",
     "ldapAccountDomainNameShort": "Krátká doména, která se používá k autorizaci k serveru LDAP.",
     "ldapUserTeams": "LDAP týmy pro uživatele.",
     "ldapUserDefaultTeam": "Výchozí tým pro vytvořeného uživatele. Další informace najdete v uživatelském profilu.",
-    "b2cMode": "Ve výchozím nastavení je AutoCRM přizpůsoben pro B2B. Můžete jej přepnout na B2C.",
+    "b2cMode": "Ve výchozím nastavení je EspoCRM přizpůsoben pro B2B. Můžete jej přepnout na B2C.",
     "aclStrictMode": "Povoleno: Přístup k rozsahům bude zakázán, pokud není uveden v rolích. \nZakázán: Přístup k rozsahům bude povolen, pokud není uveden v rolích.",
     "outboundEmailIsShared": "Povolit posílání emailů uživatelům pomocí SMTP.",
     "streamEmailNotificationsEntityList": "Emailová upozornění na aktualizace streamu sledovaných záznamů. Uživatelé budou dostávat e-mailová oznámení pouze pro určené typy entit.",

application/Espo/Tools/Attachment/UploadUrlService.php

@@ -72,7 +72,7 @@ class UploadUrlService
      */
     public function uploadImage(string $url, FieldData $data): Attachment
     {
-        if (!$this->urlCheck->isNotInternalUrl($url)) {
+        if (!$this->urlCheck->isUrlAndNotIternal($url)) {
             throw new ForbiddenSilent("Not allowed URL.");
         }
 
@@ -114,9 +114,20 @@ class UploadUrlService
     /**
      * @param non-empty-string $url
      * @return ?array{string, string} A type and contents.
+     * @throws ForbiddenSilent
      */
     private function getImageDataByUrl(string $url): ?array
     {
+        $resolve = $this->urlCheck->getCurlResolve($url);
+
+        if ($resolve === []) {
+            throw new ForbiddenSilent("Could not resolve the host.");
+        }
+
+        if ($resolve !== null && !$this->urlCheck->validateCurlResolveNotInternal($resolve)) {
+            throw new ForbiddenSilent("Forbidden host.");
+        }
+
         $type = null;
 
         if (!function_exists('curl_init')) {
@@ -144,6 +155,10 @@ class UploadUrlService
         $opts[\CURLOPT_PROTOCOLS] = \CURLPROTO_HTTPS | \CURLPROTO_HTTP;
         $opts[\CURLOPT_REDIR_PROTOCOLS] = \CURLPROTO_HTTPS;
 
+        if ($resolve) {
+            $opts[CURLOPT_RESOLVE] = $resolve;
+        }
+
         $ch = curl_init();
 
         curl_setopt_array($ch, $opts);

application/Espo/Tools/Email/Api/PostImportEml.php

@@ -36,8 +36,11 @@ use Espo\Core\Api\Response;
 use Espo\Core\Api\ResponseComposer;
 use Espo\Core\Exceptions\BadRequest;
 use Espo\Core\Exceptions\Forbidden;
+use Espo\Core\Exceptions\NotFound;
+use Espo\Entities\Attachment;
 use Espo\Entities\Email;
 use Espo\Entities\User;
+use Espo\ORM\EntityManager;
 use Espo\Tools\Email\ImportEmlService;
 
 /**
@@ -49,6 +52,7 @@ class PostImportEml implements Action
         private Acl $acl,
         private User $user,
         private ImportEmlService $service,
+        private EntityManager $entityManager,
     ) {}
 
     public function process(Request $request): Response
@@ -61,11 +65,32 @@ class PostImportEml implements Action
             throw new BadRequest("No 'fileId'.");
         }
 
-        $email = $this->service->import($fileId, $this->user->getId());
+        $attachment = $this->getAttachment($fileId);
+
+        $email = $this->service->import($attachment, $this->user->getId());
 
         return ResponseComposer::json(['id' => $email->getId()]);
     }
 
+    /**
+     * @throws NotFound
+     * @throws Forbidden
+     */
+    private function getAttachment(string $fileId): Attachment
+    {
+        $attachment = $this->entityManager->getRDBRepositoryByClass(Attachment::class)->getById($fileId);
+
+        if (!$attachment) {
+            throw new NotFound("Attachment not found.");
+        }
+
+        if (!$this->acl->checkEntityRead($attachment)) {
+            throw new Forbidden("No access to attachment.");
+        }
+
+        return $attachment;
+    }
+
     /**
      * @throws Forbidden
      */

application/Espo/Tools/Email/Api/PostSendTest.php

@@ -115,7 +115,7 @@ class PostSendTest implements Action
 
         if (
             !$this->addressUtil->isAllowedAddress($smtpParams) &&
-            !$this->hostCheck->isNotInternalHost($server)
+            !$this->hostCheck->isHostAndNotInternal($server)
         ) {
             throw new Forbidden("Not allowed internal host.");
         }

application/Espo/Tools/Email/ImportEmlService.php

@@ -31,7 +31,6 @@ namespace Espo\Tools\Email;
 
 use Espo\Core\Exceptions\Conflict;
 use Espo\Core\Exceptions\Error;
-use Espo\Core\Exceptions\NotFound;
 use Espo\Core\FileStorage\Manager;
 use Espo\Core\Mail\Exceptions\ImapError;
 use Espo\Core\Mail\Importer;
@@ -56,16 +55,13 @@ class ImportEmlService
     /**
      * Import an EML.
      *
-     * @param string $fileId An attachment ID.
      * @param ?string $userId A user ID to relate an email with.
      * @return Email An Email.
-     * @throws NotFound
      * @throws Error
      * @throws Conflict
      */
-    public function import(string $fileId, ?string $userId = null): Email
+    public function import(Attachment $attachment, ?string $userId = null): Email
     {
-        $attachment = $this->getAttachment($fileId);
         $contents = $this->fileStorageManager->getContents($attachment);
 
         try {
@@ -93,20 +89,6 @@ class ImportEmlService
         return $email;
     }
 
-    /**
-     * @throws NotFound
-     */
-    private function getAttachment(string $fileId): Attachment
-    {
-        $attachment = $this->entityManager->getRDBRepositoryByClass(Attachment::class)->getById($fileId);
-
-        if (!$attachment) {
-            throw new NotFound("Attachment not found.");
-        }
-
-        return $attachment;
-    }
-
     /**
      * @throws Conflict
      */

application/Espo/Tools/EmailNotification/Processor.php

@@ -36,6 +36,7 @@ use Espo\Core\Notification\EmailNotificationHandler;
 use Espo\Core\Mail\SenderParams;
 use Espo\Core\Utils\Config\ApplicationConfig;
 use Espo\Core\Utils\DateTime as DateTimeUtil;
+use Espo\Core\Utils\Markdown\Markdown;
 use Espo\Entities\Note;
 use Espo\ORM\Collection;
 use Espo\Repositories\Portal as PortalRepository;
@@ -58,8 +59,6 @@ use Espo\Core\Utils\TemplateFileManager;
 use Espo\Core\Utils\Util;
 use Espo\Tools\Stream\NoteAccessControl;
 
-use Michelf\Markdown;
-
 use Exception;
 use DateTime;
 use Throwable;
@@ -325,11 +324,10 @@ class Processor
 
         $data['userName'] = $note->get('createdByName');
 
-        $post = Markdown::defaultTransform(
+        $post = $note->getPost() ?? '';
-            $note->get('post') ?? ''
-        );
 
-        $data['post'] = $post;
+
+        $data['post'] = Markdown::transform($post);
 
         $subjectTpl = $this->templateFileManager->getTemplate('mention', 'subject');
         $bodyTpl = $this->templateFileManager->getTemplate('mention', 'body');
@@ -486,9 +484,7 @@ class Processor
 
         $data['userName'] = $note->get('createdByName');
 
-        $post = Markdown::defaultTransform($note->getPost() ?? '');
+        $data['post'] = Markdown::transform($note->getPost() ?? '');
-
-        $data['post'] = $post;
 
         $parent = null;
 

application/Espo/Tools/Stream/RecordService.php

@@ -141,7 +141,7 @@ class RecordService
         ];
 
         if ($this->user->isPortal()) {
-            $where[] = ['isInternal' => true];
+            $where[] = ['isInternal' => false];
         }
 
         $this->applyPortalAccess($builder, $where);

client/lib/espo-timeline.js

@@ -1,4 +1,4 @@
-/*! espocrm 2026-03-06 */
+/*! espocrm 2026-03-24 */
 define("modules/crm/views/scheduler/scheduler",["exports","view","vis-data","vis-timeline","moment","jquery"],function(t,e,a,s,n,r){Object.defineProperty(t,"__esModule",{value:!0});t.default=void 0;e=i(e);n=i(n);r=i(r);function i(t){return t&&t.__esModule?t:{default:t}}class o extends e.default{templateContent=`
         <div class="timeline"></div>
         <link href="{{basePath}}client/modules/crm/css/vis.css" rel="stylesheet">

custom/Espo/Custom/Api/JunctionData/GetDokumentes.php

@@ -0,0 +1,71 @@
+<?php
+
+namespace Espo\Custom\Api\JunctionData;
+
+use Espo\Core\Api\Action;
+use Espo\Core\Api\Request;
+use Espo\Core\Api\Response;
+use Espo\Core\Api\ResponseComposer;
+use Espo\Core\Exceptions\BadRequest;
+use Espo\Core\Exceptions\NotFound;
+use Espo\ORM\EntityManager;
+
+/**
+ * GET /api/v1/JunctionData/CAIKnowledge/:knowledgeId/dokumentes
+ * 
+ * Returns all documents linked to a knowledge entry with junction table data
+ */
+class GetDokumentes implements Action
+{
+    public function __construct(
+        private EntityManager $entityManager
+    ) {}
+    
+    public function process(Request $request): Response
+    {
+        $knowledgeId = $request->getRouteParam('knowledgeId');
+        
+        if (!$knowledgeId) {
+            throw new BadRequest('Knowledge ID is required');
+        }
+        
+        // Verify knowledge exists
+        $knowledge = $this->entityManager->getEntityById('CAIKnowledge', $knowledgeId);
+        if (!$knowledge) {
+            throw new NotFound('Knowledge entry not found');
+        }
+        
+        $pdo = $this->entityManager->getPDO();
+        
+        $sql = "
+            SELECT 
+                j.id as junctionId,
+                j.c_a_i_knowledge_id as cAIKnowledgeId,
+                j.c_dokumente_id as cDokumenteId,
+                j.ai_document_id as aiDocumentId,
+                j.syncstatus,
+                j.last_sync as lastSync,
+                d.id as documentId,
+                d.name as documentName,
+                d.blake3hash as blake3hash,
+                d.created_at as documentCreatedAt,
+                d.modified_at as documentModifiedAt
+            FROM c_a_i_knowledge_dokumente j
+            INNER JOIN c_dokumente d ON j.c_dokumente_id = d.id
+            WHERE j.c_a_i_knowledge_id = :knowledgeId
+              AND j.deleted = 0
+              AND d.deleted = 0
+            ORDER BY j.id DESC
+        ";
+        
+        $sth = $pdo->prepare($sql);
+        $sth->execute(['knowledgeId' => $knowledgeId]);
+        
+        $results = $sth->fetchAll(\PDO::FETCH_ASSOC);
+        
+        return ResponseComposer::json([
+            'total' => count($results),
+            'list' => $results
+        ]);
+    }
+}

custom/Espo/Custom/Api/JunctionData/LinkDokument.php

@@ -0,0 +1,178 @@
+<?php
+
+namespace Espo\Custom\Api\JunctionData;
+
+use Espo\Core\Api\Action;
+use Espo\Core\Api\Request;
+use Espo\Core\Api\Response;
+use Espo\Core\Api\ResponseComposer;
+use Espo\Core\Exceptions\BadRequest;
+use Espo\Core\Exceptions\NotFound;
+use Espo\Core\Exceptions\Conflict;
+use Espo\ORM\EntityManager;
+
+/**
+ * POST /api/v1/JunctionData/CAIKnowledge/:knowledgeId/dokumentes/:documentId
+ * 
+ * Creates or updates relationship with junction table data
+ * This endpoint links the entities AND sets junction columns in one call
+ */
+class LinkDokument implements Action
+{
+    public function __construct(
+        private EntityManager $entityManager
+    ) {}
+    
+    public function process(Request $request): Response
+    {
+        $knowledgeId = $request->getRouteParam('knowledgeId');
+        $documentId = $request->getRouteParam('documentId');
+        $data = $request->getParsedBody();
+        
+        if (!$knowledgeId || !$documentId) {
+            throw new BadRequest('Knowledge ID and Document ID are required');
+        }
+        
+        // Verify entities exist
+        $knowledge = $this->entityManager->getEntityById('CAIKnowledge', $knowledgeId);
+        if (!$knowledge) {
+            throw new NotFound('Knowledge entry not found');
+        }
+        
+        $document = $this->entityManager->getEntityById('CDokumente', $documentId);
+        if (!$document) {
+            throw new NotFound('Document not found');
+        }
+        
+        $pdo = $this->entityManager->getPDO();
+        
+        // Check if link already exists
+        $existing = $this->checkIfLinked($knowledgeId, $documentId);
+        
+        if ($existing) {
+            // Link exists - update junction columns
+            return $this->updateExisting($knowledgeId, $documentId, $data);
+        }
+        
+        // Create new link via ORM (triggers hooks like DokumenteSyncStatus)
+        $this->entityManager->getRDBRepository('CAIKnowledge')
+            ->getRelation($knowledge, 'dokumentes')
+            ->relate($document);
+        
+        // Now set junction columns if provided
+        if (!empty((array)$data)) {
+            return $this->updateExisting($knowledgeId, $documentId, $data);
+        }
+        
+        // Return created entry
+        $result = $this->getJunctionEntry($knowledgeId, $documentId);
+        
+        return ResponseComposer::json($result);
+    }
+    
+    private function checkIfLinked(string $knowledgeId, string $documentId): bool
+    {
+        $pdo = $this->entityManager->getPDO();
+        
+        $sql = "
+            SELECT COUNT(*) as count
+            FROM c_a_i_knowledge_dokumente
+            WHERE c_a_i_knowledge_id = :knowledgeId
+              AND c_dokumente_id = :documentId
+              AND deleted = 0
+        ";
+        
+        $sth = $pdo->prepare($sql);
+        $sth->execute([
+            'knowledgeId' => $knowledgeId,
+            'documentId' => $documentId
+        ]);
+        
+        $result = $sth->fetch(\PDO::FETCH_ASSOC);
+        return $result['count'] > 0;
+    }
+    
+    private function updateExisting(string $knowledgeId, string $documentId, \stdClass $data): Response
+    {
+        $pdo = $this->entityManager->getPDO();
+        
+        // Build dynamic UPDATE SET clause
+        $setClauses = [];
+        $params = [
+            'knowledgeId' => $knowledgeId,
+            'documentId' => $documentId
+        ];
+        
+        if (isset($data->aiDocumentId)) {
+            $setClauses[] = "ai_document_id = :aiDocumentId";
+            $params['aiDocumentId'] = $data->aiDocumentId;
+        }
+        
+        if (isset($data->syncstatus)) {
+            $allowedStatuses = ['new', 'unclean', 'synced', 'failed', 'unsupported'];
+            if (!in_array($data->syncstatus, $allowedStatuses)) {
+                throw new BadRequest('Invalid syncstatus value. Allowed: ' . implode(', ', $allowedStatuses));
+            }
+            $setClauses[] = "syncstatus = :syncstatus";
+            $params['syncstatus'] = $data->syncstatus;
+        }
+        
+        if (isset($data->lastSync)) {
+            $setClauses[] = "last_sync = :lastSync";
+            $params['lastSync'] = $data->lastSync;
+        } elseif (isset($data->updateLastSync) && $data->updateLastSync === true) {
+            $setClauses[] = "last_sync = NOW()";
+        }
+        
+        if (!empty($setClauses)) {
+            $sql = "
+                UPDATE c_a_i_knowledge_dokumente
+                SET " . implode(', ', $setClauses) . "
+                WHERE c_a_i_knowledge_id = :knowledgeId
+                  AND c_dokumente_id = :documentId
+                  AND deleted = 0
+            ";
+            
+            $sth = $pdo->prepare($sql);
+            $sth->execute($params);
+        }
+        
+        // Return updated data
+        $result = $this->getJunctionEntry($knowledgeId, $documentId);
+        
+        return ResponseComposer::json($result);
+    }
+    
+    private function getJunctionEntry(string $knowledgeId, string $documentId): array
+    {
+        $pdo = $this->entityManager->getPDO();
+        
+        $sql = "
+            SELECT 
+                id as junctionId,
+                c_a_i_knowledge_id as cAIKnowledgeId,
+                c_dokumente_id as cDokumenteId,
+                ai_document_id as aiDocumentId,
+                syncstatus,
+                last_sync as lastSync
+            FROM c_a_i_knowledge_dokumente
+            WHERE c_a_i_knowledge_id = :knowledgeId
+              AND c_dokumente_id = :documentId
+              AND deleted = 0
+        ";
+        
+        $sth = $pdo->prepare($sql);
+        $sth->execute([
+            'knowledgeId' => $knowledgeId,
+            'documentId' => $documentId
+        ]);
+        
+        $result = $sth->fetch(\PDO::FETCH_ASSOC);
+        
+        if (!$result) {
+            throw new NotFound('Junction entry not found');
+        }
+        
+        return $result;
+    }
+}

custom/Espo/Custom/Api/JunctionData/UpdateJunction.php

@@ -0,0 +1,123 @@
+<?php
+
+namespace Espo\Custom\Api\JunctionData;
+
+use Espo\Core\Api\Action;
+use Espo\Core\Api\Request;
+use Espo\Core\Api\Response;
+use Espo\Core\Api\ResponseComposer;
+use Espo\Core\Exceptions\BadRequest;
+use Espo\Core\Exceptions\NotFound;
+use Espo\ORM\EntityManager;
+
+/**
+ * PUT /api/v1/JunctionData/CAIKnowledge/:knowledgeId/dokumentes/:documentId
+ * 
+ * Updates junction table columns for an existing relationship
+ */
+class UpdateJunction implements Action
+{
+    public function __construct(
+        private EntityManager $entityManager
+    ) {}
+    
+    public function process(Request $request): Response
+    {
+        $knowledgeId = $request->getRouteParam('knowledgeId');
+        $documentId = $request->getRouteParam('documentId');
+        $data = $request->getParsedBody();
+        
+        if (!$knowledgeId || !$documentId) {
+            throw new BadRequest('Knowledge ID and Document ID are required');
+        }
+        
+        $pdo = $this->entityManager->getPDO();
+        
+        // Build dynamic UPDATE SET clause
+        $setClauses = [];
+        $params = [
+            'knowledgeId' => $knowledgeId,
+            'documentId' => $documentId
+        ];
+        
+        if (isset($data->aiDocumentId)) {
+            $setClauses[] = "ai_document_id = :aiDocumentId";
+            $params['aiDocumentId'] = $data->aiDocumentId;
+        }
+        
+        if (isset($data->syncstatus)) {
+            $allowedStatuses = ['new', 'unclean', 'synced', 'failed', 'unsupported'];
+            if (!in_array($data->syncstatus, $allowedStatuses)) {
+                throw new BadRequest('Invalid syncstatus value. Allowed: ' . implode(', ', $allowedStatuses));
+            }
+            $setClauses[] = "syncstatus = :syncstatus";
+            $params['syncstatus'] = $data->syncstatus;
+        }
+        
+        if (isset($data->lastSync)) {
+            $setClauses[] = "last_sync = :lastSync";
+            $params['lastSync'] = $data->lastSync;
+        } elseif (isset($data->updateLastSync) && $data->updateLastSync === true) {
+            $setClauses[] = "last_sync = NOW()";
+        }
+        
+        if (empty($setClauses)) {
+            throw new BadRequest('No fields to update. Provide at least one of: aiDocumentId, syncstatus, lastSync');
+        }
+        
+        $sql = "
+            UPDATE c_a_i_knowledge_dokumente
+            SET " . implode(', ', $setClauses) . "
+            WHERE c_a_i_knowledge_id = :knowledgeId
+              AND c_dokumente_id = :documentId
+              AND deleted = 0
+        ";
+        
+        $sth = $pdo->prepare($sql);
+        $sth->execute($params);
+        
+        $affectedRows = $sth->rowCount();
+        
+        if ($affectedRows === 0) {
+            throw new NotFound('Junction entry not found or no changes made');
+        }
+        
+        // Return updated data
+        $result = $this->getJunctionEntry($knowledgeId, $documentId);
+        
+        return ResponseComposer::json($result);
+    }
+    
+    private function getJunctionEntry(string $knowledgeId, string $documentId): array
+    {
+        $pdo = $this->entityManager->getPDO();
+        
+        $sql = "
+            SELECT 
+                id as junctionId,
+                c_a_i_knowledge_id as cAIKnowledgeId,
+                c_dokumente_id as cDokumenteId,
+                ai_document_id as aiDocumentId,
+                syncstatus,
+                last_sync as lastSync
+            FROM c_a_i_knowledge_dokumente
+            WHERE c_a_i_knowledge_id = :knowledgeId
+              AND c_dokumente_id = :documentId
+              AND deleted = 0
+        ";
+        
+        $sth = $pdo->prepare($sql);
+        $sth->execute([
+            'knowledgeId' => $knowledgeId,
+            'documentId' => $documentId
+        ]);
+        
+        $result = $sth->fetch(\PDO::FETCH_ASSOC);
+        
+        if (!$result) {
+            throw new NotFound('Junction entry not found');
+        }
+        
+        return $result;
+    }
+}

custom/Espo/Custom/Controllers/CAICollection.php

@@ -1,7 +0,0 @@
-<?php
-
-namespace Espo\Custom\Controllers;
-
-class CAICollection extends \Espo\Core\Templates\Controllers\BasePlus
-{
-}

custom/Espo/Custom/Controllers/CAIKnowledge.php

@@ -0,0 +1,7 @@
+<?php
+
+namespace Espo\Custom\Controllers;
+
+class CAIKnowledge extends \Espo\Core\Templates\Controllers\Base
+{
+}

custom/Espo/Custom/Controllers/CAIKnowledgeCDokumente.php

@@ -0,0 +1,24 @@
+<?php
+namespace Espo\Custom\Controllers;
+
+use Espo\Core\Controllers\Record;
+
+/**
+ * Junction Controller: CAIKnowledge ↔ CDokumente
+ * 
+ * Provides REST API access to the junction table with additionalColumns:
+ * - aiDocumentId: External AI document reference
+ * - syncstatus: Sync state tracking (new, unclean, synced, failed)
+ * - lastSync: Last synchronization timestamp
+ */
+class CAIKnowledgeCDokumente extends Record
+{
+    // Inherits all CRUD operations from Record controller
+    // 
+    // Available endpoints:
+    // GET    /api/v1/CAIKnowledgeCDokumente
+    // GET    /api/v1/CAIKnowledgeCDokumente/{id}
+    // POST   /api/v1/CAIKnowledgeCDokumente
+    // PUT    /api/v1/CAIKnowledgeCDokumente/{id}
+    // DELETE /api/v1/CAIKnowledgeCDokumente/{id}
+}

custom/Espo/Custom/Controllers/CAkten.php

@@ -0,0 +1,7 @@
+<?php
+
+namespace Espo\Custom\Controllers;
+
+class CAkten extends \Espo\Core\Templates\Controllers\BasePlus
+{
+}

custom/Espo/Custom/Controllers/CAktenCDokumente.php

@@ -0,0 +1,21 @@
+<?php
+namespace Espo\Custom\Controllers;
+
+use Espo\Core\Controllers\Record;
+
+/**
+ * Junction Controller: CAkten ↔ CDokumente
+ *
+ * Provides REST API access to the Akten-Dokumente relationship.
+ *
+ * Available endpoints:
+ * GET    /api/v1/CAktenCDokumente
+ * GET    /api/v1/CAktenCDokumente/{id}
+ * POST   /api/v1/CAktenCDokumente
+ * PUT    /api/v1/CAktenCDokumente/{id}
+ * DELETE /api/v1/CAktenCDokumente/{id}
+ */
+class CAktenCDokumente extends Record
+{
+    // Inherits all CRUD operations from Record controller
+}

custom/Espo/Custom/Hooks/CAIKnowledge/CheckGlobalSyncStatus.php

@@ -0,0 +1,75 @@
+<?php
+namespace Espo\Custom\Hooks\CAIKnowledge;
+
+use Espo\ORM\Entity;
+use Espo\ORM\Repository\Option\SaveOptions;
+use Espo\Core\Hook\Hook\BeforeSave;
+
+/**
+ * Hook: Prüft Junction-Table und aktualisiert globalen syncStatus
+ * basierend auf den syncstatus-Werten der verknüpften Dokumente
+ */
+class CheckGlobalSyncStatus implements BeforeSave
+{
+    public function __construct(
+        private \Espo\ORM\EntityManager $entityManager
+    ) {}
+    
+    public function beforeSave(Entity $entity, SaveOptions $options): void
+    {
+        // Überspringe, wenn skipHooks gesetzt ist (verhindert Loops)
+        if ($options->get('skipHooks')) {
+            return;
+        }
+        
+        // Nur wenn Entity bereits existiert (nicht bei Create)
+        if ($entity->isNew()) {
+            return;
+        }
+        
+        try {
+            // Hole alle verknüpften Dokumente mit ihren syncstatus-Werten aus der Junction-Tabelle
+            $query = $this->entityManager->getQueryBuilder()
+                ->select(['syncstatus'])
+                ->from('CAIKnowledgeDokumente')
+                ->where([
+                    'cAIKnowledgeId' => $entity->getId(),
+                    'deleted' => false
+                ])
+                ->build();
+            
+            $pdoStatement = $this->entityManager->getQueryExecutor()->execute($query);
+            $rows = $pdoStatement->fetchAll(\PDO::FETCH_ASSOC);
+            
+            // Wenn keine Dokumente verknüpft, setze auf "unclean"
+            if (empty($rows)) {
+                $entity->set('syncStatus', 'unclean');
+                return;
+            }
+            
+            // Prüfe, ob irgendein Dokument "new" oder "unclean" ist
+            $hasUnsynced = false;
+            foreach ($rows as $row) {
+                $status = $row['syncstatus'] ?? null;
+                if ($status === 'new' || $status === 'unclean' || $status === null || $status === '') {
+                    $hasUnsynced = true;
+                    break;
+                }
+            }
+            
+            // Setze globalen Status
+            if ($hasUnsynced) {
+                $entity->set('syncStatus', 'unclean');
+            } else {
+                // Alle Dokumente sind "synced"
+                $entity->set('syncStatus', 'synced');
+                $entity->set('lastSync', date('Y-m-d H:i:s'));
+            }
+            
+        } catch (\Exception $e) {
+            // Bei Fehler loggen und Status auf "unclean" setzen
+            $GLOBALS['log']->error('CAIKnowledge CheckGlobalSyncStatus Hook Error: ' . $e->getMessage());
+            $entity->set('syncStatus', 'unclean');
+        }
+    }
+}

custom/Espo/Custom/Hooks/CAIKnowledge/DokumenteSyncStatus.php

@@ -0,0 +1,47 @@
+<?php
+namespace Espo\Custom\Hooks\CAIKnowledge;
+
+use Espo\ORM\Entity;
+use Espo\Core\Hook\Hook\AfterRelate;
+
+/**
+ * Hook: Setzt Dokument-Sync-Status auf "new" beim Verknüpfen und
+ * globalen syncStatus auf "unclean"
+ */
+class DokumenteSyncStatus implements AfterRelate
+{
+    public function __construct(
+        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') {
+            return;
+        }
+        
+        // Setze Sync-Status des Dokuments in der Junction-Tabelle auf "new"
+        $repository = $this->entityManager->getRDBRepository('CAIKnowledge');
+        
+        try {
+            $repository->getRelation($entity, 'dokumentes')->updateColumns(
+                $foreignEntity,
+                ['syncstatus' => 'new']
+            );
+            
+            // Setze globalen syncStatus auf "unclean"
+            $entity->set('syncStatus', 'unclean');
+            $this->entityManager->saveEntity($entity, ['silent' => true, 'skipHooks' => true]);
+            
+        } catch (\Exception $e) {
+            // Fehler loggen, aber nicht werfen (um Verknüpfung nicht zu blockieren)
+            $GLOBALS['log']->error('CAIKnowledge DokumenteSyncStatus Hook Error: ' . $e->getMessage());
+        }
+    }
+}

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

@@ -0,0 +1,182 @@
+<?php
+namespace Espo\Custom\Hooks\CAIKnowledge;
+
+use Espo\ORM\Entity;
+use Espo\Core\Hook\Hook\AfterRelate;
+use Espo\Core\Hook\Hook\AfterUnrelate;
+
+/**
+ * Hook: Propagiert Dokumenten-Verknüpfungen von AIKnowledge nach oben zu Räumungsklage/Mietinkasso
+ * 
+ * Wenn Dokument mit AIKnowledge verknüpft wird:
+ * → verknüpfe mit verbundener Räumungsklage/Mietinkasso
+ * → von dort propagiert es automatisch zu AdvowareAkten (via deren Hooks)
+ * 
+ * Wenn Dokument von AIKnowledge entknüpft wird:
+ * → entknüpfe von verbundener Räumungsklage/Mietinkasso
+ * → von dort propagiert es automatisch von AdvowareAkten (via deren Hooks)
+ */
+class PropagateDocumentsUp implements AfterRelate, AfterUnrelate
+{
+    private static array $processing = [];
+    
+    public function __construct(
+        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') {
+            return;
+        }
+        
+        // Vermeide Loops
+        $key = $entity->getId() . '-' . $foreignEntity->getId() . '-relate';
+        if (isset(self::$processing[$key])) {
+            return;
+        }
+        self::$processing[$key] = true;
+        
+        try {
+            // Prüfe ob Räumungsklage verknüpft ist
+            $raumungsklage = $this->entityManager
+                ->getRDBRepository('CAIKnowledge')
+                ->getRelation($entity, 'vmhRumungsklage')
+                ->findOne();
+            
+            if ($raumungsklage) {
+                $this->relateDocument($raumungsklage, 'dokumentesvmhraumungsklage', $foreignEntity);
+                
+                // Also link to AdvowareAkte if Räumungsklage has one
+                $advowareAkte = $this->entityManager
+                    ->getRDBRepository('CVmhRumungsklage')
+                    ->getRelation($raumungsklage, 'advowareAkten')
+                    ->findOne();
+                
+                if ($advowareAkte && !$foreignEntity->get('cAktenId')) {
+                    $foreignEntity->set('cAktenId', $advowareAkte->getId());
+                    $foreignEntity->set('syncStatus', 'new');
+                    $this->entityManager->saveEntity($foreignEntity, ['silent' => true, 'skipHooks' => true]);
+                }
+            }
+            
+            // Prüfe ob Mietinkasso verknüpft ist
+            $mietinkasso = $this->entityManager
+                ->getRDBRepository('CAIKnowledge')
+                ->getRelation($entity, 'mietinkasso')
+                ->findOne();
+            
+            if ($mietinkasso) {
+                $this->relateDocument($mietinkasso, 'dokumentesmietinkasso', $foreignEntity);
+                
+                // Also link to AdvowareAkte if Mietinkasso has one
+                $advowareAkte = $this->entityManager
+                    ->getRDBRepository('CMietinkasso')
+                    ->getRelation($mietinkasso, 'advowareAkten')
+                    ->findOne();
+                
+                if ($advowareAkte && !$foreignEntity->get('cAktenId')) {
+                    $foreignEntity->set('cAktenId', $advowareAkte->getId());
+                    $foreignEntity->set('syncStatus', 'new');
+                    $this->entityManager->saveEntity($foreignEntity, ['silent' => true, 'skipHooks' => true]);
+                }
+            }
+            
+        } catch (\Exception $e) {
+            $GLOBALS['log']->error('CAIKnowledge 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('CAIKnowledge')
+                ->getRelation($entity, 'vmhRumungsklage')
+                ->findOne();
+            
+            if ($raumungsklage) {
+                $this->unrelateDocument($raumungsklage, 'dokumentesvmhraumungsklage', $foreignEntity);
+            }
+            
+            // Prüfe ob Mietinkasso verknüpft ist
+            $mietinkasso = $this->entityManager
+                ->getRDBRepository('CAIKnowledge')
+                ->getRelation($entity, 'mietinkasso')
+                ->findOne();
+            
+            if ($mietinkasso) {
+                $this->unrelateDocument($mietinkasso, 'dokumentesmietinkasso', $foreignEntity);
+            }
+            
+            // Note: We don't remove cAktenId on unrelate from AIKnowledge
+            // because the document might still be linked to Räumungsklage/Mietinkasso
+            
+        } catch (\Exception $e) {
+            $GLOBALS['log']->error('CAIKnowledge PropagateDocumentsUp (unrelate) Error: ' . $e->getMessage());
+        } finally {
+            unset(self::$processing[$key]);
+        }
+    }
+    
+    /**
+     * Hilfsfunktion: Verknüpfe Dokument (nur wenn nicht bereits verknüpft)
+     */
+    private function relateDocument(Entity $parentEntity, string $relationName, Entity $document): void
+    {
+        $repository = $this->entityManager->getRDBRepository($parentEntity->getEntityType());
+        $relation = $repository->getRelation($parentEntity, $relationName);
+        
+        // Prüfe ob bereits verknüpft
+        $isRelated = $relation
+            ->where(['id' => $document->getId()])
+            ->findOne();
+        
+        if (!$isRelated) {
+            $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);
+        }
+    }
+}

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

@@ -0,0 +1,83 @@
+<?php
+namespace Espo\Custom\Hooks\CAkten;
+
+use Espo\ORM\Entity;
+use Espo\Core\Hook\Hook\AfterSave;
+
+/**
+ * Hook: Propagiert Dokumenten-Änderungen von Akten nach oben zu Räumungsklage/Mietinkasso
+ *
+ * Wenn ein Dokument einer Akte zugewiesen wird (via cAktenId):
+ * → verknüpfe mit verbundener Räumungsklage/Mietinkasso
+ */
+class PropagateDocumentsUp implements AfterSave
+{
+    private static array $processing = [];
+
+    public function __construct(
+        private \Espo\ORM\EntityManager $entityManager
+    ) {}
+
+    public function afterSave(Entity $entity, \Espo\ORM\Repository\Option\SaveOptions $options): void
+    {
+        // Only process when cAktenId changed
+        if (!$entity->isAttributeChanged('cAktenId')) {
+            return;
+        }
+
+        $akteId = $entity->get('cAktenId');
+        if (!$akteId) {
+            return;
+        }
+
+        $key = $akteId . '-' . $entity->getId() . '-propagate';
+        if (isset(self::$processing[$key])) {
+            return;
+        }
+        self::$processing[$key] = true;
+
+        try {
+            $akte = $this->entityManager->getEntity('CAkten', $akteId);
+            if (!$akte) {
+                return;
+            }
+
+            $raumungsklage = $this->entityManager
+                ->getRDBRepository('CAkten')
+                ->getRelation($akte, 'vmhRumungsklage')
+                ->findOne();
+
+            if ($raumungsklage) {
+                $this->relateDocument($raumungsklage, 'dokumentesvmhraumungsklage', $entity);
+            }
+
+            $mietinkasso = $this->entityManager
+                ->getRDBRepository('CAkten')
+                ->getRelation($akte, 'mietinkasso')
+                ->findOne();
+
+            if ($mietinkasso) {
+                $this->relateDocument($mietinkasso, 'dokumentesmietinkasso', $entity);
+            }
+
+        } catch (\Exception $e) {
+            $GLOBALS['log']->error('CAkten PropagateDocumentsUp Error: ' . $e->getMessage());
+        } finally {
+            unset(self::$processing[$key]);
+        }
+    }
+
+    private function relateDocument(Entity $parentEntity, string $relationName, Entity $document): void
+    {
+        $repository = $this->entityManager->getRDBRepository($parentEntity->getEntityType());
+        $relation = $repository->getRelation($parentEntity, $relationName);
+
+        $isRelated = $relation
+            ->where(['id' => $document->getId()])
+            ->findOne();
+
+        if (!$isRelated) {
+            $relation->relate($document);
+        }
+    }
+}

custom/Espo/Custom/Hooks/CAkten/UpdateLastSyncFromDocuments.php

@@ -0,0 +1,111 @@
+<?php
+namespace Espo\Custom\Hooks\CAkten;
+
+use Espo\ORM\Entity;
+use Espo\ORM\Repository\Option\SaveOptions;
+use Espo\Core\Hook\Hook\BeforeSave;
+
+/**
+ * Hook: Aktualisiert lastSync basierend auf dem neuesten lastSyncTimestamp
+ * der verknüpften Dokumente
+ */
+class UpdateLastSyncFromDocuments implements BeforeSave
+{
+    public function __construct(
+        private \Espo\ORM\EntityManager $entityManager
+    ) {}
+    
+    public function beforeSave(Entity $entity, SaveOptions $options): void
+    {
+        // Überspringe, wenn skipHooks gesetzt ist (verhindert Loops)
+        if ($options->get('skipHooks')) {
+            return;
+        }
+        
+        // Nur wenn Entity bereits existiert (nicht bei Create)
+        if ($entity->isNew()) {
+            return;
+        }
+        
+        try {
+            // Hole das neueste lastSyncTimestamp aller verknüpften Dokumente
+            $query = $this->entityManager->getQueryBuilder()
+                ->select([
+                    'MAX:lastSyncTimestamp' => 'maxLastSync',
+                    'COUNT:id' => 'dokumentCount'
+                ])
+                ->from('CDokumente')
+                ->where([
+                    'cAktenId' => $entity->getId(),
+                    'deleted' => false,
+                    'lastSyncTimestamp!=' => null
+                ])
+                ->build();
+            
+            $pdoStatement = $this->entityManager->getQueryExecutor()->execute($query);
+            $result = $pdoStatement->fetch(\PDO::FETCH_ASSOC);
+            
+            if ($result && $result['maxLastSync']) {
+                // Setze lastSync auf den neuesten Sync-Timestamp
+                $entity->set('lastSync', $result['maxLastSync']);
+            }
+            
+            // Berechne auch syncStatus basierend auf verknüpften Dokumenten
+            $this->updateSyncStatus($entity);
+            
+        } catch (\Exception $e) {
+            // Fehler loggen, aber nicht werfen (um Save nicht zu blockieren)
+            $GLOBALS['log']->error('CAkten UpdateLastSyncFromDocuments Hook Error: ' . $e->getMessage());
+        }
+    }
+    
+    /**
+     * Aktualisiert syncStatus basierend auf den Status der verknüpften Dokumente
+     */
+    private function updateSyncStatus(Entity $entity): void
+    {
+        $query = $this->entityManager->getQueryBuilder()
+            ->select(['syncStatus'])
+            ->from('CDokumente')
+            ->where([
+                'cAktenId' => $entity->getId(),
+                'deleted' => false
+            ])
+            ->build();
+        
+        $pdoStatement = $this->entityManager->getQueryExecutor()->execute($query);
+        $rows = $pdoStatement->fetchAll(\PDO::FETCH_ASSOC);
+        
+        // Wenn keine Dokumente verknüpft, setze auf "unclean"
+        if (empty($rows)) {
+            $entity->set('syncStatus', 'unclean');
+            return;
+        }
+        
+        // Prüfe, ob irgendein Dokument "new" oder "unclean" ist
+        $hasUnsynced = false;
+        $hasFailed = false;
+        
+        foreach ($rows as $row) {
+            $status = $row['syncStatus'] ?? null;
+            
+            if ($status === 'failed') {
+                $hasFailed = true;
+            }
+            
+            if ($status === 'new' || $status === 'unclean' || $status === null || $status === '') {
+                $hasUnsynced = true;
+            }
+        }
+        
+        // Setze globalen Status
+        if ($hasFailed) {
+            $entity->set('syncStatus', 'failed');
+        } elseif ($hasUnsynced) {
+            $entity->set('syncStatus', 'unclean');
+        } else {
+            // Alle Dokumente sind "synced"
+            $entity->set('syncStatus', 'synced');
+        }
+    }
+}

custom/Espo/Custom/Hooks/CDokumente/CDokumente.php

@@ -3,10 +3,21 @@
 namespace Espo\Custom\Hooks\CDokumente;
 
 use Espo\ORM\Entity;
+use Espo\ORM\Repository\Option\SaveOptions;
+use Espo\Core\Hook\Hook\BeforeSave;
 
-class CDokumente extends \Espo\Core\Hooks\Base
+/**
+ * Hook: Berechnet Dokumenten-Hashes und setzt fileStatus
+ * 
+ * Verwendet Blake3 als Hash-Algorithmus für optimale Performance
+ */
+class CDokumente implements BeforeSave
 {
-    public function beforeSave(Entity $entity, array $options = [])
+    public function __construct(
+        private \Espo\ORM\EntityManager $entityManager
+    ) {}
+    
+    public function beforeSave(Entity $entity, SaveOptions $options): void
     {
         // Problem: isAttributeChanged('dokument') erkennt Datei-Änderungen nicht,
         // da EspoCRM Datei-Uploads nicht als Feld-Änderung markiert.
@@ -14,43 +25,43 @@ class CDokumente extends \Espo\Core\Hooks\Base
         // um sicherzustellen, dass Hashes bei Datei-Änderungen berechnet werden.
         // Optimierung wäre wünschenswert, aber nicht möglich mit aktueller API.
 
-        $dokument = $entity->get('dokument');
+        $dokumentId = $entity->get('dokumentId');
 
-        if (!$dokument) {
+        if (!$dokumentId) {
             return;
         }
 
-        if (is_object($dokument)) {
+        // Verwende EntityManager zur korrekten Relation-Verwaltung
-            $attachment = $dokument;
+        $attachment = $this->entityManager->getEntityById('Attachment', $dokumentId);
-        } else {
-            $attachment = $this->getEntityManager()->getEntity('Attachment', $dokument);
-        }
 
         if (!$attachment) {
             return;
         }
 
-        $filePath = 'data/upload/' . $attachment->get('id');
+        $filePath = 'data/upload/' . $attachment->getId();
         if (!file_exists($filePath)) {
             return;
         }
 
-        // Berechne neue Hashes
+        // Berechne Blake3 Hash
-        $newMd5 = hash_file('md5', $filePath);
+        $fileContent = file_get_contents($filePath);
-        $newSha256 = hash_file('sha256', $filePath);
+        if ($fileContent === false) {
+            return;
+        }
         
-        // Setze Hashes
+        // Blake3 Hashing - schneller als SHA3 und kryptographisch sicher
-        $entity->set('md5sum', $newMd5);
+        $newBlake3 = blake3($fileContent);
-        $entity->set('sha256', $newSha256);
+
+        // Setze Hash
+        $entity->set('blake3hash', $newBlake3);
 
         // Bestimme Status
         if ($entity->isNew()) {
             $entity->set('fileStatus', 'new');
         } else {
-            $oldMd5 = $entity->getFetched('md5sum');
+            $oldBlake3 = $entity->getFetched('blake3hash');
-            $oldSha256 = $entity->getFetched('sha256');
 
-            if ($oldMd5 !== $newMd5 || $oldSha256 !== $newSha256) {
+            if ($oldBlake3 !== $newBlake3) {
                 $entity->set('fileStatus', 'changed');
             } else {
                 $entity->set('fileStatus', 'synced');

custom/Espo/Custom/Hooks/CDokumente/UpdateJunctionSyncStatus.php

@@ -0,0 +1,122 @@
+<?php
+namespace Espo\Custom\Hooks\CDokumente;
+
+use Espo\ORM\Entity;
+use Espo\ORM\Repository\Option\SaveOptions;
+use Espo\Core\Hook\Hook\AfterSave;
+
+/**
+ * Hook: Bei Änderung eines Dokuments wird syncStatus auf "unclean" gesetzt
+ * und alle verknüpften AIKnowledge Junction-Table-Einträge werden aktualisiert
+ */
+class UpdateJunctionSyncStatus implements AfterSave
+{
+    public function __construct(
+        private \Espo\ORM\EntityManager $entityManager
+    ) {}
+    
+    public function afterSave(Entity $entity, SaveOptions $options): void
+    {
+        // Überspringe bei Create (nur bei Update)
+        if ($entity->isNew()) {
+            return;
+        }
+        
+        // Überspringe, wenn keine relevanten Felder geändert wurden
+        if (!$this->hasRelevantChanges($entity)) {
+            return;
+        }
+        
+        try {
+            // Set syncStatus = 'unclean' directly on CDokumente entity
+            // (only if it has an AdvowareAkte linked)
+            if ($entity->get('cAktenId')) {
+                $entity->set('syncStatus', 'unclean');
+                $this->entityManager->saveEntity($entity, ['silent' => true, 'skipHooks' => true]);
+                
+                // Trigger parent AdvowareAkte update (will update syncStatus and lastSync via its own hook)
+                $akte = $this->entityManager->getEntityById('CAkten', $entity->get('cAktenId'));
+                if ($akte) {
+                    // Just touch the entity to trigger beforeSave hook
+                    $this->entityManager->saveEntity($akte, ['silent' => true]);
+                }
+            }
+            
+            // Update AIKnowledge Junction-Tables (unchanged)
+            $this->updateAIKnowledgeJunctions($entity);
+            
+        } catch (\Exception $e) {
+            // Fehler loggen, aber nicht werfen (um Save nicht zu blockieren)
+            $GLOBALS['log']->error('CDokumente UpdateJunctionSyncStatus Hook Error: ' . $e->getMessage());
+        }
+    }
+    
+    /**
+     * Prüft ob relevante Felder geändert wurden
+     */
+    private function hasRelevantChanges(Entity $entity): bool
+    {
+        // Relevante Felder für Sync-Status
+        $relevantFields = [
+            'name',
+            'description',
+            'dokument',
+            'dokumentId',
+            'preview',
+            'previewId',
+            'fileStatus'
+        ];
+        
+        foreach ($relevantFields as $field) {
+            if ($entity->isAttributeChanged($field)) {
+                return true;
+            }
+        }
+        
+        return false;
+    }
+    
+    /**
+     * Update AIKnowledge Junction-Tables
+     */
+    private function updateAIKnowledgeJunctions(Entity $entity): void
+    {
+        $updateQuery = $this->entityManager->getQueryBuilder()
+            ->update()
+            ->in('CAIKnowledgeDokumente')
+            ->set(['syncstatus' => 'unclean'])
+            ->where([
+                'cDokumenteId' => $entity->getId(),
+                'deleted' => false
+            ])
+            ->build();
+        
+        $this->entityManager->getQueryExecutor()->execute($updateQuery);
+        
+        // Hole alle betroffenen AIKnowledge IDs
+        $selectQuery = $this->entityManager->getQueryBuilder()
+            ->select(['cAIKnowledgeId'])
+            ->from('CAIKnowledgeDokumente')
+            ->where([
+                'cDokumenteId' => $entity->getId(),
+                'deleted' => false
+            ])
+            ->build();
+        
+        $pdoStatement = $this->entityManager->getQueryExecutor()->execute($selectQuery);
+        $rows = $pdoStatement->fetchAll(\PDO::FETCH_ASSOC);
+        
+        // Trigger Update auf jeder AIKnowledge (um CheckGlobalSyncStatus Hook auszulösen)
+        foreach ($rows as $row) {
+            $knowledgeId = $row['cAIKnowledgeId'] ?? null;
+            if ($knowledgeId) {
+                $knowledge = $this->entityManager->getEntity('CAIKnowledge', $knowledgeId);
+                if ($knowledge) {
+                    // Force Update ohne Hook-Loop
+                    $knowledge->set('syncStatus', 'unclean');
+                    $this->entityManager->saveEntity($knowledge, ['silent' => true, 'skipHooks' => true]);
+                }
+            }
+        }
+    }
+}

custom/Espo/Custom/Hooks/CKuendigung/CreateAdvowareAkte.php

@@ -0,0 +1,134 @@
+<?php
+namespace Espo\Custom\Hooks\CKuendigung;
+
+use Espo\ORM\Entity;
+use Espo\Core\Hook\Hook\AfterSave;
+
+/**
+ * Hook: Erstellt automatisch AdvowareAkte für Kündigung
+ * 
+ * Wenn eine Kündigung erstellt/gespeichert wird:
+ * - Prüfe ob bereits eine AdvowareAkte vorhanden ist (über verknüpfte Räumungsklage)
+ * - Wenn nein: Erstelle neue AdvowareAkte und verknüpfe sie
+ */
+class CreateAdvowareAkte implements AfterSave
+{
+    private static array $processing = [];
+    
+    public function __construct(
+        private \Espo\ORM\EntityManager $entityManager,
+        private \Espo\Core\InjectableFactory $injectableFactory
+    ) {}
+    
+    public function afterSave(
+        Entity $entity,
+        \Espo\ORM\Repository\Option\SaveOptions $options
+    ): void {
+        // Skip if silent or during hooks
+        if ($options->get('silent') || $options->get('skipHooks')) {
+            return;
+        }
+        
+        // Vermeide Loops
+        $key = $entity->getId() . '-create-akte';
+        if (isset(self::$processing[$key])) {
+            return;
+        }
+        self::$processing[$key] = true;
+        
+        try {
+            // Prüfe ob Kündigung bereits eine AdvowareAkte hat
+            $existingAkteId = $entity->get('advowareAktenId');
+            
+            if ($existingAkteId) {
+                $GLOBALS['log']->info("CKuendigung CreateAdvowareAkte: Kündigung already has AdvowareAkte: {$existingAkteId}");
+                unset(self::$processing[$key]);
+                return; // Bereits vorhanden
+            }
+            
+            // Prüfe ob verknüpfte Räumungsklagen eine Akte haben
+            $raeumungsklagen = $this->entityManager
+                ->getRDBRepository('CKuendigung')
+                ->getRelation($entity, 'vmhRumungsklages')
+                ->find();
+            
+            foreach ($raeumungsklagen as $rk) {
+                $rkAkteId = $rk->get('advowareAktenId');
+                if ($rkAkteId) {
+                    // Übernehme Akte von Räumungsklage
+                    $entity->set('advowareAktenId', $rkAkteId);
+                    $this->entityManager->saveEntity($entity, ['silent' => true, 'skipHooks' => true]);
+                    
+                    // Synchronisiere Aktennummer
+                    $akte = $this->entityManager->getEntity('CAkten', $rkAkteId);
+                    if ($akte) {
+                        $this->syncAktennummer($entity, $akte);
+                    }
+                    
+                    $GLOBALS['log']->info("CKuendigung CreateAdvowareAkte: Using AdvowareAkte from Räumungsklage: {$rkAkteId}");
+                    unset(self::$processing[$key]);
+                    return;
+                }
+            }
+            
+            // Keine Akte gefunden -> Erstelle neue
+            $this->createNewAkte($entity);
+            
+        } catch (\Exception $e) {
+            $GLOBALS['log']->error('CKuendigung CreateAdvowareAkte Error: ' . $e->getMessage());
+        } finally {
+            unset(self::$processing[$key]);
+        }
+    }
+    
+    private function createNewAkte(Entity $kuendigung): void
+    {
+        // Hole Aktennummer aus Kündigung (falls vorhanden)
+        $aktennummer = $kuendigung->get('aktennr');
+        if (!$aktennummer) {
+            $aktennummer = time();
+        }
+        
+        // Erstelle AdvowareAkte (aktenzeichen bleibt leer)
+        $akteData = [
+            'name' => 'Advoware Akte - ' . $kuendigung->get('name'),
+            'aktennummer' => $aktennummer,
+            'syncStatus' => 'unclean',
+            'assignedUserId' => $kuendigung->get('assignedUserId')
+        ];
+        
+        // Copy teams
+        $teamsIds = $kuendigung->getLinkMultipleIdList('teams');
+        if (!empty($teamsIds)) {
+            $akteData['teamsIds'] = $teamsIds;
+        }
+        
+        $akte = $this->entityManager->createEntity('CAkten', $akteData);
+        
+        if ($akte) {
+            // Verknüpfe mit Kündigung
+            $kuendigung->set('advowareAktenId', $akte->getId());
+            $this->entityManager->saveEntity($kuendigung, ['silent' => true, 'skipHooks' => true]);
+            
+            // Synchronisiere Aktennummer zurück zur Kündigung (falls leer war)
+            if (!$kuendigung->get('aktennr') && $akte->get('aktennummer')) {
+                $kuendigung->set('aktennr', $akte->get('aktennummer'));
+                $this->entityManager->saveEntity($kuendigung, ['silent' => true, 'skipHooks' => true]);
+            }
+            
+            $GLOBALS['log']->info("CKuendigung CreateAdvowareAkte: Created new AdvowareAkte: {$akte->getId()}");
+        } else {
+            $GLOBALS['log']->error('CKuendigung CreateAdvowareAkte: Failed to create AdvowareAkte');
+        }
+    }
+    
+    private function syncAktennummer(Entity $kuendigung, Entity $akte): void
+    {
+        // Synchronisiere nur Aktennummer (nicht Aktenzeichen, das ist in der Beziehung)
+        if (!$kuendigung->get('aktennr') && $akte->get('aktennummer')) {
+            $kuendigung->set('aktennr', $akte->get('aktennummer'));
+            $this->entityManager->saveEntity($kuendigung, ['silent' => true, 'skipHooks' => true]);
+            $GLOBALS['log']->info("CKuendigung CreateAdvowareAkte: Synchronized Aktennummer");
+        }
+    }
+}

custom/Espo/Custom/Hooks/CKuendigung/SyncAdvowareAkte.php

@@ -0,0 +1,84 @@
+<?php
+namespace Espo\Custom\Hooks\CKuendigung;
+
+use Espo\ORM\Entity;
+use Espo\Core\Hook\Hook\AfterRelate;
+
+/**
+ * Hook: Synchronisiert AdvowareAkte zwischen Kündigung und Räumungsklage
+ * 
+ * Wenn eine Kündigung mit einer Räumungsklage verknüpft wird:
+ * - Prüfe ob Räumungsklage eine AdvowareAkte hat
+ * - Wenn ja, verknüpfe diese Akte auch mit der Kündigung
+ * - Übernehme/Synchronisiere Aktennummer und Aktenzeichen
+ */
+class SyncAdvowareAkte implements AfterRelate
+{
+    private static array $processing = [];
+    
+    public function __construct(
+        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 vmhRumungsklages-Beziehung (wenn Räumungsklage zu Kündigung hinzugefügt wird)
+        if ($relationName !== 'vmhRumungsklages') {
+            return;
+        }
+        
+        // Vermeide Loops
+        $key = $entity->getId() . '-' . $foreignEntity->getId() . '-sync-akte';
+        if (isset(self::$processing[$key])) {
+            return;
+        }
+        self::$processing[$key] = true;
+        
+        try {
+            // $entity = CKuendigung
+            // $foreignEntity = CVmhRumungsklage
+            
+            // Hole AdvowareAkte von der Räumungsklage (hasOne relationship - get via field)
+            $advowareAkteId = $foreignEntity->get('advowareAktenId');
+            
+            if ($advowareAkteId) {
+                $advowareAkte = $this->entityManager->getEntity('CAkten', $advowareAkteId);
+                
+                if ($advowareAkte) {
+                    $GLOBALS['log']->info("CKuendigung SyncAdvowareAkte: Found AdvowareAkte {$advowareAkte->getId()} on Räumungsklage {$foreignEntity->getId()}");
+                    
+                    // Prüfe ob Kündigung bereits eine andere Akte hat
+                    $existingAktenId = $entity->get('advowareAktenId');
+                    
+                    if ($existingAktenId && $existingAktenId !== $advowareAkteId) {
+                        $GLOBALS['log']->warning("CKuendigung SyncAdvowareAkte: Kündigung already has different AdvowareAkte {$existingAktenId}, will replace with {$advowareAkteId}");
+                    }
+                    
+                    // Verknüpfe AdvowareAkte mit Kündigung (belongsTo relationship - set field directly)
+                    $entity->set('advowareAktenId', $advowareAkteId);
+                    
+                    // Synchronisiere nur Aktennummer (Aktenzeichen kommt über Beziehung)
+                    if (!$entity->get('aktennr') && $advowareAkte->get('aktennummer')) {
+                        $entity->set('aktennr', $advowareAkte->get('aktennummer'));
+                    }
+                    
+                    // Save once with all changes
+                    $this->entityManager->saveEntity($entity, ['silent' => true, 'skipHooks' => true]);
+                    $GLOBALS['log']->info("CKuendigung SyncAdvowareAkte: Successfully linked AdvowareAkte and synchronized Aktennummer to Kündigung");
+                }
+            } else {
+                $GLOBALS['log']->info("CKuendigung SyncAdvowareAkte: Räumungsklage {$foreignEntity->getId()} has no AdvowareAkte yet");
+            }
+            
+        } catch (\Exception $e) {
+            $GLOBALS['log']->error('CKuendigung SyncAdvowareAkte Error: ' . $e->getMessage());
+        } finally {
+            unset(self::$processing[$key]);
+        }
+    }
+}

custom/Espo/Custom/Hooks/CMietinkasso/PropagateDocuments.php

@@ -0,0 +1,157 @@
+<?php
+namespace Espo\Custom\Hooks\CMietinkasso;
+
+use Espo\ORM\Entity;
+use Espo\Core\Hook\Hook\AfterRelate;
+use Espo\Core\Hook\Hook\AfterUnrelate;
+
+/**
+ * Hook: Propagiert Dokumenten-Verknüpfungen von Mietinkasso zu AdvowareAkten und AIKnowledge
+ * 
+ * - Wenn Dokument mit Mietinkasso verknüpft wird → verknüpfe auch mit AdvowareAkten + AIKnowledge
+ * - Wenn Dokument von Mietinkasso entknüpft wird → entknüpfe auch von AdvowareAkten + AIKnowledge
+ */
+class PropagateDocuments implements AfterRelate, AfterUnrelate
+{
+    private static array $processing = [];
+    
+    public function __construct(
+        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 dokumentesmietinkasso-Beziehung
+        if ($relationName !== 'dokumentesmietinkasso') {
+            return;
+        }
+        
+        // Vermeide Loops
+        $key = $entity->getId() . '-' . $foreignEntity->getId() . '-relate';
+        if (isset(self::$processing[$key])) {
+            return;
+        }
+        self::$processing[$key] = true;
+        
+        try {
+            // Hole verbundene AdvowareAkten
+            $advowareAkten = $this->entityManager
+                ->getRDBRepository('CMietinkasso')
+                ->getRelation($entity, 'advowareAkten')
+                ->findOne();
+            
+            // Set direct belongsTo relationship on document
+            if ($advowareAkten) {
+                $foreignEntity->set('cAktenId', $advowareAkten->getId());
+                $foreignEntity->set('syncStatus', 'new'); // Mark as new for Advoware sync
+                $this->entityManager->saveEntity($foreignEntity, ['silent' => true, 'skipHooks' => true]);
+            }
+            
+            // Hole verbundene AIKnowledge
+            $aIKnowledge = $this->entityManager
+                ->getRDBRepository('CMietinkasso')
+                ->getRelation($entity, 'aIKnowledge')
+                ->findOne();
+            
+            // Verknüpfe Dokument mit AIKnowledge
+            if ($aIKnowledge) {
+                $this->relateDocument($aIKnowledge, 'dokumentes', $foreignEntity);
+            }
+            
+        } catch (\Exception $e) {
+            $GLOBALS['log']->error('CMietinkasso PropagateDocuments (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 dokumentesmietinkasso-Beziehung
+        if ($relationName !== 'dokumentesmietinkasso') {
+            return;
+        }
+        
+        // Vermeide Loops
+        $key = $entity->getId() . '-' . $foreignEntity->getId() . '-unrelate';
+        if (isset(self::$processing[$key])) {
+            return;
+        }
+        self::$processing[$key] = true;
+        
+        try {
+            // Hole verbundene AdvowareAkten
+            $advowareAkten = $this->entityManager
+                ->getRDBRepository('CMietinkasso')
+                ->getRelation($entity, 'advowareAkten')
+                ->findOne();
+            
+            // Remove direct belongsTo relationship from document
+            if ($advowareAkten && $foreignEntity->get('cAktenId') === $advowareAkten->getId()) {
+                $foreignEntity->set('cAktenId', null);
+                $this->entityManager->saveEntity($foreignEntity, ['silent' => true, 'skipHooks' => true]);
+            }
+            
+            // Hole verbundene AIKnowledge
+            $aIKnowledge = $this->entityManager
+                ->getRDBRepository('CMietinkasso')
+                ->getRelation($entity, 'aIKnowledge')
+                ->findOne();
+            
+            // Entknüpfe Dokument von AIKnowledge
+            if ($aIKnowledge) {
+                $this->unrelateDocument($aIKnowledge, 'dokumentes', $foreignEntity);
+            }
+            
+        } catch (\Exception $e) {
+            $GLOBALS['log']->error('CMietinkasso PropagateDocuments (unrelate) Error: ' . $e->getMessage());
+        } finally {
+            unset(self::$processing[$key]);
+        }
+    }
+    
+    /**
+     * Hilfsfunktion: Verknüpfe Dokument (nur wenn nicht bereits verknüpft)
+     */
+    private function relateDocument(Entity $parentEntity, string $relationName, Entity $document): void
+    {
+        $repository = $this->entityManager->getRDBRepository($parentEntity->getEntityType());
+        $relation = $repository->getRelation($parentEntity, $relationName);
+        
+        // Prüfe ob bereits verknüpft
+        $isRelated = $relation
+            ->where(['id' => $document->getId()])
+            ->findOne();
+        
+        if (!$isRelated) {
+            $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);
+        }
+    }
+}

custom/Espo/Custom/Hooks/CVmhRumungsklage/PropagateDocuments.php

@@ -0,0 +1,157 @@
+<?php
+namespace Espo\Custom\Hooks\CVmhRumungsklage;
+
+use Espo\ORM\Entity;
+use Espo\Core\Hook\Hook\AfterRelate;
+use Espo\Core\Hook\Hook\AfterUnrelate;
+
+/**
+ * Hook: Propagiert Dokumenten-Verknüpfungen von Räumungsklage zu AdvowareAkten und AIKnowledge
+ * 
+ * - Wenn Dokument mit Räumungsklage verknüpft wird → verknüpfe auch mit AdvowareAkten + AIKnowledge
+ * - Wenn Dokument von Räumungsklage entknüpft wird → entknüpfe auch von AdvowareAkten + AIKnowledge
+ */
+class PropagateDocuments implements AfterRelate, AfterUnrelate
+{
+    private static array $processing = [];
+    
+    public function __construct(
+        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 dokumentesvmhraumungsklage-Beziehung
+        if ($relationName !== 'dokumentesvmhraumungsklage') {
+            return;
+        }
+        
+        // Vermeide Loops
+        $key = $entity->getId() . '-' . $foreignEntity->getId() . '-relate';
+        if (isset(self::$processing[$key])) {
+            return;
+        }
+        self::$processing[$key] = true;
+        
+        try {
+            // Hole verbundene AdvowareAkten
+            $advowareAkten = $this->entityManager
+                ->getRDBRepository('CVmhRumungsklage')
+                ->getRelation($entity, 'advowareAkten')
+                ->findOne();
+            
+            // Set direct belongsTo relationship on document
+            if ($advowareAkten) {
+                $foreignEntity->set('cAktenId', $advowareAkten->getId());
+                $foreignEntity->set('syncStatus', 'new'); // Mark as new for Advoware sync
+                $this->entityManager->saveEntity($foreignEntity, ['silent' => true, 'skipHooks' => true]);
+            }
+            
+            // Hole verbundene AIKnowledge
+            $aIKnowledge = $this->entityManager
+                ->getRDBRepository('CVmhRumungsklage')
+                ->getRelation($entity, 'aIKnowledge')
+                ->findOne();
+            
+            // Verknüpfe Dokument mit AIKnowledge
+            if ($aIKnowledge) {
+                $this->relateDocument($aIKnowledge, 'dokumentes', $foreignEntity);
+            }
+            
+        } catch (\Exception $e) {
+            $GLOBALS['log']->error('CVmhRumungsklage PropagateDocuments (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 dokumentesvmhraumungsklage-Beziehung
+        if ($relationName !== 'dokumentesvmhraumungsklage') {
+            return;
+        }
+        
+        // Vermeide Loops
+        $key = $entity->getId() . '-' . $foreignEntity->getId() . '-unrelate';
+        if (isset(self::$processing[$key])) {
+            return;
+        }
+        self::$processing[$key] = true;
+        
+        try {
+            // Hole verbundene AdvowareAkten
+            $advowareAkten = $this->entityManager
+                ->getRDBRepository('CVmhRumungsklage')
+                ->getRelation($entity, 'advowareAkten')
+                ->findOne();
+            
+            // Remove direct belongsTo relationship from document
+            if ($advowareAkten && $foreignEntity->get('cAktenId') === $advowareAkten->getId()) {
+                $foreignEntity->set('cAktenId', null);
+                $this->entityManager->saveEntity($foreignEntity, ['silent' => true, 'skipHooks' => true]);
+            }
+            
+            // Hole verbundene AIKnowledge
+            $aIKnowledge = $this->entityManager
+                ->getRDBRepository('CVmhRumungsklage')
+                ->getRelation($entity, 'aIKnowledge')
+                ->findOne();
+            
+            // Entknüpfe Dokument von AIKnowledge
+            if ($aIKnowledge) {
+                $this->unrelateDocument($aIKnowledge, 'dokumentes', $foreignEntity);
+            }
+            
+        } catch (\Exception $e) {
+            $GLOBALS['log']->error('CVmhRumungsklage PropagateDocuments (unrelate) Error: ' . $e->getMessage());
+        } finally {
+            unset(self::$processing[$key]);
+        }
+    }
+    
+    /**
+     * Hilfsfunktion: Verknüpfe Dokument (nur wenn nicht bereits verknüpft)
+     */
+    private function relateDocument(Entity $parentEntity, string $relationName, Entity $document): void
+    {
+        $repository = $this->entityManager->getRDBRepository($parentEntity->getEntityType());
+        $relation = $repository->getRelation($parentEntity, $relationName);
+        
+        // Prüfe ob bereits verknüpft
+        $isRelated = $relation
+            ->where(['id' => $document->getId()])
+            ->findOne();
+        
+        if (!$isRelated) {
+            $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);
+        }
+    }
+}

custom/Espo/Custom/Resources/i18n/ar_AR/CAIKnowledge.json

@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "إنشاء {الكيانTypeTranslated}"
+  }
+}

custom/Espo/Custom/Resources/i18n/ar_AR/CAkten.json

@@ -5,6 +5,6 @@
     "tasks": "مهام"
   },
   "labels": {
-    "Create CAICollection": "إنشاء {الكيانTypeTranslated}"
+    "Create CAkten": "إنشاء {الكيانTypeTranslated}"
   }
 }

custom/Espo/Custom/Resources/i18n/bg_BG/CAIKnowledge.json

@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Създаване на AI Knowledge"
+  }
+}

custom/Espo/Custom/Resources/i18n/bg_BG/CAdvowareAkten.json

@@ -5,6 +5,6 @@
     "tasks": "Задачи"
   },
   "labels": {
-    "Create CAdvowareAkten": "Създаване на Advoware Akte"
+    "Create CAdvowareAkten": "Създаване на Advoware Akten"
   }
 }

custom/Espo/Custom/Resources/i18n/bg_BG/CAkten.json

@@ -5,6 +5,6 @@
     "tasks": "Задачи"
   },
   "labels": {
-    "Create CAICollection": "Създаване на AI Collection"
+    "Create CAkten": "Създаване на Advoware Akten"
   }
 }

custom/Espo/Custom/Resources/i18n/cs_CZ/CAIKnowledge.json

@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Vytvořit AI Knowledge"
+  }
+}

custom/Espo/Custom/Resources/i18n/cs_CZ/CAdvowareAkten.json

@@ -5,6 +5,6 @@
     "tasks": "Úkoly"
   },
   "labels": {
-    "Create CAdvowareAkten": "Vytvořit Advoware Akte"
+    "Create CAdvowareAkten": "Vytvořit Advoware Akten"
   }
 }

custom/Espo/Custom/Resources/i18n/cs_CZ/CAkten.json

@@ -5,6 +5,6 @@
     "tasks": "Úkoly"
   },
   "labels": {
-    "Create CAICollection": "Vytvořit AI Collection"
+    "Create CAkten": "Vytvořit Advoware Akten"
   }
 }

custom/Espo/Custom/Resources/i18n/da_DK/CAIKnowledge.json

@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Opret AI Knowledge "
+  }
+}

custom/Espo/Custom/Resources/i18n/da_DK/CAdvowareAkten.json

@@ -5,6 +5,6 @@
     "tasks": "Opgaver"
   },
   "labels": {
-    "Create CAdvowareAkten": "Opret Advoware Akte "
+    "Create CAdvowareAkten": "Opret Advoware Akten "
   }
 }

custom/Espo/Custom/Resources/i18n/da_DK/CAkten.json

@@ -5,6 +5,6 @@
     "tasks": "Opgaver"
   },
   "labels": {
-    "Create CAICollection": "Opret AI Collection "
+    "Create CAkten": "Opret Advoware Akten "
   }
 }

custom/Espo/Custom/Resources/i18n/de_DE/CAICollection.json

@@ -1,19 +0,0 @@
-{
-  "fields": {
-    "cAdvowareAkte": "Advoware-Akte",
-    "cAdvowareAkteId": "Advoware-Akte ID",
-    "cAdvowareAkteName": "Advoware-Akte Name"
-  },
-  "links": {
-    "meetings": "Termine",
-    "calls": "Anrufe",
-    "tasks": "Aufgaben",
-    "cDokumente": "Dokumente",
-    "cAdvowareAkte": "Advoware-Akte",
-    "cmietinkassos": "Mietinkassos",
-    "cvmhRumungsklages": "Räumungsklagen"
-  },
-  "labels": {
-    "Create CAICollection": "AI Collection erstellen"
-  }
-}

custom/Espo/Custom/Resources/i18n/de_DE/CAICollectionCDokumente.json

@@ -1,31 +0,0 @@
-{
-    "labels": {
-        "Create CAICollectionCDokumente": "AI-Collection-Dokument-Verknüpfung erstellen",
-        "CAICollectionCDokumente": "AI-Collection-Dokument-Verknüpfungen"
-    },
-    "fields": {
-        "cAICollection": "AI-Collection",
-        "cAICollectionId": "AI-Collection ID",
-        "cDokumente": "Dokument",
-        "cDokumenteId": "Dokument ID",
-        "xaifileid": "XAI File ID",
-        "syncStatus": "Sync-Status",
-        "deleted": "Gelöscht"
-    },
-    "links": {
-        "cAICollection": "AI-Collection",
-        "cDokumente": "Dokument"
-    },
-    "options": {
-        "syncStatus": {
-            "new": "Neu",
-            "changed": "Geändert",
-            "synced": "Synchronisiert",
-            "deleted": "Gelöscht"
-        }
-    },
-    "tooltips": {
-        "xaifileid": "Externe XAI File ID für dieses Dokument",
-        "syncStatus": "Synchronisierungsstatus mit XAI"
-    }
-}

custom/Espo/Custom/Resources/i18n/de_DE/CAIKnowledge.json

@@ -0,0 +1,49 @@
+{
+    "labels": {
+        "Create CAIKnowledge": "AI Knowledge erstellen"
+    },
+    "fields": {
+        "dokumentes": "Dokumente",
+        "vmhRumungsklage": "Räumungsklage",
+        "mietinkasso": "Mietinkasso",
+        "datenbankId": "Datenbank-ID",
+        "syncStatus": "Sync-Status",
+        "lastSync": "Letzte Synchronisation",
+        "aktivierungsstatus": "Aktivierungsstatus",
+        "dokumenteAiDocumentId": "AI Document ID",
+        "dokumenteSyncstatus": "Sync-Status",
+        "dokumenteLastSync": "Letzter Sync",
+        "dokumenteSyncedHash": "Sync-Hash"
+    },
+    "links": {
+        "dokumentes": "Dokumente",
+        "vmhRumungsklage": "Räumungsklage",
+        "mietinkasso": "Mietinkasso"
+    },
+    "options": {
+        "syncStatus": {
+            "synced": "Synchronisiert",
+            "unclean": "Nicht synchronisiert",
+            "pending_sync": "Synchronisierung ausstehend"
+        },
+        "aktivierungsstatus": {
+            "new": "Neu",
+            "active": "Aktiv",
+            "paused": "Pausiert",
+            "deactivated": "Deaktiviert"
+        },
+        "dokumenteSyncstatus": {
+            "new": "Neu",
+            "unclean": "Nicht synchronisiert",
+            "synced": "Synchronisiert",
+            "failed": "Fehlgeschlagen",
+            "unsupported": "Nicht unterstützt"
+        }
+    },
+    "tooltips": {
+        "syncStatus": "Globaler Synchronisationsstatus: synced = Alle Dokumente synchronisiert, unclean = Mindestens ein Dokument ist neu oder hat Änderungen, pending_sync = Synchronisierung wurde gestartet aber noch nicht abgeschlossen. Wird automatisch basierend auf den Dokumenten-Status aktualisiert.",
+        "lastSync": "Zeitpunkt der letzten erfolgreichen Synchronisation aller Dokumente",
+        "aktivierungsstatus": "Aktivierungsstatus des AI Knowledge Entries: new = Neu angelegt, active = Aktiv synchronisiert, paused = Synchronisation pausiert, deactivated = Synchronisation deaktiviert",
+        "datenbankId": "Eindeutige ID in der AI-Datenbank"
+    }
+}

custom/Espo/Custom/Resources/i18n/de_DE/CAIKnowledgeCDokumente.json

@@ -0,0 +1,30 @@
+{
+    "fields": {
+        "cAIKnowledge": "AI Knowledge",
+        "cDokumente": "Dokument",
+        "aiDocumentId": "AI Dokument-ID",
+        "syncstatus": "Sync-Status",
+        "lastSync": "Letzte Synchronisation",
+        "syncedHash": "Sync-Hash"
+    },
+    "links": {
+        "cAIKnowledge": "AI Knowledge",
+        "cDokumente": "Dokument"
+    },
+    "labels": {
+        "Create CAIKnowledgeCDokumente": "Verknüpfung erstellen"
+    },
+    "options": {
+        "syncstatus": {
+            "new": "Neu",
+            "unclean": "Geändert",
+            "synced": "Synchronisiert",
+            "failed": "Fehler",
+            "unsupported": "Nicht unterstützt"
+        }
+    },
+    "tooltips": {
+        "aiDocumentId": "Externe AI-Dokument-Referenz-ID",
+        "syncedHash": "Hash-Wert des zuletzt synchronisierten Dokument-Zustands"
+    }
+}

custom/Espo/Custom/Resources/i18n/de_DE/CAIKnowledgeDokumente.json

@@ -0,0 +1,30 @@
+{
+    "fields": {
+        "cAIKnowledge": "AI Knowledge",
+        "cDokumente": "Dokument",
+        "aiDocumentId": "AI Dokument-ID",
+        "syncstatus": "Sync-Status",
+        "lastSync": "Letzte Synchronisation",
+        "syncedHash": "Sync-Hash"
+    },
+    "links": {
+        "cAIKnowledge": "AI Knowledge",
+        "cDokumente": "Dokument"
+    },
+    "labels": {
+        "Create CAIKnowledgeCDokumente": "Verknüpfung erstellen"
+    },
+    "options": {
+        "syncstatus": {
+            "new": "Neu",
+            "unclean": "Geändert",
+            "synced": "Synchronisiert",
+            "failed": "Fehler",
+            "unsupported": "Nicht unterstützt"
+        }
+    },
+    "tooltips": {
+        "aiDocumentId": "Externe AI-Dokument-Referenz-ID",
+        "syncedHash": "Hash-Wert des zuletzt synchronisierten Dokument-Zustands"
+    }
+}

custom/Espo/Custom/Resources/i18n/de_DE/CAdvowareAkten.json

@@ -1,14 +1,47 @@
 {
     "links": {
-    "meetings": "Termine",
         "calls": "Anrufe",
         "tasks": "Aufgaben",
-    "cDokumente": "Dokumente",
+        "vmhRumungsklage": "Räumungsklagen",
-    "cAICollection": "AI Collection",
+        "mietinkasso": "Mietinkasso",
-    "cmietinkassos": "Mietinkassos",
+        "kuendigungen": "Kündigungen",
-    "cvmhRumungsklages": "Räumungsklagen"
+        "dokumentes": "Dokumente"
     },
     "labels": {
-    "Create CAdvowareAkten": "Advoware Akte erstellen"
+        "Create CAdvowareAkten": "Advoware Akten erstellen"
+    },
+    "fields": {
+        "vmhRumungsklage": "Räumungsklagen",
+        "mietinkasso": "Mietinkasso",
+        "aktenzeichen": "Aktenzeichen",
+        "aktennummer": "Aktennummer",
+        "syncStatus": "Sync-Status",
+        "lastSync": "Letzte Synchronisation",
+        "aktivierungsstatus": "Aktivierungsstatus",
+        "dokumentes": "Dokumente",
+        "dokumenteHnr": "HNR",
+        "dokumenteSyncstatus": "Sync-Status",
+        "dokumenteLastSync": "Letzter Sync",
+        "dokumenteSyncedHash": "Sync-Hash"
+    },
+    "options": {
+        "syncStatus": {
+            "synced": "Synchronisiert",
+            "unclean": "Nicht synchronisiert",
+            "pending_sync": "Synchronisierung ausstehend",
+            "failed": "Fehlgeschlagen"
+        },
+        "aktivierungsstatus": {
+            "new": "Neu",
+            "import": "Import",
+            "active": "Aktiv",
+            "paused": "Pausiert",
+            "deactivated": "Deaktiviert"
+        }
+    },
+    "tooltips": {
+        "syncStatus": "Globaler Synchronisationsstatus: synced = Alle Dokumente synchronisiert, unclean = Mindestens ein Dokument ist neu oder hat Änderungen, pending_sync = Synchronisierung wurde gestartet aber noch nicht abgeschlossen, failed = Synchronisierung fehlgeschlagen. Wird automatisch basierend auf den Dokumenten-Status aktualisiert.",
+        "lastSync": "Zeitpunkt der letzten erfolgreichen Synchronisation aller Dokumente",
+        "aktivierungsstatus": "Aktivierungsstatus der Akte: new = Neu angelegt, import = Aus Advoware importiert, active = Aktiv synchronisiert, paused = Synchronisation pausiert, deactivated = Synchronisation deaktiviert"
     }
 }

custom/Espo/Custom/Resources/i18n/de_DE/CAdvowareAktenCDokumente.json

@@ -10,6 +10,7 @@
         "cDokumenteId": "Dokument ID",
         "hnr": "HNR",
         "syncStatus": "Sync-Status",
+        "syncedHash": "Sync-Hash",
         "deleted": "Gelöscht"
     },
     "links": {
@@ -26,6 +27,7 @@
     },
     "tooltips": {
         "hnr": "Advoware HNR Referenz für dieses Dokument",
-        "syncStatus": "Synchronisierungsstatus mit Advoware"
+        "syncStatus": "Synchronisierungsstatus mit Advoware",
+        "syncedHash": "Hash-Wert des zuletzt synchronisierten Dokument-Zustands (zur Änderungserkennung)"
     }
 }

custom/Espo/Custom/Resources/i18n/de_DE/CAkten.json

@@ -0,0 +1,80 @@
+{
+    "links": {
+        "calls": "Anrufe",
+        "tasks": "Aufgaben",
+        "vmhRumungsklage": "Räumungsklagen",
+        "mietinkasso": "Mietinkasso",
+        "kuendigungen": "Kündigungen",
+        "dokumentes": "Dokumente"
+    },
+    "labels": {
+        "Create CAkten": "Erstellen Akten"
+    },
+    "fields": {
+        "vmhRumungsklage": "Räumungsklagen",
+        "mietinkasso": "Mietinkasso",
+        "aktenzeichen": "Aktenzeichen",
+        "aktennummer": "Aktennummer",
+        "syncStatus": "Advoware Sync-Status",
+        "lastSync": "Advoware Letzter Sync",
+        "aktivierungsstatus": "Advoware Aktivierungsstatus",
+        "aiCollectionId": "AI Collection-ID",
+        "aiAktivierungsstatus": "AI Aktivierungsstatus",
+        "aiSyncStatus": "AI Sync-Status",
+        "aiLastSync": "AI Letzter Sync",
+        "globalSyncStatus": "Globaler Sync-Status",
+        "globalLastSync": "Globaler letzter Sync",
+        "syncSchalter": "Sync aktiv",
+        "dokumentes": "Dokumente",
+        "rubrum": "Rubrum"
+    },
+    "options": {
+        "syncStatus": {
+            "synced": "Synchronisiert",
+            "unclean": "Nicht synchronisiert",
+            "pending_sync": "Synchronisierung ausstehend",
+            "failed": "Fehlgeschlagen"
+        },
+        "aktivierungsstatus": {
+            "new": "Neu",
+            "import": "Import",
+            "active": "Aktiv",
+            "paused": "Pausiert",
+            "deactivated": "Deaktiviert"
+        },
+        "aiAktivierungsstatus": {
+            "new": "Neu",
+            "import": "Import",
+            "active": "Aktiv",
+            "paused": "Pausiert",
+            "deactivated": "Deaktiviert"
+        },
+        "aiSyncStatus": {
+            "synced": "Synchronisiert",
+            "unclean": "Nicht synchronisiert",
+            "pending_sync": "Synchronisierung ausstehend",
+            "failed": "Fehlgeschlagen"
+        },
+        "globalSyncStatus": {
+            "synced": "Synchronisiert",
+            "unclean": "Nicht synchronisiert",
+            "pending_sync": "Synchronisierung ausstehend",
+            "failed": "Fehlgeschlagen"
+        }
+    },
+    "tooltips": {
+        "syncStatus": "Advoware-Synchronisationsstatus: synced = Alle Dokumente synchronisiert, unclean = Mindestens ein Dokument ist neu oder hat Änderungen, pending_sync = Synchronisierung ausstehend, failed = Fehlgeschlagen.",
+        "lastSync": "Zeitpunkt der letzten erfolgreichen Advoware-Synchronisation",
+        "aktivierungsstatus": "Advoware Aktivierungsstatus: new = Neu angelegt, import = Aus Advoware importiert, active = Aktiv synchronisiert, paused = Pausiert, deactivated = Deaktiviert",
+        "aiCollectionId": "Eindeutige ID der KI-Datenbank/Collection für diese Akte",
+        "aiAktivierungsstatus": "KI-Sync Aktivierungsstatus: new = Neu, import = Importiert, active = Aktiv synchronisiert, paused = Pausiert, deactivated = Deaktiviert",
+        "aiSyncStatus": "KI-Synchronisationsstatus: synced = Alle Dokumente synchronisiert, unclean = Änderungen vorhanden, pending_sync = Ausstehend, failed = Fehlgeschlagen",
+        "aiLastSync": "Zeitpunkt der letzten erfolgreichen KI-Synchronisation",
+        "advowareSyncEnabled": "Advoware-Synchronisation für diese Akte aktivieren oder deaktivieren",
+        "aiSyncEnabled": "KI-Synchronisation für diese Akte aktivieren oder deaktivieren",
+        "globalSyncStatus": "Übergreifender Sync-Status über alle Synchronisationssysteme",
+        "globalLastSync": "Zeitpunkt des letzten Sync-Vorgangs über alle Systeme",
+        "syncSchalter": "Globaler Sync-Schalter: aktiviert oder deaktiviert alle Synchronisationen für diese Akte",
+        "rubrum": "Rubrum der Akte aus Advoware (Kurzbezeichnung der Parteien)"
+    }
+}

custom/Espo/Custom/Resources/i18n/de_DE/CAktenCDokumente.json

@@ -0,0 +1,33 @@
+{
+    "labels": {
+        "Create CAktenCDokumente": "Advoware-Dokument-Verknüpfung erstellen",
+        "CAktenCDokumente": "Advoware-Dokument-Verknüpfungen"
+    },
+    "fields": {
+        "cAkten": "Akte",
+        "cAktenId": "Akten-ID",
+        "cDokumente": "Dokument",
+        "cDokumenteId": "Dokument ID",
+        "hnr": "HNR",
+        "syncStatus": "Sync-Status",
+        "syncedHash": "Sync-Hash",
+        "deleted": "Gelöscht"
+    },
+    "links": {
+        "cAkten": "Akte",
+        "cDokumente": "Dokument"
+    },
+    "options": {
+        "syncStatus": {
+            "new": "Neu",
+            "changed": "Geändert",
+            "synced": "Synchronisiert",
+            "deleted": "Gelöscht"
+        }
+    },
+    "tooltips": {
+        "hnr": "Advoware HNR Referenz für dieses Dokument",
+        "syncStatus": "Synchronisierungsstatus mit Advoware",
+        "syncedHash": "Hash-Wert des zuletzt synchronisierten Dokument-Zustands (zur Änderungserkennung)"
+    }
+}

custom/Espo/Custom/Resources/i18n/de_DE/CDokumente.json

@@ -2,16 +2,15 @@
     "fields": {
         "dokument": "Download",
         "preview": "Vorschau",
-        "ydocumentuuid": "Y-Document-UUID",
+        "blake3hash": "Blake3-Hash",
-        "md5sum": "MD5-Prüfsumme",
+        "hnr": "HNR (Advoware)",
-        "sha256": "SHA256-Prüfsumme",
+        "syncStatus": "Advoware Sync-Status",
-        "aktennr": "Advoware Identifikator",
+        "syncedHash": "Advoware Sync-Hash",
-        "advowareLastSync": "Advoware letzte Synchronisation",
+        "usn": "USN",
-        "syncStatus": "Sync-Status",
+        "dateipfad": "Dateipfad",
-        "xaiId": "x.AI ID",
+        "lastSyncTimestamp": "Advoware Letzter Sync",
-        "xaiCollections": "x.AI Collections",
+        "advowareArt": "Advoware Art",
-        "xaiSyncStatus": "Sync-Status",
+        "advowareBemerkung": "Advoware Bemerkung",
-        "fileStatus": "Datei-Status",
         "contactsvmhdokumente": "Freigegebene Nutzer",
         "vmhMietverhltnisesDokumente": "Mietverhältnisse",
         "vmhErstgespraechsdokumente": "Erstgespräche",
@@ -20,7 +19,19 @@
         "beteiligte2dokumente": "Beteiligte",
         "mietobjekt2dokumente": "Mietobjekte",
         "mietinkassosdokumente": "Mietinkasso",
-        "kndigungensdokumente": "Kündigungen"
+        "kndigungensdokumente": "Kündigungen",
+        "aIKnowledges": "AI Knowledge",
+        "aiKnowledgeAiDocumentId": "AI Document ID",
+        "aiKnowledgeSyncstatus": "AI Sync-Status",
+        "aiKnowledgeLastSync": "AI Letzter Sync",
+        "cAkten": "Akte",
+        "cAktenId": "Akten-ID",
+        "cAktenName": "Aktenname",
+        "aiCollectionId": "AI Collection-ID",
+        "aiSyncHash": "AI Sync-Hash",
+        "aiSyncStatus": "AI Sync-Status",
+        "aiLastSync": "AI Letzter Sync",
+        "aiFileId": "AI File-ID"
     },
     "links": {
         "contactsvmhdokumente": "Freigegebene Nutzer",
@@ -32,40 +43,42 @@
         "mietobjekt2dokumente": "Mietobjekte",
         "mietinkassosdokumente": "Mietinkasso",
         "kndigungensdokumente": "Kündigungen",
-        "cAICollections": "AI Collections",
+        "aIKnowledges": "AI Knowledge",
-        "cAdvowareAkten": "Advoware-Akten"
+        "cAkten": "Akte"
     },
     "labels": {
         "Create CDokumente": "Dokument erstellen"
     },
     "tooltips": {
-        "aktennr": "Eindeutige Dokument-Nummer aus Advoware",
+        "blake3hash": "Kryptografischer Blake3-Hash der Datei (schneller und sicherer als MD5/SHA256)",
-        "advowareLastSync": "Zeitpunkt der letzten Synchronisation mit Advoware",
+        "hnr": "Hierarchische Referenznummer in Advoware",
-        "syncStatus": "Status der Advoware-Synchronisation: pending_sync = Warte auf Sync, clean = erfolgreich synchronisiert, unclean = Änderungen ausstehend, failed = Fehler, no_sync = Nicht synchronisiert",
+        "syncStatus": "Advoware Sync-Status: new=neu, unclean=geändert, synced=synchronisiert, failed=Fehler, unsupported=nicht unterstützt",
-        "xaiId": "Eindeutige ID für x.AI Synchronisation",
+        "syncedHash": "Hash-Wert bei letzter erfolgreicher Advoware-Synchronisation",
-        "xaiCollections": "Liste der x.AI Collections für dieses Dokument",
+        "usn": "Update Sequence Number - Versionsnummer für Synchronisation",
-        "xaiSyncStatus": "Status der x.AI Synchronisation: pending_sync = Warte auf Sync, clean = erfolgreich synchronisiert, unclean = Änderungen ausstehend, failed = Fehler, no_sync = Nicht synchronisiert",
+        "dateipfad": "Windows-Dateipfad des Dokuments in Advoware",
-        "fileStatus": "Status der Datei: new = neu hochgeladen, changed = geändert, synced = synchronisiert"
+        "lastSyncTimestamp": "Zeitstempel der letzten erfolgreichen Advoware-Synchronisation",
+        "advowareArt": "Dokumententyp/Art wie in Advoware klassifiziert",
+        "advowareBemerkung": "Bemerkungsfeld aus Advoware - wird bei Sync übernommen",
+        "aiCollectionId": "ID der KI-Collection, in der dieses Dokument indexiert ist",
+        "aiSyncHash": "Hash-Wert bei letzter erfolgreicher KI-Synchronisation",
+        "aiSyncStatus": "Synchronisationsstatus mit der KI-Datenbank: new=neu, unclean=geändert, synced=synchronisiert, failed=Fehler, unsupported=nicht unterstützt",
+        "aiLastSync": "Zeitstempel der letzten erfolgreichen KI-Synchronisation",
+        "aiFileId": "Datei-ID in der KI-Datenbank nach erfolgter Synchronisation"
     },
     "options": {
         "syncStatus": {
-            "pending_sync": "Warte auf Sync",
-            "clean": "Synchronisiert",
-            "unclean": "Änderungen ausstehend",
-            "failed": "Fehlgeschlagen",
-            "no_sync": "Kein Sync"
-        },
-        "xaiSyncStatus": {
-            "pending_sync": "Warte auf Sync",
-            "clean": "Synchronisiert",
-            "unclean": "Abweichungen",
-            "failed": "Fehlgeschlagen",
-            "no_sync": "Kein Sync"
-        },
-        "fileStatus": {
             "new": "Neu",
-            "changed": "Geändert",
+            "unclean": "Geändert",
-            "synced": "Synchronisiert"
+            "synced": "Synchronisiert",
+            "failed": "Fehler",
+            "unsupported": "Nicht unterstützt"
+        },
+        "aiSyncStatus": {
+            "new": "Neu",
+            "unclean": "Geändert",
+            "synced": "Synchronisiert",
+            "failed": "Fehler",
+            "unsupported": "Nicht unterstützt"
         }
     }
 }

custom/Espo/Custom/Resources/i18n/de_DE/CKuendigung.json

@@ -9,6 +9,8 @@
     "gekuendigte": "Mieter",
     "dokumenteskuendigung": "Dokumente",
     "contactsKuendigung": "Portal-Freigaben",
+    "advowareAkten": "Advoware Akte",
+    "vmhRumungsklages": "Räumungsklagen",
     "pulse": "Pulse"
   },
   "labels": {
@@ -32,7 +34,7 @@
     "modifiedBy": "Geändert von",
     "freigeschalteteNutzer": "Freigeschaltete Nutzer",
     "collaborators": "Mitarbeiter",
-    "advowareAktenzeichen": "Advoware Aktenzeichen",
+    "advowareAkten": "Advoware Akte",
     "aktennr": "Advoware Identifikator",
     "advowareLastSync": "Letzter Sync",
     "syncStatus": "Sync Status",
@@ -104,7 +106,6 @@
     }
   },
   "tooltips": {
-    "advowareAktenzeichen": "Aktenzeichen aus Advoware für die Synchronisation",
     "aktennr": "Eindeutige Kündigungs-Nummer aus Advoware",
     "syncStatus": "Status der Advoware-Synchronisation: pending_sync = Warte auf Sync, clean = erfolgreich synchronisiert, unclean = Änderungen ausstehend, failed = Fehler, no_sync = Nicht synchronisiert",
     "sendungsverfolgungsnummer": "Sendungsverfolgungsnummer für Einschreiben",

custom/Espo/Custom/Resources/i18n/de_DE/CMietinkasso.json

@@ -1,15 +1,10 @@
 {
     "fields": {
-    "advowareAktenzeichen": "Advoware Aktenzeichen",
-    "aktennr": "Advoware Identifikator",
-    "advowareLastSync": "Advoware letzte Synchronisation",
-    "syncStatus": "Sync-Status",
         "klaeger": "Kläger",
         "beklagte": "Beklagte",
         "vmhMietverhltnises": "Mietverhältnisse",
         "contactsMietinkasso": "Freigegebene Nutzer",
         "dokumentesmietinkasso": "Dokumente",
-    "gerichtsrubrum": "Gerichtsrubrum",
         "gegenstandswert": "Gegenstandswert",
         "kuendigungsservice": "Kündigungsservice",
         "aussergerichtlicheGebuehren13": "Außergerichtliche Gebühren 1,3",
@@ -18,12 +13,8 @@
         "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
         "collaborators": "Mitarbeiter",
         "vmhVermietersMIK": "Vermieter",
-    "cAdvowareAkte": "Advoware-Akte",
+        "advowareAkten": "Advoware Akten",
-    "cAdvowareAkteId": "Advoware-Akte ID",
+        "aIKnowledge": "AI Knowledge"
-    "cAdvowareAkteName": "Advoware-Akte Name",
-    "cAICollection": "AI Collection",
-    "cAICollectionId": "AI Collection ID",
-    "cAICollectionName": "AI Collection Name"
     },
     "links": {
         "meetings": "Termine",
@@ -38,25 +29,14 @@
         "collaborators": "Mitarbeiter",
         "vmhVermietersMIK": "Vermieter",
         "pulse": "Pulse",
-    "cAdvowareAkte": "Advoware-Akte",
+        "advowareAkten": "Advoware Akten",
-    "cAICollection": "AI Collection"
+        "aIKnowledge": "AI Knowledge"
     },
     "labels": {
         "Create CMietinkasso": "Mietinkasso erstellen"
     },
     "tooltips": {
-    "advowareAktenzeichen": "Aktenzeichen aus dem Advoware-System",
+        "gegenstandswert": "Wert des Streitgegenstands",
-    "aktennr": "Eindeutige Inkasso-Nummer aus Advoware",
+        "kuendigungsservice": "Kündigungsservice aktiviert"
-    "advowareLastSync": "Zeitpunkt der letzten Synchronisation mit Advoware",
-    "syncStatus": "Status der Advoware-Synchronisation: pending_sync = Warte auf Sync, clean = erfolgreich synchronisiert, unclean = Änderungen ausstehend, failed = Fehler, no_sync = Nicht synchronisiert"
-  },
-  "options": {
-    "syncStatus": {
-      "pending_sync": "Warte auf Sync",
-      "clean": "Synchronisiert",
-      "unclean": "Änderungen ausstehend",
-      "failed": "Fehlgeschlagen",
-      "no_sync": "Kein Sync"
-    }
     }
 }

custom/Espo/Custom/Resources/i18n/de_DE/CVmhRumungsklage.json

@@ -1,11 +1,6 @@
 {
     "fields": {
         "portalUser": "Portalnutzer",
-    "advowareAktenzeichen": "Advoware Aktenzeichen",
-    "aktennr": "Advoware Identifikator",
-    "advowareLastSync": "Advoware letzte Synchronisation",
-    "syncStatus": "Sync-Status",
-    "xaiCollectionId": "x.AI Collection ID",
         "klaeger": "Kläger",
         "beklagte": "Beklagte",
         "vmhMietverhltnises": "Mietverhältnisse",
@@ -20,12 +15,8 @@
         "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
         "collaborators": "Mitarbeiter",
         "vmhVermietersRKL": "Vermieter",
-    "cAdvowareAkte": "Advoware-Akte",
+        "advowareAkten": "Advoware Akten",
-    "cAdvowareAkteId": "Advoware-Akte ID",
+        "aIKnowledge": "AI Knowledge"
-    "cAdvowareAkteName": "Advoware-Akte Name",
-    "cAICollection": "AI Collection",
-    "cAICollectionId": "AI Collection ID",
-    "cAICollectionName": "AI Collection Name"
     },
     "links": {
         "meetings": "Termine",
@@ -34,32 +25,22 @@
         "klaeger": "Kläger",
         "beklagte": "Beklagte",
         "vmhMietverhltnises": "Mietverhältnisse",
+        "kuendigungen": "Kündigungen",
         "contactsRumungsklage": "Freigegebene Nutzer",
         "dokumentesvmhraumungsklage": "Dokumente",
         "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
         "collaborators": "Mitarbeiter",
         "vmhVermietersRKL": "Vermieter",
         "pulse": "Pulse",
-    "cAdvowareAkte": "Advoware-Akte",
+        "advowareAkten": "Advoware Akten",
-    "cAICollection": "AI Collection"
+        "aIKnowledge": "AI Knowledge"
     },
     "labels": {
         "Create CVmhRumungsklage": "Räumungsklage erstellen"
     },
     "tooltips": {
-    "advowareAktenzeichen": "Aktenzeichen aus dem Advoware-System",
+        "gerichtsrubrum": "Rubrum des Gerichtsverfahrens",
-    "aktennr": "Eindeutige Klage-Nummer aus Advoware",
+        "gegenstandswert": "Wert des Streitgegenstands",
-    "advowareLastSync": "Zeitpunkt der letzten Synchronisation mit Advoware",
+        "kuendigungsservice": "Kündigungsservice aktiviert"
-    "syncStatus": "Status der Advoware-Synchronisation: pending_sync = Warte auf Sync, clean = erfolgreich synchronisiert, unclean = Änderungen ausstehend, failed = Fehler, no_sync = Nicht synchronisiert",
-    "xaiCollectionId": "Collection ID für x.AI Synchronisation"
-  },
-  "options": {
-    "syncStatus": {
-      "pending_sync": "Warte auf Sync",
-      "clean": "Synchronisiert",
-      "unclean": "Änderungen ausstehend",
-      "failed": "Fehlgeschlagen",
-      "no_sync": "Kein Sync"
-    }
     }
 }

custom/Espo/Custom/Resources/i18n/de_DE/Global.json

@@ -4,5 +4,11 @@
     },
     "labels": {
         "Log": "Log"
+    },
+    "scopeNamesPlural": {
+        "CAkten": "Akten"
+    },
+    "scopeNames": {
+        "CAkten": "Akten"
     }
 }

custom/Espo/Custom/Resources/i18n/el_GR/CAIKnowledge.json

@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Δημιουργία  AI Knowledge"
+  }
+}

custom/Espo/Custom/Resources/i18n/el_GR/CAdvowareAkten.json

@@ -5,6 +5,6 @@
     "tasks": "Εργασίες"
   },
   "labels": {
-    "Create CAdvowareAkten": "Δημιουργία Advoware Akte"
+    "Create CAdvowareAkten": "Δημιουργία Advoware Akten"
   }
 }

custom/Espo/Custom/Resources/i18n/el_GR/CAkten.json

@@ -5,6 +5,6 @@
     "tasks": "Εργασίες"
   },
   "labels": {
-    "Create CAICollection": "Δημιουργία AI Collection"
+    "Create CAkten": "Δημιουργία Advoware Akten"
   }
 }

custom/Espo/Custom/Resources/i18n/en_GB/CAkten.json

@@ -0,0 +1 @@
+{}

custom/Espo/Custom/Resources/i18n/en_US/CAICollection.json

@@ -1,19 +0,0 @@
-{
-    "fields": {
-        "cAdvowareAkte": "Advoware File",
-        "cAdvowareAkteId": "Advoware File ID",
-        "cAdvowareAkteName": "Advoware File Name"
-    },
-    "links": {
-        "meetings": "Meetings",
-        "calls": "Calls",
-        "tasks": "Tasks",
-        "cDokumente": "Documents",
-        "cAdvowareAkte": "Advoware File",
-        "cmietinkassos": "Mietinkassos",
-        "cvmhRumungsklages": "Räumungsklagen"
-    },
-    "labels": {
-        "Create CAICollection": "Create AI Collection"
-    }
-}

custom/Espo/Custom/Resources/i18n/en_US/CAICollectionCDokumente.json

@@ -1,31 +0,0 @@
-{
-    "labels": {
-        "Create CAICollectionCDokumente": "Create AI Collection Document Link",
-        "CAICollectionCDokumente": "AI Collection Document Links"
-    },
-    "fields": {
-        "cAICollection": "AI Collection",
-        "cAICollectionId": "AI Collection ID",
-        "cDokumente": "Document",
-        "cDokumenteId": "Document ID",
-        "xaifileid": "XAI File ID",
-        "syncStatus": "Sync Status",
-        "deleted": "Deleted"
-    },
-    "links": {
-        "cAICollection": "AI Collection",
-        "cDokumente": "Document"
-    },
-    "options": {
-        "syncStatus": {
-            "new": "New",
-            "changed": "Changed",
-            "synced": "Synced",
-            "deleted": "Deleted"
-        }
-    },
-    "tooltips": {
-        "xaifileid": "External XAI file ID for this document",
-        "syncStatus": "Synchronization status with XAI"
-    }
-}

custom/Espo/Custom/Resources/i18n/en_US/CAIKnowledge.json

@@ -0,0 +1,49 @@
+{
+    "fields": {
+        "dokumentes": "Dokumente",
+        "vmhRumungsklage": "Räumungsklage",
+        "mietinkasso": "Mietinkasso",
+        "datenbankId": "Database ID",
+        "syncStatus": "Sync Status",
+        "lastSync": "Last Synchronization",
+        "aktivierungsstatus": "Activation Status",
+        "dokumenteAiDocumentId": "AI Document ID",
+        "dokumenteSyncstatus": "Sync Status",
+        "dokumenteLastSync": "Last Sync",
+        "dokumenteSyncedHash": "Sync Hash"
+    },
+    "links": {
+        "dokumentes": "Dokumente",
+        "vmhRumungsklage": "Räumungsklage",
+        "mietinkasso": "Mietinkasso"
+    },
+    "labels": {
+        "Create CAIKnowledge": "Create AI Knowledge"
+    },
+    "options": {
+        "syncStatus": {
+            "synced": "Synchronized",
+            "unclean": "Not Synchronized",
+            "pending_sync": "Synchronization Pending"
+        },
+        "aktivierungsstatus": {
+            "new": "New",
+            "active": "Active",
+            "paused": "Paused",
+            "deactivated": "Deactivated"
+        },
+        "dokumenteSyncstatus": {
+            "new": "New",
+            "unclean": "Not Synchronized",
+            "synced": "Synchronized",
+            "failed": "Failed",
+            "unsupported": "Unsupported"
+        }
+    },
+    "tooltips": {
+        "syncStatus": "Global synchronization status: synced = All documents synchronized, unclean = At least one document is new or has changes, pending_sync = Synchronization started but not yet completed. Updated automatically based on document status.",
+        "lastSync": "Timestamp of the last successful synchronization of all documents",
+        "aktivierungsstatus": "Activation status of the AI Knowledge entry: new = Newly created, active = Actively synchronized, paused = Synchronization paused, deactivated = Synchronization deactivated",
+        "datenbankId": "Unique ID in the AI database"
+    }
+}

custom/Espo/Custom/Resources/i18n/en_US/CAIKnowledgeCDokumente.json

@@ -0,0 +1,30 @@
+{
+    "fields": {
+        "cAIKnowledge": "AI Knowledge",
+        "cDokumente": "Document",
+        "aiDocumentId": "AI Document ID",
+        "syncstatus": "Sync Status",
+        "lastSync": "Last Sync",
+        "syncedHash": "Synced Hash"
+    },
+    "links": {
+        "cAIKnowledge": "AI Knowledge",
+        "cDokumente": "Document"
+    },
+    "labels": {
+        "Create CAIKnowledgeCDokumente": "Create Link"
+    },
+    "options": {
+        "syncstatus": {
+            "new": "New",
+            "unclean": "Changed",
+            "synced": "Synced",
+            "failed": "Failed",
+            "unsupported": "Unsupported"
+        }
+    },
+    "tooltips": {
+        "aiDocumentId": "External AI document reference ID",
+        "syncedHash": "Hash value of last synced document state"
+    }
+}

custom/Espo/Custom/Resources/i18n/en_US/CAIKnowledgeDokumente.json

@@ -0,0 +1,30 @@
+{
+    "fields": {
+        "cAIKnowledge": "AI Knowledge",
+        "cDokumente": "Document",
+        "aiDocumentId": "AI Document ID",
+        "syncstatus": "Sync Status",
+        "lastSync": "Last Sync",
+        "syncedHash": "Synced Hash"
+    },
+    "links": {
+        "cAIKnowledge": "AI Knowledge",
+        "cDokumente": "Document"
+    },
+    "labels": {
+        "Create CAIKnowledgeCDokumente": "Create Link"
+    },
+    "options": {
+        "syncstatus": {
+            "new": "New",
+            "unclean": "Changed",
+            "synced": "Synced",
+            "failed": "Failed",
+            "unsupported": "Unsupported"
+        }
+    },
+    "tooltips": {
+        "aiDocumentId": "External AI document reference ID",
+        "syncedHash": "Hash value of last synced document state"
+    }
+}

custom/Espo/Custom/Resources/i18n/en_US/CAdvowareAkten.json

@@ -1,16 +1,48 @@
 {
     "fields": {
+        "vmhRumungsklage": "Räumungsklagen",
+        "mietinkasso": "Mietinkasso",
+        "aktenzeichen": "Aktenzeichen",
+        "aktennummer": "Aktennummer",
+        "syncStatus": "Sync Status",
+        "lastSync": "Last Synchronization",
+        "aktivierungsstatus": "Activation Status",
+        "dokumentes": "Dokumente",
+        "dokumenteHnr": "HNR",
+        "dokumenteSyncstatus": "Sync Status",
+        "dokumenteLastSync": "Last Sync",
+        "dokumenteSyncedHash": "Sync Hash"
     },
     "links": {
         "meetings": "Meetings",
         "calls": "Calls",
         "tasks": "Tasks",
-        "cDokumente": "Documents",
+        "vmhRumungsklage": "Räumungsklagen",
-        "cAICollection": "AI Collection",
+        "mietinkasso": "Mietinkasso",
-        "cmietinkassos": "Mietinkassos",
+        "kuendigungen": "Terminations",
-        "cvmhRumungsklages": "Räumungsklagen"
+        "dokumentes": "Dokumente"
     },
     "labels": {
-        "Create CAdvowareAkten": "Create Advoware Akte"
+        "Create CAdvowareAkten": "Create Advoware Akten"
+    },
+    "options": {
+        "syncStatus": {
+            "synced": "Synchronized",
+            "unclean": "Not Synchronized",
+            "pending_sync": "Synchronization Pending",
+            "failed": "Failed"
+        },
+        "aktivierungsstatus": {
+            "new": "New",
+            "import": "Import",
+            "active": "Active",
+            "paused": "Paused",
+            "deactivated": "Deactivated"
+        }
+    },
+    "tooltips": {
+        "syncStatus": "Global synchronization status: synced = All documents synchronized, unclean = At least one document is new or has changes, pending_sync = Synchronization started but not yet completed, failed = Synchronization failed. Updated automatically based on document status.",
+        "lastSync": "Timestamp of the last successful synchronization of all documents",
+        "aktivierungsstatus": "Activation status of the file: new = Newly created, import = Imported from Advoware, active = Actively synchronized, paused = Synchronization paused, deactivated = Synchronization deactivated"
     }
 }

custom/Espo/Custom/Resources/i18n/en_US/CAdvowareAktenCDokumente.json

@@ -10,6 +10,7 @@
         "cDokumenteId": "Document ID",
         "hnr": "HNR",
         "syncStatus": "Sync Status",
+        "syncedHash": "Sync Hash",
         "deleted": "Deleted"
     },
     "links": {
@@ -26,6 +27,7 @@
     },
     "tooltips": {
         "hnr": "Advoware HNR reference for this document",
-        "syncStatus": "Synchronization status with Advoware"
+        "syncStatus": "Synchronization status with Advoware",
+        "syncedHash": "Hash value of the last synchronized document state (for change detection)"
     }
 }

custom/Espo/Custom/Resources/i18n/en_US/CAkten.json

@@ -0,0 +1,81 @@
+{
+    "links": {
+        "meetings": "Meetings",
+        "calls": "Calls",
+        "tasks": "Tasks",
+        "vmhRumungsklage": "Eviction Lawsuits",
+        "mietinkasso": "Rent Collection",
+        "kuendigungen": "Terminations",
+        "dokumentes": "Documents"
+    },
+    "labels": {
+        "Create CAkten": "Erstellen Akten"
+    },
+    "fields": {
+        "vmhRumungsklage": "Eviction Lawsuit",
+        "mietinkasso": "Rent Collection",
+        "aktenzeichen": "File Reference",
+        "aktennummer": "File Number",
+        "syncStatus": "Advoware Sync Status",
+        "lastSync": "Advoware Last Sync",
+        "aktivierungsstatus": "Advoware Activation Status",
+        "aiCollectionId": "AI Collection ID",
+        "aiAktivierungsstatus": "AI Activation Status",
+        "aiSyncStatus": "AI Sync Status",
+        "aiLastSync": "AI Last Sync",
+        "globalSyncStatus": "Global Sync Status",
+        "globalLastSync": "Global Last Sync",
+        "syncSchalter": "Sync Active",
+        "dokumentes": "Documents",
+        "rubrum": "Rubrum"
+    },
+    "options": {
+        "syncStatus": {
+            "synced": "Synchronized",
+            "unclean": "Not Synchronized",
+            "pending_sync": "Synchronization Pending",
+            "failed": "Failed"
+        },
+        "aktivierungsstatus": {
+            "new": "New",
+            "import": "Import",
+            "active": "Active",
+            "paused": "Paused",
+            "deactivated": "Deactivated"
+        },
+        "aiAktivierungsstatus": {
+            "new": "New",
+            "import": "Import",
+            "active": "Active",
+            "paused": "Paused",
+            "deactivated": "Deactivated"
+        },
+        "aiSyncStatus": {
+            "synced": "Synchronized",
+            "unclean": "Not Synchronized",
+            "pending_sync": "Synchronization Pending",
+            "failed": "Failed"
+        },
+        "globalSyncStatus": {
+            "synced": "Synchronized",
+            "unclean": "Not Synchronized",
+            "pending_sync": "Synchronization Pending",
+            "failed": "Failed"
+        }
+    },
+    "tooltips": {
+        "syncStatus": "Advoware sync status: synced = All documents synchronized, unclean = At least one document changed, pending_sync = Pending, failed = Failed.",
+        "lastSync": "Timestamp of last successful Advoware synchronization",
+        "aktivierungsstatus": "Advoware activation status: new = Newly created, import = Imported from Advoware, active = Actively synchronized, paused = Paused, deactivated = Deactivated",
+        "aiCollectionId": "Unique ID of the AI database/collection for this file",
+        "aiAktivierungsstatus": "AI sync activation status: new = New, import = Imported, active = Actively synchronized, paused = Paused, deactivated = Deactivated",
+        "aiSyncStatus": "AI sync status: synced = All documents synchronized, unclean = Changes pending, pending_sync = Pending, failed = Failed",
+        "aiLastSync": "Timestamp of last successful AI synchronization",
+        "advowareSyncEnabled": "Enable or disable Advoware synchronization for this file",
+        "aiSyncEnabled": "Enable or disable AI synchronization for this file",
+        "globalSyncStatus": "Overall sync status across all synchronization systems",
+        "globalLastSync": "Timestamp of last sync across all systems",
+        "syncSchalter": "Global sync switch: enables or disables all synchronizations for this file",
+        "rubrum": "Rubrum of the file from Advoware (short designation of parties)"
+    }
+}

custom/Espo/Custom/Resources/i18n/en_US/CAktenCDokumente.json

@@ -0,0 +1,33 @@
+{
+    "labels": {
+        "Create CAktenCDokumente": "Create Advoware Document Link",
+        "CAktenCDokumente": "Advoware Document Links"
+    },
+    "fields": {
+        "cAkten": "File",
+        "cAktenId": "File ID",
+        "cDokumente": "Document",
+        "cDokumenteId": "Document ID",
+        "hnr": "HNR",
+        "syncStatus": "Sync Status",
+        "syncedHash": "Sync Hash",
+        "deleted": "Deleted"
+    },
+    "links": {
+        "cAkten": "File",
+        "cDokumente": "Document"
+    },
+    "options": {
+        "syncStatus": {
+            "new": "New",
+            "changed": "Changed",
+            "synced": "Synced",
+            "deleted": "Deleted"
+        }
+    },
+    "tooltips": {
+        "hnr": "Advoware HNR reference for this document",
+        "syncStatus": "Synchronization status with Advoware",
+        "syncedHash": "Hash value of the last synchronized document state (for change detection)"
+    }
+}