Handwerk, Qualität & Teams · Gemischt

Namen, Struktur und Code, zu dem man zurückkehren kann

In einem Satz: Code wird weit mehr gelesen als geschrieben — daher sind ein genauer Name und eine vorhersehbare Struktur mehr wert als jede Cleverness.

Namen

Ein Name sagt, was das Ding in der Sprache der Domäne tut, nicht wie es umgesetzt ist. Ein Name, der einen Kommentar zum Verständnis braucht, ist ein schlechter Name.

Seien Sie konsistent: derselbe Begriff für dasselbe Konzept im ganzen System, auch in der Datenbank und der Oberfläche. Zwei Namen für eine Sache sind eine ständige Fehlerquelle.

Struktur

Ordnen Sie nach Geschäftsdomäne und nicht nach Dateityp. Ein „Bestellungen“-Ordner, der alles zu Bestellungen enthält, ist leichter zu navigieren als getrennte Ordner je Schicht.

Halten Sie Grenzen: Ein Modul erreicht ein anderes über eine definierte Schnittstelle, nicht über Interna. Innerhalb eines Systems gehaltene Grenzen sind, was das spätere Aufteilen erlaubt, falls nötig.

Einfachheit

Bevorzugen Sie langweiligen Code. Eine Abstraktion, die vor drei realen Fällen erzeugt wurde, ist fast immer falsch und schwerer zu entfernen als hinzuzufügen.

Im Detail

Ist Code schwer zu testen, ist das fast immer ein Zeichen für eine mit Logik verflochtene Abhängigkeit. Statt Nachahmungen hinzuzufügen, injizieren Sie die Abhängigkeit — der Test vereinfacht sich und die Struktur verbessert sich zugleich, und das ist eines der zuverlässigsten Zeichen für einen Entwurf, der Behebung braucht.