mxrb 0.1.0

data/docs/README.md

@@ -0,0 +1,10 @@
+# MXRB documentation
+
+Choose a language:
+
+- [Português (Brasil)](pt-BR/README.md)
+- [English (United States)](en-US/README.md)
+- [Deutsch (Deutschland)](de-DE/README.md)
+
+All language trees contain the same document set. Ruby APIs, CLI commands,
+Mendix identifiers and validation numbers are kept unchanged.

data/docs/de-DE/README.md

@@ -0,0 +1,24 @@
+# MXRB-Dokumentation
+
+[Português](../pt-BR/README.md) · [English](../en-US/README.md) · **Deutsch**
+
+- [Projektarchitektur](architecture.md)
+- [Architekturstandard](architectural-standard.md)
+- [Struktur des exportierten Projekts](project-structure.md)
+- [Architekturmuster](architectural-patterns.md)
+- [Semantisches Refactoring](semantic-refactoring.md)
+- [Navigation und Design System](design-system.md)
+- [OQL, SQL-Ansicht und lokale Datenbank](oql-sql.md)
+- [Konventionen](conventions.md)
+- [Ruby-First-Roadmap](ruby-first-roadmap.md)
+- [Validierungsmatrix](validation-matrix.md)
+- [Nativer Compiler und Runtime](compiler.md)
+- [Qualitätsbericht für Build und Runtime](native-runtime-quality-report.md)
+- [Projekte erstellen und bearbeiten](writing.md)
+- [Projekt-Scaffolds](scaffolds.md)
+- [Entitäten-DSL](entity-dsl.md)
+- [Betrieb, Lifecycle und Marketplace](platform-operations.md)
+- [Bewertung der Mendix-API-Integration](platform-api-integration.md)
+- [VetClinic-End-to-End-Abnahme](vetclinic-acceptance.md)
+
+[Zurück zur Projekt-README](../../README.de-DE.md)

data/docs/de-DE/architectural-patterns.md

@@ -0,0 +1,26 @@
+# Architekturmuster
+
+[Português](../pt-BR/architectural-patterns.md) · [English](../en-US/architectural-patterns.md) · **Deutsch**
+
+MXRB verwendet Ruby als einzige öffentliche Modellschnittstelle und ordnet
+Verantwortungen Domäne, Anwendung, Präsentation und Infrastruktur zu.
+
+```text
+Präsentation ─┐
+              ├─> Anwendung ─> Domäne
+Infrastruktur ┘
+```
+
+Entitäten und Regeln halten Geschäftszustand. Microflows sind Anwendungsfälle,
+wenn sie diesen Zustand koordinieren. Seiten, Navigation und Nanoflows gehören
+zur Präsentation; HTTP, externe Datenbanken, Java und Integrationen zur
+Infrastruktur.
+
+Repositories sind an echten externen Grenzen sinnvoll, nicht als Zeremonie um
+gewöhnliches Mendix-CRUD. Aufrufe und Abhängigkeiten bleiben im semantischen
+Graph sichtbar und können am tatsächlichen Modell geprüft werden.
+
+Security, Navigation und Design System sind Querschnittsrichtlinien unter
+`app/`. Deklarierte Navigation wird zusätzlich nativ in Mendix geschrieben.
+
+[Zurück zum Index](README.md)

data/docs/de-DE/architectural-standard.md

