5a31f52310
Services: Admin-Lehrer, Backend-Lehrer, Studio v2, Website, Klausur-Service, School-Service, Voice-Service, Geo-Service, BreakPilot Drive, Agent-Core Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1204 lines
64 KiB
TypeScript
1204 lines
64 KiB
TypeScript
'use client'
|
|
|
|
/**
|
|
* Alerts Monitoring Admin Page
|
|
*
|
|
* Google Alerts & Feed-Ueberwachung Dashboard
|
|
* Provides inbox management, topic configuration, rule builder, and relevance profiles
|
|
*/
|
|
|
|
import AdminLayout from '@/components/admin/AdminLayout'
|
|
import SystemInfoSection from '@/components/admin/SystemInfoSection'
|
|
import { useEffect, useState, useCallback } from 'react'
|
|
|
|
// Types
|
|
interface AlertItem {
|
|
id: string
|
|
title: string
|
|
url: string
|
|
snippet: string
|
|
topic_name: string
|
|
relevance_score: number | null
|
|
relevance_decision: string | null
|
|
status: string
|
|
fetched_at: string
|
|
published_at: string | null
|
|
matched_rule: string | null
|
|
tags: string[]
|
|
}
|
|
|
|
interface Topic {
|
|
id: string
|
|
name: string
|
|
feed_url: string
|
|
feed_type: string
|
|
is_active: boolean
|
|
fetch_interval_minutes: number
|
|
last_fetched_at: string | null
|
|
alert_count: number
|
|
}
|
|
|
|
interface Rule {
|
|
id: string
|
|
name: string
|
|
topic_id: string | null
|
|
conditions: Array<{
|
|
field: string
|
|
operator: string
|
|
value: string | number
|
|
}>
|
|
action_type: string
|
|
action_config: Record<string, unknown>
|
|
priority: number
|
|
is_active: boolean
|
|
}
|
|
|
|
interface Profile {
|
|
priorities: string[]
|
|
exclusions: string[]
|
|
positive_examples: Array<{ title: string; url: string }>
|
|
negative_examples: Array<{ title: string; url: string }>
|
|
policies: {
|
|
keep_threshold: number
|
|
drop_threshold: number
|
|
}
|
|
}
|
|
|
|
interface Stats {
|
|
total_alerts: number
|
|
new_alerts: number
|
|
kept_alerts: number
|
|
review_alerts: number
|
|
dropped_alerts: number
|
|
total_topics: number
|
|
active_topics: number
|
|
total_rules: number
|
|
}
|
|
|
|
// Tab type
|
|
type TabId = 'dashboard' | 'inbox' | 'topics' | 'rules' | 'profile' | 'audit' | 'documentation'
|
|
|
|
export default function AlertsPage() {
|
|
const [activeTab, setActiveTab] = useState<TabId>('dashboard')
|
|
const [stats, setStats] = useState<Stats | null>(null)
|
|
const [alerts, setAlerts] = useState<AlertItem[]>([])
|
|
const [topics, setTopics] = useState<Topic[]>([])
|
|
const [rules, setRules] = useState<Rule[]>([])
|
|
const [profile, setProfile] = useState<Profile | null>(null)
|
|
const [loading, setLoading] = useState(true)
|
|
const [error, setError] = useState<string | null>(null)
|
|
const [inboxFilter, setInboxFilter] = useState<string>('all')
|
|
|
|
const API_BASE = '/api/alerts'
|
|
|
|
const fetchData = useCallback(async () => {
|
|
try {
|
|
const [statsRes, alertsRes, topicsRes, rulesRes, profileRes] = await Promise.all([
|
|
fetch(`${API_BASE}/stats`),
|
|
fetch(`${API_BASE}/inbox?limit=50`),
|
|
fetch(`${API_BASE}/topics`),
|
|
fetch(`${API_BASE}/rules`),
|
|
fetch(`${API_BASE}/profile`),
|
|
])
|
|
|
|
if (statsRes.ok) setStats(await statsRes.json())
|
|
if (alertsRes.ok) {
|
|
const data = await alertsRes.json()
|
|
setAlerts(data.items || [])
|
|
}
|
|
if (topicsRes.ok) {
|
|
const data = await topicsRes.json()
|
|
setTopics(data.items || data || [])
|
|
}
|
|
if (rulesRes.ok) {
|
|
const data = await rulesRes.json()
|
|
setRules(data.items || data || [])
|
|
}
|
|
if (profileRes.ok) setProfile(await profileRes.json())
|
|
|
|
setError(null)
|
|
} catch (err) {
|
|
setError(err instanceof Error ? err.message : 'Verbindungsfehler')
|
|
// Set demo data
|
|
setStats({
|
|
total_alerts: 147,
|
|
new_alerts: 23,
|
|
kept_alerts: 89,
|
|
review_alerts: 12,
|
|
dropped_alerts: 23,
|
|
total_topics: 5,
|
|
active_topics: 4,
|
|
total_rules: 8,
|
|
})
|
|
setAlerts([
|
|
{
|
|
id: 'demo_1',
|
|
title: 'Neue Studie zur digitalen Bildung an Schulen',
|
|
url: 'https://example.com/artikel1',
|
|
snippet: 'Eine aktuelle Studie zeigt, dass digitale Lernmittel den Lernerfolg steigern koennen...',
|
|
topic_name: 'Digitale Bildung',
|
|
relevance_score: 0.85,
|
|
relevance_decision: 'KEEP',
|
|
status: 'new',
|
|
fetched_at: new Date().toISOString(),
|
|
published_at: null,
|
|
matched_rule: null,
|
|
tags: ['bildung', 'digital'],
|
|
},
|
|
{
|
|
id: 'demo_2',
|
|
title: 'Inklusion: Fortbildungen fuer Lehrkraefte',
|
|
url: 'https://example.com/artikel2',
|
|
snippet: 'Das Kultusministerium bietet neue Fortbildungsangebote zum Thema Inklusion an...',
|
|
topic_name: 'Inklusion',
|
|
relevance_score: 0.72,
|
|
relevance_decision: 'KEEP',
|
|
status: 'new',
|
|
fetched_at: new Date(Date.now() - 3600000).toISOString(),
|
|
published_at: null,
|
|
matched_rule: null,
|
|
tags: ['inklusion'],
|
|
},
|
|
])
|
|
setTopics([
|
|
{
|
|
id: 'topic_1',
|
|
name: 'Digitale Bildung',
|
|
feed_url: 'https://google.com/alerts/feeds/123',
|
|
feed_type: 'rss',
|
|
is_active: true,
|
|
fetch_interval_minutes: 60,
|
|
last_fetched_at: new Date().toISOString(),
|
|
alert_count: 47,
|
|
},
|
|
{
|
|
id: 'topic_2',
|
|
name: 'Inklusion',
|
|
feed_url: 'https://google.com/alerts/feeds/456',
|
|
feed_type: 'rss',
|
|
is_active: true,
|
|
fetch_interval_minutes: 60,
|
|
last_fetched_at: new Date(Date.now() - 1800000).toISOString(),
|
|
alert_count: 32,
|
|
},
|
|
])
|
|
setRules([
|
|
{
|
|
id: 'rule_1',
|
|
name: 'Stellenanzeigen ausschliessen',
|
|
topic_id: null,
|
|
conditions: [{ field: 'title', operator: 'contains', value: 'Stellenangebot' }],
|
|
action_type: 'drop',
|
|
action_config: {},
|
|
priority: 10,
|
|
is_active: true,
|
|
},
|
|
])
|
|
setProfile({
|
|
priorities: ['Inklusion', 'digitale Bildung'],
|
|
exclusions: ['Stellenanzeigen', 'Werbung'],
|
|
positive_examples: [],
|
|
negative_examples: [],
|
|
policies: { keep_threshold: 0.7, drop_threshold: 0.3 },
|
|
})
|
|
} finally {
|
|
setLoading(false)
|
|
}
|
|
}, [])
|
|
|
|
useEffect(() => {
|
|
fetchData()
|
|
}, [fetchData])
|
|
|
|
const formatTimeAgo = (dateStr: string | null) => {
|
|
if (!dateStr) return '-'
|
|
const date = new Date(dateStr)
|
|
const now = new Date()
|
|
const diffMs = now.getTime() - date.getTime()
|
|
const diffMins = Math.floor(diffMs / 60000)
|
|
|
|
if (diffMins < 1) return 'gerade eben'
|
|
if (diffMins < 60) return `vor ${diffMins} Min.`
|
|
if (diffMins < 1440) return `vor ${Math.floor(diffMins / 60)} Std.`
|
|
return `vor ${Math.floor(diffMins / 1440)} Tagen`
|
|
}
|
|
|
|
const getScoreBadge = (score: number | null) => {
|
|
if (score === null) return null
|
|
const pct = Math.round(score * 100)
|
|
let cls = 'bg-slate-100 text-slate-600'
|
|
if (pct >= 70) cls = 'bg-green-100 text-green-800'
|
|
else if (pct >= 40) cls = 'bg-amber-100 text-amber-800'
|
|
else cls = 'bg-red-100 text-red-800'
|
|
return <span className={`px-2 py-0.5 rounded text-xs font-semibold ${cls}`}>{pct}%</span>
|
|
}
|
|
|
|
const getDecisionBadge = (decision: string | null) => {
|
|
if (!decision) return null
|
|
const styles: Record<string, string> = {
|
|
KEEP: 'bg-green-100 text-green-800',
|
|
REVIEW: 'bg-amber-100 text-amber-800',
|
|
DROP: 'bg-red-100 text-red-800',
|
|
}
|
|
return (
|
|
<span className={`px-2 py-0.5 rounded text-xs font-semibold uppercase ${styles[decision] || 'bg-slate-100'}`}>
|
|
{decision}
|
|
</span>
|
|
)
|
|
}
|
|
|
|
const filteredAlerts = alerts.filter((alert) => {
|
|
if (inboxFilter === 'all') return true
|
|
if (inboxFilter === 'new') return alert.status === 'new'
|
|
if (inboxFilter === 'keep') return alert.relevance_decision === 'KEEP'
|
|
if (inboxFilter === 'review') return alert.relevance_decision === 'REVIEW'
|
|
return true
|
|
})
|
|
|
|
// System Info configuration for Audit/Documentation tabs
|
|
const alertsSystemConfig = {
|
|
title: 'Alerts Agent System',
|
|
description: 'Google Alerts & Feed-Ueberwachung mit KI-gestuetzter Relevanzpruefung',
|
|
version: '1.0.0',
|
|
architecture: {
|
|
layers: [
|
|
{
|
|
title: 'Ingestion Layer',
|
|
components: ['RSS Fetcher', 'Email Parser', 'Webhook Receiver', 'APScheduler'],
|
|
color: '#3b82f6',
|
|
},
|
|
{
|
|
title: 'Processing Layer',
|
|
components: ['Deduplication', 'Rule Engine', 'LLM Relevance Scorer'],
|
|
color: '#8b5cf6',
|
|
},
|
|
{
|
|
title: 'Action Layer',
|
|
components: ['Email Actions', 'Webhook Actions', 'Slack Actions'],
|
|
color: '#22c55e',
|
|
},
|
|
{
|
|
title: 'Storage Layer',
|
|
components: ['PostgreSQL', 'Valkey Cache'],
|
|
color: '#f59e0b',
|
|
},
|
|
],
|
|
},
|
|
features: [
|
|
{ name: 'RSS Feed Parsing', status: 'active' as const, description: 'Google Alerts und andere RSS/Atom Feeds' },
|
|
{ name: 'LLM Relevance Scoring', status: 'active' as const, description: 'KI-basierte Relevanzpruefung mit Few-Shot Learning' },
|
|
{ name: 'Rule Engine', status: 'active' as const, description: 'Regelbasierte Filterung mit Conditions' },
|
|
{ name: 'Email Actions', status: 'active' as const, description: 'E-Mail-Benachrichtigungen bei Matches' },
|
|
{ name: 'Webhook Actions', status: 'active' as const, description: 'HTTP Webhooks fuer Integrationen' },
|
|
{ name: 'Slack Actions', status: 'active' as const, description: 'Slack Block Kit Nachrichten' },
|
|
{ name: 'Email Parsing', status: 'planned' as const, description: 'Google Alerts per E-Mail empfangen' },
|
|
{ name: 'Microsoft Teams', status: 'planned' as const, description: 'Teams Adaptive Cards' },
|
|
],
|
|
roadmap: [
|
|
{
|
|
phase: 'Phase 1 (Completed)',
|
|
priority: 'high' as const,
|
|
items: ['PostgreSQL Persistenz', 'Repository Pattern', 'Alembic Migrations'],
|
|
},
|
|
{
|
|
phase: 'Phase 2 (Completed)',
|
|
priority: 'high' as const,
|
|
items: ['Topic CRUD API', 'APScheduler Integration', 'Email Parser'],
|
|
},
|
|
{
|
|
phase: 'Phase 3 (Completed)',
|
|
priority: 'medium' as const,
|
|
items: ['Rule Engine', 'Condition Operators', 'Rule API'],
|
|
},
|
|
{
|
|
phase: 'Phase 4 (Completed)',
|
|
priority: 'medium' as const,
|
|
items: ['Action Dispatcher', 'Email/Webhook/Slack Actions'],
|
|
},
|
|
{
|
|
phase: 'Phase 5 (Current)',
|
|
priority: 'high' as const,
|
|
items: ['Studio Frontend', 'Admin Frontend', 'Audit & Documentation'],
|
|
},
|
|
],
|
|
technicalDetails: [
|
|
{ component: 'Backend', technology: 'FastAPI', version: '0.100+', description: 'Async REST API' },
|
|
{ component: 'ORM', technology: 'SQLAlchemy', version: '2.0', description: 'Async ORM mit PostgreSQL' },
|
|
{ component: 'Scheduler', technology: 'APScheduler', version: '3.x', description: 'AsyncIO Scheduler' },
|
|
{ component: 'HTTP Client', technology: 'httpx', description: 'Async HTTP fuer Webhooks' },
|
|
{ component: 'Feed Parser', technology: 'feedparser', version: '6.x', description: 'RSS/Atom Parsing' },
|
|
{ component: 'LLM Gateway', technology: 'Ollama/vLLM/Claude', description: 'Multi-Provider LLM' },
|
|
],
|
|
privacyNotes: [
|
|
'Alle Daten werden in Deutschland gespeichert (PostgreSQL)',
|
|
'Keine personenbezogenen Daten in Alerts (nur URLs und Snippets)',
|
|
'LLM-Verarbeitung kann on-premise mit Ollama/vLLM erfolgen',
|
|
'DSGVO-konforme Datenverarbeitung',
|
|
],
|
|
auditInfo: [
|
|
{
|
|
category: 'Datenbank',
|
|
items: [
|
|
{ label: 'Tabellen', value: '4 (topics, items, rules, profiles)', status: 'ok' as const },
|
|
{ label: 'Indizes', value: 'URL-Hash, Topic-ID, Status', status: 'ok' as const },
|
|
{ label: 'Backups', value: 'PostgreSQL pg_dump', status: 'ok' as const },
|
|
],
|
|
},
|
|
{
|
|
category: 'API Sicherheit',
|
|
items: [
|
|
{ label: 'Authentifizierung', value: 'Bearer Token (geplant)', status: 'warning' as const },
|
|
{ label: 'Rate Limiting', value: 'Nicht implementiert', status: 'warning' as const },
|
|
{ label: 'Input Validation', value: 'Pydantic Models', status: 'ok' as const },
|
|
],
|
|
},
|
|
{
|
|
category: 'Logging & Monitoring',
|
|
items: [
|
|
{ label: 'Structured Logging', value: 'Python logging', status: 'ok' as const },
|
|
{ label: 'Metriken', value: 'Stats Endpoint', status: 'ok' as const },
|
|
{ label: 'Health Checks', value: '/api/alerts/health', status: 'ok' as const },
|
|
],
|
|
},
|
|
],
|
|
fullDocumentation: `
|
|
<h3>Alerts Agent - Entwicklerdokumentation</h3>
|
|
<h4>API Endpoints</h4>
|
|
<ul>
|
|
<li><code>GET /api/alerts/inbox</code> - Alerts auflisten</li>
|
|
<li><code>POST /api/alerts/ingest</code> - Alert hinzufuegen</li>
|
|
<li><code>GET /api/alerts/topics</code> - Topics auflisten</li>
|
|
<li><code>POST /api/alerts/topics</code> - Topic erstellen</li>
|
|
<li><code>GET /api/alerts/rules</code> - Regeln auflisten</li>
|
|
<li><code>POST /api/alerts/rules</code> - Regel erstellen</li>
|
|
<li><code>GET /api/alerts/profile</code> - Profil abrufen</li>
|
|
<li><code>PUT /api/alerts/profile</code> - Profil aktualisieren</li>
|
|
</ul>
|
|
<h4>Architektur</h4>
|
|
<p>Der Alerts Agent verwendet ein Pipeline-basiertes Design:</p>
|
|
<ol>
|
|
<li><strong>Ingestion</strong>: RSS Feeds werden periodisch abgerufen</li>
|
|
<li><strong>Deduplication</strong>: SimHash-basierte Duplikaterkennung</li>
|
|
<li><strong>Scoring</strong>: LLM-basierte Relevanzpruefung</li>
|
|
<li><strong>Rules</strong>: Regelbasierte Filterung und Aktionen</li>
|
|
<li><strong>Actions</strong>: Email/Webhook/Slack Benachrichtigungen</li>
|
|
</ol>
|
|
`,
|
|
}
|
|
|
|
const tabs: { id: TabId; label: string; badge?: number }[] = [
|
|
{ id: 'dashboard', label: 'Dashboard' },
|
|
{ id: 'inbox', label: 'Inbox', badge: stats?.new_alerts || 0 },
|
|
{ id: 'topics', label: 'Topics' },
|
|
{ id: 'rules', label: 'Regeln' },
|
|
{ id: 'profile', label: 'Profil' },
|
|
{ id: 'audit', label: 'Audit' },
|
|
{ id: 'documentation', label: 'Dokumentation' },
|
|
]
|
|
|
|
return (
|
|
<AdminLayout title="Alerts Monitoring" description="Google Alerts & Feed-Ueberwachung">
|
|
{/* Tab Navigation */}
|
|
<div className="border-b border-slate-200 mb-6">
|
|
<nav className="flex gap-4">
|
|
{tabs.map((tab) => (
|
|
<button
|
|
key={tab.id}
|
|
onClick={() => setActiveTab(tab.id)}
|
|
className={`pb-3 px-1 text-sm font-medium border-b-2 transition-colors flex items-center gap-2 ${
|
|
activeTab === tab.id
|
|
? 'border-primary-600 text-primary-600'
|
|
: 'border-transparent text-slate-500 hover:text-slate-700'
|
|
}`}
|
|
>
|
|
{tab.label}
|
|
{tab.badge !== undefined && tab.badge > 0 && (
|
|
<span className="px-2 py-0.5 rounded-full text-xs font-semibold bg-red-500 text-white">
|
|
{tab.badge}
|
|
</span>
|
|
)}
|
|
</button>
|
|
))}
|
|
</nav>
|
|
</div>
|
|
|
|
{/* Dashboard Tab */}
|
|
{activeTab === 'dashboard' && (
|
|
<div className="space-y-6">
|
|
{/* Stats Grid */}
|
|
<div className="grid grid-cols-2 md:grid-cols-4 gap-4">
|
|
<div className="bg-white rounded-xl border border-slate-200 p-4">
|
|
<div className="text-3xl font-bold text-slate-900">{stats?.total_alerts || 0}</div>
|
|
<div className="text-sm text-slate-500">Alerts gesamt</div>
|
|
</div>
|
|
<div className="bg-white rounded-xl border border-slate-200 p-4">
|
|
<div className="text-3xl font-bold text-blue-600">{stats?.new_alerts || 0}</div>
|
|
<div className="text-sm text-slate-500">Neue Alerts</div>
|
|
</div>
|
|
<div className="bg-white rounded-xl border border-slate-200 p-4">
|
|
<div className="text-3xl font-bold text-green-600">{stats?.kept_alerts || 0}</div>
|
|
<div className="text-sm text-slate-500">Relevant</div>
|
|
</div>
|
|
<div className="bg-white rounded-xl border border-slate-200 p-4">
|
|
<div className="text-3xl font-bold text-amber-600">{stats?.review_alerts || 0}</div>
|
|
<div className="text-sm text-slate-500">Zur Pruefung</div>
|
|
</div>
|
|
</div>
|
|
|
|
{/* Quick Actions */}
|
|
<div className="grid grid-cols-1 md:grid-cols-2 gap-6">
|
|
<div className="bg-white rounded-xl border border-slate-200 p-6">
|
|
<h3 className="font-semibold text-slate-900 mb-4">Aktive Topics</h3>
|
|
<div className="space-y-3">
|
|
{topics.slice(0, 5).map((topic) => (
|
|
<div key={topic.id} className="flex items-center justify-between p-3 bg-slate-50 rounded-lg">
|
|
<div>
|
|
<div className="font-medium text-slate-900">{topic.name}</div>
|
|
<div className="text-xs text-slate-500">{topic.alert_count} Alerts</div>
|
|
</div>
|
|
<span className={`px-2 py-1 rounded text-xs font-semibold ${topic.is_active ? 'bg-green-100 text-green-800' : 'bg-slate-100 text-slate-600'}`}>
|
|
{topic.is_active ? 'Aktiv' : 'Pausiert'}
|
|
</span>
|
|
</div>
|
|
))}
|
|
</div>
|
|
</div>
|
|
|
|
<div className="bg-white rounded-xl border border-slate-200 p-6">
|
|
<h3 className="font-semibold text-slate-900 mb-4">Letzte Alerts</h3>
|
|
<div className="space-y-3">
|
|
{alerts.slice(0, 5).map((alert) => (
|
|
<div key={alert.id} className="p-3 bg-slate-50 rounded-lg">
|
|
<div className="font-medium text-slate-900 text-sm truncate">{alert.title}</div>
|
|
<div className="flex items-center gap-2 mt-1">
|
|
<span className="text-xs text-slate-500">{alert.topic_name}</span>
|
|
{getScoreBadge(alert.relevance_score)}
|
|
</div>
|
|
</div>
|
|
))}
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
{error && (
|
|
<div className="bg-amber-50 border border-amber-200 rounded-lg p-4">
|
|
<p className="text-sm text-amber-800">
|
|
<strong>Hinweis:</strong> API nicht erreichbar. Demo-Daten werden angezeigt.
|
|
</p>
|
|
</div>
|
|
)}
|
|
</div>
|
|
)}
|
|
|
|
{/* Inbox Tab */}
|
|
{activeTab === 'inbox' && (
|
|
<div className="space-y-4">
|
|
{/* Filters */}
|
|
<div className="flex gap-2 flex-wrap">
|
|
{['all', 'new', 'keep', 'review'].map((filter) => (
|
|
<button
|
|
key={filter}
|
|
onClick={() => setInboxFilter(filter)}
|
|
className={`px-4 py-2 rounded-full text-sm font-medium transition-colors ${
|
|
inboxFilter === filter
|
|
? 'bg-primary-600 text-white'
|
|
: 'bg-slate-100 text-slate-600 hover:bg-slate-200'
|
|
}`}
|
|
>
|
|
{filter === 'all' && 'Alle'}
|
|
{filter === 'new' && 'Neu'}
|
|
{filter === 'keep' && 'Relevant'}
|
|
{filter === 'review' && 'Pruefung'}
|
|
</button>
|
|
))}
|
|
</div>
|
|
|
|
{/* Alerts Table */}
|
|
<div className="bg-white rounded-xl border border-slate-200 overflow-hidden">
|
|
<table className="w-full">
|
|
<thead className="bg-slate-50 border-b border-slate-200">
|
|
<tr>
|
|
<th className="text-left p-4 text-xs font-semibold text-slate-500 uppercase">Alert</th>
|
|
<th className="text-left p-4 text-xs font-semibold text-slate-500 uppercase">Topic</th>
|
|
<th className="text-left p-4 text-xs font-semibold text-slate-500 uppercase">Score</th>
|
|
<th className="text-left p-4 text-xs font-semibold text-slate-500 uppercase">Decision</th>
|
|
<th className="text-left p-4 text-xs font-semibold text-slate-500 uppercase">Zeit</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-slate-100">
|
|
{filteredAlerts.map((alert) => (
|
|
<tr key={alert.id} className="hover:bg-slate-50">
|
|
<td className="p-4">
|
|
<a href={alert.url} target="_blank" rel="noopener noreferrer" className="font-medium text-slate-900 hover:text-primary-600">
|
|
{alert.title}
|
|
</a>
|
|
<p className="text-sm text-slate-500 truncate max-w-md">{alert.snippet}</p>
|
|
</td>
|
|
<td className="p-4 text-sm text-slate-600">{alert.topic_name}</td>
|
|
<td className="p-4">{getScoreBadge(alert.relevance_score)}</td>
|
|
<td className="p-4">{getDecisionBadge(alert.relevance_decision)}</td>
|
|
<td className="p-4 text-sm text-slate-500">{formatTimeAgo(alert.fetched_at)}</td>
|
|
</tr>
|
|
))}
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
)}
|
|
|
|
{/* Topics Tab */}
|
|
{activeTab === 'topics' && (
|
|
<div className="space-y-4">
|
|
<div className="flex justify-between items-center">
|
|
<h3 className="font-semibold text-slate-900">Feed Topics</h3>
|
|
<button className="px-4 py-2 bg-primary-600 text-white rounded-lg text-sm font-medium hover:bg-primary-700">
|
|
+ Topic hinzufuegen
|
|
</button>
|
|
</div>
|
|
|
|
<div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
|
|
{topics.map((topic) => (
|
|
<div key={topic.id} className="bg-white rounded-xl border border-slate-200 p-4">
|
|
<div className="flex justify-between items-start mb-3">
|
|
<div className="w-10 h-10 bg-primary-100 rounded-lg flex items-center justify-center">
|
|
<svg className="w-5 h-5 text-primary-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M6 5c7.18 0 13 5.82 13 13M6 11a7 7 0 017 7m-6 0a1 1 0 11-2 0 1 1 0 012 0z" />
|
|
</svg>
|
|
</div>
|
|
<span className={`px-2 py-1 rounded text-xs font-semibold ${topic.is_active ? 'bg-green-100 text-green-800' : 'bg-slate-100 text-slate-600'}`}>
|
|
{topic.is_active ? 'Aktiv' : 'Pausiert'}
|
|
</span>
|
|
</div>
|
|
<h4 className="font-semibold text-slate-900">{topic.name}</h4>
|
|
<p className="text-sm text-slate-500 truncate">{topic.feed_url}</p>
|
|
<div className="flex justify-between items-center mt-4 pt-4 border-t border-slate-100">
|
|
<div className="text-sm">
|
|
<span className="font-semibold text-slate-900">{topic.alert_count}</span>
|
|
<span className="text-slate-500"> Alerts</span>
|
|
</div>
|
|
<div className="text-xs text-slate-500">
|
|
{formatTimeAgo(topic.last_fetched_at)}
|
|
</div>
|
|
</div>
|
|
</div>
|
|
))}
|
|
</div>
|
|
</div>
|
|
)}
|
|
|
|
{/* Rules Tab */}
|
|
{activeTab === 'rules' && (
|
|
<div className="space-y-4">
|
|
<div className="flex justify-between items-center">
|
|
<h3 className="font-semibold text-slate-900">Filterregeln</h3>
|
|
<button className="px-4 py-2 bg-primary-600 text-white rounded-lg text-sm font-medium hover:bg-primary-700">
|
|
+ Regel erstellen
|
|
</button>
|
|
</div>
|
|
|
|
<div className="bg-white rounded-xl border border-slate-200 divide-y divide-slate-100">
|
|
{rules.map((rule) => (
|
|
<div key={rule.id} className="p-4 flex items-center gap-4">
|
|
<div className="text-slate-400 cursor-grab">
|
|
<svg className="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
|
|
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4 6h16M4 12h16M4 18h16" />
|
|
</svg>
|
|
</div>
|
|
<div className="flex-1">
|
|
<div className="font-medium text-slate-900">{rule.name}</div>
|
|
<div className="text-sm text-slate-500">
|
|
Wenn: {rule.conditions[0]?.field} {rule.conditions[0]?.operator} "{rule.conditions[0]?.value}"
|
|
</div>
|
|
</div>
|
|
<span className={`px-3 py-1 rounded text-xs font-semibold uppercase ${
|
|
rule.action_type === 'keep' ? 'bg-green-100 text-green-800' :
|
|
rule.action_type === 'drop' ? 'bg-red-100 text-red-800' :
|
|
rule.action_type === 'email' ? 'bg-blue-100 text-blue-800' :
|
|
'bg-purple-100 text-purple-800'
|
|
}`}>
|
|
{rule.action_type}
|
|
</span>
|
|
<div
|
|
className={`w-12 h-6 rounded-full relative cursor-pointer transition-colors ${
|
|
rule.is_active ? 'bg-green-500' : 'bg-slate-300'
|
|
}`}
|
|
>
|
|
<div
|
|
className={`absolute w-5 h-5 bg-white rounded-full top-0.5 transition-all ${
|
|
rule.is_active ? 'left-6' : 'left-0.5'
|
|
}`}
|
|
/>
|
|
</div>
|
|
</div>
|
|
))}
|
|
</div>
|
|
</div>
|
|
)}
|
|
|
|
{/* Profile Tab */}
|
|
{activeTab === 'profile' && (
|
|
<div className="max-w-2xl space-y-6">
|
|
<div className="bg-white rounded-xl border border-slate-200 p-6">
|
|
<h3 className="font-semibold text-slate-900 mb-4">Relevanzprofil</h3>
|
|
|
|
<div className="space-y-4">
|
|
<div>
|
|
<label className="block text-sm font-medium text-slate-700 mb-2">
|
|
Prioritaeten (wichtige Themen)
|
|
</label>
|
|
<textarea
|
|
className="w-full p-3 border border-slate-200 rounded-lg text-sm"
|
|
rows={4}
|
|
defaultValue={profile?.priorities?.join('\n') || ''}
|
|
placeholder="Ein Thema pro Zeile..."
|
|
/>
|
|
<p className="text-xs text-slate-500 mt-1">Alerts zu diesen Themen werden hoeher bewertet.</p>
|
|
</div>
|
|
|
|
<div>
|
|
<label className="block text-sm font-medium text-slate-700 mb-2">
|
|
Ausschluesse (unerwuenschte Themen)
|
|
</label>
|
|
<textarea
|
|
className="w-full p-3 border border-slate-200 rounded-lg text-sm"
|
|
rows={4}
|
|
defaultValue={profile?.exclusions?.join('\n') || ''}
|
|
placeholder="Ein Thema pro Zeile..."
|
|
/>
|
|
<p className="text-xs text-slate-500 mt-1">Alerts zu diesen Themen werden niedriger bewertet.</p>
|
|
</div>
|
|
|
|
<div className="grid grid-cols-2 gap-4">
|
|
<div>
|
|
<label className="block text-sm font-medium text-slate-700 mb-2">
|
|
Schwellenwert KEEP
|
|
</label>
|
|
<select
|
|
className="w-full p-3 border border-slate-200 rounded-lg text-sm"
|
|
defaultValue={profile?.policies?.keep_threshold || 0.7}
|
|
>
|
|
<option value={0.8}>80% (sehr streng)</option>
|
|
<option value={0.7}>70% (empfohlen)</option>
|
|
<option value={0.6}>60% (weniger streng)</option>
|
|
</select>
|
|
</div>
|
|
<div>
|
|
<label className="block text-sm font-medium text-slate-700 mb-2">
|
|
Schwellenwert DROP
|
|
</label>
|
|
<select
|
|
className="w-full p-3 border border-slate-200 rounded-lg text-sm"
|
|
defaultValue={profile?.policies?.drop_threshold || 0.3}
|
|
>
|
|
<option value={0.4}>40% (strenger)</option>
|
|
<option value={0.3}>30% (empfohlen)</option>
|
|
<option value={0.2}>20% (lockerer)</option>
|
|
</select>
|
|
</div>
|
|
</div>
|
|
|
|
<button className="px-4 py-2 bg-primary-600 text-white rounded-lg text-sm font-medium hover:bg-primary-700">
|
|
Profil speichern
|
|
</button>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
)}
|
|
|
|
{/* Audit Tab */}
|
|
{activeTab === 'audit' && (
|
|
<SystemInfoSection config={alertsSystemConfig} />
|
|
)}
|
|
|
|
{/* Documentation Tab */}
|
|
{activeTab === 'documentation' && (
|
|
<div className="bg-white rounded-xl border border-slate-200 p-6 overflow-auto max-h-[calc(100vh-200px)]">
|
|
<div className="prose prose-slate max-w-none prose-headings:font-semibold prose-h1:text-2xl prose-h2:text-xl prose-h3:text-lg prose-pre:bg-slate-900 prose-pre:text-slate-100">
|
|
{/* Header */}
|
|
<div className="not-prose mb-8 pb-6 border-b border-slate-200">
|
|
<h1 className="text-2xl font-bold text-slate-900">BreakPilot Alerts Agent</h1>
|
|
<p className="text-sm text-slate-500 mt-1">Version: 1.0.0 | Stand: Januar 2026 | Autor: BreakPilot Development Team</p>
|
|
</div>
|
|
|
|
{/* Audit Box */}
|
|
<div className="not-prose bg-blue-50 border border-blue-200 rounded-lg p-4 mb-6">
|
|
<h3 className="font-semibold text-blue-900 mb-2">Audit-Relevante Informationen</h3>
|
|
<p className="text-sm text-blue-800">
|
|
Dieses Dokument dient als technische Dokumentation fuer das Alert-Monitoring-System der BreakPilot Plattform.
|
|
Es ist fuer Audits durch Bildungstraeger und Datenschutzbeauftragte konzipiert.
|
|
</p>
|
|
</div>
|
|
|
|
{/* Ziel des Systems */}
|
|
<h2>Ziel des Alert-Systems</h2>
|
|
<p>Das System ermoeglicht automatisierte Ueberwachung von Bildungsthemen mit:</p>
|
|
<ul>
|
|
<li><strong>Google Alerts Integration</strong>: RSS-Feeds von Google Alerts automatisch abrufen</li>
|
|
<li><strong>RSS/Atom Feeds</strong>: Beliebige Nachrichtenquellen einbinden</li>
|
|
<li><strong>KI-Relevanzpruefung</strong>: Automatische Bewertung der Relevanz durch LLM</li>
|
|
<li><strong>Regelbasierte Filterung</strong>: Flexible Regeln fuer automatische Sortierung</li>
|
|
<li><strong>Multi-Channel Actions</strong>: E-Mail, Webhook, Slack Benachrichtigungen</li>
|
|
<li><strong>Few-Shot Learning</strong>: Profil verbessert sich durch Nutzerfeedback</li>
|
|
</ul>
|
|
|
|
{/* Datenschutz Compliance */}
|
|
<h2>Datenschutz-Compliance</h2>
|
|
<div className="not-prose overflow-x-auto">
|
|
<table className="min-w-full text-sm">
|
|
<thead className="bg-slate-50">
|
|
<tr>
|
|
<th className="px-4 py-2 text-left font-semibold">Massnahme</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Umsetzung</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Wirkung</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-slate-200">
|
|
<tr><td className="px-4 py-2">100% Self-Hosted</td><td className="px-4 py-2">Alle Dienste auf eigenen Servern</td><td className="px-4 py-2">Keine Cloud-Abhaengigkeit</td></tr>
|
|
<tr><td className="px-4 py-2">Lokale KI</td><td className="px-4 py-2">Ollama/vLLM on-premise</td><td className="px-4 py-2">Keine Daten an OpenAI etc.</td></tr>
|
|
<tr><td className="px-4 py-2">URL-Deduplizierung</td><td className="px-4 py-2">SHA256-Hash, Tracking entfernt</td><td className="px-4 py-2">Minimale Datenspeicherung</td></tr>
|
|
<tr><td className="px-4 py-2">Soft-Delete</td><td className="px-4 py-2">Archivierung statt Loeschung</td><td className="px-4 py-2">Audit-Trail erhalten</td></tr>
|
|
<tr><td className="px-4 py-2">RBAC</td><td className="px-4 py-2">Rollenbasierte Zugriffskontrolle</td><td className="px-4 py-2">Nur autorisierter Zugriff</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
{/* Architektur */}
|
|
<h2>1. Systemarchitektur</h2>
|
|
<h3>Gesamtarchitektur</h3>
|
|
<pre className="text-xs leading-tight overflow-x-auto">{`┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ BreakPilot Alerts Frontend │
|
|
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
|
|
│ │ Dashboard │ │ Inbox │ │ Topics │ │ Profile │ │
|
|
│ │ (Stats) │ │ (Review) │ │ (Feeds) │ │ (Learning) │ │
|
|
│ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ │
|
|
└─────────────────────────────────┬───────────────────────────────────────────┘
|
|
│
|
|
v
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ Ingestion Layer │
|
|
│ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │
|
|
│ │ RSS Fetcher │ │ Email Parser │ │ APScheduler │ │
|
|
│ │ (feedparser) │ │ (geplant) │ │ (AsyncIO) │ │
|
|
│ └───────┬────────┘ └───────┬────────┘ └───────┬────────┘ │
|
|
│ └───────────────────┼───────────────────┘ │
|
|
│ │ │
|
|
│ ┌──────────────────────────────────────────────────────────────┐ │
|
|
│ │ Deduplication (URL-Hash + SimHash) │ │
|
|
│ └──────────────────────────────────────────────────────────────┘ │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
│
|
|
v
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ Processing Layer │
|
|
│ ┌────────────────────────────────────────────────────────────┐ │
|
|
│ │ Rule Engine │ │
|
|
│ │ Operatoren: contains, regex, gt/lt, in, starts_with │ │
|
|
│ └────────────────────────────────────────────────────────────┘ │
|
|
│ │ │
|
|
│ ┌────────────────────────────────────────────────────────────┐ │
|
|
│ │ LLM Relevance Scorer │ │
|
|
│ │ Output: { score, decision: KEEP/DROP/REVIEW, summary } │ │
|
|
│ └────────────────────────────────────────────────────────────┘ │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
│
|
|
v
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ Action Layer │
|
|
│ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │
|
|
│ │ Email Action │ │ Webhook Action │ │ Slack Action │ │
|
|
│ └────────────────┘ └────────────────┘ └────────────────┘ │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
│
|
|
v
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ Storage Layer │
|
|
│ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │
|
|
│ │ PostgreSQL │ │ Valkey │ │ LLM Gateway │ │
|
|
│ └────────────────┘ └────────────────┘ └────────────────┘ │
|
|
└─────────────────────────────────────────────────────────────────────────────┘`}</pre>
|
|
|
|
{/* Datenfluss */}
|
|
<h3>Datenfluss bei Alert-Verarbeitung</h3>
|
|
<pre className="text-xs leading-tight overflow-x-auto">{`1. APScheduler triggert Fetch (alle 60 Min. default)
|
|
│
|
|
v
|
|
2. RSS Fetcher holt Feed von Google Alerts
|
|
│
|
|
v
|
|
3. Deduplizierung prueft URL-Hash
|
|
│
|
|
├── URL bekannt ──> Uebersprungen
|
|
└── URL neu ──> Weiter
|
|
│
|
|
v
|
|
4. Alert in Datenbank gespeichert (Status: NEW)
|
|
│
|
|
v
|
|
5. Rule Engine evaluiert aktive Regeln
|
|
│
|
|
├── Regel matcht ──> Aktion ausfuehren
|
|
└── Keine Regel ──> LLM Scoring
|
|
│
|
|
v
|
|
6. LLM Relevance Scorer
|
|
│
|
|
├── KEEP (>= 0.7) ──> Inbox
|
|
├── REVIEW (0.4-0.7) ──> Inbox (Pruefung)
|
|
└── DROP (< 0.4) ──> Archiviert
|
|
│
|
|
v
|
|
7. Nutzer-Feedback ──> Profile aktualisieren`}</pre>
|
|
|
|
{/* Feed Ingestion */}
|
|
<h2>2. Feed Ingestion</h2>
|
|
<h3>RSS Fetcher</h3>
|
|
<div className="not-prose overflow-x-auto">
|
|
<table className="min-w-full text-sm">
|
|
<thead className="bg-slate-50">
|
|
<tr>
|
|
<th className="px-4 py-2 text-left font-semibold">Eigenschaft</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Wert</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Beschreibung</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-slate-200">
|
|
<tr><td className="px-4 py-2">Parser</td><td className="px-4 py-2">feedparser 6.x</td><td className="px-4 py-2">Standard RSS/Atom Parser</td></tr>
|
|
<tr><td className="px-4 py-2">HTTP Client</td><td className="px-4 py-2">httpx (async)</td><td className="px-4 py-2">Non-blocking Fetches</td></tr>
|
|
<tr><td className="px-4 py-2">Timeout</td><td className="px-4 py-2">30 Sekunden</td><td className="px-4 py-2">Konfigurierbar</td></tr>
|
|
<tr><td className="px-4 py-2">Parallelitaet</td><td className="px-4 py-2">Ja (asyncio.gather)</td><td className="px-4 py-2">Mehrere Feeds gleichzeitig</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<h3>Deduplizierung</h3>
|
|
<p>Die Deduplizierung verhindert doppelte Alerts durch:</p>
|
|
<ol>
|
|
<li><strong>URL-Normalisierung</strong>: Tracking-Parameter entfernen (utm_*, fbclid, gclid), Hostname lowercase, Trailing Slash entfernen</li>
|
|
<li><strong>URL-Hash</strong>: SHA256 der normalisierten URL, erste 16 Zeichen als Index</li>
|
|
</ol>
|
|
|
|
{/* Rule Engine */}
|
|
<h2>3. Rule Engine</h2>
|
|
<h3>Unterstuetzte Operatoren</h3>
|
|
<div className="not-prose overflow-x-auto">
|
|
<table className="min-w-full text-sm">
|
|
<thead className="bg-slate-50">
|
|
<tr>
|
|
<th className="px-4 py-2 text-left font-semibold">Operator</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Beschreibung</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Beispiel</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-slate-200">
|
|
<tr><td className="px-4 py-2 font-mono text-xs">contains</td><td className="px-4 py-2">Text enthaelt</td><td className="px-4 py-2">title contains "Inklusion"</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">not_contains</td><td className="px-4 py-2">Text enthaelt nicht</td><td className="px-4 py-2">title not_contains "Werbung"</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">equals</td><td className="px-4 py-2">Exakte Uebereinstimmung</td><td className="px-4 py-2">status equals "new"</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">regex</td><td className="px-4 py-2">Regulaerer Ausdruck</td><td className="px-4 py-2">title regex "\\d{4}"</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">gt / lt</td><td className="px-4 py-2">Groesser/Kleiner</td><td className="px-4 py-2">relevance_score gt 0.8</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">in</td><td className="px-4 py-2">In Liste enthalten</td><td className="px-4 py-2">title in ["KI", "AI"]</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<h3>Verfuegbare Felder</h3>
|
|
<div className="not-prose overflow-x-auto">
|
|
<table className="min-w-full text-sm">
|
|
<thead className="bg-slate-50">
|
|
<tr>
|
|
<th className="px-4 py-2 text-left font-semibold">Feld</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Typ</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Beschreibung</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-slate-200">
|
|
<tr><td className="px-4 py-2 font-mono text-xs">title</td><td className="px-4 py-2">String</td><td className="px-4 py-2">Alert-Titel</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">snippet</td><td className="px-4 py-2">String</td><td className="px-4 py-2">Textausschnitt</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">url</td><td className="px-4 py-2">String</td><td className="px-4 py-2">Artikel-URL</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">source</td><td className="px-4 py-2">Enum</td><td className="px-4 py-2">google_alerts_rss, rss_feed, manual</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">relevance_score</td><td className="px-4 py-2">Float</td><td className="px-4 py-2">0.0 - 1.0</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">relevance_decision</td><td className="px-4 py-2">Enum</td><td className="px-4 py-2">KEEP, DROP, REVIEW</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<h3>Aktionen</h3>
|
|
<div className="not-prose overflow-x-auto">
|
|
<table className="min-w-full text-sm">
|
|
<thead className="bg-slate-50">
|
|
<tr>
|
|
<th className="px-4 py-2 text-left font-semibold">Aktion</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Beschreibung</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Konfiguration</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-slate-200">
|
|
<tr><td className="px-4 py-2 font-mono text-xs">keep</td><td className="px-4 py-2">Als relevant markieren</td><td className="px-4 py-2">-</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">drop</td><td className="px-4 py-2">Archivieren</td><td className="px-4 py-2">-</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">tag</td><td className="px-4 py-2">Tags hinzufuegen</td><td className="px-4 py-2">{"tags": ["wichtig"]}</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">email</td><td className="px-4 py-2">E-Mail senden</td><td className="px-4 py-2">{"to": "x@y.de"}</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">webhook</td><td className="px-4 py-2">HTTP POST</td><td className="px-4 py-2">{"url": "https://..."}</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">slack</td><td className="px-4 py-2">Slack-Nachricht</td><td className="px-4 py-2">{"webhook_url": "..."}</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
{/* KI Relevanzpruefung */}
|
|
<h2>4. KI-Relevanzpruefung</h2>
|
|
<h3>LLM Scorer</h3>
|
|
<div className="not-prose overflow-x-auto">
|
|
<table className="min-w-full text-sm">
|
|
<thead className="bg-slate-50">
|
|
<tr>
|
|
<th className="px-4 py-2 text-left font-semibold">Eigenschaft</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Wert</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Beschreibung</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-slate-200">
|
|
<tr><td className="px-4 py-2">Gateway URL</td><td className="px-4 py-2">http://localhost:8000/llm</td><td className="px-4 py-2">LLM Gateway Endpoint</td></tr>
|
|
<tr><td className="px-4 py-2">Modell</td><td className="px-4 py-2">breakpilot-teacher-8b</td><td className="px-4 py-2">Fein-getuntes Llama 3.1</td></tr>
|
|
<tr><td className="px-4 py-2">Temperatur</td><td className="px-4 py-2">0.3</td><td className="px-4 py-2">Niedrig fuer Konsistenz</td></tr>
|
|
<tr><td className="px-4 py-2">Max Tokens</td><td className="px-4 py-2">500</td><td className="px-4 py-2">Response-Limit</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<h3>Bewertungskriterien</h3>
|
|
<div className="not-prose overflow-x-auto">
|
|
<table className="min-w-full text-sm">
|
|
<thead className="bg-slate-50">
|
|
<tr>
|
|
<th className="px-4 py-2 text-left font-semibold">Entscheidung</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Score-Bereich</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Bedeutung</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-slate-200">
|
|
<tr className="bg-green-50"><td className="px-4 py-2 font-semibold text-green-800">KEEP</td><td className="px-4 py-2">0.7 - 1.0</td><td className="px-4 py-2">Klar relevant, in Inbox anzeigen</td></tr>
|
|
<tr className="bg-amber-50"><td className="px-4 py-2 font-semibold text-amber-800">REVIEW</td><td className="px-4 py-2">0.4 - 0.7</td><td className="px-4 py-2">Unsicher, Nutzer entscheidet</td></tr>
|
|
<tr className="bg-red-50"><td className="px-4 py-2 font-semibold text-red-800">DROP</td><td className="px-4 py-2">0.0 - 0.4</td><td className="px-4 py-2">Irrelevant, automatisch archivieren</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<h3>Few-Shot Learning</h3>
|
|
<p>Das Profil verbessert sich durch Nutzerfeedback:</p>
|
|
<ol>
|
|
<li>Nutzer markiert Alert als relevant/irrelevant</li>
|
|
<li>Alert wird als positives/negatives Beispiel gespeichert</li>
|
|
<li>Beispiele werden in den Prompt eingefuegt (max. 5 pro Kategorie)</li>
|
|
<li>LLM lernt aus konkreten Beispielen des Nutzers</li>
|
|
</ol>
|
|
|
|
{/* Relevanz Profile */}
|
|
<h2>5. Relevanz-Profile</h2>
|
|
<h3>Standard-Bildungsprofil</h3>
|
|
<div className="not-prose overflow-x-auto">
|
|
<table className="min-w-full text-sm">
|
|
<thead className="bg-slate-50">
|
|
<tr>
|
|
<th className="px-4 py-2 text-left font-semibold">Prioritaet</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Gewicht</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Keywords</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-slate-200">
|
|
<tr><td className="px-4 py-2">Inklusion</td><td className="px-4 py-2">0.9</td><td className="px-4 py-2">inklusiv, Foerderbedarf, Behinderung</td></tr>
|
|
<tr><td className="px-4 py-2">Datenschutz Schule</td><td className="px-4 py-2">0.85</td><td className="px-4 py-2">DSGVO, Schuelerfotos, Einwilligung</td></tr>
|
|
<tr><td className="px-4 py-2">Schulrecht Bayern</td><td className="px-4 py-2">0.8</td><td className="px-4 py-2">BayEUG, Schulordnung, KM</td></tr>
|
|
<tr><td className="px-4 py-2">Digitalisierung Schule</td><td className="px-4 py-2">0.7</td><td className="px-4 py-2">DigitalPakt, Tablet-Klasse</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<h3>Standard-Ausschluesse</h3>
|
|
<ul>
|
|
<li>Stellenanzeige</li>
|
|
<li>Praktikum gesucht</li>
|
|
<li>Werbung</li>
|
|
<li>Pressemitteilung</li>
|
|
</ul>
|
|
|
|
{/* API Endpoints */}
|
|
<h2>6. API Endpoints</h2>
|
|
<h3>Alerts API</h3>
|
|
<div className="not-prose overflow-x-auto">
|
|
<table className="min-w-full text-sm">
|
|
<thead className="bg-slate-50">
|
|
<tr>
|
|
<th className="px-4 py-2 text-left font-semibold">Endpoint</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Methode</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Beschreibung</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-slate-200">
|
|
<tr><td className="px-4 py-2 font-mono text-xs">/api/alerts/inbox</td><td className="px-4 py-2">GET</td><td className="px-4 py-2">Inbox Items abrufen</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">/api/alerts/ingest</td><td className="px-4 py-2">POST</td><td className="px-4 py-2">Manuell Alert importieren</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">/api/alerts/run</td><td className="px-4 py-2">POST</td><td className="px-4 py-2">Scoring-Pipeline starten</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">/api/alerts/feedback</td><td className="px-4 py-2">POST</td><td className="px-4 py-2">Relevanz-Feedback geben</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">/api/alerts/stats</td><td className="px-4 py-2">GET</td><td className="px-4 py-2">Statistiken abrufen</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<h3>Topics API</h3>
|
|
<div className="not-prose overflow-x-auto">
|
|
<table className="min-w-full text-sm">
|
|
<thead className="bg-slate-50">
|
|
<tr>
|
|
<th className="px-4 py-2 text-left font-semibold">Endpoint</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Methode</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Beschreibung</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-slate-200">
|
|
<tr><td className="px-4 py-2 font-mono text-xs">/api/alerts/topics</td><td className="px-4 py-2">GET</td><td className="px-4 py-2">Topics auflisten</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">/api/alerts/topics</td><td className="px-4 py-2">POST</td><td className="px-4 py-2">Neues Topic erstellen</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">/api/alerts/topics/{id}</td><td className="px-4 py-2">PUT</td><td className="px-4 py-2">Topic aktualisieren</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">/api/alerts/topics/{id}</td><td className="px-4 py-2">DELETE</td><td className="px-4 py-2">Topic loeschen (CASCADE)</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">/api/alerts/topics/{id}/fetch</td><td className="px-4 py-2">POST</td><td className="px-4 py-2">Manueller Feed-Abruf</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<h3>Rules & Profile API</h3>
|
|
<div className="not-prose overflow-x-auto">
|
|
<table className="min-w-full text-sm">
|
|
<thead className="bg-slate-50">
|
|
<tr>
|
|
<th className="px-4 py-2 text-left font-semibold">Endpoint</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Methode</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Beschreibung</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-slate-200">
|
|
<tr><td className="px-4 py-2 font-mono text-xs">/api/alerts/rules</td><td className="px-4 py-2">GET/POST</td><td className="px-4 py-2">Regeln verwalten</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">/api/alerts/rules/{id}</td><td className="px-4 py-2">PUT/DELETE</td><td className="px-4 py-2">Regel bearbeiten/loeschen</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">/api/alerts/profile</td><td className="px-4 py-2">GET</td><td className="px-4 py-2">Profil abrufen</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">/api/alerts/profile</td><td className="px-4 py-2">PUT</td><td className="px-4 py-2">Profil aktualisieren</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">/api/alerts/scheduler/status</td><td className="px-4 py-2">GET</td><td className="px-4 py-2">Scheduler-Status</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
{/* Datenbank Schema */}
|
|
<h2>7. Datenbank-Schema</h2>
|
|
<h3>Tabellen</h3>
|
|
<div className="not-prose overflow-x-auto">
|
|
<table className="min-w-full text-sm">
|
|
<thead className="bg-slate-50">
|
|
<tr>
|
|
<th className="px-4 py-2 text-left font-semibold">Tabelle</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Beschreibung</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Wichtige Felder</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-slate-200">
|
|
<tr><td className="px-4 py-2 font-mono text-xs">alert_topics</td><td className="px-4 py-2">Feed-Quellen</td><td className="px-4 py-2">name, feed_url, feed_type, is_active, fetch_interval</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">alert_items</td><td className="px-4 py-2">Einzelne Alerts</td><td className="px-4 py-2">title, url, url_hash, relevance_score, relevance_decision</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">alert_rules</td><td className="px-4 py-2">Filterregeln</td><td className="px-4 py-2">name, conditions (JSON), action_type, priority</td></tr>
|
|
<tr><td className="px-4 py-2 font-mono text-xs">alert_profiles</td><td className="px-4 py-2">Nutzer-Profile</td><td className="px-4 py-2">priorities, exclusions, positive/negative_examples</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
{/* DSGVO */}
|
|
<h2>8. DSGVO-Konformitaet</h2>
|
|
<h3>Rechtsgrundlage (Art. 6 DSGVO)</h3>
|
|
<div className="not-prose overflow-x-auto">
|
|
<table className="min-w-full text-sm">
|
|
<thead className="bg-slate-50">
|
|
<tr>
|
|
<th className="px-4 py-2 text-left font-semibold">Verarbeitung</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Rechtsgrundlage</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Umsetzung</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-slate-200">
|
|
<tr><td className="px-4 py-2">Feed-Abruf</td><td className="px-4 py-2">Art. 6(1)(f) - Berechtigtes Interesse</td><td className="px-4 py-2">Informationsbeschaffung</td></tr>
|
|
<tr><td className="px-4 py-2">Alert-Speicherung</td><td className="px-4 py-2">Art. 6(1)(f) - Berechtigtes Interesse</td><td className="px-4 py-2">Nur oeffentliche Informationen</td></tr>
|
|
<tr><td className="px-4 py-2">LLM-Scoring</td><td className="px-4 py-2">Art. 6(1)(f) - Berechtigtes Interesse</td><td className="px-4 py-2">On-Premise, keine PII</td></tr>
|
|
<tr><td className="px-4 py-2">Profil-Learning</td><td className="px-4 py-2">Art. 6(1)(a) - Einwilligung</td><td className="px-4 py-2">Opt-in durch Nutzung</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<h3>Technische Datenschutz-Massnahmen</h3>
|
|
<ul>
|
|
<li><strong>Datenminimierung</strong>: Nur Titel, URL, Snippet - keine personenbezogenen Daten</li>
|
|
<li><strong>Lokale Verarbeitung</strong>: Ollama/vLLM on-premise - kein Datenabfluss an Cloud</li>
|
|
<li><strong>Pseudonymisierung</strong>: UUIDs statt Namen</li>
|
|
<li><strong>Automatische Loeschung</strong>: 90 Tage Retention fuer archivierte Alerts</li>
|
|
<li><strong>Audit-Logging</strong>: Stats und Match-Counts fuer Nachvollziehbarkeit</li>
|
|
</ul>
|
|
|
|
{/* Open Source */}
|
|
<h2>9. Open Source Lizenzen (SBOM)</h2>
|
|
<h3>Python Dependencies</h3>
|
|
<div className="not-prose overflow-x-auto">
|
|
<table className="min-w-full text-sm">
|
|
<thead className="bg-slate-50">
|
|
<tr>
|
|
<th className="px-4 py-2 text-left font-semibold">Komponente</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Lizenz</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Kommerziell</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-slate-200">
|
|
<tr><td className="px-4 py-2">FastAPI</td><td className="px-4 py-2">MIT</td><td className="px-4 py-2 text-green-600">Ja</td></tr>
|
|
<tr><td className="px-4 py-2">SQLAlchemy</td><td className="px-4 py-2">MIT</td><td className="px-4 py-2 text-green-600">Ja</td></tr>
|
|
<tr><td className="px-4 py-2">httpx</td><td className="px-4 py-2">BSD-3-Clause</td><td className="px-4 py-2 text-green-600">Ja</td></tr>
|
|
<tr><td className="px-4 py-2">feedparser</td><td className="px-4 py-2">BSD-2-Clause</td><td className="px-4 py-2 text-green-600">Ja</td></tr>
|
|
<tr><td className="px-4 py-2">APScheduler</td><td className="px-4 py-2">MIT</td><td className="px-4 py-2 text-green-600">Ja</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<h3>KI-Komponenten</h3>
|
|
<div className="not-prose overflow-x-auto">
|
|
<table className="min-w-full text-sm">
|
|
<thead className="bg-slate-50">
|
|
<tr>
|
|
<th className="px-4 py-2 text-left font-semibold">Komponente</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Lizenz</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Kommerziell</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-slate-200">
|
|
<tr><td className="px-4 py-2">Ollama</td><td className="px-4 py-2">MIT</td><td className="px-4 py-2 text-green-600">Ja</td></tr>
|
|
<tr><td className="px-4 py-2">Llama 3.1</td><td className="px-4 py-2">Meta Llama 3</td><td className="px-4 py-2 text-green-600">Ja*</td></tr>
|
|
<tr><td className="px-4 py-2">vLLM</td><td className="px-4 py-2">Apache-2.0</td><td className="px-4 py-2 text-green-600">Ja</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
{/* Kontakt */}
|
|
<h2>10. Kontakt & Support</h2>
|
|
<div className="not-prose overflow-x-auto">
|
|
<table className="min-w-full text-sm">
|
|
<thead className="bg-slate-50">
|
|
<tr>
|
|
<th className="px-4 py-2 text-left font-semibold">Kontakt</th>
|
|
<th className="px-4 py-2 text-left font-semibold">Adresse</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody className="divide-y divide-slate-200">
|
|
<tr><td className="px-4 py-2">Technischer Support</td><td className="px-4 py-2">support@breakpilot.de</td></tr>
|
|
<tr><td className="px-4 py-2">Datenschutzbeauftragter</td><td className="px-4 py-2">dsb@breakpilot.de</td></tr>
|
|
<tr><td className="px-4 py-2">Dokumentation</td><td className="px-4 py-2">docs.breakpilot.de</td></tr>
|
|
<tr><td className="px-4 py-2">GitHub</td><td className="px-4 py-2">github.com/breakpilot</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
{/* Footer */}
|
|
<div className="not-prose mt-8 pt-6 border-t border-slate-200 text-sm text-slate-500">
|
|
<p>Dokumentation erstellt: Januar 2026 | Version: 1.0.0</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
)}
|
|
</AdminLayout>
|
|
)
|
|
}
|