Naar de inhoud

Start hierLerenGratis e-mailcursusAI voor je beroepPlaygroundAI-WerkplaatsAI-geletterdheid voor organisaties
PromptsWorkflowsToolsVeiligheidBegrippenBlog
Mijn dashboard
↑↓ kiezenEnter openenCtrlK overal openenEsc sluiten

Voorbeeld uit de Bouwplan Studio

Planbord voor Schildersbedrijf Vos

Een planner, zes schilders, een whiteboard en te veel WhatsApp. Dit is wat de Bouwplan Studio van dat idee maakt: een specificatie die een coding agent kan bouwen, met de bestanden erbij.

Projectnaam
Planbord voor Schildersbedrijf Vos
Het idee
Een interne tool waarin onze planner klussen inplant voor zes schilders. Per klus: adres, klant, geschatte uren, benodigde materialen en welke schilder erop staat. Schilders zien op hun telefoon hun planning voor de week en vinken een klus af met een paar foto's. De planner ziet wie waar is en welke klus uitloopt. Nu gaat dit via een whiteboard en WhatsApp, en gaat er elke week wel iets mis.
Voor wie
De planner (één persoon, op een laptop) en zes schilders op hun telefoon. De eigenaar wil op vrijdag een overzicht van de week.
Soort
Interne tool voor een team
Gegevens
Klanten, klussen, schilders, uren per klus, foto's bij oplevering, materialenlijst per klus.
Koppelingen
Later: Exact Online, zodat een afgeronde klus een conceptfactuur wordt.
Techniek
Geen voorkeur, graag iets gangbaars dat één persoon kan onderhouden.
Coding agent
Claude Code

Het bouwplan

Een interne webapp met twee gezichten: een planbord voor de planner op een groot scherm, en een eenvoudige weekweergave voor schilders op hun telefoon. Versie 1 vervangt het whiteboard en de WhatsApp-berichten: klussen inplannen, toewijzen, afvinken met foto's en zien wat uitloopt. Facturatie en materiaalbeheer komen later, zodat de eerste versie binnen een paar weken in gebruik kan zijn.

Gebruikers

  • Planner: Snel een klus aanmaken, slepen naar een dag en een schilder, en in één oogopslag zien wie waar is en wat uitloopt.
  • Schilder: Op de telefoon de eigen week zien, het adres openen in de navigatie, en een klus afvinken met foto's en gewerkte uren.
  • Eigenaar: Op vrijdag een overzicht: geplande uren tegenover gewerkte uren per klus, en welke klussen zijn uitgelopen.

Functies

Versie 1

  • Klussen beheren: Klus aanmaken met klant, adres, geschatte uren en notities; status gepland, bezig, klaar.
  • Planbord per week: Dagen als kolommen, schilders als rijen; klussen slepen naar een dag en een schilder.
  • Weekweergave voor schilders: Mobiele lijst van de eigen klussen per dag, met adres als link naar de navigatie-app.
  • Klus afronden: Gewerkte uren invullen en twee tot vijf foto's uploaden; de planner ziet direct dat de klus klaar is.
  • Uitloop zichtbaar: Een klus kleurt oranje als de gewerkte uren boven de schatting komen of de klus na de geplande dag nog open staat.

Kort na versie 1

  • Weekoverzicht voor de eigenaar: Per klus geplande en gewerkte uren, totaal per schilder, export naar CSV.
  • Materialenlijst per klus: Vrije lijst met wat er mee moet; later koppelen aan voorraad.
  • Klantoverzicht: Alle klussen per klant, met de foto's van eerdere opleveringen.

Later

  • Koppeling Exact Online: Een afgeronde klus wordt een conceptfactuur in Exact.
  • Meldingen: Pushbericht of sms als de planning van morgen verandert.

