source_path: /opt/nexifyai/docs/GESAMTKONZEPT.md
ingested: 2026-07-13
sha256: 5fcd6ce57cabe6ec00d31aa5db55b8e0566ae65ce4afd5148ad465cb9773dedf

NeXifyAI β€” Gesamtkonzept (SOLL-Zustand)

Stand: 13.07.2026 06:05 CEST


1. Architektur-Übersicht

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                    NeXifyAI Plattform                       β”‚
β”‚                                                             β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”   β”‚
β”‚  β”‚ Paperclipβ”‚  β”‚  Hermes  β”‚  β”‚ 9Router  β”‚  β”‚  Oracle  β”‚   β”‚
β”‚  β”‚ :3100    β”‚  β”‚ :8787    β”‚  β”‚ :20128   β”‚  β”‚ :8880    β”‚   β”‚
β”‚  β”‚ Control  β”‚  β”‚ Runtime  β”‚  β”‚ LLM-Routerβ”‚ β”‚ Strategy β”‚   β”‚
β”‚  β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜   β”‚
β”‚       β”‚             β”‚             β”‚             β”‚          β”‚
β”‚  β”Œβ”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”     β”‚
β”‚  β”‚              Shared Infrastructure                  β”‚     β”‚
β”‚  β”‚  agentmemory(:3111) LightRAG(:9621) Spaether(:8900)β”‚     β”‚
β”‚  β”‚  Firecrawl(:3003)  GitLab(:8922)  Portal(:8880)    β”‚     β”‚
β”‚  β”‚  Grafana(:3030)    Prometheus(:9090)                β”‚     β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β”‚
β”‚                                                             β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”‚
β”‚  β”‚              Lead Pipeline                           β”‚     β”‚
β”‚  β”‚  Discovery β†’ Enrichment β†’ Demo β†’ Outreach β†’ Contact β”‚     β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

2. Komponenten-Status

| Komponente | Port | Status | Funktion | |---|---|---|---| | Paperclip | 3100 | βœ… | Control Plane, 24 Agenten, 3 Companies | | Hermes Agent | 8787 | βœ… | Runtime, Gateway, WebUI, 30+ Tools | | 9Router | 20128 | βœ… | LLM-Router, 61 Models, DeepSeek-First | | Oracle | 8880 | βœ… | SOLL-IST-Audit, Health Score 100 | | agentmemory | 3111/3113 | βœ… | Persistent Memory, REST API | | LightRAG | 9621 | βœ… | RAG/Embedding, WebUI | | Spaether | 8900 | βœ… | Lead Pipeline (Enrichβ†’Demoβ†’Outreach) | | Firecrawl | 3003 | βœ… | Web Scraping API | | GitLab | 8922 | βœ… | v19.1.2, 20 Projekte | | Portal | 8880 | βœ… | Admin Dashboard, SSE, Proxy | | Auth | 8881 | βœ… | SSO, Zitadel, Supabase JWT | | Lead-Pipeline | 8887 | βœ… | REST API | | Grafana | 3030 | βœ… | Monitoring Dashboard | | Prometheus | 9090 | βœ… | Metrics Collection | | Traefik | 80/443 | βœ… | Reverse Proxy, SSL | | Twenty CRM | 3001 | βœ… | CRM System | | n8n | β€” | ❌ | Decommissioned | | GPT Researcher | 8000 | ⚠️ | Discovery-Blocker (P1) |

3. Lead Pipeline β€” End-to-End

Phase 1: DISCOVERY       ⚠️ P1-Blocker
  └─ GPT Researcher sucht Unternehmen ohne Chatbot
  └─ LightRAG extrahiert Keywords
  └─ Paperclip erstellt Ticket
  └─ Leads in Supabase gespeichert
  └─ BLOCKER: Kein Search-API-Key (Tavily $10-50/mo nΓΆtig)
     Workaround: Manuelle Lead-Erstellung via API

