opencrm/backend/factory-defaults/README.md

1.5 KiB
Raw Blame History

Factory Defaults

Dieser Ordner enthält Stammdaten-Kataloge, die beim Initialisieren einer neuen OpenCRM-Installation automatisch eingespielt werden können.

Was ist drin?

  • providers.json Anbieter inkl. zugehöriger Tarife
  • cancellation-periods.json Kündigungsfristen (z.B. "14 Tage", "1 Monat")
  • contract-durations.json Vertragslaufzeiten (z.B. "12 Monate", "24 Monate")
  • contract-categories.json Vertragskategorien (Strom, Gas, DSL …)
  • pdf-templates.json + pdf-templates/*.pdf PDF-Auftragsvorlagen mit Feldzuordnungen

NICHT enthalten sind Kundendaten, Verträge, Dokumente, E-Mails oder SMTP-Einstellungen. Dafür gibt es den separaten Datenbank-Backup-Export.

Wie nutze ich das?

Export (aus bestehender Installation)

In den CRM-Einstellungen → Factory-Defaults → „Exportieren" → ZIP herunterladen und den Inhalt in diesen Ordner entpacken.

Import

npm run seed:defaults

Das Script liest alle Dateien aus diesem Ordner, merged mehrere JSONs automatisch per unique-name und spielt sie per Prisma upsert ein. Kann mehrfach ausgeführt werden (idempotent).

Mehrere Export-Dateien mergen

Wenn du mehrere ZIPs entpackst (z.B. Provider-Pakete von verschiedenen Quellen), kannst du die JSON-Dateien frei umbenennen das Script liest alle *.json im jeweiligen Unterordner und merged den Inhalt zusammen.

Beispiel:

providers/
  verivox.json
  check24.json
  eigene.json

Alle drei werden eingespielt, gleiche Anbieter werden über den name gemerged.