Initial import: Rechte/Pflichten/Regelwerk fuer Modul-Entwickler

2026-07-28 20:13:09 +02:00
commit 02c1542868
11 changed files with 633 additions and 0 deletions
@@ -0,0 +1,44 @@
+# Getting Started
+
+*(Quelle: neu, keine interne Vorlage)*
+
+## Was ist ein HUBrobotix-Modul?
+
+HUBrobotix.ai ist ein Core (Mandantensystem) + Module (Plugins), die über einen Marktplatz
+installiert werden. Ein Modul besteht aus:
+
+- **Frontend** (HTML/JS unter `moduls/<dein_key>/{js,pages,modals}`)
+- **Eigenem Datenbank-Schema** (`db/schema.sql`, nur dein eigenes Schema, keine Core-Tabellen)
+- **Automations-Workflow** (n8n, deine eigentliche Server-Logik)
+- **`manifest.json`** (beschreibt dein Modul: Name, Version, benötigte Rechte, Einstiegspunkte)
+
+## Grundregel Nummer 1
+
+**Dein Modul-Code greift nie direkt auf eine Datenbank zu.** Jeder Datenzugriff läuft über die
+Core-API — auch auf dein eigenes Schema. Das ist keine Empfehlung, sondern technisch erzwungen:
+dein Modul-Code bekommt nie ein Datenbank-Passwort, egal wie du es baust. Details:
+[03-security-rules.md](03-security-rules.md).
+
+## Ablauf in Kürze
+
+```
+1. Lokal (dein Rechner, kein Zugang zu uns nötig):
+   Frontend + manifest.json + db/schema.sql vorbereiten
+   → CLI-Tool (siehe SDK-Dokumentation) validiert lokal, kostenlos, sofort
+
+2. Sandbox (unsere isolierte Test-Umgebung, Zugang nach Registrierung):
+   Workflow bauen + testen mit Fake-Daten, echter KI-Testmodus möglich
+   → Details: 07-sandbox-usage.md
+
+3. Einreichung (Developer-Portal):
+   Paket hochladen → 5-stufige automatische Prüfung → menschliches Security-Audit
+   → Details: 06-submission-review-process.md
+
+4. Marktplatz:
+   Nach Freigabe: Modul ist im Marktplatz sichtbar, Mandanten können es installieren
+   → Details: 08-revenue-share.md (deine Vergütung)
+```
+
+## Reihenfolge der weiteren Dokumente
+
+Lies [01-manifest-schema.md](01-manifest-schema.md) als Nächstes.