Firescope Handbuch

Installation

1. Laden Sie unter Download die Mac-Version als.dmg herunter (Apple Silicon / Intel wählbar).
2. Öffnen Sie die heruntergeladene .dmg-Datei undziehen Sie das Firescope-Symbol in den Ordner „Programme“.
3. Starten Sie Firescope aus dem Programme-Ordner.

Windows

1. Laden Sie unter Download die Datei Firescope-Setup.exeherunter und führen Sie sie aus.
2. Falls beim ersten Start eine SmartScreen-Warnung erscheint,klicken Sie auf „Weitere Informationen“ → „Trotzdem ausführen“.

Ersteinrichtung (Sprache und Design)

Beim ersten Start öffnet sich ein vierstufiger Einrichtungsbildschirm. Wählen Sie zunächst die Anzeigesprache (9 integrierte Sprachen: Japanisch, Englisch, 简体中文, 繁體中文, 한국어, Español, Português, Français, Deutsch). Die Änderung wird sofort im Bildschirm übernommen — probieren Sie es im Zweifel einfach aus.

Als Nächstes wählen Sie das visuelle Design. Zehn Varianten stehen zur Auswahl, darunter Light und Dark. Auch hier sehen Sie die Vorschau sofort nach dem Klick.

Mit Firestore verbinden

Für die Verbindung wird der private Schlüssel eines Firebase-Dienstkontos (JSON)verwendet. Auch wenn Sie noch keinen haben, dauert es nur etwa eine Minute, ihn gemäß der Anleitung im Bildschirm zu erhalten.

1. Klicken Sie auf „Seite für Dienstkonto-Einstellungen öffnen“, um die entsprechende Seite der Firebase-Konsole im Browser zu öffnen (zu finden unter: Projekteinstellungen → Dienstkonten).
2. Klicken Sie auf „Neuen privaten Schlüssel generieren“, um die JSON-Datei herunterzuladen.
3. Wechseln Sie zurück zu Firescope und wählen Sie die heruntergeladene JSON-Datei über „JSON-Datei auswählen und verbinden“ aus.Sie können auch JSON-Dateien mehrerer Projekte gleichzeitig auswählenund alle auf einmal verbinden.
4. Wählen Sie die Umgebung der Verbindung (Entwicklung / Test / Staging / Produktion). Sie wird in der Seitenleiste als farbiges Label angezeigt, und auch die Stärke desSicherheitsschutzes richtet sich nach diesem Label.

Daten ansehen

Öffnen Sie in der Seitenleiste eine Verbindung und klicken Sie auf eine Sammlung — die Dokumente werden als Tabelle angezeigt. Jede Spaltenüberschrift trägt einTyp-Badge (string / int / time usw.), sodass die Form der Daten auf einen Blick erkennbar ist.

• Ein Klick auf eine Zeile zeigt alle Felder des Dokuments im rechten Panel.
• Sortierung, Anzahl der angezeigten Einträge und Gruppensuche (Sammlungsgruppe) lassen sich über die Werkzeugleiste ändern.
• Die Anzahl der Lesevorgänge wird stets in der Statusleiste angezeigt (als Anhaltspunkt für die Kosten).

Logische Namen (Feldnamen übersetzt anzeigen)

Englische Feldnamen wie carryingOutCoffinMasterId lassen sich alslogische Namen, etwa auf Deutsch, anzeigen. Über den„Logische Namen“-Schalter in der Werkzeugleiste können Sie jederzeit zwischen physischem und logischem Namen umschalten.

• Das Wörterbuch bearbeiten Sie über das 📖-Symbol in der Werkzeugleiste. Es gibt zwei Ebenen: „für die gesamte Verbindung gemeinsam“ und „nur für diese Sammlung (überschreibt)“.
• „Automatische Übersetzung“ befüllt leere Felder über das integrierte Wörterbuch und eine kostenlose Übersetzungs-API auf einmal.
• „Google Übersetzer öffnen“ öffnet die Übersetzungsseite mit den Feldnamen in englischer Form — kopieren Sie die Übersetzung und kehren Sie zur App zurück, schon wird sie übernommen.
• Rechtsklick auf eine Spaltenüberschrift →„Logischen Namen festlegen…“, um nur diese Spalte sofort zu bearbeiten.
• Das Typ-Badge in der Kopfzeile (string / int usw.) lässt sich über den „Typanzeige“-Schalter ein- und ausblenden.

