Dies ist die Dokumentation der Version 0.3. Die neueste Version ist 0.5: zur neuesten Dokumentation

Benutzerhandbuch

1. Was ist Loonar Compass

Loonar Compass ist eine eigenständige Desktop-Anwendung für Windows: ein KI-Assistent für die Arbeit mit einem Enterprise-Architect-Modell (Sparx Systems). Sie schreiben ihm in natürlicher Sprache, und er:

• liest das Modell (Pakete, Elemente, Diagramme, Konnektoren, Attribute und Operationen, Tagged Values und Schlüsselwörter) und beschreibt, was darin enthalten ist,
• analysiert das Modell: Auswirkungen der Änderung eines Elements auf den Rest des Modells, Verwendungsstellen von Operationen, Elemente ohne Konnektoren,
• ändert das Modell: legt Pakete, Diagramme, Elemente und Konnektoren an, ergänzt Attribute und Operationen von Klassen, setzt Tagged Values und Schlüsselwörter, ordnet Elemente in Diagrammen an, verschiebt und löscht sie, entfernt ein Element aus einem Diagramm (es bleibt im Modell), färbt Elemente ein, fügt Legenden hinzu, kopiert Pakete und erstellt Baselines davon,
• zeichnet Diagramme nach einer Beschreibung, einem Foto, einer Skizze oder einer angehängten Datei,
• zeigt Diagramme als Bilder im Chat, so wie Enterprise Architect sie zeichnet,
• erstellt Dokumente aus den Inhalten des Modells: Word, Excel, PNG-Bilder und Confluence-Seiten, auch nach Vorlagen,
• merkt sich Festlegungen über Unterhaltungen hinweg (Modellierungskonventionen, Präferenzen, Korrekturen),
• arbeitet mit Ihrem geöffneten EA-Fenster zusammen: Er weiß, was Sie ausgewählt haben, und öffnet Diagramme (Kapitel 8).

Die Anwendung nutzt das Sprachmodell Claude Haiku 5.5 (Anthropic) über das Internet. Mit dem EA-Modell verbindet sie sich auf zwei Wegen: Sie liest es direkt aus der PostgreSQL-Datenbank und schreibt über Enterprise Architect, das im Hintergrund läuft, mit dem in den Einstellungen angegebenen Benutzerkonto des Modells.

Die Oberfläche und die Antworten des Assistenten sind in vier Sprachen verfügbar: Polnisch, Englisch, Deutsch und Französisch (Kapitel 5). Die Anwendung ist kostenlos, auch für die kommerzielle Nutzung (Kapitel 18).

4. Fenster und Navigation

Links im Fenster befindet sich eine dunkelblaue Navigationsleiste mit Symbolen. Wenn Sie mit der Maus auf ein Symbol zeigen, erscheint sein Name. Ein Klick wechselt die Ansicht.

Ein orangefarbenes „!“ auf den Symbolen „Einstellungen“, „Gedächtnis des Assistenten“ und „Dokumentvorlagen“ bedeutet, dass die Übersetzung nach einem Sprachwechsel noch nicht abgeschlossen ist (Kapitel 5).

Projekt unterstützen. Loonar Compass ist kostenlos, auch für die kommerzielle Nutzung, und bleibt es. Die Schaltfläche Auf suppi.pl unterstützen öffnet die Seite https://suppi.pl/loonar, auf der Sie die Weiterentwicklung mit einem freiwilligen Beitrag unterstützen können; damit wird unter anderem ein Codesignaturzertifikat bezahlt. Unter „Weitere Möglichkeiten zu helfen“ finden Sie die Links „Quellcode auf GitHub“ und loonar.eu: Sie können Fehler und Ideen melden, die Anwendung anderen Enterprise-Architect-Nutzern empfehlen oder dem Projekt auf GitHub einen Stern geben.

Chat-Ansicht

• Die Liste der Unterhaltungen links ist in „Heute“, „Gestern“, „Letzte 7 Tage“ und „Älter“ gruppiert. Eine neue Unterhaltung beginnen Sie mit der Schaltfläche +. Die ausgewählte Unterhaltung ist hervorgehoben.
• Die Kopfzeile der Unterhaltung zeigt ihren Titel und, während der Assistent arbeitet, die Anzeige „Claude arbeitet“.
• Nachrichten: Ihre eigenen erscheinen in einer beigen Sprechblase, die Antworten des Assistenten tragen das Symbol der Anwendung. Bei jeder Nachricht steht die Uhrzeit (bei älteren auch das Datum).
• Der Bildschirm einer neuen Unterhaltung zeigt das Logo und einen Hinweis, was Sie tun können.
• Die Nachrichtenkarte unten: Textfeld, Schaltfläche Einfügen, Modell und Freigabemodus sowie runde Schaltflächen zum Senden und Abbrechen (Kapitel 6). Unter der Karte steht der Hinweis „Antworten und Änderungen werden von einem KI-Modell (Claude von Anthropic) erstellt und können Fehler enthalten. Prüfen Sie sie vor der Freigabe.“

