📚 Update README: Document intelligent change detection system

🆕 COMPREHENSIVE DOCUMENTATION UPDATE

## New Content Added:
### Intelligent Change Detection System
- Documents YAML hash monitoring and remote repository tracking
- Explains performance optimization (seconds vs minutes)
- Details the new selective rebuild logic

### Updated Workflow Documentation
- Enhanced Mermaid sequence diagram with change detection flow
- Updated make targets with new utility commands
- Added force-build options and cache management

### Technical Implementation Details
- Documents check_changes.sh script functionality
- Explains cache system (.cache/ directory)
- Details GitHub API integration for remote monitoring

### Repository Mapping Documentation
- digitalesysteme → VL_EingebetteteSysteme
- prozprog → VL_ProzeduraleProgrammierung
- softwareentwicklung → VL_Softwareentwicklung
- robotikprojekt → VL_Robotikprojekt

### Troubleshooting Section
- Common scenarios and solutions
- Performance metrics and expectations
- Remote repository update handling

### Updated File Structure
- Documents new files: check_changes.sh, .cache/, .gitignore
- Shows current PDF naming examples
- Reflects improved Makefile capabilities

## Key Improvements:
✅ Comprehensive coverage of all new features
✅ Clear performance expectations documented
✅ Troubleshooting guide for common issues
✅ Technical details for maintenance and debugging
✅ Updated workflow diagrams and examples

The README now fully reflects the production-ready intelligent
build system with remote repository monitoring capabilities.

Author: SebastianZug

README.md

@@ -2,9 +2,9 @@
 
 Course-Overview der Arbeitsgruppe Softwareentwicklung und Robotik (TU Freiberg)
 
-## Asset-Generierung und Deployment
+## Intelligente Asset-Generierung mit Change-Detection
 
-Die Kurs-Assets werden lokal generiert und intelligent deployed. Der Ablauf nutzt ein optimiertes Makefile für die lokale Entwicklung und eine schlanke GitHub Action als Fallback.
+Die Kurs-Assets werden lokal generiert mit einem intelligenten Change-Detection-System, das sowohl lokale YAML-Änderungen als auch Remote-Repository-Updates überwacht. Das System nutzt ein optimiertes Makefile für die lokale Entwicklung und eine schlanke GitHub Action als Fallback.
 
 ```mermaid
 sequenceDiagram
@@ -14,19 +14,27 @@ sequenceDiagram
     participant Action as GitHub Action
     participant Pages as GitHub Pages
 
-    Note over Dev,Pages: Lokaler Entwicklungsworkflow (Standard)
+    Note over Dev,Pages: Intelligenter Entwicklungsworkflow mit Change-Detection
     
     Dev->>Make: make digitalesysteme
-    Make->>Make: liaex -i digitalesysteme.yml
-    Note right of Make: Generiert HTML + PDFs
-    Make->>Make: mkdir -p assets/digitalesysteme/pdf
-    Make->>Make: cp *.pdf assets/digitalesysteme/pdf/
-    Note right of Make: Organisiert Assets in Kursordner
-    Make->>Make: sed -i 's|assets/pdf/|assets/digitalesysteme/pdf/|g'
-    Note right of Make: Korrigiert PDF-Pfade in HTML
-    Make->>Git: git add . && git commit --amend
-    Make->>Git: git push --force
-    Note right of Make: Automatischer Git-Workflow
+    Make->>Make: ./check_changes.sh digitalesysteme
+    Note right of Make: Prüft YAML-Hash + Remote-Repository
+    
+    alt Änderungen erkannt
+        Make->>Make: liaex -i digitalesysteme.yml
+        Note right of Make: Generiert HTML + PDFs
+        Make->>Make: mkdir -p assets/digitalesysteme/pdf
+        Make->>Make: cp *.pdf assets/digitalesysteme/pdf/
+        Note right of Make: Organisiert Assets in Kursordner
+        Make->>Make: sed -i 's|assets/pdf/|assets/digitalesysteme/pdf/|g'
+        Note right of Make: Korrigiert PDF-Pfade in HTML
+        Make->>Git: git add . && git commit --amend
+        Make->>Git: git push --force
+        Note right of Make: Automatischer Git-Workflow
+    else Keine Änderungen
+        Make->>Dev: ⏭️ Übersprungen (Sekunden statt Minuten!)
+        Note right of Make: Verwendet existierende Assets
+    end
     
     Git->>Action: Push Trigger
     Action->>Action: git diff --name-only HEAD~1 HEAD
@@ -60,18 +68,25 @@ sequenceDiagram
 ## Verfügbare Make-Targets
 
 ```bash
