DDI/docs/adr/0018-zentrale-benennung.md

0018 – Zentrale Benennung von Produkt, Pfaden und Diensten

• Status: Akzeptiert
• Datum: 2026-10-12

Kontext

„ddi-suite“ ist ein Arbeitstitel. Eine Umbenennung soll ohne Suchen-und-Ersetzen im ganzen Code möglich sein.

Entscheidung

• Go: Das Paket internal/brand enthält Produktname, Binary-Namen, Standardpfade (/etc/ddi-suite, /var/lib/ddi-suite, /var/log/ddi-suite), Systembenutzer und Unit-Namen. Die Werte sind Variablen und lassen sich beim Build per -ldflags -X überschreiben. Der übrige Code verwendet nur diese Werte.
• Build: Das Makefile definiert dieselben Namen als Variablen (PRODUCT, BIN_SERVER, …) und reicht sie per -ldflags durch.
• Installer, systemd-Units, Paketdefinitionen: Namen stehen jeweils einmal oben in der Datei bzw. werden aus Vorlagen mit diesen Variablen erzeugt.
• Ausnahmen: Go-Modulpfad und Protobuf-Paketname (ddi.agent.v1) sind technische Kennungen und bleiben bei einer Umbenennung bestehen.

Konsequenzen

Eine Umbenennung betrifft wenige, klar benannte Stellen. Die CI prüft (ab M6), dass in Units und Installer keine fest kodierten Produktnamen außerhalb der Variablenblöcke stehen.