HartOMat/docs/PROJECT_OVERVIEW.md

HartOMat Project Overview

Überblick

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.

Was das System heute abdeckt

• STEP/CAD-Import mit nachgelagerter Aufbereitung
• Produkt-, Medien-, Order- und Admin-Oberflächen
• Render Templates für definierte Licht- und Kamera-Setups
• Output Types als steuerbare Produktionsprofile
• Graph-basierter Workflow-Editor mit Legacy-Kompatibilität
• Worker-basierte Renderausführung mit Docker, Celery und Blender

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:

• CAD-Import und Dateiauflösung
• Geometrie- und GLB-Aufbereitung
• Materialzuordnung und Auto-Population
• Template-Auflösung
• Blender-Rendering
• Ergebnis-Persistierung und Benachrichtigung

Der Legacy-Weg bleibt dabei als Sicherheitsnetz parallel aktiv.

Weiterführende Architektur- und Migrationsdokumente:

• WORKFLOW_MIGRATION_PLAN.md
• NODE_BASED_PRODUCTION_ARCHITECTURE.md
• WORKFLOW_IMPLEMENTATION_BACKLOG.md

HowTo

1. Umgebung starten

Alle Kommandos werden vom Repo-Root aus ausgeführt.

cp .env.example .env
./scripts/start.sh

Danach sind standardmäßig erreichbar:

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

2. Mit lokalem Admin anmelden

Der Backend-Startprozess führt Migrationen und Seeds aus. Für lokale Entwicklungsumgebungen ist standardmäßig ein Admin-Benutzer vorhanden:

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

3. Zentrale Bereiche im UI

• / zeigt Dashboard, KPIs und den operativen Einstieg
• /products und einzelne Produktseiten bündeln Medien, Vorschauen und Produktdaten
• /admin verwaltet Output Types, Render Templates, Asset Libraries und Systemeinstellungen
• /workflows ist die Arbeitsfläche für Legacy-kompatible Graph-Workflows

4. Stack steuern

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

Screenshots

Dashboard

Das Dashboard ist der operative Einstieg in Produkte, Aufträge, KPIs und offene Prozessschritte.

Workflow Editor

Der Workflow-Editor ist die Zieloberfläche für die modulare Produktionskette. Hier werden Legacy-Bridge-Nodes und graph-native Nodes zusammengeführt.

Product Detail

Auf der Produktdetailseite laufen Geometrie, Medien, Materialzuordnung, Vorschau und Folgeaktionen zusammen.

Admin

Die Admin-Oberfläche bündelt die Konfiguration von Render Templates, Output Types, Asset Libraries und Systemparametern.

Betriebsnotizen

• Docker Compose nutzt den Stack-Namen hartomat.
• Der Backend-Container führt beim Start Migrationen und Seeds aus.
• GPU-Rendering ist auf den Blender-Worker ausgelegt und erwartet funktionierende Host-/Docker-GPU-Weitergabe.
• Für tiefergehende Workflow- und Paritätsarbeit liegen zusätzliche Dokumente unter docs/workflows/.