Bewerken: Workflow Instructies

Sectie: Hash attribuut

Reden:

### Hash attribuut

Ultimo gebruikt een `Hash` attribuut op het `<Workflow>` element om de integriteit van de workflow te valideren bij import.

**Hash-algoritme (reverse engineered en geverifieerd):**

```
SHA1( UTF-8 bytes van de volledige XML, zonder BOM, zonder het Hash="..." attribuut )
```

Concreet:
1. Neem de volledige workflow XML
2. Verwijder het `Hash="..."` attribuut (inclusief de spatie ervoor)
3. Encodeer als UTF-8 (zonder BOM)
4. Bereken SHA1 → uppercase hex string

**Python implementatie:**

```python
import hashlib
import re

def compute_ultimo_hash(xml_text: str) -> str:
    """Bereken Ultimo workflow hash. Input: XML string zonder BOM."""
    no_hash = re.sub(r' Hash="[^"]*"', '', xml_text)
    return hashlib.sha1(no_hash.encode('utf-8')).hexdigest().upper()

def add_hash_to_workflow(xml_text: str) -> str:
    """Voeg Hash attribuut toe aan workflow XML. Normaliseert naar CRLF."""
    xml_text = xml_text.replace('\r\n', '\n').replace('\r', '\n').replace('\n', '\r\n')
    h = compute_ultimo_hash(xml_text)
    if 'Hash="' in xml_text:
        return re.sub(r'Hash="[^"]*"', f'Hash="{h}"', xml_text)
    else:
        return xml_text.replace('<Workflow ', f'<Workflow Hash="{h}" ', 1)
```

**Belangrijk:**
- Het `.wfl` bestand bevat een UTF-8 BOM (`EF BB BF`) — maar die BOM wordt **niet** meegenomen in de hash-berekening
- Het bestand gebruikt **CRLF** (`\r\n`) regeleindes en **tabs** voor indentatie — deze worden **wél** meegenomen in de hash
- Bij het genereren van workflows moet je CRLF regeleindes en tabs gebruiken om een correcte hash te krijgen