feat: Projekt Scanner integrieren, Whisper in die Einstellungen

Der eigenstaendige Projekt Scanner zieht komplett ins CRM ein und laeuft parallel zur bestehenden App weiter - jede geteilte Ressource ist verdoppelt statt geteilt, damit die alte Installation unberuehrt bleibt: - eigene Datenbank perinco_scanner, legt sich beim Start selbst an - eigener SCANNER_ENCRYPTION_KEY, eigenes Upload-Verzeichnis - eigener Scheduler mit Zeitversatz, damit nicht beide Instanzen gleichzeitig mit denselben Portal-Cookies scrapen (Rate-Limits, CAPTCHA, doppelter RAM) - Sperre gegen ueberlappende Laeufe: Scheduler und "Jetzt scannen" teilen sie, ein zweiter Aufruf bekommt 409 statt doppelter OpenAI-Kosten Backend unter /api/scanner hinter der CRM-Anmeldung; die HTTP-Basic-Auth des Originals entfaellt. CV-PDFs kommen als Stream mit Token statt aus einem statischen Verzeichnis. Bestandsdaten holt "npm run scanner:import" aus der alten Datenbank, ohne sie zu veraendern. Oberflaeche in Tailwind und CI-Farben neu gebaut: Menuepunkt Scanner mit aufklappbaren Unterpunkten, Einstellungen als eigener Reiter. Whisper hat keinen eigenen Menuepunkt mehr, sondern ist ein Reiter in den Einstellungen. Damit diese Geraeteeinstellung jeder Rolle offensteht, sind die Einstellungen jetzt fuer alle sichtbar - welche Reiter erscheinen, entscheidet die Rolle. Ausserdem: kein festes Admin-Passwort mehr im Quelltext, playwright exakt auf 1.60.0 gepinnt (nutzt den vorhandenen Chromium-Build des Servers), technische Dokumentation mit Funktionszeichnungen unter docs/. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-06 15:08:59 +02:00
commit 82d1b7eab4
106 changed files with 24133 additions and 0 deletions
@@ -0,0 +1,272 @@
+export type ViewState =
+  | 'Opportunities'
+  | 'Kalender'
+  | 'Kontakte'
+  | 'Scanner'
+  | 'Unpassend'
+  | 'Suchagenten'
+  | 'Börsen-Konten'
+  | 'Einstellungen';
+
+/**
+ * Reiter der Einstellungen. Whisper sitzt hier und nicht mehr im Menue - es sind
+ * Geraeteeinstellungen, die man einmal einrichtet.
+ *
+ * Rollen: `users` und `scanner` sind Administratoren vorbehalten, `account` und
+ * `whisper` stehen jedem offen - jeder pflegt sein eigenes Konto und richtet sein
+ * eigenes Diktat ein.
+ */
+export type SettingsTab = 'users' | 'account' | 'scanner' | 'whisper';
+
+export const ADMIN_SETTINGS_TABS: SettingsTab[] = ['users', 'scanner'];
+
+/**
+ * Reiter des Projekt Scanners. "Scanner" selbst ist das Dashboard und damit die
+ * Ansicht, die beim Aufklappen des Menuepunkts erscheint. Die Einstellungen des
+ * Scanners liegen absichtlich nicht hier, sondern als Reiter in den
+ * CRM-Einstellungen.
+ */
+export const SCANNER_VIEWS: ViewState[] = ['Scanner', 'Unpassend', 'Suchagenten', 'Börsen-Konten'];
+
+export type Role = 'admin' | 'user';
+
+export interface AppUser {
+  id: number;
+  username: string;
+  email: string | null;
+  name: string;
+  role: Role;
+  /** Persoenliche Kalenderfarbe als Hex; null = automatisch aus der Palette. */
+  color?: string | null;
+  /** Benutzerfoto als Data-URL oder externe URL; null = Initiale anzeigen. */
+  avatar?: string | null;
+  is_active: boolean;
+  created_at?: string;
+  updated_at?: string;
+}
+
+/**
+ * Farbpalette fuer Benutzer im Kalender. Bewusst kontraststark untereinander
+ * und dunkel genug fuer weisse Schrift; das CI-Gruen steht an erster Stelle.
+ */
+export const USER_COLORS = [
+  '#6ba04a',
+  '#0284c7',
+  '#d97706',
+  '#7c3aed',
+  '#db2777',
+  '#0d9488',
+  '#dc2626',
+  '#4f46e5',
+  '#65a30d',
+  '#c2410c',
+] as const;
+
+/** Gesetzte Farbe, sonst stabil aus der ID abgeleitet. */
+export function userColor(user?: { id: number; color?: string | null } | null): string {
+  if (!user) return '#9a9a9a';
+  if (user.color && /^#[0-9a-fA-F]{6}$/.test(user.color)) return user.color;
+  return USER_COLORS[Math.abs(user.id) % USER_COLORS.length];
+}
+
+export const LEAD_STATUSES = [
+  'Neu',
+  'Kontaktiert',
+  'Qualifiziert',
+  'Angebot',
+  'Gewonnen',
+  'Verloren',
+] as const;
+
+export type LeadStatus = (typeof LEAD_STATUSES)[number];
+
+export interface Lead {
+  id: number;
+  salutation: string | null;
+  first_name: string;
+  last_name: string;
+  company: string | null;
+  position: string | null;
+  email: string | null;
+  phone: string | null;
+  mobile: string | null;
+  linkedin: string | null;
+  website: string | null;
+  street: string | null;
+  zip: string | null;
+  city: string | null;
+  country: string | null;
+  status: LeadStatus;
+  source: string | null;
+  tags: string[];
+  notes: string | null;
+  avatar: string | null;
+  owner_id: number | null;
+  created_by: number | null;
+  created_at?: string;
+  updated_at?: string;
+  /** Angereichert vom Backend */
+  created_by_name?: string | null;
+  owner_name?: string | null;
+}
+
+export const CONNECTION_TYPES = [
+  'Kollege',
+  'Vorgesetzter',
+  'Kunde',
+  'Partner',
+  'Empfehlung',
+  'Netzwerk',
+  'Sonstige',
+] as const;
+
+export type ConnectionType = (typeof CONNECTION_TYPES)[number];
+
+export interface LeadConnection {
+  id: number;
+  from_lead_id: number;
+  to_lead_id: number;
+  type: ConnectionType;
+  label: string | null;
+  strength: number;
+  created_by: number | null;
+  created_at?: string;
+}
+
+export type LeadViewMode = 'grid' | 'list' | 'network';
+
+// ---------- Opportunities ----------
+
+/** Phasen der Vertriebspipeline, in dieser Reihenfolge. */
+export const OPPORTUNITY_STAGES = [
+  'Neu',
+  'Qualifizierung',
+  'Angebot',
+  'Verhandlung',
+  'Gewonnen',
+  'Verloren',
+] as const;
+
+export type OpportunityStage = (typeof OPPORTUNITY_STAGES)[number];
+
+/** Phasen, in denen die Chance noch offen ist. */
+export const OPEN_STAGES: OpportunityStage[] = ['Neu', 'Qualifizierung', 'Angebot', 'Verhandlung'];
+
+export interface OpportunityContact {
+  lead_id: number;
+  /** Freitext, z. B. "Entscheider" */
+  role: string | null;
+  first_name: string;
+  last_name: string;
+  company: string | null;
+  position: string | null;
+  email: string | null;
+  phone: string | null;
+  avatar: string | null;
+}
+
+export interface Opportunity {
+  id: number;
+  title: string;
+  company: string | null;
+  description: string | null;
+  stage: OpportunityStage;
+  /** 0-100 */
+  probability: number;
+  /** Tagessatz in Euro */
+  daily_rate: number | null;
+  /** Laufzeit in Personentagen */
+  duration_days: number | null;
+  start_date: string | null;
+  end_date: string | null;
+  last_interaction_at: string | null;
+  last_interaction_note: string | null;
+  next_step: string | null;
+  tags: string[];
+  notes: string | null;
+  owner_id: number | null;
+  created_by: number | null;
+  created_at?: string;
+  updated_at?: string;
+  /** Angereichert vom Backend */
+  created_by_name?: string | null;
+  owner_name?: string | null;
+  owner_color?: string | null;
+  owner_avatar?: string | null;
+  contacts: OpportunityContact[];
+}
+
+export type OpportunityViewMode = 'grid' | 'list' | 'pipeline';
+
+/** Projektvolumen = Tagessatz x Personentage; null, wenn eines fehlt. */
+export function opportunityVolume(opportunity: Opportunity): number | null {
+  if (opportunity.daily_rate === null || opportunity.duration_days === null) return null;
+  return opportunity.daily_rate * opportunity.duration_days;
+}
+
+/** Mit der Abschlusswahrscheinlichkeit gewichtetes Volumen. */
+export function weightedVolume(opportunity: Opportunity): number | null {
+  const volume = opportunityVolume(opportunity);
+  return volume === null ? null : (volume * opportunity.probability) / 100;
+}
+
+export function formatEuro(value: number | null): string {
+  if (value === null) return '—';
+  return value.toLocaleString('de-DE', {
+    style: 'currency',
+    currency: 'EUR',
+    maximumFractionDigits: 0,
+  });
+}
+
+export function contactFullName(contact: Pick<OpportunityContact, 'first_name' | 'last_name'>): string {
+  return `${contact.first_name} ${contact.last_name}`.trim();
+}
+
+// ---------- Kalender ----------
+
+export interface EventParticipant {
+  id: number;
+  username: string;
+  name: string;
+  color: string | null;
+  avatar: string | null;
+}
+
+export interface CalendarEvent {
+  id: number;
+  title: string;
+  /** Kann Mention-Tokens der Form `@[Name](lead:12)` bzw. `@[Name](user:3)` enthalten. */
+  description: string | null;
+  location: string | null;
+  /** MariaDB-DATETIME als String: `YYYY-MM-DD HH:MM:SS` (lokale Wandzeit). */
+  starts_at: string;
+  ends_at: string;
+  all_day: boolean;
+  created_by: number | null;
+  created_at?: string;
+  updated_at?: string;
+  /** Angereichert vom Backend */
+  created_by_name?: string | null;
+  created_by_color?: string | null;
+  created_by_avatar?: string | null;
+  participants: EventParticipant[];
+}
+
+export type CalendarViewMode = 'month' | 'week' | 'day';
+
+/** Farbe eines Termins = Farbe seines Erstellers. */
+export function eventColor(event: CalendarEvent): string {
+  if (event.created_by === null) return '#9a9a9a';
+  return userColor({ id: event.created_by, color: event.created_by_color ?? null });
+}
+
+export function leadFullName(lead: Pick<Lead, 'first_name' | 'last_name'>): string {
+  return `${lead.first_name} ${lead.last_name}`.trim();
+}
+
+export function leadInitials(lead: Pick<Lead, 'first_name' | 'last_name'>): string {
+  const a = lead.first_name?.charAt(0) ?? '';
+  const b = lead.last_name?.charAt(0) ?? '';
+  return (a + b).toUpperCase() || '?';
+}