5. Einstellungen und Sprache

Die Ansicht Einstellungen hat sechs Karten. Jede speichern Sie einzeln mit der Schaltfläche unter der Karte, und die Anwendung prüft sofort, ob die Daten funktionieren. Das Ergebnis erscheint unter der Schaltfläche: grün mit Beschreibung oder rot mit der Fehlerursache.

Ein leeres Passwort- oder Schlüsselfeld bedeutet „keine Änderung“. Der Hinweis gespeichert neben einem Feld zeigt an, dass der Wert bereits gespeichert ist. Alle Passwörter, der API-Schlüssel und das Confluence-Token liegen in der Windows-Anmeldeinformationsverwaltung, nicht in der Einstellungsdatei. Das Datenbankpasswort darf kein Semikolon (;) enthalten, da Enterprise Architect es sonst nicht in seiner Verbindungszeichenfolge übergeben kann.

Standardwerte. Solange noch keine Einstellungen vorhanden sind, gilt: Server, Datenbankname, EA-Benutzerkonto und Passwörter sind leer (beim Server zeigt ein grauer Hinweis „z. B. 127.0.0.1“), der Port ist 5432, das Datenbankkonto „postgres“, der Pfad zu EA.exe C:\Program Files\Sparx Systems\EA\EA.exe, der Freigabemodus ask, Max. Tokens 10000 und die Verschlüsselung „Bevorzugt“. Bestehende Einstellungen ändern weder das Setup noch die Anwendung.

Max. Tokens. Wenn der Assistent die Arbeit mit einer Meldung über eine abgeschnittene Antwort abbricht, erhöhen Sie diesen Wert (zum Beispiel auf 20000). Die Begrenzung selbst kostet nichts: Sie zahlen für den tatsächlich erzeugten Text.

Das Sperren von Paketen beim Speichern ist immer aktiviert und deshalb nicht in den Einstellungen enthalten.

Sprache ändern

Die Anwendung arbeitet in vier Sprachen: Polnisch, Englisch, Deutsch und Französisch. Die Sprache wählen Sie im Installationsprogramm (standardmäßig Englisch) und ändern sie auf der Karte „4. Sprache und Freigabe von Änderungen“:

1. Wählen Sie eine Sprache aus der Liste Sprache.
2. Klicken Sie auf Speichern. Die Oberfläche wechselt sofort in die neue Sprache, und der Assistent antwortet ab der nächsten Nachricht in ihr (schreiben Sie ihm in einer anderen Sprache, antwortet er in Ihrer).
3. Die Anwendung überträgt Ihre Inhalte in die neue Sprache: Unveränderte Standardvorlagen ersetzt sie durch die Versionen in der neuen Sprache, und das Gedächtnis des Assistenten sowie eigene und geänderte Vorlagen übersetzt Claude.

Übersetzt werden nur das Gedächtnis und die Vorlagen. Der Unterhaltungsverlauf wird nie übersetzt: Unterhaltungen bleiben in der Sprache, in der Sie sie geführt haben.

Verschlüsselung der Datenbankverbindung

Das Feld Verschlüsselung der Verbindung auf der Karte „2. Modelldatenbank (PostgreSQL)“ legt fest, ob der Assistent das Modell über TLS liest:

• Der Verbindungstest meldet, ob die Verbindung verschlüsselt ist: „Die Verbindung ist verschlüsselt (TLS).“ oder „Die Verbindung ist NICHT verschlüsselt: Der Server bietet kein TLS an.“
• Bei der Zertifikatsprüfung muss der Name im Feld Server mit dem Namen im Serverzertifikat übereinstimmen.
• Ist das Datenbankkonto ein Superuser, warnt der Test davor. Superuser-Rechte sind nicht nötig: Es genügt ein normales Konto mit Lese- und Schreibrechten auf die Tabellen des Modells (der Assistent liest die Datenbank nur, aber Enterprise Architect speichert die Änderungen mit demselben Konto).
• Der Datenbankadministrator kann TLS für alle Clients mit hostssl-Einträgen in der Datei pg_hba.conf erzwingen.
• Die Einstellung gilt für das Lesen des Modells durch den Assistenten. Die Verbindung von Enterprise Architect selbst zur Datenbank (beim Speichern) richtet sich nach den Einstellungen in EA.

6. Unterhaltung mit dem Assistenten

Schreiben

Die Nachricht geben Sie in der Nachrichtenkarte unten im Fenster ein. Die Karte enthält das Textfeld, die Schaltfläche Einfügen, den Namen des Modells und den aktuellen Freigabemodus sowie runde Schaltflächen: Senden und, während der Assistent arbeitet, Abbrechen. Darunter erinnert ein Hinweis daran, dass Antworten und Änderungen von einem KI-Modell erstellt werden und Fehler enthalten können: Prüfen Sie sie vor der Freigabe.

Das Nachrichtenfeld wächst mit dem Text. Rechtschreibfehler werden mit dem Windows-Systemwörterbuch rot unterstrichen, in der Sprache aus den Systemeinstellungen.

