Help Hub — Logins & Rechte
Optionale Accounts — File- oder MySQL-Storage, Session-Login, Registrierung mit Freigabe, Story-Zugriffsregel und Plan-Rechte.
Der Hub läuft ohne Login. Interne Deployments schalten Session, Zugriffsregel und geteilte Pläne dazu — und halten das für den Kern.
Hier: Gastmodus bleibt Default. Login und Rechte nur, wenn das Operating Model sie braucht.
Überblick
Der Help Hub läuft standardmäßig ohne Login. Für interne Deployments kannst du optionale Accounts aktivieren: Session-Login, Benutzer und Teams, Story-Zugriffskontrolle und geteilte Sprint-Pläne.
Standard-Storage ist dateibasiert (JSON unter storage/app/bn-tools/) — keine Datenbank nötig. Betriebsdaten lassen sich später auf MySQL umstellen, ohne Markdown-Stories oder Repo-Sprint-Vorlagen zu ändern.
Accounts sind ein Feature-Flag, kein Pflichtbestandteil. Lokal und in öffentlichen Demos bleibt der Hub offen.
Orientierung (ohne Login)
Auch ohne Accounts nutzt du die Plattform voll: Hilfe & Touren (Plattform-, Lernpfade-, Sprint-Planner-Tour), Governance Advisor, Stories unter /playbooks. Accounts werden erst relevant, wenn du Story-Zugriffsregel, Team-Freigaben oder geteilte Sprint-Pläne brauchst.
Aktivieren
In .env:
BINOM_TOOLS_ACCOUNTS_ENABLED=true
SESSION_DRIVER=file
BINOM_TOOLS_STORAGE_DRIVER=file
# Optional: self-service avatar on /account (default true)
# BINOM_TOOLS_ACCOUNTS_PROFILE_AVATAR_ENABLED=false
# Optional: Self-Registration (Admin-Freigabe nötig)
# BINOM_TOOLS_REGISTRATION_ENABLED=true
File-Storage (Default)
Laufzeitdaten liegen unter storage/app/bn-tools/ (nicht in Git; lokal + im FTP-Bundle deploy-ftp/, das ebenfalls gitignored ist):
| Datei / Ordner | Zweck |
|---|---|
users.json |
Benutzer inkl. passwordHash |
teams.json |
Teams und Mitgliederzuordnung |
story-acl.json |
Sichtbarkeit einzelner Playbooks |
plans/ |
Server-seitige Sprint-Plan-Instanzen |
user-templates/ |
Von Nutzern gespeicherte Planvorlagen |
read-state/ |
Lesestatus je Nutzer |
npm run deploy:ftp packt diese Daten nach:
deploy-ftp/app/SprintPlanner/bn-tools-seed/(Hydrate beim App-Start, nur fehlende Dateien)deploy-ftp/storage/app/bn-tools/(direkter Server-Pfad zum Hochladen)
Server-.env: BINOM_TOOLS_ACCOUNTS_ENABLED=true und SESSION_DRIVER=file.
MySQL-Storage (optionaler Switch)
Stories und Repo-Vorlagen bleiben Markup. Betriebsdaten nach MySQL:
DB_CONNECTION=mysqlundDB_*setzenphp artisan migrate- Optional:
php artisan bn-tools:storage-import(bestehende JSON-Daten) BINOM_TOOLS_STORAGE_DRIVER=mysql
Tabellen nutzen das Präfix bn_* (bn_users, bn_plans, bn_playbook_stats, …).
Login
- Route:
/login(lokalisiert z. B./de/login) - Session-Key:
bn_tools_account_user_id - Passwörter nur als Hash — Klartext in JSON ist verboten
Passwort setzen (Benutzer muss bereits existieren):
php artisan bn-tools:user-password you@example.com
Self-Registration (optional)
Mit BINOM_TOOLS_REGISTRATION_ENABLED=true (und Accounts an) können Besucher /register öffnen. Neue Konten sind inaktiv mit pendingApproval, bis ein Admin sie unter Konto → Benutzer freigibt. Ablehnen löscht die Registrierung. Funktioniert mit File- und MySQL-Storage.
Leute einladen (Benutzer hinzufügen)
Unter Konto → Benutzer → Benutzer hinzufügen kannst du jemanden schnell anlegen:
- E-Mail + Anzeigename (optional: Teams, Avatar).
- Standard: temporäres Passwort erzeugen, Einladung per E-Mail, Passwortwechsel beim ersten Login.
- Die Person bekommt Login-URL, E-Mail und temporäres Passwort.
- Nach dem Login muss unter
/accountzuerst ein neues Passwort gesetzt werden.
SMTP in .env konfigurieren (MAIL_MAILER, MAIL_HOST, …). Mit MAIL_MAILER=log landet die Einladung im Laravel-Log (lokal praktisch). Schlägt der Versand fehl, zeigt die UI das temporäre Passwort einmal zum Kopieren.
Benutzer-Flags
| Feld | Bedeutung |
|---|---|
active |
Inaktiver Account kann sich nicht anmelden |
canManageUsers |
Benutzer verwalten, Story-Zugriffsregel, User-Templates anderer |
canManageTeams |
Teams verwalten |
teamIds |
Zugehörigkeit zu Teams (für Zugriffsregel und Plan-Viewer) |
mustChangePassword |
Muss Passwort ändern, bevor Tools genutzt werden |
Verwaltung in der UI unter Admin → Users / Teams (nur mit Manage-Rechten): kompakte Listen unter /admin/users und /admin/teams, mit eigenen Create-/Edit-Seiten. Team-memberIds und User-teamIds bleiben synchron. Optionale shortName / colorToken / avatarIcon steuern Chips im Sprint Planner. Nutzer können Avatar-Farbe und Icon auch unter Konto selbst setzen (BINOM_TOOLS_ACCOUNTS_PROFILE_AVATAR_ENABLED, Default an).
Story-Zugriffsregel
Playbooks sind standardmäßig öffentlich. In story-acl.json kannst du einzelne Slugs einschränken — oder in der UI unter Account → Story-Zugriff (Liste + Einzelbearbeitung):
visibility |
Verhalten |
|---|---|
public |
Für alle sichtbar (auch Gäste) |
restricted |
Nur gelistete userIds / teamIds |
Story-Zugriffsregel betrifft Playbooks und Read-State, nicht die Repo-Markdown-Vorlagen unter content/sprint-plans/.
Sprint Planner mit Accounts
| Rolle | Rechte |
|---|---|
| Gast (Accounts an, nicht eingeloggt) | Demo: Pläne nur in sessionStorage, kein Server-Sync |
Owner (ownerUserId) |
Plan bearbeiten, teilen, löschen |
Viewer (viewerUserIds / viewerTeamIds) |
Lesen und Fortschritt je nach API — kein Löschen |
canManageUsers |
Zusätzlich User-Templates und Admin-Flächen |
User-Templates speichern und teilen setzt Login voraus. Ohne Accounts bleibt der Planner rein lokal (siehe Teil 3).
Was Accounts nicht sind
| Konzept | Bedeutung |
|---|---|
| Lokale Personen / Teams im Sprint Planner | Nur Zuordnung und Filter im Browser — kein Login |
| Soft-Lock (Plan-Passwort) | Hash im lokalen Storage, keine echte Zugriffskontrolle |
| Tool-Login-Flags | Einzelne Tools können per TOOL_*_LOGIN_REQUIRED Login verlangen (Default offen) |
Setup-Checkliste
-
BINOM_TOOLS_ACCOUNTS_ENABLED=trueundSESSION_DRIVER=file(bei File-Storage) -
BINOM_TOOLS_STORAGE_DRIVER=file(Default) — oder MySQL-Switch nach migrate/import - Optional:
BINOM_TOOLS_REGISTRATION_ENABLED=true - Seeds /
users.json,teams.json,story-acl.jsonvorhanden (File) bzw. importiert (MySQL) - Mindestens ein Admin mit
canManageUsers: true - Passwort per
php artisan bn-tools:user-password …gesetzt - Story-Zugriffsregel für interne Playbooks geprüft
- Sprint Planner: Login testen vs. Gast-Demo
Weiterlesen
- Teil 1: Governance Help Hub — Architektur und Content
- Teil 3: Sprint Planner — Vorlagen, Storage, Fence-Syntax
Governance Help Hub
Part 8 of 3
View series