SPARQL-Dokumentation

Stand: 2026-07-23 · Quelle im Code: web/app.js, web/person-search.html. Alle Browser-Requests gehen direkt an öffentliche Wikidata-APIs (kein eigenes SPARQL-Backend).

1. Architektur & Abruf

Hilfsfunktionen (Client)

• qidOf(uri) – letzter Pfadteil der Entity-URI → Q…
• dateOf – XSD-Datum → YYYY-MM-DD (erste 10 Zeichen)
• isActive(end) – aktiv, wenn kein Ende oder end >= heute (UTC-Datum)

2. Genutzte Wikidata-Properties & Klassen

3. Query Q1 – Länder

Wird beim App-Start geladen. Nur Staaten mit gesetzter Legislative (P194).

SELECT DISTINCT ?country ?countryLabel WHERE {
  ?country wdt:P31 wd:Q3624078 .
  ?country wdt:P194 ?legislature .
  SERVICE wikibase:label { bd:serviceParam wikibase:language "de,en". }
}
ORDER BY ?countryLabel

Ergebnis-Mapping: { qid, label } aus ?country / ?countryLabel.

In Wikidata Query Service öffnen

4. Query Q2 – Parlamente eines Landes

Parameter: countryQid (z. B. Q183 für Deutschland), per BIND(wd:${countryQid} AS ?country) eingesetzt.

Vier UNION-Zweige:

1. Direkt P194 am Land (z. B. Bundestag, Bundesrat)
2. Untergeordnete Parlamente: P150 (enthält Verwaltungseinheit) vom Land zur Gliederungseinheit (Bundesland/Kanton/US-Bundesstaat …), dort wieder P194 — findet Landtage, State Legislatures, Kantonsparlamente etc., ohne Land-für-Land Sonderfälle
3. Teile (P527) der Legislative, gefiltert auf Parlaments-/Kammer-Typen
4. Items mit Jurisdiktion P1001 = Land und Parlaments-Typ

SELECT DISTINCT ?parliament ?parliamentLabel WHERE {
  BIND(wd:Q183 AS ?country)   # Beispiel: Deutschland
  {
    ?country wdt:P194 ?parliament .
  } UNION {
    ?country wdt:P150 ?subdivision .
    ?subdivision wdt:P194 ?parliament .
  } UNION {
    ?country wdt:P194 ?body .
    ?body wdt:P527 ?parliament .
    ?parliament wdt:P31/wdt:P279* ?t .
    VALUES ?t { wd:Q35749 wd:Q10553309 wd:Q110315425 wd:Q2145275 wd:Q257000 }
  } UNION {
    ?parliament wdt:P1001 ?country .
    ?parliament wdt:P31/wdt:P279* ?t .
    VALUES ?t { wd:Q35749 wd:Q10553309 wd:Q110315425 wd:Q2145275 }
  }
  SERVICE wikibase:label { bd:serviceParam wikibase:language "de,en". }
}
ORDER BY ?parliamentLabel

Nachbearbeitung: Deduplizierung nach QID im Client.

5. Query Q3 – Abgeordnete eines Parlaments

Parameter: parliamentQid (z. B. Q154797 Deutscher Bundestag). Findet Ämter, die Teil des Parlaments (oder einer Kammer) sind und Unterklasse von „Mitglied eines Parlaments“ (Q486839).

SELECT DISTINCT ?person ?personLabel ?position ?positionLabel
       ?start ?end ?partyLabel ?districtLabel WHERE {
  BIND(wd:Q154797 AS ?parliament)   # Beispiel: Bundestag
  {
    ?position wdt:P361 ?parliament .
    ?position wdt:P279* wd:Q486839 .
  } UNION {
    ?parliament wdt:P527 ?chamber .
    ?position wdt:P361 ?chamber .
    ?position wdt:P279* wd:Q486839 .
  }
  ?person p:P39 ?stmt .
  ?stmt ps:P39 ?position .
  OPTIONAL { ?stmt pq:P580 ?start }
  OPTIONAL { ?stmt pq:P582 ?end }
  OPTIONAL { ?stmt pq:P4100 ?group }
  OPTIONAL { ?person wdt:P102 ?partyEntity }
  BIND(COALESCE(?group, ?partyEntity) AS ?party)
  OPTIONAL { ?stmt pq:P768 ?district }
  SERVICE wikibase:label { bd:serviceParam wikibase:language "de,en". }
}
ORDER BY ?personLabel DESC(?start)

Nachbearbeitung:

• Deduplizierung über Schlüssel qid|Amt|start|end
• active = isActive(end) (kein Ende oder Ende ≥ heute)

6. Query Q4 – Label-Auflösung

