Pages (Inhaltsseiten) #64

Closed
opened 2026-11-04 09:34:08 +01:00 by miko · 1 comment
Owner

Ursprüngliche Anfrage: Es sollte möglich sein, Inhaltsseiten zu erstellen, die genutzt werden können um z.B. ein Impressum anzugeben, oder eine generelle Seite zu einem Thema anzulegen. Zum editieren reichen die Funktionen von Editor.js, allerdings sollten bei Seiten noch Bilder hochgeladen werden können und das tabellen tool wäre sicher auch nützlich. wenn möglich, auch eine möglichkeit, layout spalten zu nutzen.

Blocked by: #66

Admins können Pages anlegen: eigenständige Seiten mit Rich-Text-Inhalt, etwa ein Impressum oder eine Themenseite. Der Bild-Block folgt in #67, die Layout-Spalten in #68.

Modell

  • Eine Page hat Titel, Slug, Rich-Text-Inhalt (Editor.js-JSON, ADR 0005), Visibility (public/internal) und den Status Draft/Published.
  • Pages liegen flach, außerhalb des Category-Baums. Sie erscheinen nicht in Category-Grids und haben keine Child Order.
  • Die Visibility gilt direkt, ohne Vererbung, weil eine Page keine Ancestors hat.
  • Ein Draft ist nur für Admins sichtbar. Änderungen an einer veröffentlichten Page sind sofort live, wie bei Guides (ADR 0008).

Rechte

  • Nur Admins dürfen Pages anlegen, bearbeiten und löschen. Owner und Wiki Mode gibt es für Pages nicht.

