fix: Gitea Traefik routing and connection pool optimization

- Remove middleware reference from Gitea Traefik labels (caused routing issues)
- Optimize Gitea connection pool settings (MAX_IDLE_CONNS=30, authentication_timeout=180s)
- Add explicit service reference in Traefik labels
- Fix intermittent 504 timeouts by improving PostgreSQL connection handling

Fixes Gitea unreachability via git.michaelschiemer.de

docs/claude/README.md

@@ -0,0 +1,76 @@
+# Claude Documentation
+
+Dieses Verzeichnis enthält AI-spezifische Dokumentation für Claude Code und andere AI-Agenten, die mit dem Framework arbeiten.
+
+## Zweck
+
+Die Dokumentation in diesem Verzeichnis ist speziell für AI-Agenten (wie Claude Code, Cursor AI, etc.) konzipiert und enthält:
+- Framework-spezifische Kontexte und Personas
+- MCP (Model Context Protocol) Integration
+- Development Commands für AI-Agenten
+- Coding Guidelines für AI-generierten Code
+- Code-Generierungs-Beispiele
+
+## Allgemeine Framework-Dokumentation
+
+Für allgemeine Framework-Dokumentation, die sowohl für Entwickler als auch AI-Agenten relevant ist, siehe:
+- [Framework Dokumentation](../README.md) - Hauptdokumentation
+- [Features](../features/) - Feature-spezifische Dokumentation
+- [Guides](../guides/) - Entwickleranleitungen
+- [LiveComponents](../livecomponents/) - LiveComponents Dokumentation
+
+## Wichtige Dokumentationen
+
+### MCP Integration
+- [MCP Integration](mcp-integration.md) - Model Context Protocol Server und Tools
+
+### Framework Personas
+- [Framework Personas](framework-personas.md) - AI Personas für Framework-Entwicklung
+
+### Development Commands
+- [Development Commands](development-commands.md) - Claude Code Commands und Workflows
+
+### Coding Guidelines
+- [Guidelines](guidelines.md) - AI Coding Guidelines und Best Practices
+- [Architecture](architecture.md) - Framework-Architektur für AI-Agenten
+- [Naming Conventions](naming-conventions.md) - Namenskonventionen
+
+### Code Generation Examples
+- [Examples](examples/) - Code-Generierungs-Beispiele
+
+## Weitere AI-spezifische Dokumentationen
+
+- [Performance Profiling](performance-profiling.md) - Performance-Analyse für AI-Agenten
+- [Structured Logging](structured-logging.md) - Logging-Patterns
+- [PHP 8.5 Integration](php85-framework-integration.md) - PHP 8.5 Features
+- [PostgreSQL Features](postgresql-features.md) - PostgreSQL-spezifische Features
+- [SSE System](sse-system.md) - Server-Sent Events
+- [SSE Integration Guide](sse-integration-guide.md) - SSE Integration
+- [Sockets Module](sockets-module.md) - Socket-Kommunikation
+- [Magic Links System](magiclinks-system.md) - Magic Links Implementation
+- [View Caching System](view-caching-system.md) - View-Caching
+- [View Refactoring Plan](view-refactoring-plan.md) - View-Refactoring
+- [X-Component Syntax](x-component-syntax.md) - X-Component Template Syntax
+- [XComponent Processor](xcomponent-processor.md) - XComponent Processing
+- [Animation System](animationsystem.md) - Animation Framework
+- [Chips & Cookies](chips-cookies.md) - Cookie Management
+- [Curl OOP API](curl-oop-api.md) - HTTP Client API
+- [Deployment Architecture](deployment-architecture.md) - Deployment-Architektur
+- [ML Framework Architecture](ml-framework-architecture.md) - Machine Learning Framework
+- [POSIX System](posix-system.md) - POSIX-Integration
+- [Typed String System](typed-string-system.md) - Typed String Value Objects
+- [Framework Refactoring Recommendations](framework-refactoring-recommendations.md) - Refactoring-Empfehlungen
+
+## Verwendung
+
+Diese Dokumentation wird automatisch von AI-Agenten verwendet, die mit dem Framework arbeiten. Sie sollte nicht manuell bearbeitet werden, es sei denn, es handelt sich um AI-spezifische Kontexte oder Beispiele.
+
+## Migration
+
+Viele Dokumentationen wurden von diesem Verzeichnis in die allgemeine Dokumentationsstruktur migriert:
+- Feature-Dokumentationen → `docs/features/`
+- Guides → `docs/guides/`
+- LiveComponents → `docs/livecomponents/`
+
+Siehe [Dokumentationsanalyse](../DOCUMENTATION-ANALYSIS.md) für Details zur Reorganisation.
+