feat(ui): inline the normative text + open-source URL

Adds the actual paragraphs of the law right next to the
evaluation panel on the norm-detail page. A reviewer no longer
has to leave the app to confirm what a score is about; the
canonical source URL stays one click away via 'Im Browser
öffnen' (url_launcher) and one click away as a clipboard copy.

Schema

  models.dart gains a NormParagraph (number + text). Norm carries
  a List<NormParagraph> paragraphs, defaulted to const [] so
  norms harvested by text.akoma_normalize@^0 in live mode slot
  in without breaking the Mock path.

Demo data

  fixtures.dart embeds the public source paragraphs verbatim
  under §5 UrhG (amtliche Werke) for the five pilot norms.

Plumbing

  NormTextCard (lib/widgets/norm_text_card.dart) is the renderer:
  per-paragraph hanging label, selectable body text, source URL
  in mono at the bottom, two action buttons. NormDetailPage
  drops the card between the metric row and the duties card so
  the eye lands on it during a 'why this score?' read-through.

macOS sandbox

  The Release entitlement file gains
  com.apple.security.network.client so url_launcher's NSWorkspace
  call and the HubRepository's gRPC channel can both reach the
  network. The DebugProfile already had server; client matches
  the production posture.

  GeneratedPluginRegistrant.swift was re-generated by
  flutter pub get after url_launcher was added — no hand edits.

flutter analyze: clean. flutter test: 2/2 passing. The macOS
build via build-macos.sh launches and the new card renders the
GewO § 14, KassenSichV, DSGVO Art. 30, BauO Bln § 60 ff and
MiLoG § 17 fixtures with their actual normative text.

Signed-off-by: flemming-it <sf@flemming.it>
This commit is contained in:
flemming-it 2026-06-18 13:43:22 +02:00
parent e08cedcd3f
commit 116310b65b
7 changed files with 337 additions and 33 deletions

View file

