Overzicht

Deze pagina verzamelt gebruikersverhalen over de catalogus-tool. Ze beschrijven hoe Rene (liturgiecoördinator in de parochie Groningen) en Nana (parochie-componist) zangmateriaal vinden, lokaal toevoegen, sjablonen vullen tot samenstellingen, en materiaal delen via de bron-repository.

De verhalen zijn voorbeelden (parochie Groningen), bedoeld als bruikdocumentatie voor vrijwilligers en als basis voor latere handleidingen.

Kernworkflow (doelbeeld)

1. Rene opent een markdown-sjabloon (dienst, koormap of herkomst) — zonder individuele default.gelegenheid.
2. Hij maakt een sessie en vult default.gelegenheid (en evt. toon) in.
3. Op vaste plekken staat :::include met zoek="…" — liturgische rol.
4. Hij lost de zoekopdrachten op tot catalogus-paden; review alleen bij ambiguïteit.
5. Hij bouwt het opgeloste bestand naar de site / export.

Contract: zangstuk in samenstelling-sjablonen.

Pad-:::include vs catalogus-zoek=

zoek= (deze handleidingen): liturgische rol in het sjabloon; resolve kiest later het concrete .vsa-pad (vsa-bestand). Geschikt voor diensten die per gelegenheid wisselen.

Pad-:::include: vast relatief pad naar een .vsa — zie Exporttype SVG (exporttype svg). Geschikt wanneer de bron al bekend is (demo, vaste pagina, na resolve).

Commando’s (wanneer je CLI gebruikt): Catalogus CLI, vsa resolve-catalogus, vsa build-markdown.

Persona's en context

Naam	Rol	Werkt met
Rene	Liturgiecoördinator, parochie Groningen	Sjablonen, samenstellingen, parochie-repo, PR's naar bron
Nana	Componist / arrangeur in de parochie	Nieuwe stukken (PDF, VSA-notatie, MusicXML)

Repositories:

Repo	Pad (voorbeeld)	Inhoud
bron	C:\Git\orthodox-ronl\bron	Org-brede zangstukken (zangstukken/) in de bron-repository
parochie-site	C:\Git\orthodox-ronl\VSA-demo\content-source	Sjablonen, samenstellingen, lokaal/ (parochie-lokaal; demo)

Terminologie: terminologie §2 — opslag blijft vier niveaus (zangstuk-id → variant-id → uitvoeringsvorm-id → representatie-id); Rene typt vooral zoektekst.

Groningen, groningen en vokn in deze verhalen

Term	Betekenis in de verhalen
Parochie Groningen	Persona / plaats — geen catalogus-id
default.uitvoeringsvorm: Groningen	Parochie-default bij zoeken (invoer alias) — niet in mixed session
uitvoeringsvorm-id: groningen	Parochie-specifieke uitvoeringsvorm (bijv. Nana's Kastorski-bewerking)
uitvoeringsvorm-id: liturgikon	Bron-uitvoeringsvorm (Liturgikon-model; demo feest-stukken)
vokn	(Gepland in glossary) VOKN-standaardkoormap — niet hetzelfde als groningen

Tot de glossary-PR over vokn vastligt, gebruiken de verhalen Groningen /groningen waar het om parochiepraktijk gaat. Materiaal rechtstreeks uit de VOKN-standaardkoormap krijgt later uitvoeringsvorm-id: vokn; zie samenvatting-project — legacy yaml.

Interface: GUI (beoogd) en CLI (nu)

CLI vs GUI

catalogus zoek, vsa resolve-catalogus en :::include zoek= zijn geïmplementeerd (CLI). Een grafische catalogus (sessie-wizard, interactieve review bij ambiguïteit) is nog gepland.

Technische referentie: Catalogus CLI, Catalogus-architectuur, Catalogus — zoek-API, Zangstuk in samenstelling-sjablonen.

Verhalen

#	Titel	Wat leer je
—	Sjabloon schrijven	default, :::include zoek=, sessie
1	Liturgie — Geboorte Moeder Gods	Sjabloon → sessie → resolve
2	Cherubijnenhymne lokaal opnemen	PDF/VSA in lokaal/ (parochie-lokaal)
3	Cherubijnenhymne naar bron	Promotie via pull request
4	MusicXML delen	MXL als bronbestand

Volgorde

Verhalen 2 → 3 → 4 sluiten aan; verhaal 1 staat op zichzelf.