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/js-modules-analysis.md

@@ -0,0 +1,735 @@
+# JavaScript Modules Analysis & Recommendations
+
+**Comprehensive Analysis of Existing JS Modules and Recommendations for New Modules and Refactorings**
+
+This document provides a detailed analysis of the current JavaScript module ecosystem, identifies areas for improvement, and proposes new modules and refactorings.
+
+---
+
+## Table of Contents
+
+1. [Current Module Overview](#current-module-overview)
+2. [Module Quality Assessment](#module-quality-assessment)
+3. [Recommended New Modules](#recommended-new-modules)
+4. [Refactoring Recommendations](#refactoring-recommendations)
+5. [Priority Matrix](#priority-matrix)
+6. [Implementation Roadmap](#implementation-roadmap)
+
+---
+
+## Current Module Overview
+
+### Module Categories
+
+#### 1. **Core Framework Modules**
+- `livecomponent/` - LiveComponents system (well-structured, modern)
+- `ui/` - UI components (Modal, Dialog, Lightbox)
+- `api-manager/` - Web API wrappers (comprehensive)
+- `sse/` - Server-Sent Events client
+
+#### 2. **Form & Input Modules**
+- `form-handling/` - Form validation and submission
+- `form-autosave.js` - Auto-save functionality
+
+#### 3. **Navigation & Routing**
+- `spa-router/` - Single Page Application router
+
+#### 4. **Animation & Effects Modules**
+- `canvas-animations/` - Canvas-based animations
+- `scrollfx/` - Scroll-based animations
+- `parallax/` - Parallax effects
+- `smooth-scroll/` - Smooth scrolling
+- `scroll-timeline/` - Scroll timeline animations
+- `scroll-loop/` - Infinite scroll loops
+- `scroll-dependent/` - Scroll-dependent effects
+- `sticky-fade/` - Sticky fade effects
+- `sticky-steps/` - Sticky step animations
+- `inertia-scroll/` - Inertia scrolling
+- `wheel-boost/` - Wheel boost effects
+- `noise/` - Noise effects
+
+#### 5. **Media & Image Modules**
+- `image-manager/` - Image gallery, upload, modal
+
+#### 6. **Utility Modules**
+- `csrf-auto-refresh.js` - CSRF token management
+- `hot-reload.js` - Hot reload functionality
+- `performance-profiler/` - Performance profiling
+- `webpush/` - Web Push notifications
+
+#### 7. **Admin Modules**
+- `admin/data-table.js` - Admin data tables
+
+---
+
+## Module Quality Assessment
+
+### ✅ Well-Structured Modules (Keep as-is)
+
+1. **livecomponent/** - Excellent structure, modern patterns
+   - ✅ Modular architecture
+   - ✅ TypeScript definitions
+   - ✅ Error handling
+   - ✅ Comprehensive documentation
+
+2. **api-manager/** - Well-organized Web API wrappers
+   - ✅ Consistent API
+   - ✅ Feature detection
+   - ✅ Good separation of concerns
+
+3. **form-handling/** - Solid form handling
+   - ✅ Clear separation (Handler, Validator, State)
+   - ✅ Progressive enhancement
+   - ⚠️ Could benefit from LiveComponent integration
+
+4. **ui/** - Clean UI component system
+   - ✅ Reusable components
+   - ✅ Consistent API
+   - ⚠️ Could expand with more components
+
+### ⚠️ Modules Needing Refactoring
+
+1. **spa-router/** - Good but could be improved
+   - ⚠️ Mixed concerns (routing + transitions)
+   - ⚠️ Could better integrate with LiveComponents
+   - ⚠️ Module re-initialization could be cleaner
+
+2. **form-autosave.js** - Standalone file
+   - ⚠️ Should be part of form-handling module
+   - ⚠️ No module system integration
+
+3. **Scroll Animation Modules** - Too many separate modules
+   - ⚠️ `scrollfx/`, `parallax/`, `scroll-timeline/`, `scroll-loop/`, `scroll-dependent/`, `sticky-fade/`, `sticky-steps/` - Could be unified
+   - ⚠️ Duplicate functionality
+   - ⚠️ Inconsistent APIs
+
+4. **image-manager/** - Good but could be enhanced
+   - ⚠️ Could integrate with LiveComponent file uploads
+   - ⚠️ EventEmitter pattern could be modernized
+
+5. **performance-profiler/** - Standalone
+   - ⚠️ Could integrate with LiveComponent DevTools
+   - ⚠️ Should be part of development tools
+
+### ❌ Modules Needing Major Refactoring
+
+1. **Multiple Scroll Modules** - Consolidation needed
+   - ❌ 8+ separate scroll-related modules
+   - ❌ Inconsistent patterns
+   - ❌ Hard to maintain
+
+2. **csrf-auto-refresh.js** - Standalone file
+   - ❌ Should be part of security module
+   - ❌ No module system integration
+
+---
+
+## Recommended New Modules
+
+### 1. **State Management Module** (High Priority)
+
+**Purpose**: Centralized state management for client-side state
+
+**Features**:
+- Reactive state store (similar to Redux/Vuex)
+- State persistence (localStorage, sessionStorage)
+- State synchronization across tabs
+- Time-travel debugging
+- Integration with LiveComponents
+
+**Use Cases**:
+- User preferences
+- Shopping cart state
+- UI state (sidebar open/closed, theme)
+- Form drafts
+
+**API Example**:
+```javascript
+import { StateManager } from './modules/state-manager/index.js';
+
+const store = StateManager.create({
+    user: { name: '', email: '' },
+    cart: { items: [], total: 0 },
+    ui: { sidebarOpen: false }
+});
+
+// Reactive updates
+store.subscribe('cart', (cart) => {
+    updateCartUI(cart);
+});
+
+// Actions
+store.dispatch('cart.addItem', { id: 1, name: 'Product' });
+```
+
+**Priority**: High
+**Effort**: Medium (2-3 days)
+
+---
+
+### 2. **Validation Module** (High Priority)
+
+**Purpose**: Standalone validation system (not just forms)
+
+**Features**:
+- Field-level validation
+- Schema-based validation (JSON Schema)
+- Async validation
+- Custom validation rules
+- Integration with LiveComponents
+- Integration with form-handling
+
+**Use Cases**:
+- Form validation
+- API response validation
+- User input validation
+- Data transformation validation
+
+**API Example**:
+```javascript
+import { Validator } from './modules/validation/index.js';
+
+const validator = Validator.create({
+    email: {
+        type: 'email',
+        required: true,
+        message: 'Invalid email address'
+    },
+    age: {
+        type: 'number',
+        min: 18,
+        max: 100
+    }
+});
+
+const result = await validator.validate({ email: 'test@example.com', age: 25 });
+```
+
+**Priority**: High
+**Effort**: Medium (2-3 days)
+
+---
+
+### 3. **Cache Manager Module** (Medium Priority)
+
+**Purpose**: Intelligent caching for API responses and computed values
+
+**Features**:
+- Memory cache
+- IndexedDB cache
+- Cache invalidation strategies
+- Cache warming
+- Cache analytics
+- Integration with RequestDeduplicator
+
+**Use Cases**:
+- API response caching
+- Computed value caching
+- Image caching
+- Search result caching
+
+**API Example**:
+```javascript
+import { CacheManager } from './modules/cache-manager/index.js';
+
+const cache = CacheManager.create({
+    strategy: 'stale-while-revalidate',
+    ttl: 3600000 // 1 hour
+});
+
+// Cache API response
+const data = await cache.get('users', async () => {
+    return await fetch('/api/users').then(r => r.json());
+});
+
+// Invalidate cache
+cache.invalidate('users');
+```
+
+**Priority**: Medium
+**Effort**: Medium (2-3 days)
+
+---
+
+### 4. **Event Bus Module** (Medium Priority)
+
+**Purpose**: Centralized event system for cross-module communication
+
+**Features**:
+- Pub/sub pattern
+- Namespaced events
+- Event filtering
+- Event history
+- Integration with LiveComponents
+- Integration with SSE
+
+**Use Cases**:
+- Component communication
+- Module communication
+- Global notifications
+- Analytics events
+
+**API Example**:
+```javascript
+import { EventBus } from './modules/event-bus/index.js';
+
+const bus = EventBus.create();
+
+// Subscribe
+bus.on('user:logged-in', (user) => {
+    updateUI(user);
+});
+
+// Publish
+bus.emit('user:logged-in', { id: 1, name: 'John' });
+
+// Namespaced events
+bus.on('livecomponent:action-executed', (data) => {
+    console.log('Action executed:', data);
+});
+```
+
+**Priority**: Medium
+**Effort**: Low (1-2 days)
+
+---
+
+### 5. **Storage Manager Module** (Low Priority)
+
+**Purpose**: Unified storage interface (localStorage, sessionStorage, IndexedDB)
+
+**Features**:
+- Unified API for all storage types
+- Automatic serialization
+- Storage quotas
+- Storage migration
+- Storage analytics
+
+**Note**: Partially exists in `api-manager/StorageManager`, but could be enhanced
+
+**Priority**: Low (enhance existing)
+**Effort**: Low (1 day)
+
+---
+
+### 6. **Router Enhancement Module** (Medium Priority)
+
+**Purpose**: Enhanced routing with guards, middleware, and lazy loading
+
+**Features**:
+- Route guards (auth, permissions)
+- Route middleware
+- Lazy route loading
+- Route transitions
+- Route analytics
+- Integration with LiveComponents
+
+**API Example**:
+```javascript
+import { Router } from './modules/router/index.js';
+
+const router = Router.create({
+    routes: [
+        {
+            path: '/dashboard',
+            component: 'DashboardComponent',
+            guard: 'auth',
+            middleware: ['analytics']
+        }
+    ]
+});
+
+router.beforeEach((to, from, next) => {
+    if (requiresAuth(to) && !isAuthenticated()) {
+        next('/login');
+    } else {
+        next();
+    }
+});
+```
+
+**Priority**: Medium
+**Effort**: Medium (2-3 days)
+
+---
+
+### 7. **Animation System Module** (Low Priority)
+
+**Purpose**: Unified animation system consolidating all scroll/animation modules
+
+**Features**:
+- Unified animation API
+- Scroll-based animations
+- Timeline animations
+- Performance optimizations
+- Integration with Web Animations API
+
+**Consolidates**:
+- `scrollfx/`
+- `parallax/`
+- `scroll-timeline/`
+- `scroll-loop/`
+- `scroll-dependent/`
+- `sticky-fade/`
+- `sticky-steps/`
+- `canvas-animations/`
+
+**Priority**: Low (refactoring existing)
+**Effort**: High (5-7 days)
+
+---
+
+### 8. **Error Tracking Module** (High Priority)
+
+**Purpose**: Centralized error tracking and reporting
+
+**Features**:
+- Error collection
+- Error grouping
+- Error reporting (to backend)
+- Error analytics
+- Integration with ErrorBoundary
+- Source map support
+
+**API Example**:
+```javascript
+import { ErrorTracker } from './modules/error-tracking/index.js';
+
+const tracker = ErrorTracker.create({
+    endpoint: '/api/errors',
+    sampleRate: 1.0
+});
+
+// Automatic error tracking
+tracker.init();
+
+// Manual error reporting
+tracker.captureException(new Error('Something went wrong'), {
+    context: { userId: 123 },
+    tags: { feature: 'checkout' }
+});
+```
+
+**Priority**: High
+**Effort**: Medium (2-3 days)
+
+---
+
+### 9. **Analytics Module** (Medium Priority)
+
+**Purpose**: Unified analytics system
+
+**Features**:
+- Event tracking
+- Page view tracking
+- User behavior tracking
+- Custom events
+- Integration with LiveComponents
+- Privacy-compliant (GDPR)
+
+**API Example**:
+```javascript
+import { Analytics } from './modules/analytics/index.js';
+
+const analytics = Analytics.create({
+    providers: ['google-analytics', 'custom']
+});
+
+analytics.track('purchase', {
+    value: 99.99,
+    currency: 'EUR',
+    items: [{ id: 'product-1', quantity: 1 }]
+});
+```
+
+**Priority**: Medium
+**Effort**: Medium (2-3 days)
+
+---
+
+### 10. **Internationalization (i18n) Module** (Low Priority)
+
+**Purpose**: Internationalization and localization
+
+**Features**:
+- Translation management
+- Pluralization
+- Date/time formatting
+- Number formatting
+- Currency formatting
+- Integration with LiveComponents
+
+**API Example**:
+```javascript
+import { i18n } from './modules/i18n/index.js';
+
+i18n.init({
+    locale: 'de-DE',
+    fallback: 'en-US',
+    translations: {
+        'de-DE': { 'welcome': 'Willkommen' },
+        'en-US': { 'welcome': 'Welcome' }
+    }
+});
+
+const message = i18n.t('welcome');
+```
+
+**Priority**: Low
+**Effort**: Medium (2-3 days)
+
+---
+
+## Refactoring Recommendations
+
+### 1. **Consolidate Scroll Animation Modules** (High Priority)
+
+**Current State**: 8+ separate scroll-related modules
+
+**Proposed Solution**: Create unified `animation-system/` module
+
+**Benefits**:
+- Single API for all animations
+- Reduced bundle size
+- Easier maintenance
+- Better performance
+- Consistent patterns
+
+**Implementation**:
+1. Create `animation-system/` module
+2. Migrate functionality from existing modules
+3. Maintain backward compatibility during transition
+4. Deprecate old modules
+5. Update documentation
+
+**Priority**: High
+**Effort**: High (5-7 days)
+
+---
+
+### 2. **Integrate form-autosave into form-handling** (Medium Priority)
+
+**Current State**: Standalone `form-autosave.js` file
+
+**Proposed Solution**: Add autosave functionality to `form-handling/` module
+
+**Benefits**:
+- Better organization
+- Shared form state
+- Consistent API
+- Easier maintenance
+
+**Implementation**:
+1. Move autosave logic into `FormHandler`
+2. Add autosave configuration options
+3. Integrate with `FormState`
+4. Update documentation
+
+**Priority**: Medium
+**Effort**: Low (1 day)
+
+---
+
+### 3. **Enhance SPA Router with LiveComponent Integration** (Medium Priority)
+
+**Current State**: SPA Router works independently
+
+**Proposed Solution**: Better integration with LiveComponents
+
+**Benefits**:
+- Automatic LiveComponent initialization after navigation
+- Better state management
+- Improved performance
+- Unified API
+
+**Implementation**:
+1. Add LiveComponent auto-initialization
+2. Integrate with LiveComponentManager
+3. Handle component state during navigation
+4. Update documentation
+
+**Priority**: Medium
+**Effort**: Medium (2-3 days)
+
+---
+
+### 4. **Create Security Module** (Medium Priority)
+
+**Current State**: `csrf-auto-refresh.js` is standalone
+
+**Proposed Solution**: Create `security/` module
+
+**Features**:
+- CSRF token management
+- XSS protection helpers
+- Content Security Policy helpers
+- Security headers validation
+
+**Implementation**:
+1. Create `security/` module
+2. Move CSRF logic
+3. Add additional security features
+4. Update documentation
+
+**Priority**: Medium
+**Effort**: Low (1-2 days)
+
+---
+
+### 5. **Integrate Performance Profiler with DevTools** (Low Priority)
+
+**Current State**: Standalone `performance-profiler/` module
+
+**Proposed Solution**: Integrate with LiveComponent DevTools
+
+**Benefits**:
+- Unified developer experience
+- Better visualization
+- Easier debugging
+- Reduced bundle size (dev only)
+
+**Implementation**:
+1. Move profiler into DevTools
+2. Integrate with LiveComponent profiling
+3. Update UI
+4. Update documentation
+
+**Priority**: Low
+**Effort**: Medium (2-3 days)
+
+---
+
+### 6. **Modernize Image Manager** (Low Priority)
+
+**Current State**: Uses EventEmitter pattern
+
+**Proposed Solution**: Modernize with ES6 classes and better integration
+
+**Benefits**:
+- Modern patterns
+- Better TypeScript support
+- Integration with LiveComponent file uploads
+- Improved performance
+
+**Implementation**:
+1. Refactor to ES6 classes
+2. Add TypeScript definitions
+3. Integrate with LiveComponent file uploads
+4. Update documentation
+
+**Priority**: Low
+**Effort**: Medium (2-3 days)
+
+---
+
+## Priority Matrix
+
+### High Priority (Implement Soon)
+
+1. **State Management Module** - Needed for complex applications
+2. **Validation Module** - Reusable validation logic
+3. **Error Tracking Module** - Production debugging
+4. **Consolidate Scroll Animation Modules** - Maintenance burden
+
+### Medium Priority (Implement Next)
+
+1. **Cache Manager Module** - Performance optimization
+2. **Event Bus Module** - Cross-module communication
+3. **Router Enhancement Module** - Better routing features
+4. **Analytics Module** - Business requirements
+5. **Integrate form-autosave** - Code organization
+6. **Enhance SPA Router** - Better integration
+7. **Create Security Module** - Security best practices
+
+### Low Priority (Nice to Have)
+
+1. **Storage Manager Module** - Enhance existing
+2. **Animation System Module** - Refactoring existing
+3. **i18n Module** - Internationalization
+4. **Integrate Performance Profiler** - Developer experience
+5. **Modernize Image Manager** - Code quality
+
+---
+
+## Implementation Roadmap
+
+### Phase 1: Foundation (Weeks 1-2)
+
+1. **State Management Module** (3 days)
+2. **Validation Module** (3 days)
+3. **Error Tracking Module** (3 days)
+4. **Event Bus Module** (2 days)
+
+**Total**: ~11 days
+
+### Phase 2: Integration & Refactoring (Weeks 3-4)
+
+1. **Integrate form-autosave** (1 day)
+2. **Enhance SPA Router** (3 days)
+3. **Create Security Module** (2 days)
+4. **Cache Manager Module** (3 days)
+
+**Total**: ~9 days
+
+### Phase 3: Advanced Features (Weeks 5-6)
+
+1. **Router Enhancement Module** (3 days)
+2. **Analytics Module** (3 days)
+3. **Consolidate Scroll Animation Modules** (7 days)
+
+**Total**: ~13 days
+
+### Phase 4: Polish & Optimization (Weeks 7-8)
+
+1. **Storage Manager Enhancement** (1 day)
+2. **Integrate Performance Profiler** (3 days)
+3. **Modernize Image Manager** (3 days)
+4. **Documentation updates** (2 days)
+
+**Total**: ~9 days
+
+---
+
+## Module Architecture Principles
+
+### 1. **Consistency**
+- All modules should follow the same structure
+- Consistent naming conventions
+- Consistent API patterns
+
+### 2. **Modularity**
+- Modules should be independent
+- Clear dependencies
+- Easy to test in isolation
+
+### 3. **Integration**
+- Modules should integrate well with LiveComponents
+- Shared configuration
+- Unified event system
+
+### 4. **Performance**
+- Lazy loading where possible
+- Tree-shaking support
+- Minimal bundle size
+
+### 5. **Developer Experience**
+- TypeScript definitions
+- Comprehensive documentation
+- Clear error messages
+- DevTools integration
+
+---
+
+## Next Steps
+
+1. **Review this analysis** with the team
+2. **Prioritize modules** based on project needs
+3. **Create detailed implementation plans** for high-priority modules
+4. **Start with Phase 1** (Foundation modules)
+5. **Iterate and refine** based on feedback
+
+---
+
+**Last Updated**: 2025-01-XX
+**Status**: Draft - Pending Review
+