Anhänge

An eine Nachricht können Sie bis zu 5 Dateien mit je bis zu 10 MB anhängen. Möglichkeiten: Dateien in das Fenster ziehen (aus dem Explorer oder aus einem Browser), aus der Zwischenablage einfügen (Strg + V) oder die Schaltfläche Einfügen in der Nachrichtenkarte verwenden.

Während der Assistent arbeitet

• Unter den Nachrichten sehen Sie die Schrittkarte: was der Assistent gerade tut, wie lange es dauert und welches Ergebnis jeder Schritt hatte. In der deutschen Oberfläche zeigt die Karte kurze übersetzte Ergebnisse, zum Beispiel „Zeilen: 12“, „im EA-Modell gespeichert“, „Datei bereit“ oder „erledigt“; die vollständigen technischen Details zeigt nur die englische Oberfläche. Während der Arbeit ist die Karte aufgeklappt, nach Abschluss wird sie auf eine Zeile eingeklappt; ein Klick auf die Kopfzeile der Karte klappt sie wieder auf.
• Sie können weiterschreiben: Die nächste Nachricht kommt in eine Warteschlange, und der Assistent berücksichtigt sie beim nächsten Schritt, ohne die Arbeit zu unterbrechen.
• Die Schaltfläche Abbrechen beendet die Arbeit nach dem aktuellen Schritt. Ein bereits laufender Schritt (zum Beispiel das Speichern in EA) wird zu Ende geführt.
• Eine Antwort umfasst höchstens 24 Schritte. Ist der Assistent danach nicht fertig, bricht die Anwendung ab, um eine Endlosschleife zu vermeiden; setzen Sie die Arbeit mit einer neuen Nachricht fort (zum Beispiel „Mach weiter“).

Was kann der Assistent? Der Assistent kennt die Funktionen der Anwendung aus den Versionshinweisen. Fragen Sie ihn: „Was kannst du in dieser Anwendung?“.

7. Arbeiten mit dem EA-Modell

Schreiben Sie so, wie Sie einem Kollegen schreiben würden, der EA kennt. Nennen Sie Pakete und Diagramme beim Namen. Der Assistent bezeichnet Modellobjekte mit Namen, Paket und GUID. Nachfolgend Beispiele für Anfragen.

Lesen

Das angezeigte Diagramm erscheint im Chat als Bild. Darunter befinden sich die Schaltflächen Speichern unter… und In voller Größe öffnen.

Auswirkungsanalyse einer Änderung

Der Assistent geht vom angegebenen Element entlang der Beziehungen in die Tiefe des Modells (bis zu 6 Ebenen, in eine oder beide Richtungen, optional nur entlang ausgewählter Beziehungstypen). Für jedes betroffene Element nennt er die Beziehung, über die die Auswirkung ankommt, den Pfad vom Ausgangselement und die Diagramme, auf denen das Element liegt. Das Ergebnis erhalten Sie als Beschreibung, Bild, Word-Dokument oder Excel-Arbeitsmappe.

Wo Operationen verwendet werden

Für eine Klasse, eine Komponente oder eine Schnittstelle findet der Assistent, wo ihre Operationen (Services) aufgerufen werden: in Sequenzdiagrammen (Nachrichten an das Element oder seine Lebenslinie) und Aktivitätsdiagrammen (Aktionen, die die Operation aufrufen), mit Paket und Aufrufer. Er nennt auch die Operationen, die in keinem Diagramm verwendet werden.

Zeichnen

BPMN-Teilprozesse

• Eingebettet (embedded): Die Schritte des Teilprozesses sind seine Kindelemente und werden in seinem Rechteck im selben Diagramm gezeichnet.
• Eingeklappt (collapsed): Die Schritte liegen in einem separaten Diagramm, und ein Doppelklick auf den Teilprozess öffnet dieses Diagramm. Der Assistent kann einen Teilprozess (oder ein anderes Element) auch als Composite-Diagramm mit einem bestehenden Diagramm verknüpfen.
• Einem bestehenden Teilprozess fügt der Assistent neue Schritte hinzu.

Änderungen an einem bestehenden Modell

Der Assistent ändert auch Position und Größe eines Elements im Diagramm, ohne es zu entfernen (die Konnektoren bleiben erhalten), sowie Name, Beschreibung und Stereotyp eines bestehenden Diagramms. Ein Element kann er aus einem einzelnen Diagramm entfernen, ohne es aus dem Modell zu löschen.

Schlüsselwörter und Legenden

Der Assistent setzt Schlüsselwörter von Elementen (Feld Keywords in EA) und Tagged Values und erstellt eine Diagrammlegende mit automatischer Einfärbung wie in EA: Elemente (nach Schlüsselwort, Stereotyp, Status oder Typ) oder Konnektoren (zum Beispiel nach Stereotyp) erhalten eine Farbe aus der Legende, und die Legende zeigt Wert, Farbe und Beschriftung.

Konnektorlinien