@@ -0,0 +1,48 @@
+# MXRB-Architekturstandard
+
+[Português](../pt-BR/architectural-standard.md) · [English](../en-US/architectural-standard.md) · **Deutsch**
+
+## Zentrales Prinzip
+
+Ruby ist die kanonische Architekturdarstellung. Mendix bleibt Laufzeit und
+natives Modell. Ein Microflow wird nach seiner Verantwortung klassifiziert,
+nicht allein danach, dass er ein Microflow ist.
+
+## Schichten
+
+- `domain`: Entitäten, Beziehungen, Invarianten und Domain Events.
+- `application`: Use Cases, Abfragen, Validierungen und Jobs.
+- `presentation`: Seiten, UI-Einstiegspunkte und Nanoflows.
+- `infrastructure`: Integrationen, Services und technische Adapter.
+
+Abhängigkeiten zeigen nach innen. Modulübergreifender Zugriff erfolgt über
+bewusst veröffentlichte APIs.
+
+## Persistenz und Repositories
+
+Direkter Mendix-Retrieve ist für normales CRUD korrekt. Ein Repository ist nur
+für eine echte Grenze sinnvoll, etwa externen Speicher, komplexe
+Abfrageverträge oder Testisolation.
+
+## Security, Navigation und Designsystem
+
+App Security besitzt User Roles und globale Regeln; Module Security besitzt
+Module Roles. Seiten und Flows deklarieren `allowed_roles`. Navigation ist
+appweit. Semantische Ruby-Tokens beschreiben Designabsichten, während native
+Mendix-Ressourcen erhalten bleiben.
+
+## Qualitätsregeln
+
+MXRB prüft fehlende Referenzen, Zyklen, verbotene Abhängigkeiten,
+Zugriffsgrenzen, Benennung und projektspezifische Ruby-Regeln. `mx check` und
+MxBuild bleiben die offiziellen Plattform-Gates.
+
+## Supportgrenze
+
+Domain-, Microflow-, Nanoflow-, Seiten-, Menü-, Security- und native
+Navigationsflächen sind typisiert bearbeitbar. Theme- und Code-Assets
+verwenden ein Manifest mit Prüfsummen; Designsystem-Tokens und -Richtlinien
+besitzen einen typisierten Ruby-Vertrag. Workflows, Integrationen,
+veröffentlichte APIs und Widgets ohne kompakte API bleiben über tiefes Ruby
+und das native Baseline bearbeitbar, benötigen aber noch spezifische
+typisierte DSLs.

data/docs/de-DE/architecture.md

@@ -0,0 +1,76 @@
+# Mendix-Projektarchitektur in MXRB
+
+[Português](../pt-BR/architecture.md) · [English](../en-US/architecture.md) · **Deutsch**
+
+MXRB bildet Mendix-Projekte als bearbeitbares Ruby ab und bewahrt gleichzeitig
+das native Modell für sichere Roundtrips. Ruby ist die einzige öffentliche
+Sprache; es gibt keine parallele MDL-ähnliche Syntax.
+
+## Kompatibilitätsprinzipien
+
+- Qualifizierte Mendix-Namen bleiben kanonisch.
+- Native Units ohne typisierte Ruby-Abstraktion bleiben verlustfrei erhalten.
+- Typisierte Änderungen ersetzen nur ausdrücklich deklarierte Strukturen.
+- MPR v1 bleibt in SQLite, MPR v2 in `mprcontents/`.
+- `mx`, MxBuild und Runtime sind externe Gates, keine Kern-APIs.
+
+## Kanonische Struktur
+
+```text
+project.rb
+app/{security,navigation}
+modules/Sales/
+  domain/
+  application/
+  presentation/
+  infrastructure/
+  security/
+```
+
+`domain` enthält Entitäten und Regeln. `application` enthält Use Cases,
+Abfragen und Jobs. `presentation` enthält Seiten und clientseitige Nanoflows.
+`infrastructure` enthält Integrationen, Dienste und Adapter.
+
+Die Kardinalität folgt dem Mendix-Modell aus Typ und Eigentümer:
+
+```ruby
+# 1:N (Standard): Reference + Default
+association "Sales.Customer", name: "Order_Customer"
+
+# 1:1: Reference + Both
+association "Sales.Profile", name: "Customer_Profile", owner: :Both
+
+# N:N: ReferenceSet + Default
+association "Sales.Tag", name: "Order_Tags", type: :ReferenceSet
+```
+
+## Abhängigkeitsregel
+
+```text
+presentation ─┐
+              ├─> application ─> domain
+infrastructure┘
+```
+
+Der semantische Graph prüft fehlende Ziele, Zyklen, Modulgrenzen und verbotene
+Abhängigkeiten.
+
+## Ruby → Mendix
+
+Definitionen werden ausgewertet, native Units zuerst wiederhergestellt und
+typisierte Overlays über stabile Namen zusammengeführt. Danach aktualisiert
+MXRB Hashes und v1/v2-Speicher. `mxrb validate`, `mx check` und MxBuild bilden
+aufeinanderfolgende Gates.
+
+## Mendix → Ruby
+
+MXRB indexiert alle Units, exportiert typisierte Artefakte und schreibt nicht
+typisierte Units nach `.mxrb/native_units.json`. Fingerprints erlauben die
+exakte Wiederverwendung unveränderter Flow- und Seitenstrukturen.
+
+## Namenskonventionen und Wahrheit
+
+Mendix-Namen bleiben exakt; Ruby-Dateien verwenden `snake_case`. Ruby ist für
+deklarierte typisierte Strukturen maßgeblich, das native Manifest für den
+bewahrten Rest. Eine tiefe Ruby-Änderung invalidiert den Fingerprint und wird
+neu generiert.

