Setup Playbook

Dokumenttyp: Developer Playbook
Status: Draft v0.1
Stand: 2026-06-29
Prinzip: Allgemeine Anleitung mit Praxisbeispiel aus Immohai

Zweck

Dieser Bereich beschreibt die vollständige Einrichtung einer Entwicklungsumgebung für moderne Softwareprojekte.

Die Struktur folgt dem tatsächlichen Ablauf eines neuen Projekts:

1. Server beschaffen.
2. Versionsverwaltung einrichten.
3. Server-Basissoftware installieren.
4. Entwicklungsrechner verbinden.
5. Projekt sauber starten.
6. Typische Fehler strukturiert beheben.

Praxisbeispiel: Immohai

Das Projekt Immohai dient als konkretes Referenzbeispiel. Immohai ist ein persönliches Werkzeug zur schnellen, transparenten und fundierten Bewertung von Immobilieninvestitionen.

Die technische Umgebung von Immohai besteht aktuell aus:

• Hetzner Cloud Server
• Ubuntu LTS
• Benutzer fober
• Git und GitHub
• Docker und Docker Compose
• MkDocs Material
• VS Code mit Remote-SSH
• Windows-PC als Entwicklungsarbeitsplatz

Struktur

setup/
├── 01-server/
├── 02-versionierung/
├── 03-server-software/
├── 04-entwicklungsumgebung/
├── 05-projektstart/
└── troubleshooting/

Dokumentationsstandard

Jede Datei enthält:

• Ziel
• Hintergrund
• Voraussetzungen
• Schritt-für-Schritt-Anleitung
• Best Practices
• Praxisbeispiel Immohai
• Typische Fehler
• Checkliste