Governance Help Hub

Begriffe vor dem Lesen

• Governance — Gemeinsame Regeln, Rollen und Nachweise, damit Daten verantwortbar genutzt werden.
• verantwortliche Person — Fachlich verantwortliche Person oder Rolle, die Zweck, Bedeutung und Freigabe klärt.
• technischer Betreiber — Technische Rolle, die Plattform, Zugriff, Betrieb oder Umsetzung betreut.
• Nachweis — Nachvollziehbarer Nachweis zu Entscheidung, Prüfung, Umsetzung oder Ausnahme.

Teams kennen Advisor, Stories und Tools — und wissen nicht, wo der Einstieg sitzt. Sie öffnen drei Hubs und können das Einstiegsproblem trotzdem nicht benennen.

Hier: die Plattform-Karte. Wo Advisor, Stories, Pfade, Tools und Planner sitzen. Ein Betriebsproblem bleibt im Konzept oder in den Lernpfaden.

Überblick

Viele Governance-Programme scheitern nicht an fehlenden Folien, sondern daran, dass Lage, Sprache, Artefakte und Nachweis an verschiedenen Orten liegen. Der Governance Help Hub in binom-tools ist die Arbeitskette dafür: Lage klären → verstehen → gemeinsame Begriffe → Artefakt erzeugen → umsetzen → nachhalten — Stories als Markdown-Playbooks, interaktive Tools, zweisprachige Oberfläche, schlanker Laravel-Stack ohne CMS.

Du kannst das Projekt klonen, eigene Stories unter content/stories/ ablegen und optional Tools ergänzen — für Data-Governance- und BI-Teams, die Wissen versionierbar und nah am Code halten wollen.

Kein Gateway, kein CMS: Inhalte leben in Git, Reviews laufen wie bei Application Code.

Die Plattform nutzen (Kurz)

Binom Governance ist eine Arbeitskette, keine Linkliste: Lage klären → verstehen → gemeinsame Sprache (Glossar, Rollen, Fachbereiche) → Artefakte → umsetzen → am Ball bleiben. Die Hubs unten bedienen je einen Teil dieser Kette.

Hilfe & geführte Touren

Zentrale Einstiege unter Hilfe & Touren:

Die Buttons Tour starten öffnen die geführte Overlay-Tour (Schritte mit Kontext und oft Screenshot/Diagramm). Spezialtouren erreichst du auch direkt in den jeweiligen Hubs (Governance, Lernpfade, Sprint Planner).

Mehr Kontext zur Arbeitskette: About und die Plattform-Tour.

Governance Hub & Advisor

Der Governance Hub ist der Ort, um eine konkrete Lage zu klären — nicht nur Links zu sammeln.

Decision Ladder: Flow-Orientierung → Fallentscheidung → Tools/Playbooks → Nachweise. Der Advisor vertieft die Lage; Session/Report kannst du speichern und später in den Sprint Planner übernehmen.

Verwandte Tools: Governance Stack Advisor, Custom Stack Builder, Starting-Point Decision.

Weitere Hubs (Orientierung)

Empfohlene Reihenfolge für Einsteiger: Plattform-Tour → Flows → bei Bedarf Advisor mit einem echten Use Case → passende Story oder Lernpfad → ein Tool-Artefakt → optional Sprint-Plan.

Oder als geführter Pfad: Lernpfad Governance Help Hub (inkl. Sprint-Vorlage).

Vertiefung je Hub: Teil 2 Advisor · Teil 3 Stories · Teil 4 Lernpfade · Teil 5 Tools · Teil 6 Glossary, Roles & Functions · Teil 7 Radar & Resources.

Architektur

