perinco-CRM/docs/07-anleitung-benutzer.md

07 Anleitung fuer Benutzer

Diese Anleitung setzt keine Vorkenntnisse voraus. Sie beschreibt, was die Anwendung tut und wie man sie bedient.

Was die Anwendung ist

Ein CRM fuer die Projektvermittlung. Es beantwortet vier Fragen:

Frage	Bereich
Welche Geschaefte sind in Arbeit und was sind sie wert?	Opportunities
Wer ist wann wo, und wer ist beteiligt?	Kalender
Wen kennen wir, und wer kennt wen?	Kontakte
Welche Projekte auf den Boersen passen zu unseren Beratern?	Scanner

Anmelden

https://pcrm.perinco.de. Anmelden geht mit Benutzername oder E-Mail plus Passwort. Die Sitzung haelt 12 Stunden, danach fragt die Anwendung erneut.

Sagt die Meldung „Benutzername oder Passwort ist falsch", bleibt bewusst offen, welches von beidem nicht stimmte - so kann ueber die Anmeldemaske niemand Benutzernamen durchprobieren.

Es gibt zwei Rollen: Administrator sieht zusaetzlich die Nutzerverwaltung und die Scanner-Einstellungen. Alles andere ist fuer beide Rollen gleich.

Sich zurechtfinden

┌──────────────┬───────────────────────────────────────────┐
│ Kategorien   │  Titel der Ansicht        [Hell/Dunkel]   │
│  Opportunities├──────────────────────────────────────────┤
│  Kalender    │                                           │
│  Kontakte    │   Inhalt                                  │
│  Scanner   ▾ │                                           │
│   Dashboard  │                                           │
│   Unpassend  │                                           │
│   Suchagenten│                                           │
│   Boersen-…  │                                           │
├──────────────┤                                           │
│ Einstellungen│                                           │
├──────────────┤                                           │
│ [Foto] Name  │                                           │
└──────────────┴───────────────────────────────────────────┘

• Der Knopf mit den drei Strichen oben links klappt das Menue auf Symbolbreite zusammen - hilfreich auf kleinen Bildschirmen.
• Rechts oben schaltet zwischen hellem und dunklem Design. Ein Doppelklick auf den Schalter folgt wieder der Systemeinstellung.
• Der Menuepunkt Scanner klappt beim Anklicken seine Unterpunkte auf.

Opportunities

Der Startbereich: eine Opportunity ist ein Geschaeft in Arbeit. Oben rechts wechselt man die Darstellung:

Ansicht	wofuer
Kachel	Ueberblick mit Volumen, Tagessatz, Laufzeit, letzter Interaktion
Liste	viele Eintraege vergleichen, Spaltenkoepfe sortieren
Pipeline	Fortschritt durch die Phasen, Karten per Maus verschieben

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 ueber der Liste, je Pipeline-Spalte und in der Kopfzeile.

Zu jeder Opportunity gehoeren beliebig viele Ansprechpartner aus den Kontakten, jeder mit eigener Rolle („Entscheider", „Fachbereich", …).

Aendern und loeschen darf der Ersteller, der Zustaendige und jeder Administrator. Wer keines davon ist, bekommt eine Fehlermeldung - das prueft der Server, nicht nur die Oberflaeche.

Auf dem Tablet oder ohne Lust auf Ziehen: die Phase laesst sich auch ueber das Auswahlfeld direkt auf der Karte aendern.

Kalender

Ein gemeinsamer Teamkalender - alle sehen dieselben Termine, jeder darf eintragen.

• Monat, Woche, Tag oben umschalten, Heute und die Pfeile blaettern.
• Klick auf einen Monatstag oder eine Stundenzelle legt sofort einen Termin an.
• Klick auf einen Wochentagskopf springt in die Tagesansicht.
• Farben gehoeren zum Ersteller. Die eigene Farbe aendert man unter Einstellungen → Mein Konto; die Legende unter dem Kalender zeigt, welche Farbe zu wem gehoert.
• Teilnehmer erscheinen mit Foto oder Initiale und sind anklickbar.
• @-Erwaehnungen: In der Beschreibung @ tippen, dann Kontakte und Benutzer aus der Vorschlagsliste waehlen (Pfeiltasten, Enter). In der Leseansicht sind sie klickbar - Kontakte oeffnen die Kontaktkarte, Benutzer ein Detailfenster mit naechsten Terminen.
• Rechts stehen die naechsten Termine, nach Tagen gruppiert. Vergangenes fliegt aus der Liste, bleibt im Kalender aber erhalten.