Datamodel

  • Klant
    • id: uuid
    • naam: tekst
    • adres: tekst
    • telefoon: tekst
    • email: tekst, optioneel

    Eén klant kan meerdere klussen hebben.

  • Schilder
    • id: uuid
    • naam: tekst
    • telefoon: tekst
    • actief: ja/nee
    • inlogcode: hash

    Schilders loggen in met een pincode op hun telefoon; de planner met e-mail en wachtwoord.

  • Klus
    • id: uuid
    • klant_id: verwijzing
    • omschrijving: tekst
    • adres: tekst
    • geschatte_uren: getal
    • status: gepland | bezig | klaar
    • notities: tekst

    Het adres staat ook op de klus, omdat het kan afwijken van het adres van de klant.

  • Planning
    • id: uuid
    • klus_id: verwijzing
    • schilder_id: verwijzing
    • datum: datum
    • volgorde: getal

    Eén klus kan over meerdere dagen en schilders verdeeld zijn.

  • Urenregistratie
    • id: uuid
    • klus_id: verwijzing
    • schilder_id: verwijzing
    • datum: datum
    • uren: decimaal

    Per dag per schilder, zodat uitloop per dag zichtbaar is.

  • Foto
    • id: uuid
    • klus_id: verwijzing
    • bestand: pad in opslag
    • gemaakt_op: tijdstip

    Opslag buiten de database, bijvoorbeeld in een bucket; alleen het pad in de tabel.

Schermen

  • Planbord: Weekoverzicht voor de planner: slepen, toewijzen, uitloop zien.
  • Klus: Eén klus bekijken en bewerken, met planning, uren en foto's.
  • Mijn week: Mobiele lijst voor een schilder, per dag.
  • Klus afronden: Uren invullen, foto's maken of kiezen, bevestigen.
  • Weekoverzicht: Eigenaar: uren en uitloop per klus en per schilder, export.
  • Inloggen: Planner met e-mail en wachtwoord, schilder met pincode.

Techstack

  • Frontend en backend: Next.js met TypeScript (Eén codebase voor planbord en mobiele weergave, veel voorbeelden, goed te onderhouden door één persoon.)
  • Database: PostgreSQL via Drizzle (Relaties tussen klussen, planning en uren zijn precies waar een relationele database goed in is.)
  • Bestandsopslag: S3-compatibele bucket (Foto's horen niet in de database; een bucket is goedkoop en schaalt mee.)
  • Hosting: Eén VPS met Docker Compose (Interne tool voor zeven gebruikers; een kleine server met back-ups is genoeg.)

Security en privacy

  • Alle pagina's achter inloggen; schilders zien alleen hun eigen klussen (Het zijn klantgegevens en adressen; een gelekte link mag niets tonen.)
  • Pincodes van schilders als hash opslaan en na vijf foute pogingen tijdelijk blokkeren (Een pincode van vier cijfers is anders in minuten te raden.)
  • Foto's alleen via de app opvraagbaar, niet via een openbare bucket-URL (Foto's van woningen zijn persoonsgegevens.)
  • Dagelijkse back-up van de database en de bucket (Als de planning weg is, staat het bedrijf stil.)
  • Invoer valideren op de server, niet alleen in het formulier (Ook een interne tool krijgt verkeerde of onverwachte invoer.)

Koppelingen

  • Exact Online: Later: conceptfactuur maken uit een afgeronde klus. Versie 1 exporteert alleen CSV.

Takenlijst in bouwvolgorde

  1. 1Project opzetten

    Next.js met TypeScript, Drizzle en PostgreSQL in Docker Compose; een lege pagina die draait.

    Klaar als: npm run dev werkt en de database is bereikbaar.

  2. 2Datamodel en migraties

    De zes tabellen uit het datamodel als Drizzle-schema met een eerste migratie.

    Klaar als: De migratie draait schoon op een lege database.

  3. 3Inloggen

    Planner met e-mail en wachtwoord, schilder met naam en pincode; sessie in een beveiligde cookie.

    Klaar als: Zonder sessie kom je op elke pagina op het inlogscherm.

  4. 4Klussen beheren

    Lijst, aanmaken en bewerken van klussen en klanten, met validatie op de server.

    Klaar als: Een klus met lege omschrijving wordt geweigerd met een duidelijke melding.

  5. 5Planbord

    Weekweergave met slepen van klussen naar dag en schilder; opslaan zonder herladen.

    Klaar als: Een verplaatste klus staat na herladen op de nieuwe plek.

  6. 6Mijn week voor schilders

    Mobiele weergave van de eigen klussen per dag, adres als link naar de navigatie.

    Klaar als: Een schilder ziet alleen klussen die aan hem of haar zijn toegewezen.

  7. 7Klus afronden met uren en foto's

    Formulier op de telefoon: uren per dag, foto's uploaden naar de bucket, status naar klaar.

    Klaar als: Foto's zijn alleen zichtbaar na inloggen en staan niet op een openbare URL.

  8. 8Uitloop markeren

    Klus kleurt oranje bij meer gewerkte dan geschatte uren of bij een open klus na de geplande dag.

    Klaar als: Een klus van 8 uur met 9 geregistreerde uren is oranje op het planbord.

  9. 9Weekoverzicht en CSV-export

    Pagina voor de eigenaar met uren per klus en per schilder, downloadknop voor CSV.

    Klaar als: De CSV opent in Excel met de juiste kolommen en totalen.

  10. 10Back-ups en livegang

    Dagelijkse dump van de database, versiebeheer van de bucket, HTTPS via Caddy, één testrestore.

    Klaar als: Een restore van gisteren levert een werkende app op.

