Sprint 4

Tijdens deze sprint ben ik voornamelijk bezig geweest met de feedback functionaliteit. Docenten kunnen zeggen wat zij van het spel vinden en de opdrachtgevers willen deze feedback verzamelen.

Dit was zowel in Svelte, als in het CMS (Strapi). Het CMS heb ik ook nog wat gepersonaliseerd, zodat het niet op een standaard Strapi CMS lijkt, maar echt op een JungleGym CMS.

Daarnaast nog wat kleine dingen opgepakt, zoals refactoren, updaten van de README en bugfixes.

Beoordelen van spellen

Onze opdrachtgevers wilden graag feedback over de spellen verzamelen. Hierdoor kunnen zij spellen aanpassen als deze niet duidelijk schijnen te zijn.

Ik heb een GameReview component gemaakt die op iedere spelpagina getoond wordt. Er is ervoor gekozen om dit formulier zo simpel mogelijk te houden.

Het liefst willen zij zo veel mogelijk (nuttige) informatie verzamelen, maar alles is beter dan niets. Daarom wilde ik een kort formulier maken dat optioneel langer kan worden (als de gebruiker dat wilt).

Met dit ontwerp ben ik begonnen:

De afgelopen sprints ging ik vervolgens naar Figma om daar wat te ontwerpen. Deze sprint heb ik ervoor gekozen om dit niet te doen en direct in de app aan de slag te gaan. Natuurlijk heb ik nog wel wat dingen geschetst, maar ik heb de stap in Figma overgeslagen.

Ik wist wel wat ik ongeveer wilde, maar naar mate ik langer bezig was, kreeg ik een steeds beter beeld van wat ik wilde.

Opslaan van deze data

Uiteindelijk wil je dat deze data ook opgeslagen wordt. Eerst wilde ik dit in het account gedeelte doen van de app. Ik ben van mening dat dit nog steeds de beste manier is, maar voor nu heb ik een andere (minder goede, maar wel snellere) keuze gemaakt.

Wij gebruiken al Strapi als CMS en hier is het ook mogelijk om een POST request te sturen. Dit is niet ideaal, want Strapi is een CMS. Een CMS is een plek waar jij content kunt beheren (lees: toevoegen en bewerken). De reviews zijn dingen die je niet hoeft te bewerken, dus daarom is een CMS hier niet ideaal voor.

Toch heb ik ervoor gekozen om Strapi hiervoor te gebruiken, omdat wij dit heel snel te realiseren was. Het enige wat ik hoefde te doen, was het volgende:

	async function sendResultsToDB(formResults) {
		// Both forms have fields in common
		let result = {
			game: formResults.game,
			type: formResults.type
		};
		const isShortForm = formResults.type === 'short';
		if (isShortForm) {
			result = {
				...result,
				overallEmoji: formResults.overallEmoji
			};
		} else {
			result = {
				...result,
				descriptionEmoji: formResults.descriptionAnswers.emoji,
				descriptionExplanation: formResults.descriptionAnswers.explanation,
				executionEmoji: formResults.executionAnswers.emoji,
				executionExplanation: formResults.executionAnswers.explanation,
				kidsEmoji: formResults.kidsAnswers.emoji,
				kidsExplanation: formResults.kidsAnswers.explanation
			};
		}
		const response = await fetch(`${VITE_STRAPI_API_URL}/reviews`, {
			method: 'POST',
			body: JSON.stringify(result),
			headers: {
				'Content-Type': 'application/json'
			}
		});
		return response.json();
	}

Het resultaat (formResults) werd in een andere functie al uit het formulier gehaald en werd vervolgens als parameter meegestuurd aan de sendResultsToDB functie.

Er zijn dus twee type forms: short en long

Korte formulier (short)

Lange formulier (long)

Indien de gebruiker (docent) geen zin heeft om een lang formulier in te vullen, dan is er toch wat feedback.

Dit formulier wordt gestuurd naar Strapi en hierin staat dan een overzicht met alle reviews.

Zoals je kunt zien, wordt er onderscheidt gemaakt tussen de twee formulieren, maar komen zij beiden op dezelfde plaatst in het CMS te staan.

Wel heb ik ervoor gekozen om er een read-only field van te maken, aangezien de content niet aangepast gaat worden. Hieronder is een review te zien uit het lange formulier. Bovenin is te zien op wat voor type formulier het gaat en om welk spel het gaat.

Design Review

Tijdens deze sprint had ik geen specifieke dingen om te reviewen. Samen met Sjoerd ben bij Vasilis langs geweest voor wat overall feedback over de app.

Hieruit kwamen twee dingen:

1. Witruimtes moeten consistenter. Doordat ze zo verschillend zijn, lijkt het erg rommelig.

2. Het zoeken moet verbeteren. Het was allereerst niet goed uitgelijnd, maar daarnaast was de feedback als iemand zocht ook niet goed. Er stond Er wordt gezocht op ..., terwijl dit pas getoond werd als het zoeken klaar was. Niet heel logisch dus.

Deze dingen hebben wij daarna verbeterd. Voor de rest van Vasilis erg positief over de app.

Code Review

Deze sprint hebben wij geen code review ontvangen.