144 lines
4.7 KiB
Markdown
144 lines
4.7 KiB
Markdown
# HartOMat
|
|
|
|
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).
|
|
|
|
> CAD rein, Produktdaten anreichern, Output-Typ wählen, Rendern ausführen, Ergebnis kontrollieren.
|
|
|
|
## Start Hier
|
|
|
|
| Thema | Einstieg |
|
|
| --- | --- |
|
|
| Projektüberblick | [docs/PROJECT_OVERVIEW.md](docs/PROJECT_OVERVIEW.md) |
|
|
| Workflows | [docs/workflows/WORKFLOW_MIGRATION_PLAN.md](docs/workflows/WORKFLOW_MIGRATION_PLAN.md) |
|
|
| Architekturziel | [docs/workflows/NODE_BASED_PRODUCTION_ARCHITECTURE.md](docs/workflows/NODE_BASED_PRODUCTION_ARCHITECTURE.md) |
|
|
| Umsetzungs-Backlog | [docs/workflows/WORKFLOW_IMPLEMENTATION_BACKLOG.md](docs/workflows/WORKFLOW_IMPLEMENTATION_BACKLOG.md) |
|
|
|
|
## Inhaltsverzeichnis
|
|
|
|
- [Kurzüberblick](#kurzüberblick)
|
|
- [Kernfunktionen](#kernfunktionen)
|
|
- [Stack](#stack)
|
|
- [Quick Start](#quick-start)
|
|
- [Screenshots](#screenshots)
|
|
- [Workflow-System](#workflow-system)
|
|
- [Typischer Ablauf](#typischer-ablauf)
|
|
- [Projektstruktur](#projektstruktur)
|
|
|
|
## 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
|
|
|
|
1. Konfiguration anlegen:
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
|
|
2. Stack starten:
|
|
|
|
```bash
|
|
./scripts/start.sh
|
|
```
|
|
|
|
3. Oberflächen öffnen:
|
|
|
|
- Frontend: `http://localhost:5173`
|
|
- Backend API / Swagger: `http://localhost:8888/docs`
|
|
- MinIO Console: `http://localhost:9001`
|
|
|
|
### 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.
|
|
|
|
### Nützliche Kommandos
|
|
|
|
```bash
|
|
./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
|
|
|
|
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
|
|
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
|
|
```
|