Opdracht: van projectidee tot interactief prototype
Opdracht: van projectidee tot interactief prototype
Tijdens het eerste deel van het project bouw je de UI van je applicatie uit, voorzie je een databaseschema en implementeer je registratie en login functionaliteiten.
Doel
Gebruik ChatGPT Work en/of Codex om een projectidee uit te werken en een interactief frontendprototype te bouwen. Je vertrekt vanuit de aangereikte Next.js-template en bereidt je project voor op een backend die je in een latere fase zelf ontwerpt en programmeert.
Aan het einde van deze fase heb je een duidelijk projectconcept, een roadmap voor het volledige project en een werkend prototype met herbruikbare componenten en functionerende navigatie. Raadpleeg ook het bestand instructies.md voor hulp bij het werken met de AI-agent.
De opdracht
Kies een projectonderwerp dat voldoet aan de vereisten van je docent. Je applicatie moet een concreet probleem oplossen voor een duidelijk omschreven doelgroep.
Gebruik AI als samenwerkingspartner. Jij blijft verantwoordelijk voor de keuzes, de code en je begrip van het resultaat. Beoordeel voorstellen, stel vragen en maak bewuste keuzes.
1. Brainstorm en kies een project
Gebruik AI om verschillende projectideeën te verkennen. Denk bij elk idee na over de volgende vragen:
- Wie zal de applicatie gebruiken?
- Welk probleem lost de applicatie op?
- Wat zijn de belangrijkste acties die gebruikers kunnen uitvoeren?
- Welke gegevens heeft de applicatie nodig?
- Is het idee haalbaar binnen de beschikbare tijd?
Kies één idee en leg uit waarom het voldoet aan de opdrachtvereisten. Beschrijf de doelgroep, het probleem en de belangrijkste functies van een eerste versie.
2. Importeer en verken de template
Gebruik een AI-agent om de aangereikte Next.js-template in je project te importeren. Vraag de agent om je te helpen de bestaande structuur te begrijpen en uit te zoeken hoe je de applicatie opstart.
Start het project lokaal op en controleer of de template werkt voordat je grote wijzigingen aanbrengt. Houd rekening met de instructies en conventies die bij de template zijn meegeleverd.
3. Maak een beknopt AGENTS.md-bestand
Maak samen met de agent een AGENTS.md-bestand in de hoofdmap van je project. Dit bestand geeft een AI-codeeragent praktische aanwijzingen om in je repository te werken.
Houd het bestand kort en specifiek voor jouw project. Neem bijvoorbeeld het volgende op:
- Het doel van de applicatie.
- Hoe je het project installeert, opstart en controleert.
- De belangrijkste afspraken over de projectstructuur en code.
- Waar herbruikbare componenten en mockdata thuishoren.
- Het onderscheid tussen het prototype en de backend die je later bouwt.
Lees elke instructie na en verwijder wat vaag, overbodig of niet van toepassing is op jouw project.
Houd je agents.md file beknopt. AI kan zelf zien dat je een Next project hebt dat TypeScript gebruikt. Zoek (recente) best practices op.
4. Maak een roadmap
Stel samen met de agent een roadmap op voor het volledige project, niet alleen voor het prototype. Beschrijf de belangrijkste stappen om van je huidige idee tot een werkende applicatie te komen.
Je roadmap bevat minstens deze fasen:
- Het project definiëren.
- Een prototype maken.
- De backend ontwerpen, inclusief de gegevens die de applicatie nodig heeft.
- De backend implementeren.
- De frontend verbinden met de backend.
- De applicatie testen en afwerken.
- De applicatie deployen indien van toepassing.
Beschrijf voor elke fase het gewenste resultaat en de belangrijkste taken. Vermeld ook welke aannames je maakt en welke beslissingen nog openstaan. De roadmap is een planning: je hoeft in deze opdracht niet alle fasen uit te voeren.
5. Bouw een interactief frontendprototype
Gebruik een AI-agent om een Next.js-prototype te maken op basis van je projectidee.
Je prototype moet:
- Schermen bevatten voor alle verplichte CRUD acties.
- Werkende navigatie tussen die schermen hebben.
- Waar zinvol gebruikmaken van herbruikbare componenten.
- Mockdata en gesimuleerd gedrag gebruiken in plaats van een echte backend.
- Realistische inhoud en, waar relevant, verschillende toestanden tonen, zoals een lege lijst of een voltooide actie.
- Zo gestructureerd zijn dat je het gesimuleerde gedrag later kunt vervangen door je eigen backend.
- Lokaal opstarten met behulp van de gedocumenteerde instructies.
6. Maak je databankschema en zorg voor authenticatie
Databank
Je voorziet een volledig databaseschema dat opgebouwd is met één of meer migrations in Prisma. Natuurlijk komt dit schema overeen met de UI die je door een AI-tool heb laten genereren, er mogen hier en daar nog enkele kleine verschillen zijn, maar de grote lijnen moeten dezelfde zijn.
Je relationeel model bevat minstens 8 tabellen, één veel-op-veel relatie en één tabel met minstens 7 attributen (exclusief primary key). Veel-op-veel relaties tellen mee als een tabel, ook als je deze op de achtergrond laat aanmaken door Prisma en deze niet expliciet in je Prisma schema opneemt. Enums tellen niet mee als een tabel.
Aangezien je ook authenticatie moet voorzien, heb je minstens een User en Session tabel nodig, daarnaast is er natuurlijk ook een Role enum aanwezig. Er zijn dus nog 6 andere tabellen nodig.
Testdata
Om je applicatie te testen voorzie je een seed script waarmee er minstens 10 records per tabel worden aangemaakt.
Voor de Session en User tabellen volstaat het om 1 record (gebruiker) aan te maken, tenzij je met meerdere rollen gewerkt hebt, dan maak je voor elke rol een gebruiker aan.
Voeg de inloggegevens voor elke gebruiker toe aan je readme.md bestand.
Om testdata te genereren kan je eventueel gebruik maken van faker, of aan een AI vragen om testdata te genereren.
Authenticatie
De enige CRUD-operaties die moeten werken in deel 1 van je project zijn inloggen en registreren. Zorg ervoor dat deze op een correcte manier geïmplementeerd zijn, je mag al validatie toevoegen via Zod, maar dit moet niet.
Je implementeert deze authenticatie via een JSON Web Token die in een veilig HTTP-only cookie bewaard wordt. Deze token moet alle informatie over de gebruiker en sessie bevatten.
7. Wat dien je in?
Commit en push je aanpassingen. Je mag meerdere branches gebruiken (graag), maar enkel code in de main branch wordt verbeterd.
Je repo bevat:
- Het Next.js-project, inclusief je prototype en
AGENTS.md. - Een korte projectbeschrijving met het probleem, de doelgroep, het gekozen idee en de belangrijkste functies.
- Je roadmap voor de volledige applicatie.
- Een korte reflectie over je gebruik van AI, waarin je beschrijft:
- Welke omgeving je gebruikte en hoe je AI gebruikte tijdens het brainstormen en ontwikkelen.
- Eén opdracht die goed werkte en waarom die duidelijk was.
- Minstens één voorstel dat je hebt aangepast of verworpen, en waarom.
- Een moment waarop je de agent moest bijsturen en iets wat je hebt gecontroleerd of gecorrigeerd.
- Hoe je de navigatie en de gesimuleerde acties hebt getest.
- Wat momenteel gesimuleerd wordt en wat je zelf nog moet bouwen.
- Instructies om het project op te starten, zodat iemand anders het kan installeren en uitvoeren.
Gebruik een readme.md file voor je omschrijving, reflectie, ...
Beoordelingscriteria
Zie rubriek op Canvas.