Für Entwickler · DevOps · Admins
Entwickler-Handbuch¶
Architektur, Entwicklungs-Setup, Deployment, Sicherheit und Betrieb der easySale-Plattform – vollständig dokumentiert.
Stack auf einen Blick¶
Flutter ERP & Shop (Web · iOS · Android)
Firebase Firestore · Auth · Storage · Functions
Node.js Cloud Functions · Backend-Logik
GitHub Actions CI/CD für Core und alle Clients
Architekturprinzip¶
easySale verwendet eine Single-Tenant Multi-Instance-Architektur:
- Jeder Kunde erhält eine eigene Firebase-Instanz (maximale Datenisolation)
- Der Quellcode ist zu ~80 % gemeinsam (Core-Repo), der Rest kundenspezifisch
- Bugfixes im Core werden automatisch auf alle Clients ausgerollt
Core-Repo (easySale) Client-Repos (je Kunde)
┌─────────────────────┐ ┌─────────────────────────────┐
│ ERP Base App │ ──┐ │ easysale-client-<slug> │
│ Shop Base App │ ├──▶│ ├── erp/ (Git-Dependency) │
│ Shared Libraries │ │ │ ├── firebase/ (Config) │
│ Cloud Functions │ │ │ └── .github/workflows/ │
│ Onboarding-Tools │ │ └─────────────────────────────┘
└─────────────────────┘ └──▶ (weiterer Client …)
Nach Bereich¶
-
Multi-Tenant-Konzept, Client-Override-System, Shared Packages
-
Lokales Setup, Lokalisierung, Dialog-Animationen, Artikel-Statistiken
-
Gesamtkonzept, GitHub Actions, Firebase-Config, CORS, Cloudflare Access
-
Security Policy, Dependency Scanning
-
Zugriffskonzept, Löschkonzept, Sub-Auftragsverarbeiter
-
Testkonzept, Core/Client-Erweiterungen
-
Interne Feature-Guides: Artikel, Jobs, Connectors, SAM KI, Berechtigungen
-
Mobile-App-Features: Artikel-Dokumente, Bilder & Varianten, Lieferpausen
-
Neuen Kunden auf die Plattform bringen
Häufige Aufgaben¶
| Aufgabe | Startpunkt |
|---|---|
| Projekt lokal aufsetzen | Lokales Setup |
| Neuen Kunden onboarden | Client-Onboarding |
| Deployment verstehen | Deployment-Gesamtkonzept |
| Docs-Zugriff verwalten | Cloudflare Access |
| Neuen Connector schreiben | ERP-Entwicklung |
Endanwender?
Das Benutzer-Handbuch – ohne technische Details – finden Sie hier.