Guides: create, read, publish, delete (text only) #8

Closed
opened 2026-11-01 16:19:34 +01:00 by miko · 1 comment
Owner

Part of #1

Blocked by: #7

What

Guide header and reading view without steps. See ADR-0005, ADR-0008.

Acceptance criteria

  • Prisma model Guide (categoryId, ownerId, title, slug, description JSON, language, visibility, status, wikiMode, searchText, version, createdById, updatedById, timestamps, publishedAt?, deletedAt?)
  • Authors create guides in any category; creator becomes owner
  • Editor.js for the description with allow-listed blocks (paragraph, header h3/h4, list, code, quote, warning; inline bold, italic, link, inline code)
  • Own server-side React renderer for Editor.js JSON (no raw HTML injection); unit tests incl. stripping disallowed blocks/tags
  • /guides/<id>/<slug>; wrong or missing slug redirects to the canonical one
  • Draft/published status; edits to published guides are live
  • Soft delete; admins can list and restore deleted guides
  • Optimistic locking via version; stale save shows a conflict notice with "reload"
  • updatedById/updatedAt maintained
  • All access goes through the permission module from #7

Vocabulary: GLOSSARY.md. Decisions: docs/adr/.

Part of #1 Blocked by: #7 ## What Guide header and reading view without steps. See ADR-0005, ADR-0008. ## Acceptance criteria - [ ] Prisma model `Guide` (categoryId, ownerId, title, slug, description JSON, language, visibility, status, wikiMode, searchText, version, createdById, updatedById, timestamps, publishedAt?, deletedAt?) - [ ] Authors create guides in any category; creator becomes owner - [ ] Editor.js for the description with allow-listed blocks (paragraph, header h3/h4, list, code, quote, warning; inline bold, italic, link, inline code) - [ ] Own server-side React renderer for Editor.js JSON (no raw HTML injection); unit tests incl. stripping disallowed blocks/tags - [ ] `/guides/<id>/<slug>`; wrong or missing slug redirects to the canonical one - [ ] Draft/published status; edits to published guides are live - [ ] Soft delete; admins can list and restore deleted guides - [ ] Optimistic locking via `version`; stale save shows a conflict notice with "reload" - [ ] `updatedById`/`updatedAt` maintained - [ ] All access goes through the permission module from #7 Vocabulary: `GLOSSARY.md`. Decisions: `docs/adr/`.
Author
Owner

Implemented in MR #21 (stacked on #20).

Implemented in MR #21 (stacked on #20).
miko closed this issue 2026-11-01 18:31:59 +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.

Dependencies

No dependencies set.

Reference
MassiveDynamic/kataba#8
No description provided.