diff --git a/README.md b/README.md index 205246d..1de1848 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,12 @@ CRM im perinco Corporate Design. Vite/React-Frontend, Express-Backend, MariaDB. Enthält den portierten *Projekt Scanner* und die lesende Anbindung des Vertriebspostfachs `crm@perinco.de` über Microsoft Graph. +![Opportunities im perinco CRM](docs/bilder/opportunities-kacheln.png) + +*Beispieldaten - Firmen, Personen und Zahlen in allen Abbildungen sind erfunden. +Die Bildstrecke aller Bereiche steht in der +[Anleitung für Benutzer](docs/07-anleitung-benutzer.md).* + > **Dokumentation mit Funktionszeichnungen:** [`docs/`](docs/README.md) > — Architektur, Datenmodell, Scanner-Ablauf, Diktat, Frontend, Betrieb, > [Postfachanbindung](docs/11-postfach.md). diff --git a/docs/07-anleitung-benutzer.md b/docs/07-anleitung-benutzer.md index 2a412ea..d39af31 100644 --- a/docs/07-anleitung-benutzer.md +++ b/docs/07-anleitung-benutzer.md @@ -53,10 +53,15 @@ die Scanner-Einstellungen. Alles andere ist für beide Rollen gleich. zusammen - hilfreich auf kleinen Bildschirmen. * Rechts oben schaltet zwischen hellem und dunklem Design. Ein **Doppelklick** auf den Schalter folgt wieder der Systemeinstellung. + + ![Dieselbe Ansicht im dunklen Design](bilder/aus-mails-dunkel.png) * Die Menüpunkte **Kontakte** und **Scanner** klappen beim Anklicken ihre Unterpunkte auf. Die Zahl neben *Aus Mails* sagt, wie viele Funde aus dem Postfach noch auf eine Entscheidung warten. +> Alle Abbildungen in dieser Anleitung zeigen die Anwendung mit **erfundenen +> Beispieldaten**. Firmen, Personen und Zahlen darin gibt es nicht. + ## Opportunities Der Startbereich: eine Opportunity ist ein Geschäft in Arbeit. Oben rechts @@ -68,6 +73,13 @@ wechselt man die Darstellung: | **Liste** | viele Einträge vergleichen, Spaltenköpfe sortieren | | **Pipeline** | Fortschritt durch die Phasen, Karten per Maus verschieben | +![Opportunities in der Kachelansicht](bilder/opportunities-kacheln.png) + +Die **Pipeline** zeigt dieselben Opportunities nach Phasen sortiert. Über jeder +Spalte steht ihr Volumen; eine Karte wird per Maus in die nächste Phase gezogen. + +![Pipeline-Ansicht mit den Phasen von Neu bis Verloren](bilder/opportunities-pipeline.png) + **Volumen** rechnet die Anwendung selbst: Tagessatz x Personentage. Das **gewichtete** Volumen multipliziert das noch mit der Abschlusswahrscheinlichkeit. Beide Zahlen stehen live im Formular, auf jeder Karte, als Summe über der Liste, @@ -88,6 +100,8 @@ Auswahlfeld direkt auf der Karte ändern. Ein **gemeinsamer** Teamkalender - alle sehen dieselben Termine, jeder darf eintragen. +![Monatsansicht des Kalenders](bilder/kalender-monat.png) + * **Monat, Woche, Tag** oben umschalten, `Heute` und die Pfeile blättern. * Klick auf einen Monatstag oder eine Stundenzelle legt sofort einen Termin an. * Klick auf einen Wochentagskopf springt in die Tagesansicht. @@ -108,6 +122,12 @@ eintragen. * Rechts stehen die **nächsten Termine**, nach Tagen gruppiert. Vergangenes fliegt aus der Liste, bleibt im Kalender aber erhalten. +![Wochenansicht des Kalenders mit Terminen dreier Benutzer](bilder/kalender-woche.png) + +Die Farbe eines Termins gehört zu seinem Ersteller - die Legende unter dem +Kalender löst auf, welche Farbe zu wem gehört. Rechts stehen die nächsten +Termine mit Beschreibung, Teilnehmern und den markierten Personen. + Ändern und löschen darf nur der **Ersteller** oder ein **Administrator**. Anlegen darf jeder. @@ -121,11 +141,20 @@ Drei Ansichten, davon eine besondere: | **Liste** | sortierbar, viele Einträge | | **Netzwerk** | wer steht mit wem in Kontakt | +![Kontakte in der Kachelansicht](bilder/kontakte-kacheln.png) + +Ein Klick auf eine Karte öffnet den Kontakt zum Bearbeiten - mit Foto, Anschrift, +Status, Zuständigkeit, Tags, Notizen und den Verbindungen zu anderen Kontakten. + +![Dialog "Neuer Kontakt" mit allen Feldern](bilder/kontakt-dialog.png) + Im **Netzwerk** sind Kreise Kontakte (Farbe = Status, Größe = Anzahl Verbindungen) und Quadrate Benutzer, die Kontakte angelegt haben. Grüne Linien verbinden Kontakte untereinander, graue gestrichelte den Ersteller mit seinem Kontakt. +![Netzwerkansicht mit Kontakten, Verbindungen und Erstellern](bilder/kontakte-netzwerk.png) + Bedienung: Hintergrund ziehen verschiebt, Mausrad zoomt, einen Knoten ziehen setzt ihn fest (grüner Punkt), Doppelklick löst ihn wieder. Über *Verbindung erstellen* zwei Kontakte anklicken, um eine Verbindung anzulegen; `Esc` bricht ab. @@ -145,6 +174,8 @@ hat. **Sie sind noch keine Kontakte**: sie erscheinen nicht in der Kontaktliste, nicht in Opportunities und nicht im Kalender. Jede Karte zeigt alle gefundenen Angaben und darunter, aus welcher Mail sie stammen. +![Vorbereich "Aus Mails" mit zwei neuen Personen und einer gold markierten Dublette](bilder/aus-mails.png) + Zwei Fälle: * **Weiße Karte** - die Person ist neu. *In Kontakte übernehmen* legt sie als @@ -158,6 +189,8 @@ Zwei Fälle: kann aus einer alten Signatur stammen. *Neu anlegen* erzeugt trotz Dublette einen zweiten Kontakt, etwa wenn es zwei Personen mit demselben Namen gibt. +![Feldauswahl: eine überschreibende Adresse und eine ergänzende Mobilnummer](bilder/aus-mails-feldauswahl.png) + Weitere Bedienelemente: * **Alle neuen übernehmen** legt alle weißen Karten auf einmal als Kontakte an; @@ -189,6 +222,8 @@ Listeneintrag sagen, was noch zu tun ist: | **2 Kontakte** | so viele Kontakt-Vorschläge warten noch auf eine Entscheidung | | 📎 | Anhänge vorhanden (im Postfach, nicht im CRM) | +![Postfachansicht: Mailliste links, gewählte Mail mit Zuordnungen rechts](bilder/mails-postfach.png) + Das Auswahlfeld filtert die Liste. **Nicht zugeordnet** ist die eigentliche Arbeitsliste: alles, was noch nirgends hängt. Die Suche geht über Betreff, Absender und den kompletten Mailtext; mehrere Wörter wirken als ein Suchbegriff. @@ -218,6 +253,8 @@ Der Balken rechts ist die Zuversicht: je voller und grüner, je verlässlicher d Angaben. Das Kennzeichen darunter sagt, woher sie stammen (*Absender*, *Empfänger*, *Signatur*, *Im Text genannt*). +![Reiter Kontakt-Vorschläge mit Zuversicht und Herkunft je Vorschlag](bilder/mails-vorschlaege.png) + Zwei Knöpfe: * **Als Kontakt anlegen** - es entsteht sofort ein richtiger Kontakt mit Herkunft @@ -263,6 +300,8 @@ KI-Auswertung mit Pro und Contra, dazu die Knöpfe *Gesehen*, *Beworben*, Über der Liste steht der Betriebszustand: *automatische Suche aktiv*, *nur manuelle Suche*, *pausiert* oder *Suchlauf läuft*. +![Scanner-Dashboard mit Kennzahlen und bewerteten Treffern](bilder/scanner-dashboard.png) + ### Ton bei neuen Treffern Findet der Scanner einen Treffer über dem Wert *Hinweis ab %*, spielt das @@ -296,6 +335,8 @@ Ein Suchagent ist ein Berater: | **Lebenslauf (PDF)** | wird als Text ausgelesen und gegen jedes Projekt bewertet | | **aktiv** | nur aktive Agenten suchen im Hintergrund | +![Liste der Suchagenten mit Suchbegriffen und Lebenslauf](bilder/scanner-suchagenten.png) + Ohne Lebenslauf kann ein Agent nichts bewerten. Die Ausschluss-Begriffe sind nicht nur Bequemlichkeit: sie greifen **vor** der KI-Bewertung und sparen damit echte Kosten. „Arbeitnehmerüberlassung" oder „Festanstellung" sind typische @@ -318,6 +359,8 @@ Zeigt für jede Börse, ob die Verbindung steht. Zwei Arten: Browser-Erweiterung *Cookie-Editor* als JSON und fügt sie unter **Cookie-Import** ein. +![Börsen-Konten mit Verbindungsstatus je Portal](bilder/scanner-boersen.png) + *Jetzt prüfen* testet eine Verbindung sofort. Steht dort **Abgelaufen / CAPTCHA**, hilft nur ein neuer Cookie-Import. @@ -349,6 +392,8 @@ Zugriff auf `crm@perinco.de`. Schlägt etwas fehl, nennt die Meldung den wahrscheinlichen Grund. Darunter lassen sich Intervall, Zeitraum des ersten Durchlaufs und die automatische Kontaktübernahme einstellen. +![Einstellungen, Reiter Postfach: Zustand des Abgleichs und Schalter](bilder/einstellungen-postfach.png) + Die Zugangsdaten selbst stehen **nicht** in der Oberfläche, sondern in der Serverkonfiguration - sie werden beim Start gelesen. Fehlt einer, sagt die Seite welcher. diff --git a/docs/bilder/aus-mails-dunkel.png b/docs/bilder/aus-mails-dunkel.png new file mode 100644 index 0000000..34fc9a7 Binary files /dev/null and b/docs/bilder/aus-mails-dunkel.png differ diff --git a/docs/bilder/aus-mails-feldauswahl.png b/docs/bilder/aus-mails-feldauswahl.png new file mode 100644 index 0000000..e62a6ba Binary files /dev/null and b/docs/bilder/aus-mails-feldauswahl.png differ diff --git a/docs/bilder/aus-mails.png b/docs/bilder/aus-mails.png new file mode 100644 index 0000000..cffa8b6 Binary files /dev/null and b/docs/bilder/aus-mails.png differ diff --git a/docs/bilder/einstellungen-postfach.png b/docs/bilder/einstellungen-postfach.png new file mode 100644 index 0000000..1f61817 Binary files /dev/null and b/docs/bilder/einstellungen-postfach.png differ diff --git a/docs/bilder/kalender-monat.png b/docs/bilder/kalender-monat.png new file mode 100644 index 0000000..7cf02a0 Binary files /dev/null and b/docs/bilder/kalender-monat.png differ diff --git a/docs/bilder/kalender-woche.png b/docs/bilder/kalender-woche.png new file mode 100644 index 0000000..4102e7f Binary files /dev/null and b/docs/bilder/kalender-woche.png differ diff --git a/docs/bilder/kontakt-dialog.png b/docs/bilder/kontakt-dialog.png new file mode 100644 index 0000000..07e2eee Binary files /dev/null and b/docs/bilder/kontakt-dialog.png differ diff --git a/docs/bilder/kontakte-kacheln.png b/docs/bilder/kontakte-kacheln.png new file mode 100644 index 0000000..0a6170d Binary files /dev/null and b/docs/bilder/kontakte-kacheln.png differ diff --git a/docs/bilder/kontakte-netzwerk.png b/docs/bilder/kontakte-netzwerk.png new file mode 100644 index 0000000..97e21ed Binary files /dev/null and b/docs/bilder/kontakte-netzwerk.png differ diff --git a/docs/bilder/mails-postfach.png b/docs/bilder/mails-postfach.png new file mode 100644 index 0000000..8c1e066 Binary files /dev/null and b/docs/bilder/mails-postfach.png differ diff --git a/docs/bilder/mails-vorschlaege.png b/docs/bilder/mails-vorschlaege.png new file mode 100644 index 0000000..aeac512 Binary files /dev/null and b/docs/bilder/mails-vorschlaege.png differ diff --git a/docs/bilder/opportunities-kacheln.png b/docs/bilder/opportunities-kacheln.png new file mode 100644 index 0000000..5526020 Binary files /dev/null and b/docs/bilder/opportunities-kacheln.png differ diff --git a/docs/bilder/opportunities-pipeline.png b/docs/bilder/opportunities-pipeline.png new file mode 100644 index 0000000..02dc371 Binary files /dev/null and b/docs/bilder/opportunities-pipeline.png differ diff --git a/docs/bilder/scanner-boersen.png b/docs/bilder/scanner-boersen.png new file mode 100644 index 0000000..a367785 Binary files /dev/null and b/docs/bilder/scanner-boersen.png differ diff --git a/docs/bilder/scanner-dashboard.png b/docs/bilder/scanner-dashboard.png new file mode 100644 index 0000000..fdb0173 Binary files /dev/null and b/docs/bilder/scanner-dashboard.png differ diff --git a/docs/bilder/scanner-suchagenten.png b/docs/bilder/scanner-suchagenten.png new file mode 100644 index 0000000..caa4337 Binary files /dev/null and b/docs/bilder/scanner-suchagenten.png differ