Zum Inhalt springen
DEVTechnische Spezifikation

Technische Spezifikation

Invarianten zuerst. Schnittstelle danach.

Was die Plattform fachlich erzwingt, steht fest: Mandant, Tarifversion, Statushistorie, Provision als Korrektur. Mapping und Schlüssel folgen im Partner-Onboarding.

  • Architektur
  • Backend
  • Security
  • Integration
Mandant
pflicht
Geld
minor units
Keys
onboarding

Nische

Spezifikation ohne öffentlichen Key-Rummel.

Markt · Problem

Was Entwicklerseiten oft falsch machen.

  • Öffentliche API-Keys und Sandbox-Wunder.
  • Features vor Invarianten.
  • „Alle Partner live“ ohne Nachweis.

SparWay · Lösung

Was hier steht.

  • Invarianten: Mandant, Version, Historie, Minor Units.
  • Connector-Modell und kanonische Objekte.
  • Dokumentation und Schlüssel im Onboarding.

Schichten

Technische Grundlage.

Spec

Objekte und Regeln.

technical specification · process layerSW-TS-001

SparWay ONE

Technische Spezifikation

Operative Prozessschicht zwischen Produktanbieter und Vertrieb. Ersetzt nicht Kassensystem, Versorgerkern, Gesellschaft oder Telco-BSS.

Dokument
SW-TS-001
Produkt
SparWay ONE
Schicht
Process layer · nicht Kernsystemersatz
Stand
31.08.2026
Katalog
codes.json v1.2.1-rc1 · frozen

Invarianten · Coding Rules

  1. #04Mandanttenant_id auf jeder fachlichen Tabelle. BelongsToTenant. Roh-Queries filtern selbst.
  2. #07TarifVersioniert, nie überschrieben. Historische Aufträge behalten den Snapshot.
  3. #08FinanzzeileFreigegebene Zeilen werden nicht mutiert. Korrektur statt Änderung.
  4. #09StatusJeder Wechsel: alt, neu, Quelle, Grund, Zeitpunkt.
  5. #18GeldInteger in Minor Units. Niemals float.

Objekte

  • KUNKunde / Akte
  • ORDEnergieauftrag
  • GKVMitgliedschaftsantrag
  • DOCDokument am Vorgang
  • RQRückfrage
  • COMProvision
  • AUDAudit

Laufzeit

  • RuntimeLaravel 12 · Next.js 15
  • IdentitätULID · Mandantentrennung
  • ConnectorREST · Webhook · CSV/XLSX · Adapter
  • MappingKanonisch nach innen · Rohstatus gespeichert · Map versioniert
  • RechteRolle · Produkt · Anbieter · Organisation

Connector

  • RESTbiAuftrag / Antrag übergeben, Status lesen
  • WebhookinStatus und Rückfrage inbound
  • CSV / XLSXfileBestand, Tarif, Abrechnung
  • AdapterpartnerIhr Format, unser Modell

Öffentlich live gilt nur Verifiziertes. Partnerdokumentation und Schlüssel im Onboarding — nicht auf dieser Website.

Invarianten

Nicht verhandelbar.

  • 01

    Mandant

    Jede fachliche Tabelle trägt tenant_id.

  • 02

    Tarife

    Versionieren, nie überschreiben.

  • 03

    Finanzen

    Freigegebene Zeilen nie mutieren.

  • 04

    Status

    Jeder Wechsel historisiert.

  • 05

    Geld

    Ganzzahl in Minor Units — nie float.

  • 06

    Keys

    Nicht auf dieser Website.

Technische Anbindung besprechen

Wir zeigen, wo Auftrag, Antrag, Status und Dokument ansetzen.

Technische Spezifikation · SparWay ONE