Spezifiziert native Brücken, Speicherung, Synchronisierung, Sicherheit, Tests, Telemetrie und Wiederherstellung für Hintergrundaufgaben. Diese Referenz legt die Übernahmegrenze, das Fehlverhalten und beobachtbare Nachweise fest, während umgebungsspezifische Grenzen konfigurierbar bleiben.
Paketstatus: Referenzkontext bereit für menschliche Überprüfung. Der Vertrag und die Testszenarien sind vollständig, es wird jedoch nicht behauptet, dass eine übernehmende Implementierung diese bestanden hat.
Entscheidung
Für Hintergrundaufgaben wird ein plattformneutraler Domänenvertrag mit expliziten nativen Adaptern übernommen. Das Verhalten wird durch einen autoritativen Schreibpfad, typisierte Schnittstellen, expliziten Zustand und idempotente Nebenwirkungsbehandlung implementiert. Dieses Paket ist ein Referenzvertrag: Das übernehmende Team muss numerische Grenzen, Anbieter, Rechtsordnungen und operative Verantwortliche anhand von Nachweisen in der eigenen Umgebung auswählen.
Umfang
- Die Akteure, Eingaben, Ausgaben, Zustände, Richtlinien- oder Schema-Versionen und extern sichtbaren Ergebnisse der Hintergrundaufgaben, wie sie durch diesen Implementierungsblock beschrieben sind.
- Primäre und alternative Schnittstellen, Hintergrundarbeit, Caches, Integrationen, Unterstützungspfade und Nachweise, die dieselbe Grenze ausüben können.
- Übernahmespezifische Konfiguration, Rollout, Wiederherstellung und Verifikationsverantwortlichkeiten, die für eine sichere Anwendung der Referenz erforderlich sind.
Außerhalb dieses Blocks
- Die Wahl eines universellen Anbieters, Frameworks, einer Rechtsordnung, numerischer Schwellenwerte, Aufbewahrungsfristen oder Service-Level-Objectives für jeden Übernehmer.
- Die Behauptung, dass verpackte Szenarien gegen eine nachgelagerte Implementierung ausgeführt wurden oder dass diese Referenz rechtliche, Sicherheits- oder Barrierefreiheitszertifizierungen gewährt.
Vertrag
- Modellieren von Vordergrund-, Hintergrund-, beendeten, offline-, wiederhergestellten, abgemeldeten und berechtigungsverweigerten Zuständen, wenn die Funktion davon abhängt.
- Betriebssystem-Callbacks und externe Links als nicht vertrauenswürdige Eingaben behandeln und die daraus resultierende Domänenaktion neu autorisieren.
- Sensible Schlüssel nur über plattformgeschützte Einrichtungen speichern und Werte, die in Benachrichtigungen, Protokollen, Backups und Zwischenablagen kopiert werden, minimieren.
- Synchronisationsoperationen idempotent gestalten mit dauerhaften Versionen oder Operationskennungen statt Annahmen über vergangene Zeit.
- Eingaben einmal an der Grenze validieren und die normalisierte Darstellung bewahren, die von nachgelagerter Logik verwendet wird.
- Die geschäftliche Transition vor oder atomar mit einem Outbox-Datensatz persistieren; Verbraucher deduplizieren anhand dauerhafter Operationsidentität.
- Arbeit um Plattformplanung, Aussetzung, Konnektivität, Energie und Ausführungszeitlimits herum gestalten und Fortschritt vor dem Betriebssystem-terminieren checkpointen.
- Verzögerte Effekte zur Ausführungszeit neu autorisieren, doppelte Arbeit durch dauerhafte Identität vermeiden und materielle ausstehende, fehlgeschlagene oder vom Benutzer abgebrochene Ergebnisse sichtbar machen.
Implementierungsleitfaden
- Zuerst additive Speicher- und Schnittstellenänderungen ausliefern, beobachtbar nachpflegen, dann alte Pfade nach Kompatibilitätsnachweis zurückziehen.
- Hintergrundaufgaben-Eingaben, -Ausgaben, Akteure, Zustände, Invarianten, Nebenwirkungen und Nachweise modellieren, bevor Framework- oder Anbieterdetails ausgewählt werden.
- Die anwendbare Version des Hintergrundaufgabenvertrags oder der Richtlinie mit materiellem Zustand speichern, damit Migrationen, Wiedergabe und Supportentscheidungen zuordenbar bleiben.
- Den Pfad hinter kontrolliertem Rollout einführen, erwartete und beobachtete Ergebnisse vergleichen und eine getestete Wiederherstellungsroute bis zum Abschluss der Übernahmebelege beibehalten.
Fehlerbehandlung und Schutzmaßnahmen
- Unterbrochene native Arbeit wird von einem dauerhaften Checkpoint fortgesetzt oder kehrt in einen sicheren sichtbaren Zustand zurück, ohne Nebenwirkungen zu duplizieren.
- Ungültiger oder widersprüchlicher Hintergrundaufgaben-Zustand wird abgelehnt oder isoliert; die Implementierung schätzt niemals einen Wert, der Autorität erweitert oder eine Wirkung dupliziert.
- Wiederholungen sind begrenzt und verwenden dauerhafte Identität; nach Erschöpfung erreicht die Arbeit einen inspizierbaren Endzustand mit verantwortlichem Eigentümer.
Verifikation und Betrieb
- Abhängigkeitsfehler vor und nach der Persistenz injizieren und beweisen, dass Wiederholung auf ein einziges extern sichtbares Ergebnis konvergiert.
- Erfolg, Verweigerung, Validierungsfehler, Abhängigkeitsfehler, Wiederholungsermüdung und Wiederherstellung von Hintergrundaufgaben nach Vertragsversion ohne sensible Nutzlastdimensionen überwachen.
- Paare positiver und negativer Fixtures nach Richtlinien-, Schema-, Abhängigkeits-, Migrations- oder Grenzänderungen erneut ausführen und die resultierenden Nachweise bewahren.
Übernahmeannahmen
- Namen und Werte im Beispiel sind ein konkretes Fixture, keine universellen Standardwerte; Übernehmer ersetzen sie durch dokumentierte Nachweise und Verantwortlichkeit.
- Das übernehmende System kann authentifizierte Identität, dauerhafte Operationen oder Datensatzversionen, begrenzte Telemetrie und einen kontrollierten Pfad für Änderungen bereitstellen.
Die ausführbar aussehenden Beispiele in diesem Paket sind Fixtures und Akzeptanzverträge. Führen Sie den Sammlungsvalidator aus, um Struktur und Metadaten zu prüfen, übersetzen und führen Sie dann die Szenarien im Ziel-Repository aus, bevor Sie Implementierungsnachweise aufzeichnen.