HQBase

Über HQBase

HQBase bietet Teams einen zentralen Ort für die Arbeit mit gemeinsamen Postfächern – während die Anwendung, die E-Mails und die Cloudflare-Anmeldedaten in der Infrastruktur des Kunden bleiben. Dazu gehören:

• Gemeinsame Postfächer und Team-Zugriffskontrollen.

• Multi-Domain-Setup, Entwürfe und Prüfprotokoll (Audit-Trail).

• Installation, Aktualisierung, Sicherung und Wiederherstellung.

• Ein OAuth-geschützter Remote-MCP-Server.

Weitere Informationen zu Installation, täglicher Nutzung, Architektur und Betrieb finden Sie in der Produktdokumentation.

Related MCP server: Gmail MCP Connector

Lokale Entwicklung

Anwendung starten

pnpm install
pnpm db:migrate:local
pnpm db:seed:local
pnpm dev

Bevor Sie den optionalen Seed-Befehl ausführen, fügen Sie diese Werte zu .dev.vars hinzu:

• BETTER_AUTH_SECRET

• HQBASE_LOCAL_SEED_PASSWORD mit 8 bis 128 Zeichen

Der Seed-Befehl schreibt nur in die lokale D1-Datenbank und kontaktiert kein Cloudflare-OAuth. Öffnen Sie http://127.0.0.1:5173/ und melden Sie sich mit owner@hqbase.test und diesem Passwort an. Vite stellt das Frontend mit Live-Reload auf Port 5173 bereit und leitet API-Anfragen an den Wrangler-Worker auf Port 8787 weiter.

Um den Ersteinrichtungs-Assistenten zu nutzen, lassen Sie den Seed-Befehl weg und öffnen Sie http://localhost:5173/setup.

Lokale Daten zurücksetzen

Um alle lokalen D1-Daten zu verwerfen, das Schema neu aufzubauen und den Demo-Arbeitsbereich neu zu erstellen:

pnpm db:reset:local
pnpm db:seed:local

Der Reset-Befehl ist destruktiv und wirkt nur lokal. Er verändert keine bereitgestellte Datenbank.

Setup-Oberfläche in der Vorschau anzeigen

Für reine Präsentationsarbeiten am Onboarding:

pnpm dev:setup-ui

Öffnen Sie http://127.0.0.1:5173/__ui/setup.

Änderungen prüfen

Führen Sie die vollständige lokale Qualitätsprüfung aus:

pnpm check
pnpm deploy:dry-run

Führen Sie pnpm cf:typegen aus, nachdem Sie wrangler.jsonc geändert haben.

Pushes auf main durchlaufen dieselbe Qualitätsprüfung sowie einen Deployment-Dry-Run. Das bereitgestellte Staging ist manuell und läuft ebenfalls innerhalb des signierten Release-Workflows. Ein Release bleibt im Entwurfsstatus, bis die vorherige stabile Version auf das exakt signierte Kandidaten-Release aktualisiert wurde und alle Prüfungen bestanden hat. Installationen und Updates bei Kunden verifizieren das signierte Manifest und den Artefakt-Digest vor der Bereitstellung.

Dokumentation

hqbase.io/docs ist die öffentliche Quelle für Benutzer- und Betreiberhandbücher, Produktspezifikationen und Wartungsverfahren.

Mitwirken

Bitte lesen Sie den Mitwirkungsleitfaden, bevor Sie einen Pull Request eröffnen.

Sicherheit

Um eine Schwachstelle zu melden, folgen Sie dem privaten Verfahren in der Sicherheitsrichtlinie.

Lizenz

HQBase ist unter der GNU Affero General Public License v3.0 only verfügbar.