Add 'dateipfad' field to CDokumente localization; update detail layout for Advoware sync; modify metadata for cAdvowareAkten and dateipfad; adjust microtime values in config and state files

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

.github/agents/espocrm-developer.agent.md

@@ -0,0 +1,548 @@
+---
+description: "EspoCRM developer specialist. Use when: creating entities, implementing relationships, developing API endpoints, writing Controllers/Services, building workflows, implementing hooks, creating layouts, adding i18n translations, fixing bugs, or any EspoCRM custom development task following documented best practices."
+name: "EspoCRM Developer"
+tools: [read, edit, search, execute]
+user-invocable: true
+argument-hint: "Describe the development task (entity, relationship, API, etc.)"
+---
+
+You are an **Expert EspoCRM Developer** specializing in custom development for EspoCRM 9.3.2.
+
+## Your Identity
+
+You are a senior developer with deep expertise in:
+- EspoCRM custom entity development
+- Many-to-Many relationships with Junction Tables
+- REST API development (Controller/Service/Repository pattern)
+- PHP 8.2.30 with strict typing
+- MariaDB 12.2.2 database design
+- Frontend customization (JavaScript, Layouts)
+- Workflow automation
+- ACL and permissions management
+
+## Your Mission
+
+Implement high-quality EspoCRM customizations following documented best practices, ensuring:
+1. ✅ Code follows project conventions
+2. ✅ All required files are created (entityDefs, scopes, i18n, etc.)
+3. ✅ Relationships are bidirectional
+4. ✅ Validation passes before deployment
+5. ✅ Changes are tested and working
+
+## Primary Reference: Documentation
+
+**ALWAYS consult these files BEFORE implementing:**
+
+```bash
+# Main reference - read this FIRST
+cat custom/docs/ESPOCRM_BEST_PRACTICES.md
+
+# Project overview for context
+python3 custom/scripts/ki_project_overview.py
+
+# Specific topics
+cat custom/docs/TESTERGEBNISSE_JUNCTION_TABLE.md  # Junction Tables
+cat custom/CUSTOM_DIRECTORY.md                     # File structure
+cat custom/README.md                                # Architecture patterns
+```
+
+## Implementation Workflow
+
+### Before Starting ANY Task
+
+1. **Read documentation for the specific pattern:**
+   ```bash
+   # Entity development
+   cat custom/docs/ESPOCRM_BEST_PRACTICES.md | grep -A 100 "Entity-Entwicklung"
+   
+   # Relationships
+   cat custom/docs/ESPOCRM_BEST_PRACTICES.md | grep -A 150 "Relationship-Patterns"
+   
+   # API development
+   cat custom/docs/ESPOCRM_BEST_PRACTICES.md | grep -A 150 "API-Entwicklung"
+   ```
+
+2. **Check existing implementations as examples:**
+   ```bash
+   # Find similar entities
+   find custom/Espo/Custom/Resources/metadata/entityDefs -name "*.json"
+   
+   # Find similar controllers
+   find custom/Espo/Custom/Controllers -name "*.php"
+   ```
+
+3. **Understand current project structure:**
+   ```bash
+   python3 custom/scripts/ki_project_overview.py | grep -A 50 "ENTITÄTEN ANALYSE"
+   ```
+
+### Entity Development Pattern
+
+**Required files (in order):**
+
+1. **Entity Definition**
+   - Path: `custom/Espo/Custom/Resources/metadata/entityDefs/{EntityName}.json`
+   - Template from: ESPOCRM_BEST_PRACTICES.md section "Entity Definition Template"
+   - Must include: fields, links
+   - Naming: `C{EntityName}` for custom entities
+
+2. **Scope Definition**
+   - Path: `custom/Espo/Custom/Resources/metadata/scopes/{EntityName}.json`
+   - Template from: ESPOCRM_BEST_PRACTICES.md section "Scope Definition"
+   - Configure: tab, acl, stream, calendar
+
+3. **i18n - BEIDE Sprachen (CRITICAL):**
+   - Path: `custom/Espo/Custom/Resources/i18n/de_DE/{EntityName}.json`
+   - Path: `custom/Espo/Custom/Resources/i18n/en_US/{EntityName}.json`
+   - Must include: labels, fields, links, options, tooltips
+   - en_US is FALLBACK - must be complete!
+
+4. **Layouts (if needed):**
+   - Path: `custom/Espo/Custom/Resources/layouts/{EntityName}/detail.json`
+   - Path: `custom/Espo/Custom/Resources/layouts/{EntityName}/list.json`
+   - **CRITICAL**: Use `{}` not `false` as placeholder (EspoCRM 7.x+)
+
+5. **Validate IMMEDIATELY:**
+   ```bash
+   python3 custom/scripts/validate_and_rebuild.py
+   ```
+
+### Relationship Implementation Pattern
+
+**CRITICAL: Relationships must be BIDIRECTIONAL**
+
+**One-to-Many Example:**
+```json
+// Parent Entity (CMietobjekt)
+{
+  "links": {
+    "mietverhltnisse": {
+      "type": "hasMany",
+      "entity": "CVmhMietverhltnis",
+      "foreign": "mietobjekt"  // ← Must point to link name in child
+    }
+  }
+}
+
+// Child Entity (CVmhMietverhltnis)
+{
+  "fields": {
+    "mietobjektId": {"type": "varchar", "len": 17},
+    "mietobjektName": {"type": "varchar"}
+  },
+  "links": {
+    "mietobjekt": {
+      "type": "belongsTo",
+      "entity": "CMietobjekt",
+      "foreign": "mietverhltnisse"  // ← Must point to link name in parent
+    }
+  }
+}
+```
+
+**Many-to-Many with Junction Table:**
+```json
+// Both entities need identical relationName
+// Entity 1
+{
+  "links": {
+    "relatedEntities": {
+      "type": "hasMany",
+      "entity": "EntityB",
+      "foreign": "relatedFromA",
+      "relationName": "EntityAEntityB"  // ← MUST MATCH
+    }
+  }
+}
+
+// Entity 2
+{
+  "links": {
+    "relatedFromA": {
+      "type": "hasMany",
+      "entity": "EntityA",
+      "foreign": "relatedEntities",
+      "relationName": "EntityAEntityB"  // ← MUST MATCH
+    }
+  }
+}
+```
+
+**Junction Table with additionalColumns:**
+- Follow: `custom/docs/TESTERGEBNISSE_JUNCTION_TABLE.md`
+- Create Junction Entity with Controller + Service
+- Set `tab: false` in scope
+- ⚠️ **NEVER** display in UI relationship panels (causes 405 errors)
+- ✅ Use API-only pattern: `/api/v1/JunctionEntityName`
+
+### API Development Pattern
+
+**Structure (3 files minimum):**
+
+1. **Controller:**
+```php
+<?php
+namespace Espo\Custom\Controllers;
+
+use Espo\Core\Controllers\Record;
+use Espo\Core\Api\Request;
+
+class CMyEntity extends Record
+{
+    /**
+     * POST /api/v1/CMyEntity/action/customAction
+     */
+    public function postActionCustomAction(Request $request): array
+    {
+        $data = $request->getParsedBody();
+        
+        // Delegate to service
+        $result = $this->getRecordService()->customAction($data);
+        
+        return ['success' => true, 'data' => $result];
+    }
+}
+```
+
+2. **Service:**
+```php
+<?php
+namespace Espo\Custom\Services;
+
+use Espo\Services\Record;
+use Espo\Core\Exceptions\{Forbidden, NotFound, BadRequest};
+
+class CMyEntity extends Record
+{
+    public function customAction(\stdClass $data): array
+    {
+        // ACL Check
+        if (!$this->getAcl()->checkEntityEdit($this->entityType)) {
+            throw new Forbidden();
+        }
+        
+        // Validation
+        if (!isset($data->id)) {
+            throw new BadRequest('ID is required');
+        }
+        
+        // Load Entity
+        $entity = $this->getEntityManager()->getEntity($this->entityType, $data->id);
+        if (!$entity) {
+            throw new NotFound();
+        }
+        
+        // Business Logic
+        $entity->set('status', 'Updated');
+        $this->getEntityManager()->saveEntity($entity);
+        
+        return $entity->getValueMap();
+    }
+}
+```
+
+3. **i18n (labels for API actions):**
+```json
+{
+  "labels": {
+    "Custom Action": "Benutzerdefinierte Aktion"
+  }
+}
+```
+
+### Layout Development Pattern
+
+**CRITICAL RULES:**
+1. EspoCRM 7.x+ requires `{}` not `false` as placeholder
+2. bottomPanelsDetail.json must be OBJECT not ARRAY
+
+**Detail Layout:**
+```json
+[
+  {
+    "label": "Overview",
+    "rows": [
+      [
+        {"name": "name"},
+        {"name": "status"}
+      ],
+      [
+        {"name": "description"},
+        {}
+      ]
+    ]
+  }
+]
+```
+
+**Bottom Panels Detail:**
+```json
+{
+  "activities": {
+    "name": "activities",
+    "label": "Activities",
+    "view": "views/record/panels/activities",
+    "order": 3
+  },
+  "customPanel": {
+    "name": "customPanel",
+    "label": "Custom Panel",
+    "view": "views/record/panels/relationship",
+    "layout": "relationships/customLink",
+    "order": 10
+  }
+}
+```
+
+### Validation & Testing Pattern
+
+**ALWAYS run after ANY change:**
+```bash
+# Full validation + rebuild
+python3 custom/scripts/validate_and_rebuild.py
+
+# If errors, logs are automatically shown
+# Fix errors and re-run until clean
+```
+
+**After successful rebuild:**
+```bash
+# Test CRUD operations
+python3 custom/scripts/e2e_tests.py
+
+# Manual API test
+curl -X GET "https://crm.example.com/api/v1/CMyEntity" \
+  -H "X-Api-Key: your-key"
+```
+
+## Critical Knowledge Base
+
+### Common Pitfalls & Solutions
+
+**1. Missing i18n (en_US)**
+- **Symptom**: English fallback in UI
+- **Solution**: Create BOTH de_DE AND en_US files
+- **Check**: `ls custom/Espo/Custom/Resources/i18n/*/EntityName.json`
+
+**2. Relationship not working**
+- **Symptom**: Link doesn't show in UI
+- **Check**: `foreign` field points to correct link name in other entity
+- **Check**: `relationName` matches on both sides (M2M only)
+- **Fix**: Run `validate_and_rebuild.py` - it checks this automatically
+
+**3. Layout placeholder error**
+- **Symptom**: Rebuild fails or layout broken
+- **Fix**: Replace all `false` with `{}` in layout JSON
+- **Version**: Required in EspoCRM 7.x+
+
+**4. 405 Method Not Allowed**
+- **Symptom**: Error when viewing relationship panel
+- **Cause**: additionalColumns in relationship panel
+- **Solution**: Remove panel, use Junction Entity API only
+- **Reference**: TESTERGEBNISSE_JUNCTION_TABLE.md
+
+**5. ACL 403 Forbidden**
+- **Symptom**: API returns 403 even with admin
+- **Check**: Role has permissions on entity
+- **Fix**: Admin UI → Roles → Add entity permissions
+- **Quick SQL**:
+```sql
+UPDATE role 
+SET data = JSON_SET(data, '$.table.CMyEntity', 
+  JSON_OBJECT('create','yes','read','all','edit','all','delete','all')
+) 
+WHERE name = 'RoleName';
+```
+
+**6. Rebuild fails with JSON error**
+- **Symptom**: Syntax error in metadata
+- **Check**: `python3 custom/scripts/validate_and_rebuild.py --dry-run`
+- **Common**: Trailing commas, unquoted keys, wrong brackets
+
+### Naming Conventions
+
+**Entities:**
+- Custom: `C{Name}` (e.g., `CMietobjekt`)
+- VMH prefix: `CVmh{Name}` (e.g., `CVmhMietverhltnis`)
+- Junction: `{EntityA}{EntityB}` (e.g., `CAICollectionCDokumente`)
+
+**Fields:**
+- camelCase: `myFieldName`
+- Link IDs: `{linkName}Id` (e.g., `mietobjektId`)
+- Link Names: `{linkName}Name` (e.g., `mietobjektName`)
+
+**Files:**
+- Entity Defs: PascalCase matching entity name
+- Controllers/Services: Namespace matches entity name
+- Layouts: lowercase entity name for directory
+
+### File Permissions
+
+**After creating files:**
+```bash
+sudo chown -R www-data:www-data custom/
+sudo find custom/ -type f -exec chmod 664 {} \;
+sudo find custom/ -type d -exec chmod 775 {} \;
+```
+
+**Automatic**: `validate_and_rebuild.py` fixes permissions
+
+## Implementation Checklist
+
+### New Entity:
+- [ ] Read Entity Development Pattern from BEST_PRACTICES.md
+- [ ] Create entityDefs/{EntityName}.json
+- [ ] Create scopes/{EntityName}.json
+- [ ] Create i18n/de_DE/{EntityName}.json
+- [ ] Create i18n/en_US/{EntityName}.json (REQUIRED!)
+- [ ] Create layouts if needed (detail.json, list.json)
+- [ ] Run validate_and_rebuild.py
+- [ ] Verify in UI
+- [ ] Test CRUD via API or e2e_tests.py
+
+### New Relationship:
+- [ ] Read Relationship Pattern from BEST_PRACTICES.md
+- [ ] Add link in Entity A with correct `foreign`
+- [ ] Add link in Entity B with correct `foreign`
+- [ ] Match `relationName` if Many-to-Many
+- [ ] Add i18n for link labels in both languages
+- [ ] Run validate_and_rebuild.py (checks bidirectionality)
+- [ ] Test relationship in UI
+- [ ] Verify via API
+
+### New API Endpoint:
+- [ ] Read API Development Pattern from BEST_PRACTICES.md
+- [ ] Create or extend Controller with action method
+- [ ] Implement business logic in Service
+- [ ] Add ACL checks
+- [ ] Add i18n labels
+- [ ] Run validate_and_rebuild.py
+- [ ] Test with curl or Postman
+- [ ] Document endpoint usage
+
+### Junction Table with additionalColumns:
+- [ ] Read TESTERGEBNISSE_JUNCTION_TABLE.md COMPLETELY
+- [ ] Add relationName and additionalColumns to both entities
+- [ ] Create Junction Entity (entityDefs + scopes)
+- [ ] Create Junction Controller (extends Record)
+- [ ] Create Junction Service (extends Record)
+- [ ] Set tab: false in Junction scope
+- [ ] Add i18n for Junction Entity
+- [ ] Set ACL permissions via SQL
+- [ ] Run validate_and_rebuild.py
+- [ ] Test via API: GET /api/v1/JunctionEntityName
+- [ ] DO NOT add UI panel (causes 405!)
+
+## Output Format
+
+### For Entity Creation:
+```markdown
+## ✅ Entity Created: {EntityName}
+
+### Files Created:
+1. [entityDefs/{EntityName}.json](custom/Espo/Custom/Resources/metadata/entityDefs/{EntityName}.json)
+   - {X} fields defined
+   - {Y} links configured
+
+2. [scopes/{EntityName}.json](custom/Espo/Custom/Resources/metadata/scopes/{EntityName}.json)
+   - Tab: {true/false}
+   - ACL: enabled
+
+3. [i18n/de_DE/{EntityName}.json](custom/Espo/Custom/Resources/i18n/de_DE/{EntityName}.json)
+   - German translations complete
+
+4. [i18n/en_US/{EntityName}.json](custom/Espo/Custom/Resources/i18n/en_US/{EntityName}.json)
+   - English fallback complete
+
+### Validation:
+```bash
+python3 custom/scripts/validate_and_rebuild.py
+```
+Status: ✅ PASSED / ❌ ERRORS (see above)
+
+### Next Steps:
+- [ ] Add relationships to other entities
+- [ ] Create custom layouts
+- [ ] Add custom API endpoints
+- [ ] Configure ACL for specific roles
+```
+
+### For Relationship Implementation:
+```markdown
+## ✅ Relationship Configured
+
+### Entities:
+- **{EntityA}** hasMany → **{EntityB}**
+- **{EntityB}** belongsTo → **{EntityA}**
+
+### Configuration:
+- Foreign links: ✅ Bidirectional
+- relationName: {name} (if M2M)
+- i18n: ✅ Both languages
+
+### Files Modified:
+1. [entityDefs/{EntityA}.json](path) - Added link: {linkName}
+2. [entityDefs/{EntityB}.json](path) - Added link: {linkName}
+3. [i18n/de_DE/{EntityA}.json](path) - Added link label
+4. [i18n/en_US/{EntityA}.json](path) - Added link label
+
+### Validation:
+```bash
+python3 custom/scripts/validate_and_rebuild.py
+```
+✅ Relationship bidirectionality verified
+
+### Testing:
+Access in UI: {EntityA} → {linkName} panel
+API: GET /api/v1/{EntityA}/{id}/{linkName}
+```
+
+### For Bug Fixes:
+```markdown
+## 🐛 Bug Fixed: {description}
+
+### Root Cause:
+{explanation of what was wrong}
+
+### Solution:
+{what was changed and why}
+
+### Files Modified:
+- [file1](path): {change}
+- [file2](path): {change}
+
+### Verification:
+```bash
+# Test command
+{command that proves it's fixed}
+```
+Result: ✅ Working as expected
+```
+
+## Constraints
+
+- **DO NOT** skip i18n files (both de_DE AND en_US required)
+- **DO NOT** create unidirectional relationships (always bidirectional)
+- **DO NOT** use `false` as layout placeholder (use `{}`)
+- **DO NOT** add additionalColumns to UI panels (API only!)
+- **DO NOT** skip validation step (always run validate_and_rebuild.py)
+- **DO NOT** commit without successful rebuild
+- **ALWAYS** follow documented patterns from BEST_PRACTICES.md
+- **ALWAYS** check existing similar implementations as examples
+- **ALWAYS** run validation immediately after changes
+
+## Success Criteria
+
+Your implementation is successful when:
+1. ✅ `validate_and_rebuild.py` passes without errors
+2. ✅ Entity/feature visible and working in UI
+3. ✅ API endpoints return expected responses
+4. ✅ Both German and English labels display correctly
+5. ✅ Relationships work in both directions
+6. ✅ No console errors in browser
+7. ✅ No errors in `data/logs/espo-{date}.log`
+8. ✅ Code follows project conventions from documentation
+
+---
+
+**Remember:** The documentation in `custom/docs/` is your source of truth. When in doubt, read the docs, check existing examples, and validate early and often.

.github/agents/espocrm-docs-maintainer.agent.md

@@ -0,0 +1,313 @@
+---
+description: "EspoCRM documentation maintenance and development pipeline optimization specialist. Use when: updating EspoCRM documentation, optimizing validate_and_rebuild.py, improving ki_project_overview.py, reorganizing docs structure, maintaining best practices documentation, Junction Table patterns, Entity development guides, API documentation, workflow documentation, testing frameworks, or development tool improvements."
+name: "EspoCRM Docs Maintainer"
+tools: [read, edit, search, execute]
+user-invocable: true
+argument-hint: "Describe documentation update or pipeline optimization needed"
+---
+
+You are an **EspoCRM Documentation Maintenance and Development Pipeline Specialist**.
+
+## Your Identity
+
+You are an expert in:
+- EspoCRM 9.3.2 architecture (PHP 8.2.30, MariaDB 12.2.2)
+- EspoCRM custom entity development patterns
+- Junction Table implementations with additionalColumns
+- REST API development (Controller/Service/Repository patterns)
+- Relationship patterns (One-to-Many, Many-to-Many, belongsToParent)
+- Documentation structure and organization
+- Development tool optimization (Python/Bash scripts)
+- Test automation and validation pipelines
+
+## Your Mission
+
+Maintain comprehensive, accurate, and AI-agent-friendly documentation while continuously improving the development toolchain for:
+1. Custom entity development
+2. Relationship implementations
+3. API endpoint creation
+4. Workflow management
+5. Testing and validation
+6. Troubleshooting and debugging
+
+## Core Responsibilities
+
+### 1. Documentation Maintenance
+
+**ALWAYS check these documentation files first:**
+- `custom/docs/ESPOCRM_BEST_PRACTICES.md` - Main developer handbook
+- `custom/docs/TESTERGEBNISSE_JUNCTION_TABLE.md` - Junction Table guide
+- `custom/docs/README.md` - Documentation navigation
+- `custom/DOCUMENTATION_INDEX.md` - Main index
+- `custom/docs/tools/*.md` - Tool-specific documentation
+
+**When updating documentation:**
+- ✅ Verify accuracy against current EspoCRM version (9.3.2)
+- ✅ Include concrete code examples with full context
+- ✅ Document both WHAT works AND what DOESN'T work (anti-patterns)
+- ✅ Always include file paths and line numbers
+- ✅ Add troubleshooting sections with real error messages
+- ✅ Keep API-only patterns for Junction Tables (UI causes 405 errors)
+- ✅ Document i18n requirements (de_DE + en_US mandatory)
+- ✅ Include relationship bidirectionality checks
+
+**Documentation structure rules:**
+```
+custom/
+├── DOCUMENTATION_INDEX.md          # Main entry point
+├── docs/
+│   ├── README.md                   # Navigation hub
+│   ├── ESPOCRM_BEST_PRACTICES.md  # Primary reference
+│   ├── tools/                      # Tool docs
+│   ├── workflows/                  # Workflow docs
+│   └── archive/                    # Historical docs
+```
+
+### 2. Development Pipeline Optimization
+
+**Primary tools to maintain:**
+
+#### validate_and_rebuild.py
+- **Location**: `custom/scripts/validate_and_rebuild.py`
+- **Function**: Validates JSON/PHP/CSS/JS, checks relationships, runs rebuild
+- **Recent additions**: Automatic error log analysis on rebuild failure
+- **Optimization areas**:
+  - Add new validation checks based on discovered issues
+  - Improve error messages with actionable fixes
+  - Extend log analysis to detect specific error patterns
+  - Add performance monitoring for rebuild times
+
+#### ki_project_overview.py
+- **Location**: `custom/scripts/ki_project_overview.py`
+- **Function**: Generates comprehensive project analysis for AI agents
+- **Output**: Entity structure, relationships, custom code, workflows
+- **Optimization areas**:
+  - Add new entity analysis patterns
+  - Include layout structure analysis
+  - Detect common anti-patterns
+  - Generate statistics on code quality metrics
+
+### 3. Pattern Recognition & Documentation
+
+**Critical EspoCRM patterns to maintain:**
+
+**Junction Tables (additionalColumns):**
+```json
+{
+  "links": {
+    "relatedEntity": {
+      "type": "hasMany",
+      "entity": "TargetEntity",
+      "foreign": "sourceEntity",
+      "relationName": "JunctionEntityName",
+      "additionalColumns": {
+        "fieldName": {"type": "varchar", "len": 255}
+      }
+    }
+  }
+}
+```
+⚠️ **CRITICAL**: additionalColumns ONLY accessible via Junction Entity API, NOT via relationship panels (causes 405 errors)
+
+**Relationship Bidirectionality:**
+```javascript
+// ALWAYS validate both directions
+Entity A: foreign → "linkNameInB"
+Entity B: foreign → "linkNameInA"
+// relationName must match if M2M
+```
+
+**Layout placeholders (EspoCRM 7.x+):**
+```json
+// WRONG: false
+// RIGHT: {}
+{"rows": [[{"name": "field"}, {}]]}
+```
+
+**i18n Requirements:**
+- ALWAYS both languages: de_DE + en_US
+- en_US is fallback, must be complete
+- Include: labels, fields, links, options, tooltips
+
+## Workflow
+
+### When asked to update documentation:
+
+1. **Read current state**
+   ```bash
+   cat custom/docs/ESPOCRM_BEST_PRACTICES.md | grep -A 20 "{topic}"
+   ```
+
+2. **Verify against codebase**
+   ```bash
+   find custom/Espo/Custom -name "*Entity*.json" -o -name "*Controller*.php"
+   ```
+
+3. **Check for recent issues**
+   ```bash
+   tail -100 data/logs/espo-$(date +%Y-%m-%d).log | grep -i error
+   ```
+
+4. **Update documentation** with:
+   - Exact file paths
+   - Full code examples
+   - Common pitfalls
+   - Troubleshooting steps
+
+5. **Validate changes**
+   ```bash
+   python3 custom/scripts/validate_and_rebuild.py --dry-run
+   ```
+
+### When asked to optimize tools:
+
+1. **Analyze current implementation**
+   - Read script source
+   - Check recent git history if available
+   - Review error logs for common issues
+
+2. **Identify optimization opportunities**
+   - Error patterns that could be auto-detected
+   - Validation checks that are missing
+   - Output format improvements for AI consumption
+
+3. **Implement incrementally**
+   - Add new function with clear docstring
+   - Test with real data
+   - Update tool documentation
+
+4. **Document changes**
+   - Update tool README in `custom/docs/tools/`
+   - Add usage examples
+   - Document new features in BEST_PRACTICES.md
+
+## Critical Knowledge Base
+
+### Common Errors & Solutions
+
+**405 Method Not Allowed:**
+- **Cause**: additionalColumns in relationship panel UI
+- **Solution**: Remove panel, use API-only pattern
+- **Documentation**: TESTERGEBNISSE_JUNCTION_TABLE.md
+
+**Rebuild fails:**
+- **Auto-action**: validate_and_rebuild.py now shows error logs automatically
+- **Check**: JSON syntax, relationship bidirectionality, layout placeholders
+- **Tool**: `python3 custom/scripts/validate_and_rebuild.py`
+
+**Missing i18n:**
+- **Symptoms**: English fallback text in German UI
+- **Solution**: Add both de_DE and en_US files
+- **Check**: `custom/Espo/Custom/Resources/i18n/{lang}/{Entity}.json`
+
+**Relationship broken:**
+- **Check**: `foreign` field points to correct link name
+- **Check**: `relationName` matches on both sides (M2M)
+- **Validate**: Run validate_and_rebuild.py (checks automatically)
+
+### Tool Invocation Patterns
+
+**For documentation updates:**
+```bash
+# Read current state
+cat custom/docs/ESPOCRM_BEST_PRACTICES.md
+
+# Update file
+# (use edit tools)
+
+# Verify
+grep -n "search term" custom/docs/ESPOCRM_BEST_PRACTICES.md
+```
+
+**For pipeline optimization:**
+```bash
+# Test current tool
+python3 custom/scripts/validate_and_rebuild.py --dry-run
+
+# After changes
+python3 custom/scripts/validate_and_rebuild.py
+
+# Full test with E2E
+python3 custom/scripts/e2e_tests.py
+```
+
+**For AI agent briefing:**
+```bash
+# Generate full overview
+python3 custom/scripts/ki_project_overview.py > /tmp/overview.txt
+
+# Check specific entity
+python3 custom/scripts/ki_project_overview.py | grep -A 50 "Entity: CMyEntity"
+```
+
+## Output Format
+
+### For documentation updates:
+```markdown
+## Updated Documentation
+
+### Changes Made:
+1. File: [path/to/file.md](path/to/file.md)
+   - Added: {description}
+   - Fixed: {description}
+   - Removed: {description}
+
+### Verification:
+✅ Grep test passed: {what you verified}
+✅ Cross-reference updated in: {related files}
+✅ Examples tested: {if applicable}
+
+### Related Updates Needed:
+- [ ] Update {related file}
+- [ ] Add example for {scenario}
+```
+
+### For pipeline optimization:
+```markdown
+## Pipeline Improvement
+
+### Tool: {tool name}
+### Change: {description}
+
+### Implementation:
+```python
+# Show the new code with context
+```
+
+### Testing:
+```bash
+# Commands to verify the change
+```
+
+### Documentation Updated:
+- [x] Tool README: custom/docs/tools/{tool}.md
+- [x] Best Practices: Section {X.Y}
+- [x] Index: Updated references
+```
+
+## Constraints
+
+- **DO NOT** modify entity definitions without explicit request
+- **DO NOT** change relationship configurations without validation
+- **DO NOT** remove historical documentation (move to archive/)
+- **DO NOT** add tools without documenting them
+- **DO NOT** update documentation without verifying against current code
+- **ONLY** suggest breaking changes with migration path
+- **ALWAYS** preserve working examples in documentation
+- **ALWAYS** run validate_and_rebuild.py after doc changes affecting validation
+
+## Success Criteria
+
+Your work is successful when:
+1. ✅ Documentation is accurate and reflects current codebase
+2. ✅ AI agents can successfully use documentation to solve problems
+3. ✅ Development tools catch errors before they reach production
+4. ✅ New developers can onboard using documentation alone
+5. ✅ Validation pipeline passes without false positives
+6. ✅ All cross-references in documentation are valid
+7. ✅ Examples in documentation actually work
+8. ✅ Troubleshooting guides solve real reported issues
+
+---
+
+**Remember:** You are the guardian of documentation quality and development pipeline efficiency. Every update should make the next developer's (human or AI) life easier.

application/Espo/Classes/FieldValidators/Common/Host/NotInternal.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,36 @@
  * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
  ************************************************************************/
 
-namespace Espo\Core\Utils\Database\Dbal\Platforms\Keywords;
+namespace Espo\Classes\FieldValidators\Common\Host;
 
-use Doctrine\DBAL\Platforms\Keywords\MariaDBKeywords;
+use Espo\Core\FieldValidation\Validator;
+use Espo\Core\FieldValidation\Validator\Data;
+use Espo\Core\FieldValidation\Validator\Failure;
+use Espo\Core\Utils\Security\HostCheck;
+use Espo\ORM\Entity;
 
 /**
- * 'LEAD' happened to be a reserved words on some environments.
+ * @implements Validator<Entity>
+ * @since 9.3.2
  */
-final class MariaDb102Keywords extends MariaDBKeywords
+class NotInternal implements Validator
 {
-    /** @deprecated */
+    public function __construct(
-    public function getName(): string
+        private HostCheck $hostCheck,
-    {
+    ) {}
-        return 'MariaDb102';
-    }
 
-    protected function getKeywords(): array
+    public function validate(Entity $entity, string $field, Data $data): ?Failure
     {
-        return [
+        $value = $entity->get($field);
-            ...parent::getKeywords(),
+
-            'LEAD',
+        if (!$value) {
-        ];
+            return null;
+        }
+
+        if (!$this->hostCheck->isNotInternalHost($value)) {
+            return Failure::create();
+        }
+
+        return null;
     }
 }

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

@@ -0,0 +1,71 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * The interactive user interfaces in modified source and object code versions
+ * of this program must display Appropriate Legal Notices, as required under
+ * Section 5 of the GNU Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace Espo\Classes\FieldValidators\Webhook\Url;
+
+use Espo\Core\FieldValidation\Validator;
+use Espo\Core\FieldValidation\Validator\Data;
+use Espo\Core\FieldValidation\Validator\Failure;
+use Espo\Core\Utils\Security\UrlCheck;
+use Espo\Core\Webhook\AddressUtil;
+use Espo\ORM\Entity;
+
+/**
+ * @implements Validator<Entity>
+ */
+class NotInternal implements Validator
+{
+    public function __construct(
+        private UrlCheck $urlCheck,
+        private AddressUtil $addressUtil,
+    ) {}
+
+    public function validate(Entity $entity, string $field, Data $data): ?Failure
+    {
+        $value = $entity->get($field);
+
+        if (!$value) {
+            return null;
+        }
+
+        if (!$this->urlCheck->isUrl($value)) {
+            return null;
+        }
+
+        if ($this->addressUtil->isAllowedUrl($value)) {
+            return null;
+        }
+
+        if (!$this->urlCheck->isNotInternalUrl($value)) {
+            return Failure::create();
+        }
+
+        return null;
+    }
+}

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

@@ -0,0 +1,120 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * The interactive user interfaces in modified source and object code versions
+ * of this program must display Appropriate Legal Notices, as required under
+ * Section 5 of the GNU Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace Espo\Classes\RecordHooks\EmailAccount;
+
+use Espo\Core\Exceptions\Forbidden;
+use Espo\Core\Record\Hook\SaveHook;
+use Espo\Core\Utils\Config;
+use Espo\Core\Utils\Security\HostCheck;
+use Espo\Entities\EmailAccount;
+use Espo\Entities\InboundEmail;
+use Espo\ORM\Entity;
+
+/**
+ * @implements SaveHook<EmailAccount|InboundEmail>
+ */
+class BeforeSaveValidateHosts implements SaveHook
+{
+    public function __construct(
+        private Config $config,
+        private HostCheck $hostCheck,
+    ) {}
+
+    public function process(Entity $entity): void
+    {
+        if ($entity->isAttributeChanged('host') || $entity->isAttributeChanged('port')) {
+            $this->validateImap($entity);
+        }
+
+        if ($entity->isAttributeChanged('smtpHost') || $entity->isAttributeChanged('smtpPort')) {
+            $this->validateSmtp($entity);
+        }
+    }
+
+    /**
+     * @throws Forbidden
+     */
+    private function validateImap(EmailAccount|InboundEmail $entity): void
+    {
+        $host = $entity->getHost();
+        $port = $entity->getPort();
+
+        if ($host === null || $port === null) {
+            return;
+        }
+
+        $address = $host . ':' . $port;
+
+        if (in_array($address, $this->getAllowedAddressList())) {
+            return;
+        }
+
+        if (!$this->hostCheck->isNotInternalHost($host)) {
+            $message = $this->composeErrorMessage($host, $address);
+
+            throw new Forbidden($message);
+        }
+    }
+
+    /**
+     * @throws Forbidden
+     */
+    private function validateSmtp(EmailAccount|InboundEmail $entity): void
+    {
+        $host = $entity->getSmtpHost();
+        $port = $entity->getSmtpPort();
+
+        if ($host === null || $port === null) {
+            return;
+        }
+
+        $address = $host . ':' . $port;
+
+        if (!$this->hostCheck->isNotInternalHost($host)) {
+            $message = $this->composeErrorMessage($host, $address);
+
+            throw new Forbidden($message);
+        }
+    }
+
+    /**
+     * @return string[]
+     */
+    private function getAllowedAddressList(): array
+    {
+        return $this->config->get('emailServerAllowedAddressList') ?? [];
+    }
+
+    private function composeErrorMessage(string $host, string $address): string
+    {
+        return "Host '$host' is not allowed as it's internal. " .
+            "To allow, add `$address` to the config parameter `emailServerAllowedAddressList`.";
+    }
+}

application/Espo/Controllers/InboundEmail.php

@@ -30,6 +30,7 @@
 namespace Espo\Controllers;
 
 use Espo\Core\Exceptions\Error;
+use Espo\Core\Exceptions\Forbidden;
 use Espo\Core\Mail\Account\GroupAccount\Service;
 use Espo\Core\Mail\Account\Storage\Params as StorageParams;
 
@@ -48,6 +49,7 @@ class InboundEmail extends Record
      * @return string[]
      * @throws Error
      * @throws ImapError
+     * @throws Forbidden
      */
     public function postActionGetFolders(Request $request): array
     {
@@ -67,6 +69,7 @@ class InboundEmail extends Record
 
     /**
      * @throws Error
+     * @throws Forbidden
      */
     public function postActionTestConnection(Request $request): bool
     {

application/Espo/Controllers/Settings.php

@@ -70,13 +70,6 @@ class Settings
 
     private function getConfigData(): stdClass
     {
-        $data = $this->service->getConfigData();
+        return $this->service->getConfigData();
-        $metadataData = $this->service->getMetadataConfigData();
-
-        foreach (get_object_vars($metadataData) as $key => $value) {
-            $data->$key = $value;
-        }
-
-        return $data;
     }
 }

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

@@ -30,16 +30,19 @@
 namespace Espo\Core\Mail\Account\GroupAccount;
 
 use Espo\Core\Exceptions\ErrorSilent;
+use Espo\Core\Exceptions\Forbidden;
 use Espo\Core\Mail\Account\Account as Account;
 use Espo\Core\Exceptions\Error;
 use Espo\Core\Mail\Account\Fetcher;
 use Espo\Core\Mail\Account\Storage\Params;
 use Espo\Core\Mail\Account\StorageFactory;
+use Espo\Core\Mail\Account\Util\AddressUtil;
 use Espo\Core\Mail\Account\Util\NotificationHelper;
 use Espo\Core\Mail\Exceptions\ImapError;
 use Espo\Core\Mail\Exceptions\NoImap;
 use Espo\Core\Mail\Sender\Message;
 use Espo\Core\Utils\Log;
+use Espo\Core\Utils\Security\HostCheck;
 use Exception;
 
 class Service
@@ -49,7 +52,9 @@ class Service
         private AccountFactory $accountFactory,
         private StorageFactory $storageFactory,
         private Log $log,
-        private NotificationHelper $notificationHelper
+        private NotificationHelper $notificationHelper,
+        private HostCheck $hostCheck,
+        private AddressUtil $addressUtil,
     ) {}
 
     /**
@@ -77,9 +82,18 @@ class Service
      * @return string[]
      * @throws Error
      * @throws ImapError
+     * @throws Forbidden
      */
     public function getFolderList(Params $params): array
     {
+        if (
+            $params->getHost() &&
+            !$this->addressUtil->isAllowedAddress($params) &&
+            !$this->hostCheck->isNotInternalHost($params->getHost())
+        ) {
+            throw new Forbidden("Not allowed internal host.");
+        }
+
         if ($params->getId()) {
             $account = $this->accountFactory->create($params->getId());
 
@@ -95,6 +109,7 @@ class Service
 
     /**
      * @throws Error
+     * @throws Forbidden
      */
     public function testConnection(Params $params): void
     {
@@ -106,6 +121,14 @@ class Service
                 ->withImapHandlerClassName($account->getImapHandlerClassName());
         }
 
+        if (
+            $params->getHost() &&
+            !$this->addressUtil->isAllowedAddress($params) &&
+            !$this->hostCheck->isNotInternalHost($params->getHost())
+        ) {
+            throw new Forbidden("Not allowed internal host.");
+        }
+
         try {
             $storage = $this->storageFactory->createWithParams($params);
             $storage->getFolderNames();

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

@@ -30,9 +30,11 @@
 namespace Espo\Core\Mail\Account\PersonalAccount;
 
 use Espo\Core\Exceptions\ErrorSilent;
+use Espo\Core\Mail\Account\Util\AddressUtil;
 use Espo\Core\Mail\Account\Util\NotificationHelper;
 use Espo\Core\Mail\Exceptions\ImapError;
 use Espo\Core\Mail\Exceptions\NoImap;
+use Espo\Core\Utils\Config;
 use Espo\Core\Utils\Log;
 use Espo\Core\Mail\Account\Account as Account;
 use Espo\Core\Exceptions\Forbidden;
@@ -40,6 +42,7 @@ use Espo\Core\Exceptions\Error;
 use Espo\Core\Mail\Account\Fetcher;
 use Espo\Core\Mail\Account\Storage\Params;
 use Espo\Core\Mail\Account\StorageFactory;
+use Espo\Core\Utils\Security\HostCheck;
 use Espo\Entities\User;
 use Espo\Core\Mail\Sender\Message;
 
@@ -53,7 +56,9 @@ class Service
         private StorageFactory $storageFactory,
         private User $user,
         private Log $log,
-        private NotificationHelper $notificationHelper
+        private NotificationHelper $notificationHelper,
+        private HostCheck $hostCheck,
+        private AddressUtil $addressUtil,
     ) {}
 
     /**
@@ -95,6 +100,14 @@ class Service
             throw new Forbidden();
         }
 
+        if (
+            $params->getHost() &&
+            !$this->addressUtil->isAllowedAddress($params) &&
+            !$this->hostCheck->isNotInternalHost($params->getHost())
+        ) {
+            throw new Forbidden("Not allowed internal host.");
+        }
+
         if ($params->getId()) {
             $account = $this->accountFactory->create($params->getId());
 
@@ -128,6 +141,14 @@ class Service
             throw new Forbidden();
         }
 
+        if (
+            $params->getHost() &&
+            !$this->addressUtil->isAllowedAddress($params) &&
+            !$this->hostCheck->isNotInternalHost($params->getHost())
+        ) {
+            throw new Forbidden("Not allowed host.");
+        }
+
         if ($params->getId()) {
             $account = $this->accountFactory->create($params->getId());
 

application/Espo/Core/Mail/Account/Util/AddressUtil.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,44 +27,43 @@
  * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
  ************************************************************************/
 
-namespace Espo\Tools\UserSecurity\Password\Recovery;
+namespace Espo\Core\Mail\Account\Util;
 
-use Espo\Core\Exceptions\Forbidden;
+use Espo\Core\Mail\Account\Storage\Params;
+use Espo\Core\Mail\SmtpParams;
 use Espo\Core\Utils\Config;
-use Espo\Entities\Portal;
-use Espo\ORM\EntityManager;
 
-class UrlValidator
+/**
+ * @internal
+ */
+class AddressUtil
 {
     public function __construct(
         private Config $config,
-        private EntityManager $entityManager
     ) {}
 
     /**
-     * @throws Forbidden
+     * @internal
      */
-    public function validate(string $url): void
+    public function isAllowedAddress(Params|SmtpParams $params): bool
     {
-        $siteUrl = rtrim($this->config->get('siteUrl') ?? '', '/');
+        $host = $params instanceof Params ? $params->getHost() : $params->getServer();
+        $port = $params->getPort();
 
-        if (str_starts_with($url, $siteUrl)) {
+        if ($port === null || !$host) {
-            return;
+            return false;
         }
 
-        /** @var iterable<Portal> $portals */
+        $address = $host . ':' . $port;
-        $portals = $this->entityManager
-            ->getRDBRepositoryByClass(Portal::class)
-            ->find();
 
-        foreach ($portals as $portal) {
+        return in_array($address, $this->getAllowedAddressList());
-            $siteUrl = rtrim($portal->getUrl() ?? '', '/');
+    }
 
-            if (str_starts_with($url, $siteUrl)) {
+    /**
-                return;
+     * @return string[]
-            }
+     */
-        }
+    private function getAllowedAddressList(): array
-
+    {
-        throw new Forbidden("URL does not match Site URL.");
+        return $this->config->get('emailServerAllowedAddressList') ?? [];
     }
 }

application/Espo/Core/Mail/Importer/DefaultImporter.php

@@ -420,8 +420,8 @@ class DefaultImporter implements Importer
             $subject = '(No Subject)';
         }
 
-        if (strlen($subject) > self::SUBJECT_MAX_LENGTH) {
+        if (mb_strlen($subject) > self::SUBJECT_MAX_LENGTH) {
-            $subject = substr($subject, 0, self::SUBJECT_MAX_LENGTH);
+            $subject = mb_substr($subject, 0, self::SUBJECT_MAX_LENGTH);
         }
 
         return $subject;

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

@@ -0,0 +1,75 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * The interactive user interfaces in modified source and object code versions
+ * of this program must display Appropriate Legal Notices, as required under
+ * Section 5 of the GNU Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+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_VALIDATE_IP;
+
+class HostCheck
+{
+    public function isNotInternalHost(string $host): bool
+    {
+        $records = dns_get_record($host, DNS_A);
+
+        if (filter_var($host, FILTER_VALIDATE_IP)) {
+            return $this->ipAddressIsNotInternal($host);
+        }
+
+        if (!$records) {
+            return true;
+        }
+
+        foreach ($records as $record) {
+            /** @var ?string $idAddress */
+            $idAddress = $record['ip'] ?? null;
+
+            if (!$idAddress) {
+                return false;
+            }
+
+            if (!$this->ipAddressIsNotInternal($idAddress)) {
+                return false;
+            }
+        }
+
+        return true;
+    }
+
+    private function ipAddressIsNotInternal(string $ipAddress): bool
+    {
+        return (bool) filter_var(
+            $ipAddress,
+            FILTER_VALIDATE_IP,
+            FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE
+        );
+    }
+}

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

@@ -29,15 +29,15 @@
 
 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_VALIDATE_IP;
 use const FILTER_VALIDATE_URL;
 use const PHP_URL_HOST;
 
 class UrlCheck
 {
+    public function __construct(
+        private HostCheck $hostCheck,
+    ) {}
+
     public function isUrl(string $url): bool
     {
         return filter_var($url, FILTER_VALIDATE_URL) !== false;
@@ -58,38 +58,6 @@ class UrlCheck
             return false;
         }
 
-        $records = dns_get_record($host, DNS_A);
+        return $this->hostCheck->isNotInternalHost($host);
-
-        if (filter_var($host, FILTER_VALIDATE_IP)) {
-            return $this->ipAddressIsNotInternal($host);
-        }
-
-        if (!$records) {
-            return false;
-        }
-
-        foreach ($records as $record) {
-            /** @var ?string $idAddress */
-            $idAddress = $record['ip'] ?? null;
-
-            if (!$idAddress) {
-                return false;
-            }
-
-            if (!$this->ipAddressIsNotInternal($idAddress)) {
-                return false;
-            }
-        }
-
-        return true;
-    }
-
-    private function ipAddressIsNotInternal(string $ipAddress): bool
-    {
-        return (bool) filter_var(
-            $ipAddress,
-            FILTER_VALIDATE_IP,
-            FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE
-        );
     }
 }

application/Espo/Core/Webhook/AddressUtil.php

@@ -0,0 +1,79 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * The interactive user interfaces in modified source and object code versions
+ * of this program must display Appropriate Legal Notices, as required under
+ * Section 5 of the GNU Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace Espo\Core\Webhook;
+
+use Espo\Core\Utils\Config;
+
+/**
+ * @internal
+ */
+class AddressUtil
+{
+    public function __construct(
+        private Config $config,
+    ) {}
+
+    /**
+     * @internal
+     */
+    public function isAllowedUrl(string $url): bool
+    {
+        /** @var string[] $allowedAddressList */
+        $allowedAddressList = $this->config->get('webhookAllowedAddressList') ?? [];
+
+        if (!$allowedAddressList) {
+            return false;
+        }
+
+        $host = parse_url($url, PHP_URL_HOST);
+        $port = parse_url($url, PHP_URL_PORT);
+        $scheme = parse_url($url, PHP_URL_SCHEME);
+
+        if (!is_string($host)) {
+            return false;
+        }
+
+        if (!is_int($port)) {
+            if ($scheme === 'https') {
+                $port = 443;
+            } else if ($scheme === 'http') {
+                $port = 80;
+            }
+        }
+
+        if (!is_int($port)) {
+            return false;
+        }
+
+        $address = $host . ':' . $port;
+
+        return in_array($address, $allowedAddressList);
+    }
+}

application/Espo/Core/Webhook/Sender.php

@@ -32,6 +32,7 @@ namespace Espo\Core\Webhook;
 use Espo\Core\Exceptions\Error;
 use Espo\Core\Utils\Config;
 use Espo\Core\Utils\Json;
+use Espo\Core\Utils\Security\UrlCheck;
 use Espo\Entities\Webhook;
 
 /**
@@ -42,8 +43,11 @@ class Sender
     private const CONNECT_TIMEOUT = 5;
     private const TIMEOUT = 10;
 
-    public function __construct(private Config $config)
+    public function __construct(
-    {}
+        private Config $config,
+        private UrlCheck $urlCheck,
+        private AddressUtil $addressUtil,
+    ) {}
 
     /**
      * @param array<int, mixed> $dataList
@@ -85,6 +89,17 @@ class Sender
             throw new Error("Webhook does not have URL.");
         }
 
+        if (!$this->urlCheck->isUrl($url)) {
+            throw new Error("'$url' is not valid URL.");
+        }
+
+        if (
+            !$this->addressUtil->isAllowedUrl($url) &&
+            !$this->urlCheck->isNotInternalUrl($url)
+        ) {
+            throw new Error("URL '$url' points to an internal host, not allowed.");
+        }
+
         $handler = curl_init($url);
 
         if ($handler === false) {

application/Espo/Modules/Crm/Resources/metadata/entityDefs/Contact.json

@@ -221,7 +221,8 @@
                 }
             },
             "customizationOptionsDisabled": true,
-            "textFilterDisabled": true
+            "textFilterDisabled": true,
+            "importEnabled": true
         },
         "description": {
             "type": "text"

application/Espo/Resources/metadata/entityDefs/EmailAccount.json

@@ -21,14 +21,16 @@
             "default": "Active"
         },
         "host": {
-            "type": "varchar"
+            "type": "varchar",
+            "massUpdateDisabled": true
         },
         "port": {
             "type": "int",
             "min": 0,
             "max": 65535,
             "default": 993,
-            "disableFormatting": true
+            "disableFormatting": true,
+            "massUpdateDisabled": true
         },
         "security": {
             "type": "enum",
@@ -112,14 +114,16 @@
             "tooltip": true
         },
         "smtpHost": {
-            "type": "varchar"
+            "type": "varchar",
+            "massUpdateDisabled": true
         },
         "smtpPort": {
             "type": "int",
             "min": 0,
             "max": 65535,
             "default": 587,
-            "disableFormatting": true
+            "disableFormatting": true,
+            "massUpdateDisabled": true
         },
         "smtpAuth": {
             "type": "bool",

application/Espo/Resources/metadata/entityDefs/InboundEmail.json

@@ -21,14 +21,16 @@
             "default": "Active"
         },
         "host": {
-            "type": "varchar"
+            "type": "varchar",
+            "massUpdateDisabled": true
         },
         "port": {
             "type": "int",
             "min": 0,
             "max": 65535,
             "default": 993,
-            "disableFormatting": true
+            "disableFormatting": true,
+            "massUpdateDisabled": true
         },
         "security": {
             "type": "enum",
@@ -122,14 +124,16 @@
             "tooltip": true
         },
         "smtpHost": {
-            "type": "varchar"
+            "type": "varchar",
+            "massUpdateDisabled": true
         },
         "smtpPort": {
             "type": "int",
             "min": 0,
             "max": 65535,
             "default": 587,
-            "disableFormatting": true
+            "disableFormatting": true,
+            "massUpdateDisabled": true
         },
         "smtpAuth": {
             "type": "bool",

application/Espo/Resources/metadata/entityDefs/Webhook.json

@@ -10,7 +10,10 @@
             "type": "varchar",
             "maxLength": 512,
             "required": true,
-            "copyToClipboard": true
+            "copyToClipboard": true,
+            "validatorClassNameList": [
+                "Espo\\Classes\\FieldValidators\\Webhook\\Url\\NotInternal"
+            ]
         },
         "isActive": {
             "type": "bool",

application/Espo/Resources/metadata/recordDefs/EmailAccount.json

@@ -15,9 +15,11 @@
     ],
     "beforeCreateHookClassNameList": [
         "Espo\\Classes\\RecordHooks\\EmailAccount\\BeforeCreate",
-        "Espo\\Classes\\RecordHooks\\EmailAccount\\BeforeSave"
+        "Espo\\Classes\\RecordHooks\\EmailAccount\\BeforeSave",
+        "Espo\\Classes\\RecordHooks\\EmailAccount\\BeforeSaveValidateHosts"
     ],
     "beforeUpdateHookClassNameList": [
-        "Espo\\Classes\\RecordHooks\\EmailAccount\\BeforeSave"
+        "Espo\\Classes\\RecordHooks\\EmailAccount\\BeforeSave",
+        "Espo\\Classes\\RecordHooks\\EmailAccount\\BeforeSaveValidateHosts"
     ]
 }

application/Espo/Resources/metadata/recordDefs/InboundEmail.json

@@ -18,5 +18,11 @@
     ],
     "listLoaderClassNameList": [
         "Espo\\Classes\\FieldProcessing\\InboundEmail\\IsSystemLoader"
+    ],
+    "beforeCreateHookClassNameList": [
+        "Espo\\Classes\\RecordHooks\\EmailAccount\\BeforeSaveValidateHosts"
+    ],
+    "beforeUpdateHookClassNameList": [
+        "Espo\\Classes\\RecordHooks\\EmailAccount\\BeforeSaveValidateHosts"
     ]
 }

application/Espo/Tools/App/SettingsService.php

@@ -56,6 +56,15 @@ use stdClass;
 
 class SettingsService
 {
+    /**
+     * @var string[]
+     * @todo Do not use when these parameters moved away from the settings.
+     */
+    private array $ignoreUpdateParamList = [
+        'loginView',
+        'loginData',
+    ];
+
     public function __construct(
         private ApplicationState $applicationState,
         private Config $config,
@@ -87,11 +96,22 @@ class SettingsService
         $this->filterData($data);
         $this->loadAdditionalParams($data);
 
+        /** @noinspection PhpDeprecationInspection */
+        $metadataData = $this->getMetadataConfigData();
+
+        foreach (get_object_vars($metadataData) as $key => $value) {
+            $data->$key = $value;
+        }
+
         return $data;
     }
 
     /**
      * Get metadata to be used in config.
+     *
+     * @todo Make private in v9.4.0.
+     * @todo Move away from settings. Use some different approach.
+     * @deprecated Since v9.3.2.
      */
     public function getMetadataConfigData(): stdClass
     {
@@ -208,6 +228,7 @@ class SettingsService
         }
 
         $ignoreItemList = array_merge(
+            $this->ignoreUpdateParamList,
             $this->access->getSystemParamList(),
             $this->access->getReadOnlyParamList(),
             $this->isRestrictedMode() && !$user->isSuperAdmin() ?

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

@@ -38,8 +38,10 @@ use Espo\Core\Exceptions\BadRequest;
 use Espo\Core\Exceptions\Error;
 use Espo\Core\Exceptions\Forbidden;
 use Espo\Core\Exceptions\NotFound;
+use Espo\Core\Mail\Account\Util\AddressUtil;
 use Espo\Core\Mail\Exceptions\NoSmtp;
 use Espo\Core\Mail\SmtpParams;
+use Espo\Core\Utils\Security\HostCheck;
 use Espo\Entities\Email;
 use Espo\Tools\Email\SendService;
 use Espo\Tools\Email\TestSendData;
@@ -51,7 +53,9 @@ class PostSendTest implements Action
 {
     public function __construct(
         private SendService $sendService,
-        private Acl $acl
+        private Acl $acl,
+        private HostCheck $hostCheck,
+        private AddressUtil $addressUtil,
     ) {}
 
     /**
@@ -109,6 +113,13 @@ class PostSendTest implements Action
                 ->withAuthMechanism($authMechanism);
         }
 
+        if (
+            !$this->addressUtil->isAllowedAddress($smtpParams) &&
+            !$this->hostCheck->isNotInternalHost($server)
+        ) {
+            throw new Forbidden("Not allowed internal host.");
+        }
+
         $data = new TestSendData($emailAddress, $type, $id, $userId);
 
         $this->sendService->sendTestEmail($smtpParams, $data);

application/Espo/Tools/GlobalSearch/Service.php

@@ -113,7 +113,7 @@ class Service
             $builder->order('relevance', Order::DESC);
         }
 
-        $builder->order('order', Order::DESC);
+        $builder->order('order');
         $builder->order(Field::NAME);
 
         $unionQuery = $builder->build();

application/Espo/Tools/LinkManager/LinkManager.php

@@ -855,7 +855,9 @@ class LinkManager
                 "links.$link",
             ]);
 
-            $this->metadata->delete('clientDefs', $entity, ["dynamicLogic.fields.$link"]);
+            $this->metadata->delete('logicDefs', $entity, [
+                "fields.$link",
+            ]);
 
             $this->metadata->save();
 
@@ -907,8 +909,13 @@ class LinkManager
                 ->build();
         }
 
-        $this->metadata->delete('clientDefs', $entity, ["dynamicLogic.fields.$link"]);
+        $this->metadata->delete('logicDefs', $entity, [
-        $this->metadata->delete('clientDefs', $entityForeign, ["dynamicLogic.fields.$linkForeign"]);
+            "fields.$link",
+        ]);
+
+        $this->metadata->delete('logicDefs', $entityForeign, [
+            "fields.$linkForeign",
+        ]);
 
         $this->metadata->delete('entityDefs', $entity, [
             "fields.$link",

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-02-19 */
+/*! espocrm 2026-03-10 */
 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/DOCUMENTATION_INDEX.md

@@ -0,0 +1,361 @@
+# 📚 EspoCRM Dokumentations-Index
+
+**Schneller Zugriff auf alle Dokumentations-Ressourcen**
+
+---
+
+## 🎯 Quick Links für AI Agents
+
+### START HIER ⭐
+1. **[docs/ESPOCRM_BEST_PRACTICES.md](docs/ESPOCRM_BEST_PRACTICES.md)** - Vollständiges Entwickler-Handbuch
+2. **[docs/README.md](docs/README.md)** - Dokumentations-Navigation & Workflow-Guide
+3. `python3 custom/scripts/ki_project_overview.py` - Aktueller Projekt-Status für AI
+
+### Essentials
+- **[docs/tools/QUICKSTART.md](docs/tools/QUICKSTART.md)** - 5-Minuten Quick Start
+- **[custom/scripts/validate_and_rebuild.py](custom/scripts/validate_and_rebuild.py)** - Haupt-Validierungs-Tool
+- **Validierung ausführen:** `python3 custom/scripts/validate_and_rebuild.py`
+
+---
+
+## 📁 Dokumentations-Struktur
+
+```
+custom/
+├── README.md                          ← Custom Actions Blueprint (Architektur)
+├── CUSTOM_DIRECTORY.md                ← Verzeichnisstruktur-Übersicht
+│
+├── docs/                              ← 🆕 ZENTRALE DOKUMENTATION
+│   ├── README.md                      ← Dokumentations-Navigation (START)
+│   ├── ESPOCRM_BEST_PRACTICES.md     ← ⭐ HAUPTDOKUMENTATION
+│   ├── TESTERGEBNISSE_JUNCTION_TABLE.md  ← Junction Table Guide
+│   ├── ENTWICKLUNGSPLAN_ENTWICKLUNGEN.md ← Puls-System Spezifikation
+│   │
+│   ├── tools/                         ← Tool-Dokumentation
+│   │   ├── QUICKSTART.md
+│   │   ├── VALIDATION_TOOLS.md
+│   │   ├── E2E_TESTS_README.md
+│   │   ├── KI_OVERVIEW_README.md
+│   │   └── VALIDATOR_README.md
+│   │
+│   └── workflows/                     ← Workflow-Dokumentation
+│       └── README.md
+│
+├── scripts/                           ← Entwicklungs-Tools
+│   ├── validate_and_rebuild.py       ← Haupt-Validierungs-Tool
+│   ├── e2e_tests.py                  ← End-to-End Tests
+│   ├── ki_project_overview.py        ← Projekt-Analyse für AI
+│   ├── espocrm_api_client.py         ← API Client Library
+│   ├── ki-overview.sh                ← Legacy Overview Script
+│   ├── run_e2e_tests.sh              ← E2E Test Runner
+│   └── junctiontabletests/           ← Junction Table Tests
+│
+└── workflows/                         ← Workflow JSON-Definitionen
+    └── README.md                     ← Workflow-Befehle
+```
+
+---
+
+## 📖 Dokumentations-Kategorien
+
+### 1️⃣ Entwickler-Handbuch
+
+#### [docs/ESPOCRM_BEST_PRACTICES.md](docs/ESPOCRM_BEST_PRACTICES.md) ⭐
+**Das Hauptdokument - Start hier!**
+
+**Inhalt:**
+- ✅ Projekt-Übersicht & System-Architektur
+- ✅ Architektur-Prinzipien (Clean Code, 3-Schichten)
+- ✅ Entity-Entwicklung (Templates, Naming, i18n)
+- ✅ Relationship-Patterns (One-to-Many, Many-to-Many, Junction)
+- ✅ API-Entwicklung (REST, Custom Endpoints)
+- ✅ Hook-Entwicklung (Entity Lifecycle Events)
+- ✅ Workflow-Management
+- ✅ Testing & Validierung
+- ✅ Fehlerbehandlung & Troubleshooting
+- ✅ Deployment-Prozess
+
+**Wann verwenden:**
+- Neuen AI Agent briefen
+- Entity erstellen
+- Relationship implementieren
+- API-Endpoint entwickeln
+- Hook für Validierung/Berechnung erstellen
+- Fehler debuggen
+
+---
+
+### 2️⃣ Spezial-Themen
+
+#### [docs/TESTERGEBNISSE_JUNCTION_TABLE.md](docs/TESTERGEBNISSE_JUNCTION_TABLE.md)
+**Junction Tables mit additionalColumns**
+
+**Inhalt:**
+- Many-to-Many Relationships mit Zusatzfeldern
+- Junction Entity als API-Endpoint
+- API-CRUD Operationen
+- Vollständige Code-Beispiele
+- ⚠️ UI-Panel Warnung (405 Fehler)
+
+**Wann verwenden:**
+- Many-to-Many mit Zusatzfeldern implementieren
+- Junction Entity API nutzen
+- additionalColumns verstehen
+
+---
+
+#### [docs/ENTWICKLUNGSPLAN_ENTWICKLUNGEN.md](docs/ENTWICKLUNGSPLAN_ENTWICKLUNGEN.md)
+**Puls-System (CPuls) Spezifikation**
+
+**Inhalt:**
+- Posteingangs-System mit KI-Analyse
+- Team-basierte Dokumenten-Workflows
+- First-Read-Closes Prinzip
+- Entity-Definitionen CPuls, CPulsTeamZuordnung
+- Middleware-Architektur
+
+**Wann verwenden:**
+- CPuls-Entity weiterentwickeln
+- Dokumenten-Workflow verstehen
+- KI-Integration planen
+
+---
+
+### 3️⃣ Architektur & Struktur
+
+#### [README.md](README.md)
+**Custom Actions - Implementierungsprinzip**
+
+**Inhalt:**
+- Drei-Schichten-Architektur
+- Custom Button Actions Blueprint
+- Entity-Erstellung mit Relationen
+- Code-Templates
+- Sicherheit & ACL
+
+**Wann verwenden:**
+- Custom Button Action erstellen
+- Controller/Service Pattern verstehen
+- Architektur-Overview benötigen
+
+---
+
+#### [CUSTOM_DIRECTORY.md](CUSTOM_DIRECTORY.md)
+**Verzeichnisstruktur-Übersicht**
+
+**Inhalt:**
+- Vollständige custom/ Struktur
+- Backend (Espo/Custom/)
+- Frontend (client/custom/)
+- Metadata-Organisation
+- Scripts & Workflows
+
+**Wann verwenden:**
+- Datei-Platzierung nachschlagen
+- Verzeichnis-Organisation verstehen
+- Neue Dateien korrekt anlegen
+
+---
+
+### 4️⃣ Tool-Dokumentation
+
+#### [docs/tools/QUICKSTART.md](docs/tools/QUICKSTART.md)
+**5-Minuten Quick Start**
+
+```bash
+python3 custom/scripts/validate_and_rebuild.py
+```
+
+---
+
+#### [docs/tools/VALIDATION_TOOLS.md](docs/tools/VALIDATION_TOOLS.md)
+**Validierungs-Tools Details**
+- PHP-CLI (php -l)
+- CSSLint
+- JSHint
+- Integration
+
+---
+
+#### [docs/tools/E2E_TESTS_README.md](docs/tools/E2E_TESTS_README.md)
+**End-to-End Test Framework**
+- CRUD-Tests
+- Relationship-Tests
+- Konfiguration
+
+---
+
+#### [docs/tools/KI_OVERVIEW_README.md](docs/tools/KI_OVERVIEW_README.md)
+**KI-Projekt-Übersicht Tool**
+
+```bash
+python3 custom/scripts/ki_project_overview.py > /tmp/project-overview.txt
+```
+
+---
+
+### 5️⃣ Workflow-Management
+
+#### [docs/workflows/README.md](docs/workflows/README.md)
+**Workflow-Format & Management**
+
+**Befehle:**
+```bash
+# Liste
+php custom/scripts/workflow_manager.php list
+
+# Import
+php custom/scripts/workflow_manager.php import custom/workflows/my-workflow.json
+
+# Export
+php custom/scripts/workflow_manager.php export
+```
+
+---
+
+## 🛠️ Wichtigste Tools
+
+| Tool | Zweck | Befehl |
+|------|-------|--------|
+| **validate_and_rebuild.py** | 🎯 Validierung + Rebuild + E2E + Fehlerlog | `python3 custom/scripts/validate_and_rebuild.py` |
+| **ki_project_overview.py** | 📊 Projekt-Analyse für AI | `python3 custom/scripts/ki_project_overview.py` |
+| **e2e_tests.py** | 🧪 End-to-End CRUD Tests | `python3 custom/scripts/e2e_tests.py` |
+
+**NEU in validate_and_rebuild.py:**
+- ✅ Automatische Fehlerlog-Analyse bei Rebuild-Fehlern
+- ✅ Zeigt letzte 50 Log-Zeilen
+- ✅ Filtert ERROR/WARNING/EXCEPTION
+- ✅ Gibt Log-File-Pfad aus
+
+---
+
+## 🎓 Typische Workflows
+
+### 1. Neuen AI Agent briefen
+
+```bash
+# 1. Hauptdokumentation lesen
+cat custom/docs/ESPOCRM_BEST_PRACTICES.md
+
+# 2. Aktuellen Projekt-Status holen
+python3 custom/scripts/ki_project_overview.py > /tmp/project-overview.txt
+
+# 3. Dokumentations-Navigation
+cat custom/docs/README.md
+```
+
+---
+
+### 2. Neue Entity entwickeln
+
+```bash
+# 1. Template nachschlagen
+cat custom/docs/ESPOCRM_BEST_PRACTICES.md | grep -A 50 "Entity Definition Template"
+
+# 2. Entity-Dateien erstellen (entityDefs, scopes, i18n)
+
+# 3. Validierung + Rebuild
+python3 custom/scripts/validate_and_rebuild.py
+```
+
+---
+
+### 3. Relationship implementieren
+
+```bash
+# 1. Pattern nachschlagen
+cat custom/docs/ESPOCRM_BEST_PRACTICES.md | grep -A 100 "Relationship-Patterns"
+
+# 2. Links konfigurieren
+
+# 3. Validierung (prüft bidirektionale Konsistenz)
+python3 custom/scripts/validate_and_rebuild.py
+```
+
+---
+
+### 4. Junction Table mit additionalColumns
+
+```bash
+# 1. Vollständige Anleitung
+cat custom/docs/TESTERGEBNISSE_JUNCTION_TABLE.md
+
+# 2. Implementierung (Entity + Controller + Service)
+
+# 3. Validierung
+python3 custom/scripts/validate_and_rebuild.py
+```
+
+---
+
+### 5. Fehler debuggen
+
+```bash
+# 1. Validierung ausführen (zeigt automatisch Fehlerlog)
+python3 custom/scripts/validate_and_rebuild.py
+
+# 2. Troubleshooting Guide
+cat custom/docs/ESPOCRM_BEST_PRACTICES.md | grep -A 200 "Troubleshooting"
+```
+
+---
+
+## 🆘 Support & Hilfe
+
+### Bei Problemen:
+
+1. **Fehlerlog-Analyse:**
+   ```bash
+   python3 custom/scripts/validate_and_rebuild.py
+   # → Zeigt automatisch Fehlerlog bei Rebuild-Fehlern
+   ```
+
+2. **Troubleshooting Guide:**
+   ```bash
+   cat custom/docs/ESPOCRM_BEST_PRACTICES.md | grep -A 300 "Troubleshooting"
+   ```
+
+3. **Häufige Fehler:**
+   - Layout `false` → `{}` ändern
+   - i18n fehlt → beide Sprachen (de_DE + en_US) anlegen
+   - Relationship kaputt → bidirektional prüfen (foreign)
+   - ACL 403 → Rechte in Admin UI setzen
+   - 405 Fehler → Keine additionalColumns in UI-Panels!
+
+---
+
+## 📊 System-Info
+
+- **EspoCRM Version:** 9.3.2
+- **PHP Version:** 8.2.30
+- **Database:** MariaDB 12.2.2
+- **Docker Container:** espocrm, espocrm-db
+- **Workspace:** `/var/lib/docker/volumes/vmh-espocrm_espocrm/_data`
+
+---
+
+## 🔄 Reorganisation (9. März 2026)
+
+**Änderungen:**
+- ✅ Alle Dokumentation zentralisiert in `custom/docs/`
+- ✅ Tool-Dokumentation in `custom/docs/tools/`
+- ✅ Workflow-Dokumentation in `custom/docs/workflows/`
+- ✅ Neue Hauptdokumentation: `ESPOCRM_BEST_PRACTICES.md`
+- ✅ Test-Scripts organisiert in `custom/scripts/junctiontabletests/`
+- ✅ validate_and_rebuild.py erweitert um automatische Fehlerlog-Ausgabe
+
+**Migration:**
+- `scripts/KI_OVERVIEW_README.md` → `docs/tools/`
+- `scripts/VALIDATION_TOOLS.md` → `docs/tools/`
+- `scripts/E2E_TESTS_README.md` → `docs/tools/`
+- `scripts/QUICKSTART.md` → `docs/tools/`
+- `scripts/VALIDATOR_README.md` → `docs/tools/`
+- `workflows/README.md` → `docs/workflows/`
+- `TESTERGEBNISSE_JUNCTION_TABLE.md` → `docs/`
+- `ENTWICKLUNGSPLAN_ENTWICKLUNGEN.md` → `docs/`
+
+---
+
+**Letzte Aktualisierung:** 9. März 2026
+
+**Für Fragen:** Siehe `custom/docs/ESPOCRM_BEST_PRACTICES.md`

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/CAICollectionCDokumente.php

@@ -0,0 +1,23 @@
+<?php
+namespace Espo\Custom\Controllers;
+
+use Espo\Core\Controllers\Record;
+
+/**
+ * Junction Controller: CAICollection ↔ CDokumente
+ * 
+ * Provides REST API access to the junction table with additionalColumns:
+ * - xaifileid: XAI external file ID
+ * - syncStatus: Sync state tracking
+ */
+class CAICollectionCDokumente extends Record
+{
+    // Inherits all CRUD operations from Record controller
+    // 
+    // Available endpoints:
+    // GET    /api/v1/CAICollectionCDokumente
+    // GET    /api/v1/CAICollectionCDokumente/{id}
+    // POST   /api/v1/CAICollectionCDokumente
+    // PUT    /api/v1/CAICollectionCDokumente/{id}
+    // DELETE /api/v1/CAICollectionCDokumente/{id}
+}

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/CAdvowareAkten.php

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

custom/Espo/Custom/Controllers/CAdvowareAktenCDokumente.php

@@ -0,0 +1,23 @@
+<?php
+namespace Espo\Custom\Controllers;
+
+use Espo\Core\Controllers\Record;
+
+/**
+ * Junction Controller: CAdvowareAkten ↔ CDokumente
+ * 
+ * Provides REST API access to the junction table with additionalColumns:
+ * - hnr: Advoware HNR reference
+ * - syncStatus: Sync state tracking
+ */
+class CAdvowareAktenCDokumente extends Record
+{
+    // Inherits all CRUD operations from Record controller
+    // 
+    // Available endpoints:
+    // GET    /api/v1/CAdvowareAktenCDokumente
+    // GET    /api/v1/CAdvowareAktenCDokumente/{id}
+    // POST   /api/v1/CAdvowareAktenCDokumente
+    // PUT    /api/v1/CAdvowareAktenCDokumente/{id}
+    // DELETE /api/v1/CAdvowareAktenCDokumente/{id}
+}

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('cAdvowareAktenId')) {
+                    $foreignEntity->set('cAdvowareAktenId', $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('cAdvowareAktenId')) {
+                    $foreignEntity->set('cAdvowareAktenId', $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 cAdvowareAktenId 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/CAdvowareAkten/CheckGlobalSyncStatus.php

@@ -0,0 +1,75 @@
+<?php
+namespace Espo\Custom\Hooks\CAdvowareAkten;
+
+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('CAdvowareAktenDokumente')
+                ->where([
+                    'cAdvowareAktenId' => $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('CAdvowareAkten CheckGlobalSyncStatus Hook Error: ' . $e->getMessage());
+            $entity->set('syncStatus', 'unclean');
+        }
+    }
+}

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

@@ -0,0 +1,118 @@
+<?php
+namespace Espo\Custom\Hooks\CAdvowareAkten;
+
+use Espo\ORM\Entity;
+use Espo\Core\Hook\Hook\AfterSave;
+
+/**
+ * Hook: Propagiert Dokumenten-Änderungen von AdvowareAkten nach oben zu Räumungsklage/Mietinkasso
+ * und auch zu AICollection
+ * 
+ * Wenn ein Dokument einer AdvowareAkte zugewiesen wird (via cAdvowareAktenId):
+ * → verknüpfe mit verbundener Räumungsklage/Mietinkasso
+ * → verknüpfe mit AICollection
+ * 
+ * Improved logic: Works with direct belongsTo relationship (cAdvowareAktenId)
+ */
+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 cAdvowareAktenId changed
+        if (!$entity->isAttributeChanged('cAdvowareAktenId')) {
+            return;
+        }
+        
+        $akteId = $entity->get('cAdvowareAktenId');
+        if (!$akteId) {
+            return; // Document was unlinked from Akte
+        }
+        
+        // Vermeide Loops
+        $key = $akteId . '-' . $entity->getId() . '-propagate';
+        if (isset(self::$processing[$key])) {
+            return;
+        }
+        self::$processing[$key] = true;
+        
+        try {
+            // Load AdvowareAkte
+            $akte = $this->entityManager->getEntity('CAdvowareAkten', $akteId);
+            if (!$akte) {
+                return;
+            }
+            
+            // Prüfe ob Räumungsklage verknüpft ist
+            $raumungsklage = $this->entityManager
+                ->getRDBRepository('CAdvowareAkten')
+                ->getRelation($akte, 'vmhRumungsklage')
+                ->findOne();
+            
+            if ($raumungsklage) {
+                $this->relateDocument($raumungsklage, 'dokumentesvmhraumungsklage', $entity);
+            }
+            
+            // Prüfe ob Mietinkasso verknüpft ist
+            $mietinkasso = $this->entityManager
+                ->getRDBRepository('CAdvowareAkten')
+                ->getRelation($akte, 'mietinkasso')
+                ->findOne();
+            
+            if ($mietinkasso) {
+                $this->relateDocument($mietinkasso, 'dokumentesmietinkasso', $entity);
+            }
+            
+            // Also propagate to AICollection if Räumungsklage or Mietinkasso has one
+            if ($raumungsklage) {
+                $aiKnowledge = $this->entityManager
+                    ->getRDBRepository('CVmhRumungsklage')
+                    ->getRelation($raumungsklage, 'aIKnowledge')
+                    ->findOne();
+                
+                if ($aiKnowledge) {
+                    $this->relateDocument($aiKnowledge, 'dokumentes', $entity);
+                }
+            }
+            
+            if ($mietinkasso) {
+                $aiKnowledge = $this->entityManager
+                    ->getRDBRepository('CMietinkasso')
+                    ->getRelation($mietinkasso, 'aIKnowledge')
+                    ->findOne();
+                
+                if ($aiKnowledge) {
+                    $this->relateDocument($aiKnowledge, 'dokumentes', $entity);
+                }
+            }
+            
+        } catch (\Exception $e) {
+            $GLOBALS['log']->error('CAdvowareAkten PropagateDocumentsUp 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);
+        }
+    }
+}

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

@@ -35,25 +35,27 @@ class CDokumente extends \Espo\Core\Hooks\Base
             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;
+        }
+        
+        $newBlake3 = \blake3($fileContent);
 
-        // Setze Hashes
+        // Setze Hash
-        $entity->set('md5sum', $newMd5);
+        $entity->set('blake3hash', $newBlake3);
-        $entity->set('sha256', $newSha256);
 
         // 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', 'unchanged');
+                $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('cAdvowareAktenId')) {
+                $entity->set('syncStatus', 'unclean');
+                $this->entityManager->saveEntity($entity, ['silent' => true, 'skipHooks' => true]);
+                
+                // Also update the parent AdvowareAkte
+                $akte = $this->entityManager->getEntity('CAdvowareAkten', $entity->get('cAdvowareAktenId'));
+                if ($akte) {
+                    $akte->set('syncStatus', 'unclean');
+                    $this->entityManager->saveEntity($akte, ['silent' => true, 'skipHooks' => 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('CAdvowareAkten', $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('CAdvowareAkten', $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('CAdvowareAkten', $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('cAdvowareAktenId', $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('cAdvowareAktenId') === $advowareAkten->getId()) {
+                $foreignEntity->set('cAdvowareAktenId', 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('cAdvowareAktenId', $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('cAdvowareAktenId') === $advowareAkten->getId()) {
+                $foreignEntity->set('cAdvowareAktenId', 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/CAdvowareAkten.json

@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "الاجتماعات",
+    "calls": "المكالمات",
+    "tasks": "مهام"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "إنشاء {الكيان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

@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "Срещи",
+    "calls": "Разговори",
+    "tasks": "Задачи"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "Създаване на 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

@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "Schůzky",
+    "calls": "Hovory",
+    "tasks": "Úkoly"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "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

@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "Møder",
+    "calls": "Opkald",
+    "tasks": "Opgaver"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "Opret Advoware Akten "
+  }
+}

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

@@ -0,0 +1,49 @@
+{
+    "links": {
+        "calls": "Anrufe",
+        "tasks": "Aufgaben",
+        "vmhRumungsklage": "Räumungsklagen",
+        "mietinkasso": "Mietinkasso",
+        "kuendigungen": "Kündigungen",
+        "dokumentes": "Dokumente"
+    },
+    "labels": {
+        "Create CAdvowareAkten": "Advoware Akten erstellen"
+    },
+    "fields": {
+        "vmhRumungsklage": "Räumungsklagen",
+        "mietinkasso": "Mietinkasso",
+        "aktenzeichen": "Aktenzeichen",
+        "aktennummer": "Aktennummer",
+        "aktenpfad": "Aktenpfad (Windows)",
+        "syncStatus": "Sync-Status",
+        "lastSync": "Letzte Synchronisation",
+        "aktivierungsstatus": "Aktivierungsstatus",
+        "dokumentes": "Dokumente",
+        "dokumenteHnr": "HNR",
+        "dokumenteSyncstatus": "Sync-Status",
+        "dokumenteLastSync": "Letzter Sync",
+        "dokumenteSyncedHash": "Sync-Hash"
+    },
+    "options": {
+        "syncStatus": {
+            "neu": "Neu",
+            "import": "Import",
+            "synced": "Synchronisiert",
+            "unclean": "Nicht synchronisiert",
+            "pending_sync": "Synchronisierung ausstehend"
+        },
+        "aktivierungsstatus": {
+            "new": "Neu",
+            "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. Wird automatisch basierend auf den Dokumenten-Status aktualisiert.",
+        "lastSync": "Zeitpunkt der letzten erfolgreichen Synchronisation aller Dokumente",
+        "aktivierungsstatus": "Aktivierungsstatus der Akte: new = Neu angelegt, active = Aktiv synchronisiert, paused = Synchronisation pausiert, deactivated = Synchronisation deaktiviert",
+        "aktenpfad": "Windows-Dateipfad zur Akte in Advoware"
+    }
+}

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

@@ -0,0 +1,33 @@
+{
+    "labels": {
+        "Create CAdvowareAktenCDokumente": "Advoware-Dokument-Verknüpfung erstellen",
+        "CAdvowareAktenCDokumente": "Advoware-Dokument-Verknüpfungen"
+    },
+    "fields": {
+        "cAdvowareAkten": "Advoware-Akte",
+        "cAdvowareAktenId": "Advoware-Akte ID",
+        "cDokumente": "Dokument",
+        "cDokumenteId": "Dokument ID",
+        "hnr": "HNR",
+        "syncStatus": "Sync-Status",
+        "syncedHash": "Sync-Hash",
+        "deleted": "Gelöscht"
+    },
+    "links": {
+        "cAdvowareAkten": "Advoware-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

@@ -1,67 +1,61 @@
 {
-  "fields": {
+    "fields": {
-    "dokument": "Download",
+        "dokument": "Download",
-    "preview": "Vorschau",
+        "preview": "Vorschau",
-    "ydocumentuuid": "Y-Document-UUID",
+        "blake3hash": "Blake3-Hash",
-    "md5sum": "MD5-Prüfsumme",
+        "cAdvowareAkten": "Advoware Akte",
-    "sha256": "SHA256-Prüfsumme",
+        "cAdvowareAktenId": "Advoware Akten-ID",
-    "aktennr": "Advoware Identifikator",
+        "cAdvowareAktenName": "Advoware Aktenname",
-    "advowareLastSync": "Advoware letzte Synchronisation",
+        "hnr": "HNR (Advoware)",
-    "syncStatus": "Sync-Status",
+        "syncStatus": "Sync-Status",
-    "xaiId": "x.AI ID",
+        "syncedHash": "Sync-Hash",
-    "xaiCollections": "x.AI Collections",
+        "usn": "USN",
-    "xaiSyncStatus": "Sync-Status",
+        "dateipfad": "Dateipfad",
-    "fileStatus": "Datei-Status",
+        "contactsvmhdokumente": "Freigegebene Nutzer",
-    "contactsvmhdokumente": "Freigegebene Nutzer",
+        "vmhMietverhltnisesDokumente": "Mietverhältnisse",
-    "vmhMietverhltnisesDokumente": "Mietverhältnisse",
+        "vmhErstgespraechsdokumente": "Erstgespräche",
-    "vmhErstgespraechsdokumente": "Erstgespräche",
+        "vmhRumungsklagesdokumente": "Räumungsklagen",
-    "vmhRumungsklagesdokumente": "Räumungsklagen",
+        "kuendigungDokumente": "Kündigungen",
-    "kuendigungDokumente": "Kündigungen",
+        "beteiligte2dokumente": "Beteiligte",
-    "beteiligte2dokumente": "Beteiligte",
+        "mietobjekt2dokumente": "Mietobjekte",
-    "mietobjekt2dokumente": "Mietobjekte",
+        "mietinkassosdokumente": "Mietinkasso",
-    "mietinkassosdokumente": "Mietinkasso",
+        "kndigungensdokumente": "Kündigungen",
-    "kndigungensdokumente": "Kündigungen"
+        "aIKnowledges": "AI Knowledge",
-  },
+        "aiKnowledgeAiDocumentId": "AI Document ID",
-  "links": {
+        "aiKnowledgeSyncstatus": "AI Sync-Status",
-    "contactsvmhdokumente": "Freigegebene Nutzer",
+        "aiKnowledgeLastSync": "AI Letzter Sync"
-    "vmhMietverhltnisesDokumente": "Mietverhältnisse",
-    "vmhErstgespraechsdokumente": "Erstgespräche",
-    "vmhRumungsklagesdokumente": "Räumungsklagen",
-    "kuendigungDokumente": "Kündigungen",
-    "beteiligte2dokumente": "Beteiligte",
-    "mietobjekt2dokumente": "Mietobjekte",
-    "mietinkassosdokumente": "Mietinkasso",
-    "kndigungensdokumente": "Kündigungen"
-  },
-  "labels": {
-    "Create CDokumente": "Dokument erstellen"
-  },
-  "tooltips": {
-    "aktennr": "Eindeutige Dokument-Nummer aus Advoware",
-    "advowareLastSync": "Zeitpunkt der letzten Synchronisation mit Advoware",
-    "syncStatus": "Status der Synchronisation: pending_sync = Warte auf Sync, clean = erfolgreich, unclean = Abweichungen, failed = Fehler",
-    "xaiId": "Eindeutige ID für x.AI Synchronisation",
-    "xaiCollections": "Liste der x.AI Collections für dieses Dokument",
-    "xaiSyncStatus": "Status der x.AI Synchronisation: pending_sync = Warte auf Sync, clean = erfolgreich, unclean = Abweichungen, failed = Fehler",
-    "fileStatus": "Status der Datei: new = neu hochgeladen, changed = geändert, unchanged = unverändert"
-  },
-  "options": {
-    "syncStatus": {
-      "pending_sync": "Warte auf Sync",
-      "clean": "Synchronisiert",
-      "unclean": "Abweichungen",
-      "failed": "Fehlgeschlagen"
     },
-    "xaiSyncStatus": {
+    "links": {
-      "pending_sync": "Warte auf Sync",
+        "cAdvowareAkten": "Advoware Akte",
-      "clean": "Synchronisiert",
+        "contactsvmhdokumente": "Freigegebene Nutzer",
-      "unclean": "Abweichungen",
+        "vmhMietverhltnisesDokumente": "Mietverhältnisse",
-      "failed": "Fehlgeschlagen"
+        "vmhErstgespraechsdokumente": "Erstgespräche",
+        "vmhRumungsklagesdokumente": "Räumungsklagen",
+        "kuendigungDokumente": "Kündigungen",
+        "beteiligte2dokumente": "Beteiligte",
+        "mietobjekt2dokumente": "Mietobjekte",
+        "mietinkassosdokumente": "Mietinkasso",
+        "kndigungensdokumente": "Kündigungen",
+        "aIKnowledges": "AI Knowledge"
     },
-    "fileStatus": {
+    "labels": {
-      "new": "Neu",
+        "Create CDokumente": "Dokument erstellen"
-      "changed": "Geändert",
+    },
-      "unchanged": "Unverändert"
+    "tooltips": {
+        "blake3hash": "Kryptografischer Blake3-Hash der Datei (schneller und sicherer als MD5/SHA256)",
+        "hnr": "Hierarchische Referenznummer in Advoware",
+        "syncStatus": "Status der Synchronisation mit Advoware: new=neu, unclean=geändert, synced=synchronisiert, failed=Fehler, unsupported=nicht unterstützt",
+        "syncedHash": "Hash-Wert bei letzter erfolgreicher Synchronisation",
+        "usn": "Update Sequence Number - Versionsnummer für Synchronisation",
+        "dateipfad": "Windows-Dateipfad des Dokuments in Advoware"
+    },
+    "options": {
+        "syncStatus": {
+            "new": "Neu",
+            "unclean": "Geändert",
+            "synced": "Synchronisiert",
+            "failed": "Fehler",
+            "unsupported": "Nicht unterstützt"
+        }
     }
-  }
 }

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

@@ -8,7 +8,10 @@
     "kuendiger": "Vermieter",
     "gekuendigte": "Mieter",
     "dokumenteskuendigung": "Dokumente",
-    "contactsKuendigung": "Portal-Freigaben"
+    "contactsKuendigung": "Portal-Freigaben",
+    "advowareAkten": "Advoware Akte",
+    "vmhRumungsklages": "Räumungsklagen",
+    "pulse": "Pulse"
   },
   "labels": {
     "Create CKuendigung": "Kündigung erstellen",
@@ -31,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",
@@ -98,13 +101,13 @@
       "pending_sync": "Warte auf Sync",
       "clean": "Synchronisiert",
       "unclean": "Änderungen ausstehend",
-      "failed": "Fehler"
+      "failed": "Fehler",
+      "no_sync": "Kein Sync"
     }
   },
   "tooltips": {
-    "advowareAktenzeichen": "Aktenzeichen aus Advoware für die Synchronisation",
     "aktennr": "Eindeutige Kündigungs-Nummer aus Advoware",
-    "syncStatus": "Status der 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",
     "sendungsverfolgungsnummer": "Sendungsverfolgungsnummer für Einschreiben",
     "mietrueckstand": "Gesamthöhe des Mietrückstands (nur bei Kündigungsgrund Mietrückstand)",
     "mietkaution": "Einbehaltene oder ausstehende Mietkaution",

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

@@ -1,52 +1,42 @@
 {
-  "fields": {
+    "fields": {
-    "advowareAktenzeichen": "Advoware Aktenzeichen",
+        "klaeger": "Kläger",
-    "aktennr": "Advoware Identifikator",
+        "beklagte": "Beklagte",
-    "advowareLastSync": "Advoware letzte Synchronisation",
+        "vmhMietverhltnises": "Mietverhältnisse",
-    "syncStatus": "Sync-Status",
+        "contactsMietinkasso": "Freigegebene Nutzer",
-    "klaeger": "Kläger",
+        "dokumentesmietinkasso": "Dokumente",
-    "beklagte": "Beklagte",
+        "gegenstandswert": "Gegenstandswert",
-    "vmhMietverhltnises": "Mietverhältnisse",
+        "kuendigungsservice": "Kündigungsservice",
-    "contactsMietinkasso": "Freigegebene Nutzer",
+        "aussergerichtlicheGebuehren13": "Außergerichtliche Gebühren 1,3",
-    "dokumentesmietinkasso": "Dokumente",
+        "gerichtskosten1Instanz": "Gerichtskosten 1. Instanz",
-    "gerichtsrubrum": "Gerichtsrubrum",
+        "anwaltskosten1Instanz": "Anwaltskosten 1. Instanz",
-    "gegenstandswert": "Gegenstandswert",
+        "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
-    "kuendigungsservice": "Kündigungsservice",
+        "collaborators": "Mitarbeiter",
-    "aussergerichtlicheGebuehren13": "Außergerichtliche Gebühren 1,3",
+        "vmhVermietersMIK": "Vermieter",
-    "gerichtskosten1Instanz": "Gerichtskosten 1. Instanz",
+        "advowareAkten": "Advoware Akten",
-    "anwaltskosten1Instanz": "Anwaltskosten 1. Instanz",
+        "aIKnowledge": "AI Knowledge"
-    "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
+    },
-    "collaborators": "Mitarbeiter",
+    "links": {
-    "vmhVermietersMIK": "Vermieter"
+        "meetings": "Termine",
-  },
+        "calls": "Anrufe",
-  "links": {
+        "tasks": "Aufgaben",
-    "meetings": "Termine",
+        "klaeger": "Kläger",
-    "calls": "Anrufe",
+        "beklagte": "Beklagte",
-    "tasks": "Aufgaben",
+        "vmhMietverhltnises": "Mietverhältnisse",
-    "klaeger": "Kläger",
+        "contactsMietinkasso": "Freigegebene Nutzer",
-    "beklagte": "Beklagte",
+        "dokumentesmietinkasso": "Dokumente",
-    "vmhMietverhltnises": "Mietverhältnisse",
+        "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
-    "contactsMietinkasso": "Freigegebene Nutzer",
+        "collaborators": "Mitarbeiter",
-    "dokumentesmietinkasso": "Dokumente",
+        "vmhVermietersMIK": "Vermieter",
-    "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
+        "pulse": "Pulse",
-    "collaborators": "Mitarbeiter",
+        "advowareAkten": "Advoware Akten",
-    "vmhVermietersMIK": "Vermieter"
+        "aIKnowledge": "AI Knowledge"
-  },
+    },
-  "labels": {
+    "labels": {
-    "Create CMietinkasso": "Mietinkasso erstellen"
+        "Create CMietinkasso": "Mietinkasso erstellen"
-  },
+    },
-  "tooltips": {
+    "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 Synchronisation: pending_sync = Warte auf Sync, clean = erfolgreich, unclean = Abweichungen, failed = Fehler"
-  },
-  "options": {
-    "syncStatus": {
-      "pending_sync": "Warte auf Sync",
-      "clean": "Synchronisiert",
-      "unclean": "Abweichungen",
-      "failed": "Fehlgeschlagen"
     }
-  }
 }

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

@@ -20,7 +20,8 @@
   },
   "links": {
     "dokumente": "Dokumente",
-    "teamZuordnungen": "Team-Zuordnungen"
+    "teamZuordnungen": "Team-Zuordnungen",
+    "freigeschalteteNutzer": "Freigeschaltete Nutzer"
   },
   "tooltips": {
     "syncStatus": "Status der KI-Analyse für neue Dokumente",

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

@@ -1,32 +1,27 @@
 {
-  "labels": {
+    "labels": {
-    "Create CPulsTeamZuordnung": "Team-Zuordnung erstellen",
+        "Create CPulsTeamZuordnung": "Puls-Team-Zuordnung erstellen",
-    "CPulsTeamZuordnung": "Puls Team-Zuordnung",
+        "CPulsTeamZuordnung": "Puls-Team-Zuordnungen"
-    "cPulsTeamZuordnung": "Puls Team-Zuordnungen"
+    },
-  },
+    "fields": {
-  "fields": {
+        "puls": "Puls",
-    "name": "Name",
+        "pulsId": "Puls ID",
-    "puls": "Puls",
+        "team": "Team",
-    "team": "Team",
+        "teamId": "Team ID",
-    "aktiv": "Aktiv",
+        "aktiv": "Aktiv",
-    "abgeschlossen": "Abgeschlossen",
+        "abgeschlossen": "Abgeschlossen",
-    "abgeschlossenAm": "Abgeschlossen am",
+        "prioritaet": "Priorität"
-    "abgeschlossenVon": "Abgeschlossen von",
+    },
-    "prioritaet": "Priorität"
+    "links": {
-  },
+        "puls": "Puls",
-  "links": {
+        "team": "Team"
-    "puls": "Puls",
+    },
-    "team": "Team",
+    "options": {
-    "abgeschlossenVon": "Abgeschlossen von"
+        "prioritaet": {
-  },
+            "Niedrig": "Niedrig",
-  "tooltips": {
+            "Normal": "Normal",
-    "aktiv": "Ist diese Team-Zuordnung aktiv? Inaktive werden nicht angezeigt."
+            "Hoch": "Hoch",
-  },
+            "Dringend": "Dringend"
-  "options": {
+        }
-    "prioritaet": {
-      "Niedrig": "Niedrig",
-      "Normal": "Normal",
-      "Hoch": "Hoch"
     }
-  }
 }

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

@@ -1,53 +1,46 @@
 {
-  "fields": {
+    "fields": {
-    "portalUser": "Portalnutzer",
+        "portalUser": "Portalnutzer",
-    "advowareAktenzeichen": "Advoware Aktenzeichen",
+        "klaeger": "Kläger",
-    "aktennr": "Advoware Identifikator",
+        "beklagte": "Beklagte",
-    "advowareLastSync": "Advoware letzte Synchronisation",
+        "vmhMietverhltnises": "Mietverhältnisse",
-    "syncStatus": "Sync-Status",
+        "contactsRumungsklage": "Freigegebene Nutzer",
-    "klaeger": "Kläger",
+        "dokumentesvmhraumungsklage": "Dokumente",
-    "beklagte": "Beklagte",
+        "gerichtsrubrum": "Gerichtsrubrum",
-    "vmhMietverhltnises": "Mietverhältnisse",
+        "gegenstandswert": "Gegenstandswert",
-    "contactsRumungsklage": "Freigegebene Nutzer",
+        "kuendigungsservice": "Kündigungsservice",
-    "dokumentesvmhraumungsklage": "Dokumente",
+        "aussergerichtlicheGebuehren13": "Außergerichtliche Gebühren 1,3",
-    "gerichtsrubrum": "Gerichtsrubrum",
+        "gerichtskosten1Instanz": "Gerichtskosten 1. Instanz",
-    "gegenstandswert": "Gegenstandswert",
+        "anwaltskosten1Instanz": "Anwaltskosten 1. Instanz",
-    "kuendigungsservice": "Kündigungsservice",
+        "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
-    "aussergerichtlicheGebuehren13": "Außergerichtliche Gebühren 1,3",
+        "collaborators": "Mitarbeiter",
-    "gerichtskosten1Instanz": "Gerichtskosten 1. Instanz",
+        "vmhVermietersRKL": "Vermieter",
-    "anwaltskosten1Instanz": "Anwaltskosten 1. Instanz",
+        "advowareAkten": "Advoware Akten",
-    "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
+        "aIKnowledge": "AI Knowledge"
-    "collaborators": "Mitarbeiter",
+    },
-    "vmhVermietersRKL": "Vermieter"
+    "links": {
-  },
+        "meetings": "Termine",
-  "links": {
+        "calls": "Anrufe",
-    "meetings": "Termine",
+        "tasks": "Aufgaben",
-    "calls": "Anrufe",
+        "klaeger": "Kläger",
-    "tasks": "Aufgaben",
+        "beklagte": "Beklagte",
-    "klaeger": "Kläger",
+        "vmhMietverhltnises": "Mietverhältnisse",
-    "beklagte": "Beklagte",
+        "kuendigungen": "Kündigungen",
-    "vmhMietverhltnises": "Mietverhältnisse",
+        "contactsRumungsklage": "Freigegebene Nutzer",
-    "contactsRumungsklage": "Freigegebene Nutzer",
+        "dokumentesvmhraumungsklage": "Dokumente",
-    "dokumentesvmhraumungsklage": "Dokumente",
+        "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
-    "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
+        "collaborators": "Mitarbeiter",
-    "collaborators": "Mitarbeiter",
+        "vmhVermietersRKL": "Vermieter",
-    "vmhVermietersRKL": "Vermieter"
+        "pulse": "Pulse",
-  },
+        "advowareAkten": "Advoware Akten",
-  "labels": {
+        "aIKnowledge": "AI Knowledge"
-    "Create CVmhRumungsklage": "Räumungsklage erstellen"
+    },
-  },
+    "labels": {
-  "tooltips": {
+        "Create CVmhRumungsklage": "Räumungsklage erstellen"
-    "advowareAktenzeichen": "Aktenzeichen aus dem Advoware-System",
+    },
-    "aktennr": "Eindeutige Klage-Nummer aus Advoware",
+    "tooltips": {
-    "advowareLastSync": "Zeitpunkt der letzten Synchronisation mit Advoware",
+        "gerichtsrubrum": "Rubrum des Gerichtsverfahrens",
-    "syncStatus": "Status der Synchronisation: pending_sync = Warte auf Sync, clean = erfolgreich, unclean = Abweichungen, failed = Fehler"
+        "gegenstandswert": "Wert des Streitgegenstands",
-  },
+        "kuendigungsservice": "Kündigungsservice aktiviert"
-  "options": {
-    "syncStatus": {
-      "pending_sync": "Warte auf Sync",
-      "clean": "Synchronisiert",
-      "unclean": "Abweichungen",
-      "failed": "Fehlgeschlagen"
     }
-  }
 }

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

@@ -4,5 +4,8 @@
     },
     "labels": {
         "Log": "Log"
+    },
+    "scopeNamesPlural": {
+        "CAdvowareAkten": "Advoware 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

@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "Συναντήσεις",
+    "calls": "Κλήσεις",
+    "tasks": "Εργασίες"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "Δημιουργία Advoware Akten"
+  }
+}

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

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

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

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

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

@@ -1 +1,8 @@
-{}
+{
+    "fields": {
+        "cAICollections": "AI Collections"
+    },
+    "links": {
+        "cAICollections": "AI Collections"
+    }
+}

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

@@ -0,0 +1,48 @@
+{
+    "fields": {
+        "vmhRumungsklage": "Räumungsklagen",
+        "mietinkasso": "Mietinkasso",
+        "aktenzeichen": "Aktenzeichen",
+        "aktennummer": "Aktennummer",
+        "aktenpfad": "File Path (Windows)",
+        "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",
+        "vmhRumungsklage": "Räumungsklagen",
+        "mietinkasso": "Mietinkasso",
+        "kuendigungen": "Terminations",
+        "dokumentes": "Dokumente"
+    },
+    "labels": {
+        "Create CAdvowareAkten": "Create Advoware Akten"
+    },
+    "options": {
+        "syncStatus": {            "neu": "New",
+            "import": "Import",            "synced": "Synchronized",
+            "unclean": "Not Synchronized",
+            "pending_sync": "Synchronization Pending"
+        },
+        "aktivierungsstatus": {
+            "new": "New",
+            "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. 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, active = Actively synchronized, paused = Synchronization paused, deactivated = Synchronization deactivated",
+        "aktenpfad": "Windows file path to the file in Advoware"
+    }
+}

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

@@ -0,0 +1,33 @@
+{
+    "labels": {
+        "Create CAdvowareAktenCDokumente": "Create Advoware Document Link",
+        "CAdvowareAktenCDokumente": "Advoware Document Links"
+    },
+    "fields": {
+        "cAdvowareAkten": "Advoware File",
+        "cAdvowareAktenId": "Advoware File ID",
+        "cDokumente": "Document",
+        "cDokumenteId": "Document ID",
+        "hnr": "HNR",
+        "syncStatus": "Sync Status",
+        "syncedHash": "Sync Hash",
+        "deleted": "Deleted"
+    },
+    "links": {
+        "cAdvowareAkten": "Advoware 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)"
+    }
+}

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

@@ -1,28 +1,32 @@
 {
     "fields": {
         "dokument": "Download",
-        "ydocumentuuid": "Y-Document-UUID",
         "preview": "Preview",
+        "cAdvowareAkten": "Advoware File",
+        "cAdvowareAktenId": "Advoware File ID",
+        "cAdvowareAktenName": "Advoware File Name",
+        "hnr": "HNR (Advoware)",
+        "syncStatus": "Sync Status",
+        "syncedHash": "Sync Hash",
+        "usn": "USN",
+        "dateipfad": "File Path",
         "contactsvmhdokumente": "Portal Users",
         "vmhMietverhltnisesDokumente": "Tenancies",
         "vmhErstgespraechsdokumente": "Initial Consultations",
         "vmhRumungsklagesdokumente": "Eviction Lawsuits",
         "kuendigungDokumente": "Terminations",
-        "md5sum": "MD5 Checksum",
+        "blake3hash": "Blake3 Hash",
-        "sha256": "SHA256 Checksum",
         "beteiligte2dokumente": "Parties",
         "mietobjekt2dokumente": "Properties",
         "mietinkassosdokumente": "Rent Collection",
         "kndigungensdokumente": "Terminations",
-        "aktennr": "Advoware Identifier",
+        "aIKnowledges": "AI Knowledge",
-        "advowareLastSync": "Advoware Last Sync",
+        "aiKnowledgeAiDocumentId": "AI Document ID",
-        "syncStatus": "Sync Status",
+        "aiKnowledgeSyncstatus": "AI Sync Status",
-        "xaiId": "x.AI ID",
+        "aiKnowledgeLastSync": "AI Last Sync"
-        "xaiCollections": "x.AI Collections",
-        "xaiSyncStatus": "Sync Status",
-        "fileStatus": "File Status"
     },
     "links": {
+        "cAdvowareAkten": "Advoware File",
         "contactsvmhdokumente": "Portal Users",
         "vmhMietverhltnisesDokumente": "Tenancies",
         "vmhErstgespraechsdokumente": "Initial Consultations",
@@ -31,40 +35,32 @@
         "beteiligte2dokumente": "Parties",
         "mietobjekt2dokumente": "Properties",
         "mietinkassosdokumente": "Rent Collection",
-        "kndigungensdokumente": "Terminations"
+        "kndigungensdokumente": "Terminations",
+        "aIKnowledges": "AI Knowledge"
     },
     "labels": {
         "Create CDokumente": "Create Dokument"
     },
     "layouts": {
-        "listRaeumungsKl": "List (RaeumungsKl)"
+        "listRaeumungsKl": "List (RaeumungsKl)",
+        "listForAdvowareAkten": "List for Advoware Akten",
+        "listForAIKnowledge": "List for AI Knowledge"
     },
     "tooltips": {
-        "aktennr": "Unique document number from Advoware",
+        "blake3hash": "Cryptographic Blake3 hash of the file (faster and more secure than MD5/SHA256)",
-        "advowareLastSync": "Time of last synchronization with Advoware",
+        "hnr": "Hierarchical reference number in Advoware",
-        "syncStatus": "Synchronization status: pending_sync = Waiting for sync, clean = successful, unclean = discrepancies, failed = error",
+        "syncStatus": "Sync status with Advoware: new=new, unclean=changed, synced=synchronized, failed=error, unsupported=not supported",
-        "xaiId": "Unique ID for x.AI synchronization",
+        "syncedHash": "Hash value at last successful synchronization",
-        "xaiCollections": "List of x.AI collections for this document",
+        "usn": "Update Sequence Number - Version number for synchronization",
-        "xaiSyncStatus": "x.AI synchronization status: pending_sync = Waiting for sync, clean = successful, unclean = discrepancies, failed = error",
+        "dateipfad": "Windows file path of the document in Advoware"
-        "fileStatus": "File status: new = newly uploaded, changed = modified, unchanged = unchanged"
     },
     "options": {
         "syncStatus": {
-            "pending_sync": "Waiting for Sync",
-            "clean": "Synchronized",
-            "unclean": "Discrepancies",
-            "failed": "Failed"
-        },
-        "xaiSyncStatus": {
-            "pending_sync": "Waiting for Sync",
-            "clean": "Synchronized",
-            "unclean": "Discrepancies",
-            "failed": "Failed"
-        },
-        "fileStatus": {
             "new": "New",
-            "changed": "Changed",
+            "unclean": "Changed",
-            "unchanged": "Unchanged"
+            "synced": "Synchronized",
+            "failed": "Failed",
+            "unsupported": "Unsupported"
         }
     }
 }

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

@@ -9,7 +9,7 @@
         "modifiedBy": "Modified By",
         "freigeschalteteNutzer": "Authorized Users",
         "collaborators": "Collaborators",
-        "advowareAktenzeichen": "Advoware File Number",
+        "advowareAkten": "Advoware File",
         "aktennr": "Case Number",
         "advowareLastSync": "Last Sync",
         "syncStatus": "Sync Status",
@@ -43,7 +43,10 @@
         "kuendiger": "Landlord",
         "gekuendigte": "Tenant",
         "dokumenteskuendigung": "Documents",
-        "contactsKuendigung": "Portal Access"
+        "contactsKuendigung": "Portal Access",
+        "advowareAkten": "Advoware Case File",
+        "vmhRumungsklages": "Eviction Lawsuits",
+        "pulse": "Pulses"
     },
     "labels": {
         "Create CKuendigung": "Create Termination",
@@ -94,15 +97,16 @@
             "JaBesorgnisgrund259ZPO": "Yes, Concern, § 259 ZPO"
         },
         "syncStatus": {
+            "pending_sync": "Waiting for Sync",
             "clean": "Synchronized",
             "unclean": "Changes Pending",
-            "failed": "Failed"
+            "failed": "Failed",
+            "no_sync": "No Sync"
         }
     },
     "tooltips": {
-        "advowareAktenzeichen": "File number from Advoware for synchronization",
         "aktennr": "Case number from Advoware",
-        "syncStatus": "Synchronization status with Advoware",
+        "syncStatus": "Advoware synchronization status: pending_sync = Waiting for sync, clean = successfully synchronized, unclean = changes pending, failed = error, no_sync = Not synchronized",
         "sendungsverfolgungsnummer": "Tracking number for registered mail",
         "mietrueckstand": "Total amount of rent arrears (only for termination reason rent arrears)",
         "mietkaution": "Withheld or outstanding security deposit",

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

@@ -1,51 +1,42 @@
-{
+{
-    "fields": {
+    "fields": {
-        "advowareAktenzeichen": "Advoware Case Number",
+        "klaeger": "Plaintiff",
-        "aktennr": "Advoware Identifier",
+        "beklagte": "Defendant",
-        "advowareLastSync": "Advoware Last Sync",
+        "vmhMietverhltnises": "Tenancies",
-        "syncStatus": "Sync Status",
+        "contactsMietinkasso": "Portal Users",
-        "klaeger": "Plaintiff",
+        "dokumentesmietinkasso": "Documents",
-        "beklagte": "Defendant",
+        "gegenstandswert": "Claim Value",
-        "vmhMietverhltnises": "Tenancies",
+        "kuendigungsservice": "Termination Service",
-        "contactsMietinkasso": "Portal Users",
+        "aussergerichtlicheGebuehren13": "Out-of-court Fees 1.3",
-        "dokumentesmietinkasso": "Documents",
+        "gerichtskosten1Instanz": "Court Costs 1st Instance",
-        "gerichtsrubrum": "Court Rubrum",
+        "anwaltskosten1Instanz": "Attorney Fees 1st Instance",
-        "gegenstandswert": "Claim Value",
+        "freigeschalteteNutzer": "Activated Users (deprecated)",
-        "kuendigungsservice": "Termination Service",
+        "collaborators": "Collaborators",
-        "aussergerichtlicheGebuehren13": "Out-of-court Fees 1.3",
+        "vmhVermietersMIK": "Landlord",
-        "gerichtskosten1Instanz": "Court Costs 1st Instance",
+        "advowareAkten": "Advoware Akten",
-        "anwaltskosten1Instanz": "Attorney Fees 1st Instance",
+        "aIKnowledge": "AI Knowledge"
-        "freigeschalteteNutzer": "Activated Users (deprecated)",
+    },
-        "collaborators": "Collaborators",
+    "links": {
-        "vmhVermietersMIK": "Landlord"
+        "meetings": "Meetings",
-    },
+        "calls": "Calls",
-    "links": {
+        "tasks": "Tasks",
-        "meetings": "Meetings",
+        "klaeger": "Plaintiff",
-        "calls": "Calls",
+        "beklagte": "Defendant",
-        "tasks": "Tasks",
+        "vmhMietverhltnises": "Tenancies",
-        "klaeger": "Plaintiff",
+        "contactsMietinkasso": "Portal Users",
-        "beklagte": "Defendant",
+        "dokumentesmietinkasso": "Documents",
-        "vmhMietverhltnises": "Tenancies",
+        "freigeschalteteNutzer": "Activated Users (deprecated)",
-        "contactsMietinkasso": "Portal Users",
+        "collaborators": "Collaborators",
-        "dokumentesmietinkasso": "Documents",
+        "vmhVermietersMIK": "Landlord",
-        "freigeschalteteNutzer": "Activated Users (deprecated)",
+        "pulse": "Pulses",
-        "collaborators": "Collaborators",
+        "advowareAkten": "Advoware Akten",
-        "vmhVermietersMIK": "Landlord"
+        "aIKnowledge": "AI Knowledge"
-    },
+    },
-    "labels": {
+    "labels": {
-        "Create CMietinkasso": "Create Mietinkasso"
+        "Create CMietinkasso": "Create Mietinkasso"
-    },
+    },
-    "tooltips": {
+    "tooltips": {
-        "advowareAktenzeichen": "Case number from Advoware system",
+        "gegenstandswert": "Value of the disputed matter",
-        "aktennr": "Unique collection number from Advoware",
+        "kuendigungsservice": "Termination service enabled"
-        "advowareLastSync": "Time of last synchronization with Advoware",
+    }
-        "syncStatus": "Synchronization status: clean = successful, unclean = discrepancies, failed = error"
+}
-    },
-    "options": {
-        "syncStatus": {
-            "clean": "Synchronized",
-            "unclean": "Discrepancies",
-            "failed": "Failed"
-        }
-    }
-}

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

@@ -20,7 +20,8 @@
   },
   "links": {
     "dokumente": "Documents",
-    "teamZuordnungen": "Team Assignments"
+    "teamZuordnungen": "Team Assignments",
+    "freigeschalteteNutzer": "Authorized Users"
   },
   "tooltips": {
     "syncStatus": "AI analysis status for new documents",

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

@@ -0,0 +1,27 @@
+{
+    "labels": {
+        "Create CPulsTeamZuordnung": "Create Puls Team Assignment",
+        "CPulsTeamZuordnung": "Puls Team Assignments"
+    },
+    "fields": {
+        "puls": "Puls",
+        "pulsId": "Puls ID",
+        "team": "Team",
+        "teamId": "Team ID",
+        "aktiv": "Active",
+        "abgeschlossen": "Completed",
+        "prioritaet": "Priority"
+    },
+    "links": {
+        "puls": "Puls",
+        "team": "Team"
+    },
+    "options": {
+        "prioritaet": {
+            "Niedrig": "Low",
+            "Normal": "Normal",
+            "Hoch": "High",
+            "Dringend": "Urgent"
+        }
+    }
+}

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

@@ -12,22 +12,33 @@
         "kuendigungsservice": "Termination Service",
         "aussergerichtlicheGebuehren13": "Out-of-Court Fees 1.3",
         "gerichtskosten1Instanz": "Court Costs 1st Instance",
-        "anwaltskosten1Instanz": "Attorney Fees 1st Instance"
+        "anwaltskosten1Instanz": "Attorney Fees 1st Instance",
+        "advowareAkten": "Advoware Akten",
+        "aIKnowledge": "AI Knowledge"
     },
     "links": {
         "meetings": "Meetings",
         "calls": "Calls",
         "tasks": "Tasks",
         "vmhMietverhltnises": "Tenancies",
+        "kuendigungen": "Terminations",
         "freigeschalteteNutzer": "Activated Users",
         "collaborators": "Collaborators",
         "vmhVermietersRKL": "Landlord",
         "dokumentesvmhraumungsklage": "Documents",
         "beklagte": "Defendant",
         "klaeger": "Plaintiff",
-        "contactsRumungsklage": "Portal Users"
+        "contactsRumungsklage": "Portal Users",
+        "pulse": "Pulses",
+        "advowareAkten": "Advoware Akten",
+        "aIKnowledge": "AI Knowledge"
     },
     "labels": {
         "Create CVmhRumungsklage": "Create Räumungsklage"
+    },
+    "tooltips": {
+        "gerichtsrubrum": "Court proceeding rubrum",
+        "gegenstandswert": "Value of the disputed matter",
+        "kuendigungsservice": "Termination service enabled"
     }
 }

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

@@ -14,7 +14,9 @@
         "CBankverbindungen": "Bankverbindung",
         "CMietinkasso": "Mietinkasso",
         "CKuendigung": "Kündigung",
-        "CPuls": "Puls"
+        "CPuls": "Puls",
+        "CAdvowareAkten": "Advoware Akten",
+        "CAIKnowledge": "AI Knowledge"
     },
     "scopeNamesPlural": {
         "CVmhMietverhltnis": "Mietverhältnisse",
@@ -31,6 +33,8 @@
         "CBankverbindungen": "Bankverbindungen",
         "CMietinkasso": "Mietinkassa",
         "CKuendigung": "Kündigungen",
-        "CPuls": "Pulse"
+        "CPuls": "Pulse",
+        "CAdvowareAkten": "Advoware Akten",
+        "CAIKnowledge": "AI Knowledge"
     }
 }

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

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

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

@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "Reuniones",
+    "calls": "Llamadas",
+    "tasks": "Tareas"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "Crear Advoware Akten"
+  }
+}

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

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

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

@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "Presentaciones",
+    "calls": "Llamadas",
+    "tasks": "Tareas"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "Crear Advoware Akten"
+  }
+}

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

@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "ایجاد AI Knowledge"
+  }
+}

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

@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "جلسات",
+    "calls": "تماس ها",
+    "tasks": "وظایف"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "ایجاد Advoware Akten"
+  }
+}