School App maken met AI Werkboek Inloggen

Les 4 van 17 · 8 min

Je eerste app: een rekenhulp

In deze les bouw je de rekenhulp van Henk na, met Claude Code in de map rekenhulp die je in les 3 hebt gemaakt. Wil je liever meteen iets voor je eigen bedrijf maken, dan kan dat ook: vervang Henks rekenregel door die van jou. De stappen blijven hetzelfde.

Reken op twee tot drie uur voor de eerste keer.

Stap 1: schrijf op papier wat het moet doen

Begin niet achter de computer. Pak een vel papier en schrijf drie dingen op.

Wat vult de bezoeker in? Bij Henk: de oppervlakte van het huis in vierkante meters, en of het huis van voor of na 2000 is.

Wat moet er uitgerekend worden? Henk gebruikt een eenvoudige vuistregel. Een huis van na 2000 heeft ongeveer 50 watt per vierkante meter nodig, een ouder huis 80 watt. Een huis van 120 vierkante meter uit 1985 heeft dus 120 × 80 = 9.600 watt nodig, afgerond 10 kilowatt.

Dit is Henks vuistregel voor dit voorbeeld. Een echte installateur kijkt ook naar isolatie, ramen en hoe het huis nu verwarmd wordt. Gebruik voor je eigen rekenhulp de regels die jij in je vak gebruikt.

Wat ziet de bezoeker als uitkomst? Bij Henk: het benodigde vermogen in kilowatt, met een zin eronder dat het een schatting is en een uitnodiging om contact op te nemen.

Dit lijkt een overbodige stap. Toch zit hier het meeste werk. Een AI kan niet raden welke rekenregel jij gebruikt. Weet je het zelf nog niet precies, dan krijg je een rekenhulp die er goed uitziet en verkeerd rekent.

Stap 2: vertel het Claude

Open VS Code met de map rekenhulp en open het Claude-venster. Henks eerste poging was één zin:

Maak een rekenhulp voor warmtepompen.

Het resultaat zag er netjes uit. Er stonden zes invulvelden op, de AI had zelf een berekening bedacht en voor een huis van 120 vierkante meter kwam er 4 kilowatt uit. Dat klopt niet met Henks ervaring, en hij kon niet zien waar het getal vandaan kwam.

De tweede keer schreef hij op wat hij op papier had staan:

Ik ben installateur en ik wil een rekenhulp voor op mijn website. Bezoekers vullen twee dingen in: de woonoppervlakte in vierkante meters, en of hun huis van voor of na 2000 is. Reken zo: na 2000 is het 50 watt per vierkante meter, voor 2000 is het 80 watt per vierkante meter. Laat de uitkomst zien in kilowatt, afgerond op een heel getal. Zet eronder: "Dit is een eerste schatting. Voor een advies komen we graag bij je langs." Maak het eenvoudig en goed leesbaar, met grote letters. Maak het als één bestand, warmtepomp.html, dat werkt zonder extra bestanden. Vertel eerst in een paar zinnen wat je gaat bouwen, en maak het bestand pas als ik akkoord geef.

Let op wat er in deze vraag staat. Henk zegt wie hij is en waar het voor is. Hij noemt precies wat er ingevuld wordt, hoe er gerekend wordt en wat er op het scherm komt. Hij zegt hoe het eruit moet zien en hoe het bestand heet.

De laatste zin is een gewoonte die je houdt. Claude vertelt eerst wat hij van plan is. Klopt dat niet met wat je bedoelde, dan zeg je dat voordat er iets gebouwd is. Klopt het wel, dan typ je "akkoord".

Stap 3: bekijk het resultaat

Claude laat zien welk bestand hij wil maken, met alle regels in groen. Geef toestemming. Links in VS Code verschijnt warmtepomp.html.

Open het bestand in je browser. Klik er in VS Code met de rechtermuisknop op en kies Reveal in File Explorer (Windows) of Reveal in Finder (Mac). Dubbelklik daar op het bestand. Je kunt het Claude ook vragen: "Open warmtepomp.html in mijn browser." Dan vraagt hij toestemming om een opdracht uit te voeren die het bestand opent.

Laat het browservenster openstaan. Na elke wijziging druk je op F5 (Windows) of Cmd en R (Mac) om de nieuwe versie te zien.

Kijk eerst alleen of alles er staat: twee invulvelden, een uitkomst, de zin eronder. Over de kleuren en de letters praat je later.

