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.

CAD rein, Produktdaten anreichern, Output-Typ wählen, Rendern ausführen, Ergebnis kontrollieren.

Start Hier

Thema	Einstieg
Projektüberblick	docs/PROJECT_OVERVIEW.md
Workflows	docs/workflows/WORKFLOW_MIGRATION_PLAN.md
Architekturziel	docs/workflows/NODE_BASED_PRODUCTION_ARCHITECTURE.md
Umsetzungs-Backlog	docs/workflows/WORKFLOW_IMPLEMENTATION_BACKLOG.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
Verwaltung von Produkten, Medien, Asset Libraries, Output Types, Pricing Tiers und Orders
Blender-basierte Render-Pipeline mit Template-Unterstützung und GPU-Rendering
Legacy-kompatible Produktionspfade parallel zu graph-basierten Workflows
Workflow-Editor unter /workflows mit backend-definierten Nodes und Settings-Schemas

Stack

Ebene	Technologie
Frontend	React, TypeScript, Vite
Backend	FastAPI, SQLAlchemy, Alembic, Celery
Infrastruktur	PostgreSQL, Redis, MinIO, Docker Compose
Rendering	Blender Worker mit GPU-Support

Quick Start

Betriebsstatus

Compose-Projektname: hartomat
Frontend lokal: http://localhost:5173
Backend lokal: http://localhost:8888/docs
MinIO Console: http://localhost:9001

Voraussetzungen

Docker und Docker Compose
Optional für GPU-Rendering: NVIDIA-Treiber und funktionierende Docker-GPU-Weitergabe

Lokaler Start

Konfiguration anlegen:

cp .env.example .env

Stack starten:

./scripts/start.sh

Oberflächen öffnen:

Frontend: http://localhost:5173
Backend API / Swagger: http://localhost:8888/docs
MinIO Console: http://localhost:9001

Beim Container-Start werden Migrationen, Templates und ein Admin-Benutzer gesät. Für eine lokale Standardinstallation ist aktuell typischerweise verfügbar:

E-Mail: admin@hartomat.com
Passwort: Admin1234!

Das ist nur für lokale Entwicklung gedacht und sollte für jede nicht-lokale Umgebung sofort ersetzt werden.

Nützliche Kommandos

./scripts/restart.sh
./scripts/restart.sh --build
./scripts/restart.sh backend
./scripts/stop.sh
docker compose logs -f

Screenshots

Workflow-System

HartOMat führt zwei Welten parallel:

den bestehenden Legacy-Produktionspfad für sichere Rückwärtskompatibilität
den neuen node-basierten Graph-Workflow für modulare, editorfähige Produktionsketten

Die laufende Migrations- und Architekturarbeit ist über die Start-Hier-Links oben erreichbar.

Typischer Ablauf

CAD- oder Mediendaten importieren.
Produkt- und Materialdaten prüfen oder anreichern.
Output Type und Render Template wählen.
Legacy- oder Graph-Workflow ausführen.
Ergebnis im Produkt, Auftrag oder Medienbereich prüfen.

Projektstruktur

backend/         FastAPI-App, Domänenlogik, Migrationen, Worker
frontend/        React/Vite-Frontend
render-worker/   Blender- und Render-spezifische Laufzeit
scripts/         Start-, Restart-, Vergleichs- und QA-Skripte
docs/            Architektur-, Migrations- und Projektdokumentation

README.md

HartOMat