feat(controls): 5 neue Use Cases + Machinery-Fix + Korpus-/Lizenz-Übersicht

- Registry: arbeitsrecht, gesellschaftsrecht, insolvenzrecht, csrd, bafin_it
  + Mapper-Regeln für zuvor ungemappte Quell-Gesetze, Machinery-Guide 2006/42
  -> maschinen. Jetzt 43 Use Cases (Achse 1 / license 1+2 vollständig).
- corpus_overview Service + GET /v1/controls/corpus: Quell-Dokumente mit
  Lizenz-Tier + atom-Count + Use-Case + kuratiertem Lizenz-Katalog.
- list_use_cases trägt atom_classification-Counts (atom_total/atom_relevant).
- Frontend /sdk/coverage: Use-Case-Übersicht + Korpus-Dokumente + Lizenz-Katalog.
- Tests: registry-Mappings (neue Domänen), corpus tier-labels, coverage-helpers.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

admin-compliance/app/sdk/coverage/_helpers.test.ts

@@ -0,0 +1,55 @@
+import { describe, it, expect } from 'vitest'
+import {
+  licenseTierBadgeClass,
+  commercialBadgeClass,
+  groupUseCases,
+  type UseCaseRow,
+} from './_helpers'
+
+const uc = (over: Partial<UseCaseRow>): UseCaseRow => ({
+  key: 'x',
+  label: 'X',
+  group: 'security',
+  regulations: [],
+  verification_methods: [],
+  mapped_controls: 0,
+  atom_total: 0,
+  atom_relevant: 0,
+  ...over,
+})
+
+describe('coverage helpers', () => {
+  it('license tier badge classes', () => {
+    expect(licenseTierBadgeClass(1)).toContain('green')
+    expect(licenseTierBadgeClass(2)).toContain('blue')
+    expect(licenseTierBadgeClass(3)).toContain('amber')
+    expect(licenseTierBadgeClass(null)).toContain('gray')
+  })
+
+  it('commercial-use badge classes', () => {
+    expect(commercialBadgeClass('allowed')).toContain('green')
+    expect(commercialBadgeClass('restricted')).toContain('amber')
+    expect(commercialBadgeClass('prohibited')).toContain('red')
+    expect(commercialBadgeClass(null)).toContain('gray')
+  })
+
+  it('groups use-cases in stable order and sorts by relevant desc', () => {
+    const groups = groupUseCases([
+      uc({ key: 'a', group: 'security', atom_relevant: 5 }),
+      uc({ key: 'b', group: 'security', atom_relevant: 15 }),
+      uc({ key: 'c', group: 'document', atom_relevant: 1 }),
+    ])
+    expect(groups[0].group).toBe('document')
+    expect(groups[1].group).toBe('security')
+    expect(groups[1].rows[0].key).toBe('b')
+    expect(groups[1].rows[1].key).toBe('a')
+  })
+
+  it('appends unknown groups after the known order', () => {
+    const groups = groupUseCases([
+      uc({ key: 'z', group: 'mystery', atom_relevant: 9 }),
+      uc({ key: 'd', group: 'document', atom_relevant: 2 }),
+    ])
+    expect(groups.map((g) => g.group)).toEqual(['document', 'mystery'])
+  })
+})

admin-compliance/app/sdk/coverage/_helpers.ts