Tabs und Gruppen

Rechtsklick auf eine Sammlung →„In neuem Tab anzeigen“ lässt Sie wie im Browser weitere Tabs öffnen. Tabs lassen sich, wie bei Chrome, zu Gruppen zusammenfassen.

• Rechtsklick auf einen Tab →„Zu neuer Gruppe hinzufügen“ erstellt eine Gruppe. Sie lässt sich benennen und einfärben.
• Ein Klick auf den Gruppen-Chip klappt ihn ein bzw. aus.
• Doppelklick auf einen Tab ändert Name und Hintergrundfarbe.
• Per Drag & Drop lassen sich Tabs neu anordnen und in Gruppen verschieben.
• Der Tab-Zustand bleibt nach einem Neustart erhalten (in den Einstellungen abschaltbar).

Geteilte Ansicht

Rechtsklick auf eine Sammlung →„Rechts geteilt anzeigen“ zeigt zwei Sammlungen nebeneinander an. Praktisch, um Stammdaten mit Transaktionen abzugleichen.

• Auch das Ziehen einer Sammlung aus der Seitenleiste an den linken oder rechten Bildschirmrand teilt die Ansicht.
• Ziehen Sie den Chip eines Bereichs, um links und rechts zu tauschen oder ihn in einen neuen Tab zu verschieben.
• Der Split-Status bleibt pro Tab erhalten.

Echtzeit-Überwachung

Klicken Sie in der Werkzeugleiste auf „Überwachen“, und Änderungen an der angezeigten Sammlung werden live ins Raster übernommen. Inhalte, die von einer anderen App oder einem Server geschrieben werden, fließen ohne Neuladen direkt ein.

• Im Dialog vor dem Start können Sie Bedingungen (Feld, Wert), Sortierung und Anzahl eingrenzen.
• Im Änderungs-Feed rechts erscheinen „Hinzugefügt / Aktualisiert / Gelöscht“ in chronologischer Reihenfolge, inklusive der geänderten Feldnamen.
• Die Überwachung ist rein lesend. Schreibvorgänge während der Überwachung durchlaufen wie gewohnt die Sicherheits-Pipeline.
• Es können bis zu 5 Überwachungen gleichzeitig laufen.
• Nach der eingestellten Zeit stoppt die Überwachung automatisch (Zeit in den Einstellungen änderbar). Das verhindert einen übermäßigen Verbrauch an Lesevorgängen.

Daten bearbeiten

Ein Doppelklick auf eine Zelle öffnet die Inline-Bearbeitung.Enter bestätigt, Esc bricht ab. Typen wie int oder timestamp bleiben beim Schreiben erhalten.

Jede Schreiboperation durchläuft die Sicherheits-Pipeline:

1. Bestätigen — Ein Dialog erscheint, abgestimmt auf Umgebungs-Label × Operationsrisiko. Destruktive Operationen in der Produktion erfordern dieEingabe der Projekt-ID.
2. Automatisches Backup — Betroffene Dokumente werden vor der Ausführung als Snapshot gesichert.
3. Ausführen — Der Schreibvorgang wird durchgeführt.
4. Protokoll — Wird unabhängig von Erfolg oder Misserfolg erfasst (einsehbar über „Protokoll“ in der unteren Leiste).

Backup und Wiederherstellung

Snapshots, die unmittelbar vor destruktiven Operationen erstellt wurden, sammeln sich unter„Backup“ in der unteren Leiste. Eine Auswahl öffnet dieWiederherstellungsvorschau, in der Sie den Unterschied — neu erstellen / überschreiben / unverändert — prüfen können, bevor Sie wiederherstellen.