Verwaltung

  • Das Verwaltungsmenü (#66) bekommt den Eintrag Pages, der auf /admin/pages führt.
  • /admin/pages listet alle Pages mit Titel, Status, Visibility und dem Datum der letzten Änderung.
  • /admin/pages/new fragt nur nach Titel und Slug, legt die Page als Draft an und leitet zu /admin/pages/[id] weiter.
  • /admin/pages/[id] bearbeitet Titel, Slug, Visibility, Status und Inhalt.
  • Gelöscht wird nach einer Bestätigung endgültig, ohne Papierkorb.
  • Alle Routen werden mit requireAdmin geschützt.

URL und Slug

  • Eine Page ist unter /<slug> erreichbar, z.B. /impressum.
  • Der Slug wird aus dem Titel erzeugt (src/categories/slug.ts), ist danach änderbar und instanzweit eindeutig.
  • Erlaubt sind nur Kleinbuchstaben, Ziffern und Bindestriche.
  • Bei einer Slug-Änderung gibt es keinen Redirect. Das Formular weist darauf hin, dass die alte URL dann nicht mehr funktioniert.
  • Reservierte Slugs werden beim Speichern abgewiesen. Eine Konstante im Code hält sie fest:
    • alle Namen, die auf oberster Ebene von src/app schon belegt sind: admin, api, c, guides, media, search, icon.svg, apple-icon
    • vorsorglich: p, login, logout, account, settings, favicon.ico, robots.txt, sitemap.xml
  • Ein Test prüft, dass jeder Eintrag auf oberster Ebene von src/app auf der Liste steht.
  • Falls eine neue Route später eine Page überdeckt, gewinnt die Route.

Editor

  • Der Page-Editor verwendet RichTextEditor mit allen bisherigen Tools und zusätzlich einem Tabellen-Block (@editorjs/table).
  • Die Kopfzeile der Tabelle ist umschaltbar. Die Zellen erlauben nur Inline-Formatierung (fett, kursiv, Link, Inline-Code).
  • Den Tabellen-Block gibt es nur in Pages, nicht in Guide-Beschreibungen, Step-Content oder Category-Beschreibungen.
  • Parser (src/richText/document.ts) und Renderer (src/richText/RichText.tsx) bekommen einen table-Fall. Auf dem Handy scrollt die Tabelle horizontal in ihrem Container.

Suche

  • Pages erscheinen in der Suche als eigene Ergebnisart „Page“. Gesucht wird in Titel und Inhalt (plainText).
  • Es erscheinen nur Pages, die der Besucher sehen darf.

Doku

  • Glossar-Eintrag Page
  • ADR 0015: „Pages liegen außerhalb des Category-Baums, auf oberster Ebene mit reservierten Namen“

Akzeptanzkriterien

  • Ein Admin kann eine Page anlegen, bearbeiten, veröffentlichen und löschen. Andere Rollen haben keinen Zugriff auf /admin/pages….
  • /<slug> zeigt eine veröffentlichte Page gemäß ihrer Visibility. Für Nicht-Admins liefern ein Draft und ein unbekannter Slug 404.
  • Reservierte und doppelte Slugs werden mit einer Fehlermeldung abgewiesen. Der Test gegen src/app ist vorhanden.
  • Der Tabellen-Block funktioniert im Page-Editor, hat einen Round-Trip-Test im Parser und wird gerendert. In anderen Editoren ist er nicht verfügbar.
  • Pages erscheinen in der Suche nur für berechtigte Besucher.
  • Glossar und ADR 0015 sind ergänzt.
> Ursprüngliche Anfrage: Es sollte möglich sein, Inhaltsseiten zu erstellen, die genutzt werden können um z.B. ein Impressum anzugeben, oder eine generelle Seite zu einem Thema anzulegen. Zum editieren reichen die Funktionen von Editor.js, allerdings sollten bei Seiten noch Bilder hochgeladen werden können und das tabellen tool wäre sicher auch nützlich. wenn möglich, auch eine möglichkeit, layout spalten zu nutzen. Blocked by: #66 Admins können **Pages** anlegen: eigenständige Seiten mit Rich-Text-Inhalt, etwa ein Impressum oder eine Themenseite. Der Bild-Block folgt in #67, die Layout-Spalten in #68. ## Modell - Eine **Page** hat Titel, Slug, Rich-Text-Inhalt (Editor.js-JSON, ADR 0005), Visibility (`public`/`internal`) und den Status Draft/Published. - Pages liegen **flach, außerhalb des Category-Baums**. Sie erscheinen nicht in Category-Grids und haben keine Child Order. - Die Visibility gilt direkt, ohne Vererbung, weil eine Page keine Ancestors hat. - Ein Draft ist nur für Admins sichtbar. Änderungen an einer veröffentlichten Page sind sofort live, wie bei Guides (ADR 0008). ## Rechte - Nur **Admins** dürfen Pages anlegen, bearbeiten und löschen. Owner und Wiki Mode gibt es für Pages nicht. ## Verwaltung - Das Verwaltungsmenü (#66) bekommt den Eintrag **Pages**, der auf `/admin/pages` führt. - `/admin/pages` listet alle Pages mit Titel, Status, Visibility und dem Datum der letzten Änderung. - `/admin/pages/new` fragt nur nach Titel und Slug, legt die Page als Draft an und leitet zu `/admin/pages/[id]` weiter. - `/admin/pages/[id]` bearbeitet Titel, Slug, Visibility, Status und Inhalt. - Gelöscht wird nach einer Bestätigung **endgültig**, ohne Papierkorb. - Alle Routen werden mit `requireAdmin` geschützt. ## URL und Slug - Eine Page ist unter `/<slug>` erreichbar, z.B. `/impressum`. - Der Slug wird aus dem Titel erzeugt (`src/categories/slug.ts`), ist danach änderbar und instanzweit eindeutig. - Erlaubt sind nur Kleinbuchstaben, Ziffern und Bindestriche. - Bei einer Slug-Änderung gibt es keinen Redirect. Das Formular weist darauf hin, dass die alte URL dann nicht mehr funktioniert. - **Reservierte Slugs** werden beim Speichern abgewiesen. Eine Konstante im Code hält sie fest: - alle Namen, die auf oberster Ebene von `src/app` schon belegt sind: `admin`, `api`, `c`, `guides`, `media`, `search`, `icon.svg`, `apple-icon` - vorsorglich: `p`, `login`, `logout`, `account`, `settings`, `favicon.ico`, `robots.txt`, `sitemap.xml` - Ein Test prüft, dass jeder Eintrag auf oberster Ebene von `src/app` auf der Liste steht. - Falls eine neue Route später eine Page überdeckt, gewinnt die Route. ## Editor - Der Page-Editor verwendet `RichTextEditor` mit allen bisherigen Tools und zusätzlich einem **Tabellen-Block** (`@editorjs/table`). - Die Kopfzeile der Tabelle ist umschaltbar. Die Zellen erlauben nur Inline-Formatierung (fett, kursiv, Link, Inline-Code). - Den Tabellen-Block gibt es **nur in Pages**, nicht in Guide-Beschreibungen, Step-Content oder Category-Beschreibungen. - Parser (`src/richText/document.ts`) und Renderer (`src/richText/RichText.tsx`) bekommen einen `table`-Fall. Auf dem Handy scrollt die Tabelle horizontal in ihrem Container. ## Suche - Pages erscheinen in der Suche als eigene Ergebnisart „Page“. Gesucht wird in Titel und Inhalt (`plainText`). - Es erscheinen nur Pages, die der Besucher sehen darf. ## Doku - Glossar-Eintrag **Page** - ADR 0015: „Pages liegen außerhalb des Category-Baums, auf oberster Ebene mit reservierten Namen“ ## Akzeptanzkriterien - [ ] Ein Admin kann eine Page anlegen, bearbeiten, veröffentlichen und löschen. Andere Rollen haben keinen Zugriff auf `/admin/pages…`. - [ ] `/<slug>` zeigt eine veröffentlichte Page gemäß ihrer Visibility. Für Nicht-Admins liefern ein Draft und ein unbekannter Slug 404. - [ ] Reservierte und doppelte Slugs werden mit einer Fehlermeldung abgewiesen. Der Test gegen `src/app` ist vorhanden. - [ ] Der Tabellen-Block funktioniert im Page-Editor, hat einen Round-Trip-Test im Parser und wird gerendert. In anderen Editoren ist er nicht verfügbar. - [ ] Pages erscheinen in der Suche nur für berechtigte Besucher. - [ ] Glossar und ADR 0015 sind ergänzt.
miko changed title from Inhaltsseiten to Pages (Inhaltsseiten) 2026-11-04 09:52:41 +01:00
Author
Owner

Umgesetzt in MR #69 (feature/64-pages). Der Eintrag „Pages“ steht vorerst als Link neben Settings in der Kopfleiste; #66 übernimmt ihn ins Verwaltungsmenü.

Umgesetzt in MR #69 (feature/64-pages). Der Eintrag „Pages“ steht vorerst als Link neben Settings in der Kopfleiste; #66 übernimmt ihn ins Verwaltungsmenü.
miko closed this issue 2026-11-04 11:44:45 +01:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Blocks
#65 Menu in der Kopfleiste
MassiveDynamic/kataba
#67 Bild-Block in Pages
MassiveDynamic/kataba
#68 Columns in Pages
MassiveDynamic/kataba
Depends on
Reference
MassiveDynamic/kataba#64
No description provided.