@@ -0,0 +1,105 @@
+// Pure helpers for the Coverage page (#74). Kept separate so they are unit-testable
+// without rendering the server component.
+
+export interface UseCaseRow {
+  key: string
+  label: string
+  group: string
+  regulations: string[]
+  verification_methods: string[]
+  mapped_controls: number
+  atom_total: number
+  atom_relevant: number
+}
+
+export interface CorpusDoc {
+  source_regulation: string
+  license_rule: number | null
+  license_tier: string
+  atom_count: number
+  use_case: string | null
+}
+
+export interface LicenseSummaryRow {
+  license_rule: number | null
+  label: string
+  atom_count: number
+}
+
+export interface LicenseCatalogEntry {
+  source_id: string
+  title: string
+  publisher: string | null
+  url: string | null
+  version: string | null
+  license_id: string | null
+  license_name: string | null
+  commercial_use: string | null
+  ship_in_product: boolean | null
+  terms_url: string | null
+}
+
+export interface CorpusOverview {
+  license_summary: LicenseSummaryRow[]
+  documents: CorpusDoc[]
+  license_catalog: LicenseCatalogEntry[]
+  totals: { documents: number; catalog_sources: number }
+}
+
+export const USE_CASE_GROUP_LABELS: Record<string, string> = {
+  document: 'Dokument-Compliance',
+  security: 'Security',
+  cross_cutting: 'Querschnitt',
+  product: 'Produkt / Sektor',
+}
+
+export function licenseTierBadgeClass(rule: number | null): string {
+  switch (rule) {
+    case 1:
+      return 'bg-green-100 text-green-800'
+    case 2:
+      return 'bg-blue-100 text-blue-800'
+    case 3:
+      return 'bg-amber-100 text-amber-800'
+    default:
+      return 'bg-gray-100 text-gray-700'
+  }
+}
+
+export function commercialBadgeClass(commercial: string | null): string {
+  switch ((commercial || '').toLowerCase()) {
+    case 'allowed':
+      return 'bg-green-100 text-green-800'
+    case 'restricted':
+      return 'bg-amber-100 text-amber-800'
+    case 'prohibited':
+      return 'bg-red-100 text-red-800'
+    default:
+      return 'bg-gray-100 text-gray-700'
+  }
+}
+
+export interface UseCaseGroup {
+  group: string
+  label: string
+  rows: UseCaseRow[]
+}
+
+// Group use-cases by their registry group (stable order), each group's rows
+// sorted by how many relevant obligations it carries (desc).
+export function groupUseCases(rows: UseCaseRow[]): UseCaseGroup[] {
+  const order = ['document', 'security', 'cross_cutting', 'product']
+  const by: Record<string, UseCaseRow[]> = {}
+  for (const r of rows) {
+    ;(by[r.group] ||= []).push(r)
+  }
+  const groups = order.filter((g) => by[g]?.length)
+  for (const g of Object.keys(by)) {
+    if (!order.includes(g)) groups.push(g)
+  }
+  return groups.map((g) => ({
+    group: g,
+    label: USE_CASE_GROUP_LABELS[g] || g,
+    rows: [...by[g]].sort((a, b) => b.atom_relevant - a.atom_relevant),
+  }))
+}

admin-compliance/app/sdk/coverage/page.tsx

