Enterprise Engineering Handbook 2025
Zukunftssichere Entwicklung auf CachyOS – Von Prompts bis Production
Kurzbeschreibung:
Dieses Engineering-Handbook ist ein professionelles System zur Automation und Standardisierung deiner Entwicklungs-Workflows auf CachyOS (Arch-basiert). Es kombiniert:
✅ Universelle Header-Schema – Jeder Prompt folgt einheitlichen Sicherheitsstandards
✅ Backup-Integration – Automatische Sicherung vor jeder Änderung (mit Zeitstempel)
✅ Local-First Philosophie – Keine Cloud-Abhängigkeiten, maximale Kontrolle
✅ Wayland-ready (2025) – Optimiert für moderne Linux-Infrastruktur
✅ Prompt-Bibliothek – Spezialisierte KI-Befehle für Photon, Docker, WordPress, PHP & Bash
🎯 Wichtige Hinweise (Best Practices)
1. System-Anforderungen
- OS: CachyOS (Arch Linux x86_64 v3)
- Shell: Fish (Standard), mit Bash-Fallback
- Tools: wl-clipboard (Wayland), git, docker, docker-compose, python 3.10+
- Editor: micro oder nano (CachyOS-Standard)
2. Die 5-Säulen des Handbuchs
| Säule | Fokus | Alias | Datei |
|---|---|---|---|
| Python/Generisch | venv & Arch-Optimierung | tpai | HEIKO_GENERIC_PYTHON.md |
| Photon + Docker | Framework + Isolation | tpph | HEIKO_PHOTON_DOCKER.md |
| Photon (lokal) | venv ohne Container | tppv | HEIKO_PHOTON_VENV_PROMPT.md |
| Bash-Automation | Skripte & Systemtools | tpbs | HEIKO_BASH_PROMPT.md |
| WordPress | Sicherheit & Performance | tpwp | HEIKO_WORDPRESS_PROMPT.md |
3. Sicherheits-Standard (Immer!)
Bevor die KI handelt, muss sie prüfen:
# 1. Backup anlegen (mit Zeitstempel)
cp <datei> <datei>.backup_$(date +%Y%m%d_%H%M%S)
# 2. Bestehende Dateien erweitern (nicht überschreiben)
# 3. Umgebung prüfen (CachyOS/Docker/venv)
# 4. Cleanup nach Erfolg
4. Shell-Setup (Fish + Bash Hybrid)
Aktuelle Konfiguration:
- Primär: Fish (Autovervollständigung mit STRG + R + fzf)
- Fallback: Bash (für POSIX-Kompatibilität)
- Integration:
.bash_aliaseswerden von Fish gelesen
Alias-Beispiel:
abbr -a tpph "cat ~/scripts/tools/PROMTS/HEIKO_PHOTON_DOCKER.md | wl-copy && echo '✅ Wayland-Copy: Ready!'"
5. Wayland-Standard (2025)
⚠️ Kritisch: Nutze wl-copy statt xclip
# Universelle Lösung (Wayland + X11)
function tp_copy() {
if [ "$XDG_SESSION_TYPE" = "wayland" ]; then
cat "$1" | wl-copy
else
cat "$1" | xclip -selection clipboard
fi
}
📂 Verzeichnisstruktur (Production-Ready)
rubykopierenherunterladen~/scripts/tools/PROMTS/
├── README.md # Index aller Prompts
├── HEIKO_GENERIC_PYTHON.md # Python-Standard
├── HEIKO_PHOTON_DOCKER.md # Photon + Docker
├── HEIKO_PHOTON_VENV_PROMPT.md # Photon (lokal)
├── HEIKO_BASH_PROMPT.md # Bash-Automation
├── HEIKO_WORDPRESS_PROMPT.md # WordPress-Sicherheit
└── .backups/ # Versionskontrolle
🔧 Workflow (Quickstart)
Scenario 1: Neues Photon-Projekt
# 1. Prompt kopieren
tpph
# 2. In ChatGPT/Claude einfügen (STRG + V)
# 3. KI macht die Arbeit (mit automatischen Backups)
# 4. Ergebnis: docker-compose up --build
Scenario 2: WordPress-Sicherheitsaudit
tpwp
# → Erhältst sofort alle relevanten Sicherheits-Checklisten
Scenario 3: Bash-Skript erweitern
tpbs
# → KI weiß sofort: CachyOS-Arch, Bash POSIX, Backup-Regeln
✅ Checkliste für neue Projekte
- Header-Schema kopiert (META_INFO + SYSTEM-DIREKTIVE)
- Backup angelegt:
*.backup_$(date +%Y%m%d_%H%M%S) - CachyOS/Wayland-Umgebung verifiziert
-
.gitignorefürvenv/,__pycache__,.enverstellt - Git-Repo initialisiert (lokal, Remote-Push optional)
- Docker-Kompose getestet (falls benötigt)
- Temporäre Dateien gelöscht (Cleanup)
🚨 Häufige Fehler (Vermeiden!)
| Fehler | Lösung |
|---|---|
| xclip funktioniert nicht | sudo pacman -Rs xclip && sudo pacman -S wl-clipboard |
| Aliase nicht sichtbar | source ~/.bash_aliases oder Terminal neustarten |
| Fish vs. Bash Inkompatibilität | Nutze bash -c 'befehl' für kritische Skripte |
| Docker: Permission denied | sudo usermod -aG docker $USER + Logout/Login |
| Fehlende Backups | IMMER vor Änderungen: cp datei datei.backup_$(date +%Y%m%d_%H%M%S) |
📚 Ressourcen & Links
- CachyOS Wiki: https://wiki.cachyos.org/
- Arch Linux Wiki: https://wiki.archlinux.org/
- Fish Shell Docs: https://fishshell.com/docs/
- Docker Compose: https://docs.docker.com/compose/
- GitHub (Tuxplayers): https://github.com/Tuxplayers/
👤 Autor & Support
Heiko Schäfer (TUXPLAYER)
- 📧 Email:
contact@tuxplayer - 🌐 Website: https://tuxhs.de/
- 💻 GitHub: https://github.com/Tuxplayers/
- 📅 Handbook Version: 2025.12-ZUKUNFTSSICHER