Datenfluss Stories: content/stories/*.md → PlaybookRepository → Blade (playbooks/show) → gerendertes HTML + TOC aus Überschriften.

Datenfluss Tools: config/tools.php → Controller → Blade-Karten und Sidebar-Navigation.

Projektstruktur

binom-tools/
├── app/
│   ├── Accounts/             # Optionale Logins, Zugriffsregel, Plan-Store (siehe Teil 8)
│   ├── Catalog/              # Landing-Vorschau (neueste Tools & Stories)
│   ├── Http/Controllers/     # Landing, Tools, Playbooks, Sprint Planner, Legal
│   ├── Playbooks/            # Parser, Renderer, Repository (siehe Teil 3)
│   └── SprintPlanner/        # Vorlagen-Parser, Seeds (siehe Teil 9)
├── config/tools.php          # Tool-Navigation, Hero, Ecosystem-Links
├── content/
│   ├── stories/              # Markdown-Stories (.de.md / .en.md)
│   ├── sprint-plans/         # Sprint-Planner-Vorlagen
│   └── catalogs/             # Suppliers / Glossary JSON
├── public/images/            # Hero-Grafiken, Logos
├── resources/
│   ├── css/                  # Shell, Playbooks, Themes
│   ├── js/                   # Locale, TOC, Suche, Theme, Sprint Planner
│   └── views/                # Blade Layouts & Komponenten
├── routes/web.php
└── tests/                    # Feature- & Unit-Tests

Wichtige UI-Komponenten:

• <x-tools.card> — Karten für Tools und Landing
• <x-playbooks.card> — Story-Karten in Übersicht & Landing
• <x-playbooks.toc> — Inhaltsverzeichnis mit Scroll-Spy
• <x-tools.sidebar> — Navigation (Startseite, Stories, Tools, Sprint Planner)

Stories & Tools (Kurz)

• Stories schreiben/lesen: ausführlich in Teil 3 — Stories & Playbooks (Frontmatter, Serien, Fences, Offline).
• Tools nutzen/erweitern: Teil 5 — Tools; Nav/Modul-Wiring und Architektur siehe Abschnitte oben.

Pager-Verhalten für Serien-Mitglieder: PLAYBOOKS_SERIES_PAGER=both|series|global in .env (Default both).

i18n & Theme

• UI-Strings: resources/js/shell/locale.js (data-i18n, data-card-id, data-text-de / data-text-en)
• Playbook-Inhalte: getrennte Locale-Dateien (.de.md, .en.md)
• Theme: Light/Dark via data-color-scheme und CSS-Variablen in resources/css/themes/

Lokale Entwicklung

git clone <repository-url> binom-tools
cd binom-tools
composer install
cp .env.example .env
php artisan key:generate
npm install
npm run dev          # oder: npm run build
php artisan serve

Optional in .env:

BINOM_TOOLS_REPO_URL=https://github.com/dein-org/dein-help-hub

binom-ngx Docs: fest in config/tools.php → https://ngx-docs.binom.net

Deployment

1. npm run build — Vite-Assets nach public/build/
2. composer install --no-dev --optimize-autoloader
3. php artisan config:cache und php artisan route:cache
4. Webserver document root auf public/ zeigen

Stories sind reine Dateien — Content-Updates können per Git Pull ohne DB-Migration ausgerollt werden.

Download & Fork

Das Projekt ist als Starter-Template gedacht:

1. Repository klonen und unter eigenem Namen weiterentwickeln
2. content/stories/ durch eigene Governance-Stories ersetzen oder erweitern
3. config/tools.php und Branding (resources/views/components/tools/brand.blade.php) anpassen
4. Optional nur Stories nutzen — interaktive Tools können schrittweise ergänzt werden

Repository-URL (konfigurierbar): siehe BINOM_TOOLS_REPO_URL in .env bzw. config/tools.php → links.repository.

Checkliste für einen eigenen Help Hub

• Branding (Logo, Domain, Footer)
• Mindestens eine Story in DE + EN
• Kategorien und Tags definieren
• Impressum / Legal (/impressum) prüfen
• CI: php artisan test und npm run build in Pipeline

Support & Erweiterung

Typische Erweiterungen ohne Architektur-Bruch:

• PDF-/Ebook-Export von Stories und Serien (Playbook-PDF)
• Volltextsuche serverseitig (statt Client-Filter auf Übersichtsseiten)
• Optionale Authentifizierung und Story-Zugriffsregel — siehe Teil 8: Logins & Rechte
• Ausführbare Arbeitspläne — siehe Teil 9: Sprint Planner
• Produkt-Hubs vertiefen — Teile 2–7 dieser Serie

Fragen oder Anpassungen: über das Repository-Issue-Tracking oder euren internen Governance-Owner.