Coding Guidelines

Dokumenttyp: Developer Playbook
Status: Draft v0.1
Stand: 2026-06-29

Ziel

Grundregeln für Codequalität festlegen.

Prinzipien

• Lesbarkeit vor Cleverness
• Kleine Funktionen
• Klare Namen
• Tests für Fachlogik
• Dokumentierte Annahmen
• Keine Duplikate

Praxisbeispiel Immohai

Für Immohai ist besonders wichtig, dass Berechnungslogik nachvollziehbar bleibt und nicht in UI oder API versteckt wird.

Best Practices

• Fachlogik separat halten.
• Tests vor komplexen Formeln.
• Kommentare für Annahmen, nicht für offensichtlichen Code.
• Formatierung automatisieren.

Checkliste

• [ ] Namenskonventionen festgelegt
• [ ] Tests geplant
• [ ] Formatierung eingerichtet