RSS/Atom-Feeds für Teiche und Seiten #149

New Issue

fable-5 · 2026-07-20T00:15:48+02:00

fable-5 commented

2026-07-20 00:15:48 +02:00

Ziel

Abonnierbare Feeds mit wiki-üblichen Informationen: (a) je Teich = neue/geänderte Seiten, (b) je Seite = Änderungshistorie. Öffentliche Teiche anonym; nicht-öffentliche authentifiziert.

Umsetzungsskizze

Neue Handler im PublicModule (apps/api/src/public/): GET /public/:pondSlug/feed.xml und GET /public/:pondSlug/:pageSlug/feed.xml; Atom-XML aus page.findMany({orderBy updatedAt desc, take N}) bzw. der Versions-Tabelle. Einträge: Titel, Link, updated, Autor soweit vorhanden, Auszug (Plain-Text-Cache). Vorlage für Non-JSON-Responses: der html-Handler + html-shell.ts.
Auth für private Teiche: dediziertes read-only Feed-Token je Nutzer als Query-Param (?token=…) — PATs bewusst NICHT in URLs wiederverwenden (Leak-Gefahr). Neue kleine Tabelle analog api_tokens (DB-Migration), Verwaltung in den Nutzer-Einstellungen, Permission-Check = canSeePond/canAccessPage des Token-Inhabers.
Ohne gültiges Token bei privatem Teich: 404 (Semantik #60).
<link rel="alternate" type="application/atom+xml"> in die Public-HTML-Shell.

Akzeptanzkriterien

Valides Atom (einmalig gegen W3C-Validator geprüft).
Anonym 200 nur bei öffentlichen Teichen; privat ohne Token 404, mit Token 200.
Einträge tragen Titel/Link/updated; DB-Tests; Doku (user-guide + API-Doku).

## Ziel Abonnierbare Feeds mit wiki-üblichen Informationen: (a) je Teich = neue/geänderte Seiten, (b) je Seite = Änderungshistorie. Öffentliche Teiche anonym; nicht-öffentliche authentifiziert. ## Umsetzungsskizze - Neue Handler im `PublicModule` (`apps/api/src/public/`): `GET /public/:pondSlug/feed.xml` und `GET /public/:pondSlug/:pageSlug/feed.xml`; Atom-XML aus `page.findMany({orderBy updatedAt desc, take N})` bzw. der Versions-Tabelle. Einträge: Titel, Link, updated, Autor soweit vorhanden, Auszug (Plain-Text-Cache). Vorlage für Non-JSON-Responses: der `html`-Handler + `html-shell.ts`. - Auth für private Teiche: dediziertes read-only **Feed-Token je Nutzer** als Query-Param (`?token=…`) — PATs bewusst NICHT in URLs wiederverwenden (Leak-Gefahr). Neue kleine Tabelle analog `api_tokens` (**DB-Migration**), Verwaltung in den Nutzer-Einstellungen, Permission-Check = canSeePond/canAccessPage des Token-Inhabers. - Ohne gültiges Token bei privatem Teich: 404 (Semantik #60). - `<link rel="alternate" type="application/atom+xml">` in die Public-HTML-Shell. ## Akzeptanzkriterien - Valides Atom (einmalig gegen W3C-Validator geprüft). - Anonym 200 nur bei öffentlichen Teichen; privat ohne Token 404, mit Token 200. - Einträge tragen Titel/Link/updated; DB-Tests; Doku (user-guide + API-Doku).

fable-5 added this to the M21 — API & Feeds milestone 2026-07-20 00:15:48 +02:00

fable-5 referenced this issue

2026-07-20 00:51:20 +02:00

M21: API & Feeds — me-Doku (#147), since-Filter (#148), Atom-Feeds (#149) #157

fable-5 referenced this issue from a commit

2026-07-20 00:51:21 +02:00

#149: Atom-Feeds für Teiche und Seiten, privat via Feed-Token

fable-5 closed this issue

2026-07-20 01:06:21 +02:00

fable-5 commented

2026-07-20 01:06:22 +02:00

Umgesetzt in PR #157 (7252bd1): Atom-Feeds GET /api/v1/public/:pond/feed.xml (zuletzt geaenderte Seiten) und GET /api/v1/public/:pond/:page/feed.xml (Versions-Historie), @Public mit 404-Semantik. Oeffentliche Teiche anonym; nicht-oeffentliche via neuem read-only Feed-Token je Nutzer (?token=dt_feed_…, neue Tabelle feed_tokens als Migration, Verwaltung unter Einstellungen → Feed-Tokens). Oeffentliche HTML-Seiten annoncieren den Teich-Feed per link rel=alternate. 5 DB-Tests (anonym/privat/Token-Lifecycle/Permission/HTML-Shell) + User-Guide-Doku en+de.

Umgesetzt in PR #157 (7252bd1): Atom-Feeds GET /api/v1/public/:pond/feed.xml (zuletzt geaenderte Seiten) und GET /api/v1/public/:pond/:page/feed.xml (Versions-Historie), @Public mit 404-Semantik. Oeffentliche Teiche anonym; nicht-oeffentliche via neuem read-only Feed-Token je Nutzer (?token=dt_feed_…, neue Tabelle feed_tokens als Migration, Verwaltung unter Einstellungen → Feed-Tokens). Oeffentliche HTML-Seiten annoncieren den Teich-Feed per link rel=alternate. 5 DB-Tests (anonym/privat/Token-Lifecycle/Permission/HTML-Shell) + User-Guide-Doku en+de.

Sign in to join this conversation.