• Mit ⌘Z (oder dem ↩︎-Symbol in der Seitenleiste) können SieIhre letzte Schreiboperation sofort rückgängig machen.
• Ältere Snapshots werden gelöscht, sobald die Generationsobergrenze überschritten ist. Möchten Sie einen behalten, heften Sie ihn mit 📌 an.

Konsole

In der Seitenleiste unter „Konsole“ schreiben Sie Abfragen in JavaScript im Stil von firebase-admin. Mit ⌘Enter ausgeführt, erscheint das Ergebnis in einer typannotierten Tabelle.

const snap = await db.collection('orders')
  .where('status', '==', 'paid')
  .orderBy('amount', 'desc')
  .limit(20)
  .get();
return snap.docs.map((d) => ({ id: d.id, ...d.data() }));

• Für die Maus-Fraktion gibt es einen visuellen Baukasten (Lesen / Aktualisieren / Erstellen / Löschen). Zusammengestellte Bedingungen lassen sich über „In Code übernehmen“ in JS umwandeln.
• Code mit Schreibvorgängen läuft in der Reihenfolge Testlauf → Schreibvorschau → Anwendenab, sodass sich Daten nie unerwartet ändern.
• Auch die Join-Ansicht (Verknüpfung) wird unterstützt.

CSV-Import/-Export

Export

Über „CSV-Export“ in der Werkzeugleiste einer Sammlung können Sie das aktuell angezeigte Abfrageergebnis (inklusive Filter und Sortierung) als CSV speichern. DankTypannotation in der Kopfzeile bleiben die Typen auch beim späteren erneuten Import erhalten.

Import

1. „Import“ in der Werkzeugleiste → CSV-Datei auswählen (Shift_JIS wird automatisch erkannt).
2. Typ und Modus (upsert / nur neu / nur aktualisieren) jeder Spalte prüfen.
3. „Anzahl prüfen“ zeigt eine Vorschau, wie viele Einträge neu erstellt bzw. überschrieben werden.
4. „Import ausführen“ → nach einem Bestätigungsdialog wird importiert. Überschriebene Einträge werden vorher automatisch gesichert.

Schemaprüfung (Erkennung von Schemaabweichungen)

Rechtsklick auf eine Sammlung →„Schemaprüfung…“liest die gesamte Sammlung und erkennt automatischFelder mit gemischten Typen, Felder, die nur bei einem Teil der Dokumente fehlen, sowie seltene Felder mit möglichen Tippfehlern(bis zu 20.000 Einträge).

• Fehlende Felder, die über dieselbe Dokumentgruppe hinweg auftreten, werden in einer Karte gebündelt. „Alle öffnen“ markiert alle betroffenen Zeilen auf einmal — praktisch für anschließendes Massenlöschen.
• Ein Klick auf die ID eines betroffenen Dokuments scrollt automatisch zur entsprechenden Zeile im Raster und hebt sie hervor.
• Die Ergebnisse bleiben auch nach Schließen des Assistenten erhalten, sodass Sie beliebig oft zwischen Prüfung und Dokumenten wechseln können.
• Im Tab Zod-Schemaprüfung können Sie ein Zod-Schema (TypeScript) einfügen, um alle Dokumente zu validieren.

Umgebungen vergleichen und kopieren

Mit anderer Umgebung vergleichen

Rechtsklick auf eine Sammlung →„Mit anderer Umgebung vergleichen…“stellt gleichnamige Sammlungen zweier Umgebungen, etwa Entwicklung und Produktion, gegenüber. Unterschiede (Hinzufügungen / Löschungen / Änderungen) werden pro Dokument und Feld aufgelistet.

• Sie können Felder wie updatedAt vom Vergleich ausschließen.
• Die Unterschiede lassen sich als CSV exportieren.

In andere Umgebung kopieren

Mit „In andere Umgebung kopieren…“lässt sich eine Sammlung in eine andere Verbindung (Umgebung) duplizieren. Vor der Ausführung wird eine Vorschau von Anzahl und möglichen Überschreibungen angezeigt, und Schreibvorgänge in die Produktion durchlaufen wie gewohnt die strenge Bestätigung.