data/docs/de-DE/compiler.md

@@ -0,0 +1,162 @@
+# Nativer Compiler, Runtime und MDA-Format
+
+Die funktionale MXRB-Pipeline führt weder `mx`, `mxbuild`, `mxcli`, Studio Pro
+noch das Model SDK aus. Diese Werkzeuge können externe Kompatibilitätsprüfungen
+bleiben, sind aber keine Build-, Datenbank- oder Funktionstest-Abhängigkeiten.
+
+## Build von null
+
+`DeploymentMaterializer` erzeugt ein fehlendes `deployment/` aus den Templates
+der installierten Version und durchläuft 12 Stufen: Sicherheit, Konstanten,
+Domänenmodell, Artefakte, Übersetzungen, Systemtexte, Systemwarteschlangen,
+Clientmodell, Actions, Settings, Microflows und Projekt-/Modulindex. Metadaten,
+Abhängigkeiten und ein Runtime-kompatibel geordnetes BSON-`model.mdp` werden
+ebenfalls erzeugt.
+
+Der Bootstrap besitzt auditierte Seeds und Kataloge für 6.10.8, 7.5.0,
+7.17.0, 9.6.1.29396, 10.24.0.73019 und 11.12.1. Die Familien 6.x, 7.x, 9.x, 10.x und 11.x wählen
+einen kompatiblen Compiler-Seed; 5.x und 8.x schlagen ohne auditierten
+Seed geschlossen fehl. Die Familie gilt nur für das Compiler-Schema. Die
+Runtime muss exakt zum Patch des MPR passen.
+
+`ProjectJarBuilder` findet das JDK über `MXRB_JAVA_HOME`, `JAVA_HOME`, asdf oder
+mise, kompiliert `javasource/**/*.java` gegen Runtime- und Projektbibliotheken
+und schreibt ein deterministisches OSGi-`project.jar`. Für VetClinic wurden 183
+Quelldateien zu 249 Klassen kompiliert.
+
+`WebBundleBuilder` wählt Dojo für 6/7, Dojo mit React-Wrapper für 9, den im
+Projekt gewählten klassischen oder optimierten Client für 10 und React für 11.
+Der React-Pfad erzeugt Entry-/Seitenmodule, entpackt `.mpk` und ruft direkt
+Node/Rollup für 10 oder Node/Rspack für 11 auf. Data Grid 2 wird für den Teilumfang aus XPath-Datenquelle
+und Attributspalten kompiliert, einschließlich `operations.json`, Datenquelle
+und Attributtypen. Noch nicht übersetzte Typen oder Eigenschaftskombinationen
+erhalten einen DOM-Fallback in `web/mxrb-pages.json`; das VetClinic-Manifest ist
+leer.
+
+Der React-Compiler materialisiert außerdem Container, Texte und Überschriften,
+responsive Grids/Spalten sowie Buttons zum Öffnen und Erzeugen. Der Bootstrap
+bindet `theme.compiled.css`, das Manifest und Assets aus
+`themesource/*/public` ein; eine Homepage mit `LayoutGrid` bleibt nicht leer.
+Ruby-Inhalte lassen sich so ergänzen:
+
+Parametergestützte `DataView`-Formulare rendern nun editierbare `TextBox`-Felder
+sowie Save/Cancel-Aktionen. Create übergibt die GUID des neuen Objekts über
+`openForm2`; Commit-/Rollback-Operationen werden mit den Projektbenutzerrollen
+registriert, die aus den erlaubten Modulrollen der Seite abgeleitet werden.
+Damit bleibt die Runtime-Autorisierung erhalten und wird nicht umgangen.
+
+Layouts, Platzhalter, Scrollbereiche, Sidebars, Header, Navigationsmenüs,
+Snippets, DataViews, ListViews, Formularelemente, Bilder, Combo Boxes, Gallery,
+Data Grid 2 und schemagestützte Pluggable Widgets werden über die nativen
+React-Client-Verträge kompiliert. Seiten-, Menü- und Widget-Aktionen decken
+Navigation, Microflows, Nanoflows, Objektlebenszyklus, Links und Sign-out ab.
+Nanoflow-Programme unterstützen außerdem Entscheidungen, Fehlerbehandlung,
+JavaScript-Aktionen und serverseitige Microflow-/Commit-
+Operationen, sofern der Modellvertrag sicher abgebildet werden kann.
+
+Der React-Pfad kompiliert außerdem die offizielle Gallery mit XPath- und
+Microflow-Listenquellen, Template-Inhalten, Auswahl und formatierten dynamischen
+Attributen. Nanoflow-Quellen und -Aktionen verwenden die Mendix-Verträge
+`NanoflowObjectListProperty`, `NanoflowObjectProperty` und `ActionProperty`.
+MXRB erzeugt echte Clientprogramme `{ name, instructions }` für auditierten
+Graph-Kontrollfluss, Returns, Variablen, Objekte, Nanoflow-/Microflow-Aufrufe,
+JavaScript-, Seiten-, Nachrichten-, Validierungs- und Commit-Aktionen. Fehlende
+Flows, unsichere Parameterabbildungen und nicht übersetzte Clientinstruktionen
+schlagen geschlossen fehl und bleiben Befunde im Support-Manifest.
+
+In lokalen Runtime-Sitzungen im Developer-Modus versioniert mxrb außerdem
+dynamische Seitenimporte, versieht den korrigierten React-Client-Chunk mit
+einem Inhalts-Hash und gibt dem Rspack-Selbstimport dasselbe Cache-Token wie
+dem Entry-Point. Dadurch können langlebige statische Mendix-Antworten nach
+einem nativen Rebuild keine veraltete leere Seite wiederherstellen. Die erzeugte
+Shell stellt außerdem einen begrenzten `openForm`-Adapter über `openForm2`
+bereit; alte Handler im Cache navigieren damit, statt still ohne Request zu enden.
+
+```ruby
+Mxrb.define("App.mpr") do
+  mendix_version "11.12.1"
+  self.module(:App) do
+    layout :Shell
+    page(:Home) do
+      layout "App.Shell"
+      title "Meine Anwendung"
+      container(:main, class_name: "container") do
+        text :welcome, caption: "Mit mxrb erzeugter Inhalt"
+      end
+    end
+  end
+end
+```
+
+Bestehende Projekte können exportiert, in der DSL geändert und neu erzeugt
+werden. Nicht unterstützte Widgets bleiben im Support-Manifest sichtbar.
+
+Vor einem nativen Build kann das gesamte MPR mit dem für seine Mendix-Version
+gewählten Renderer geprüft werden:
+
+```bash
+mxrb preflight App.mpr
+mxrb preflight App.mpr --json
+```
+
+Der Nur-Lese-Befehl liefert bei nicht unterstützten Versionen oder
+Client-Features einen Fehlerstatus. Mendix 11 wird über den React-Compiler
+geprüft; 6/7/9 verwenden dieselbe Legacy-Dojo-Prüfung wie `WebBundleBuilder`.
+
+Der Dojo-Pfad kompiliert Data Grid 1 mit Datenbank-, XPath- und
+Microflow-Quellen sowie auditierten Such-, Sortier-, Paging-, Auswahl- und
+Button-Verträgen. Alle anderen sichtbaren Widgets werden pro Seite in
+`web/mxrb-legacy-pages.json` erfasst und nicht als gerendert ausgewiesen.
+
+## MDA und portables Paket
+
+```bash
+mxrb pack App.mpr --output build/App.mda
+mxrb mda inspect build/App.mda
+mxrb portable App.mpr --output build/runtime.zip
+```
+
+MDA und portables ZIP sind deterministisch. Das portable Paket kombiniert das
+native Deployment mit der passenden installierten Runtime, Konfiguration,
+Konstanten und Skripten. Arbeitsverzeichnisse wie `data`, `log`, `run`, `build`
+und `.gradle` werden nicht in das MDA aufgenommen.
+
+## Regressionsnachweis
+
+```bash
+script/runtime_boot_regression App.mpr /fehlendes/deployment \
+  ~/.local/share/mendix/11.12.1
+```
+
+Der Test erzeugt ein temporäres Deployment, kompiliert Java und Web, paketiert,
+startet die Runtime und verlangt HTTP 200 für `/`, `dist/index.js` und jedes
+Seitenbundle. Ein sauberes Herunterfahren ist ebenfalls erforderlich. Protokoll
+und SHA-256 stehen in `tmp/runtime-boot-evidence.log`. Wenn Chromium installiert
+ist, importiert der Test alle Module und instanziiert Factorys ohne
+Sitzungsbedarf. Das Data-Grid-Bundle wird importiert und ausgewertet; seine
+Factory liest die Clientsitzung und benötigt daher einen authentifizierten Test.
+
+Am 1. August 2026 startete VetClinic 11.12.1 ohne vorhandenes Deployment,
+führte 675 Datenbanksynchronisierungen aus, initialisierte die
+`System`-Warteschlangen, plante `VetClinic.Cleanup`, lieferte 200 für alle vier
+Seitenbundles und fuhr sauber herunter. Danach bestand der Funktionstest
+`ACT Create Animal`.
+
+## Explizite Grenzen
+
+- alle 12 Stufen und saubere Web-Generierung sind für 6.10.8, 7.5.0, 7.17.0,
+  9.6.1.29396, 10.24.0.73019 und 11.12.1 validiert;
+- ein exakter nativer Boot ist für 10.24.0.73019 und 11.12.1 belegt. Die installierten
+  6/7/9-Distributionen enthalten exakte Runtime-Bundles, aber keinen
+  kompatiblen Launcher; `db up` schlägt geschlossen fehl, statt den Java-21-Launcher
+  aus Version 11 einzusetzen;
+- Data Grid 1 ist abgedeckt, andere Dojo-Widgets bleiben explizite
+  Manifestbefunde;
+- der optimierte Mendix-10-React/Rollup-Pfad ist durch eine neu erstellte
+  Anwendung belegt; der Mendix-11-React-Pfad besitzt saubere Preflights und vollständige
+  Rspack-Builds für LearnNow, MyFirstModule, SLATaskApp, Sudoku und VetClinic.
+  Diese Fixture-Matrix belegt auditierte Verträge, keine universelle Kompatibilität;
+- native Web-Bundles werden erzeugt; React Native verwendet weiterhin
+  bestehende Versions-Template- und Projektassets;
+- `mx` und `mxbuild` sind niemals Fallbacks. Nicht unterstützte Eingaben führen
+  zu einem klaren Compilerfehler oder einem Eintrag im Support-Manifest.

