Poll-Takt auf 15 Minuten und Revisionshistorie fuer Items

Der 2-Stunden-Takt verlor ganze Artikel. Ein RSS-Feed ist ein Fenster,
kein Archiv: ist das Fenster kuerzer als der Poll-Abstand, fallen
Eintraege zwischen zwei Abrufen heraus und sind nicht nachholbar.
Gemessen am 2026-09-04 haelt zeit.de 0,6 h vor, spiegel und welt rund
5 h; von der Zeit sah man etwa jeden dritten Artikel. Der bedingte GET
macht haeufiges Pollen billig, ein unveraenderter Abruf ist ein 304
ohne Body.

Zweitens schrieb der Upsert Aenderungen nicht fort. Redaktionen aendern
Ueberschriften nach der Veroeffentlichung; bei gleicher GUID lief das in
ein `on conflict do nothing` und blieb unsichtbar. raw_items haelt jetzt
den aktuellen Stand und zaehlt Revisionen, raw_item_versionen haelt jede
Fassung einschliesslich der ersten. Erkannt wird das ueber einen
Inhalts-Hash aus Titel, Teaser und URL.

Die Migration zieht Bestandsdaten nach. Die SQL-Hashformel ist
zeichengleich zu poller.inhalt_hash(), geprueft an 814 migrierten Items:
null Scheinrevisionen beim ersten Lauf danach.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011ZAdZb3EifGb9nvQ5Zp2TE
This commit is contained in:
2026-09-05 18:17:07 +02:00
co-authored by Claude Opus 5
parent 8a1ab8a146
commit 4983662514
4 changed files with 264 additions and 44 deletions
+99 -35
View File
@@ -1,7 +1,7 @@
#!/usr/bin/env python3
"""Ingest-Poller fuer den deutschen Ereignisdatensatz.
Liest die Quellen aus sources.toml, holt alle 2 Stunden die Feeds und legt
Liest die Quellen aus sources.toml, holt alle 15 Minuten die Feeds und legt
jedes neue Item roh ab. Bewusst ohne Kodierung: was hier landet, soll sich
beliebig oft neu kodieren lassen.
@@ -10,7 +10,7 @@ Zwei Senken:
--sink jsonl:/pfad/dir Schatten-Ingest als gzip-JSONL pro Slot
Aufrufe:
poller.py --sink "$DATABASE_URL" # Dauerbetrieb, 2-Stunden-Takt
poller.py --sink "$DATABASE_URL" # Dauerbetrieb, 15-Minuten-Takt
poller.py --sink "$DATABASE_URL" --once # ein Durchlauf
poller.py --check-robots # Lizenzstatus nachpruefen
"""
@@ -40,7 +40,7 @@ USER_AGENT = os.environ.get(
"INGEST_USER_AGENT",
"wurzelwerk-ingest/0.1 (+https://stinkwurzpresse.de/wurzelwerk; kontakt@stinkwurzpresse.de)",
)
TAKT = 2 * 60 * 60 # Slotlaenge in Sekunden
TAKT = 15 * 60 # Slotlaenge in Sekunden
VERSATZ = 30 # Sekunden nach der Slotgrenze, nicht exakt darauf
NS = {
"a": "http://www.w3.org/2005/Atom",
@@ -66,7 +66,7 @@ def _jetzt():
def slot_von(ts):
"""Auf TAKT-Sekunden seit Epoch abrunden (bei 2 h also volle gerade Stunden)."""
"""Auf TAKT-Sekunden seit Epoch abrunden (bei 15 min auf :00/:15/:30/:45)."""
sekunden = int(ts.timestamp())
return dt.datetime.fromtimestamp(
(sekunden // TAKT) * TAKT, tz=dt.timezone.utc)
@@ -107,6 +107,17 @@ def datum(s):
return d.astimezone(dt.timezone.utc)
def inhalt_hash(titel, teaser, url):
"""Fingerabdruck des Item-Inhalts.
Identisch zur SQL-Formel in der Migration, damit Bestandsdaten und neue
Zeilen denselben Hash tragen. md5 reicht - es geht um Gleichheit, nicht
um Faelschungssicherheit.
"""
roh = "\x1f".join((titel or "", teaser or "", url or ""))
return hashlib.md5(roh.encode("utf-8"), usedforsecurity=False).hexdigest()
def _text(el):
return (el.text or "").strip() if el is not None and el.text else None
@@ -165,7 +176,7 @@ def parse_feed(roh):
if not guid:
guid = hashlib.sha256(titel.encode()).hexdigest()[:32]
aus.append({
eintrag = {
"titel": klartext(titel),
"url": link,
"guid": guid,
@@ -174,7 +185,10 @@ def parse_feed(roh):
"autor": _erst(it, ["author", "dc:creator", "a:author/a:name"]),
"pubdate": datum(_erst(it, ["pubDate", "dc:date",
"a:published", "a:updated"])),
})
}
eintrag["inhalt_hash"] = inhalt_hash(
eintrag["titel"], eintrag["teaser"], eintrag["url"])
aus.append(eintrag)
return aus
@@ -195,7 +209,8 @@ class JsonlSenke:
self.ziel.mkdir(parents=True, exist_ok=True)
self.db = sqlite3.connect(self.ziel / "gesehen.sqlite")
self.db.execute("create table if not exists gesehen ("
"quelle text, guid text, primary key (quelle, guid))")
"quelle text, guid text, hash text, "
"primary key (quelle, guid))")
self.db.commit()
def sync_quellen(self, quellen):
@@ -206,16 +221,27 @@ class JsonlSenke:
return None, None
def schreibe(self, quelle, items, slot):
frisch = []
frisch, neu, geaendert = [], 0, 0
for it in items:
cur = self.db.execute(
"insert or ignore into gesehen (quelle, guid) values (?, ?)",
(quelle["id"], it["guid"]))
if cur.rowcount:
frisch.append(it)
row = self.db.execute(
"select hash from gesehen where quelle = ? and guid = ?",
(quelle["id"], it["guid"])).fetchone()
if row is None:
self.db.execute("insert into gesehen (quelle, guid, hash) "
"values (?, ?, ?)",
(quelle["id"], it["guid"], it["inhalt_hash"]))
neu += 1
elif row[0] != it["inhalt_hash"]:
self.db.execute("update gesehen set hash = ? "
"where quelle = ? and guid = ?",
(it["inhalt_hash"], quelle["id"], it["guid"]))
geaendert += 1
else:
continue
frisch.append(it)
self.db.commit()
if not frisch:
return 0
return 0, 0
tag = self.ziel / slot.strftime("%Y%m%d")
tag.mkdir(exist_ok=True)
pfad = tag / (slot.strftime("%Y%m%d%H%M%S") + ".jsonl.gz")
@@ -226,7 +252,7 @@ class JsonlSenke:
{"quelle": quelle["id"], "slot": slot.isoformat(),
"abgerufen_am": _jetzt().isoformat(), **it},
ensure_ascii=False, default=str) + "\n")
return len(frisch)
return neu, geaendert
def notiere(self, *a, **kw):
pass
@@ -270,24 +296,57 @@ class PostgresSenke:
return (r[0], r[1]) if r else (None, None)
def schreibe(self, quelle, items, slot):
neu = 0
"""Neue Items einfuegen, geaenderte fortschreiben.
Redaktionen aendern Ueberschriften nach der Veroeffentlichung. Frueher
lief das in ein `do nothing` und war unsichtbar. Jetzt schreibt der
Upsert den aktuellen Stand fort und legt jede Fassung zusaetzlich in
raw_item_versionen ab - auch die erste, damit die Historie vollstaendig
ist. Bleibt der Hash gleich, liefert das WHERE keine Zeile zurueck und
es passiert nichts.
"""
neu = geaendert = 0
with self.conn.cursor() as cur:
for it in items:
cur.execute("""
insert into raw_items
(quelle, item_key, url, titel, titel_norm, teaser,
autor, pubdate, slot, roh)
values (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s)
on conflict (quelle, item_key) do nothing
returning id
autor, pubdate, slot, inhalt_hash, roh)
values (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s)
on conflict (quelle, item_key) do update set
url = excluded.url,
titel = excluded.titel,
titel_norm = excluded.titel_norm,
teaser = excluded.teaser,
autor = excluded.autor,
pubdate = excluded.pubdate,
inhalt_hash = excluded.inhalt_hash,
roh = excluded.roh,
revisionen = raw_items.revisionen + 1,
zuletzt_geaendert = now()
where raw_items.inhalt_hash is distinct from excluded.inhalt_hash
returning id, (xmax = 0) as ist_neu
""", (quelle["id"], it["guid"], it["url"], it["titel"],
norm_titel(it["titel"]), it["teaser"], it["autor"],
it["pubdate"], slot,
it["pubdate"], slot, it["inhalt_hash"],
json.dumps(it, ensure_ascii=False, default=str)))
if cur.fetchone():
zeile = cur.fetchone()
if not zeile:
continue # unveraendert
rid, ist_neu = zeile
if ist_neu:
neu += 1
else:
geaendert += 1
cur.execute("""
insert into raw_item_versionen
(raw_item_id, slot, titel, teaser, url, inhalt_hash)
values (%s, %s, %s, %s, %s, %s)
on conflict (raw_item_id, inhalt_hash) do nothing
""", (rid, slot, it["titel"], it["teaser"], it["url"],
it["inhalt_hash"]))
self.conn.commit()
return neu
return neu, geaendert
def merke_zustand(self, qid, etag, last_modified, geaendert):
with self.conn.cursor() as cur:
@@ -300,14 +359,16 @@ class PostgresSenke:
""", (etag, last_modified, geaendert, qid))
self.conn.commit()
def notiere(self, quelle, slot, dauer_ms, status, gesehen, neu, fehler):
def notiere(self, quelle, slot, dauer_ms, status, gesehen, neu,
geaendert, fehler):
with self.conn.cursor() as cur:
cur.execute("""
insert into poll_laeufe
(quelle, slot, dauer_ms, http_status,
items_gesehen, items_neu, fehler)
values (%s, %s, %s, %s, %s, %s, %s)
""", (quelle, slot, dauer_ms, status, gesehen, neu, fehler))
items_gesehen, items_neu, items_geaendert, fehler)
values (%s, %s, %s, %s, %s, %s, %s, %s)
""", (quelle, slot, dauer_ms, status, gesehen, neu, geaendert,
fehler))
self.conn.commit()
def close(self):
@@ -323,13 +384,13 @@ def lade_quellen(pfad):
def durchlauf(quellen, senke, slot):
ges_neu = ges_gesehen = 0
ges_neu = ges_gesehen = ges_geaendert = 0
for q in quellen:
if q["typ"] != "rss":
continue
t0 = time.monotonic()
etag, lm = senke.zustand(q["id"])
status = gesehen = neu = 0
status = gesehen = neu = geaendert = 0
fehler = None
try:
status, roh, n_etag, n_lm = hole(q["url"], etag, lm)
@@ -338,21 +399,23 @@ def durchlauf(quellen, senke, slot):
else:
items = parse_feed(roh)
gesehen = len(items)
neu = senke.schreibe(q, items, slot)
neu, geaendert = senke.schreibe(q, items, slot)
if hasattr(senke, "merke_zustand"):
senke.merke_zustand(q["id"], n_etag, n_lm, neu > 0)
except Exception as e: # eine Quelle darf nicht
fehler = f"{type(e).__name__}: {e}" # den Durchlauf killen
status = getattr(e, "code", None)
dauer = int((time.monotonic() - t0) * 1000)
senke.notiere(q["id"], slot, dauer, status, gesehen, neu, fehler)
senke.notiere(q["id"], slot, dauer, status, gesehen, neu, geaendert,
fehler)
ges_neu += neu
ges_geaendert += geaendert
ges_gesehen += gesehen
marke = "!" if fehler else (" " if status != 304 else ".")
print(f" {marke} {q['id']:14} {str(status):>4} "
f"{gesehen:4} gesehen {neu:4} neu {dauer:5} ms"
f"{gesehen:4} gesehen {neu:4} neu {geaendert:3} rev {dauer:5} ms"
+ (f" {fehler}" if fehler else ""), flush=True)
return ges_gesehen, ges_neu
return ges_gesehen, ges_neu, ges_geaendert
def check_robots(quellen):
@@ -420,8 +483,9 @@ def main():
while _lauf:
slot = slot_von(_jetzt())
print(f"[{slot:%Y-%m-%d %H:%M}] Slot", flush=True)
gesehen, neu = durchlauf(aktiv, senke, slot)
print(f" = {gesehen} gesehen, {neu} neu", flush=True)
gesehen, neu, geaendert = durchlauf(aktiv, senke, slot)
print(f" = {gesehen} gesehen, {neu} neu, "
f"{geaendert} revidiert", flush=True)
if args.once:
break
ziel = slot + dt.timedelta(seconds=TAKT + VERSATZ)