Workflow pipeline + bundle builder + docs consolidation

Author: Gib hier deinen Namen ein

.gitignore

@@ -1,21 +1,30 @@
-<<<<<<< ours
 # Build artifacts
 build/
-*.vcxproj.user
-*.sln.docstates
-*.suo
-*.user
-*.userosscache
-*.sln.docstates
-
-# Compiled binaries
+dist/
+out/
 *.dll
+*.so
+*.dylib
 *.lib
 *.exe
 *.obj
 *.pdb
 *.ilk
 *.exp
+*.map
+*.binlog
+*.tlog
+*.ipch
+*.aps
+*.ncb
+*.opendb
+*.opensdf
+*.sdf
+*.suo
+*.user
+*.userosscache
+*.vcxproj.user
+*.sln.docstates
 
 # CMake
 CMakeCache.txt
@@ -25,94 +34,71 @@ cmake_install.cmake
 
 # Visual Studio
 .vs/
-*.aps
-*.ncb
-*.opendb
-*.opensdf
-*.sdf
-*.tlb
-*.tlh
-*.bak
-*.cache
-*.ilk
-*.log
-*.lib
-*.sbr
-*.tlb
-*.tlh
-*.tmp
-*.tmp_proj
-*.user
-*.vspscc
-*.vssscc
-.builds
-*.pidb
-*.svclog
-*.scc
+.builds/
 
-# Qt
+# Qt (generated)
 moc_*.cpp
 moc_*.h
 qrc_*.cpp
 ui_*.h
 *.moc
 
-# Temporary files
-*.tmp
-*.temp
-*~
-.DS_Store
-Thumbs.db
-
-# IDE
-.idea/
-.vscode/
-*.swp
-*.swo
-
-# Documentation builds
-docs/_build/
-docs/.doctrees/
-=======
 # Python
 __pycache__/
 *.py[cod]
 *$py.class
-*.so
 .Python
 env/
 venv/
 ENV/
-.venv
+.venv/
+.pytest_cache/
 
 # IDE
 .vscode/
 .idea/
 *.swp
 *.swo
 
-# Docker
+# Docker / runtime logs
 *.log
 
-# MinIO/Storage
+# MinIO/Storage/cache (local)
 data/
 cache/
+.local_artifacts/
 
-# Environment
+# Environment (never commit secrets)
 .env
 .env.local
 
-# Cursor workspace / local-only scratch
-.cursor/.env
-.cursor/chroma_db/
-.cursor/__pycache__/
-.cursor/backend_*.log
-.cursor/gamma_scribus_pack/plugin/cpp/
->>>>>>> theirs
+# Local-only workspace / scratch
+.cursor/
+temp_analysis/
+backups/
+media_pool/
+assets/
+screenshots/
+scribus/
+
+# Local archive (kept out of GitHub)
+docs/archive/
+
+# Large binary assets (keep out of GitHub by default)
+*.zip
+*.sla
+*.pdf
+*.pptx
+*.png
+*.jpg
+*.jpeg
+*.tif
+*.tiff
 
 # Nested repos / scratch (avoid accidental submodules)
-temp_analysis/
 gamma_scribus_pack/plugin/cpp/github_version/
+apps/api_gateway/
+addon_bundle/
 
 # OS
 .DS_Store

INSTALLATION.md

@@ -0,0 +1,35 @@
+# Installation
+
+Diese Anleitung beschreibt die Installation des Gamma Dashboard Plugins (Scribus) und des Backends (Docker).
+
+## Voraussetzungen
+- Windows 10/11 (für Plugin-Build), oder nur Backend via Docker
+- Docker Desktop (inkl. Compose)
+- Scribus 1.7.x (für das Plugin)
+
+## Backend (empfohlen)
+```powershell
+cd docker
+docker compose up -d --build
+```
+
+Checks:
+- API Gateway: `http://localhost:8003/health`
+
+## Plugin (Windows / VS2022)
+Für Build, Installation und Troubleshooting:
+- `gamma_scribus_pack/plugin/cpp/SCRIBUS_PLUGIN_COOKBOOK.md`
+
+## Workflow (Bundle → Run)
+1. Bundle bauen:
+```powershell
+pwsh tools/build_workflow_bundle.ps1 -Out temp_analysis/workflow_bundle.zip
+```
+2. Workflow starten:
+```powershell
+curl -F "bundle=@temp_analysis/workflow_bundle.zip" -F "options_json={\"gamma_sync\":true,\"gamma_attach_to_variants\":true}" http://localhost:8003/v1/workflow/run
+```
+
+Weitere Details:
+- `docs/workflow/MAGAZIN_WORKFLOW_IMPLEMENTATION_PLAN.md`
+