• Linienverlauf (wie Line Style in EA): direkt, automatisch, benutzerdefiniert, orthogonal eckig, orthogonal abgerundet, Baum und lateral; für ausgewählte Konnektoren oder alle im Diagramm.
• Route eines Konnektors: Der Assistent führt die Linie durch angegebene Knickpunkte und Berührungspunkte mit den Seiten der Elemente, zum Beispiel nach einer Skizze auf einem Screenshot.
• Ausblenden von Konnektoren in einem einzelnen Diagramm (und erneutes Einblenden): Die Beziehung bleibt im Modell und in anderen Diagrammen erhalten, sodass Sie ein dichtes Diagramm entlasten, ohne Beziehungen zu löschen.

Paketkopie und Baseline

• Die Paketkopie erstellt ein Duplikat des Pakets mit dem gesamten Inhalt.
• Eine Baseline ist eine gespeicherte Version eines Pakets in EA. Der Assistent ist angewiesen, vor dem Löschen oder einem größeren Umbau eines bestehenden Pakets eine Baseline zu erstellen. Das ist jedoch keine erzwungene Sperre: Bitten Sie bei wichtigen Paketen ausdrücklich um eine Baseline und verwenden Sie den Modus ask.
• Die Wiederherstellung führen Sie in Enterprise Architect durch: Klicken Sie mit der rechten Maustaste auf das Paket, wählen Sie Manage Baselines, markieren Sie die Baseline und verwenden Sie Compare/Restore. Der Assistent stellt Baselines nicht selbst wieder her, da die Wiederherstellung per Automatisierung EA zum Hängen bringt.

Gut zu wissen

• Der erste Aufruf von EA dauert einige bis über zehn Sekunden, weil die Anwendung Enterprise Architect im Hintergrund startet und das Modell öffnet. Weitere Speicherungen und Diagrammabrufe dauern dann weniger als eine Sekunde. Nach 10 Minuten ohne Aufrufe schließt sich EA im Hintergrund und gibt die Lizenz frei. Auch das Schließen der Anwendung schließt ihre EA-Sitzung.
• Sperren. In einem Modell mit aktivierter Sicherheit sperrt der Assistent ein Objekt für die Dauer des Speicherns auf sein Konto und hebt die Sperre danach auf. Ein von einem anderen Benutzer gesperrtes Objekt ändert er nicht; die Meldung nennt, wer das Element sperrt (Konto oder Gruppe, seit wann), sein Paket und Diagramm.
• Löschen ist endgültig. Das Löschen eines Pakets löscht seinen gesamten Inhalt. Verwenden Sie bei wichtigen Modellen den Modus ask (Kapitel 12), lassen Sie Baselines erstellen und sichern Sie die Datenbank.
• Teilweise Speicherung. Ein Speichervorgang kann mehrere Operationen umfassen. Schlägt eine davon fehl, bleiben die vorherigen Operationen desselben Vorgangs im Modell; die Meldung nennt, was gespeichert wurde.
• Prüfen Sie das Ergebnis. Der Assistent kann sich irren: ein Foto falsch lesen, einen anderen Elementtyp wählen oder ein Diagramm unübersichtlich anordnen. Lassen Sie sich das Diagramm nach den Änderungen anzeigen und bitten Sie bei Bedarf um Korrekturen.
• Große Diagramme speichert der Assistent in mehreren Schritten. Das ist normal.

8. Arbeiten mit dem geöffneten EA-Fenster

Wenn Sie in Enterprise Architect dasselbe Modell geöffnet haben, arbeitet der Assistent mit Ihrem EA-Fenster zusammen:

• er weiß, was Sie geöffnet und ausgewählt haben: welches Diagramm geöffnet ist und welche Elemente im Diagramm oder im Projekt-Browser ausgewählt sind. Sie können also „dieses Element“ oder „die ausgewählten Aufgaben“ schreiben,
• er öffnet Diagramme in Ihrem EA-Fenster und zeigt Elemente im Projekt-Browser an,
• nach dem Speichern aktualisiert er die geänderten Diagramme und Pakete in Ihrem Fenster selbst, ohne dass Sie F5 drücken müssen.

Nur wenn das EA-Fenster nicht geöffnet ist oder ein anderes Modell zeigt, arbeitet der Assistent ohne diese Zusammenarbeit, und Sie sehen die Änderungen nach dem Aktualisieren des Pakets in EA (F5). Anmeldedaten aus der Verbindung Ihres EA-Fensters (Konto, Passwort) gehen nie an das Modell.

9. Dokumente (Word, Excel, PNG, Confluence)

Der Assistent erstellt Dokumente aus den Inhalten des Modells und der Unterhaltung. Die fertige Datei erscheint im Chat als Karte mit Schaltflächen.

Confluence-Seiten

Der Assistent erstellt eine Seite im Format des Confluence-Quelltext-Editors (Storage-XHTML): Überschriften, Tabellen, Listen, Inhaltsverzeichnis, Panels (Info, Hinweis, Warnung, Tipp, aufklappbarer Abschnitt), Status, Jira-Vorgänge, Erwähnungen von Personen und Codeblöcke. Diagramme aus EA und Bilder werden als Anhänge beigefügt.

