docs: optimize readme landing layout for gitea

This commit is contained in:
2026-04-12 14:44:13 +02:00
parent 04a08a8bdf
commit 9f1ccec8f0
+47 -20
View File
@@ -4,6 +4,28 @@ HartOMat ist eine CAD-, Medien- und Render-Automatisierungsplattform für techni
Eine ausführlichere Projektübersicht mit Screenshots gibt es in [docs/PROJECT_OVERVIEW.md](docs/PROJECT_OVERVIEW.md). 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 ## Kurzüberblick
| Bereich | Zweck | | Bereich | Zweck |
@@ -21,25 +43,24 @@ Eine ausführlichere Projektübersicht mit Screenshots gibt es in [docs/PROJECT_
- Legacy-kompatible Produktionspfade parallel zu graph-basierten Workflows - Legacy-kompatible Produktionspfade parallel zu graph-basierten Workflows
- Workflow-Editor unter `/workflows` mit backend-definierten Nodes und Settings-Schemas - Workflow-Editor unter `/workflows` mit backend-definierten Nodes und Settings-Schemas
## Architektur ## Stack
- Frontend: React, TypeScript, Vite | Ebene | Technologie |
- Backend: FastAPI, SQLAlchemy, Alembic, Celery | --- | --- |
- Infrastruktur: PostgreSQL, Redis, MinIO, Docker Compose | Frontend | React, TypeScript, Vite |
- Rendering: Blender Worker mit GPU-Support | Backend | FastAPI, SQLAlchemy, Alembic, Celery |
| Infrastruktur | PostgreSQL, Redis, MinIO, Docker Compose |
## Screenshots | Rendering | Blender Worker mit GPU-Support |
![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)
## Quick Start ## Quick Start
### Betriebsstatus
- Compose-Projektname: `hartomat`
- Frontend lokal: `http://localhost:5173`
- Backend lokal: `http://localhost:8888/docs`
- MinIO Console: `http://localhost:9001`
### Voraussetzungen ### Voraussetzungen
- Docker und Docker Compose - Docker und Docker Compose
@@ -84,6 +105,16 @@ Das ist nur für lokale Entwicklung gedacht und sollte für jede nicht-lokale Um
docker compose logs -f docker compose logs -f
``` ```
## 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 ## Workflow-System
HartOMat führt zwei Welten parallel: HartOMat führt zwei Welten parallel:
@@ -91,11 +122,7 @@ HartOMat führt zwei Welten parallel:
- den bestehenden Legacy-Produktionspfad für sichere Rückwärtskompatibilität - den bestehenden Legacy-Produktionspfad für sichere Rückwärtskompatibilität
- den neuen node-basierten Graph-Workflow für modulare, editorfähige Produktionsketten - den neuen node-basierten Graph-Workflow für modulare, editorfähige Produktionsketten
Die laufende Migrations- und Architekturarbeit ist hier dokumentiert: Die laufende Migrations- und Architekturarbeit ist über die Start-Hier-Links oben erreichbar.
- [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)
## Typischer Ablauf ## Typischer Ablauf