Dokumentation
Ausführliche Anleitung zur Nutzung von assessmentbird.io – von der Registrierung bis zum PDF-Bericht.
Erste Schritte
Registrierung & Anmeldung
Öffnen Sie die Startseite und klicken Sie auf „Jetzt kostenlos starten". Füllen Sie das Registrierungsformular mit Ihrem Namen, Ihrer E-Mail-Adresse, einem Organisationsnamen und einem sicheren Passwort aus. Nach der Registrierung erhalten Sie eine Bestätigungs-E-Mail – klicken Sie auf den enthaltenen Link, um Ihre E-Mail-Adresse zu verifizieren.
Alternativ können Sie sich über „Mit GitHub anmelden" registrieren. Dabei wird Ihr GitHub-Konto automatisch verknüpft und Sie können sich zukünftig mit einem Klick einloggen.
Das Dashboard
Nach der Anmeldung landen Sie auf dem Dashboard. Hier sehen Sie auf einen Blick:
- Vier Kennzahlen-Karten: Anzahl Ihrer Kunden, Gesamtzahl der Assessments, abgeschlossene und laufende Assessments.
- Schnellstart-Karten: Direktlinks zum Erstellen eines neuen Assessments, zum Vorlagenkatalog und zum Anlegen eines neuen Kunden.
- Letzte Assessments: Eine Tabelle mit Ihren fünf neuesten Assessments inklusive Status und Direktzugriff.
Kundenverwaltung
Übersicht
Klicken Sie in der Hauptnavigation auf „Kunden". Sie sehen eine Tabelle aller angelegten Kunden mit Firmenname, Ansprechpartner, E-Mail, Stadt und Ersteller. Über das Suchfeld oben rechts können Sie die Liste filtern.
Neuen Kunden anlegen
Klicken Sie auf „Neuer Kunde". Füllen Sie mindestens den Firmennamen aus (Pflichtfeld). Optional können Sie folgende Informationen hinterlegen:
- Ansprechpartner, E-Mail und Telefonnummer
- Adresse (Straße, PLZ, Stadt, Land)
- Ein Firmenlogo (wird per Datei-Upload hochgeladen)
- Freitext-Notizen
Klicken Sie auf „Erstellen", um den Kunden zu speichern.
Kunden bearbeiten & löschen
In der Kundentabelle finden Sie bei jedem Eintrag Aktionsbuttons zum Bearbeiten (Stift-Symbol) und Löschen (Papierkorb-Symbol). Beim Löschen werden Sie zur Bestätigung aufgefordert.
Achtung: Das Löschen eines Kunden ist unwiderruflich.
Kundendetail
Klicken Sie auf einen Kunden, um seine Details und alle zugehörigen Assessments zu sehen. Von hier aus können Sie direkt ein neues Assessment für diesen Kunden starten.
Fragenkataloge
Was ist ein Katalog?
Ein Katalog ist eine strukturierte Sammlung von Fragen, unterteilt in Kategorien. Jede Frage hat Beschreibungen für die fünf Reifegrade (1–5), eine optionale Gewichtung und optionale automatische Empfehlungen. Kataloge durchlaufen drei Status:
Katalog aus dem Vorlagenkatalog verwenden
Der schnellste Weg zu Ihrem ersten Assessment: Klicken Sie auf „Vorlagenkatalog" in der Navigation. Dort finden Sie kostenlose Katalog-Vorlagen. Wählen Sie eine Vorlage, konfigurieren Sie Kunde und Titel und starten Sie direkt ein Assessment. Alle Katalogvorlagen sind kostenlos.
Eigenen Katalog erstellen (nur Admins)
Klicken Sie auf „Kataloge" → „Neuer Katalog". Vergeben Sie einen Namen, eine optionale Beschreibung und eine Versionsnummer (z. B. „1.0"). Der Katalog wird als Entwurf angelegt.
Jede Organisation erhält 1 kostenloses Katalog-Credit. Für weitere eigene Kataloge können Sie zusätzliche Credits erwerben (siehe „Katalog-Credits").
Kategorien hinzufügen
Öffnen Sie den Katalog und klicken Sie auf „Neue Kategorie". Geben Sie einen Namen, eine optionale Beschreibung und eine Gewichtung ein. Die Gewichtung bestimmt, wie stark diese Kategorie in den Gesamtscore einfließt. Per Drag-and-Drop können Sie die Reihenfolge der Kategorien ändern.
Fragen hinzufügen
Wählen Sie eine Kategorie aus und klicken Sie auf „Frage hinzufügen". Füllen Sie den Fragetext aus und beschreiben Sie für jede der fünf Stufen, was diese Bewertung für diese Frage bedeutet:
- Stufe 1 – Nicht vorhanden: Der bewertete Bereich ist nicht oder kaum vorhanden.
- Stufe 2 – Initial: Erste Ansätze, aber nicht standardisiert.
- Stufe 3 – Wiederholbar: Dokumentierte, wiederholbare Prozesse.
- Stufe 4 – Definiert: Standardisierte und gemessene Prozesse.
- Stufe 5 – Optimiert: Kontinuierliche Verbesserung.
Optional können Sie eine Gewichtung für die Frage festlegen.
Empfehlungen definieren
Für jede Frage können Sie Empfehlungen mit einem Schwellenwert anlegen. Klicken Sie auf „Empfehlungen verwalten" und dann auf „Empfehlung hinzufügen". Geben Sie den Empfehlungstext ein und wählen Sie den Schwellenwert (z. B. „Ab Stufe 3"). Liegt der Score bei der Assessment-Durchführung unter diesem Schwellenwert, wird die Empfehlung automatisch angezeigt – sowohl im Assessment als auch im PDF-Bericht.
Katalog veröffentlichen
Wenn Ihr Katalog fertig ist, klicken Sie auf „Veröffentlichen". Nur veröffentlichte Kataloge können für Assessments verwendet werden. Nach der Veröffentlichung ist der Katalog nicht mehr bearbeitbar – erstellen Sie bei Bedarf eine neue Version.
Versionierung
Um einen veröffentlichten Katalog zu ändern, klicken Sie auf „Neue Version". Es wird eine Kopie als Entwurf erstellt. Bestehende Assessments bleiben an die vorherige Version gebunden. Im Versionen-Panel (Button „Versionen") können Sie alle Versionen eines Katalogs einsehen.
Assessments
Assessment erstellen
Klicken Sie auf „Assessments" → „Neues Assessment". Wählen Sie einen Kunden und einen veröffentlichten Katalog aus. Optional können Sie einen Titel (z. B. „Jahres-Assessment 2026") und den Namen des Prüfers angeben. Klicken Sie auf „Assessment starten".
Assessment durchführen
Nach dem Start öffnet sich die Bewertungsansicht. Links sehen Sie die Kategorien und Fragen als Navigation. In der Mitte wird die aktuelle Frage mit den fünf Bewertungsstufen angezeigt. Klicken Sie auf eine Stufe (1–5), um die Frage zu bewerten.
Besondere Features bei der Durchführung:
- Auto-Save: Jede Bewertung wird sofort automatisch gespeichert. Sie sehen einen „Gespeichert"-Indikator oben rechts.
- Auto-Weiter: Aktivieren Sie „Auto-Weiter", um nach jeder Bewertung automatisch zur nächsten Frage zu springen.
- Tastatursteuerung: Tasten 1–5 für die Bewertung, U zum Aufheben, Pfeiltasten oder W/Z für Navigation, N für Notizen, E für eigene Empfehlung, A für Auto-Weiter an/aus.
- Notizen: Zu jeder Frage können Sie im Notizen-Feld individuelle Anmerkungen hinterlegen.
- Eigene Empfehlung: Neben den automatischen Empfehlungen können Sie pro Frage eine individuelle Empfehlung eingeben.
- Automatische Empfehlungen: Wenn der Score unter dem definierten Schwellenwert liegt, werden die Empfehlungen aus dem Katalog automatisch eingeblendet.
- Fortschrittsanzeige: Am oberen Rand sehen Sie, wie viele Fragen bereits beantwortet sind.
Assessment abschließen
Wenn alle Fragen beantwortet sind (oder Sie vorzeitig abschließen möchten), klicken Sie auf „Abschließen". Sie werden zur Bestätigung aufgefordert. Nach dem Abschluss können keine Änderungen mehr vorgenommen werden.
Ergebnisse ansehen
Nach dem Abschluss öffnet sich die Ergebnisseite. Dort sehen Sie:
- Gesamtbewertung: Ein gewichteter Score von 1.0 bis 5.0 mit Farbkodierung.
- Spider-Diagramm: Visualisierung der Scores aller Kategorien.
- Balkendiagramm: Kategorie-Bewertungen im direkten Vergleich.
- Detailansicht: Alle Fragen mit Scores, Notizen und Empfehlungen pro Kategorie.
PDF-Berichte generieren
Auf der Ergebnisseite finden Sie zwei Download-Buttons:
- PDF Executive Summary: Kompakter Bericht für Entscheider mit Gesamtscore, Kategorie-Übersicht und Top-Schwachstellen.
- PDF Detailliert: Vollständiger Bericht mit allen Fragen, Scores, Notizen und Empfehlungen.
Beide PDFs verwenden Ihr Organisations-Logo, Farbschema und die in den Einstellungen konfigurierten Disclaimer/Vertraulichkeitshinweise.
Erneut durchführen
Über den Button „Erneut durchführen" auf der Ergebnisseite erstellen Sie eine Kopie des Assessments mit demselben Kunden und Katalog. So können Sie z. B. ein Jahresvergleichs-Assessment starten.
Archivieren & Wiederherstellen
Abgeschlossene Assessments können über „Archivieren" ins Archiv verschoben und bei Bedarf über „Wiederherstellen" zurückgeholt werden.
Filtern & Übersicht
Auf der Assessments-Seite können Sie nach Status filtern: Alle, Entwurf, In Bearbeitung, Abgeschlossen, Archiviert. Die Tabs zeigen jeweils die Anzahl der Assessments im jeweiligen Status an.
Vorlagenkatalog
Öffentlicher Zugang
Der Vorlagenkatalog ist ohne Anmeldung zugänglich. Sie können alle verfügbaren Vorlagen durchstöbern, Details einsehen und sich einen Überblick verschaffen, bevor Sie sich registrieren. Für die Nutzung einer Vorlage ist eine Anmeldung erforderlich.
Vorlagen durchsuchen
Nutzen Sie das Suchfeld für eine Volltextsuche nach Name und Beschreibung. Über Tag-Filter (z. B. AWS, Kubernetes, Security, DevOps) grenzen Sie die Auswahl thematisch ein. Zusätzlich können Sie nach Sprache filtern (Deutsch, Englisch oder Alle).
Jede Vorlage zeigt Name, Beschreibung, Autor, Version, Anzahl der Kategorien und Fragen, Tags, verfügbare Sprachen und eine Kategorien-Vorschau mit Beispielfragen.
Assessment aus Vorlage erstellen
So erstellen Sie ein Assessment direkt aus einer Katalogvorlage:
- Vorlage auswählen: Gewünschtes Template im Vorlagenkatalog finden und Detailseite öffnen.
- Assessment konfigurieren: Kunden auswählen, Assessment-Titel vergeben und optional einen Prüfer-Namen angeben.
- Assessment starten: Ein Katalog-Snapshot wird automatisch erstellt und das Assessment gestartet.
Katalog-Credits
Katalogvorlagen sind kostenlos. Für eigene Kataloge benötigen Sie Katalog-Credits. Jede Organisation erhält 1 Credit kostenlos. Weitere Credits können in Paketen erworben werden:
- 1 Credit
- 5 Credits (reduzierter Stückpreis)
- 10 Credits (bester Stückpreis)
Die Bezahlung erfolgt sicher über Stripe Checkout. Die Steuer (19% MwSt.) wird automatisch berechnet und ausgewiesen. Nach erfolgreicher Zahlung werden die Credits sofort Ihrer Organisation gutgeschrieben.
Ihren aktuellen Credit-Stand sehen Sie auf der Kataloge-Seite sowie auf der Katalog-Credits-Seite.
Einstellungen (nur Admins)
Organisation
Unter „Einstellungen" → „Organisation" können Sie anpassen:
- Organisationsname
- Logo: Wird in der Navigation und auf PDF-Berichten angezeigt.
- Adresse: Straße, PLZ, Ort, Website und E-Mail.
- Farbschema: Wählen Sie zwischen Dunkel, Hell, Blau, Grün oder Violett. Das Farbschema wird auch auf den PDF-Berichten verwendet.
PDF-Berichte
Unter „Einstellungen" → „PDF-Berichte" konfigurieren Sie das Erscheinungsbild Ihrer PDF-Berichte:
- Firmenname: Erscheint als Absender auf den Berichten.
- Firmenlogo: Ein separates Logo für die PDF-Deckblätter (kann sich vom Organisationslogo unterscheiden).
- Report-Titel: Der Haupttitel auf Deckblatt und Fußzeile (z. B. „IT-Reifegradanalyse", „Security Audit Report").
- Disclaimer: Eigener Disclaimer-Text, separat konfigurierbar für Deutsch und Englisch (max. 1.000 Zeichen pro Sprache).
- Vertraulichkeitshinweis: Individueller Vertraulichkeitshinweis, ebenfalls separat für Deutsch und Englisch (max. 1.000 Zeichen pro Sprache).
Wird kein eigener Disclaimer oder Vertraulichkeitshinweis hinterlegt, greift jeweils ein Standardtext. Der angezeigte Text richtet sich nach der Spracheinstellung des Benutzers, der den Report exportiert.
Mitglieder verwalten
Unter „Einstellungen" → „Mitglieder" sehen Sie alle Teammitglieder und offene Einladungen.
Neues Mitglied einladen:
- Geben Sie die E-Mail-Adresse des neuen Mitglieds ein.
- Wählen Sie die Rolle: Admin oder Mitglied.
- Klicken Sie auf „Einladung senden".
Die eingeladene Person erhält eine E-Mail mit einem Einladungslink (7 Tage gültig). Sie können Rollen ändern und Mitglieder entfernen.
Benutzer
Unter „Einstellungen" → „Benutzer" sehen Sie alle Benutzer, gruppiert nach Rolle (Eigentümer, Admins, Benutzer). Hier können Sie neue Benutzer anlegen, bestehende bearbeiten und Benutzer aktivieren/deaktivieren. Deaktivierte Benutzer können sich nicht mehr anmelden.
Aktivitätsprotokoll
Unter „Einstellungen" → „Protokoll" sehen Sie ein chronologisches Protokoll aller Aktionen in Ihrer Organisation: wer hat wann was erstellt, geändert, gelöscht, veröffentlicht etc. Filtern Sie nach Objekttyp (Assessments, Kataloge, Kunden, Benutzer, Organisation).
Profil
Profilfoto
Laden Sie ein Profilfoto hoch und wählen Sie einen Bildausschnitt. Das Foto wird in der Navigation und bei Ihren Team-Einträgen angezeigt. Um das Foto zu entfernen, klicken Sie auf den Entfernen-Button.
Profilinformationen
Ändern Sie Ihren Namen und Ihre E-Mail-Adresse. Bei Änderung der E-Mail müssen Sie diese erneut verifizieren.
Passwort
Ändern Sie Ihr Passwort. Geben Sie Ihr aktuelles Passwort und das neue Passwort (mit Bestätigung) ein. Verwenden Sie ein langes, zufälliges Passwort für maximale Sicherheit.
Sprache
Wählen Sie Ihre bevorzugte Sprache für die Benutzeroberfläche: Deutsch oder Englisch. Die Änderung wird sofort wirksam.
GitHub-Konto
Verknüpfen oder trennen Sie Ihr GitHub-Konto. Mit einer Verknüpfung können Sie sich über „Mit GitHub anmelden" einloggen, ohne jedes Mal Ihr Passwort eingeben zu müssen.
Konto löschen
Löschen Sie Ihr Konto unwiderruflich. Alle zugehörigen Daten werden permanent entfernt. Sie müssen Ihr Passwort eingeben, um die Löschung zu bestätigen.
Achtung: Diese Aktion kann nicht rückgängig gemacht werden. Sichern Sie vorher alle wichtigen Daten.
Rollen & Berechtigungen
| Funktion | Eigentümer | Admin | Mitglied |
|---|---|---|---|
| Dashboard ansehen | ✓ | ✓ | ✓ |
| Kunden anlegen/bearbeiten/löschen | ✓ | ✓ | ✓ |
| Assessments erstellen/durchführen | ✓ | ✓ | ✓ |
| PDF-Berichte herunterladen | ✓ | ✓ | ✓ |
| Kataloge erstellen/bearbeiten/veröffentlichen | ✓ | ✓ | – |
| Katalogvorlagen übernehmen | ✓ | ✓ | – |
| Einstellungen anpassen | ✓ | ✓ | – |
| Benutzer verwalten | ✓ | ✓ | – |
| Mitglieder einladen/entfernen | ✓ | ✓ | – |
| Aktivitätsprotokoll einsehen | ✓ | ✓ | – |
Hinweise
- Es gibt genau einen Eigentümer pro Organisation. Dieser kann nicht entfernt werden.
- Admins haben die gleichen Rechte wie der Eigentümer, können aber vom Eigentümer entfernt werden.
- Mitglieder können Assessments durchführen und Kunden verwalten, haben aber keinen Zugriff auf Katalogbearbeitung, Einstellungen oder Benutzerverwaltung.
Bewertungssystem
Die fünf Reifegrade
Gewichtung
Sowohl Fragen als auch Kategorien können gewichtet werden. Die Berechnung funktioniert in zwei Stufen:
- Kategorie-Score: Gewichteter Durchschnitt aller Fragen-Scores innerhalb der Kategorie.
- Gesamtscore: Gewichteter Durchschnitt aller Kategorie-Scores.
Beispiel: Hat eine Frage die Gewichtung 2 und eine andere die Gewichtung 1, zählt die erste Frage doppelt so stark in den Kategorie-Score.
Tastaturkürzel
Bei der Assessment-Durchführung stehen folgende Tastaturkürzel zur Verfügung:
| Taste | Funktion |
|---|---|
| 1 – 5 | Bewertung auf die jeweilige Stufe setzen |
| U | Bewertung aufheben |
| → / W | Nächste Frage |
| ← / Z | Vorherige Frage |
| N | Notizen-Feld fokussieren |
| E | Empfehlungs-Feld fokussieren |
| A | Auto-Weiter ein-/ausschalten |