FIELD REPORT / DEVELOPER INFRASTRUCTURE

GIT
IS A MAP

Git ist kein „Upload-Ordner“, sondern ein lokales, adressierbares Gedächtnis: Snapshots werden zu Objekten, Branches zu Zeigern und Merges zu nachvollziehbaren Entscheidungen.

PRIMITIVE4blob · tree · commit · tag
BRANCH1beweglicher Zeiger
MERGE2+Eltern in einem Commit
BEISPIELCLITINA-SNOW · Spring Boot

01 / Das Objektgedächtnis

Alles beginnt mit unveränderlichen Objekten. Ein Commit zeigt auf einen Tree; der Tree zeigt auf Dateien. Die Historie ist damit ein Graph, nicht nur eine Liste.

COMMITparent · author · messagee7a1… „ship report“TREEVerzeichnis-Snapshotsrc/ · pom.xml · READMEBLOBREADME.md · InhaltBLOBTinaSnowCliApplication.javaBLOBapplication.yamlHASH = IDENTITÄTGleicher Inhalt → gleicher Fingerabdruck.
Lesart: Ein Commit speichert nicht „die Datei“, sondern referenziert einen vollständigen Snapshot. Das macht Vergleiche, Branches und Rücksprünge billig und präzise.

02 / Branches sind Zeiger

Ein Branch kopiert nicht den Code. Er benennt den jeweils letzten Commit. Arbeit entsteht durch neue Commits; Zusammenführung bleibt sichtbar.

baseHEADfeature/reportdocs + diagrammerge commitmainBRANCH = NAMEein beweglicher ZeigerMERGE = ENTSCHEIDUNGKonflikte werden explizit
Praxisregel: Kleine, thematisch klare Commits sind bessere Karten. Die Commit-Nachricht sollte erklären, warum sich der Zustand verändert hat.

03 / Vom Commit zum Bericht

Der konkrete Anschluss an dieses Repository: Git hält den Entwicklungszustand fest; TINA-SNOW transportiert daraus erzeugte Berichte kontrolliert in die ServiceNow-Knowledge-Base.

GIT REPOcommit · tagREADME / source / reportMAVEN BUILDJava 21 · Spring BootJAR als reproduzierbares ArtefaktTINA-SNOW CLIupload / cleanupOAuth2 Client CredentialsSERVICENOW KBBericht + AnhängeDEV · QS · PRODCONTROL PLANEGit versioniert · Build prüft · CLI authentifiziert · Zielsystem veröffentlicht
Warum diese Kette wichtig ist: Git liefert Rückverfolgbarkeit, der Build liefert Reproduzierbarkeit und die CLI kapselt die Zielsystem-Integration. Jeder Schritt hat eine eigene Verantwortung.
QUICK READ

Die vier Fragen vor dem Push

  1. Was ändert sich — Code, Konfiguration oder Dokumentation?
  2. Warum ist diese Änderung nötig?
  3. Wo kann sie sicher geprüft werden — lokal, QS oder PROD?
  4. Wie kann jemand den Zustand zurücksetzen?
TAKEAWAY

Git ist soziale Technik

Die Datenstruktur ist elegant, aber ihr Wert entsteht durch Teamverhalten: klare Grenzen, kleine Änderungen, aussagekräftige Reviews und ein gemeinsames Verständnis von „fertig“.

Für TINA-SNOW heißt das: Bericht erzeugen, als Artefakt versionieren, in der passenden Umgebung ausrollen und den Lebenszyklus alter Anhänge explizit behandeln.