Aendern und loeschen darf nur der Ersteller oder ein Administrator. Anlegen darf jeder.

Kontakte

Drei Ansichten, davon eine besondere:

Ansicht	wofuer
Kachel	Ueberblick mit Foto, Firma, Status
Liste	sortierbar, viele Eintraege
Netzwerk	wer steht mit wem in Kontakt

Im Netzwerk sind Kreise Kontakte (Farbe = Status, Groesse = Anzahl Verbindungen) und Quadrate Benutzer, die Kontakte angelegt haben. Gruene Linien verbinden Kontakte untereinander, graue gestrichelte den Ersteller mit seinem Kontakt.

Bedienung: Hintergrund ziehen verschiebt, Mausrad zoomt, einen Knoten ziehen setzt ihn fest (gruener Punkt), Doppelklick loest ihn wieder. Ueber Verbindung erstellen zwei Kontakte anklicken, um eine Verbindung anzulegen; Esc bricht ab. Suche und Statusfilter wirken auch hier.

Scanner

Durchsucht Projektboersen und bewertet jeden Fund mit KI gegen die Lebenslaeufe der Berater.

Dashboard

Oben vier Kennzahlen, darunter die Trefferliste. Der Knopf Jetzt scannen startet sofort einen Suchlauf; laeuft schon einer, sagt die Anwendung das.

Die Filterzeile:

Feld	Bedeutung
Zeitraum	wie alt darf das Projekt sein (Standard: letzte 24 Stunden)
Agent	nur Treffer eines Beraters
Anzeige ab %	schwaechere Treffer ausblenden
Hinweis ab %	ab wann Signalton und E-Mail

Die letzten zwei Werte werden gespeichert und gelten auch beim naechsten Mal und in den Einstellungen. Rechts daneben steht sichtbar / gesamt.

Ein Klick auf eine Zeile oeffnet die Details: Projektbeschreibung, die KI-Auswertung mit Pro und Contra, dazu die Knoepfe Gesehen, Beworben, Zurueck auf Neu, Boerse oeffnen, Passt nicht und Treffer loeschen.

Ueber der Liste steht der Betriebszustand: automatische Suche aktiv, nur manuelle Suche, pausiert oder Suchlauf laeuft.

Ton bei neuen Treffern

Findet der Scanner einen Treffer ueber dem Wert Hinweis ab %, spielt das Dashboard einen Signalton und zeigt ein Hinweisbanner. Drei Dinge muss man dazu wissen:

1. Nur im Dashboard. Wer auf Opportunities oder Kontakte wechselt, hoert nichts - und bekommt es auch spaeter nicht nachgemeldet.
2. In einem anderen Browsertab klingelt es weiter, aber verzoegert: der Browser bremst versteckte Tabs auf etwa eine Pruefung pro Minute. Ausserdem muss man vorher einmal irgendwo auf der Seite geklickt haben, sonst laesst der Browser keinen Ton zu.
3. Ist der Tab geschlossen, passiert nichts. Wer unabhaengig vom Browser benachrichtigt werden will, schaltet die E-Mail in den Einstellungen ein.

Unpassend

Alles, was ueber Passt nicht aussortiert wurde. Von hier bringt Zurueck ins Dashboard einen Treffer wieder zurueck, oder er wird endgueltig geloescht.

Suchagenten

Ein Suchagent ist ein Berater:

Feld	wofuer
Name	erscheint an jedem Treffer
E-Mail	Ziel der Benachrichtigung fuer diesen Berater
Suchbegriffe	kommagetrennt, damit wird auf den Boersen gesucht
Ausschluss-Begriffe	kommagetrennt; Projekte mit diesen Woertern werden uebersprungen
Lebenslauf (PDF)	wird als Text ausgelesen und gegen jedes Projekt bewertet
aktiv	nur aktive Agenten suchen im Hintergrund

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. „Arbeitnehmerueberlassung" oder „Festanstellung" sind typische Kandidaten.