data/docs/de-DE/conventions.md

@@ -0,0 +1,19 @@
+# Konventionen
+
+[Português](../pt-BR/conventions.md) · [English](../en-US/conventions.md) · **Deutsch**
+
+- Mendix-qualifizierte Namen bleiben in Referenzen kanonisch.
+- Ruby-Dateien verwenden `snake_case`, ohne Artefaktidentitäten zu ändern.
+- Rename, Move, Remove und Migration werden vor Apply als Vorschau geprüft.
+- Seiten- und Flow-Rollen werden in geschützten Projekten deklariert.
+- Jedes Navigationsprofil besitzt ein Standardziel.
+- Rollenspezifische Ziele verweisen auf Benutzerrollen mit Zugriff.
+- Design-Tokens werden lokalen literalen Styles vorgezogen.
+- Typisierte Writer ändern nur ausdrücklich deklarierte Felder.
+- Themes, Widgets, Ressourcen und Java-Quellen sind Teil des Round-trips.
+- Vor Änderungen laufen RSpec, Branch-Report und RuboCop.
+
+Die exakte Mendix-5-Validierung unter Windows bleibt als Legacy-Einschränkung
+dokumentiert, ist aber kein aktuelles Auslieferungs-Gate.
+
+[Zurück zum Index](README.md)