Manuelles Einfügen (ohne Confluence-Einstellungen):

1. Klicken Sie auf der Seitenkarte auf Seitencode kopieren.
2. Öffnen Sie in Confluence die Seite zum Bearbeiten und den Quelltext-Editor (Source Editor), fügen Sie den Code ein und bestätigen Sie.
3. Klicken Sie auf Bilderordner öffnen und fügen Sie die Bilder der Seite als Anhänge hinzu.

Veröffentlichung durch den Assistenten. Nachdem Sie die Karte „6. Confluence“ ausgefüllt haben, veröffentlicht der Assistent die Seite auf Ihre Bitte über die REST-API: Er legt eine neue Seite unter der übergeordneten Seite an oder aktualisiert eine bestehende (angegeben per ID oder Titel). Bilder werden als Anhänge hochgeladen; bestehende erhalten eine neue Version. Diagramme werden bei jeder Veröffentlichung neu aus EA exportiert, sodass eine erneute Veröffentlichung die Seite nach Änderungen im Modell aktualisiert. Der Assistent merkt sich die Seiten, die er veröffentlicht hat. Die Verbindung zu Confluence läuft ausschließlich über HTTPS.

Speichern Sie die Karte mit der Schaltfläche Speichern und Confluence-Verbindung prüfen.

10. Dokumentvorlagen

Eine Vorlage sagt dem Assistenten, wie er ein Dokument aufbauen soll: welche Abschnitte es haben soll und was darin stehen soll. Der Assistent füllt sie mit Inhalten aus dem Modell und der Unterhaltung und erstellt daraus eine Confluence-Seite oder ein Word-Dokument.

Nach der Installation stehen folgende Standardvorlagen in der gewählten Sprache zur Verfügung:

• Vorläufige Machbarkeitsanalyse,
• BRD - Geschäftsanforderungen,
• Beschreibung der Systemänderungen,
• Prozessbeschreibung.

Die Ansicht „Dokumentvorlagen“

• Liste der Vorlagen mit kurzer Beschreibung.
• Verwenden fügt im Chat eine Anfrage ein, nach der Vorlage ein Dokument zu erstellen (standardmäßig eine Confluence-Seite). Ergänzen Sie sie, zum Beispiel um den Namen eines Pakets oder Prozesses, und senden Sie sie. Möchten Sie stattdessen ein Word-Dokument, schreiben Sie das in die Anfrage.
• Bearbeiten öffnet die Vorlagendatei im Windows-Editor.
• Vorlagenordner öffnen öffnet den Ordner templates im Explorer (ältere Installationen verwenden möglicherweise noch den Ordner szablony).

Eigene Vorlagen

Vorlagen sind Markdown-Dateien mit Hinweisen für den Assistenten. Die erste Zeile hat die Form > Vorlage: Beschreibung; die Beschreibung erscheint in der Liste. Weitere Zeilen, die mit > beginnen, sind Hinweise für den Assistenten. Sie können bestehende Vorlagen ändern, eigene Dateien in den Vorlagenordner legen oder den Assistenten bitten, eine Vorlage aus einem Beispieldokument zu erstellen:

Speichert oder überschreibt der Assistent eine Vorlage, fragt er in den Modi ask und plan vorher nach Ihrer Freigabe („Dokumentvorlage „…“ überschreiben“).

11. Gedächtnis des Assistenten

Der Assistent merkt sich Festlegungen über Unterhaltungen hinweg: Modellierungskonventionen, Ihre Präferenzen, Korrekturen und Fakten zu Projekten. Er kennt sie in jeder neuen Unterhaltung. Eine Festlegung zum selben Thema wird aktualisiert statt verdoppelt, veraltete werden entfernt.

Der Assistent speichert Festlegungen selbst, wenn er etwas Dauerhaftes erfährt (und sagt das in einem Satz), oder auf Ihre Bitte, zum Beispiel mit „merk dir…“:

In den Modi ask und plan fragt die Anwendung vor dem Speichern einer Festlegung nach Ihrer Freigabe („Notiz im Gedächtnis des Assistenten speichern“). Das Speichern unterbricht die Arbeit des Assistenten an der aktuellen Aufgabe nicht. Der gesamte Inhalt des Gedächtnisses geht mit jeder Anfrage an Anthropic (Kapitel 14): Speichern Sie dort keine Passwörter oder vertraulichen Daten.

Die Ansicht „Gedächtnis des Assistenten“

• Liste der Festlegungen mit Datum.
• Entfernen löscht die ausgewählte Festlegung.
• Gedächtnisordner öffnen öffnet den Ordner memory im Explorer. Die Festlegungen sind darin Markdown-Dateien, die Übersicht steht in der Datei MEMORY.md.

12. Freigabe von Änderungen und Änderungsprotokoll

Den Modus stellen Sie in der Ansicht Einstellungen auf Karte 4 ein. Er bestimmt, ob und wann die Anwendung vor dem Speichern in EA um Freigabe bittet. Das Lesen des Modells und das Anzeigen von Diagrammen erfordern nie eine Freigabe. Der aktuelle Modus ist auch in der Nachrichtenkarte zu sehen.

