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.

- 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.

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

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

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

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

.vscode/settings.json

@@ -63,6 +63,22 @@
         "/^cd /var/lib/docker/volumes/vmh-espocrm_espocrm/_data/custom/scripts && python3 validate_and_rebuild\\.py 2>&1 \\| tail -120$/": {
             "approve": true,
             "matchCommandLine": true
+        },
+        "/^bash /var/lib/docker/volumes/vmh-espocrm_espocrm/_data/custom/scripts/ki-overview\\.sh$/": {
+            "approve": true,
+            "matchCommandLine": true
+        },
+        "/^python3 custom/scripts/validate_and_rebuild\\.py 2>&1 \\| tail -60$/": {
+            "approve": true,
+            "matchCommandLine": true
+        },
+        "/^bash custom/scripts/ki-overview\\.sh$/": {
+            "approve": true,
+            "matchCommandLine": true
+        },
+        "/^cd /var/lib/docker/volumes/vmh-espocrm_espocrm/_data/custom/scripts && bash ki-overview\\.sh$/": {
+            "approve": true,
+            "matchCommandLine": true
         }
     }
 }

README.md

@@ -670,6 +670,60 @@ Neue Felder in einer Entity erfordern Änderungen in **drei Bereichen**:
 - `detailSmall.json` - Seitenleisten-Ansicht
 - `filters.json` - Filter-Felder
 
+---
+
+### ⚠️ WICHTIG: Zwei verschiedene Layout-Verzeichnisse!
+
+**EspoCRM verwendet zwei verschiedene Layout-Verzeichnisse mit unterschiedlichen Zwecken:**
+
+#### 1. **Frontend-Layouts** (PRIMÄR - meistens benötigt)
+**Pfad:** `custom/Espo/Custom/Resources/layouts/{Entity}/{LayoutType}.json`
+
+✅ **Verwenden für:**
+- Liste-Ansichten: `list.json`, `listSmall.json`
+- Detail-Ansichten: `detail.json`, `detailSmall.json`
+- Bottom-Panels: `bottomPanelsDetail.json`
+- Relationship-Panels (werden über `listSmall.json` definiert)
+- Alle UI-bezogenen Layouts
+
+**Beispiel:**
+```
+custom/Espo/Custom/Resources/layouts/
+├── CBeteiligte/
+│   ├── list.json
+│   ├── listSmall.json         ← Wird in Relationship-Panels verwendet!
+│   ├── detail.json
+│   └── bottomPanelsDetail.json
+```
+
+#### 2. **Metadata-Layouts** (SEKUNDÄR - selten benötigt)
+**Pfad:** `custom/Espo/Custom/Resources/metadata/layouts/{Entity}/{LayoutType}.json`
+
+⚠️ **Nur verwenden für:**
+- Backend-spezifische Layout-Definitionen
+- Erweiterte Konfigurationen
+- In den meisten Fällen NICHT benötigt!
+
+**Regel:**
+> **Relationship-Panels in Bottom-Views nutzen IMMER `listSmall.json` aus dem `layouts/` Verzeichnis (NICHT `metadata/layouts/`)!**
+
+**Häufiger Fehler:**
+```bash
+# ❌ FALSCH - wird ignoriert!
+custom/Espo/Custom/Resources/metadata/layouts/CBeteiligte/listSmall.json
+
+# ✅ RICHTIG - wird verwendet!
+custom/Espo/Custom/Resources/layouts/CBeteiligte/listSmall.json
+```
+
+**Best Practice:**
+- Layouts IMMER in `custom/Espo/Custom/Resources/layouts/` erstellen
+- Das `metadata/layouts/` Verzeichnis nur verwenden, wenn explizit dokumentiert
+- Nach Änderungen: `./custom/scripts/check_and_rebuild.sh`
+- Browser Hard Refresh (Ctrl+Shift+R) durchführen
+
+---
+
 ### clientDefs/{EntityType}.json
 
 **Format-Beispiel:**

application/Espo/Binding.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/ActionHistoryRecord/OwnershipChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/Attachment/AccessChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/Attachment/OwnershipChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/AuthToken/AccessChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/CurrencyRecordRate/AccessChecker.php