data/docs/de-DE/design-system.md

@@ -0,0 +1,52 @@
+# Navigation und Design System
+
+[Português](../pt-BR/design-system.md) · [English](../en-US/design-system.md) · **Deutsch**
+
+Navigationsprofile sind native Mendix-Daten. MXRB liest und schreibt
+Standardseiten oder -Microflows, Login-Seiten, übersetzte Titel, Symbole,
+rollenspezifische Ziele und rekursive Menüs.
+
+```ruby
+navigation do
+  profile :Responsive, home_page: "Sales.Home", app_title: "Shop" do
+    title :de_DE, "Geschäft"
+    home_for :Administrator, microflow: "Sales.OpenDashboard"
+    item "Bestellungen", page: "Sales.Order_Overview", icon: "shopping_cart"
+  end
+end
+```
+
+`project.design_system` inventarisiert CSS-Eigenschaften, Sass-Variablen,
+Themes und `design-properties.json`-Kataloge. Lint findet fehlende Tokens,
+literale Farben und Kontrastverträge unterhalb des deklarierten WCAG-Niveaus.
+
+In der Ruby-DSL deklarierte Tokens werden in
+`theme/web/_mxrb-design-system.scss` materialisiert und genau einmal aus
+`theme/web/main.scss` importiert. Farb-Tokens erscheinen zusätzlich als
+Studio-`ColorPicker`-Eigenschaften in
+`themesource/mxrb/web/design-properties.json`. Theme-Vererbung und Overrides
+werden vor dem Schreiben aufgelöst; bestehender `main.scss`-Inhalt bleibt
+erhalten. Zyklen, ungültige Namen und strukturell unsichere CSS-Werte werden
+abgelehnt.
+
+Themes, Widgets, Ressourcen und Java-Quellen durchlaufen den Round-trip über
+`.mxrb/assets.json` mit SHA-256 und Traversal-Schutz.
+
+Literale Migrationen beginnen mit einer Vorschau. Apply lehnt Dateien ab, die
+sich seit der Vorschau geändert haben, und ersetzt jede Datei atomar.
+
+Dieselben Abläufe stehen über die CLI zur Verfügung:
+
+```sh
+bundle exec mxrb design scan App.mpr
+bundle exec mxrb design scan App.mpr --json
+bundle exec mxrb design migrate App.mpr '#3366ff' 'var(--brand-primary)'
+bundle exec mxrb design migrate App.mpr '#3366ff' 'var(--brand-primary)' --apply
+```
+
+`scan` zeigt Name, Wert, Typ, Theme und Quellposition jedes Tokens sowie die
+Anzahl literaler Farben und nicht aufgelöster Referenzen. `migrate` bleibt bis
+zur Angabe von `--apply` eine Vorschau. Im Ruby-Vertrag deklarierte
+Kontrastpaare prüft `mxrb lint` gegen die konfigurierte WCAG-Stufe.
+
+[Zurück zum Index](README.md)

