developer-rules/00-getting-started.md

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.

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 als Nächstes.