@@ -0,0 +1,79 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * The interactive user interfaces in modified source and object code versions
+ * of this program must display Appropriate Legal Notices, as required under
+ * Section 5 of the GNU Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace Espo\Classes\Acl\CurrencyRecordRate;
+
+use Espo\Core\Acl\AccessEntityCREDChecker;
+use Espo\Core\Acl\DefaultAccessChecker;
+use Espo\Core\Acl\ScopeData;
+use Espo\Core\Acl\Table;
+use Espo\Core\Acl\Traits\DefaultAccessCheckerDependency;
+use Espo\Entities\CurrencyRecordRate;
+use Espo\Entities\User;
+use Espo\ORM\Entity;
+
+/**
+ * @implements AccessEntityCREDChecker<CurrencyRecordRate>
+ */
+class AccessChecker implements AccessEntityCREDChecker
+{
+    use DefaultAccessCheckerDependency;
+
+    public function __construct(
+        private DefaultAccessChecker $defaultAccessChecker,
+    ) {}
+
+    public function checkCreate(User $user, ScopeData $data): bool
+    {
+        if ($data->getEdit() === Table::LEVEL_YES) {
+            return true;
+        }
+
+        return false;
+    }
+
+    public function checkDelete(User $user, ScopeData $data): bool
+    {
+        if ($data->getEdit() === Table::LEVEL_YES) {
+            return true;
+        }
+
+        return false;
+    }
+
+    public function checkEntityCreate(User $user, Entity $entity, ScopeData $data): bool
+    {
+        return $this->checkCreate($user, $data);
+    }
+
+    public function checkEntityDelete(User $user, Entity $entity, ScopeData $data): bool
+    {
+        return $this->checkDelete($user, $data);
+    }
+}

application/Espo/Classes/Acl/Email/AccessChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/Email/AssignmentChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/Email/LinkCheckers/ParentLinkChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/Email/LinkCheckers/TeamsLinkChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/Email/OwnershipChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/EmailFilter/OwnershipChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/Import/AccessChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/ImportEml/AccessChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/Note/AccessChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/Note/OwnershipChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/Notification/OwnershipChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/Portal/AccessChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/ScheduledJob/AccessChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/Team/OwnershipChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/User/AccessChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/User/OwnershipChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/Webhook/AccessChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/Webhook/OwnershipChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Acl/WorkingTimeRange/AssignmentChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AclPortal/Attachment/AccessChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AclPortal/Attachment/OwnershipChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AclPortal/Email/AccessChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AclPortal/Email/OwnershipChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AclPortal/Note/AccessChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AclPortal/Note/OwnershipChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AclPortal/Notification/OwnershipChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AclPortal/User/OwnershipChecker.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AddressFormatters/Formatter1.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AddressFormatters/Formatter2.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AddressFormatters/Formatter3.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AddressFormatters/Formatter4.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AppInfo/Binding.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AppInfo/Container.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AppInfo/Jobs.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AppParams/AddressCountryData.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AppParams/CurrencyRates.php

@@ -0,0 +1,59 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * The interactive user interfaces in modified source and object code versions
+ * of this program must display Appropriate Legal Notices, as required under
+ * Section 5 of the GNU Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace Espo\Classes\AppParams;
+
+use Espo\Core\Currency\ConfigDataProvider;
+use Espo\Core\Utils\NumberUtil;
+use Espo\Tools\App\AppParam;
+use stdClass;
+
+/**
+ * @noinspection PhpUnused
+ */
+class CurrencyRates implements AppParam
+{
+    private const int PRECISION = 6;
+
+    public function __construct(
+        private ConfigDataProvider $configDataProvider,
+        private NumberUtil $numberUtil,
+    ) {}
+
+    public function get(): stdClass
+    {
+        $rates = $this->configDataProvider->getCurrencyRates()->toAssoc();
+
+        foreach ($rates as $code => $value) {
+            $rates[$code] = $this->numberUtil->format($value, self::PRECISION, '.', '');
+        }
+
+        return (object) $rates;
+    }
+}

application/Espo/Classes/AppParams/Extensions.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AppParams/TemplateEntityTypeList.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/AssignmentNotificators/Email.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Cleanup/AppLog.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Cleanup/Audit.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Cleanup/Exports.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Cleanup/MassActions.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Cleanup/PasswordChangeRequests.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Cleanup/Reminders.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Cleanup/Stars.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Cleanup/Subscribers.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Cleanup/TwoFactorCodes.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/Cleanup/WebhookQueue.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/ConsoleCommands/CheckFilePermissions.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/ConsoleCommands/CreateAdminUser.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/ConsoleCommands/Import.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/ConsoleCommands/PopulateArrayValues.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/ConsoleCommands/PopulateNumbers.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify
@@ -35,7 +35,7 @@ use Espo\Core\Console\Exceptions\ArgumentNotSpecified;
 use Espo\Core\Console\Exceptions\InvalidArgument;
 use Espo\Core\Console\IO;
 use Espo\Core\Exceptions\Error;