data/docs/de-DE/entity-dsl.md

@@ -0,0 +1,53 @@
+# Entitäten-DSL
+
+[Português](../pt-BR/entity-dsl.md) · [English](../en-US/entity-dsl.md) · **Deutsch**
+
+Mit `mxrb entity new Modul.Entitaet` erzeugte Dateien werden im Modulblock
+ausgewertet. Deshalb wird nur der lokale Name deklariert:
+
+```ruby
+entity :Animal do
+  documentation "Tier in der Klinik"
+  string :Name, default: "", documentation: "Anzeigename"
+  integer :Age, default: 0
+  long :ExternalId
+  float :Weight
+  decimal :Balance
+  boolean :Active, default: true
+  datetime :BirthDate
+  autonumber :Sequence
+  hashstring :PasswordHash
+  binary :Document
+  enum :Species, enumeration: "VetClinic.AnimalSpecies"
+end
+```
+
+Verfügbare Typen sind `string`, `integer`, `long`, `float`, `decimal`,
+`boolean`, `datetime`, `autonumber`, `hashstring`, `binary` und `enum`. Derzeit
+werden `default:`, `documentation:` und bei Enum-Attributen `enumeration:` in
+das MPR geschrieben. Die Enumeration selbst wird mit `enumeration` deklariert,
+das Attribut mit `enum`.
+
+## Assoziationen
+
+```ruby
+association "VetClinic.Owner", name: "Animal_Owner" # N:1 Reference
+association "VetClinic.Passport", name: "Animal_Passport", owner: :Both # 1:1
+association "VetClinic.Tag", name: "Animal_Tags", type: :ReferenceSet # N:N
+association "VetClinic.Group", name: "Animal_Groups",
+            type: :ReferenceSet, owner: :Both
+```
+
+Das erste Argument ist das qualifizierte Ziel. `type:` akzeptiert `:Reference`
+(Standard) oder `:ReferenceSet`; `owner:` akzeptiert `:Default` oder `:Both`.
+
+## Persistenz, Ereignisse und Zugriff
+
+`non_persistent!` erzeugt eine nicht persistente Entität. Verfügbare Hooks sind
+`before_commit`, `after_commit`, `before_delete` und `after_delete`, jeweils mit
+`microflow:`. `access_rule` akzeptiert qualifizierte Rollen sowie `create:`,
+`delete:`, `read:`, `write:` und `xpath:`. Lesen und Schreiben verwenden
+`:all`, `:none` oder eine Attributliste.
+
+Weitere CLI-Hilfe liefert `mxrb entity --help`; das Ergebnis wird mit
+`mxrb generate project.rb` und `mxrb validate App.mpr` geprüft.

