Datamodel¶

Entity-Relationship Diagram¶

erDiagram
    Package ||--o{ Package : "parent_package"
    Package ||--o{ Class : "bevat"
    Package ||--o{ Enumeratie : "bevat"
    Package ||--o{ Diagram : "bevat"

    Class ||--o{ Attribute : "heeft"
    Class ||--o{ Association : "src_class"
    Class ||--o{ Association : "dst_class"
    Class ||--o{ Generalization : "superclass"
    Class ||--o{ Generalization : "subclass"

    Enumeratie ||--o{ EnumerationLiteral : "heeft"
    Attribute |o--o| Enumeratie : "optioneel type"

    Diagram }o--o{ Class : "DiagramClass"
    Diagram }o--o{ Enumeratie : "DiagramEnumeration"
    Diagram }o--o{ Association : "DiagramAssociation"
    Diagram }o--o{ Generalization : "DiagramGeneralization"

    Package {
        string id PK
        string schema_id
        string name
        string parent_package_id FK
        string definitie
        string bron
        string toelichting
        string author
        string version
        string phase
        string status
        string uri
        string stereotype
        datetime created
        datetime modified
    }

    Class {
        string id PK
        string schema_id
        string name
        string package_id FK
        boolean is_datatype
        string definitie
        string bron
        string toelichting
        string author
        string version
        string phase
        string status
        string uri
        string stereotype
    }

    Attribute {
        string id PK
        string schema_id
        string name
        string clazz_id FK
        string primitive
        string enumeratie_id FK
        string definitie
        string bron
        string toelichting
    }

    Association {
        string id PK
        string schema_id
        string name
        string src_class_id FK
        string dst_class_id FK
        string src_mult_start
        string src_mult_end
        string dst_mult_start
        string dst_mult_end
        string src_role
        string dst_role
        string src_documentation
        string dst_documentation
    }

    Generalization {
        string id PK
        string schema_id
        string name
        string superclass_id FK
        string subclass_id FK
    }

    Enumeratie {
        string id PK
        string schema_id
        string name
        string package_id FK
        string definitie
        string bron
    }

    EnumerationLiteral {
        string id PK
        string schema_id
        string name
        string enumeratie_id FK
    }

    Diagram {
        string id PK
        string schema_id
        string name
        string package_id FK
    }

Modeldetail¶

Package¶

Container voor classes en enumerations. Packages vormen een hiërarchie via self-referencing parent_package_id.

Belangrijke methoden:

get_classes() — Alle classes in dit package
get_enumerations() — Alle enumeraties
is_model() — Is dit een top-level model package?
get_classes_in_model() — Alle classes recursief in de hiërarchie
get_copy() — Deep copy van het package en alle children

Class¶

UML Class entiteit met attributen en relaties.

Relaties:

package — Bovenliggend package
attributes — 1:N relatie met Attribute
uitgaande_associaties — Associaties waar deze class de bron is
inkomende_associaties — Associaties waar deze class het doel is
superclasses — Generalisaties als subclass
subclasses — Generalisaties als superclass

Belangrijke methoden:

get_attribute_by_name() — Zoek attribuut op naam
copy_attributes() — Kopieer attributen naar andere class
get_copy() — Deep copy inclusief attributen

Attribute¶

Property van een Class. Kan een primitief type (primitive als string) of een verwijzing naar een Enumeratie hebben.

Association¶

Bidirectionele relatie tussen twee Classes met multipliciteiten en rolnamen.

graph LR
    A["Class A<br/>(src)"] -->|"src_role<br/>src_mult"| R["Association"]
    R -->|"dst_role<br/>dst_mult"| B["Class B<br/>(dst)"]

Generalization¶

Inheritance-relatie tussen twee classes. Bevat een materialize() methode die attributen van de superclass naar de subclass kopieert.

Enumeratie & EnumerationLiteral¶

Enumeratietype met benoemde waarden. EnumerationLiteral bevat de individuele waarden.

Diagram¶

Visueel diagram dat via junction tables verwijst naar classes, enumeraties, associaties en generalisaties.

Mixin-structuur¶

Alle entiteiten delen velden via mixins:

Mixin	Velden	Gebruikt door
`UML_Generic`	id, schema_id, name, definitie, bron, toelichting, created, modified, stereotype	Alle entiteiten
`UMLBase`	author, version, phase, status, uri, visibility, alias	Package, Class, Attribute, etc.
`UMLTagsClazz`	MIM-tags, GEMMA-tags, history indicators	Class
`UMLTagsAttr`	Attribuut-specifieke tags	Attribute
`UMLTagsAssoc`	Associatie-specifieke tags	Association

Schema-isolatie: hetzelfde model meerdere keren inlezen¶

Een van de krachtigste features van crunch_uml is dat je hetzelfde model meerdere keren kunt inlezen in verschillende schema's binnen dezelfde database. Alle tabellen bevatten een schema_id kolom die deze isolatie mogelijk maakt.

Hoe werkt het?¶

Elk schema is als een apart "vakje" in de database. Wanneer je een model importeert of transformeert, geef je met -sch aan in welk schema de data terecht moet komen. Entiteiten in het ene schema zijn volledig gescheiden van entiteiten in het andere — ze leven naast elkaar in dezelfde database maar overlappen niet.

graph TB
    DB[("crunch_uml.db<br/>━━━━━━━━━━━━<br/>Eén fysieke database")]

    subgraph schema_default["Schema: default"]
        D1["Alle packages"]
        D2["Alle classes"]
        D3["Alle relaties"]
    end

    subgraph schema_v1["Schema: v1.0"]
        V1["Kernmodel v1"]
    end

    subgraph schema_v2["Schema: v2.0"]
        V2["Kernmodel v2"]
    end

    subgraph schema_en["Schema: vertaling_en"]
        EN["Engelse versie"]
    end

    DB --> schema_default & schema_v1 & schema_v2 & schema_en

    style DB fill:#1a5276,color:#fff
    style schema_default fill:#dae8fc,stroke:#6c8ebf
    style schema_v1 fill:#d5e8d4,stroke:#82b366
    style schema_v2 fill:#d5e8d4,stroke:#82b366
    style schema_en fill:#fff2cc,stroke:#d6b656

Typische toepassingen¶

Versievergelijking — Lees twee versies van hetzelfde model in (elk in een eigen schema) en gebruik de diff_md-renderer om automatisch de verschillen te rapporteren:

# Versie 2.0 in default schema (al geïmporteerd)
crunch_uml transform -ttp copy -sch_to versie_2 -rt_pkg ROOT

# Versie 1.0 in apart schema
crunch_uml -sch v1_raw import -f model_v1.xmi -t eaxmi
crunch_uml transform -ttp copy -sch_from v1_raw -sch_to versie_1 -rt_pkg ROOT

# Genereer diff
crunch_uml -sch versie_1 export -t diff_md -f diff.md \
    --compare_schema_name versie_2 --compare_title "v1 → v2"

Meertaligheid — Kopieer het model naar een vertaalschema en importeer vertalingen erbij:

crunch_uml transform -ttp copy -sch_to vertaling_en -rt_pkg ROOT
crunch_uml -sch vertaling_en import -f translations.json -t i18n --language en

Deelmodellen — Kopieer alleen een specifiek package (en alles eronder) naar een werkschema:

crunch_uml transform -ttp copy -sch_to deelmodel -rt_pkg EAPK_SUBPACKAGE_ID

Experimenteren — Kopieer naar een testschema, experimenteer met materialisatie van inheritance, en exporteer — zonder het origineel aan te raken:

crunch_uml transform -ttp copy -sch_to experiment -rt_pkg ROOT -m_gen True
crunch_uml -sch experiment export -t xlsx -f experiment.xlsx

Technische implementatie¶

De Schema-klasse in schema.py vormt de wrapper. Alle CRUD-operaties lopen via de Schema-klasse, die automatisch het schema_id filtert:

schema = Schema(database, "mijn_schema")
schema.get_all_classes()       # Alleen classes uit "mijn_schema"
schema.save(obj)               # Schrijft met schema_id = "mijn_schema"
schema.clean()                 # Verwijdert alles in "mijn_schema"

Omdat schema_id op elke tabel zit (packages, classes, attributes, associations, generalizations, enumerations, diagrams), is de isolatie volledig. Er is geen risico dat data uit het ene schema het andere beïnvloedt.