TECHNISCHER REPORT · MAIERZONE

mz-dev-toolbox

Drei Werkzeuge, ein Baukasten: Clean-Code-Referenz, Offline-Krypto-Suite und Regex-Tester — Architektur, Stack und Reifegrad im Ueberblick.

Java 21 · Spring Boot 4 React + TypeScript Monorepo, 3 Subprojekte

Repository: maierzone/mz-dev-toolbox
Stand: 2026-08-04
Subprojekte: clean-code-examples · mzone-dev-suite · regex-editor
Report-Typ: Architektur- & Stack-Uebersicht

Ueberblick

mz-dev-toolbox buendelt drei lose gekoppelte, aber stilistisch konsistente Entwickler-Werkzeuge unter einem Dach: eine didaktische Clean-Code-Referenz in reinem Java, einen Offline-Regex-Tester und dessen Weiterentwicklung zu einer vollstaendigen, lokal laufenden Krypto-/Dev-Toolbox.

Subprojekte

Backend-Module (mzone-dev-suite)

8Pakete

Clean-Code-Regeln

Release-Pipelines

2von 3

Die drei Projekte

01 · Referenz

clean-code-examples

kein Release

Deutschsprachige Lernsammlung der "Top 10 Clean Code Rules" fuer moderne Java-Enterprise-Entwicklung — je Regel ein Bad*/Good*-Klassenpaar (SRP, Konstruktor-Injektion, Records, Value Objects, Fail-Fast u.a.).

STACK

Java 21Spring Boot 4.0.0MavenJUnit 5 / Mockito

MODULE

rule01_srp…rule10_testable

Zusatzordner mit with_skill/without_skill-Vergleichen — dient offenbar auch als Testbett fuer Claude-Code-Skills. Kein REST-API, keine CI/Release-Pipeline.

02 · Kern-Toolbox

mzone-dev-suite

aktive Releases

"jwt.io, openssl & friends — aber nichts verlaesst deinen Rechner." Offline Single-Executable-Toolbox fuer JWT, Zertifikate, Hashes und SSH-Keys.

STACK

Spring Boot 4.1.0Java 21BouncyCastle 1.85 Nimbus JOSE+JWT 10.9.1React 18 + TSVite 7 + TailwindRadix UI

MODULE (Backend + Frontend gespiegelt via registry.ts)

regexjwtcertchain hashbase64sshconfig

Privacy-by-Design: keine Logs, keine Netzwerkaufrufe. Ein Origin liefert UI + API aus einer JAR. Portables Windows-Paket via jpackage, keine Installation noetig.

03 · Ursprungsprojekt

regex-editor

aktive Releases

Moderner, lokal laufender Tester fuer java.util.regex-Muster mit Live-Feedback, Capture-Group-Details und Replace-Vorschau. Als Web-App und Desktop-Installer (Windows, Ubuntu/WSL, openSUSE) verfuegbar.

STACK

Spring Boot 4 / Framework 7Lombok React 18 + TS 5.5Vite 5 + TailwindBun

REST API v1

POST /matchPOST /replace GET /validateGET /health

Eigenes desktop-Spring-Profil bindet an 127.0.0.1 und aktiviert einen System-Tray-Launcher fuer die gepackten Installer.

Stack-Vergleich

	clean-code-examples	regex-editor	mzone-dev-suite
Java	21	21	21
Spring Boot	4.0.0	4 / Framework 7	4.1.0
Frontend	—	React 18 + TS 5.5	React 18 + TS
Build-Tool FE	—	Bun + Vite 5	npm + Vite 7
UI-Kit	—	shadcn / Radix	Radix UI
Packaging	—	jpackage (.exe/.msi/.deb/.rpm)	jpackage (portable .zip)
CI/CD	keine	Release nur bei Tag	CI je Push + Release bei Tag

BACKEND-MODULE JE PROJEKT

Architektur & Verwandtschaft

regex-editor ist die Keimzelle: mzone-dev-suite bettet den vollstaendigen regex-editor als eigenes regex-Modul ein. Die Dev-Ports sind bewusst getrennt gewaehlt (regex-editor: 8080, mzone-dev-suite: 8081), damit beide gleichzeitig laufen koennen — mzone-dev-suite ist faktisch die Evolution von regex-editor zur vollen Offline-Krypto-Suite.

regex-editor
Standalone-Tool

──absorbiert in──▶

mzone-dev-suite / modules/regex
ein Modul von acht

Gemeinsamer Hausstil

Java 21 + Spring Boot 4.x + Maven im Backend, React/TypeScript/Tailwind im Frontend, "Backend liefert Frontend aus einer JAR" und jpackage-basierte Desktop-Pakete — konsistent ueber alle drei Projekte hinweg.

Ausreisser

clean-code-examples ist rein didaktisch: kein REST-API, kein Frontend, keine Release-Pipeline. Es dokumentiert Team-Standards statt ein Werkzeug auszuliefern.

CI/CD

Workflow	Trigger	Zweck
mztools-ci.yml	Push/PR auf `mzone-dev-suite/**`	`mvn -B package` — Build + Test, Java 21 + Node 20
mztools-release.yml	Tag `mztools-vX.Y.Z`	Portable Windows-ZIP via jpackage, GitHub Release
regex-editor-desktop-release.yml	Tag `regex-editor-vX.Y.Z` oder manuell	Parallele Windows-(.exe/.msi via WiX) und Linux-(.deb/.rpm) Builds, zusammengefuehrt in einem Release

clean-code-examples hat keinen eigenen Workflow — es wird nicht als Artefakt ausgeliefert.

Befunde & Empfehlungen

B1Info

Der Monorepo-Zuschnitt mit pfadgefilterten Workflows und projektspezifischen Tag-Praefixen (mztools-v*, regex-editor-v*) funktioniert sauber fuer unabhaengige Releases — sollte beibehalten werden, wenn weitere Tools hinzukommen.
B2Mittel

regex-editor hat keinen eigenen CI-Build-Workflow fuer Push/PR (nur Release bei Tag) — im Gegensatz zu mzone-dev-suite. Ein leichter mvn -B package-Check bei jedem PR wuerde Regressionen frueher fangen.
B3Mittel

Da mzone-dev-suite den regex-editor-Code intern dupliziert/einbettet statt zu referenzieren, droht Drift zwischen beiden Implementierungen. Eine gemeinsame Bibliothek oder ein klarer Sync-Prozess wuerde das vermeiden.
B4Positiv

Konsistenter Stack (Java 21, Spring Boot 4.x, React/TS/Tailwind) senkt die Einstiegshuerde zwischen den Projekten erheblich und erleichtert Code-Reuse.