@ -29,6 +29,26 @@ class Fixtures {
standDate: DateTime.utc(2025, 12, 1),
sourceUrl: 'https://www.gesetze-im-internet.de/gewo/__14.html',
sourceSha256: 'demo-${'a' * 60}',
paragraphs: const [
NormParagraph(
number: '(1)',
text: 'Wer den selbständigen Betrieb eines stehenden Gewerbes, '
'einer Zweigniederlassung oder einer unselbständigen '
'Zweigstelle anfängt, muss dies der zuständigen Behörde '
'gleichzeitig anzeigen. Das Gleiche gilt, wenn '
'1. der Betrieb verlegt wird, '
'2. der Gegenstand des Gewerbes gewechselt oder '
'auf Waren oder Leistungen ausgedehnt wird, die bei '
'Gewerbebetrieben der angemeldeten Art nicht geschäftsüblich '
'sind, oder '
'3. der Betrieb aufgegeben wird.',
),
NormParagraph(
number: '(2)',
text: 'Die Anzeige hat unverzüglich zu erfolgen. Sie ist nach '
'amtlich vorgeschriebenem Vordruck zu erstatten.',
),
],
),
skmEurPerYear: 2_800_000,
benefitScore: 2.5,
@ -78,6 +98,30 @@ class Fixtures {
sourceUrl:
'https://www.gesetze-im-internet.de/kassensichv/index.html',
sourceSha256: 'demo-${'b' * 60}',
paragraphs: const [
NormParagraph(
number: '§ 1',
text: 'Diese Verordnung gilt für elektronische '
'Aufzeichnungssysteme im Sinne des § 146a Absatz 1 '
'Satz 1 der Abgabenordnung, mit denen aufzeichnungspflichtige '
'Geschäftsvorfälle oder andere Vorgänge erfasst werden.',
),
NormParagraph(
number: '§ 2',
text: 'Das elektronische Aufzeichnungssystem muss jeden '
'einzelnen aufzeichnungspflichtigen Vorgang vollständig '
'aufzeichnen. Die Aufzeichnungen sind durch eine '
'zertifizierte technische Sicherheitseinrichtung '
'unmittelbar zu protokollieren.',
),
NormParagraph(
number: '§ 3',
text: 'Den Steuerpflichtigen treffen Mitteilungspflichten '
'gegenüber dem zuständigen Finanzamt; der Ausfall einer '
'zertifizierten technischen Sicherheitseinrichtung ist '
'unverzüglich anzuzeigen.',
),
],
),
skmEurPerYear: 25_000_000,
benefitScore: 3.0,
@ -136,6 +180,48 @@ class Fixtures {
standDate: DateTime.utc(2025, 10, 1),
sourceUrl: 'https://eur-lex.europa.eu/eli/reg/2016/679',
sourceSha256: 'demo-${'c' * 60}',
paragraphs: const [
NormParagraph(
number: '(1)',
text: 'Jeder Verantwortliche und gegebenenfalls sein Vertreter '
'führen ein Verzeichnis aller Verarbeitungstätigkeiten, '
'die ihrer Zuständigkeit unterliegen. Dieses Verzeichnis '
'enthält sämtliche folgenden Angaben: a) den Namen und '
'die Kontaktdaten des Verantwortlichen … b) die Zwecke '
'der Verarbeitung; c) eine Beschreibung der Kategorien '
'betroffener Personen und der Kategorien personenbezogener '
'Daten; d) die Kategorien von Empfängern …',
),
NormParagraph(
number: '(2)',
text: 'Jeder Auftragsverarbeiter und gegebenenfalls sein '
'Vertreter führen ein Verzeichnis zu allen Kategorien von '
'im Auftrag eines Verantwortlichen durchgeführten '
'Verarbeitungstätigkeiten.',
),
NormParagraph(
number: '(3)',
text: 'Das in den Absätzen 1 und 2 genannte Verzeichnis ist '
'schriftlich zu führen, was auch in einem elektronischen '
'Format erfolgen kann.',
),
NormParagraph(
number: '(4)',
text: 'Der Verantwortliche oder der Auftragsverarbeiter sowie '
'gegebenenfalls deren Vertreter stellen das Verzeichnis '
'der Aufsichtsbehörde auf Anfrage zur Verfügung.',
),
NormParagraph(
number: '(5)',
text: 'Die in den Absätzen 1 und 2 genannten Pflichten gelten '
'nicht für Unternehmen oder Einrichtungen, die weniger als '
'250 Mitarbeiter beschäftigen, es sei denn die von ihnen '
'vorgenommene Verarbeitung birgt ein Risiko für die Rechte '
'und Freiheiten der betroffenen Personen, die Verarbeitung '
'erfolgt nicht nur gelegentlich oder umfasst besondere '
'Datenkategorien gemäß Artikel 9 Absatz 1 …',
),
],
),
skmEurPerYear: 450_000_000,
benefitScore: 3.8,
@ -185,6 +271,31 @@ class Fixtures {
sourceUrl:
'https://gesetze.berlin.de/bsbe/document/jlr-BauOBE2005V25P60',
sourceSha256: 'demo-${'d' * 60}',
paragraphs: const [
NormParagraph(
number: '§ 60 (1)',
text: 'Für die Errichtung, Änderung und Nutzungsänderung '
'baulicher Anlagen sowie anderer Anlagen und '
'Einrichtungen im Sinne des § 1 Absatz 1 Satz 2 ist die '
'Baugenehmigung erforderlich, soweit in den §§ 61 bis 65 '
'sowie 76 und 77 nichts anderes bestimmt ist.',
),
NormParagraph(
number: '§ 60 (2)',
text: 'Bauliche Anlagen und andere Anlagen, an die in dieser '
'Bauordnung oder in Vorschriften aufgrund dieser '
'Bauordnung Anforderungen gestellt werden, dürfen nur so '
'errichtet, geändert und in der Nutzung geändert werden, '
'dass sie diesen Anforderungen entsprechen.',
),
NormParagraph(
number: '§ 63',
text: 'Der Bauantrag ist schriftlich bei der Bauaufsichtsbehörde '
'unter Beifügung der für die Beurteilung des Vorhabens und '
'die Bearbeitung des Bauantrags erforderlichen Bauvorlagen '
'einzureichen.',
),
],
),
skmEurPerYear: 72_000_000,
benefitScore: 3.5,
@ -233,6 +344,30 @@ class Fixtures {
standDate: DateTime.utc(2025, 11, 1),
sourceUrl: 'https://www.gesetze-im-internet.de/milog/__17.html',
sourceSha256: 'demo-${'e' * 60}',
paragraphs: const [
NormParagraph(
number: '(1)',
text: 'Ein Arbeitgeber, der Arbeitnehmerinnen und Arbeitnehmer '
'nach § 8 Absatz 1 des Vierten Buches Sozialgesetzbuch '
'geringfügig beschäftigt oder in den in § 2a des '
'Schwarzarbeitsbekämpfungsgesetzes genannten '
'Wirtschaftsbereichen oder Wirtschaftszweigen Personen '
'beschäftigt, ist verpflichtet, Beginn, Ende und Dauer der '
'täglichen Arbeitszeit dieser Arbeitnehmerinnen und '
'Arbeitnehmer spätestens bis zum Ablauf des siebten auf '
'den Tag der Arbeitsleistung folgenden Kalendertages '
'aufzuzeichnen und diese Aufzeichnungen mindestens zwei '
'Jahre beginnend ab dem für die Aufzeichnung maßgeblichen '
'Zeitpunkt aufzubewahren.',
),
NormParagraph(
number: '(2)',
text: 'Arbeitgeber im Sinne des Absatzes 1 haben die für die '
'Kontrolle der Einhaltung der Verpflichtungen nach § 20 '
'in Verbindung mit § 2 Absatz 1 erforderlichen Unterlagen '
'im Inland in deutscher Sprache bereitzuhalten.',
),
],
),
skmEurPerYear: 270_000_000,
benefitScore: 3.2,