Wenn eine Freigabe nötig ist, erscheint über dem Nachrichtenfeld das Panel „Claude möchte Änderungen im Modell speichern“ mit einer Beschreibung der Änderungen (wie viele Pakete, Diagramme, Elemente, Konnektoren, was gelöscht wird) und den Schaltflächen Freigeben und Ablehnen. Beim Löschen, Verschieben und Kopieren nennt es die Objekte mit Namen, zum Beispiel „LÖSCHEN: Paket „Archiv““ oder „KOPIE des Pakets „Onlineshop“ mit dem gesamten Inhalt“. Ein abgelehntes Speichern ändert das Modell nicht; der Assistent erhält die Information über die Ablehnung und kann etwas anderes vorschlagen.

Über dasselbe Panel laufen in den Modi ask und plan auch das Speichern einer Festlegung im Gedächtnis des Assistenten (Kapitel 11) und das Überschreiben einer Dokumentvorlage (Kapitel 10). Die Veröffentlichung in Confluence fragt in jedem Modus (Kapitel 9).

Änderungsprotokoll

Jede Speicherung des Assistenten im EA-Modell, auch eine fehlgeschlagene, wird im Änderungsprotokoll erfasst (Datei audit_log.jsonl im Benutzerdatenordner). Nicht erfasst werden Speicherungen, die Sie abgelehnt haben, und Operationen, die die Anwendung nicht zum Speichern zugelassen hat; auch Gedächtnis, Vorlagen und Veröffentlichungen in Confluence stehen nicht im Protokoll.

Die Ansicht Änderungsprotokoll (Symbol „Änderungsprotokoll des Modells“) zeigt die letzten 200 Einträge, die neuesten zuerst: Ergebnis (OK oder FEHLER), Zeit, EA-Konto und Datenbank, die Beschreibung der Änderungen und gegebenenfalls den Fehlertext. Die Schaltfläche Nach Excel exportieren speichert das gesamte Protokoll als XLSX-Arbeitsmappe (Spalten: Zeit, Ergebnis, EA-Konto, Datenbank, Modus, Änderungen, Erstellt, Fehler), zum Beispiel für eine Durchsicht der Änderungen im Team. Protokolldatei öffnen öffnet die Protokolldatei im Windows-Editor.

13. Unterhaltungen

• Neue Unterhaltung: die Schaltfläche + über der Liste der Unterhaltungen. Jede Unterhaltung wird gespeichert und ist nach einem Neustart der Anwendung wieder da.
• Gruppen: Die Unterhaltungen sind in „Heute“, „Gestern“, „Letzte 7 Tage“ und „Älter“ gruppiert.
• Suche: Das Feld „Unterhaltungen durchsuchen…“ filtert die Liste nach Titel und nach Nachrichteninhalt.
• Umbenennen: Klicken Sie auf den Stift neben der ausgewählten Unterhaltung, geben Sie einen Namen ein; Eingabe speichert, Esc bricht ab.
• Löschen: In der Anwendung lassen sich Unterhaltungen nicht löschen. Bei Bedarf löschen Sie die Datei der Unterhaltung im Ordner history des Benutzerdatenordners (Kapitel 14).
• Mehrere Unterhaltungen gleichzeitig: Während der Assistent arbeitet, können Sie eine neue Unterhaltung beginnen oder zu einer anderen wechseln. Die begonnene Arbeit läuft im Hintergrund weiter.

Speicherungen in EA aus verschiedenen Unterhaltungen werden nacheinander ausgeführt, nicht gleichzeitig. Wenn der Chat nach oben gescrollt ist, bringt Sie der Kreis mit dem Pfeil über dem Nachrichtenfeld zum Ende der Unterhaltung.

14. Daten, Sicherheit und Datenschutz

Wo Ihre Daten liegen

Der Unterhaltungsverlauf wird als normale Dateien in Ihrem Windows-Profil gespeichert. Er ist durch Ihr Windows-Konto geschützt, wird von der Anwendung aber nicht zusätzlich verschlüsselt. Schützen Sie den Zugang zu Ihrem Konto und geben Sie den Datenordner nicht weiter.

Was an Anthropic gesendet wird

Damit der Assistent antworten kann, sendet die Anwendung mit Ihrem Schlüssel bei jeder Anfrage an den Dienst Claude (Anthropic): die Unterhaltung, die angehängten Dateien, den gesamten Inhalt des Gedächtnisses des Assistenten, die Liste der Vorlagen mit ihren Beschreibungen sowie das, was der Assistent in der jeweiligen Unterhaltung aus dem Modell gelesen hat, also die Ergebnisse seiner Datenbankabfragen (Namen und Beschreibungen von Paketen, Elementen, Diagrammen) und Bilder der angezeigten Diagramme. Es wird nicht die gesamte Datenbank gesendet, sondern nur das, wonach der Assistent gefragt hat. Den Inhalt einer Vorlage erhält Claude, wenn der Assistent sie verwendet, und nach einem Sprachwechsel gehen auch die zu übersetzenden Inhalte von Gedächtnis und Vorlagen an Claude.

