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.
Eine ausführlichere Projektübersicht mit Screenshots gibt es in docs/PROJECT_OVERVIEW.md.
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
/workflowsmit backend-definierten Nodes und Settings-Schemas
Architektur
- Frontend: React, TypeScript, Vite
- Backend: FastAPI, SQLAlchemy, Alembic, Celery
- Infrastruktur: PostgreSQL, Redis, MinIO, Docker Compose
- Rendering: Blender Worker mit GPU-Support
Quick Start
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
Nützliche Betriebsbefehle
./scripts/restart.sh
./scripts/restart.sh --build
./scripts/restart.sh backend
./scripts/stop.sh
docker compose logs -f
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:
- 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.
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 hier dokumentiert:
- docs/workflows/WORKFLOW_MIGRATION_PLAN.md
- docs/workflows/NODE_BASED_PRODUCTION_ARCHITECTURE.md
- docs/workflows/WORKFLOW_IMPLEMENTATION_BACKLOG.md
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