@@ -0,0 +1,228 @@
+import {
+  type UseCaseRow,
+  type CorpusOverview,
+  licenseTierBadgeClass,
+  commercialBadgeClass,
+  groupUseCases,
+} from './_helpers'
+
+const BACKEND_URL =
+  process.env.COMPLIANCE_BACKEND_URL || 'http://backend-compliance:8002'
+
+export const dynamic = 'force-dynamic'
+
+async function getData(): Promise<{
+  useCases: UseCaseRow[]
+  corpus: CorpusOverview | null
+}> {
+  try {
+    const [ucRes, corpusRes] = await Promise.all([
+      fetch(`${BACKEND_URL}/api/compliance/v1/controls/use-cases`, {
+        cache: 'no-store',
+      }),
+      fetch(`${BACKEND_URL}/api/compliance/v1/controls/corpus`, {
+        cache: 'no-store',
+      }),
+    ])
+    return {
+      useCases: ucRes.ok ? await ucRes.json() : [],
+      corpus: corpusRes.ok ? await corpusRes.json() : null,
+    }
+  } catch {
+    return { useCases: [], corpus: null }
+  }
+}
+
+function Stat({ label, value }: { label: string; value: string | number }) {
+  return (
+    <div className="rounded-lg border border-gray-200 bg-white px-4 py-3">
+      <div className="text-2xl font-semibold text-gray-900">{value}</div>
+      <div className="text-xs text-gray-500">{label}</div>
+    </div>
+  )
+}
+
+export default async function CoveragePage() {
+  const { useCases, corpus } = await getData()
+  const groups = groupUseCases(useCases)
+  const totalRelevant = useCases.reduce((s, u) => s + u.atom_relevant, 0)
+  const totalAtoms = useCases.reduce((s, u) => s + u.atom_total, 0)
+
+  return (
+    <div className="mx-auto max-w-7xl space-y-10 p-6">
+      <header className="space-y-1">
+        <h1 className="text-2xl font-bold text-gray-900">
+          Compliance-Abdeckung
+        </h1>
+        <p className="text-sm text-gray-600">
+          Alle ableitbaren Use Cases und alle Quell-Dokumente im Korpus inkl.
+          Lizenz — damit kein Thema und keine Quelle vergessen wird.
+        </p>
+      </header>
+
+      <section className="grid grid-cols-2 gap-3 sm:grid-cols-4">
+        <Stat label="Use Cases" value={useCases.length} />
+        <Stat label="Pflichten (relevant)" value={totalRelevant.toLocaleString('de-DE')} />
+        <Stat label="klassifizierte Atome" value={totalAtoms.toLocaleString('de-DE')} />
+        <Stat label="Quell-Dokumente" value={corpus?.totals.documents ?? 0} />
+      </section>
+
+      {corpus?.license_summary?.length ? (
+        <section className="space-y-2">
+          <h2 className="text-lg font-semibold text-gray-900">Lizenz-Verteilung</h2>
+          <div className="flex flex-wrap gap-3">
+            {corpus.license_summary.map((l) => (
+              <div
+                key={String(l.license_rule)}
+                className="flex items-center gap-2 rounded-lg border border-gray-200 bg-white px-4 py-2"
+              >
+                <span
+                  className={`rounded px-2 py-0.5 text-xs font-medium ${licenseTierBadgeClass(l.license_rule)}`}
+                >
+                  Tier {l.license_rule ?? '?'}
+                </span>
+                <span className="text-sm text-gray-700">{l.label}</span>
+                <span className="text-sm font-semibold text-gray-900">
+                  {l.atom_count.toLocaleString('de-DE')}
+                </span>
+              </div>
+            ))}
+          </div>
+        </section>
+      ) : null}
+
+      <section className="space-y-4">
+        <h2 className="text-lg font-semibold text-gray-900">Use Cases</h2>
+        {groups.map((g) => (
+          <div key={g.group} className="space-y-1">
+            <h3 className="text-sm font-semibold uppercase tracking-wide text-gray-500">
+              {g.label} ({g.rows.length})
+            </h3>
+            <div className="overflow-hidden rounded-lg border border-gray-200">
+              <table className="min-w-full divide-y divide-gray-200 text-sm">
+                <thead className="bg-gray-50 text-left text-xs uppercase text-gray-500">
+                  <tr>
+                    <th className="px-4 py-2">Use Case</th>
+                    <th className="px-4 py-2">Key</th>
+                    <th className="px-4 py-2 text-right">relevant</th>
+                    <th className="px-4 py-2 text-right">klassifiziert</th>
+                    <th className="px-4 py-2">Quellen</th>
+                  </tr>
+                </thead>
+                <tbody className="divide-y divide-gray-100 bg-white">
+                  {g.rows.map((u) => (
+                    <tr key={u.key} className={u.atom_relevant === 0 ? 'text-gray-400' : ''}>
+                      <td className="px-4 py-2 font-medium text-gray-900">{u.label}</td>
+                      <td className="px-4 py-2 font-mono text-xs text-gray-500">{u.key}</td>
+                      <td className="px-4 py-2 text-right font-semibold">
+                        {u.atom_relevant.toLocaleString('de-DE')}
+                      </td>
+                      <td className="px-4 py-2 text-right text-gray-500">
+                        {u.atom_total.toLocaleString('de-DE')}
+                      </td>
+                      <td className="px-4 py-2 text-xs text-gray-500">
+                        {u.regulations.slice(0, 4).join(', ')}
+                      </td>
+                    </tr>
+                  ))}
+                </tbody>
+              </table>
+            </div>
+          </div>
+        ))}
+      </section>
+
+      <section className="space-y-2">
+        <h2 className="text-lg font-semibold text-gray-900">
+          Korpus-Dokumente ({corpus?.documents.length ?? 0})
+        </h2>
+        <p className="text-xs text-gray-500">
+          Quell-Regulierung × Lizenz-Tier × Anzahl Pflichten × gemappter Use Case.
+        </p>
+        <div className="max-h-[28rem] overflow-auto rounded-lg border border-gray-200">
+          <table className="min-w-full divide-y divide-gray-200 text-sm">
+            <thead className="sticky top-0 bg-gray-50 text-left text-xs uppercase text-gray-500">
+              <tr>
+                <th className="px-4 py-2">Dokument / Quelle</th>
+                <th className="px-4 py-2">Lizenz</th>
+                <th className="px-4 py-2 text-right">Pflichten</th>
+                <th className="px-4 py-2">Use Case</th>
+              </tr>
+            </thead>
+            <tbody className="divide-y divide-gray-100 bg-white">
+              {(corpus?.documents ?? []).map((d) => (
+                <tr key={d.source_regulation}>
+                  <td className="px-4 py-2 text-gray-900">{d.source_regulation}</td>
+                  <td className="px-4 py-2">
+                    <span
+                      className={`rounded px-2 py-0.5 text-xs font-medium ${licenseTierBadgeClass(d.license_rule)}`}
+                      title={d.license_tier}
+                    >
+                      Tier {d.license_rule ?? '?'}
+                    </span>
+                  </td>
+                  <td className="px-4 py-2 text-right">{d.atom_count.toLocaleString('de-DE')}</td>
+                  <td className="px-4 py-2 font-mono text-xs text-gray-600">
+                    {d.use_case ?? <span className="text-amber-600">— ungemappt</span>}
+                  </td>
+                </tr>
+              ))}
+            </tbody>
+          </table>
+        </div>
+      </section>
+
+      {corpus?.license_catalog?.length ? (
+        <section className="space-y-2">
+          <h2 className="text-lg font-semibold text-gray-900">
+            Lizenz-Katalog ({corpus.license_catalog.length} kuratierte Quellen)
+          </h2>
+          <p className="text-xs text-gray-500">
+            Detaillierte Nutzungsrechte je kuratierter Quelle (kommerzielle
+            Nutzung, Auslieferung im Produkt).
+          </p>
+          <div className="overflow-auto rounded-lg border border-gray-200">
+            <table className="min-w-full divide-y divide-gray-200 text-sm">
+              <thead className="bg-gray-50 text-left text-xs uppercase text-gray-500">
+                <tr>
+                  <th className="px-4 py-2">Quelle</th>
+                  <th className="px-4 py-2">Herausgeber</th>
+                  <th className="px-4 py-2">Lizenz</th>
+                  <th className="px-4 py-2">kommerziell</th>
+                  <th className="px-4 py-2">im Produkt</th>
+                </tr>
+              </thead>
+              <tbody className="divide-y divide-gray-100 bg-white">
+                {corpus.license_catalog.map((c) => (
+                  <tr key={c.source_id}>
+                    <td className="px-4 py-2 text-gray-900">
+                      {c.terms_url ? (
+                        <a href={c.terms_url} target="_blank" rel="noreferrer" className="hover:underline">
+                          {c.title}
+                        </a>
+                      ) : (
+                        c.title
+                      )}
+                    </td>
+                    <td className="px-4 py-2 text-gray-600">{c.publisher ?? '—'}</td>
+                    <td className="px-4 py-2 text-gray-600">{c.license_name ?? c.license_id ?? '—'}</td>
+                    <td className="px-4 py-2">
+                      <span
+                        className={`rounded px-2 py-0.5 text-xs font-medium ${commercialBadgeClass(c.commercial_use)}`}
+                      >
+                        {c.commercial_use ?? 'unbekannt'}
+                      </span>
+                    </td>
+                    <td className="px-4 py-2 text-gray-600">
+                      {c.ship_in_product ? 'ja' : 'nein'}
+                    </td>
+                  </tr>
+                ))}
+              </tbody>
+            </table>
+          </div>
+        </section>
+      ) : null}
+    </div>
+  )
+}