Die Daten gehen mit Ihrem API-Schlüssel direkt an Anthropic. Loonar erhält sie nicht, und die Anwendung erfasst keine Nutzungsdaten (keine Telemetrie).

Berechtigungen des Assistenten

• Die Datenbank liest der Assistent in einer schreibgeschützten Sitzung, ausschließlich mit SELECT- und WITH-Abfragen, mit einem Zeitlimit für Abfragen und ohne Serverfunktionen, die Dateien lesen oder andere Sitzungen beeinflussen. Alle Änderungen laufen über Enterprise Architect, mit dem in den Einstellungen angegebenen Konto, sodass für sie die Berechtigungen und Sperren dieses Kontos gelten.
• In Confluence arbeitet der Assistent mit den Berechtigungen des Tokens von Karte 6 und veröffentlicht nur nach Ihrer Freigabe.
• Der Assistent hat keinen Zugriff auf Dateien auf der Festplatte außer denen, die Sie ihm selbst anhängen, und außer seinen Gedächtnis- und Vorlagenordnern. Bilder, die der Assistent zeichnet, können keine Dateien von der Festplatte oder aus dem Netz laden.
• Inhalte von Anhängen, Dokumenten, Seiten und dem Modell behandelt der Assistent als Daten, nicht als Anweisungen: Er führt dort gefundene Anweisungen nicht aus und sendet keine Daten an Stellen, die solche Inhalte nennen.
• Anmeldedaten aus der Verbindung des geöffneten EA-Fensters gehen nie an das Modell.

Netzwerk und Verschlüsselung

• Die Claude-API und Confluence werden ausschließlich über HTTPS angesprochen.
• Die Verbindung zur Modelldatenbank unterstützt TLS (Karte 2, Kapitel 5). Administratoren können TLS für alle Clients mit hostssl-Einträgen in pg_hba.conf erzwingen. Die Verbindung von Enterprise Architect selbst zur Datenbank richtet sich nach den Einstellungen in EA.
• Die Anwendung verwendet den Proxy aus den Windows-Interneteinstellungen sowie die Umgebungsvariablen HTTPS_PROXY und ALL_PROXY. Proxy-Skripte (PAC) und die NTLM-/Kerberos-Authentifizierung am Proxy werden nicht unterstützt.
• Vorübergehende Fehler der Claude-API (Überlastung 529 oder andere 5xx-Fehler, Anfragelimit 429) wiederholt die Anwendung automatisch.

15. Fehlerbehebung

16. Fehlermeldungen und Neuigkeiten

Fehler melden

1. Klicken Sie in der Navigationsleiste auf das Symbol Fehler melden.
2. Geben Sie Betreff und Beschreibung ein: was Sie getan haben, was Sie erwartet haben, was passiert ist. Die Beschreibung ist erforderlich; Sie können darin den Fehlertext aus dem Chat einfügen.
3. Fügen Sie Bilder hinzu, zum Beispiel Screenshots: Ziehen Sie sie in das Fenster, fügen Sie sie aus der Zwischenablage ein (Strg + V) oder wählen Sie sie mit + Bild hinzufügen von der Festplatte. Hinzugefügte Bilder werden als Miniaturansichten angezeigt; zusammen dürfen sie höchstens 15 MB groß sein.
4. Geben Sie optional die E-Mail-Adresse an, an die ich antworten soll. Die Option „Technische Informationen anhängen“ (Anwendungsversion, System, Modell, Freigabemodus, letzte Meldung; ohne Passwörter und Schlüssel) ist standardmäßig aktiviert; Sie können sie abwählen.
5. Klicken Sie auf Meldung senden. Im Windows-E-Mail-Programm öffnet sich eine fertige Nachricht an den Autor (mariusz@loonar.eu) mit den Bildern als Anhängen. Prüfen Sie sie und senden Sie sie.

Ein Hinweis im Formular erklärt, wofür die Meldung verwendet wird (nur für die Antwort und die Verbesserung der Anwendung, Aufbewahrung bis zu 2 Jahre nach Abschluss der Angelegenheit), mit einem Link zur Datenschutzerklärung. Entfernen Sie vor dem Senden personenbezogene und vertrauliche Daten aus den Screenshots.

Die Anwendung legt für das E-Mail-Programm temporäre Kopien der Bilder an und löscht sie, sobald das E-Mail-Programm sie übernommen hat. Nimmt das E-Mail-Programm keine Anhänge von anderen Anwendungen an, öffnet sich eine Nachricht ohne Bilder sowie der Ordner mit den Bildern: Ziehen Sie sie in die Nachricht. Nur in diesem Fall bleiben die Kopien im Ordner.

Neue Versionen (Newsletter)

