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