feat(postfach): crm@perinco.de lesend anbinden, Kontakte aus Mails
Spiegelt das Vertriebspostfach ueber Microsoft Graph ins CRM. Aus jeder Mail entstehen Kontakt-Vorschlaege, und jede Mail laesst sich an Opportunities und Kontakte haengen. Uebernommen ist die Idee aus dem Altsystem KeepTrack, nicht die Umsetzung: - Delta Query statt "$filter=isRead eq false" mit anschliessendem PATCH. Damit genuegt die Anwendungsberechtigung Mail.Read, es braucht keinen Schreibzugriff auf das Postfach, und eine vorher in Outlook geoeffnete Mail geht nicht verloren. Der Fortschritt liegt als delta_link in der Datenbank und ueberlebt Neustarts; ein Lauf ist gedeckelt und fortsetzbar. - Tenant- und Client-ID kommen aus der .env, nicht aus dem Browser. Im Altsystem konnte jeder Angemeldete das Server-Secret gegen einen fremden Tenant verwenden. - Kontaktdaten werden aus den Graph-Feldern und der Signatur gelesen, ohne Sprachmodell. Mailinhalte verlassen den Server nicht. - Ein Vorschlag ohne E-Mail-Adresse wird nicht mit einer erfundenen Adresse angelegt, sondern bleibt zur Durchsicht liegen. Ist die Adresse schon als Kontakt vorhanden, werden nur leere Felder ergaenzt. - Mails haengen als eigene Verknuepfung an Opportunity und Kontakt, nicht als Text im Notizfeld - loesbar und mehrfach moeglich. - Fremdes Mail-HTML wird serverseitig entschaerft und in einem iframe mit sandbox="" gezeigt. Externe Bilder sind per CSP gesperrt, damit das Oeffnen dem Absender nichts meldet. - Der Verbindungstest prueft Anmeldung und tatsaechlichen Postfachzugriff und benennt den wahrscheinlichen Grund. Der alte Test holte nur ein Token. Fehlen die MS_*-Werte, startet das CRM normal; die Einstellungen nennen die fehlende Variable. Neue Tabellen: crm_mail_messages, crm_mail_links, crm_mail_contact_candidates, crm_mail_sync_state, crm_settings. Uebernommene Kontakte tragen source = 'Mail'; die Kontaktliste hat dafuer einen Herkunftsfilter. Nicht enthalten: Senden, Antworten, Weiterleiten, Anhaenge und die automatische Zuordnung zu Opportunities. npm test im Verzeichnis server prueft Kontaktextraktion und Graph-Client (47 Pruefungen, ohne Framework und ohne Datenbank). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Sascha Wolf
co-authored by
Claude Opus 5
Claude Opus 5
parent
3647201111
commit
6fd713497d
@@ -0,0 +1,264 @@
|
||||
import { apiRequest } from './api';
|
||||
|
||||
/*
|
||||
* Postfachanbindung crm@perinco.de. Alle Endpunkte liegen unter /api/mail und
|
||||
* haengen an derselben CRM-Anmeldung wie der Rest der App.
|
||||
*
|
||||
* Zeitangaben kommen als MariaDB-DATETIME in UTC (`YYYY-MM-DD HH:MM:SS`), so wie
|
||||
* Microsoft Graph sie liefert. Fuer die Anzeige gibt es parseMailDate().
|
||||
*/
|
||||
|
||||
export interface MailAddress {
|
||||
name: string | null;
|
||||
email: string;
|
||||
}
|
||||
|
||||
export interface MailMessageSummary {
|
||||
id: number;
|
||||
subject: string | null;
|
||||
from_name: string | null;
|
||||
from_email: string | null;
|
||||
to: MailAddress[];
|
||||
cc: MailAddress[];
|
||||
received_at: string;
|
||||
body_preview: string | null;
|
||||
has_attachments: boolean;
|
||||
is_deleted: boolean;
|
||||
web_link: string | null;
|
||||
link_count: number;
|
||||
open_candidates: number;
|
||||
}
|
||||
|
||||
export interface MailLink {
|
||||
id: number;
|
||||
lead_id: number | null;
|
||||
opportunity_id: number | null;
|
||||
origin: 'manuell' | 'automatisch';
|
||||
note: string | null;
|
||||
created_at: string;
|
||||
created_by: number | null;
|
||||
created_by_name: string | null;
|
||||
lead_name: string | null;
|
||||
lead_company: string | null;
|
||||
opportunity_title: string | null;
|
||||
opportunity_stage: string | null;
|
||||
}
|
||||
|
||||
export type CandidateOrigin = 'absender' | 'empfaenger' | 'signatur' | 'text';
|
||||
export type CandidateStatus = 'offen' | 'uebernommen' | 'verworfen' | 'dublette';
|
||||
|
||||
export interface MailCandidate {
|
||||
id: number;
|
||||
message_id: number;
|
||||
first_name: string | null;
|
||||
last_name: string | null;
|
||||
salutation: string | null;
|
||||
email: string | null;
|
||||
phone: string | null;
|
||||
mobile: string | null;
|
||||
company: string | null;
|
||||
position: string | null;
|
||||
street: string | null;
|
||||
zip: string | null;
|
||||
city: string | null;
|
||||
website: string | null;
|
||||
linkedin: string | null;
|
||||
origin: CandidateOrigin;
|
||||
confidence: number;
|
||||
status: CandidateStatus;
|
||||
lead_id: number | null;
|
||||
lead_name: string | null;
|
||||
decided_at: string | null;
|
||||
decided_by_name?: string | null;
|
||||
created_at: string;
|
||||
/** Aus dem Join: nur in der Vorschlagsliste gesetzt. */
|
||||
message_subject?: string | null;
|
||||
message_from?: string | null;
|
||||
message_received_at?: string;
|
||||
/** Adresse existiert schon als Kontakt - dann wird ergaenzt, nicht angelegt. */
|
||||
existing_lead_id?: number | null;
|
||||
}
|
||||
|
||||
export interface MailMessageDetail extends MailMessageSummary {
|
||||
bcc: MailAddress[];
|
||||
sent_at: string | null;
|
||||
importance: string | null;
|
||||
conversation_id: string | null;
|
||||
internet_message_id: string | null;
|
||||
is_read_in_mailbox: boolean;
|
||||
body_text: string | null;
|
||||
body_html: string | null;
|
||||
links: MailLink[];
|
||||
candidates: MailCandidate[];
|
||||
}
|
||||
|
||||
export interface MailStatus {
|
||||
configured: boolean;
|
||||
/** Namen der fehlenden .env-Werte, wenn nicht konfiguriert. */
|
||||
missing: string[];
|
||||
mailbox: string;
|
||||
folder: string;
|
||||
scheduler_enabled: boolean;
|
||||
active: boolean;
|
||||
interval_minutes: number;
|
||||
auto_contacts: boolean;
|
||||
since_days: number;
|
||||
running: boolean;
|
||||
/** Es sind noch Delta-Seiten offen - der Erstabgleich laeuft noch. */
|
||||
has_more: boolean;
|
||||
/** Ein erster Abgleich hat stattgefunden. */
|
||||
initialized: boolean;
|
||||
last_run_at: string | null;
|
||||
last_success_at: string | null;
|
||||
last_error: string | null;
|
||||
last_new_messages: number;
|
||||
last_candidates: number;
|
||||
counts: {
|
||||
messages: number;
|
||||
open_candidates: number;
|
||||
adopted_candidates: number;
|
||||
links: number;
|
||||
};
|
||||
last_result: MailSyncResult | null;
|
||||
}
|
||||
|
||||
export interface MailSyncResult {
|
||||
ok: boolean;
|
||||
trigger: string;
|
||||
startedAt: string;
|
||||
durationMs: number;
|
||||
pages?: number;
|
||||
newMessages?: number;
|
||||
updatedMessages?: number;
|
||||
deletedMessages?: number;
|
||||
newCandidates?: number;
|
||||
adoptedContacts?: number;
|
||||
hasMore?: boolean;
|
||||
error?: string;
|
||||
}
|
||||
|
||||
export interface MailConnectionTest {
|
||||
ok: boolean;
|
||||
stage: 'konfiguration' | 'token' | 'mailbox';
|
||||
error?: string;
|
||||
code?: string | null;
|
||||
hint?: string;
|
||||
mailbox?: string;
|
||||
folder?: string | null;
|
||||
totalItems?: number | null;
|
||||
unreadItems?: number | null;
|
||||
}
|
||||
|
||||
/** Alle Werte liegen als Text in crm_settings - auch Zahlen und Schalter. */
|
||||
export interface MailSettingsValues {
|
||||
mail_sync_active: string;
|
||||
mail_sync_interval: string;
|
||||
mail_auto_contacts: string;
|
||||
mail_since_days: string;
|
||||
mail_internal_domains: string;
|
||||
}
|
||||
|
||||
export const MAIL_SETTINGS_DEFAULTS: MailSettingsValues = {
|
||||
mail_sync_active: 'true',
|
||||
mail_sync_interval: '10',
|
||||
mail_auto_contacts: 'true',
|
||||
mail_since_days: '30',
|
||||
mail_internal_domains: 'perinco.de,perinco.onmicrosoft.com',
|
||||
};
|
||||
|
||||
export type MailListFilter = 'alle' | 'unlinked' | 'linked' | 'candidates';
|
||||
|
||||
export const mailApi = {
|
||||
status: () => apiRequest<MailStatus>('/mail/status'),
|
||||
|
||||
messages: (params: { search?: string; filter?: MailListFilter; limit?: number; offset?: number } = {}) => {
|
||||
const query = new URLSearchParams();
|
||||
if (params.search) query.set('search', params.search);
|
||||
if (params.filter && params.filter !== 'alle') query.set('filter', params.filter);
|
||||
if (params.limit) query.set('limit', String(params.limit));
|
||||
if (params.offset) query.set('offset', String(params.offset));
|
||||
const suffix = query.toString() ? `?${query}` : '';
|
||||
return apiRequest<{ total: number; limit: number; offset: number; messages: MailMessageSummary[] }>(
|
||||
`/mail/messages${suffix}`
|
||||
);
|
||||
},
|
||||
|
||||
message: (id: number) => apiRequest<MailMessageDetail>(`/mail/messages/${id}`),
|
||||
|
||||
link: (messageId: number, input: { lead_id?: number | null; opportunity_id?: number | null; note?: string }) =>
|
||||
apiRequest<{ ok: true; created: number[] }>(`/mail/messages/${messageId}/links`, {
|
||||
method: 'POST',
|
||||
body: JSON.stringify(input),
|
||||
}),
|
||||
|
||||
unlink: (linkId: number) => apiRequest<{ ok: true }>(`/mail/links/${linkId}`, { method: 'DELETE' }),
|
||||
|
||||
candidates: (params: { status?: CandidateStatus | 'alle'; limit?: number } = {}) => {
|
||||
const query = new URLSearchParams();
|
||||
query.set('status', params.status ?? 'offen');
|
||||
if (params.limit) query.set('limit', String(params.limit));
|
||||
return apiRequest<MailCandidate[]>(`/mail/candidates?${query}`);
|
||||
},
|
||||
|
||||
adoptCandidate: (id: number, input: { owner_id?: number | null } = {}) =>
|
||||
apiRequest<{ status: 'uebernommen' | 'dublette'; leadId: number; enrichedFields: number }>(
|
||||
`/mail/candidates/${id}/adopt`,
|
||||
{ method: 'POST', body: JSON.stringify(input) }
|
||||
),
|
||||
|
||||
rejectCandidate: (id: number) =>
|
||||
apiRequest<{ ok: true; status: 'verworfen' }>(`/mail/candidates/${id}/reject`, { method: 'POST' }),
|
||||
|
||||
// ---------- nur Administratoren ----------
|
||||
settings: () => apiRequest<Partial<MailSettingsValues>>('/mail/settings'),
|
||||
saveSettings: (input: Partial<MailSettingsValues>) =>
|
||||
apiRequest<MailSettingsValues>('/mail/settings', { method: 'POST', body: JSON.stringify(input) }),
|
||||
test: () => apiRequest<MailConnectionTest>('/mail/test', { method: 'POST' }),
|
||||
sync: (options: { reset?: boolean } = {}) =>
|
||||
apiRequest<MailSyncResult>('/mail/sync', { method: 'POST', body: JSON.stringify(options) }),
|
||||
};
|
||||
|
||||
/**
|
||||
* MariaDB-DATETIME in UTC nach Date. Ohne das angehaengte Z liest der Browser
|
||||
* den Wert als Ortszeit und die Anzeige waere je Zeitzone um Stunden verschoben.
|
||||
*/
|
||||
export function parseMailDate(value: string | null): Date | null {
|
||||
if (!value) return null;
|
||||
const date = new Date(`${value.replace(' ', 'T')}Z`);
|
||||
return Number.isNaN(date.getTime()) ? null : date;
|
||||
}
|
||||
|
||||
/** Heute nur Uhrzeit, dieses Jahr Tag und Monat, sonst mit Jahr. */
|
||||
export function formatMailDate(value: string | null): string {
|
||||
const date = parseMailDate(value);
|
||||
if (!date) return '—';
|
||||
|
||||
const now = new Date();
|
||||
const sameDay =
|
||||
date.getFullYear() === now.getFullYear() &&
|
||||
date.getMonth() === now.getMonth() &&
|
||||
date.getDate() === now.getDate();
|
||||
|
||||
if (sameDay) return date.toLocaleTimeString('de-DE', { hour: '2-digit', minute: '2-digit' });
|
||||
if (date.getFullYear() === now.getFullYear()) {
|
||||
return date.toLocaleDateString('de-DE', { day: '2-digit', month: 'short' });
|
||||
}
|
||||
return date.toLocaleDateString('de-DE', { day: '2-digit', month: '2-digit', year: '2-digit' });
|
||||
}
|
||||
|
||||
/** Vollstaendige Angabe fuer die Detailansicht und Titelhinweise. */
|
||||
export function formatMailDateTime(value: string | null): string {
|
||||
const date = parseMailDate(value);
|
||||
if (!date) return '—';
|
||||
return date.toLocaleString('de-DE', {
|
||||
day: '2-digit',
|
||||
month: '2-digit',
|
||||
year: 'numeric',
|
||||
hour: '2-digit',
|
||||
minute: '2-digit',
|
||||
});
|
||||
}
|
||||
|
||||
export function candidateName(candidate: MailCandidate): string {
|
||||
return [candidate.first_name, candidate.last_name].filter(Boolean).join(' ').trim() || 'Ohne Namen';
|
||||
}
|
||||
@@ -8,10 +8,14 @@ import type { SettingsTab, ViewState } from '../types';
|
||||
*
|
||||
* `tab` waehlt beim Sprung in die Einstellungen gleich den richtigen Reiter aus;
|
||||
* Whisper ist genau so ein Ziel und hat deshalb keinen eigenen Menuepunkt mehr.
|
||||
*
|
||||
* `leadId` oeffnet in der Kontaktansicht direkt den passenden Kontakt - die
|
||||
* Mailansicht springt so von einer Zuordnung zum Kontakt, ohne dass der Benutzer
|
||||
* ihn in der Liste suchen muss.
|
||||
*/
|
||||
interface NavigationContextValue {
|
||||
currentView: ViewState;
|
||||
goTo: (view: ViewState, options?: { tab?: SettingsTab }) => void;
|
||||
goTo: (view: ViewState, options?: { tab?: SettingsTab; leadId?: number }) => void;
|
||||
}
|
||||
|
||||
const NavigationContext = createContext<NavigationContextValue | null>(null);
|
||||
|
||||
Reference in New Issue
Block a user