diff --git a/README.md b/README.md index a4fa65a..133db31 100644 --- a/README.md +++ b/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 diff --git a/docs/PROJECT_OVERVIEW.md b/docs/PROJECT_OVERVIEW.md index 5d92389..538f65a 100644 --- a/docs/PROJECT_OVERVIEW.md +++ b/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 diff --git a/docs/assets/screenshots/admin.png b/docs/assets/screenshots/admin.png index e6b1ed7..5e9e2bf 100644 Binary files a/docs/assets/screenshots/admin.png and b/docs/assets/screenshots/admin.png differ diff --git a/docs/assets/screenshots/dashboard.png b/docs/assets/screenshots/dashboard.png index d67c77f..3ed5648 100644 Binary files a/docs/assets/screenshots/dashboard.png and b/docs/assets/screenshots/dashboard.png differ diff --git a/docs/assets/screenshots/product-detail.png b/docs/assets/screenshots/product-detail.png index 6b5a4f3..7a4f8e3 100644 Binary files a/docs/assets/screenshots/product-detail.png and b/docs/assets/screenshots/product-detail.png differ diff --git a/docs/assets/screenshots/workflow-editor.png b/docs/assets/screenshots/workflow-editor.png index ab10319..086f4df 100644 Binary files a/docs/assets/screenshots/workflow-editor.png and b/docs/assets/screenshots/workflow-editor.png differ