Update EspoCRM Best Practices to version 2.4 with new features and implementation patterns for Custom API Endpoints; remove outdated TESTERGEBNISSE_JUNCTION_TABLE.md file.

Update configuration and localization files for CAIKnowledgeCDokumente; add metadata and scopes
Implement CAIKnowledge and CDokumente junction functionality; add API routes, metadata, and localization files
2026-03-12 22:52:42 +01:00 · 2026-03-12 22:40:38 +01:00 · 2026-03-12 22:39:33 +01:00 · 2026-03-12 21:50:02 +01:00 · 2026-03-11 22:45:42 +01:00 · 2026-03-11 22:20:21 +01:00
257 changed files with 180484 additions and 2098 deletions
--- a/.github/agents/espocrm-developer.agent.md
+++ b/.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.
--- a/.github/agents/espocrm-docs-maintainer.agent.md
+++ b/.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.
--- a/application/Espo/Classes/RecordHooks/CurrencyRecordRate/AfterDelete.php
+++ b/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');
    }
 }
--- a/application/Espo/Classes/RecordHooks/CurrencyRecordRate/AfterSave.php
+++ b/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');
    }
 }
--- a/application/Espo/Tools/Stream/RecordService.php
+++ b/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);
--- a/client/lib/espo-admin.js
+++ b/client/lib/espo-admin.js
--- a/client/lib/espo-calendar.js
+++ b/client/lib/espo-calendar.js
--- a/client/lib/espo-chart.js
+++ b/client/lib/espo-chart.js
--- a/client/lib/espo-crm.js
+++ b/client/lib/espo-crm.js
--- a/client/lib/espo-extra.js
+++ b/client/lib/espo-extra.js
--- a/client/lib/espo-main.js
+++ b/client/lib/espo-main.js
--- a/client/lib/espo-timeline.js
+++ b/client/lib/espo-timeline.js
@@ -1,4 +1,4 @@
-/*! espocrm 2026-03-06 */
+/*! 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">
--- a/client/lib/espo.js
+++ b/client/lib/espo.js
--- a/client/lib/templates.tpl
+++ b/client/lib/templates.tpl
--- a/custom/DOCUMENTATION_INDEX.md
+++ b/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`
--- a/custom/Espo/Custom/Api/JunctionData/GetDokumentes.php
+++ b/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
+        ]);
+    }
+}
--- a/custom/Espo/Custom/Api/JunctionData/LinkDokument.php
+++ b/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;
+    }
+}
--- a/custom/Espo/Custom/Api/JunctionData/UpdateJunction.php
+++ b/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;
+    }
+}
--- a/custom/Espo/Custom/Controllers/CAICollectionCDokumente.php
+++ b/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}
+}
--- a/custom/Espo/Custom/Controllers/CAIKnowledge.php
+++ b/custom/Espo/Custom/Controllers/CAIKnowledge.php
@@ -0,0 +1,7 @@
+<?php
+
+namespace Espo\Custom\Controllers;
+
+class CAIKnowledge extends \Espo\Core\Templates\Controllers\Base
+{
+}
--- a/custom/Espo/Custom/Controllers/CAIKnowledgeCDokumente.php
+++ b/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}
+}
--- a/custom/Espo/Custom/Controllers/CAdvowareAkten.php
+++ b/custom/Espo/Custom/Controllers/CAdvowareAkten.php
@@ -0,0 +1,7 @@
+<?php
+
+namespace Espo\Custom\Controllers;
+
+class CAdvowareAkten extends \Espo\Core\Templates\Controllers\BasePlus
+{
+}
--- a/custom/Espo/Custom/Controllers/CAdvowareAktenCDokumente.php
+++ b/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}
+}
--- a/custom/Espo/Custom/Hooks/CAIKnowledge/CheckGlobalSyncStatus.php
+++ b/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');
+        }
+    }
+}
--- a/custom/Espo/Custom/Hooks/CAIKnowledge/DokumenteSyncStatus.php
+++ b/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());
+        }
+    }
+}
--- a/custom/Espo/Custom/Hooks/CAIKnowledge/PropagateDocumentsUp.php
+++ b/custom/Espo/Custom/Hooks/CAIKnowledge/PropagateDocumentsUp.php
@@ -0,0 +1,155 @@
+<?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);
+            }
+            
+            // Prüfe ob Mietinkasso verknüpft ist
+            $mietinkasso = $this->entityManager
+                ->getRDBRepository('CAIKnowledge')
+                ->getRelation($entity, 'mietinkasso')
+                ->findOne();
+            
+            if ($mietinkasso) {
+                $this->relateDocument($mietinkasso, 'dokumentesmietinkasso', $foreignEntity);
+            }
+            
+        } 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);
+            }
+            
+        } 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);
+        }
+    }
+}
--- a/custom/Espo/Custom/Hooks/CAdvowareAkten/CheckGlobalSyncStatus.php
+++ b/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');
+        }
+    }
+}
--- a/custom/Espo/Custom/Hooks/CAdvowareAkten/DokumenteSyncStatus.php
+++ b/custom/Espo/Custom/Hooks/CAdvowareAkten/DokumenteSyncStatus.php
@@ -0,0 +1,47 @@
+<?php
+namespace Espo\Custom\Hooks\CAdvowareAkten;
+
+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('CAdvowareAkten');
+        
+        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('CAdvowareAkten DokumenteSyncStatus Hook Error: ' . $e->getMessage());
+        }
+    }
+}
--- a/custom/Espo/Custom/Hooks/CAdvowareAkten/PropagateDocumentsUp.php
+++ b/custom/Espo/Custom/Hooks/CAdvowareAkten/PropagateDocumentsUp.php
@@ -0,0 +1,155 @@
+<?php
+namespace Espo\Custom\Hooks\CAdvowareAkten;
+
+use Espo\ORM\Entity;
+use Espo\Core\Hook\Hook\AfterRelate;
+use Espo\Core\Hook\Hook\AfterUnrelate;
+
+/**
+ * Hook: Propagiert Dokumenten-Verknüpfungen von AdvowareAkten nach oben zu Räumungsklage/Mietinkasso
+ * 
+ * Wenn Dokument mit AdvowareAkten verknüpft wird:
+ * → verknüpfe mit verbundener Räumungsklage/Mietinkasso
+ * → von dort propagiert es automatisch zu AIKnowledge (via deren Hooks)
+ * 
+ * Wenn Dokument von AdvowareAkten entknüpft wird:
+ * → entknüpfe von verbundener Räumungsklage/Mietinkasso
+ * → von dort propagiert es automatisch von AIKnowledge (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('CAdvowareAkten')
+                ->getRelation($entity, 'vmhRumungsklage')
+                ->findOne();
+            
+            if ($raumungsklage) {
+                $this->relateDocument($raumungsklage, 'dokumentesvmhraumungsklage', $foreignEntity);
+            }
+            
+            // Prüfe ob Mietinkasso verknüpft ist
+            $mietinkasso = $this->entityManager
+                ->getRDBRepository('CAdvowareAkten')
+                ->getRelation($entity, 'mietinkasso')
+                ->findOne();
+            
+            if ($mietinkasso) {
+                $this->relateDocument($mietinkasso, 'dokumentesmietinkasso', $foreignEntity);
+            }
+            
+        } catch (\Exception $e) {
+            $GLOBALS['log']->error('CAdvowareAkten PropagateDocumentsUp (relate) Error: ' . $e->getMessage());
+        } finally {
+            unset(self::$processing[$key]);
+        }
+    }
+    
+    public function afterUnrelate(
+        Entity $entity,
+        string $relationName,
+        Entity $foreignEntity,
+        \Espo\ORM\Repository\Option\UnrelateOptions $options
+    ): void {
+        // Nur für dokumentes-Beziehung
+        if ($relationName !== 'dokumentes') {
+            return;
+        }
+        
+        // Vermeide Loops
+        $key = $entity->getId() . '-' . $foreignEntity->getId() . '-unrelate';
+        if (isset(self::$processing[$key])) {
+            return;
+        }
+        self::$processing[$key] = true;
+        
+        try {
+            // Prüfe ob Räumungsklage verknüpft ist
+            $raumungsklage = $this->entityManager
+                ->getRDBRepository('CAdvowareAkten')
+                ->getRelation($entity, 'vmhRumungsklage')
+                ->findOne();
+            
+            if ($raumungsklage) {
+                $this->unrelateDocument($raumungsklage, 'dokumentesvmhraumungsklage', $foreignEntity);
+            }
+            
+            // Prüfe ob Mietinkasso verknüpft ist
+            $mietinkasso = $this->entityManager
+                ->getRDBRepository('CAdvowareAkten')
+                ->getRelation($entity, 'mietinkasso')
+                ->findOne();
+            
+            if ($mietinkasso) {
+                $this->unrelateDocument($mietinkasso, 'dokumentesmietinkasso', $foreignEntity);
+            }
+            
+        } catch (\Exception $e) {
+            $GLOBALS['log']->error('CAdvowareAkten 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);
+        }
+    }
+}
--- a/custom/Espo/Custom/Hooks/CDokumente/CDokumente.php
+++ b/custom/Espo/Custom/Hooks/CDokumente/CDokumente.php
@@ -35,25 +35,27 @@ class CDokumente extends \Espo\Core\Hooks\Base
            return;
        }

-        // Berechne neue Hashes
-        $newMd5 = hash_file('md5', $filePath);
-        $newSha256 = hash_file('sha256', $filePath);
+        // Berechne Blake3 Hash
+        $fileContent = file_get_contents($filePath);
+        if ($fileContent === false) {
+            return;
+        }
+        
+        $newBlake3 = \blake3($fileContent);

-        // Setze Hashes
-        $entity->set('md5sum', $newMd5);
-        $entity->set('sha256', $newSha256);
+        // Setze Hash
+        $entity->set('blake3hash', $newBlake3);

        // Bestimme Status
        if ($entity->isNew()) {
            $entity->set('fileStatus', 'new');
        } else {
-            $oldMd5 = $entity->getFetched('md5sum');
-            $oldSha256 = $entity->getFetched('sha256');
+            $oldBlake3 = $entity->getFetched('blake3hash');

-            if ($oldMd5 !== $newMd5 || $oldSha256 !== $newSha256) {
+            if ($oldBlake3 !== $newBlake3) {
                $entity->set('fileStatus', 'changed');
            } else {
-                $entity->set('fileStatus', 'unchanged');
+                $entity->set('fileStatus', 'synced');
            }
        }
    }
--- a/custom/Espo/Custom/Hooks/CDokumente/UpdateJunctionSyncStatus.php
+++ b/custom/Espo/Custom/Hooks/CDokumente/UpdateJunctionSyncStatus.php
@@ -0,0 +1,155 @@
+<?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 werden alle verknüpften
+ * AdvowareAkten und AIKnowledge Junction-Table-Einträge auf "unclean" gesetzt
+ */
+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 {
+            // Update AdvowareAkten Junction-Tables
+            $this->updateAdvowareAktenJunctions($entity);
+            
+            // Update AIKnowledge Junction-Tables
+            $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 AdvowareAkten Junction-Tables
+     */
+    private function updateAdvowareAktenJunctions(Entity $entity): void
+    {
+        $updateQuery = $this->entityManager->getQueryBuilder()
+            ->update()
+            ->in('CAdvowareAktenDokumente')
+            ->set(['syncstatus' => 'unclean'])
+            ->where([
+                'cDokumenteId' => $entity->getId(),
+                'deleted' => false
+            ])
+            ->build();
+        
+        $this->entityManager->getQueryExecutor()->execute($updateQuery);
+        
+        // Hole alle betroffenen AdvowareAkten IDs
+        $selectQuery = $this->entityManager->getQueryBuilder()
+            ->select(['cAdvowareAktenId'])
+            ->from('CAdvowareAktenDokumente')
+            ->where([
+                'cDokumenteId' => $entity->getId(),
+                'deleted' => false
+            ])
+            ->build();
+        
+        $pdoStatement = $this->entityManager->getQueryExecutor()->execute($selectQuery);
+        $rows = $pdoStatement->fetchAll(\PDO::FETCH_ASSOC);
+        
+        // Trigger Update auf jeder AdvowareAkte (um CheckGlobalSyncStatus Hook auszulösen)
+        foreach ($rows as $row) {
+            $aktenId = $row['cAdvowareAktenId'] ?? null;
+            if ($aktenId) {
+                $akte = $this->entityManager->getEntity('CAdvowareAkten', $aktenId);
+                if ($akte) {
+                    // Force Update ohne Hook-Loop
+                    $akte->set('syncStatus', 'unclean');
+                    $this->entityManager->saveEntity($akte);
+                }
+            }
+        }
+    }
+    
+    /**
+     * 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);
+                }
+            }
+        }
+    }
+}
--- a/custom/Espo/Custom/Hooks/CMietinkasso/PropagateDocuments.php
+++ b/custom/Espo/Custom/Hooks/CMietinkasso/PropagateDocuments.php
@@ -0,0 +1,154 @@
+<?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();
+            
+            // Verknüpfe Dokument mit AdvowareAkten
+            if ($advowareAkten) {
+                $this->relateDocument($advowareAkten, 'dokumentes', $foreignEntity);
+            }
+            
+            // 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();
+            
+            // Entknüpfe Dokument von AdvowareAkten
+            if ($advowareAkten) {
+                $this->unrelateDocument($advowareAkten, 'dokumentes', $foreignEntity);
+            }
+            
+            // 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);
+        }
+    }
+}
--- a/custom/Espo/Custom/Hooks/CVmhRumungsklage/PropagateDocuments.php
+++ b/custom/Espo/Custom/Hooks/CVmhRumungsklage/PropagateDocuments.php
@@ -0,0 +1,154 @@
+<?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();
+            
+            // Verknüpfe Dokument mit AdvowareAkten
+            if ($advowareAkten) {
+                $this->relateDocument($advowareAkten, 'dokumentes', $foreignEntity);
+            }
+            
+            // 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();
+            
+            // Entknüpfe Dokument von AdvowareAkten
+            if ($advowareAkten) {
+                $this->unrelateDocument($advowareAkten, 'dokumentes', $foreignEntity);
+            }
+            
+            // 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);
+        }
+    }
+}
--- a/custom/Espo/Custom/Resources/i18n/ar_AR/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/ar_AR/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "إنشاء {الكيانTypeTranslated}"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/ar_AR/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/ar_AR/CAdvowareAkten.json
@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "الاجتماعات",
+    "calls": "المكالمات",
+    "tasks": "مهام"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "إنشاء {الكيانTypeTranslated}"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/bg_BG/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/bg_BG/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Създаване на AI Knowledge"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/bg_BG/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/bg_BG/CAdvowareAkten.json
@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "Срещи",
+    "calls": "Разговори",
+    "tasks": "Задачи"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "Създаване на Advoware Akten"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/cs_CZ/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/cs_CZ/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Vytvořit AI Knowledge"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/cs_CZ/CAdvowareAkten.json
+++ b/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"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/da_DK/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/da_DK/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Opret AI Knowledge "
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/da_DK/CAdvowareAkten.json
+++ b/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 "
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/de_DE/CAIKnowledge.json
+++ b/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"
+    }
+}
--- a/custom/Espo/Custom/Resources/i18n/de_DE/CAIKnowledgeCDokumente.json
+++ b/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"
+    }
+}
--- a/custom/Espo/Custom/Resources/i18n/de_DE/CAIKnowledgeDokumente.json
+++ b/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"
+    }
+}
--- a/custom/Espo/Custom/Resources/i18n/de_DE/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/de_DE/CAdvowareAkten.json
@@ -0,0 +1,46 @@
+{
+    "links": {
+        "calls": "Anrufe",
+        "tasks": "Aufgaben",
+        "vmhRumungsklage": "Räumungsklagen",
+        "mietinkasso": "Mietinkasso",
+        "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": {
+            "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"
+    }
+}
--- a/custom/Espo/Custom/Resources/i18n/de_DE/CAdvowareAktenCDokumente.json
+++ b/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)"
+    }
+}
--- a/custom/Espo/Custom/Resources/i18n/de_DE/CDokumente.json
+++ b/custom/Espo/Custom/Resources/i18n/de_DE/CDokumente.json
@@ -2,16 +2,7 @@
    "fields": {
        "dokument": "Download",
        "preview": "Vorschau",
-        "ydocumentuuid": "Y-Document-UUID",
-        "md5sum": "MD5-Prüfsumme",
-        "sha256": "SHA256-Prüfsumme",
-        "aktennr": "Advoware Identifikator",
-        "advowareLastSync": "Advoware letzte Synchronisation",
-        "syncStatus": "Sync-Status",
-        "xaiId": "x.AI ID",
-        "xaiCollections": "x.AI Collections",
-        "xaiSyncStatus": "Sync-Status",
-        "fileStatus": "Datei-Status",
+        "blake3hash": "Blake3-Hash",
        "contactsvmhdokumente": "Freigegebene Nutzer",
        "vmhMietverhltnisesDokumente": "Mietverhältnisse",
        "vmhErstgespraechsdokumente": "Erstgespräche",
@@ -20,7 +11,15 @@
        "beteiligte2dokumente": "Beteiligte",
        "mietobjekt2dokumente": "Mietobjekte",
        "mietinkassosdokumente": "Mietinkasso",
-        "kndigungensdokumente": "Kündigungen"
+        "kndigungensdokumente": "Kündigungen",
+        "advowareAktens": "Advoware Akten",
+        "aIKnowledges": "AI Knowledge",
+        "advowareAktenHnr": "Advoware HNR",
+        "advowareAktenSyncstatus": "Advoware Sync-Status",
+        "advowareAktenLastSync": "Advoware Letzter Sync",
+        "aiKnowledgeAiDocumentId": "AI Document ID",
+        "aiKnowledgeSyncstatus": "AI Sync-Status",
+        "aiKnowledgeLastSync": "AI Letzter Sync"
    },
    "links": {
        "contactsvmhdokumente": "Freigegebene Nutzer",
@@ -31,38 +30,14 @@
        "beteiligte2dokumente": "Beteiligte",
        "mietobjekt2dokumente": "Mietobjekte",
        "mietinkassosdokumente": "Mietinkasso",
-        "kndigungensdokumente": "Kündigungen"
+        "kndigungensdokumente": "Kündigungen",
+        "advowareAktens": "Advoware Akten",
+        "aIKnowledges": "AI Knowledge"
    },
    "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 synchronisiert, unclean = Änderungen ausstehend, failed = Fehler, no_sync = Nicht synchronisiert",
-        "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": {
-            "pending_sync": "Warte auf Sync",
-            "clean": "Synchronisiert",
-            "unclean": "Abweichungen",
-            "failed": "Fehlgeschlagen",
-            "no_sync": "Kein Sync"
-        },
-        "fileStatus": {
-            "new": "Neu",
-            "changed": "Geändert",
-            "unchanged": "Unverändert"
-        }
+        "blake3hash": "Kryptografischer Blake3-Hash der Datei (schneller und sicherer als MD5/SHA256)"
    }
 }
--- a/custom/Espo/Custom/Resources/i18n/de_DE/CKuendigung.json
+++ b/custom/Espo/Custom/Resources/i18n/de_DE/CKuendigung.json
@@ -99,13 +99,14 @@
      "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",
--- a/custom/Espo/Custom/Resources/i18n/de_DE/CMietinkasso.json
+++ b/custom/Espo/Custom/Resources/i18n/de_DE/CMietinkasso.json
@@ -1,53 +1,42 @@
 {
-  "fields": {
-    "advowareAktenzeichen": "Advoware Aktenzeichen",
-    "aktennr": "Advoware Identifikator",
-    "advowareLastSync": "Advoware letzte Synchronisation",
-    "syncStatus": "Sync-Status",
-    "klaeger": "Kläger",
-    "beklagte": "Beklagte",
-    "vmhMietverhltnises": "Mietverhältnisse",
-    "contactsMietinkasso": "Freigegebene Nutzer",
-    "dokumentesmietinkasso": "Dokumente",
-    "gerichtsrubrum": "Gerichtsrubrum",
-    "gegenstandswert": "Gegenstandswert",
-    "kuendigungsservice": "Kündigungsservice",
-    "aussergerichtlicheGebuehren13": "Außergerichtliche Gebühren 1,3",
-    "gerichtskosten1Instanz": "Gerichtskosten 1. Instanz",
-    "anwaltskosten1Instanz": "Anwaltskosten 1. Instanz",
-    "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
-    "collaborators": "Mitarbeiter",
-    "vmhVermietersMIK": "Vermieter"
-  },
-  "links": {
-    "meetings": "Termine",
-    "calls": "Anrufe",
-    "tasks": "Aufgaben",
-    "klaeger": "Kläger",
-    "beklagte": "Beklagte",
-    "vmhMietverhltnises": "Mietverhältnisse",
-    "contactsMietinkasso": "Freigegebene Nutzer",
-    "dokumentesmietinkasso": "Dokumente",
-    "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
-    "collaborators": "Mitarbeiter",
-    "vmhVermietersMIK": "Vermieter",
-    "pulse": "Pulse"
-  },
-  "labels": {
-    "Create CMietinkasso": "Mietinkasso erstellen"
-  },
-  "tooltips": {
-    "advowareAktenzeichen": "Aktenzeichen aus dem Advoware-System",
-    "aktennr": "Eindeutige Inkasso-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"
-  },
-  "options": {
-    "syncStatus": {
-      "pending_sync": "Warte auf Sync",
-      "clean": "Synchronisiert",
-      "unclean": "Abweichungen",
-      "failed": "Fehlgeschlagen"
+    "fields": {
+        "klaeger": "Kläger",
+        "beklagte": "Beklagte",
+        "vmhMietverhltnises": "Mietverhältnisse",
+        "contactsMietinkasso": "Freigegebene Nutzer",
+        "dokumentesmietinkasso": "Dokumente",
+        "gegenstandswert": "Gegenstandswert",
+        "kuendigungsservice": "Kündigungsservice",
+        "aussergerichtlicheGebuehren13": "Außergerichtliche Gebühren 1,3",
+        "gerichtskosten1Instanz": "Gerichtskosten 1. Instanz",
+        "anwaltskosten1Instanz": "Anwaltskosten 1. Instanz",
+        "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
+        "collaborators": "Mitarbeiter",
+        "vmhVermietersMIK": "Vermieter",
+        "advowareAkten": "Advoware Akten",
+        "aIKnowledge": "AI Knowledge"
+    },
+    "links": {
+        "meetings": "Termine",
+        "calls": "Anrufe",
+        "tasks": "Aufgaben",
+        "klaeger": "Kläger",
+        "beklagte": "Beklagte",
+        "vmhMietverhltnises": "Mietverhältnisse",
+        "contactsMietinkasso": "Freigegebene Nutzer",
+        "dokumentesmietinkasso": "Dokumente",
+        "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
+        "collaborators": "Mitarbeiter",
+        "vmhVermietersMIK": "Vermieter",
+        "pulse": "Pulse",
+        "advowareAkten": "Advoware Akten",
+        "aIKnowledge": "AI Knowledge"
+    },
+    "labels": {
+        "Create CMietinkasso": "Mietinkasso erstellen"
+    },
+    "tooltips": {
+        "gegenstandswert": "Wert des Streitgegenstands",
+        "kuendigungsservice": "Kündigungsservice aktiviert"
    }
-  }
 }
--- a/custom/Espo/Custom/Resources/i18n/de_DE/CPulsTeamZuordnung.json
+++ b/custom/Espo/Custom/Resources/i18n/de_DE/CPulsTeamZuordnung.json
@@ -1,32 +1,27 @@
 {
-  "labels": {
-    "Create CPulsTeamZuordnung": "Team-Zuordnung erstellen",
-    "CPulsTeamZuordnung": "Puls Team-Zuordnung",
-    "cPulsTeamZuordnung": "Puls Team-Zuordnungen"
-  },
-  "fields": {
-    "name": "Name",
-    "puls": "Puls",
-    "team": "Team",
-    "aktiv": "Aktiv",
-    "abgeschlossen": "Abgeschlossen",
-    "abgeschlossenAm": "Abgeschlossen am",
-    "abgeschlossenVon": "Abgeschlossen von",
-    "prioritaet": "Priorität"
-  },
-  "links": {
-    "puls": "Puls",
-    "team": "Team",
-    "abgeschlossenVon": "Abgeschlossen von"
-  },
-  "tooltips": {
-    "aktiv": "Ist diese Team-Zuordnung aktiv? Inaktive werden nicht angezeigt."
-  },
-  "options": {
-    "prioritaet": {
-      "Niedrig": "Niedrig",
-      "Normal": "Normal",
-      "Hoch": "Hoch"
+    "labels": {
+        "Create CPulsTeamZuordnung": "Puls-Team-Zuordnung erstellen",
+        "CPulsTeamZuordnung": "Puls-Team-Zuordnungen"
+    },
+    "fields": {
+        "puls": "Puls",
+        "pulsId": "Puls ID",
+        "team": "Team",
+        "teamId": "Team ID",
+        "aktiv": "Aktiv",
+        "abgeschlossen": "Abgeschlossen",
+        "prioritaet": "Priorität"
+    },
+    "links": {
+        "puls": "Puls",
+        "team": "Team"
+    },
+    "options": {
+        "prioritaet": {
+            "Niedrig": "Niedrig",
+            "Normal": "Normal",
+            "Hoch": "Hoch",
+            "Dringend": "Dringend"
+        }
    }
-  }
 }
--- a/custom/Espo/Custom/Resources/i18n/de_DE/CVmhRumungsklage.json
+++ b/custom/Espo/Custom/Resources/i18n/de_DE/CVmhRumungsklage.json
@@ -1,56 +1,45 @@
 {
-  "fields": {
-    "portalUser": "Portalnutzer",
-    "advowareAktenzeichen": "Advoware Aktenzeichen",
-    "aktennr": "Advoware Identifikator",
-    "advowareLastSync": "Advoware letzte Synchronisation",
-    "syncStatus": "Sync-Status",
-    "xaiCollectionId": "x.AI Collection ID",
-    "klaeger": "Kläger",
-    "beklagte": "Beklagte",
-    "vmhMietverhltnises": "Mietverhältnisse",
-    "contactsRumungsklage": "Freigegebene Nutzer",
-    "dokumentesvmhraumungsklage": "Dokumente",
-    "gerichtsrubrum": "Gerichtsrubrum",
-    "gegenstandswert": "Gegenstandswert",
-    "kuendigungsservice": "Kündigungsservice",
-    "aussergerichtlicheGebuehren13": "Außergerichtliche Gebühren 1,3",
-    "gerichtskosten1Instanz": "Gerichtskosten 1. Instanz",
-    "anwaltskosten1Instanz": "Anwaltskosten 1. Instanz",
-    "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
-    "collaborators": "Mitarbeiter",
-    "vmhVermietersRKL": "Vermieter"
-  },
-  "links": {
-    "meetings": "Termine",
-    "calls": "Anrufe",
-    "tasks": "Aufgaben",
-    "klaeger": "Kläger",
-    "beklagte": "Beklagte",
-    "vmhMietverhltnises": "Mietverhältnisse",
-    "contactsRumungsklage": "Freigegebene Nutzer",
-    "dokumentesvmhraumungsklage": "Dokumente",
-    "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
-    "collaborators": "Mitarbeiter",
-    "vmhVermietersRKL": "Vermieter",
-    "pulse": "Pulse"
-  },
-  "labels": {
-    "Create CVmhRumungsklage": "Räumungsklage erstellen"
-  },
-  "tooltips": {
-    "advowareAktenzeichen": "Aktenzeichen aus dem Advoware-System",
-    "aktennr": "Eindeutige Klage-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",
-    "xaiCollectionId": "Collection ID für x.AI Synchronisation"
-  },
-  "options": {
-    "syncStatus": {
-      "pending_sync": "Warte auf Sync",
-      "clean": "Synchronisiert",
-      "unclean": "Abweichungen",
-      "failed": "Fehlgeschlagen"
+    "fields": {
+        "portalUser": "Portalnutzer",
+        "klaeger": "Kläger",
+        "beklagte": "Beklagte",
+        "vmhMietverhltnises": "Mietverhältnisse",
+        "contactsRumungsklage": "Freigegebene Nutzer",
+        "dokumentesvmhraumungsklage": "Dokumente",
+        "gerichtsrubrum": "Gerichtsrubrum",
+        "gegenstandswert": "Gegenstandswert",
+        "kuendigungsservice": "Kündigungsservice",
+        "aussergerichtlicheGebuehren13": "Außergerichtliche Gebühren 1,3",
+        "gerichtskosten1Instanz": "Gerichtskosten 1. Instanz",
+        "anwaltskosten1Instanz": "Anwaltskosten 1. Instanz",
+        "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
+        "collaborators": "Mitarbeiter",
+        "vmhVermietersRKL": "Vermieter",
+        "advowareAkten": "Advoware Akten",
+        "aIKnowledge": "AI Knowledge"
+    },
+    "links": {
+        "meetings": "Termine",
+        "calls": "Anrufe",
+        "tasks": "Aufgaben",
+        "klaeger": "Kläger",
+        "beklagte": "Beklagte",
+        "vmhMietverhltnises": "Mietverhältnisse",
+        "contactsRumungsklage": "Freigegebene Nutzer",
+        "dokumentesvmhraumungsklage": "Dokumente",
+        "freigeschalteteNutzer": "Freigeschaltete Nutzer (veraltet)",
+        "collaborators": "Mitarbeiter",
+        "vmhVermietersRKL": "Vermieter",
+        "pulse": "Pulse",
+        "advowareAkten": "Advoware Akten",
+        "aIKnowledge": "AI Knowledge"
+    },
+    "labels": {
+        "Create CVmhRumungsklage": "Räumungsklage erstellen"
+    },
+    "tooltips": {
+        "gerichtsrubrum": "Rubrum des Gerichtsverfahrens",
+        "gegenstandswert": "Wert des Streitgegenstands",
+        "kuendigungsservice": "Kündigungsservice aktiviert"
    }
-  }
 }
--- a/custom/Espo/Custom/Resources/i18n/de_DE/Global.json
+++ b/custom/Espo/Custom/Resources/i18n/de_DE/Global.json
@@ -4,5 +4,8 @@
    },
    "labels": {
        "Log": "Log"
+    },
+    "scopeNamesPlural": {
+        "CAdvowareAkten": "Advoware Akten"
    }
-}
+}
--- a/custom/Espo/Custom/Resources/i18n/el_GR/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/el_GR/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Δημιουργία  AI Knowledge"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/el_GR/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/el_GR/CAdvowareAkten.json
@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "Συναντήσεις",
+    "calls": "Κλήσεις",
+    "tasks": "Εργασίες"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "Δημιουργία Advoware Akten"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/en_GB/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/en_GB/CAIKnowledge.json
@@ -0,0 +1 @@
+{}
--- a/custom/Espo/Custom/Resources/i18n/en_GB/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/en_GB/CAdvowareAkten.json
@@ -0,0 +1 @@
+{}
--- a/custom/Espo/Custom/Resources/i18n/en_GB/CDokumente.json
+++ b/custom/Espo/Custom/Resources/i18n/en_GB/CDokumente.json
@@ -1 +1,8 @@
-{}
+{
+    "fields": {
+        "cAICollections": "AI Collections"
+    },
+    "links": {
+        "cAICollections": "AI Collections"
+    }
+}
--- a/custom/Espo/Custom/Resources/i18n/en_US/CAIKnowledge.json
+++ b/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"
+    }
+}
--- a/custom/Espo/Custom/Resources/i18n/en_US/CAIKnowledgeCDokumente.json
+++ b/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"
+    }
+}
--- a/custom/Espo/Custom/Resources/i18n/en_US/CAIKnowledgeDokumente.json
+++ b/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"
+    }
+}
--- a/custom/Espo/Custom/Resources/i18n/en_US/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/en_US/CAdvowareAkten.json
@@ -0,0 +1,47 @@
+{
+    "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",
+        "dokumentes": "Dokumente"
+    },
+    "labels": {
+        "Create CAdvowareAkten": "Create Advoware Akten"
+    },
+    "options": {
+        "syncStatus": {
+            "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"
+    }
+}
--- a/custom/Espo/Custom/Resources/i18n/en_US/CAdvowareAktenCDokumente.json
+++ b/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)"
+    }
+}
--- a/custom/Espo/Custom/Resources/i18n/en_US/CDokumente.json
+++ b/custom/Espo/Custom/Resources/i18n/en_US/CDokumente.json
@@ -1,26 +1,25 @@
 {
    "fields": {
        "dokument": "Download",
-        "ydocumentuuid": "Y-Document-UUID",
        "preview": "Preview",
        "contactsvmhdokumente": "Portal Users",
        "vmhMietverhltnisesDokumente": "Tenancies",
        "vmhErstgespraechsdokumente": "Initial Consultations",
        "vmhRumungsklagesdokumente": "Eviction Lawsuits",
        "kuendigungDokumente": "Terminations",
-        "md5sum": "MD5 Checksum",
-        "sha256": "SHA256 Checksum",
+        "blake3hash": "Blake3 Hash",
        "beteiligte2dokumente": "Parties",
        "mietobjekt2dokumente": "Properties",
        "mietinkassosdokumente": "Rent Collection",
        "kndigungensdokumente": "Terminations",
-        "aktennr": "Advoware Identifier",
-        "advowareLastSync": "Advoware Last Sync",
-        "syncStatus": "Sync Status",
-        "xaiId": "x.AI ID",
-        "xaiCollections": "x.AI Collections",
-        "xaiSyncStatus": "Sync Status",
-        "fileStatus": "File Status"
+        "advowareAktens": "Advoware Akten",
+        "aIKnowledges": "AI Knowledge",
+        "advowareAktenHnr": "Advoware HNR",
+        "advowareAktenSyncstatus": "Advoware Sync Status",
+        "advowareAktenLastSync": "Advoware Last Sync",
+        "aiKnowledgeAiDocumentId": "AI Document ID",
+        "aiKnowledgeSyncstatus": "AI Sync Status",
+        "aiKnowledgeLastSync": "AI Last Sync"
    },
    "links": {
        "contactsvmhdokumente": "Portal Users",
@@ -31,41 +30,19 @@
        "beteiligte2dokumente": "Parties",
        "mietobjekt2dokumente": "Properties",
        "mietinkassosdokumente": "Rent Collection",
-        "kndigungensdokumente": "Terminations"
+        "kndigungensdokumente": "Terminations",
+        "advowareAktens": "Advoware Akten",
+        "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",
-        "advowareLastSync": "Time of last synchronization with Advoware",
-        "syncStatus": "Synchronization status: pending_sync = Waiting for sync, clean = successful, unclean = discrepancies, failed = error",
-        "xaiId": "Unique ID for x.AI synchronization",
-        "xaiCollections": "List of x.AI collections for this document",
-        "xaiSyncStatus": "x.AI synchronization status: pending_sync = Waiting for sync, clean = successfully synchronized, unclean = changes pending, failed = error, no_sync = Not synchronized",
-        "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": "Changes Pending",
-            "failed": "Failed",
-            "no_sync": "No Sync"
-        },
-        "fileStatus": {
-            "new": "New",
-            "changed": "Changed",
-            "unchanged": "Unchanged"
-        }
+        "blake3hash": "Cryptographic Blake3 hash of the file (faster and more secure than MD5/SHA256)"
    }
 }
--- a/custom/Espo/Custom/Resources/i18n/en_US/CKuendigung.json
+++ b/custom/Espo/Custom/Resources/i18n/en_US/CKuendigung.json
@@ -95,15 +95,17 @@
            "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",
--- a/custom/Espo/Custom/Resources/i18n/en_US/CMietinkasso.json
+++ b/custom/Espo/Custom/Resources/i18n/en_US/CMietinkasso.json
@@ -1,52 +1,42 @@
-{
-    "fields": {
-        "advowareAktenzeichen": "Advoware Case Number",
-        "aktennr": "Advoware Identifier",
-        "advowareLastSync": "Advoware Last Sync",
-        "syncStatus": "Sync Status",
-        "klaeger": "Plaintiff",
-        "beklagte": "Defendant",
-        "vmhMietverhltnises": "Tenancies",
-        "contactsMietinkasso": "Portal Users",
-        "dokumentesmietinkasso": "Documents",
-        "gerichtsrubrum": "Court Rubrum",
-        "gegenstandswert": "Claim Value",
-        "kuendigungsservice": "Termination Service",
-        "aussergerichtlicheGebuehren13": "Out-of-court Fees 1.3",
-        "gerichtskosten1Instanz": "Court Costs 1st Instance",
-        "anwaltskosten1Instanz": "Attorney Fees 1st Instance",
-        "freigeschalteteNutzer": "Activated Users (deprecated)",
-        "collaborators": "Collaborators",
-        "vmhVermietersMIK": "Landlord"
-    },
-    "links": {
-        "meetings": "Meetings",
-        "calls": "Calls",
-        "tasks": "Tasks",
-        "klaeger": "Plaintiff",
-        "beklagte": "Defendant",
-        "vmhMietverhltnises": "Tenancies",
-        "contactsMietinkasso": "Portal Users",
-        "dokumentesmietinkasso": "Documents",
-        "freigeschalteteNutzer": "Activated Users (deprecated)",
-        "collaborators": "Collaborators",
-        "vmhVermietersMIK": "Landlord",
-        "pulse": "Pulses"
-    },
-    "labels": {
-        "Create CMietinkasso": "Create Mietinkasso"
-    },
-    "tooltips": {
-        "advowareAktenzeichen": "Case number from Advoware system",
-        "aktennr": "Unique collection number from Advoware",
-        "advowareLastSync": "Time of last synchronization with Advoware",
-        "syncStatus": "Synchronization status: clean = successful, unclean = discrepancies, failed = error"
-    },
-    "options": {
-        "syncStatus": {
-            "clean": "Synchronized",
-            "unclean": "Discrepancies",
-            "failed": "Failed"
-        }
-    }
-}
+{
+    "fields": {
+        "klaeger": "Plaintiff",
+        "beklagte": "Defendant",
+        "vmhMietverhltnises": "Tenancies",
+        "contactsMietinkasso": "Portal Users",
+        "dokumentesmietinkasso": "Documents",
+        "gegenstandswert": "Claim Value",
+        "kuendigungsservice": "Termination Service",
+        "aussergerichtlicheGebuehren13": "Out-of-court Fees 1.3",
+        "gerichtskosten1Instanz": "Court Costs 1st Instance",
+        "anwaltskosten1Instanz": "Attorney Fees 1st Instance",
+        "freigeschalteteNutzer": "Activated Users (deprecated)",
+        "collaborators": "Collaborators",
+        "vmhVermietersMIK": "Landlord",
+        "advowareAkten": "Advoware Akten",
+        "aIKnowledge": "AI Knowledge"
+    },
+    "links": {
+        "meetings": "Meetings",
+        "calls": "Calls",
+        "tasks": "Tasks",
+        "klaeger": "Plaintiff",
+        "beklagte": "Defendant",
+        "vmhMietverhltnises": "Tenancies",
+        "contactsMietinkasso": "Portal Users",
+        "dokumentesmietinkasso": "Documents",
+        "freigeschalteteNutzer": "Activated Users (deprecated)",
+        "collaborators": "Collaborators",
+        "vmhVermietersMIK": "Landlord",
+        "pulse": "Pulses",
+        "advowareAkten": "Advoware Akten",
+        "aIKnowledge": "AI Knowledge"
+    },
+    "labels": {
+        "Create CMietinkasso": "Create Mietinkasso"
+    },
+    "tooltips": {
+        "gegenstandswert": "Value of the disputed matter",
+        "kuendigungsservice": "Termination service enabled"
+    }
+}
--- a/custom/Espo/Custom/Resources/i18n/en_US/CPulsTeamZuordnung.json
+++ b/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"
+        }
+    }
+}
--- a/custom/Espo/Custom/Resources/i18n/en_US/CVmhRumungsklage.json
+++ b/custom/Espo/Custom/Resources/i18n/en_US/CVmhRumungsklage.json
@@ -12,7 +12,9 @@
        "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",
@@ -26,9 +28,16 @@
        "beklagte": "Defendant",
        "klaeger": "Plaintiff",
        "contactsRumungsklage": "Portal Users",
-        "pulse": "Pulses"
+        "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"
    }
 }
--- a/custom/Espo/Custom/Resources/i18n/en_US/Global.json
+++ b/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"
    }
 }
--- a/custom/Espo/Custom/Resources/i18n/es_ES/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/es_ES/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Crear AI Knowledge"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/es_ES/CAdvowareAkten.json
+++ b/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"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/es_MX/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/es_MX/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Crear AI Knowledge"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/es_MX/CAdvowareAkten.json
+++ b/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"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/fa_IR/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/fa_IR/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "ایجاد AI Knowledge"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/fa_IR/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/fa_IR/CAdvowareAkten.json
@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "جلسات",
+    "calls": "تماس ها",
+    "tasks": "وظایف"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "ایجاد Advoware Akten"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/fr_FR/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/fr_FR/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Créer un AI Knowledge"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/fr_FR/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/fr_FR/CAdvowareAkten.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAdvowareAkten": "Créer un Advoware Akten"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/hr_HR/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/hr_HR/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Napravi AI Knowledge"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/hr_HR/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/hr_HR/CAdvowareAkten.json
@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "Sastanci",
+    "calls": "Pozivi",
+    "tasks": "Zadaci"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "Kreiraj Advoware Akten"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/hu_HU/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/hu_HU/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "{EntityTypeTranslated} létrehozása"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/hu_HU/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/hu_HU/CAdvowareAkten.json
@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "találkozók",
+    "calls": "felhívja",
+    "tasks": "Feladatok"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "{EntityTypeTranslated} létrehozása"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/id_ID/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/id_ID/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Buat AI Knowledge"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/id_ID/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/id_ID/CAdvowareAkten.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAdvowareAkten": "Buat Advoware Akten"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/it_IT/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/it_IT/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Crea AI Knowledge"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/it_IT/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/it_IT/CAdvowareAkten.json
@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "Riunioni",
+    "calls": "Chiamate",
+    "tasks": "Compiti"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "Crea Advoware Akten"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/ja_JP/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/ja_JP/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "AI Knowledge を作成する"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/ja_JP/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/ja_JP/CAdvowareAkten.json
@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "会議",
+    "calls": "通話",
+    "tasks": "タスク"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "Advoware Akten を作成する"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/lt_LT/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/lt_LT/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Sukurti AI Knowledge"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/lt_LT/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/lt_LT/CAdvowareAkten.json
@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "Susitikimai",
+    "calls": "Skambučiai",
+    "tasks": "Užduotys"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "Sukurti Advoware Akten"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/lv_LV/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/lv_LV/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Izveidot AI Knowledge"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/lv_LV/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/lv_LV/CAdvowareAkten.json
@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "Tikšanās",
+    "calls": "Zvani",
+    "tasks": "Uzdevumi"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "Izveidot Advoware Akten"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/nb_NO/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/nb_NO/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Opprett AI Knowledge"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/nb_NO/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/nb_NO/CAdvowareAkten.json
@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "Møter",
+    "calls": "Samtaler",
+    "tasks": "Oppgaver"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "Opprett Advoware Akten"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/nl_NL/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/nl_NL/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Creëer AI Knowledge"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/nl_NL/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/nl_NL/CAdvowareAkten.json
@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "Vergaderingen",
+    "calls": "Gesprekken",
+    "tasks": "Taken"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "Creëer Advoware Akten"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/pl_PL/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/pl_PL/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Utwórz AI Knowledge"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/pl_PL/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/pl_PL/CAdvowareAkten.json
@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "Spotkania",
+    "calls": "Połączenia",
+    "tasks": "Zadania"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "Utwórz Advoware Akten"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/pt_BR/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/pt_BR/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Criar AI Knowledge"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/pt_BR/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/pt_BR/CAdvowareAkten.json
@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "Reuniões",
+    "calls": "Ligações",
+    "tasks": "Tarefas"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "Criar Advoware Akten"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/pt_PT/CAIKnowledge.json
+++ b/custom/Espo/Custom/Resources/i18n/pt_PT/CAIKnowledge.json
@@ -0,0 +1,5 @@
+{
+  "labels": {
+    "Create CAIKnowledge": "Criar AI Knowledge"
+  }
+}
--- a/custom/Espo/Custom/Resources/i18n/pt_PT/CAdvowareAkten.json
+++ b/custom/Espo/Custom/Resources/i18n/pt_PT/CAdvowareAkten.json
@@ -0,0 +1,10 @@
+{
+  "links": {
+    "meetings": "Reuniões",
+    "calls": "Chamadas",
+    "tasks": "Tarefas"
+  },
+  "labels": {
+    "Create CAdvowareAkten": "Criar Advoware Akten"
+  }
+}
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
bsiggel	faffe3d874	Update EspoCRM Best Practices to version 2.4 with new features and implementation patterns for Custom API Endpoints; remove outdated TESTERGEBNISSE_JUNCTION_TABLE.md file.	2026-03-12 22:52:42 +01:00
bsiggel	bf0f596ad4	Update configuration and localization files for CAIKnowledgeCDokumente; add metadata and scopes	2026-03-12 22:40:38 +01:00
bsiggel	3ecc6275bc	Implement CAIKnowledge and CDokumente junction functionality; add API routes, metadata, and localization files	2026-03-12 22:39:33 +01:00
bsiggel	d0397e475e	Remove unused CAICollectionCDokumente localization, metadata, and service files; update CAIKnowledge layout and CAdvowareAkten scope type	2026-03-12 21:50:02 +01:00
bsiggel	51d9f7fa22	Refactor Blake3 hashing implementation in CDokumente; update localization and metadata files	2026-03-11 22:45:42 +01:00
bsiggel	80dc3b40d3	Implement Blake3 hashing in CDokumente; update related metadata and localization files	2026-03-11 22:20:21 +01:00
bsiggel	e15dd14cab	Add 'pending_sync' status to syncStatus in CAIKnowledge and CAdvowareAkten entities; update tooltips and API documentation	2026-03-11 22:05:27 +01:00
bsiggel	54d66da52d	Add 'syncedHash' field to CAIKnowledge and CAdvowareAkten entities; update API documentation and configuration timestamps	2026-03-11 21:53:35 +01:00
bsiggel	ae359048af	Add 'aktivierungsstatus' field to CAIKnowledge and CAdvowareAkten entities; update API documentation and configuration timestamps	2026-03-11 21:49:02 +01:00
bsiggel	c678660ad6	Add 'unsupported' status to dokumenteSyncstatus in CAIKnowledge and CAIKnowledgeCDokumente; update API documentation and configuration timestamps	2026-03-11 21:19:56 +01:00
bsiggel	c952fc40bc	Update configuration and state files; adjust microtime values and add CAIKnowledgeCDokumente junction entity with metadata and API documentation	2026-03-11 20:48:35 +01:00
bsiggel	b2c391539d	Update documentation for Junction Table UI-Integration and document propagation patterns; include new features and best practices for sync status management	2026-03-11 20:38:45 +01:00
bsiggel	e7b14406fb	Update detail layouts for CMietinkasso and CVmhRumungsklage to include AI Knowledge and Advoware Akten; update cache and microtime state in state.php	2026-03-11 20:09:13 +01:00
bsiggel	4707925917	Update timestamps in config and state files; add hooks for document relation propagation in CAIKnowledge, CAdvowareAkten, CMietinkasso, and CVmhRumungsklage	2026-03-11 20:07:34 +01:00
bsiggel	c2c9cfe709	Remove Advoware and x.AI related fields, tooltips, and options from CDokumente JSON files. Add UpdateJunctionSyncStatus hook to manage sync status for related entities on document updates. Update configuration timestamps in state and config files.	2026-03-11 19:55:29 +01:00
bsiggel	9411337939	Add sync status and last sync fields to CAIKnowledge and CAdvowareAkten entities, update layouts and metadata. Implement hooks for global sync status management.	2026-03-11 19:29:55 +01:00
bsiggel	986cafcfd6	Add new fields and layouts for AI Knowledge and Advoware Akten, update translations and metadata	2026-03-11 19:11:41 +01:00
bsiggel	c12577f4f8	Add AI Knowledge entity and related localization - Introduced CAIKnowledge entity with fields for name, description, and relationships to Mietinkasso and Räumungsklage. - Added localization files for CAIKnowledge in multiple languages including English, German, Spanish, and more. - Updated existing JSON files to include references to AI Knowledge where applicable. - Created necessary metadata definitions for client, entity, and record definitions for CAIKnowledge. - Enhanced existing documents and mietinkasso resources to support new AI Knowledge functionality.	2026-03-11 18:30:21 +01:00
bsiggel	f7b1adc015	Add CAdvowareAkten entity and related metadata - Introduced new entity CAdvowareAkten with fields: name, description, createdAt, modifiedAt, assignedUser, teams, vmhRumungsklage, mietinkasso, aktenzeichen, and aktennummer. - Defined relationships for CAdvowareAkten with existing entities: CVmhRumungsklage and CMietinkasso. - Created client definitions, layouts, and ACL for CAdvowareAkten. - Added internationalization support for CAdvowareAkten in multiple languages. - Updated existing entities and metadata to include references to CAdvowareAkten.	2026-03-11 18:21:20 +01:00
bsiggel	0f307c7eca	Remove CAICollection and CAdvowareAkten entities and their associated metadata, layouts, services, and translations. Update configuration and state files accordingly. Add side panel configuration for CMietinkasso.	2026-03-11 10:24:52 +01:00
bsiggel	9ab8f8b4bf	Add Mietinkasso and Räumungsklage fields to translations and metadata, update layouts and configuration	2026-03-11 10:15:02 +01:00
bsiggel	8438af8f97	Update translations and metadata for CVmhRumungsklage, and synchronize cache timestamps	2026-03-11 09:27:54 +01:00
bsiggel	76c38e8ad4	Refactor code structure for improved readability and maintainability	2026-03-11 09:21:52 +01:00
bsiggel	c2766ec66a	Update documentation for EspoCRM Best Practices and Validator Tool	2026-03-10 12:46:14 +01:00
bsiggel	9b18a63acf	Update configuration timestamps, add custom services, and implement validation and rebuild script for EspoCRM	2026-03-10 12:35:01 +01:00
bsiggel	641e5c0a91	Update cache timestamps and microtime values in configuration and state files	2026-03-10 12:24:35 +01:00
bsiggel	3470dba301	Add junction entities and ACL for CAICollection, CAdvowareAkten, and CPulsTeam - Introduced new junction entities: CAICollectionCDokumente, CAdvowareAktenCDokumente, and CPulsTeamZuordnung. - Implemented respective controllers and services for handling CRUD operations. - Added metadata definitions for new entities, including fields, links, and indexes. - Created language files for English and German translations for the new entities. - Developed a script to set ACL permissions for the new junction entities across existing roles. - Updated existing entity definitions to include new relationships and fields related to Advoware and AI Collections.	2026-03-10 00:10:57 +01:00
bsiggel	0340c59e5c	Add CAICollection and Advoware Akten entity and related resources	2026-03-09 23:57:48 +01:00
bsiggel	cd7c80af0f	Remove CPulsTeamZuordnung entity definitions, localization files, and update cache timestamps in configuration and state files.	2026-03-09 23:56:19 +01:00
bsiggel	1f32fbb89b	Remove CAICollectionCDokumente and CAICollections controllers, related metadata, and localization files. Update configuration and state files.	2026-03-09 23:55:42 +01:00
bsiggel	63e3841f86	Update documentation: Add Hook development section and Custom Entities overview	2026-03-09 23:12:30 +01:00
bsiggel	2e9db78c6e	Refactor code structure for improved readability and maintainability	2026-03-09 23:07:05 +01:00
bsiggel	3361cffb14	introducing junction table extension	2026-03-09 22:42:40 +01:00
bsiggel	47634c81ef	add CAICollections entity with metadata and localization support	2026-03-09 21:28:21 +01:00
bsiggel	53dd8f33d4	fix: Update fileStatus to 'synced' in CDokumente hooks and translations; adjust microtime and cacheTimestamp in config and state files	2026-03-08 21:56:00 +01:00
bsiggel	1b904eb15f	fix: Update synchronization status messages and add "no_sync" option; adjust microtime and cacheTimestamp in config and state files; add beforeSaveScripts for Advoware sync status management	2026-03-08 21:10:08 +01:00