TUTORIAL | Bouw je eerste Conduction Nextcloud-app

[WilcoLouwerse]

Achtergrond

Er staat al een tutorial Build an app op de academy en een uitgebreidere reeks DeskDesk-tutorials (1–4). Deze dekken samen het bouwen van een eerste Conduction Nextcloud-app, maar de instaproute is nog niet ideaal:

• de "Build an app"-tutorial is relatief op zichzelf staand;
• de DeskDesk-reeks is uitgebreid maar verwijst niet expliciet terug naar de korte introductie;
• er ontbreekt een duidelijk "Doe eerst …" / "Doe hierna …" tussen beide.

Doel

Een publieke Nederlandstalige leerlijn op conduction.nl/academy die een nieuwe developer van niets naar een werkende, eigen Conduction Nextcloud-app brengt. Voortbouwen op wat er al is, niet vanaf nul herschrijven.

Doelgroep

Developers die al een werkplek hebben (zie tutorial Workstation Setup) en een eerste app willen bouwen.

Voorgestelde structuur (chaining)

1. Voorbereiding — verwijzen naar Workstation Setup + Nextcloud-lokaal-draaien als prerequisites.
2. Bestaande korte tutorial bijwerken — build-an-app (bron: academy/2026-04-20-build-an-app) — als beknopte "Hello App" instap.
3. Doorlinken naar DeskDesk-reeks — tutorial 1 → 2 → 3 → 4 als verdiepingsroute, expliciet als "Doe hierna".
4. (optioneel) Eigen schema toevoegen — een mini-tutorial die buiten DeskDesk om een eigen entiteit toevoegt.

Bestaande documentatie (referenties)

Naast de bestaande academy-tutorials staat in /home/wilco/.github/docs/claude/ materiaal dat we kunnen verwerken/linken:

• docs/claude/walkthrough.md
• docs/claude/app-lifecycle.md
• docs/claude/getting-started.md
• docs/claude/frontend-standards.md

Pluvo-vragen (minimaal 4)

Voorbeelden:

1. Wat is het verschil tussen een Nextcloud-app en een Conduction Nextcloud-app (qua structuur en stack)?
2. Welke generator/skill gebruik je om een nieuwe app te scaffolden, en wat doet die precies?
3. Waar leef je je domeinmodel: in code, in een spec, of in een schema-bestand?
4. Hoe deploy je je app lokaal op je Nextcloud-omgeving om hem te testen?
5. Wat is een logische volgende stap nadat je de basis-app werkend hebt?

Op te leveren

• Inventarisatie van wat er al staat (build-an-app + DeskDesk 1–4) en wat ontbreekt
• Eventueel: bijgewerkte versie van build-an-app
• Expliciete "Doe eerst …" / "Doe hierna …" links tussen tutorials
• Minimaal 4 Pluvo-vragen per deel
• Cross-links naar Workstation Setup, Nextcloud-lokaal-draaien, OpenSpec, Skills
• Linkcheck
• Peer review

Schrijfstijl

Volg de Conduction-schrijfstijl (zie identity.conduction.nl). Voorbeeldstructuur: Bestanden bij een Woo-publicatie uploaden. Houd elke stap kort; chain ze.

Tijdregistratie

Uren op dit issue boeken op de Jira-issue van het SLIM-account.