API updadte

docs/development.md

@@ -0,0 +1,302 @@
+# Entwicklung
+
+[← Zurück zur Hauptseite](../README.md)
+
+## Entwickler-Workflow
+
+### Entwicklungsumgebung einrichten
+
+Siehe [Installation](installation.md)
+
+### Code-Änderungen testen
+
+```bash
+# Container starten
+docker-compose up -d
+
+# In Web-Container einloggen
+docker-compose exec web bash
+
+# Cache leeren nach Änderungen
+php bin/console cache:clear
+```
+
+## Testing
+
+### PHPUnit Tests
+
+Das Projekt verwendet PHPUnit 12.4 für Tests.
+
+#### Alle Tests ausführen
+
+```bash
+docker-compose exec web php bin/phpunit
+```
+
+#### Spezifische Tests
+
+```bash
+# Nur Entity-Tests
+docker-compose exec web php bin/phpunit tests/Entity
+
+# Nur API-Tests
+docker-compose exec web php bin/phpunit tests/Api
+
+# Einzelne Testklasse
+docker-compose exec web php bin/phpunit tests/Entity/UserTest.php
+```
+
+#### Mit Details
+
+```bash
+docker-compose exec web php bin/phpunit --verbose
+```
+
+#### Code Coverage (optional)
+
+```bash
+docker-compose exec web php bin/phpunit --coverage-text
+```
+
+### Test-Struktur
+
+```
+tests/
+├── Entity/
+│   ├── UserTest.php           # User-Entity Tests
+│   ├── ImmobilieTest.php      # Immobilie-Entity Tests
+│   ├── BundeslandTest.php     # Bundesland-Entity Tests
+│   └── HeizungstypTest.php    # Heizungstyp-Entity Tests
+└── Api/
+    ├── BundeslandApiTest.php  # Bundesländer-API Tests
+    ├── HeizungstypApiTest.php # Heizungstypen-API Tests
+    └── ApiDocumentationTest.php # API-Docs Tests
+```
+
+## Code Quality
+
+### PHP-CS-Fixer
+
+Für konsistenten Code-Style nach Symfony Standards.
+
+#### Code-Style prüfen (Dry-Run)
+
+```bash
+docker-compose exec web vendor/bin/php-cs-fixer fix --dry-run --diff
+```
+
+#### Code automatisch formatieren
+
+```bash
+docker-compose exec web vendor/bin/php-cs-fixer fix
+```
+
+#### Bestimmte Verzeichnisse
+
+```bash
+# Nur src/
+docker-compose exec web vendor/bin/php-cs-fixer fix src
+
+# Nur tests/
+docker-compose exec web vendor/bin/php-cs-fixer fix tests
+```
+
+### Code-Style Regeln
+
+Konfiguration in `.php-cs-fixer.dist.php`:
+- Symfony Coding Standards
+- PSR-12 kompatibel
+- Short Array Syntax
+- Sortierte Imports
+- Trailing Commas in Arrays
+
+## Datenbank
+
+### Neue Entity erstellen
+
+```bash
+docker-compose exec web php bin/console make:entity
+```
+
+### Migration erstellen
+
+Nach Änderungen an Entities:
+
+```bash
+docker-compose exec web php bin/console doctrine:migrations:diff
+```
+
+### Migration ausführen
+
+```bash
+docker-compose exec web php bin/console doctrine:migrations:migrate
+```
+
+### Migration rückgängig machen
+
+```bash
+# Letzte Migration
+docker-compose exec web php bin/console doctrine:migrations:migrate prev
+
+# Zu spezifischer Version
+docker-compose exec web php bin/console doctrine:migrations:migrate DoctrineMigrations\\Version20251109100000
+```
+
+### Migration-Status
+
+```bash
+docker-compose exec web php bin/console doctrine:migrations:status
+```
+
+### Datenbank-Schema validieren
+
+```bash
+docker-compose exec web php bin/console doctrine:schema:validate
+```
+
+## Controller & Routes
+
+### Controller erstellen
+
+```bash
+docker-compose exec web php bin/console make:controller
+```
+
+### Routes anzeigen
+
+```bash
+# Alle Routes
+docker-compose exec web php bin/console debug:router
+
+# Spezifische Route
+docker-compose exec web php bin/console debug:router app_home
+```
+
+## Symfony Console
+
+### Cache
+
+```bash
+# Cache leeren
+docker-compose exec web php bin/console cache:clear
+
+# Cache warmup
+docker-compose exec web php bin/console cache:warmup
+```
+
+### Services debuggen
+
+```bash
+# Alle Services
+docker-compose exec web php bin/console debug:container
+
+# Spezifischer Service
+docker-compose exec web php bin/console debug:container UserRepository
+```
+
+### Ereignisse anzeigen
+
+```bash
+docker-compose exec web php bin/console debug:event-dispatcher
+```
+
+### Konfiguration anzeigen
+
+```bash
+docker-compose exec web php bin/console debug:config framework
+```
+
+## Git Workflow
+
+### Feature-Branch erstellen
+
+```bash
+git checkout -b feature/neue-funktion
+```
+
+### Änderungen committen
+
+```bash
+git add .
+git commit -m "Feature: Beschreibung der Änderung"
+```
+
+### Pull Request erstellen
+
+1. Push auf Remote Branch
+2. Pull Request in GitHub/GitLab erstellen
+3. Code Review abwarten
+4. Nach Approval mergen
+
+## Best Practices
+
+### Code-Organisation
+
+1. **Controller:** Dünn halten, Logik in Services auslagern
+2. **Entities:** Nur Datenmodell, keine Business-Logik
+3. **Services:** Wiederverwendbare Business-Logik
+4. **Repositories:** Nur Datenbank-Queries
+
+### Namenskonventionen
+
+- **Controller:** `XyzController.php`
+- **Entity:** `Xyz.php`
+- **Repository:** `XyzRepository.php`
+- **Service:** `XyzService.php`
+- **Test:** `XyzTest.php`
+
+### Security
+
+- Nie Passwörter im Klartext speichern
+- Immer UserPasswordHasher verwenden
+- CSRF-Tokens bei allen Forms
+- Input-Validierung auf Server-Seite
+- Output-Escaping (Twig macht automatisch)
+
+### Performance
+
+- Doctrine Query Cache nutzen
+- Eager Loading für Relationen
+- Opcache in Produktion aktivieren
+- Assets kompilieren für Produktion
+
+## Deployment
+
+### Vorbereitung
+
+```bash
+# .env.local für Produktion erstellen
+cp .env .env.local
+
+# Produktions-Werte setzen
+APP_ENV=prod
+APP_SECRET=<neues-secret-generieren>
+```
+
+### Build für Produktion
+
+```bash
+# Composer Dependencies ohne Dev
+composer install --no-dev --optimize-autoloader
+
+# Cache warmup
+php bin/console cache:warmup --env=prod
+
+# Assets installieren
+php bin/console assets:install public --symlink --relative --env=prod
+```
+
+### Database Migration
+
+```bash
+php bin/console doctrine:migrations:migrate --no-interaction --env=prod
+```
+
+---
+
+**Siehe auch:**
+- [Technical](technical.md) - Architektur & Konfiguration
+- [Docker](docker.md) - Container-Management
+- [Troubleshooting](troubleshooting.md) - Fehler beheben
+
+[← Zurück zur Hauptseite](../README.md)