Für die Detailseite: QIDs aus EntityData (Ämter, Fraktionen, Wahlkreise, Parteien, Berufe, Geburtsort) in Chunks à max. 50 auflösen.

SELECT ?item ?itemLabel WHERE {
  VALUES ?item { wd:Q1939555 wd:Q1023134 /* … */ }
  SERVICE wikibase:label { bd:serviceParam wikibase:language "de,en". }
}

7. Detailseite – EntityData (kein SPARQL für Kerndaten)

GET https://www.wikidata.org/wiki/Special:EntityData/{QID}.json

Darstellung ist lokal in PoliSPARQL — kein Pflicht-Deep-Link nach wikidata.org.

8. Namenssuche (person-search.html)

Separater Einstieg. Sucht Personen per MediaWiki EntitySearch, behält nur Menschen (Q5) mit mindestens einem P39-Amt. Limit 100.

SELECT ?person ?personLabel ?positionLabel ?start ?end
       ?partyLabel ?districtLabel WHERE {
  SERVICE wikibase:mwapi {
    bd:serviceParam wikibase:api "EntitySearch" .
    bd:serviceParam wikibase:endpoint "www.wikidata.org" .
    bd:serviceParam mwapi:search "Olaf Scholz" .   # User-Input, escaped
    bd:serviceParam mwapi:language "de" .
    ?person wikibase:apiOutputItem mwapi:item .
  }
  ?person wdt:P31 wd:Q5 .
  ?person p:P39 ?stmt .
  ?stmt ps:P39 ?position .
  OPTIONAL { ?stmt pq:P580 ?start }
  OPTIONAL { ?stmt pq:P582 ?end }
  OPTIONAL { ?stmt pq:P768 ?district }
  OPTIONAL { ?person wdt:P102 ?party }
  SERVICE wikibase:label { bd:serviceParam wikibase:language "de,en". }
}
ORDER BY DESC(?start)
LIMIT 100

Sonderzeichen im Suchbegriff: \ und " werden vor dem Einbetten escaped.

9. Client-seitige Filter (kein SPARQL)

Nach Q3 filtert die UI lokal:

• Aktiv – active === true
• Ausgelaufen – active === false
• Alle – kein Statusfilter
• Namenssuche – Substring-Match (case-insensitive) auf dem Personennamen

Länderliste: ebenfalls lokale Substring-Filterung auf dem Label.

10. Frontend-Features (2026-07-23)

• URL-Routing: #/land/QID/parlament/QID/person/QID — bookmarkbar, teilbar, Browser-Zurück/Vor funktioniert.
• Personen- vs. Mandatszeilen-Zählung: zusätzlich COUNT(DISTINCT ?person) aktiv/gesamt, getrennt von den Mandatszeilen (eine Person kann mehrere Perioden haben).
• Query-Cache: In-Memory, 15 Min. TTL, Anzeige „Live“/„Cache (vor …)“ + Button zum Leeren & Neuladen.
• Portraits: P18 zusätzlich in der Mitglieder-Query, kleines Icon wenn vorhanden.
• Schnellzugriff: Bundestag & Assemblée nationale als feste Links auf der Länder-Seite.
• „Zuletzt gesucht“: GET/POST /api/recent (server.mjs), geteilt über alle Besucher*innen — bewusst nur Land/Parlament, keine Namenssuche.
• Ladeanzeige: deutlicher Banner mit Spinner während Parlamente/Abgeordnete laden.

Details & verworfene Alternativen: docs/SPARQL_QUERIES.md.

11. Fixes (2026-07-23, Abend)

• Landtage: zeigten oft 0 Abgeordnete (fehlende P279-Klassifizierung in Wikidata). Automatischer Fallback auf lockeren Filter (nur P361), wenn der strikte Filter nichts findet.
• Parteiliste: jetzt höhenbegrenzt/scrollbar und als Klick-Filter für die Mitgliederliste nutzbar.
• Caching: HTML wird nie mehr gecacht (no-store) — verhindert veraltete Personen-Detail-Links.
• Label-Fallback: fällt bei fehlendem de/en-Label auf die QID zurück statt auf eine zufällige andere Sprache.
• Wikidata-Link: QID auf der Personendetailseite verlinkt jetzt direkt zu Wikidata.

12. Bekannte Grenzen

• Qualität hängt von Wikidata-Modellierung ab (fehlende P361/P279 → leere Abgeordnetenliste).
• Große Parlamente: Q3 kann mehrere Sekunden dauern (Timeouts möglich).
• Fehlende Labels (Vandalismus/Lücken) → Anzeige fällt auf die QID zurück.
• „Aktiv“ ohne P582 kann historisch ungenaue Mandate als laufend zählen.

Canonical repo path: docs/SPARQL_QUERIES.md (gleiche Inhalte).