Installationsanleitung

Installationsuebersicht

Budgeting Pro wird aus Shopify installiert und anschliessend ueber eine shopspezifische Subdomain aufgerufen.

Der aktuelle Installationsablauf erstellt den Shop und den Shop-Superadmin automatisch. Er erstellt nicht automatisch alle Unternehmens-, Standort-, Budget- und Benutzerdaten fuer den Haendler.

Shopify-Installationsablauf

Schritt 1: App installieren und autorisieren

Wenn der Haendler die App aus Shopify installiert und OAuth abschliesst:

wird das Shopify-Access-Token fuer den Shop gespeichert
wird der Shop-Datensatz lokal erstellt oder aktualisiert
wird ein Superadmin-Benutzer fuer diesen Shop erstellt
wird die Superadmin-E-Mail aus den Shopify-Shopdaten uebernommen

Schritt 2: Zugangsdaten werden per E-Mail versendet

Nach erfolgreicher Installation sendet die App dem Shop-Superadmin:

die URL der Shop-Subdomain
die Admin-E-Mail-Adresse
ein generiertes Passwort

Das Admin-Konto wird als Benutzertyp admin mit der Rolle super_admin erstellt.

Schritt 3: Hintergrundeinrichtung startet

Nach der Installation startet die App ausserdem Hintergrundprozesse, um:

Webhooks zu registrieren
Shopify-Unternehmen fuer den Shop zu importieren

Erster Zugriff nach der Installation

Die Anwendung wird ueber die Shop-Subdomain erreicht, zum Beispiel:

https://your-shop-subdomain.4budgetingpro.app/admin
https://your-shop-subdomain.4budgetingpro.app/app

Zugriff auf das Admin-Panel

Das erste durch die Installation erstellte Konto ist der Shop-Admin. Dieser Benutzer meldet sich auf /admin an mit:

E-Mail
Passwort

Zugriff auf das App-Panel

Unternehmensbenutzer nutzen /app. Sie verwenden nicht den Admin-Passwort-Flow. Das unternehmensseitige Panel nutzt:

Registrierung plus E-Mail-Verifizierung fuer neue Unternehmens-Setups
OTP-Anmeldung fuer Unternehmensbenutzer

Abonnementfreigabe

Initiales Zugriffsfenster

Die aktuelle Middleware erlaubt einem neu installierten Shop den Zugriff auf die App fuer etwa 30 Minuten nach der Installation, bevor die Abonnementfreigabe erzwungen wird.

Billing-Flow

Nach dem initialen Fenster kann die App den Haendler in den Shopify-Billing-Freigabe-Flow weiterleiten:

/billing/create
/billing/confirmed

Abhaengig von der Shopify-Antwort kann der Shop:

aktiviert sein
auf Freigabe warten
abgelehnt sein
blockiert sein, bis das Billing geklaert ist

Unternehmens-Onboarding nach der Shop-Installation

Shop-Installation und Unternehmens-Onboarding sind im aktuellen Stand getrennte Themen.

Nach der Shop-Installation koennen Unternehmensdaten auf zwei Arten eingebracht werden:

Option 1: Bestehende Unternehmen aus Shopify importieren

Oeffnen Sie im Admin-Panel Unternehmen und verwenden Sie Import From Shopify.

Option 2: Neues Unternehmen ueber das App-Panel registrieren

Ueber /app/register kann ein Unternehmenskontakt Folgendes uebermitteln:

Unternehmensname
Name des ersten Standorts
Lieferadresse
Rechnungsadresse
Hauptkontaktinformationen
Zahlungsbedingungen

Diese Registrierung wird als ausstehend gespeichert, bis die E-Mail-Adresse verifiziert ist. Nach der Verifizierung erstellt die App das Unternehmen und den ersten Standort in Shopify und lokal.

Fehlerbehebung

Ich habe die App installiert, kann mich aber nicht anmelden

Pruefen Sie:

die E-Mail, an die die Admin-Zugangsdaten gesendet wurden
die Shop-Subdomain in dieser E-Mail
dass Sie fuer das Shop-Admin-Konto /admin aufrufen

Ich kann direkt nach der Installation auf die App zugreifen, spaeter sehe ich jedoch einen Bildschirm mit Zahlung erforderlich

Das ist zu erwarten, wenn das initiale Zugriffsfenster endet und der Shop die Abonnementfreigabe noch nicht abgeschlossen hat.

Nach der Installation fehlt ein Unternehmen

Unternehmen erscheinen nicht garantiert sofort, ausser:

sie wurden aus Shopify importiert, oder
sie wurden ueber den App-Registrierungsflow erstellt und erfolgreich verifiziert

Eine neue Unternehmensregistrierung haengt fest