Geben Sie auf der Karte „5. Neue Versionen (Newsletter)“ in den Einstellungen Ihre E-Mail-Adresse ein, aktivieren Sie das Kontrollkästchen „Ich möchte über neue Versionen informiert werden“ und klicken Sie auf Speichern. Sie erhalten dann eine kurze E-Mail, wenn eine neue Version erscheint, mit einer Beschreibung der Änderungen und der Angabe, wo Sie sie herunterladen können; keine Werbung. Ihre Wahl wird in den Einstellungen gespeichert, An- und Abmeldung gehen als Nachricht aus dem E-Mail-Programm an den Autor.

Ihre Adresse wird nur für Informationen zu neuen Versionen verwendet, auf Grundlage Ihrer Einwilligung, bis Sie diese widerrufen: Entfernen Sie das Häkchen und speichern Sie, oder schreiben Sie eine E-Mail an mariusz@loonar.eu. Verantwortlicher ist Loonar Mariusz Głowacki; Einzelheiten stehen in der Datenschutzerklärung, die auf der Karte verlinkt ist.

18. Lizenz, Marken und Kontakt

Lizenz. Loonar Compass ist Freeware. Kurz zusammengefasst:

• Die Nutzung ist kostenlos, auch beruflich und kommerziell, auf beliebig vielen Computern und ohne zeitliche oder räumliche Beschränkung.
• Kopieren und an andere weitergeben dürfen Sie die Anwendung nur unentgeltlich, vollständig und unverändert, zusammen mit den Dateien LICENSE und THIRD-PARTY-NOTICES.
• Ohne schriftliche Zustimmung des Lizenzgebers ist es nicht gestattet, die Anwendung zu ändern, zu dekompilieren, zu verkaufen oder zu vermieten (ausgenommen Rechte, die vertraglich nicht ausgeschlossen werden können).
• Antworten, Modelländerungen und Dokumente erstellt ein KI-Modell: Prüfen Sie sie vor der Freigabe, den Modus auto aktivieren Sie auf eigenes Risiko, und sichern Sie das Modell, bevor Sie mit der Anwendung arbeiten.
• Die Anwendung erhebt keine Daten (keine Telemetrie); die für eine Antwort nötigen Inhalte gehen direkt an Anthropic, auf Grundlage Ihres Vertrags mit Anthropic.
• Enterprise Architect, die Claude-API, Confluence und andere Dienste erfordern eigene Lizenzen und Konten ihrer Anbieter; deren Entgelte tragen Sie.

Verbindlich ist die polnische Fassung der Lizenz; die englische, deutsche und französische Fassung sind Übersetzungen. Der vollständige Text befindet sich in der Ansicht Info sowie in der Datei LICENSE.txt im Installationsordner (die verbindliche polnische Fassung in LICENSE.pl.txt). Die Liste der Funktionen und bekannten Einschränkungen dieser Version finden Sie in der Ansicht Versionshinweise.

Datenschutz und Impressum. Datenschutzerklärung: https://loonar.eu/de/privacy/. Impressum: https://loonar.eu/de/legal/. Den Link zur Datenschutzerklärung finden Sie auch in der Ansicht Info, im Formular zum Melden von Fehlern und auf der Newsletter-Karte.

Quellcode und Open-Source-Komponenten. Der Quellcode der Anwendung ist öffentlich: https://github.com/loonar-eu/loonar-compass. Die Anwendung enthält Open-Source-Bibliotheken und -Schriftarten; jede behält ihre eigene Lizenz. Die Liste steht in der Datei THIRD-PARTY-NOTICES.txt im Installationsordner; in der Ansicht Info öffnet sie die Schaltfläche Lizenzen der Komponenten anzeigen im Abschnitt „Open-Source-Komponenten“.

Marken. Sparx Systems und Enterprise Architect sind eingetragene Marken der Sparx Systems Pty Ltd. Claude und Anthropic sind Marken der Anthropic, PBC. Atlassian, Confluence und Jira sind Marken von Atlassian. Microsoft, Windows, Word und Excel sind Marken der Microsoft-Unternehmensgruppe. PostgreSQL ist eine Marke der PostgreSQL Community Association of Canada. Loonar Compass ist ein unabhängiges Produkt, steht in keiner Verbindung zu diesen Unternehmen und wird von ihnen weder unterstützt noch gesponsert.

Eigentümer und Kontakt. Loonar Mariusz Głowacki, ul. Gombrowicza 12, 73-110 Stargard.
E-Mail: mariusz@loonar.eu, Website: https://loonar.eu (mit Fragen und Antworten). Fehler melden Sie am bequemsten über die Ansicht Fehler melden (Kapitel 16). Sicherheitsprobleme melden Sie bitte vertraulich per E-Mail an mariusz@loonar.eu mit dem Betreff „Security: Loonar Compass“, nicht in einem öffentlichen Issue auf GitHub.

Projekt unterstützen. Die Weiterentwicklung der Anwendung können Sie freiwillig unter https://suppi.pl/loonar unterstützen (Ansicht Projekt unterstützen, Kapitel 4).

Loonar Compass 0.3 · © 2026 Loonar Mariusz Głowacki. Alle Rechte vorbehalten.