-# Einzelne Kurse generieren
-make digitalesysteme    # Digitale Systeme / Eingebettete Systeme
-make prozprog          # Prozedurale Programmierung
-make softwareentwicklung  # Softwareentwicklung
-make robotikprojekt    # Robotikprojekt
-make index            # Übersichtsseite
-
-# Alle Kurse
-make all
-
-# Hilfe anzeigen
-make help
+# Intelligente Kurs-Generierung (mit Change-Detection)
+make digitalesysteme    # ⚡ Überspringt wenn keine Änderungen
+make prozprog          # ⚡ Überspringt wenn keine Änderungen  
+make softwareentwicklung  # ⚡ Überspringt wenn keine Änderungen
+make robotikprojekt    # ⚡ Überspringt wenn keine Änderungen
+make index            # Übersichtsseite (keine Remote-Überwachung)
+
+# Alle Kurse mit Change-Detection
+make all              # Nur geänderte Kurse werden regeneriert
+
+# Erzwungene Neugenerierung (ignoriert Cache)
+make force-build-digitalesysteme  # Einzelner Kurs
+make force-all                    # Alle Kurse
+
+# Utility-Befehle
+make status           # Zeigt Build-Status und Cache-Informationen
+make clean-cache      # Löscht Cache → nächster Build regeneriert alles
+make clean-all        # Löscht alle generierten Dateien
+make help            # Zeigt alle verfügbaren Targets
 ```
 
 ## Konfiguration
@@ -92,28 +107,113 @@ SCORM_SCORE = 80
 ```
 ├── digitalesysteme.yml     # Kurskonfiguration
 ├── digitalesysteme.html    # Generierte Webseite
+├── check_changes.sh        # 🆕 Intelligente Change-Detection
+├── .cache/                 # 🆕 Cache für Change-Detection
+│   └── digitalesysteme     # Hash-Cache (YAML + Remote)
 ├── assets/
 │   └── digitalesysteme/
 │       └── pdf/           # Kurs-spezifische PDFs
-│           ├── 070f8b44f.pdf
-│           └── ...
-├── Makefile               # Build-System
+│           ├── 272cfe0.pdf
+│           ├── 0611ae484.pdf
+│           └── ...        # 16 PDFs insgesamt
+├── Makefile               # 🔄 Verbessertes Build-System
+├── .gitignore            # 🆕 Ignoriert .cache/ Verzeichnis
 └── .github/workflows/