Authentication-Nutzer

Über „Authentication“ in der Seitenleiste können Sie Nutzer von Firebase Authentication auflisten und verwalten.

• E-Mail, Anzeigename, Anbieter, Erstellungsdatum und letzte Anmeldung werden aufgelistet. Über den Schalter für logische Namen lassen sich auch die Feldnamen auf Deutsch anzeigen.
• Unterstützt Deaktivieren / Aktivieren und Löschen von Nutzern sowie das Versenden von E-Mails zum Zurücksetzen des Passworts.
• Die UID eines Nutzers lässt sich kopieren, um sie mit Dokumenten in Firestore abzugleichen.
• Destruktive Operationen (z. B. Löschen) durchlaufen dieselbe Sicherheits-Pipeline wie bei Firestore (bestätigen → Protokoll).

Updates

• Auf Updates wird alle 6 Stunden sowie beim Start automatisch geprüft (manuelle Prüfung auch über Einstellungen → Info → „Nach Updates suchen“).
• Wird ein verpflichtendes Update veröffentlicht, läuft ab dem Update-Bildschirm beim Start automatisch Herunterladen → Neustarten → Anwenden ab. Es ist keine Bedienung nötig.
• Nur bei einem Fehlschlag (z. B. offline) wird der manuelle Download über den Browser angeboten.

Preise und Lizenz

• Ab dem ersten Start stehen 14 Tage als Testversionmit allen Funktionen zur Verfügung. Weder Registrierung noch Zahlungsangaben sind nötig.
• Auch nach Ablauf bleibt das Ansehen der Daten weiterhin kostenlos möglich.
• Der Kauf erfolgt direkt in der App: Wählen Sie unten rechts unter ⚙ Einstellungen → Lizenzeinen Plan (Pro / TEAM, monatlich / jährlich) — die Stripe-Zahlungsseite öffnet sich im Browser. Nach Abschluss der Zahlung aktiviert die App die Lizenz automatisch.
• Beim Wechsel auf einen anderen Mac lösen Sie die Lizenz zuerst auf dem alten Gerät und aktivieren sie danach auf dem neuen.

Details zu den Plänen finden Sie auf der Preisseite.

Häufige Fragen

Keine Verbindung möglich / „Authentifizierung fehlgeschlagen“ wird angezeigt

Prüfen Sie, ob die JSON-Datei tatsächlich der Dienstkontoschlüssel des Zielprojekts ist. Wurde der Schlüssel neu erstellt, trennen Sie die alte Verbindung und verbinden Sie sich neu mit der neuen JSON-Datei.

Werden Daten irgendwohin gesendet?

Nein. Firescope greift direkt von Ihrem Mac aus auf Firestore zu. Weder Schlüssel noch Daten werden an einen externen Server gesendet.

Was macht der „Produktionsschutz“ eigentlich?

Ein Mechanismus, der die Stärke der Bestätigung automatisch anhand des Umgebungs-Labels der Verbindung und des Operationsrisikos anpasst. Das Löschen einer Sammlung in der Produktion lässt sich zum Beispiel nur ausführen, wenn die Projekt-ID manuell eingegeben wird. Da die Prüfung nicht nur ein Hinweis in der Oberfläche ist, sondern im Kern der App (Hauptprozess) erfolgt, lässt sie sich nicht versehentlich umgehen.

Gibt es eine Windows-Version?

Ja. Laden SieFirescope-Setup.exe über die Download-Seiteherunter (erscheint eine SmartScreen-Warnung, klicken Sie auf „Weitere Informationen“ → „Trotzdem ausführen“).

Kann ich weitere Sprachen hinzufügen?

Ja. Exportieren Sie unter Einstellungen → Sprache ein Sprachpaket (JSON), übersetzen Sie es und importieren Sie es anschließend wieder — so lässt sich jede beliebige Sprache hinzufügen.