feat(advisor): Evidence Workspace — structured panes, markdown, sources as knowledge units

Rebuilds the Compliance Advisor floating widget from a plain chat into an Evidence Workspace: pinned last question, markdown-rendered answer (clean prose), and separate panes for Sources (hierarchical Knowledge Units), Figures (C8, conditional) and Footnotes (C-FN), plus a stats bar (Quellen/Regelwerke/Diagramme/Fußnoten). Scrollable turn history; stays a floating icon on every SDK page. Architecture (user direction): the frontend renders ONLY structured evidence and NEVER parses the answer text. The proxy now returns a JSON AdvisorEvidenceMeta line followed by the streamed markdown answer; advisor-rag exposes structured results; an adapter maps RAG/compiler output to the frontend envelope. Figures/footnotes wire in once the RAG-ingestion contract lands (requested on the board) — figures pane is conditional. - lib/sdk/advisor/{evidence,evidence-adapter}.ts (+ adapter test, 7 cases) - components/sdk/advisor/* panes + in-house safe Markdown (no new dep, no dangerouslySetInnerHTML) + test - useAdvisorStream (meta-line parse + streamed answer) + useAdvisorEmail (escaped) - proxy: evidence-meta-v1 envelope + clean-prose prompt (no inline citations) - tsc clean, 11 vitest pass, check-loc 0. ESLint not installed in this node_modules -> CI lints on push. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-07-01 07:46:37 +02:00
parent f0120b237e
commit 49171e841f
22 changed files with 1379 additions and 421 deletions
@@ -0,0 +1,71 @@
+'use client'
+
+import { useCallback, useState } from 'react'
+import type { AdvisorTurn } from './useAdvisorStream'
+
+function esc(s: string): string {
+  return s
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+}
+
+function sourcesHtml(turn: AdvisorTurn): string {
+  if (turn.meta.sources.length === 0) return ''
+  const items = turn.meta.sources
+    .map((s) => {
+      const hier = [s.section, s.subsection, s.paragraph, s.footnoteRef].filter(Boolean).join(' › ')
+      return `<li>${esc(s.regulation.short || '')}${hier ? ` — ${esc(hier)}` : ''}</li>`
+    })
+    .join('')
+  return `<p style="color:#64748b;font-size:12px;margin:4px 0 0;">Quellen:</p><ul style="color:#64748b;font-size:12px;margin:2px 0;">${items}</ul>`
+}
+
+/** Sends the consultation transcript (question + answer + structured sources) as an email to the DSB. */
+export function useAdvisorEmail(turns: AdvisorTurn[], country: string, currentStep: string) {
+  const [sending, setSending] = useState(false)
+  const [sent, setSent] = useState(false)
+
+  const send = useCallback(async () => {
+    if (turns.length === 0 || sending) return
+    setSending(true)
+    try {
+      const qaHtml = turns
+        .map(
+          (t) =>
+            `<div style="margin-bottom:16px;"><p style="font-weight:600;color:#1e293b;">Frage: ${esc(
+              t.question,
+            )}</p><p style="color:#475569;white-space:pre-wrap;">${esc(t.answer)}</p>${sourcesHtml(t)}</div>`,
+        )
+        .join('')
+
+      const bodyHtml = `
+        <h2 style="color:#1e293b;">Compliance Advisor — Beratungsprotokoll</h2>
+        <p style="color:#64748b;font-size:13px;">Datum: ${esc(new Date().toLocaleString('de-DE'))} | Land: ${esc(country)} | Kontext: ${esc(currentStep)}</p>
+        <hr style="border-color:#e2e8f0;margin:16px 0;">
+        ${qaHtml}
+        <hr style="border-color:#e2e8f0;margin:16px 0;">
+        <p style="color:#94a3b8;font-size:11px;">Automatisch erstellt vom BreakPilot Compliance Advisor</p>`
+
+      await fetch('/api/sdk/v1/agent/notify', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          recipient: 'dsb@breakpilot.local',
+          subject: `Compliance Advisor — ${turns.length} Fragen (${currentStep})`,
+          body_html: bodyHtml,
+          role: 'Datenschutzbeauftragter',
+        }),
+      })
+      setSent(true)
+      setTimeout(() => setSent(false), 3000)
+    } catch (e) {
+      console.error('Email send failed:', e)
+    } finally {
+      setSending(false)
+    }
+  }, [turns, sending, country, currentStep])
+
+  return { send, sending, sent }
+}