-    └── generateOERoverview.yml  # Intelligente GitHub Action
+    └── generateOERoverview.yml  # Optimierte GitHub Action
 ```
 
-## Entwicklungsworkflow
-
-1. **Lokal entwickeln**: `make digitalesysteme`
-   - Generiert HTML und PDFs
-   - Organisiert Assets automatisch
-   - Korrigiert Pfade in HTML-Dateien
-
-2. **Automatischer Git-Workflow**:
+## Intelligentes Change-Detection-System
+
+### 🔍 **Was wird überwacht:**
+- **📄 Lokale YAML-Dateien**: SHA256-Hash der Konfiguration
+- **🌐 Remote GitHub-Repositories**: Commit-Hash via GitHub API
+  - `digitalesysteme` → `VL_EingebetteteSysteme`
+  - `prozprog` → `VL_ProzeduraleProgrammierung`
+  - `softwareentwicklung` → `VL_Softwareentwicklung`
+  - `robotikprojekt` → `VL_Robotikprojekt`
+- **📁 Generierte HTML-Dateien**: Existenz-Check
+
+### ⚡ **Performance-Optimierung:**
+- **Sekunden statt Minuten** bei unveränderten Inhalten
+- Automatisches **Überspringen** bei identischen Hashes
+- **Selective Rebuilds** nur bei tatsächlichen Änderungen
+
+### 🛠️ **Entwicklungsworkflow:**
+
+1. **Status prüfen**: `make status`
+   ```
+   📚 Course: digitalesysteme
+     ✅ HTML file exists
+     📋 Cache file exists  
+     💾 Cached YAML: bd241dd6...
+     💾 Cached remote: 5caf909b...
+     📁 Assets: 16 PDFs
+     🌐 Monitoring: VL_EingebetteteSysteme
+   ```
+
+2. **Intelligente Entwicklung**: `make digitalesysteme`
+   - ✅ **Änderung erkannt** → Vollständige Regenerierung (HTML + PDFs + Git)
+   - ⏭️ **Keine Änderung** → Überspringt Build (< 5 Sekunden)
+
+3. **Automatischer Git-Workflow** (nur bei Änderungen):
    - `git add .` und `git commit --amend` 
    - `git push --force` für saubere History
 
-3. **Intelligentes Deployment**:
-   - GitHub Action erkennt Änderungen
-   - Regeneriert nur bei Bedarf
-   - Fungiert als zuverlässiges Fallback
+## Technische Implementierung
+
+### 🧠 **Change-Detection-Script** (`check_changes.sh`)
+```bash
+# Prüft lokale YAML-Änderungen
+YAML_HASH=$(sha256sum digitalesysteme.yml | cut -d' ' -f1)
+
+# Überwacht Remote-Repository via GitHub API
+REMOTE_HASH=$(curl -s "https://api.github.com/repos/TUBAF-IfI-LiaScript/VL_EingebetteteSysteme/commits/master" | jq -r '.sha')
+
+# Vergleicht mit Cache
+if [ "$YAML_HASH" != "$CACHED_YAML" ] || [ "$REMOTE_HASH" != "$CACHED_REMOTE" ]; then
+    echo "✅ Changes detected - rebuild needed"
+    # Update cache and trigger rebuild
+else
+    echo "⏭️ No changes detected - skipping"
+fi
+```
+
+### 📋 **Cache-System**
+- **Speicherort**: `.cache/[course]` (ignoriert von Git)
+- **Format**: Zeile 1 = YAML-Hash, Zeile 2 = Remote-Hash
+- **Invalidierung**: Automatisch bei erkannten Änderungen
+
+### 🔄 **Rebuild-Trigger**
+- ✅ **YAML-Datei geändert** → Lokale Konfiguration aktualisiert
+- ✅ **Remote-Repository aktualisiert** → Neue Markdown-Inhalte verfügbar  
+- ✅ **HTML-Datei fehlt** → Erste Generierung oder Datei gelöscht
+- ⏭️ **Alles unverändert** → Skip (massive Zeitersparnis)
+
+## Troubleshooting & Tipps
+
+### 🔧 **Häufige Szenarien:**
+
+```bash
+# Erzwungene Neugenerierung (ignoriert Cache)
+make force-build-digitalesysteme
+
+# Cache zurücksetzen (nächster Build regeneriert alles)
+make clean-cache
+
+# Vollständige Neugenerierung aller Kurse
+make force-all
+
+# Status aller Kurse anzeigen
+make status
+```
+
+### 🌐 **Remote-Repository-Updates:**
+Das System erkennt automatisch neue Commits in den überwachten Repositories:
+- Neue Markdown-Inhalte werden automatisch bei `make digitalesysteme` gezogen
+- PDF-Dateinamen bleiben bei unverändertem Inhalt identisch
+- Remote-Verbindungsfehler → System nutzt cached Version
+
+### 📊 **Performance-Metriken:**
+- **Mit Änderungen**: ~3-5 Minuten (komplette PDF-Generierung)
+- **Ohne Änderungen**: ~3-5 Sekunden (Change-Detection + Skip)
+- **Überwachte Repositories**: 4 aktive + 1 index (nur lokal)