Stap 4: test met getallen die je kent

Dit is de belangrijkste stap, en de stap die mensen het vaakst overslaan.

Maak een lijstje met drie of vier huizen waarvan je de uitkomst zelf kunt uitrekenen:

Huis Oppervlakte Bouwjaar Verwacht
Rijtjeshuis 100 m² na 2000 5 kW
Twee-onder-een-kap 120 m² voor 2000 10 kW
Vrijstaand 180 m² voor 2000 14 kW
Appartement 65 m² na 2000 3 kW

Vul ze een voor een in. Klopt elke uitkomst met je lijstje? Probeer daarna wat een bezoeker per ongeluk zou kunnen doen: niets invullen, een 0 invullen, 1200 in plaats van 120, of een komma in het getal.

Henk vond twee dingen. Bij 65 vierkante meter kwam er 3,25 uit in plaats van 3, omdat het afronden niet goed ging. En bij een leeg veld stond er "NaN kW". Dat betekent "geen getal" en is voor een bezoeker onbegrijpelijk.

Onthoud De AI kent jouw vak niet. Geef je eigen rekenregels mee, dan rekent hij met jouw kennis.

Stap 5: verbeter één ding per keer

Henk typte:

Bij 65 m² na 2000 zie ik 3,25 kW. Rond de uitkomst af op een heel getal, dus 3 kW.

Claude liet zien welke regel hij wilde veranderen. Henk gaf toestemming, herlaadde de pagina en testte opnieuw. Daarna, toen dat goed ging:

Als er niets is ingevuld, staat er "NaN kW". Laat dan niets zien, en zet bij een getal onder de 20 de melding "Vul de oppervlakte in vierkante meters in."

Vraag niet alles tegelijk. Als je vijf wijzigingen in één bericht zet, voert de AI er vaak vier goed uit en verandert hij ongemerkt iets anders. Na elke wijziging test je weer met je lijstje uit stap 4.

Pas als alles goed rekent, ga je naar de uitstraling:

Gebruik de kleur van mijn bedrijf, donkergroen (#1E5E3B), voor de knop en de uitkomst. Zet mijn bedrijfsnaam bovenaan: Installatiebedrijf Hendriks.

Stap 6: bewaar werkende versies

Gaat een wijziging mis, dan wil je terug naar de versie die werkte. Claude Code bewaart bij elke wijziging een herstelpunt. Typ /rewind in het invoervak en kies het moment waar je naartoe wilt. Je kunt het ook gewoon vragen: "Zet de laatste wijziging terug."

Maak daarnaast zelf een kopie als iets goed werkt:

Maak een kopie van warmtepomp.html met de naam warmtepomp-werkt-1.html.

Bij een groter project gebruik je versiebeheer. Dat komt in het tweede deel van de cursus.

Stap 7: schrijf op wat je hebt gemaakt

Alles staat al in je map, dus opslaan hoeft niet. Wel wil je over een halfjaar nog weten hoe het zat. Vraag Claude:

Schrijf een bestand LEESMIJ.md met wat deze rekenhulp doet, de rekenregel en mijn testgevallen met de verwachte uitkomst.

Wil je later iets veranderen, dan open je de map weer in VS Code. Claude leest de bestanden, ook LEESMIJ.md, en je gaat verder waar je gebleven was.

En dan op je website

Een rekenhulp op je eigen computer heeft nog geen klant geholpen. Er zijn drie manieren om hem online te krijgen:

  • Via je webbouwer. Stuur het HTML-bestand op en vraag of het op een eigen pagina kan. Voor een webbouwer is dit meestal een kwartier werk.
  • In WordPress. Veel WordPress-sites hebben een blok voor eigen HTML. Je plakt de code daarin. Of dat goed gaat, hangt af van je thema en je instellingen.
  • Bij je hostingpartij. Je zet het bestand zelf via een bestandsbeheerder op je website. Dat vraagt wat meer handigheid.

Wat je ook kiest, lees eerst les 6. Daarin staat wat je moet controleren voordat iets van jou online staat.

Opdracht

Bouw je rekenhulp

Bouw de rekenhulp na met Henks prompt, of met je eigen rekenregel uit de opdracht van les 2.

Samengevat: schrijf eerst op papier wat er ingevuld wordt, hoe er gerekend wordt en wat eruit komt. Laat Claude eerst vertellen wat hij gaat bouwen, test met getallen die je zelf kunt uitrekenen en verbeter één ding per keer.