-use Espo\Core\FieldProcessing\NextNumber\BeforeSaveProcessor;
+use Espo\Core\FieldProcessing\NextNumber\Processor;
 use Espo\Core\Name\Field;
 use Espo\Core\ORM\Entity as CoreEntity;
 use Espo\Core\ORM\Repository\Option\SaveOption;
@@ -44,11 +44,11 @@ use Espo\ORM\Query\Part\Order;
 
 class PopulateNumbers implements Command
 {
-    private BeforeSaveProcessor $beforeSaveProcessor;
+    private Processor $beforeSaveProcessor;
     private EntityManager $entityManager;
 
     public function __construct(
-        BeforeSaveProcessor $beforeSaveProcessor,
+        Processor $beforeSaveProcessor,
         EntityManager $entityManager
     ) {
         $this->beforeSaveProcessor = $beforeSaveProcessor;

application/Espo/Classes/ConsoleCommands/RebuildCategoryPaths.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/DefaultLayouts/DefaultSidePanelType.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/DuplicateWhereBuilders/Company.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/DuplicateWhereBuilders/General.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/DuplicateWhereBuilders/Name.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/DuplicateWhereBuilders/Person.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldConverters/RelationshipRole.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldDuplicators/AttachmentMultiple.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldDuplicators/File.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldDuplicators/LinkMultiple.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldDuplicators/Wysiwyg.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldProcessing/CurrencyRecord/IsBase.php

@@ -0,0 +1,63 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * The interactive user interfaces in modified source and object code versions
+ * of this program must display Appropriate Legal Notices, as required under
+ * Section 5 of the GNU Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace Espo\Classes\FieldProcessing\CurrencyRecord;
+
+use Espo\Core\Currency\ConfigDataProvider;
+use Espo\Core\FieldProcessing\Loader;
+use Espo\Core\FieldProcessing\Loader\Params;
+use Espo\Entities\CurrencyRecord;
+use Espo\ORM\Entity;
+use ValueError;
+
+/**
+ * @implements Loader<CurrencyRecord>
+ */
+class IsBase implements Loader
+{
+    public function __construct(
+        private ConfigDataProvider $configDataProvider,
+    ) {}
+
+
+    public function process(Entity $entity, Params $params): void
+    {
+        try {
+            $code = $entity->getCode();
+        } catch (ValueError) {
+            $entity->setIsBase(false);
+
+            return;
+        }
+
+        $isBase = $code === $this->configDataProvider->getBaseCurrency();
+
+        $entity->setIsBase($isBase);
+    }
+}

application/Espo/Classes/FieldProcessing/CurrencyRecord/Label.php

@@ -0,0 +1,60 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * The interactive user interfaces in modified source and object code versions
+ * of this program must display Appropriate Legal Notices, as required under
+ * Section 5 of the GNU Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace Espo\Classes\FieldProcessing\CurrencyRecord;
+
+use Espo\Core\FieldProcessing\Loader;
+use Espo\Core\FieldProcessing\Loader\Params;
+use Espo\Core\Utils\Language;
+use Espo\Entities\CurrencyRecord;
+use Espo\ORM\Entity;
+use ValueError;
+
+/**
+ * @implements Loader<CurrencyRecord>
+ */
+class Label implements Loader
+{
+    public function __construct(
+        private Language $defaultLanguage
+    ) {}
+
+    public function process(Entity $entity, Params $params): void
+    {
+        try {
+            $code = $entity->getCode();
+        } catch (ValueError) {
+            return;
+        }
+
+        $name = $this->defaultLanguage->translateLabel($code, 'names', 'Currency');
+
+        $entity->setLabel($name);
+    }
+}

application/Espo/Classes/FieldProcessing/CurrencyRecord/Rate.php

@@ -0,0 +1,57 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * The interactive user interfaces in modified source and object code versions
+ * of this program must display Appropriate Legal Notices, as required under
+ * Section 5 of the GNU Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace Espo\Classes\FieldProcessing\CurrencyRecord;
+
+use Espo\Core\Currency\ConfigDataProvider;
+use Espo\Core\FieldProcessing\Loader;
+use Espo\Core\FieldProcessing\Loader\Params;
+use Espo\Entities\CurrencyRecord;
+use Espo\ORM\Entity;
+use Espo\Tools\Currency\RateEntryProvider;
+
+/**
+ * @implements Loader<CurrencyRecord>
+ */
+class Rate implements Loader
+{
+    public function __construct(
+        private RateEntryProvider $rateEntryProvider,
+        private ConfigDataProvider $configDataProvider,
+    ) {}
+
+    public function process(Entity $entity, Params $params): void
+    {
+        $rate = $entity->getCode() !== $this->configDataProvider->getBaseCurrency() ?
+            $this->rateEntryProvider->getCurrentRateEntry($entity)?->getRate() :
+            '1';
+
+        $entity->setRate($rate);
+    }
+}

application/Espo/Classes/FieldProcessing/CurrencyRecord/RateDate.php

@@ -0,0 +1,57 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * The interactive user interfaces in modified source and object code versions
+ * of this program must display Appropriate Legal Notices, as required under
+ * Section 5 of the GNU Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace Espo\Classes\FieldProcessing\CurrencyRecord;
+
+use Espo\Core\Currency\ConfigDataProvider;
+use Espo\Core\FieldProcessing\Loader;
+use Espo\Core\FieldProcessing\Loader\Params;
+use Espo\Entities\CurrencyRecord;
+use Espo\ORM\Entity;
+use Espo\Tools\Currency\RateEntryProvider;
+
+/**
+ * @implements Loader<CurrencyRecord>
+ */
+class RateDate implements Loader
+{
+    public function __construct(
+        private RateEntryProvider $rateEntryProvider,
+        private ConfigDataProvider $configDataProvider,
+    ) {}
+
+    public function process(Entity $entity, Params $params): void
+    {
+        $date = $entity->getCode() !== $this->configDataProvider->getBaseCurrency() ?
+            $this->rateEntryProvider->getCurrentRateEntry($entity)?->getDate() :
+            null;
+
+        $entity->setRateDate($date);
+    }
+}

application/Espo/Classes/FieldProcessing/CurrencyRecord/Symbol.php

@@ -0,0 +1,59 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * The interactive user interfaces in modified source and object code versions
+ * of this program must display Appropriate Legal Notices, as required under
+ * Section 5 of the GNU Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace Espo\Classes\FieldProcessing\CurrencyRecord;
+
+use Espo\Core\FieldProcessing\Loader;
+use Espo\Core\FieldProcessing\Loader\Params;
+use Espo\Core\Utils\Metadata;
+use Espo\Entities\CurrencyRecord;
+use Espo\ORM\Entity;
+use ValueError;
+
+/**
+ * @implements Loader<CurrencyRecord>
+ */
+class Symbol implements Loader
+{
+    public function __construct(
+        private Metadata $metadata,
+    ) {}
+
+    public function process(Entity $entity, Params $params): void
+    {
+        try {
+            $code = $entity->getCode();
+        } catch (ValueError) {
+            return;
+        }
+        $symbol = $this->metadata->get("app.currency.symbolMap.$code");
+
+        $entity->setSymbol($symbol);
+    }
+}

application/Espo/Classes/FieldProcessing/Email/AddressDataLoader.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldProcessing/Email/AddressLoader.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldProcessing/Email/FolderDataLoader.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldProcessing/Email/IcsDataLoader.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldProcessing/Email/StringDataLoader.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldProcessing/Email/UserColumnsLoader.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldProcessing/Import/CountsLoader.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldProcessing/InboundEmail/IsSystemLoader.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldProcessing/LeadCapture/ExampleLoader.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldProcessing/Note/AdditionalFieldsLoader.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldProcessing/OAuthAccount/DataLoader.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldProcessing/OAuthProvider/AuthorizationRedirectUriLoader.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldProcessing/Portal/UrlLoader.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldProcessing/User/LastAccessLoader.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldSanitizers/ArrayFromNull.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldSanitizers/ArrayStringTrim.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldSanitizers/Date.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldSanitizers/Datetime.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldSanitizers/DatetimeOptionalDate.php

@@ -3,7 +3,7 @@
  * This file is part of EspoCRM.
  *
  * EspoCRM – Open Source CRM application.
- * Copyright (C) 2014-2025 EspoCRM, Inc.
+ * Copyright (C) 2014-2026 EspoCRM, Inc.
  * Website: https://www.espocrm.com
  *
  * This program is free software: you can redistribute it and/or modify

application/Espo/Classes/FieldSanitizers/Decimal.php

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