Beslissingen voor jou

  • Mogen schilders elkaars klussen zien, bijvoorbeeld om bij te springen, of strikt alleen de eigen klussen?
  • Wie mag een klus op klaar zetten: alleen de schilder, of ook de planner namens hem?
  • Hoeveel foto's per klus en hoe lang bewaren, in verband met opslagkosten en privacy?
  • Wil de eigenaar het weekoverzicht als pagina, als mail op vrijdag, of allebei?

De bestanden voor je coding agent

Uit dit plan maakt de Studio drie bestanden die je in de hoofdmap van je project zet. Je agent leest dan eerst wat er gebouwd moet worden en werkt de takenlijst op volgorde af.

  • CLAUDE.md
  • SPEC.md
  • TASKS.md
Bekijk CLAUDE.md
markdown
# Planbord voor Schildersbedrijf Vos

Een interne webapp met twee gezichten: een planbord voor de planner op een groot scherm, en een eenvoudige weekweergave voor schilders op hun telefoon. Versie 1 vervangt het whiteboard en de WhatsApp-berichten: klussen inplannen, toewijzen, afvinken met foto's en zien wat uitloopt. Facturatie en materiaalbeheer komen later, zodat de eerste versie binnen een paar weken in gebruik kan zijn.

## Waar vind je wat
- `SPEC.md`: wat we bouwen, voor wie, datamodel en schermen.
- `TASKS.md`: de takenlijst in bouwvolgorde.

## Techstack
- Frontend en backend: Next.js met TypeScript
- Database: PostgreSQL via Drizzle
- Bestandsopslag: S3-compatibele bucket
- Hosting: Eén VPS met Docker Compose

## Werkafspraken
- Werk aan één taak uit TASKS.md tegelijk. Lees eerst SPEC.md.
- Doe kleine, controleerbare stappen en leg uit wat je verandert.
- Schrijf tests voor logica en draai ze voordat je een taak klaar meldt.
- Voeg geen afhankelijkheden toe zonder te zeggen waarom.
- Vraag het als een eis onduidelijk is, in plaats van te gokken.

## Security, altijd
- Geen geheimen of API-keys in de code of in git. Gebruik omgevingsvariabelen.
- Controleer bij elke actie op de server of de gebruiker dit mag (autorisatie), niet alleen in de interface.
- Valideer alle invoer op de server. Gebruik geparametriseerde queries.
- Toon geen stacktraces of interne fouten aan gebruikers.
- Alle pagina's achter inloggen; schilders zien alleen hun eigen klussen
- Pincodes van schilders als hash opslaan en na vijf foute pogingen tijdelijk blokkeren
- Foto's alleen via de app opvraagbaar, niet via een openbare bucket-URL
- Dagelijkse back-up van de database en de bucket
- Invoer valideren op de server, niet alleen in het formulier

Eén keer gemaakt met de Bouwplan Studio op Claude en daarna nagelezen. Het bedrijf, de mensen en de cijfers zijn verzonnen. Een echte run met jouw invoer ziet er anders uit en is net zo goed een startpunt: controleer de keuzes voordat je ze gebruikt.