Files
Homelab--Bratonein-Kontroll…/Workflow Notizen.md

366 lines
17 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Workflow_Notizen
## 1. Chatregeln
Verhindern, dass sich der Chat in langen Sitzungen verliert oder Fantasie-Inhalte entstehen.
Klare Regeln für Neustarts und Fokus.
## Grundprinzipien
1. **Klare Zieldefinition**
Zu Beginn jeder Phase wird das Ziel festgelegt.
Beispiel:
> Ziel dieser Phase: PDF-Template für alle Kapitel fertigstellen.
2. **Ein Thema pro Schritt**
Keine Vermischung verschiedener Aufgaben in einer Antwort.
3. **Regelmäßige Zwischenstände**
ChatGPT fasst nach abgeschlossenen Schritten den Stand zusammen:
- Erledigt
- Offen
- Nächster Schritt
4. **Nachfragen statt Raten**
Bei fehlenden Infos wird immer nachgefragt.
## Wenn der Chat „entgleist“
- **Anzeichen:** Abschweifen, widersprüchliche Aussagen, Fantasie-Inhalte, Fokusverlust.
- **Aktion:**
1. User sagt: `STOP Neuer Chat ab <Kapitel/Thema>`
2. ChatGPT erstellt eine kurze Zusammenfassung des letzten stabilen Stands.
3. Neuer Chat wird eröffnet, Einstiegspunkt ist der letzte stabile Stand.
4. Workflow_Notizen bleiben als Referenz bestehen.
## Checkliste für jede neue Phase
- [ ] Ziel für die Phase notiert
- [ ] Offene Aufgaben aus vorheriger Phase geklärt
- [ ] Workflow_Notizen als Referenz geöffnet
- [ ] Nach Abschluss: Zusammenfassung geschrieben
## Kurzfassung
> **Immer nur ein Thema, klare Ziele, Zwischenstände dokumentieren, bei Fehlern Neustart ab stabilem Punkt.**
---
## 2. Roadmap 2025 Homelab Tutorial
- ~~**30.09 15.10:** Planung, PDF-Template, To-Do-Liste, erste Free-Rohtexte~~
- ~~**16.10 05.11:** Free-Kapitel (112 + Paperless) fertigstellen~~
- ~~**06.11 20.11:** Premium-Kapitel **Clipper** (Kap. 13) ausarbeiten~~
- ~~**21.11 30.11:** restliche Premium-Kapitel (Backup, n8n-Pro-Flows, Home-Assistant-Erweiterungen etc.)~~
- ~~**01.12 15.12:** komplette **Test- & Review-Phase** (alle Installationen/Skripte neu durchspielen)~~
- ~~**16.12 24.12:** Bugfixes, finale Screenshots & PDFs~~
- **25.12 31.12:** Launch: Veröffentlichung aller PDFs + Start Premium-Download
Roadmap siehe 5.
---
## 3. Freemium-Planung (Kapitelweise)
### 1. Proxmox
**Free:** Grundinstallation, Storage, LXC-Anlage
**Premium:** Backup-Strategien, Snapshots, HA-Cluster-Basics, Ressourcen-Tuning
### 2. Pi-hole + Unbound
**Free:** Basis-Setup als DNS-Blocker
**Premium:** zusätzliche Blocklisten, zentrale Statistik-Dashboards, Auto-Updates, Grafana-Charts
### 3. Nginx Proxy Manager
**Free:** Standard-Setup mit SSL
**Premium:** Sicherheits-Header, Geo-Blocking, Auto-Renew-Monitoring, Custom-Templates
### ~~4. dyndns (IPv6 NPM / IPv4 FRITZ!Box)~~
~~**Free:** Basis-DynDNS-Einrichtung~~
~~**Premium:** Failover-Strategie, Monitoring, API-Updates~~
In Kapitel 3 bereits abgehandelt. Später GUI als weiterer Prämiuminhalt
### 5. WireGuard (Kapitel 4)
**Free:** Basis-VPN mit 1 Client
**Premium:** Multi-Client-Setup, automatisches Schlüssel-Management, dynamisches Routing
### 6. Vaultwarden (Kapitel 5)
**Free:** Standard-Installation, 1 User, Web-UI
**Premium:** Multi-User-Policies, 2FA-Erzwingung, SSO-Integration
### 7. Nextcloud (Kapitel 6)
**Free:** Installation, erster User, Web-UI, Clients (Win/Mac/Mobil)
**Premium:** php.ini/www.conf-Tuning, Redis-Optimierung, externe Speicher-Mounts, SFTP-Upload-Integration, Preview-Cache
### 8. Affine (Kapitel 7)
**Free:** Grundinstallation, Basis-Features
**Premium:** Vorlagen-Paket, Backup-Automatisierung
### 9. Archiv (Kapitel 8)
**Free:** Basiseinbindung von Archiv-Storage (Duplicati)
**Premium:** automatisierte Mount-Skripte, Lifecycle-Management, Storage-Monitoring
### 10. Webspace (Kapitel 9)
**Free:** Basis-Setup für statische Seiten
**Premium:** Auto-Deployment via Git, Staging/Prod-Trennung, HTTPS-Redirect-Regeln
### 11. n8n (Kapitel 10)
**Free:** Installation + produktiver Beispiel-Workflow **„Stream-Reminder + Social-Post“**
**Premium:** Twitch-ICS-Flows, Auto-Upload-VODs, Social-Media-Flüsse, Fehler-Monitoring
### 12. RTMP (OME) (Kapitel 11)
**Free:** Grundinstallation für 1 Input → 1 Output
**Premium:** Simulcast auf mehrere Plattformen, automatische Aufzeichnung + Speicherung
### 13. Clipper (Kapitel 22)
**Free:**
**Premium:** kompletter Workflow inkl. Whisper-Untertitel, ZIP-Archiv, Cleanup-Skript, KI-Analyse
### 14. Asset-LXC (Kapitel 12)
**Free:** Separater LXC für statische Dateien, Grundinstallation mit Nginx als File-Server, Verzeichnisstruktur und HTTPS-Einbindung über NPM
**Premium:** Erweiterte Caching- und Komprimierungsfunktionen, projektbasierte Unterordner und Versionierung, Integration mit Webspace/WordPress, Sicherheits- und Zugriffsoptionen, Backup-Strategie und Skalierung auf eigenes Volume
### 15. Git (Gitea) (Kapitel 13)
**Free:** Installation, Repo anlegen
**Premium:** CI-Pipelines, Self-Hosted-Runner, Webhooks
### 16. Wiki (Wiki.js / Outline) (kapitel 14)
**Free:** Grundinstallation, Basis-Nutzung
**Premium:** Rollen-Management, Integration mit Gitea + Nextcloud
### 17. Netdata (Kapitel 15)
**Free:** Grundinstallation, Basis-Dashboard
**Premium:** benutzerdefinierte Dashboards, Benachrichtigungen, externe Hooks
### 18. Paperless-ngx (Kapitel 16)
**Free:** Grundinstallation und Basisscan (**Appetithappen**)
**Premium:** Automatisierte OCR-Workflows, Tagging-Regeln, Nextcloud-Sync
### 19. Postiz (Kapitel 17)
**Free:** Basis-Setup (soweit für private Accounts möglich)
**Premium:** Business-Integrationen (z. B. TikTok-API, erweiterte Planungs-Flows)
### 20. Paywall / Premium (Kapitel 23)
**Free:**
**Premium:** Komplettes Modul für Paid Content, Lizenzhandling, Updates
### 21. Home Assistant (Kapitel 21 - Free Abschluss)
**Free:** Grundinstallation, Basis-Integrationen
**Premium:** IPv6-Fix hinter NPM, erweiterte Automationen, Streaming-Anbindungen
### 22. WAHA (WhatsApp-HTTP-API) (Kapitel 19)
**Free:** Server-Installation, Grundkonfiguration, Verbindung zu WhatsApp-Account
**Premium:** Integration in n8n, Automatische Nachrichten und Status-Updates
### 23. Ollama (lokale KI) (Kapitel 18)
Free: Installation, Basis-Modell laden (Mistral), CLI-Test
Premium: CPU-Optimierung (Threads/Cache/Swap), GPU-Passthrough erklären, Modellverwaltung/Updates
### 24. Tandoor (Rezeptdatenbank) (Kapitel 20)
Free: Installation, Benutzer, Import/Export, SSL über NPM
Premium: erweiterte Rollenverwaltung, Nährwertberechnung, Wochenplan & Einkaufsliste
---
## 4. Produktiver Free-Workflow für n8n
- **Ziel:** Stream-Reminder aus Kalender-Feed + automatischer Social-Post (X / Insta / FB)
- **Status:** geplant, kommt ins Free-Kapitel 11
---
## 5. Nächste Schritte
> Die Phasen entsprechen der Roadmap aus § 2.
> Detaillierter Fortschritt je Kapitel steht in § 8 (To-Do-Liste).
> Fortschrittsbalken werden manuell gepflegt.
### Phase 1 30.09.15.10. **Rohtexte für alle Kapitel (121)**
<progress value="15" max="100"></progress> 32 %
- [x] 30.09. Grundplanung & Roadmap abgeschlossen
- [x] 30.09. PDF-Template & Designrichtlinien (§ 7) fertig
- [x] 30.09. Kapitel-To-Do-Liste (§ 8) angelegt
**Rohtext-Plan (alle Kapitel)**
- [x] 01.10. Kap 1 **Proxmox** (Free + Premium abgeschlossen)
- [x] 02.10. Kap 2 **Pi-hole + Unbound**+Kap 3 **Nginx Proxy Manager**
- [x] 03.10. ~~Kap 4 **DynDNS**~~+Kap 5 **WireGuard**
- [x] 04.10. Kap 6 **Vaultwarden**
- [x] 05.10. Kap 8 **Affine**+Kap 9 **Archiv (Duplicati)**+Kap 10 **Webspace**
- [x] 06.10. Kap 7 **Nextcloud** *(umfangreich → Solo-Tag)*
- [x] 07.10. Kap 11 **n8n (Free-Workflow)**+Kap 12 **RTMP-Server**
- [ ] 08.10. Kap 13 **Clipper** *(umfangreich → Solo-Tag)*
- [x] 09.10. Kap 14 **Backup**+Kap 15 **Git (Gitea)**
- [x] 10.10. Kap 16 **Wiki**+Kap 17 **Netdata**
- [x] 11.10. Kap 18 **Paperless-ngx**+Kap 19 **Postiz**
- [ ] 12.10. Kap 20 **Paywall / Premium-System**+Kap 21 **Home Assistant**
- [ ] 13.15.10. **Reserve / Review / Feinkorrekturen** aller Rohtexte
### Phase 2 16.10.05.11. **Screenshots & Review**
<progress value="0" max="100"></progress> 0 %
- komplettes Debugging durch anlegen und löschen der LXC
- Korrektur der Rohtexte
- Screenshots aller CLI und Dashboards während Installation
### Phase 3 06.11.20.11. **Videoskripte ersstellen**
<progress value="0" max="100"></progress> 0 %
- entwickeln der Videoskripte
### Phase 4 21.11.30.11. **Aufnahme Kapitel 1 - 5**
<progress value="0" max="100"></progress> 0 %
- [ ] Aufnahme Kapitel 1
- [ ] Aufnahme Kapitel 2
- [ ] Aufnahme Kapitel 3
- [ ] Aufnahme Kapitel 4
- [ ] Aufnahme Kapitel 5
### Phase 5 01.12.15.12. **Aufnahme Kapitel 6 - 15*
<progress value="0" max="100"></progress> 0 %
- [ ] Aufnahme Kapitel 6
- [ ] Aufnahme Kapitel 7
- [ ] Aufnahme Kapitel 8
- [ ] Aufnahme Kapitel 9
- [ ] Aufnahme Kapitel 10
- [ ] Aufnahme Kapitel 11
- [ ] Aufnahme Kapitel 12
- [ ] Aufnahme Kapitel 13
- [ ] Aufnahme Kapitel 14
- [ ] Aufnahme Kapitel 15
### Phase 6 16.12.31.12. **Aufnahme Kapitel 16 - 21**
<progress value="0" max="100"></progress> 0 %
- [ ] Aufnahme Kapitel 16
- [ ] Aufnahme Kapitel 17
- [ ] Aufnahme Kapitel 18
- [ ] Aufnahme Kapitel 19
- [ ] Aufnahme Kapitel 20
- ~~[ ] Aufnahme Kapitel 21~~ Ehemals Kapitel 4 verschiebt nach oben
---
## 6. PDF-Designrichtlinien (Branding)
### Farbpalette
- **Primär-Violett:** `#8573FB` → Haupttitel
- **Dunkelblau:** `#183EFA` → Kapitel-Überschriften
- **Cyan:** `#64D4E8` → Tipp-Boxen (💡)
- **Orange:** `#F78212` → Warn-Box-Hintergrund (⚠️)
- **Rot für Warn-Umrandung:** `#D32F2F` → 2-px-Rahmen um Warn-Box
- **Hellgrau:** `#F5F5F5` → Code-Hintergrund
- **Textfarbe:** Schwarz `#000000`, Fußzeilen Grau
### Schriftarten
- **Titel / Überschriften:** Calibri Bold (ersatzweise Helvetica-Bold)
- **Fließtext:** Calibri Regular, 11 pt
- **Codeblöcke:** Courier New, 10 pt, Hintergrund hellgrau
- **Fußzeile:** Calibri Italic, grau
### Layout
- Seitenränder: 2 cm
- Titelseite: Großtitel + Kapitelinfo + Free/Premium-Label + Version + optional Logo
- Seitenfuß: Kapitel-Nr | Seite X/Y | © Bratonien Tech
- **Tipp-Box:** Hintergrund Cyan #64D4E8, weiße Schrift, Icon 💡
- **Warn-Box:** Hintergrund Orange #F78212, weiße Schrift, **rote Umrandung #D32F2F (2 px)**, Icon ⚠️
- Codeblöcke: Monospace, Hintergrund hellgrau #F5F5F5
### Struktur pro Kapitel-PDF
1. Titelseite
2. Inhaltsübersicht
3. Einleitung & Ziel
4. Voraussetzungen & Ressourcen
5. Schritt-für-Schritt-Anleitung (Codeblöcke + Screenshots)
6. Troubleshooting & Tipps
7. Zusammenfassung & Nächste Schritte
8. Optional: Changelog
---
## 7. To-Do-Liste Kapitelstatus
| Kapitel (alt) | Free/Premium | Premium-Inhalte (Beispiele) | Rohtext | CLI-Shots | GUI-Shots | PDF-fertig | Getestet |
|---------|--------------|----------------------------|---------|-----------|-----------|------------|----------|
| 1. Proxmox | Free + Premium | LXC-Optimierung, Auto-Backup-Script | ☑ | ☐ | ☐ | ☐ | ☐ |
| 2. Pi-hole + Unbound | Free + Premium | erweiterte Blocklists, DNS-Monitoring | ☑ | ☐ | ☐ | ☐ | ☐ |
| 3. Nginx Proxy Manager | Free + Premium | Hardening-Rules, erweiterte SSL-Konfiguration | ☑ | ☐ | ☐ | ☐ | ☐ |
| ~~4. DynDNS~~ | ~~Free + Premium~~ | ~~Mehr-Domain-Setup, automatisierte Failover-Updates~~ | ~~☐~~ | ~~☐~~ | ~~☐~~ | ~~☐~~ | ~~☐~~ |
| 5. WireGuard | Free + Premium | Multi-Client-Setup, Traffic-Split, Failover-Skripte | ☑ | ☐ | ☐ | ☐ | ☐ |
| 6. Vaultwarden | Free + Premium | 2FA-Integration, automatisches Backup der Secrets | ☑ | ☐ | ☐ | ☐ | ☐ |
| 7. Nextcloud | Free + Premium | optimierte **php.ini/www.conf**, Cron-Jobs, SFTP-Flows | ☑ | ☐ | ☐ | ☐ | ☐ |
| 8. Affine | Free + Premium | erweiterte Collaboration-Vorlagen | ☑ | ☐ | ☐ | ☐ | ☐ |
| 9. Archiv (Duplicati) | Free + Premium | automatisches Archiv-Cleanup, Langzeit-Backup | ☑ | ☐ | ☐ | ☐ | ☐ |
|10. Webspace | Free + Premium | Multi-Site-Hosting, CDN-Integration | ☑ | ☐ | ☐ | ☐ | ☐ |
|11. n8n | Free + Premium | produktiver Workflow **(Social-Post-Flow)**, weitere Nodes| ☑ | ☐ | ☐ | ☐ | ☐ |
|12. RTMP-Server (OME) | Free + Premium | Auto-Failover, Mehr-Stream-Ziele | ☑| ☐ | ☐ | ☐ | ☐ |
|13. Clipper | **Premium only**| kompletter VOD-Workflow inkl. Whisper-Integration | ☑ | ☐ | ☐ | ☐ | ☐ |
|14. Asset-LXC | Free + Premium | Caching- und Komprimierungs­optionen, projektbasierte Ordnerstruktur, Integration mit Webspace/WordPress, Backup-Strategie, Skalierung auf eigenes Volume | ☑ | ☐ | ☐ | ☐ | ☐ |
|15. Git (Gitea) | Free + Premium | CI-Hooks, Deployment-Keys | ☑ | ☐ | ☐ | ☐ | ☐ |
|16. Wiki | Free + Premium | ACL-Steuerung, Premium-Vorlagen | ☑ | ☐ | ☐ | ☐ | ☐ |
|17. Netdata | Free + Premium | Alarmierungs-Flows, erweiterte Dashboards | ☑ | ☐ | ☐ | ☐ | ☐ |
|18. Paperless-ngx | Free + Premium | OCR-Optimierung, Tagging-Vorlagen | ☑ | ☐ | ☐ | ☐ | ☐ |
|19. Postiz | Free + Premium | Premium-Integrationen (TikTok u. Co.) | ☑ | ☐ | ☐ | ☐ | ☐ |
|20. Paywall / Premium-Sys | **Premium only**| Bezahlschranke, API-Keys, Token-Verwaltung | ☐ | ☐ | ☐ | ☐ | ☐ |
|21. Home Assistant | Free + Premium | erweiterte Automationen, Integration mit NC/n8n | ☐ | ☐ | ☐ | ☐ | ☐ |
|22. WAHA (WhatsApp-HTTP-API) | Free + Premium | Installation des WAHA-Servers, Node-Integration in n8n, Verbindung zu WhatsApp-Konten | ☑ | ☐ | ☐ | ☐ | ☐ |
| 23. Ollama | Free + Premium | CPU-Optimierung, GPU-Passthrough, Modellverwaltung | ☐ | ☐ | ☐ | ☐ | ☐ |
| 24. Tandoor | Free + Premium | Rollenverwaltung, Nährwertberechnung, Wochenplan & Einkauf | ☐ | ☐ | ☐ | ☐ | ☐ |
## 8. Monetarisierung & Preisstrategie
- **Normalpreis Komplettpaket Premium (21 Kapitel inkl. Videos):** 59,99 €
- **Gesamtwert bei Einzelkauf:** ca. 270 €
### Einzelpreise
- Premium-Kapitel (Text): 4,95 €
- Premium-Video-Kapitel: 7,95 €
### Bundle-Strategie
- Komplettpaket zu 59,99 € als Standardangebot
- Vorteilspreis wird durch die hohe Einzel-Summe (ca. 270 €) unterstrichen
### Rabattaktionen
- **Community-Code (15 % Rabatt):** 50,99 €
- Einsatz z. B. in Streams, Discord oder Newsletter
- Signalisiert Wertschätzung für aktive Community-Mitglieder
- **Special Events (20 % Rabatt):** 47,99 €
- Weihnachten, Ostern, Black Friday oder besondere Anlässe
- Starker psychologischer Anker „unter 50 €“
### Kommunikation
- Stets den Gesamtwert von ca. 270 € betonen
- Rabattaktionen zeitlich begrenzen, um Exklusivität zu unterstreichen
- Free/Premium klar trennen, damit der Mehrwert des Premium-Pakets deutlich sichtbar bleibt
## 9. Ergänzung: Disaster-Recovery-Kapitel (geplant)
**Zweck:**
Disaster Recovery wird als **eigenes Premium-Plus-Kapitel** ins Gesamttutorial aufgenommen.
Es richtet sich an Anwender, die das UCC-System exakt nach unseren Kapiteln aufgebaut haben und wissen möchten,
wie sie ihr komplettes System nach einer schweren Störung (z. B. defekter Host, Datenverlust, Totalcrash) wiederherstellen können.
**Abgrenzung zu Kapitel 8 (Duplicati-Backup):**
Kapitel 8 beschreibt das **Sichern und Wiederherstellen einzelner Daten und Projekte**.
Disaster Recovery geht weiter: Es zeigt die **komplette Wiederherstellung der gesamten UCC-Infrastruktur**, inklusive
Proxmox-Host
LXC-Container und deren Konfiguration
Netzwerk- und Proxy-Einstellungen
Duplicati-Backups als Datenquelle für die Container
**Ziel:**
Schritt-für-Schritt-Anleitung, wie ein Creator nach einem Totalausfall mit vorhandenen Backups und minimalem Aufwand wieder arbeitsfähig wird.
**Status:**
Wird erst nach Abschluss aller regulären Kapitel erstellt
Nur für das **Komplettpaket** vorgesehen (Free/Premium-Kapitel allein reichen nicht)
Geplante Inhalte:
1. Vollständige Systemsicherung (Proxmox + Container)
2. Vorbereitung eines Recovery-Mediums (z. B. USB-Stick oder zweite Festplatte)
3. Neuinstallation des Hosts und Import der Container
4. Einspielen der Duplicati-Daten in die jeweiligen Anwendungen
5. Testlauf: Validierung der wiederhergestellten Umgebung
[!NOTE]
Das Disaster-Recovery-Kapitel ist ein **Verkaufsargument für das Komplettpaket** und wird nicht einzeln angeboten.