docs: add project overview with quickstart and screenshots

2026-04-12 11:56:41 +02:00
parent 3e810c74a3
commit 10fcb2817b
6 changed files with 207 additions and 0 deletions
@@ -0,0 +1,99 @@
+# 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](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 `/workflows` mit 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
+
+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`
+
+### 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
+
+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
+
+![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)
+
+## 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/WORKFLOW_MIGRATION_PLAN.md)
+- [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)
+
+## 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
+```