data/docs/de-DE/native-runtime-quality-report.md

@@ -0,0 +1,74 @@
+# Qualitätsbericht für nativen Build und Runtime
+
+Datum: 5. August 2026.
+
+## Bestätigtes Ergebnis
+
+- keine funktionale Stufe ruft `mx`, `mxbuild`, `mxcli`, Studio Pro oder Model SDK auf;
+- sauberer 12-Stufen-Build und Web-Generierung bestanden mit 6.10.8 (39 Seiten), 7.5.0 (45), 7.17.0 (66), 9.6.1.29396 (90), 10.24.0.73019 (optimierter Client) und 11.12.1;
+- die Round-trip-Matrix bestand mit sechs echten Fixtures von 5.21.4 bis 11.12.1: 1.506 Units, 1.734 Artefakte und 3.388 Referenzen;
+- auditierte Compiler-Schemas/Seeds decken 6.x, 7.x, 9.x, 10.x und 11.x ab. 5.x und 8.x schlagen bei nativer Kompilierung geschlossen fehl; Runtime benötigt den exakten Patch;
+- Data Grid 1 deckt Datenbank/XPath/Microflow, Suche, Sortierung, Paging, Auswahl und auditierte Buttons ab. Data Grid 2 deckt XPath, Attributspalten und Create ab;
+- Webprofile: Dojo in 6/7, Dojo/React-Hybrid in 9, projektabhängig klassisch/optimiert in 10 und React in 11;
+- Projects API inventarisierte 130 Apps. Drei echte Git-Projekte (`MyFirstModule`, `LearnNow Trainning Management`, `SLATaskApp`) bestanden validate → export → generate → validate → compare;
+- `MyFirstModule` wurde ohne proprietäre Builder als exaktes 11.12.1 erzeugt. Runtime synchronisierte 655 Operationen, erstellte den aktiven Admin `mx`, lieferte React-Shell und gestaltetes Login auf `127.0.0.1:18080` und zeigte die erwarteten Tabellen;
+- eine neu erstellte 10.24.0.73019-Anwendung mit optimiertem Client bestand offizielles `mx check` und `mxbuild`, natives Modell/Java/Rollup/Portable-Paket, 460 Datenbanksynchronisierungen, Readiness-Probe und HTTP 200;
+- authentifizierte Chromium-QA bestand wiederholt für Home und Orders mit
+  deterministischen DOM/Layout/Style/ARIA-Snapshots und Screenshots, null
+  Konsolenfehlern und einer expliziten SHA-256-Baseline;
+- `mxrb page new|generate|g Modul.Seite --chain ...` materialisiert gültige
+  MPRs für `page:microflow`, `page:nanoflow` und
+  `page:nanoflow:microflow`; ohne Option bleibt das minimale Seiten-Scaffold
+  unverändert;
+- `mxrb page templates` zeigt den Baum starter/blank/dashboard/form-vertical;
+  `--template` kombiniert Vorlagen mit Chains, und dashboard/form-vertical
+  bestanden in einer echten Runtime mit kompiliertem Theme und null Konsolenfehlern;
+- finale QA: 1.039 Beispiele, null Fehler, 100,00% Zeilen (17.224/17.224), 100,00% Branches (6.811/6.811) und RuboCop ohne Verstöße in 244 Dateien.
+
+## Korrekturen aus dem Verbesserungsbericht
+
+- selektive Java-Proxy-Erzeugung für verwendete Entitäten, Vererbung, Enums und Konstanten;
+- Absenkung der offiziellen Database-Connector-Build-Erweiterung auf External-Database-Connector-Java-Actions, einschließlich sicherem Query-Builder-`SELECT`;
+- OQL-Quellen, geerbte Persistenzflags, Demo-User-Rollen, Systemtexte und exakte Association-Storage/Access-Rechte;
+- stabile PostgreSQL-Bereitschaft, öffentliche Loopback-Portoption (`--runtime-port`), Admin-Passwort aus Umgebung und Admin-Erstellung;
+- eigenständige Login-Ressourcen, gerenderte Platzhalter, Cache-Busting, Stil und i18n;
+- Einbindung von Atlas-CSS, Manifest und öffentlichen Assets; die echte
+  Team-Server-Homepage rendert nun bedienbare React-Grids, Überschriften und Buttons;
+- Seitenimporte im Developer-Modus tragen das Sitzungs-Cache-Token; der
+  korrigierte Client-Chunk erhält einen Inhalts-Hash und der Rspack-Selbstimport
+  teilt das Entry-Point-Token, sodass keine veraltete leere Homepage geladen wird;
+- die erzeugte Shell stellt einen begrenzten `openForm`-Kompatibilitätsadapter
+  über `openForm2` bereit, damit zwischengespeicherte alte Click-Handler
+  navigieren, statt ohne Runtime-Request still fehlzuschlagen;
+- die offizielle React Gallery rendert nun XPath- und Microflow-Daten,
+  Item-Templates, Auswahl sowie formatierte String-/Zahlenwerte. Authentifizierte
+  Browser-QA zeigte Titel, Beschreibung, `90 day(s)` und `49.95`; eine leere
+  Teacher-Gallery blieb strukturell vorhanden;
+- Nanoflow-Listen-/Objektquellen und Button-Aktionen werden in die echten
+  Mendix-Clientverträge und funktionsreferenzierte Instruktionsprogramme
+  kompiliert. Der auditierte Graph-Teilumfang umfasst Entscheidungen,
+  Fehlerpfade, verschachtelte Nanoflows, JavaScript-Aktionen und serverseitige
+  Microflow-Aufrufe; nicht unterstützte Clientknoten schlagen geschlossen fehl;
+- der PostgreSQL-Workspace injiziert eine konsistente JDBC-URL und die Runtime-
+  SSL-Option; Navigationsrollen bei `CheckNothing`, Scroll-Modi, SidebarToggle
+  und Rückgabekonstanten von Microflow-Data-Sources folgen den im
+  authentifizierten 11.12.1-Client beobachteten Verträgen;
+- echte Browserklicks bestätigten Home → Courses → Add → Save. Parametergestützte
+  DataView/TextBox-Formulare rendern und speichern Werte; Create übergibt die GUID
+  über `openForm2`, während die Commit-/Rollback-Autorisierung aus den Modulrollen
+  der Seite abgeleitet wird. PostgreSQL bestätigte die vier gespeicherten QA-Werte;
+- Schutz vor Traversal, unsicheren Bezeichnern und Symlinks in nativen Eingaben;
+- Vergleich normalisiert fehlende boolesche Runtime-Defaults und erhält exakte Legacy-Round-trips.
+
+## Explizite Grenzen
+
+1. Andere Dojo-Widgets als Data Grid 1 bleiben in `web/mxrb-legacy-pages.json`; sie werden nicht als gerendert gemeldet.
+2. Data Grid 2 deckt den auditierten XPath/Attribut/Create-Teil ab. Gallery deckt
+   XPath/Microflow und den auditierten Nanoflow-Graph-Teil ab. Nicht unterstützte
+   Graphformen, fehlende Referenzen, unsichere Parameterabbildungen und nicht
+   übersetzte Client-Instruktionen schlagen weiterhin geschlossen fehl.
+3. Installierte 6/7/9-Distributionen enthalten exakte Bundles, aber keinen kompatiblen Launcher. Der 11-Launcher benötigt Java 21 und kann 9 unter Java 11 nicht sicher starten. Legacy-`db up` schlägt geschlossen fehl; exakter Boot wird nur für 10.24.0.73019 und 11.12.1 behauptet.
+4. Runtime verwendet eine lokale Trial-/Developer-Lizenz mit erwarteter Zeitlimit-Warnung.
+5. Cloud Build/Deploy/Pipelines/Backups sind optionale externe Prüfungen, nie Abhängigkeiten des nativen Kerns.
+
+Es gibt keinen versteckten `mx`/`mxbuild`-Fallback.