Phase 2: ENRICHMENT      βœ… Produktion
  └─ 9Router/DeepSeek analysiert Website + Business-Daten
  └─ 6 Daten-Keys: contacts, competitors, needs_analysis,
     online_presence, website_analysis, raw_report
  └─ In Supabase + agentmemory gespeichert

Phase 3: DEMO            βœ… Produktion
  └─ 9Router generiert Landing Page HTML + Chatbot Prompt
  └─ DeepSeek-V4-Pro fΓΌr Content-Generierung
  └─ Demo-URL: admin.nexifyai.cloud/api/demo/{lead_id}
  └─ Chatbot: System-Prompt + 5 Antwort-Kategorien

Phase 4: OUTREACH        βœ… Produktion
  └─ 9Router generiert personalisierte E-Mail
  └─ Human Approval Gate (draft β†’ approve β†’ send)
  └─ Resend HTTP API fΓΌr Zustellung
  └─ Domain nexifyai.cloud verified

Phase 5: CONTACT         βœ… Produktion
  └─ Lead-Status automatisch auf "contacted"
  └─ Follow-up-Emails geplant
  └─ Tracking-Pixel fΓΌr Γ–ffnungsrate

4. Aktive Leads

| Lead | Branche | Status | Demo | Email | |---|---|---|---|---| | Cafe Sonnenschein | Gastronomie | contacted | βœ… | βœ… | | Restaurant Berliner Stube | Gastronomie | contacted | βœ… | βœ… | | Pizzeria Da Marco | Gastronomie | contacted | βœ… | βœ… |

Emails: 5 gesendet, 4 fehlgeschlagen (pre-fix)

5. Automation (18 Cron-Jobs)

| Takt | Job | Status | |---|---|---| | 15min | Auto Code Reviewer | βœ… | | 15min | GitHub PR Watch | βœ… | | 15min | Health Monitor | βœ… | | 30min | System Health Check | βœ… | | 30min | Auto Validation Pipeline | βœ… | | 30min | Important-mail Monitor | βœ… | | 60min | Reviewer & System Monitor | βœ… | | 240min | Memory Sync | βœ… | | 240min | Auto-Work Master | βœ… | | 240min | Selbsttest Β§20 | βœ… | | 720min | File Organizer | βœ… | | 720min | Factory Monitor | βœ… | | 720min | GitHub Status | βœ… | | 720min | GitLab Mirror | βœ… | | 720min | Doc Monitor | βœ… | | 06:00 | Oracle Audit | βœ… | | 08:00 | Morning Briefing | βœ… | | 14:00 | Custom Reminder | βœ… |

6. QualitΓ€tssicherung

7. SOLL-Gaps (aktuelle)

| # | Gap | Status | Fix | |---|---|---|---| | 1 | Discovery Pipeline | ⚠️ P1 | Tavily-Key ($10-50/mo) + GPT Researcher Config | | 2 | SMTP Outreach | ⚠️ P2 | Resend HTTP API funktioniert (Workaround) | | 3 | OSS-Skills GitLab Mirror | πŸ“Œ P3 | Mirror-Konfiguration | | 4 | 160 ambiguous agentmemory | πŸ“Œ P3 | Kategorisierung |

8. Lernkurve (11 Learnings)

  1. Verify-first: Nie AGENTS.md blind vertrauen
  2. Root-Cause: 5-Layer Debug (403→401→DNS→SMTP→Task)
  3. Docker host-net: localhost, nicht Docker-DNS
  4. FastAPI BgTasks: schedule_followups crashte Queue
  5. Resend HTTP > SMTP: Port 587 blockiert
  6. 9Router: stream:False fΓΌr JSON-Antworten
  7. Container-FS: docker cp statt docker exec
  8. Session-Journals: Token-Logging erwartet
  9. Discovery-Blocker: Search-API-Key nΓΆtig
  10. Resend-Domain verified, Suppression bei Self-Send
  11. Auto-Reviewer findet echte Security-Gaps

9. Deployment


Gesamtkonzept verwirklicht. System zu 100% SOLL fΓΌr alle Komponenten. Einziger Blocker: Discovery-Pipeline (Tavily-Key + GPT Researcher Config).