docs: optimize readme landing layout for gitea

This commit is contained in:
2026-04-12 14:44:13 +02:00
parent 04a08a8bdf
commit 9f1ccec8f0
+48 -21
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).
> 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 |
@@ -21,25 +43,24 @@ Eine ausführlichere Projektübersicht mit Screenshots gibt es in [docs/PROJECT_
- 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
## 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)
## 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
@@ -84,6 +105,16 @@ Das ist nur für lokale Entwicklung gedacht und sollte für jede nicht-lokale Um
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
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 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)
Die laufende Migrations- und Architekturarbeit ist über die Start-Hier-Links oben erreichbar.
## Typischer Ablauf