Loeschen nimmt die Treffer mit. Wird ein Suchagent geloescht, verschwinden alle seine bisherigen Treffer und sein Lebenslauf mit ihm - die Datenbank raeumt das automatisch auf. Die gefundenen Projekte bleiben erhalten, sie gehoeren nicht zu einem einzelnen Agenten. Wer einen Berater nur vorübergehend aus der Suche nehmen will, setzt ihn besser auf inaktiv statt ihn zu loeschen: dann sucht er nicht mehr, die Treffer bleiben aber sichtbar.

Boersen-Konten

Zeigt fuer jede Boerse, ob die Verbindung steht. Zwei Arten:

• Oeffentliche Portale (Hays, Etengo, …) brauchen keinen Login.
• Geschuetzte Portale (Freelance.de, Freelancermap.de) brauchen eine angemeldete Sitzung. Dafuer exportiert man die Cookies mit der Browser-Erweiterung Cookie-Editor als JSON und fuegt sie unter Cookie-Import ein.

Jetzt pruefen testet eine Verbindung sofort. Steht dort Abgelaufen / CAPTCHA, hilft nur ein neuer Cookie-Import.

Die Zugangsdaten (Benutzername, Passwort) sind optional - der Scraper versucht damit im Notfall eine eigene Anmeldung. Passwoerter liegen verschluesselt in der Datenbank.

Einstellungen

Reiter	Wer	Inhalt
Nutzerverwaltung	Admin	Benutzer anlegen, bearbeiten, deaktivieren, loeschen
Mein Konto	alle	Foto, Kalenderfarbe, Passwort aendern
Scanner	Admin	Suchintervall, Schwellenwerte, KI-Schluessel, Ton, E-Mail
Whisper	alle	Spracherkennung fuer das Diktat einrichten

Im Reiter Scanner steht das Suchintervall (Minuten) - also wie oft der Hintergrund-Scanner die Boersen durchsucht.

Darueber der Hauptschalter Scanner aktiviert. Ist er aus, sucht die Anwendung nicht mehr: kein Lauf im Hintergrund, und Jetzt scannen antwortet mit einem Hinweis statt zu starten. Der Zustand steht auch oben im Scanner-Dashboard, damit man nicht raetselt, warum keine neuen Treffer kommen.

Foto und Kalenderfarbe werden sofort gespeichert, ohne Speichern-Knopf. Der letzte aktive Administrator kann sich nicht selbst degradieren oder loeschen - das verhindert der Server.

Diktat

Ueberall, wo laengerer Text entsteht, sitzt ein Mikrofon-Knopf. Beim ersten Mal steht dort Diktat einrichten und fuehrt in die Einstellungen: dort einmal Sprachmodell laden klicken, rund 759 MB, danach ist es dauerhaft in diesem Browser.

Die Erkennung laeuft komplett auf dem eigenen Rechner. Aufnahmen verlassen das Geraet nicht und werden nirgends gespeichert. Auf einem anderen Rechner oder in einem anderen Browser faellt der Download erneut an - er gehoert zum Browser, nicht zum Benutzerkonto.

Wenn etwas nicht klappt

Beobachtung	Ursache und Abhilfe
„Sitzung abgelaufen"	12 Stunden vorbei, neu anmelden
Trefferliste ist leer	Anzeige ab % zu hoch oder Zeitraum zu kurz
Kein Ton bei Treffern	Dashboard offen? Einmal auf der Seite geklickt? Wert Hinweis ab % erreicht?
Mikrofon-Knopf fehlt	kein Mikrofon oder keine HTTPS-Verbindung
Boerse zeigt „Abgelaufen"	Cookies neu importieren
„Ein Suchlauf laeuft bereits"	kurz warten, es laeuft nur einer zur Zeit
Aendern nicht erlaubt	bei Opportunities darf nur Ersteller, Zustaendiger oder Admin