- Neuer "Integrationen"-Tab in ProfilePage mit "Microsoft 365 verbinden"- Button, OAuth-Callback-Handling (?integration=...&status=...), Trennen-Button - EmailsTab, CalendarTab, TasksTab fuer ContactDetailPage (via MS Graph Proxy) - useIntegrations, useDisconnectM365, useContactEmails/Calendar/Tasks Hooks - integrationsApi + graphApi in crm/api.ts - M365Email, M365CalendarEvent, M365Task, UserIntegration Types in crm/types.ts - Tabs nur sichtbar wenn Kontakt eine E-Mail-Adresse hat; ohne Verbindung Connect-Button Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
20 KiB
INSIGHT MVP - Aenderungsprotokoll
Stand: 2026-03-12
Aktueller Sprint: CRM Phase 3 — Kanban-Board + Microsoft 365 OAuth-Integration (Feature-Branch: feature/crm-service)
Aenderungen 2026-03-12: Microsoft 365 OAuth-Integration — Frontend
Frontend: MS365 Integration-Tab + Kontakt-Tabs
crm/types.ts— Neue Interfaces:UserIntegration,M365Email,M365EmailAddress,M365CalendarEvent,M365Task,M365TaskListcrm/api.ts—integrationsApi(list, disconnectM365, getM365ConnectUrl) +graphApi(getContactEmails, getContactCalendar, getContactTasks)crm/hooks.ts—useIntegrations,useDisconnectM365,useContactEmails,useContactCalendar,useContactTasksprofile/ProfilePage.tsx:- Neuer Tab "Integrationen" (Typ:
ProfileTab = 'personal' | 'expert' | 'password' | 'integrations') - Oeffnet automatisch wenn
?integration=microsoft-365URL-Param gesetzt ist - Zeigt Erfolgs-/Fehlermeldung aus
?status=success|errorParam - "Microsoft 365 verbinden" Button (Link zu
/api/v1/auth/integrations/microsoft-365) - Verbunden-Ansicht: Tenant-ID, Token-Ablauf, "Verbindung trennen" Button
- Neuer Tab "Integrationen" (Typ:
crm/contacts/EmailsTab.tsx— E-Mail-Liste aus MS Graph, ungelesen fett + blauer Rand, Link zu Outlook Webcrm/contacts/CalendarTab.tsx— Kalendertermine (naechste 90 Tage), Online-Meeting-Badge, Link zu Outlook Webcrm/contacts/TasksTab.tsx— Microsoft To Do Aufgaben, gruppiert nach Listen, Status-/Prioritaets-Badgescrm/contacts/ContactDetailPage.tsx:- Neuer "Microsoft 365" Abschnitt (Card) am Seitenende (nur wenn Kontakt E-Mail hat)
- Drei Tabs: E-Mails / Kalender / Aufgaben
- Ohne MS365-Verbindung: "Verbinden"-Button direkt im Tab
- TypeScript
npx tsc --noEmit: 0 Fehler
Aenderungen 2026-03-12: Microsoft 365 OAuth-Integration — CRM-Service (GraphModule)
crm-service/src/graph/graph.service.ts— Token von Core-Service holen (JWT-Forwarding), Graph-Calls (Emails/Kalender/Tasks), Redis-Cache 5 Mincrm-service/src/graph/graph.controller.ts— GET /crm/contacts/:id/emails|calendar|taskscrm-service/src/graph/graph.module.ts— Modul-Definitioncrm-service/src/app.module.ts— GraphModule registriertcrm-service/src/config/env.validation.ts—CORE_SERVICE_URLergaenztdocker-compose.crm.yml—CORE_SERVICE_URL=http://core:3000hinzugefuegt
Aenderungen 2026-03-12: Microsoft 365 OAuth-Integration — Core-Service
core-service/prisma/core.schema.prisma—UserIntegrationModell + Relation aufUsercore-service/prisma/migrations/20260312_user_integrations/migration.sql— Migration fueruser_integrationsTabellecore-service/src/config/env.validation.ts—AZURE_INTEGRATION_REDIRECT_URI,INTEGRATION_ENCRYPTION_KEYcore-service/src/core/auth/sso/entra-id.service.ts—getIntegrationAuthUrl,handleIntegrationCallback,refreshIntegrationTokencore-service/src/core/integrations/integrations.service.ts— AES-256-GCM Token-Verschluesselung, Token-CRUD, Auto-Refreshcore-service/src/core/integrations/integrations.controller.ts— OAuth-Flow + Token-Endpointscore-service/src/core/integrations/integrations.module.tscore-service/src/app.module.ts— IntegrationsModule registriert
Aenderungen 2026-03-12: Kanban-Board (Frontend)
frontend/src/crm/deals/KanbanPage.tsx— Drag-&-Drop Kanban-Board (@dnd-kit)- Pipeline-Selektor + Toggle "Abgeschlossene anzeigen"
- DealCard (useDraggable), KanbanColumn (useDroppable), DragOverlay
- Optimistisches Update via
localStageMap; Rollback bei Fehler
frontend/src/crm/deals/KanbanPage.module.css— Styles fuer Board, Spalten, Cardsfrontend/src/shell/App.tsx— Route/crm/kanbanfrontend/src/shell/AppLayout.tsx— NavLink "Kanban" im CRM-Bereichfrontend/package.json—@dnd-kit/core,@dnd-kit/sortable,@dnd-kit/utilities
Aktueller Sprint: CRM Phase 2 / Vertraege-Modul (Feature-Branch: feature/crm-service)
Aenderungen 2026-03-12: Vertraege-Modul Frontend (ContractsCard)
Neue/geaenderte Dateien
crm/companies/ContractsCard.tsx— Vollstaendige Vertraege-Card fuer CompanyDetailPage- Tabelle mit Titel, Status-Badge, Laufzeit, Vertragswert
- "+ Neu" Button oeffnet Create-Modal
- Stift-Icon (Bearbeiten) + X-Icon (Loeschen) pro Zeile
- Status-Farben: DRAFT=grau, ACTIVE=gruen, EXPIRED=orange, CANCELLED=rot
- Wert-Formatierung (Intl.NumberFormat de-DE), Datumsformatierung
crm/types.ts—CreateContractPayload,UpdateContractPayload,ContractsQueryParamsergaenztcrm/api.ts—contractsApi(list, create, update, delete) mit/crm/companies/:id/contractscrm/hooks.ts—crmKeys.contracts+useContracts,useCreateContract,useUpdateContract,useDeleteContractcrm/companies/CompanyDetailPage.tsx—contractCountProp entfernt (Card laedt selbst)
Aenderungen 2026-03-12: CRM Phase 2 — Forecast, Import, Enrichment (Frontend komplett)
Phase 2.3: Forecasting
crm/forecast/ForecastPage.tsx— Prognose-Dashboard unter/crm/forecast- Pipeline-Filter (Dropdown) + Zeitraum-Toggle (Monat/Quartal/Jahr)
- Summary-Cards: Offene Vorgaenge, Gesamtwert, Gewichteter Wert, Zeitraum
- Tabelle: Stage | Wahrscheinlichkeit | Vorgaenge | Gesamtwert | Gewichteter Wert
crm/pipelines/PipelinesPage.tsx— Probability-Feld (0–100%) pro Pipeline-Stage
Phase 2.2: CSV/Excel Import
crm/import/ImportPage.tsx— 3-Schritt-Wizard in CRM-Einstellungen → Tab "Import"- Schritt 1: Typ-Auswahl (Kontakte/Unternehmen/Vorgaenge) + Datei-Upload (CSV, XLSX, max 10MB)
- Schritt 2: Spalten-Mapping (Auto-Match + manuell), Duplikat-Strategie, Kopfzeilen-Option
- Schritt 3: Ergebnis (created/updated/skipped/errors + Fehlerdetails)
- API-Konvertierungen:
PERSON→contact, mappingRecord→Array [{sourceColumn,targetField}]
Phase 2.4: Datenanreicherung
crm/companies/CompanyDetailPage.tsx— "Anreichern"-Button im Header- POST /companies/:id/enrich → Suggestions-Modal
- Tabelle: Feld | Aktuell | Vorschlag | Quelle + "Uebernehmen"-Button (PATCH)
- suggestions-Konvertierung: Backend-Record → UI-Array
crm/settings/CrmSettingsPage.tsx— North Data API-Key in Tab "Integrationen"
Kontakt-Entity UI/UX Redesign (aus dieser Sprint-Session)
components/Drawer.tsx+Drawer.module.css— Wiederverwendbarer Right-Side-Drawercrm/contacts/ContactFormModal.tsx— Modal → Drawer, Zwei-Tab-Struktur (Allgemein/Details)crm/contacts/ContactDetailPage.tsx:- Header: Name (Unternehmen) in Klammern, Aktiv/Inaktiv-Badge (Pill mit farbigem Dot)
- Kontaktdaten-Card: immer alle Allgemein-Felder (leere Felder = "—"), 2 Sub-Spalten
- Lexware-Section entfernt (Kontakte werden nicht separat in Lexware gepflegt)
TypeScript
npx tsc --noEmitin packages/frontend: 0 Fehler (alle Commits)
Aktueller Sprint: Sprint 1 (Alpha)
Aenderungen 2026-03-12: CRM UI/UX Redesign – Kontakt-Entitaet
Drawer-Komponente (neu)
packages/frontend/src/components/Drawer.tsx– Wiederverwendbares Right-Side-Drawer-Pattern mit Portal, ESC-Key, Backdrop-Click, optionalem Footerpackages/frontend/src/components/Drawer.module.css– Animiertes Slide-In von rechts, sticky Header + Footer, scrollbarer Body
ContactFormModal – Redesign (Modal → Drawer + Tabs)
- Gewechselt von
<Modal>(zentriert) zu<Drawer>(von rechts, 540px) - Zwei-Tab-Struktur:
- Tab "Allgemein": Vorname, Nachname, Unternehmen (Autocomplete), Position, Abteilung, E-Mail, Telefon, Mobil, LinkedIn
- Tab "Details & Adresse": Geburtsdatum, Quelle, Status, Website, Adresse, Notizen, Tags, Custom Fields
- "Adresse vom Unternehmen uebernehmen" Checkbox: wird angezeigt wenn Unternehmen verlinkt ist; bei aktivierter Checkbox werden Adressfelder ausgeblendet und die Adresse wird aus dem verlinkten Unternehmen uebernommen
- "Typ"-Feld entfernt (Kontakte sind immer Personen; ORGANIZATION-Typ bleibt intern erhalten)
- Sticky Footer (Abbrechen / Anlegen|Speichern) via HTML5
formAttribut - Adress-Duplikate bereinigt
ContactDetailPage – Redesign
- Header: Subtitle "Position @ Unternehmen" unter dem Namen (z.B. "Geschaeftsfuehrerin @ team neusta SE"), Status-Dot inline
- Kontaktdaten-Card: Zwei Sub-Spalten (Kommunikation links, Kontext rechts), Adresse als volle Breite darunter
- Entfernt: Vorname/Nachname (im Header), Firma-Duplikat (nur noch "Unternehmen" als Link)
- Hinzugefuegt: Mobil als
tel:-Link, LinkedIn mit Icon, Geburtsdatum, Quelle, Abteilung
- Neue Card "Notizen & Tags": Tags als Badges, Notizen-Text, Custom Fields
- Layout: Rechte Spalte (Aktivitaeten) auf
minmax(380px, 40%)verbreitert (min. 1/3 fuer kuenftigen O365-Feed) - CSS:
.infoColumns(2-spaltig),.addressRow,.subtitle,.nameRowneu
TypeScript
npx tsc --noEmitin packages/frontend: 0 Fehler
Aenderungen in dieser Session
1. Projektinitialisierung & Infrastruktur-Definition
Was wurde gemacht:
-
SSH Keys erstellt
- Deploy-Key (
.keys/deploy_ed25519) fuer Server-Zugriff - CI/CD-Key (
.keys/cicd_ed25519) fuer Forgejo Actions Pipeline
- Deploy-Key (
-
Infrastruktur-Definition erstellt (
docs/INFRASTRUCTURE.md)- ProxmoxVE VM-Spezifikation: Ubuntu 24.04 LTS, 4 vCPU, 8 GB RAM, 60 GB SSD
- Docker-Netzwerk-Architektur mit 3 isolierten Netzwerken
- Komplette Service-Landschaft definiert
- Schritt-fuer-Schritt VM-Setup Anleitung
-
Zugangsdaten-Dokument erstellt (
docs/ACCESS.md)- Server-IP: 172.20.10.59 (insight-dev-01)
- Git-Server: 172.20.10.11 (GAIA-GIT)
- Alle SSH-Keys, Ports, Befehle dokumentiert
-
Projektstruktur aufgesetzt (packages/core-service, packages/frontend, config, .forgejo)
-
Basis-Konfigurationsdateien (.gitignore, .env.example, README.md)
2. Forgejo Git-Server Konfiguration
Was wurde auf dem Git-Server (172.20.10.11) gemacht:
- Docker Engine 29.3 installiert (fuer Forgejo Actions Runner)
- Forgejo Actions aktiviert (
[actions] ENABLED = truein app.ini) - Container Registry aktiviert (
[packages] ENABLED = truein app.ini) - Forgejo Runner v6.3.1 installiert und registriert
- Runner-Name:
insight-runner - Labels:
ubuntu-latest(docker://node:20) - Laeuft als Systemd-Service (
forgejo-runner.service)
- Runner-Name:
- Repository Secrets angelegt:
SSH_DEPLOY_KEY- CI/CD Private KeyDEPLOY_HOST- 172.20.10.59DEPLOY_USER- deployREGISTRY_USER- gitadminREGISTRY_PASSWORD- Forgejo Access Token
- Branch Protection eingerichtet:
main: Kein direkter Push, 1 Approval erforderlichdevelop: Kein direkter Push, 1 Approval erforderlich
- Forgejo Setup-Anleitung erstellt (
docs/FORGEJO_SETUP.md)
3. Server-Setup (insight-dev-01)
Was wurde auf dem Entwicklungsserver (172.20.10.59) gemacht:
- SSH Public Keys hinterlegt in
/home/deploy/.ssh/authorized_keys- Deploy-Key (
insight-deploy@xinion.lan) - fuer manuellen Zugriff - CI/CD-Key (
insight-cicd@xinion.lan) - fuer Forgejo Actions Pipeline
- Deploy-Key (
- SSH-Zugang getestet - Key-basierter Login als
deployfunktioniert
4. Docker Compose & Service-Konfiguration
Erstellte Dateien:
-
docker-compose.yml- Alle Basis-Services:- Traefik 3 (API Gateway, Reverse Proxy, Rate Limiting)
- PostgreSQL 16-alpine (Performance-Tuning: 1GB shared_buffers, 4GB cache)
- PgBouncer (Connection Pooling, Transaction Mode)
- Redis 7-alpine (Cache, Sessions, Token-Revocation)
- step-ca (Interne Certificate Authority fuer mTLS - geplant)
- Core-Service (NestJS) mit Traefik-Labels
- Frontend (React) mit Traefik-Labels
- 3 isolierte Docker-Netzwerke (insight-web, insight-db, insight-cache)
- Health-Checks fuer alle Services
-
docker-compose.observability.yml- Monitoring-Stack:- Prometheus (Metrics-Sammlung, 30 Tage Retention)
- Grafana (Dashboards, automatisch provisionierte Datenquellen)
- Loki (Log-Aggregation)
- Promtail (Docker Log-Collector)
- Tempo (Distributed Tracing, OTLP gRPC)
- cAdvisor (Container-Metriken)
- PostgreSQL Exporter (DB-Metriken)
-
Konfigurationsdateien:
config/traefik/dynamic/tls.yml- TLS deaktiviert (Alpha/Dev)config/traefik/dynamic/middlewares.yml- Security-Headers, CORS, Compressionconfig/prometheus/prometheus.yml- Scrape-Konfigurationconfig/loki/loki.yml- Log-Storage-Konfigurationconfig/promtail/promtail.yml- Docker-Log-Collectorconfig/tempo/tempo.yml- Tracing-Backendconfig/grafana/provisioning/datasources/datasources.yml- Auto-Provisioningconfig/postgres/init/01-init-extensions.sql- DB-Extensions (uuid-ossp, pgcrypto, pg_trgm)
5. NestJS Core-Service Implementierung
Projekt-Setup:
package.jsonmit allen Dependencies (NestJS 10, Prisma 6, Passport, JWT, bcrypt, TOTP)tsconfig.jsonmit strict: true, noImplicitAny, strictNullChecksDockerfile(Multi-Stage: base, deps, development, build, production)nest-cli.jsonKonfiguration
Implementierte Module:
-
Auth-Modul (
src/core/auth/)AuthService: Login (E-Mail/Passwort), Token-Refresh, Logout, Token-RevocationAuthController: POST /login, /refresh, /logoutJwtStrategy: RS256 Passport-StrategyTotpService: TOTP 2FA (Google Authenticator kompatibel)LoginDto: Validierung mit class-validator- Account-Lockout nach 5 Fehlversuchen (15 Min Sperre)
- Refresh-Token als HttpOnly Cookie (secure/sameSite umgebungsabhaengig)
- Token-Rotation mit Redis-basierter Familien-Erkennung
-
Users-Modul (
src/core/users/)UsersService: CRUD, Bcrypt Cost 12, Passwort-HashingUsersController: GET /me, GET /users, POST /users, PATCH /users/:id- DTOs: CreateUserDto, UpdateUserDto
- Paginierung mit Meta-Informationen
-
Tenants-Modul (
src/core/tenants/)TenantsService: CRUD, Member-ManagementTenantsController: CRUD + POST /:id/members, DELETE /:id/members/:userId- DTOs: CreateTenantDto, UpdateTenantDto, AddMemberDto
- Slug-Validierung (URL-freundlich)
-
Infrastruktur-Module:
PrismaService: PostgreSQL-Verbindung (platform_core)TenantPrismaService: Dynamische Tenant-DB-Verbindungen mit CachingRedisService: Token-Blocklist, Refresh-Token-Familien, generischer CacheHealthController: GET /health (DB + Redis Status)
-
Common (Guards, Decorators, Filter):
@Public()Decorator fuer oeffentliche Routen@Roles()Decorator fuer rollenbasierte Zugriffskontrolle@CurrentUser()Decorator fuer User-Extraktion aus JWTJwtAuthGuard(global) mit Token-Revocation-CheckRolesGuardfuer Rollen-PruefungGlobalExceptionFilterfuer strukturierte Fehlerantworten
-
Config:
validateConfig()mit class-validator fuer Umgebungsvariablen
6. Prisma-Schemas & Migration
-
core.schema.prisma(platform_core Datenbank):User- Plattform-Benutzer (mit Login-Tracking, 2FA)AuthProvider- Multi-Provider Auth (LOCAL, MS_SSO, M2M)Tenant- Mandanten mit JSON-SettingsTenantMembership- User-Tenant-Zuordnung (M:N)Module- Verfuegbare Plattform-ModuleTenantModule- Module pro TenantAuditLog- Plattform-weites Audit-Log
-
tenant.schema.prisma(tenant_{slug} Datenbanken):Contact- CRM-Kontakte (Person/Organisation)Activity- CRM-Aktivitaeten (Notiz, Anruf, E-Mail, Meeting, Task)- Referenz-Schema fuer Sprint 2 (CRM-Modul)
-
Erste Migration erstellt (
prisma/migrations/20260308000000_init/)- 7 Tabellen, alle Indizes und Foreign Keys
migration_lock.tomlfuer Prisma
-
Seed-Script erstellt (
prisma/seed.ts)- Erstellt Platform-Admin:
admin@xinion.de/ChangeMe123! - Bcrypt Cost 12, Rolle: PLATFORM_ADMIN
- Erstellt Platform-Admin:
7. React Frontend-Shell
Projekt-Setup:
package.jsonmit React 18, Vite 6, React Router 6, TanStack Query 5, Axiostsconfig.jsonmit strict TypeScriptvite.config.tsmit API-Proxy und Path-AliasesDockerfile(Multi-Stage: development mit Vite, production mit Nginx)nginx.conf(SPA-Routing, Security-Headers, Caching)
Implementierte Komponenten:
-
Auth-System (
src/auth/)AuthContext+useAuth()Hook: Login, Logout, Silent RefreshLoginPage: E-Mail/Passwort + optionaler TOTP 2FA-Code- Access-Token NUR im Memory (kein localStorage!)
- Automatischer Silent Refresh via HttpOnly Cookie
-
API-Client (
src/api/client.ts)- Axios-Instanz mit automatischem Token-Handling
- Request-Interceptor fuer Authorization-Header
- Response-Interceptor fuer automatisches Token-Refresh bei 401
-
App-Shell (
src/shell/)App: React Router mit PrivateRoute-GuardAppLayout: Sidebar-Navigation + OutletDashboardPage: Willkommens-Seite
-
Admin-Bereich (
src/admin/)AdminUsersPage: Benutzer-Tabelle mit PaginierungAdminTenantsPage: Mandanten-Tabelle mit Member-Count
-
Styling:
- CSS Custom Properties (Farben, Layout, Schatten, Radien)
- CSS Modules fuer komponentenspezifische Styles
- Responsive Sidebar-Layout
8. CI/CD Pipelines
-
.forgejo/workflows/ci.yml- Continuous Integration:- Trigger: Push auf alle Branches + Pull Requests
- Core-Service: npm ci, Prisma Generate, Lint, Type-Check, Test, Build
- Frontend: npm ci, Lint, Type-Check, Build
-
.forgejo/workflows/deploy.yml- Deployment:- Trigger: Push auf main/develop
- Build Docker-Images (Core + Frontend)
- Push in Forgejo Container Registry
- SSH-Deploy auf insight-dev-01
- Health-Check Verifizierung
9. IP-basierte Deployment-Anpassung (HTTP statt HTTPS)
Grund: Kein DNS-Eintrag vorhanden, Zugriff nur ueber IP 172.20.10.59.
Geaenderte Dateien:
-
auth.controller.ts- Cookie secure/sameSite umgebungsabhaengigsecure: true->secure: process.env.NODE_ENV === 'production'sameSite: 'strict'->isProduction ? 'strict' : 'lax'- Betrifft
setRefreshTokenCookie()undlogout()
-
docker-compose.yml- HTTP + IP Umstellung- HTTPS-Redirect entfernt
- TLS-Entrypoint deaktiviert, Port 443 entfernt
- Alle Host-Rules:
insight-dev.xinion.lan->172.20.10.59 - Alle Entrypoints:
websecure->web - URL-Defaults auf
http://172.20.10.59 - PostgreSQL Memory reduziert (1GB/4GB/256MB fuer 8GB RAM VM)
- JWT-Keys Volume-Mount hinzugefuegt:
./keys:/app/keys:ro
-
config/traefik/dynamic/tls.yml- TLS-Konfiguration deaktiviert -
config/traefik/dynamic/middlewares.yml- HSTS-Headers entfernt
- CSP:
wss://insight-dev.xinion.lan->ws://172.20.10.59 - CORS:
https://insight-dev.xinion.lan->http://172.20.10.59
-
main.ts- CORS-Fallback aufhttp://172.20.10.59 -
env.validation.ts- APP_URL Default aufhttp://172.20.10.59 -
.env.example- Alle URLs aufhttp://172.20.10.59 -
package-lock.json- Generiert fuer core-service und frontend (npm ci braucht diese) -
Dokumentation aktualisiert:
docs/INFRASTRUCTURE.md- HTTP statt HTTPS, IP statt DNSdocs/ACCESS.md- Ports, URLs, Default-ZugangsdatenREADME.md- Setup-Anleitung, URLs, Seed-Befehle
Naechste Schritte
- SSH Deploy Keys auf insight-dev-01 Server hinterlegen
docker-compose.ymlerstellen (alle Basis-Services)docker-compose.observability.ymlerstellen- NestJS Core-Service implementieren (Auth, Users, Tenants)
- Prisma-Schemas erstellen (core + tenant)
- React Frontend-Shell implementieren
- CI/CD Pipelines (.forgejo/workflows/) definieren
- Codebase auf HTTP + IP (172.20.10.59) umstellen
- Seed-Script erstellen (admin@xinion.de)
- Prisma-Migration erstellen (init)
- package-lock.json generieren
- Dokumentation aktualisieren
- Commit & Push auf develop
- LVM-Festplatte auf Server erweitern (60GB -> voll nutzbar)
- Docker + Docker Compose auf insight-dev-01 installieren
- Repo klonen, .env + JWT-Keys auf Server erstellen
- Services starten, Migration + Seed ausfuehren
- Erster End-to-End Test (Login -> Dashboard)
Offene Fragen / Abhaengigkeiten
- DNS-Eintrag
insight-dev.xinion.lanwird spaeter eingerichtet (dann HTTPS aktivieren) - LVM auf Server muss erweitert werden (60GB Disk, nur ~56GB sichtbar)