React + Vite (Schema Viz)
Deze map bevat stap 2 van de migratie van de schema-visualisaties naar React + Vite.
Wat staat hier
src/pages/IndexSchemaPage.jsx: migratie vanweb/index_schema.htmlsrc/pages/TijdlijnSchemaPage.jsx: migratie vanweb/tijdlijn_schema.htmlsrc/pages/EditorPage.jsx: wrapper rond de UML editor subtreesrc/shared/schemaUtils.js: gedeelde helpers (ESM)src/shared/SvgPatternDefs.jsx: gedeelde SVG pattern-defs (React component)src/shared/schema-viz.css: gedeelde basis-CSSsrc/styles/index-schema.css: index-specifieke CSSsrc/styles/tijdlijn-schema.css: tijdlijn-specifieke CSS
Routes (na build)
Omdat Gin router.Static("/viz", "./web") gebruikt, worden de buildbestanden onder web/react geserveerd als:
/viz/react/(index)/viz/react/tijdlijn.html(tijdlijn)/viz/react/editor.html(UML editor)
De editorcode is volledig geïntegreerd binnen deze Vite-app:
src/umleditor/— UML/metamodel-editor module (voorheen../../uml-editor/)
Vite importeert die code via de alias:
@umleditor->src/umleditor
Zie ook ../../UML_EDITOR_INTEGRATIE.md.
Studio — geïntegreerde werkbank (/studio)
src/studio/ bevat een VS Code-achtige werkbank die de losse functie-pagina's
(UML, DMN, BPMN, berichten, …) onder één schil brengt: een uitbreidbare iconenbalk
links en centrale werkvlakken met auto-hide tree-browser (links) en eigenschappen-paneel
(rechts). Elke functie is een activiteit met een dun contract (Sidebar/Main/Inspector);
de onderliggende modules blijven ongewijzigd. Een nieuwe functie toevoegen = één
descriptor registreren in src/studio/activities/index.jsx.
Volledige uitleg: ../../docs/STUDIO.md.
Ontwikkelen
-
Zorg dat Node.js + npm beschikbaar zijn op je machine.
-
Installeer dependencies:
npm install -
Start dev server:
npm run dev
In een git-worktree met gedeelde node_modules (junction/symlink naar de hoofdclone):
start met VITE_PRESERVE_SYMLINKS=1, bv. VITE_PRESERVE_SYMLINKS=1 npx vite --port 5175
(PowerShell: $env:VITE_PRESERVE_SYMLINKS="1"; npx vite --port 5175). Zonder die vlag volgt Vite
de junction naar een pad buiten de root en faalt de EA-import ("Failed to fetch dynamically
imported module … sql-wasm.wasm?import&url"). Zie resolve.preserveSymlinks in vite.config.js.
Regressietests Studio
Unittests (puur, Node): node --import ./test/register-aliases.mjs --test "src/**/*.test.js"
(op Windows via npm vindt het patroon niets door de quotes; roep node dan direct aan).
Gedrag in de interface staat in Playwright-specs tests/e2e/1x-studio-*.spec.js (selectie en
kaders, relaties en Delete, inspector, projectboom, vormen en vergroten). Ze mocken de API, dus
alleen een dev-server is nodig:
VITE_PRESERVE_SYMLINKS=1 npx vite --port 5175 --strictPort --host # eigen poort (in een worktree)
PLAYWRIGHT_BASE_URL=http://localhost:5175 PLAYWRIGHT_API_URL=http://127.0.0.1:9 npm run test:e2e:studio
PLAYWRIGHT_API_URL naar een dode poort laat de global-setup de login overslaan. Gedeelde opzet:
tests/e2e/helpers/studio.js (Studio openen, model in een profiel zetten, selectie lezen,
HTML5-slepen). Na een codewijziging in een draaiende dev-server: eerst herstarten, anders laden
de tests via HMR een tweede module-instantie.
Builden naar door Gin geserveerde map
npm run build
De output gaat naar web/react via vite.config.js (outDir: "../react").
API base URL
Standaard gebruiken de pagina's window.location.origin.
Je kunt overschrijven met:
VITE_API_BASE_URL