Week 2 - jornveltrop/ilojo-bar GitHub Wiki

Stand-up Joost

Aan het begin van de week hadden we de eerste stand-up. Samen in een online call met Joost hebben we de stand van zaken besproken. Er waren wat probleempjes met het 3D model. Joost gaf de tip zolang dit nog niet werkt een goede fallback als tijdelijke oplossing te gebruiken. Het blijft tenslotte een prototype. Deze fallbacks heb overigens sowieso nodig bij 3D modellen.

Joost concludeerde dat we erg soepel en vlot begonnen waren met een plan.

API werkt

Na de stand-up probeerde ik nogmaals de API werkend te krijgen. Nogmaals de uitleg op de site van Prismic lezen, bracht de oplossing.

Vervolgens kon ik de server & templating code schrijven, zodat alle routes de juiste data binnen kregen.

app.get('/discover/:id', async (req, res) => {
    let stories = await client.getAllByType('story', {
        orderings: {
          field: 'my.story.id',
          direction: 'asc'
        }
      })

    let uid = req.params.id
    let story = await client.getByUID('story', uid)
    let storyData = story.data
    let alineas = storyData.body[0].items
    let id = storyData.id - 1;

    let previous = getPreviousStory(id, stories);
    let next = getNextStory(id, stories);

    res.render('story', { 
        storyData,
        alineas,
        previous,
        next
    })
})

Templating engine

Helaas moest ik concluderen dat Handlebars als templating engine niet goed combineert met Prismic. Ik heb daarom, na het mergen met Jeany haar code, Handlebars vervangen met EJS.

Uiteindelijk is dat goed gekomen en werkt Prismic nu soepel.

Documentatie

Dinsdag Documentatie dag! Deze week dan tenminste. Het was een iets minder productieve dag door te weinig nachtrust.

Documentatie blijft een mentaal obstakel, maar zoals je leest, heb ik mij daar overheen kunnen zetten.

Code review #1

In de eerste code review hebben we nog niet veel naar code gekeken. Wel hebben we het gehad over planning, een code guide opzetten en het schrijven van component based code. Je site kun je namelijk opdelen in componenten. Deze componenten zijn allemaal een soort feature. Door al deze features los te beschrijven kun je ze vervolgens omzetten naar GH-issues, met MoSCoW op belangrijkheid indelen via labels en daarna verdelen tussen Jeany en mij. Een goede tip van Joost!

Ook hebben we het in deze code review gehad over het eerst prototypen en daarmee een proof-of-concept neerzetten, en daarna pas de performance te optimaliseren.

Zo gaan wij voor een opt in systeem voor het 3D model, door de kosten en de zwaarte voor de telefoons in Nigeria.

Design

Ik heb deze week ook gewerkt aan het design van de site. De Ilojo bar is een gebouw in Braziliaanse stijl en gebouwd door terug gekeerde tot slaaf gemaakten uit Zuid Amerika. Ik heb daarom het design geïnspireert op Zuid Amerikaanse stijl.

Bronnen voor deze stijl staan in een Github issue

Aan de hand van deze stijl heb ik de eerste versie gemaakt:

Feedbackgesprek Femke #1

Deze vrijdag was het tijd voor het eerste feedback gesprek. We hebben haar versie 1 van ons prototype laten zien. Ze vond de stijl erg mooi aansluiten bij de Ilojo bar. Zij kwam in de briefing zelf met het idee om per gevel een verhaal aan te hangen. Dit hebben we uitgewerkt en vond ze erg sterk.

Wel mistte ze op de homepagina nog wat meer omgeving. Ze zou het fijn vinden om nog meer van de straat te zien en de omgeving waar de Ilojo bar stond. Goed punt, waar we aan zullen gaan werken tijdens de volgende sprint.

Ook leek het haar mooi als je wat meer kon in en uitzoomen bij de gevels, nu is er steeds maar 1 gevel in beeld.

Conclusie week 2

Er zijn grote stappen gemaakt deze week met het design en goede feedback van Femke. We hebben een duidelijke richting waar we heen willen, daar ben ik erg blij mee. Ook de samenwerking met Jeany verliep nog steeds goed.