PROJECT_STRUCTURE.md

@@ -0,0 +1,27 @@
+# Projektstruktur (Kurzüberblick)
+
+Kanonische Struktur für GitHub (Code + kuratierte Docs; keine Assets/Secrets).
+
+```
+scribus-gamma-dashboard-plugin/
+├── README.md
+├── LICENSE
+├── INSTALLATION.md
+├── PROJECT_STRUCTURE.md
+├── requirements.txt
+├── requirements-dev.txt
+├── docker/                       # docker compose + Dockerfiles
+├── apps/                         # API-Gateway + Worker
+├── packages/                     # shared libs (workflow, rag, figma, …)
+├── gamma_scribus_pack/
+│   └── plugin/cpp/               # C++/Qt Plugin (inkl. Cookbook)
+├── docs/
+│   ├── workflow/                 # Magazin-Workflow Dokumente (kanonisch)
+│   └── ...                       # weitere kuratierte Dossiers
+├── strategy/                     # Strategie-Dokumente (RAG/Figma/Layout)
+├── tools/                        # Dev-Tools (Bundle-Builder etc.)
+└── tests/                        # Tests (falls vorhanden)
+```
+
+Hinweis: Lokale Daten/Assets sind bewusst per `.gitignore` ausgeschlossen (`.env`, `.cursor/`, `media_pool/`, `assets/`, `*.pptx`, `*.png`, …).
+

README.md

@@ -1,25 +1,26 @@
 # Scribus Gamma Dashboard Plugin
 
-Native C++/Qt Plugin für Scribus (Gamma Dashboard) plus ein zugehöriges, selbst entwickeltes Backend (Docker: API‑Gateway, Sidecar, Worker).
-
-## Inhalt
+Native C++/Qt Plugin für Scribus (Gamma Dashboard) plus zugehöriges Backend (Docker: API-Gateway, Sidecar, Worker).
 
+## Struktur
 - Plugin (C++/Qt): `gamma_scribus_pack/plugin/cpp/`
-- Plugin (Python‑Teil): `gamma_scribus_pack/plugin/gamma_dashboard/`
-- Backend (Docker + Services): `docker/`, `apps/`, `packages/`, `mvp/`
-- Strategie (RAG für Figma/Layout): `strategy/RAG_FIGMA_LAYOUT_STRATEGY.md`
+- Backend (Docker + Services): `docker/`, `apps/`, `packages/`
+- Workflow-Dokumente: `docs/workflow/`
+- RAG/Figma Strategie: `strategy/RAG_FIGMA_LAYOUT_STRATEGY.md`
 
 ## Quick Start (Backend)
-
 ```powershell
 cd docker
 docker compose up -d --build
 ```
-
 - API Gateway Health: `http://localhost:8003/health`
-- Sidecar Health: `http://localhost:8004/health`
 
-## Plugin Build (Windows / VS2022)
+## Workflow Quick Start
+```powershell
+pwsh tools/build_workflow_bundle.ps1 -Out temp_analysis/workflow_bundle.zip
+curl -F "bundle=@temp_analysis/workflow_bundle.zip" -F "options_json={\"gamma_sync\":true,\"gamma_attach_to_variants\":true}" http://localhost:8003/v1/workflow/run
+```
 
+## Plugin Build (Windows / VS2022)
 Siehe: `gamma_scribus_pack/plugin/cpp/SCRIBUS_PLUGIN_COOKBOOK.md`
 

apps/__init__.py

@@ -0,0 +1,7 @@
+"""Apps package.
+
+This repository keeps app implementations in directories like `apps/api-gateway/`
+which are not importable as Python packages due to the hyphen in the name.
+For tests and local tooling, we provide import-friendly wrappers under `apps/*_*/`.
+"""
+