docs: refine project presentation and refresh dark screenshots

README.md

@@ -1,9 +1,18 @@
 # HartOMat
 
-HartOMat ist eine CAD-, Medien- und Render-Automatisierungsplattform für technische Produktbilder. Das System kombiniert STEP/CAD-Import, Materialzuordnung, Produkt- und Asset-Verwaltung, Pricing/Output-Typen, Blender-Render-Templates und einen node-basierten Workflow-Editor, ohne den bestehenden Legacy-Produktionspfad zu brechen.
+HartOMat ist eine CAD-, Medien- und Render-Automatisierungsplattform für technische Produktvisualisierung. Das System verbindet STEP/CAD-Import, Materialzuordnung, Produkt- und Asset-Verwaltung, Render-Templates, Output-Typen und einen node-basierten Workflow-Editor in einer gemeinsamen Produktionsoberfläche, ohne den bestehenden Legacy-Pfad zu verlieren.
 
 Eine ausführlichere Projektübersicht mit Screenshots gibt es in [docs/PROJECT_OVERVIEW.md](docs/PROJECT_OVERVIEW.md).
 
+## Kurzüberblick
+
+| Bereich | Zweck |
+| --- | --- |
+| CAD Intake | STEP-Dateien importieren, aufbereiten und in produktionsfähige Assets überführen |
+| Product Ops | Produkte, Medien, Orders, Asset Libraries und Pricing zentral verwalten |
+| Rendering | Blender-Templates, GPU-Worker und definierte Output Types für reproduzierbare Bilder |
+| Workflows | Legacy-sichere und graph-native Produktionsketten parallel betreiben |
+
 ## Kernfunktionen
 
 - Import von CAD- und Mediendaten mit nachgelagerter Material- und Metadatenverarbeitung
