Was in ein Beispielprojekt gehört
Halten Sie Konfiguration, API-Aufrufe, Ergebnisvalidierung und Präsentation getrennt. Geben Sie Adressen und Zugangsdaten über die Umgebungskonfiguration an und geben Sie Abhängigkeits- und Laufzeitversionen an. Zeigen Sie erfolgreiche und fehlgeschlagene Ergebnisse an, damit Benutzer sowohl die Ausführung als auch die geschäftliche Korrektheit beurteilen können.
Wenn Ihre Version ein offizielles SDK enthält, befolgen Sie dessen versionspezifische Installations- und Authentifizierungsanweisungen. Andernfalls schreiben Sie dem Kunden den vereinbarten API-Vertrag entgegen. Bestätigen Sie die Paketnamen beim Anbieter und halten Sie persönliche Zugangsdaten aus dem Repository fern.
Beginnen Sie mit einem vollständig lokalen synthetischen Beispiel
Das folgende Beispiel nutzt die Python-Standardbibliothek. Es filtert nach Status und summiert die ausgewählten Zeilen. Es läuft lokal, ohne Aufruf von Haomai Technology AI Brain und ohne Datenbankverbindung. Sie können damit eine Kennzahlendefinition erproben. Die erwartete Programmausgabe lautet 200.00.
from decimal import Decimal
# Synthetic records for a local calculation. No SDK call is made.
orders = [
{"region": "A", "status": "confirmed", "amount": "120.00"},
{"region": "B", "status": "confirmed", "amount": "80.00"},
{"region": "A", "status": "cancelled", "amount": "30.00"},
]
total = sum(
(Decimal(row["amount"]) for row in orders
if row["status"] == "confirmed"),
Decimal("0.00"),
)
assert total == Decimal("200.00")
print(total)Dienstaufruf hinzufügen
- Behalten Sie die lokalen Basisdaten und die erwartete Ausgabe bei, damit die Berechnung unabhängig durchgeführt werden kann.
- Implementieren Sie den Anruf entsprechend dem tatsächlichen Vertrag und konfigurieren Sie Timeouts und Abbruch in der Testumgebung.
- Konvertieren Sie die zurückgegebenen Werte in eine explizite Datenstruktur, die abgeschlossene, fehlgeschlagene und unvollständige Ergebnisse unterscheidet.
- Prüfen Sie, dass Protokolle weder Zugangsdaten noch vollständige vertrauliche Anfragen oder unnötige Einzelheiten aus Datensätzen enthalten.
Beziehen Sie Fehlerfälle in das Beispiel ein
Decken Sie mindestens leere Ergebnisse, Typkonflikte, unbekannte Felder, Zeitüberschreitungen und unzureichende Berechtigungen ab. Geben Sie Benutzern neben dem Fehler einen nächsten Diagnoseschritt. Führen Sie diese Fälle nach Abhängigkeits- oder Dienst-Upgrades erneut aus, um festzustellen, welche Ebene sich geändert hat.
Schließen Sie Grenzfälle für Beträge, fehlende Werte und Statusfelder ein. Unterscheiden Sie einen fehlenden Wert von einer numerischen Null. Das automatische Füllen von Lücken in der Anzeige kann ein Problem mit der Datenqualität oder eine Protokolländerung verbergen.
