Files
developer-rules/00-getting-started.md
T

45 lines
1.7 KiB
Markdown

# 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.