@@ -19,6 +28,16 @@ Eine ausführlichere Projektübersicht mit Screenshots gibt es in [docs/PROJECT_
 - Infrastruktur: PostgreSQL, Redis, MinIO, Docker Compose
 - Rendering: Blender Worker mit GPU-Support
 
+## Screenshots
+
+![Dashboard](docs/assets/screenshots/dashboard.png)
+
+![Workflow Editor](docs/assets/screenshots/workflow-editor.png)
+
+![Product Detail](docs/assets/screenshots/product-detail.png)
+
+![Admin](docs/assets/screenshots/admin.png)
+
 ## Quick Start
 
 ### Voraussetzungen
@@ -46,17 +65,7 @@ cp .env.example .env
 - Backend API / Swagger: `http://localhost:8888/docs`
 - MinIO Console: `http://localhost:9001`
 
-### Nützliche Betriebsbefehle
-
-```bash
-./scripts/restart.sh
-./scripts/restart.sh --build
-./scripts/restart.sh backend
-./scripts/stop.sh
-docker compose logs -f
-```
-
-## Standard-Login für lokale Seeds
+### Standard-Login für lokale Seeds
 
 Beim Container-Start werden Migrationen, Templates und ein Admin-Benutzer gesät. Für eine lokale Standardinstallation ist aktuell typischerweise verfügbar:
 
@@ -65,15 +74,15 @@ Beim Container-Start werden Migrationen, Templates und ein Admin-Benutzer gesät
 
 Das ist nur für lokale Entwicklung gedacht und sollte für jede nicht-lokale Umgebung sofort ersetzt werden.
 
-## Screenshots
+### Nützliche Kommandos
 
-![Dashboard](docs/assets/screenshots/dashboard.png)
-
-![Workflow Editor](docs/assets/screenshots/workflow-editor.png)
-
-![Product Detail](docs/assets/screenshots/product-detail.png)
-
-![Admin](docs/assets/screenshots/admin.png)
+```bash
+./scripts/restart.sh
+./scripts/restart.sh --build
+./scripts/restart.sh backend
+./scripts/stop.sh
+docker compose logs -f
+```
 
 ## Workflow-System
 
@@ -88,6 +97,14 @@ Die laufende Migrations- und Architekturarbeit ist hier dokumentiert:
 - [docs/workflows/NODE_BASED_PRODUCTION_ARCHITECTURE.md](docs/workflows/NODE_BASED_PRODUCTION_ARCHITECTURE.md)
 - [docs/workflows/WORKFLOW_IMPLEMENTATION_BACKLOG.md](docs/workflows/WORKFLOW_IMPLEMENTATION_BACKLOG.md)
 
+## Typischer Ablauf
+
+1. CAD- oder Mediendaten importieren.
+2. Produkt- und Materialdaten prüfen oder anreichern.
+3. Output Type und Render Template wählen.
+4. Legacy- oder Graph-Workflow ausführen.
+5. Ergebnis im Produkt, Auftrag oder Medienbereich prüfen.
+
 ## Projektstruktur
 
 ```text

docs/PROJECT_OVERVIEW.md

@@ -4,6 +4,10 @@
 
 HartOMat ist eine Produktionsplattform für technische Visualisierung. Die Anwendung verbindet CAD-Import, Datenaufbereitung, Material-Mapping, Produkt- und Asset-Verwaltung sowie eine Blender-basierte Render-Pipeline in einer gemeinsamen Oberfläche. Parallel dazu wird die Render-Orchestrierung von einem Legacy-Workflow auf ein node-basiertes Produktionsmodell migriert, ohne dass der bisherige Produktionsweg ausfallen darf.
 
+## Positionierung
+
+HartOMat ist kein isolierter Renderer, sondern die operative Schicht zwischen technischen Quelldaten und reproduzierbarer Medienproduktion. Das Projekt ist darauf ausgelegt, CAD-Assets, kommerzielle Output-Varianten, Template-Logik und Worker-Ausführung in einem System zusammenzuhalten.
+
 ## Was das System heute abdeckt
 
 - STEP/CAD-Import mit nachgelagerter Aufbereitung
@@ -13,6 +17,13 @@ HartOMat ist eine Produktionsplattform für technische Visualisierung. Die Anwen
 - Graph-basierter Workflow-Editor mit Legacy-Kompatibilität
 - Worker-basierte Renderausführung mit Docker, Celery und Blender
 
+## Zielnutzen
+
+- Weniger manuelle Übergaben zwischen CAD, Medienproduktion und Admin
+- Reproduzierbare Render-Ergebnisse durch Templates und definierte Output Types
+- Sichere Migration in Richtung node-basierter Produktion ohne Abschalten des Bestandssystems
+- Klare Trennung zwischen operativen Profilen, Workflow-Definitionen und Render-Modulen
+
 ## Laufende Architekturidee
 
 Das Zielbild ist eine modulare Produktionskette, in der einzelne Prozessschritte als wiederverwendbare Backend-Module im Workflow-Editor verfügbar sind. Dazu gehören insbesondere:
@@ -63,7 +74,15 @@ Der Backend-Startprozess führt Migrationen und Seeds aus. Für lokale Entwicklu
 - `/admin` verwaltet Output Types, Render Templates, Asset Libraries und Systemeinstellungen
 - `/workflows` ist die Arbeitsfläche für Legacy-kompatible Graph-Workflows
 
-### 4. Stack steuern
+### 4. Typischer Produktionsfluss
+
+1. CAD-Datei oder Medienquelle hochladen.
+2. Produktdaten, Materialzuordnung und Bibliotheken prüfen.
+3. Render Template und Output Type auswählen.
+4. Produktion über Legacy- oder Graph-Workflow starten.
+5. Ergebnisse im Produkt, Auftrag oder Medienkontext kontrollieren.
+
+### 5. Stack steuern
 
 ```bash
 ./scripts/restart.sh
@@ -80,13 +99,13 @@ docker compose logs -f
 
 ![HartOMat Dashboard](assets/screenshots/dashboard.png)
 
-Das Dashboard ist der operative Einstieg in Produkte, Aufträge, KPIs und offene Prozessschritte.
+Das Dashboard ist der operative Einstieg in Produkte, Aufträge, KPIs und offene Prozessschritte. Für die Projektdokumentation werden hier Dark-Theme-Screenshots aus der laufenden lokalen Instanz verwendet.
 
 ### Workflow Editor
 
 ![HartOMat Workflow Editor](assets/screenshots/workflow-editor.png)
 
-Der Workflow-Editor ist die Zieloberfläche für die modulare Produktionskette. Hier werden Legacy-Bridge-Nodes und graph-native Nodes zusammengeführt.
+Der Workflow-Editor ist die Zieloberfläche für die modulare Produktionskette. Hier werden Legacy-Bridge-Nodes, Referenzpfade und graph-native Nodes zusammengeführt.
 
 ### Product Detail