Fullstack Closette App

door Jiro Ghianni

Inhoud en installatie

Welkom bij de Closette ~ genderneutrale toiletten zoek-app. Deze applicatie kun je zelf installeren via de installatie handleiding. Alle toelichtingen en uitleg over hoe deze app inelkaar zit, kun je hier vinden:

• Deze Readme...

  * ... beschrijft waar alle documenten en applicaties te vinden zijn
  
  * ... bevat de link naar de GIT repository waarnaar het project geüpload
  

  is, te weten deze: Jiro's Github Fullstack Closette App.

• ⚠️ in de 'LEESMIJ' map staat alle documentatie bijelkaar, inclusief de Installatiehandleiding: link naar installatiehandleiding PDF (2 MB)

• Om het makkelijker te maken om de JSON body van alle endpoints te kopiëren, bestaat er ook endpoint-collectie bestand dat meteen in Postman geïmporteerd kan worden.

• Zowel de Front-end als de Back-end map hebben nog eens dubbelop wat eigen documentatie in zeer korte vorm in een Readme file. Dit lijkt overkill, maar het maakt het wel makkelijker om documentatie te bereiken zodra je deze folders als Root hebt geopend in verschillende IDE's.

• in de 'LEESMIJ' map staat het Functioneel ontwerp + het Technisch ontwerp samen in één PDF (7 MB).

• Broncode van beide projecten staat in de ZIP (hierin bevinden zich de front-end map en de back-end map + de 'LeesMij'-documentatie map) en het online Github-project.

• in de 'LEESMIJ' map staat ook het Verantwoordingsdocument: link naar Verantwoordingsdocument in markdown

• in de 'LEESMIJ' map staat de eerder genoemde importeerbare verzameling van Postman requests (JSON); De endpoints heb ik tevens gepubliceerd op deze documentatie site (inclusief beschrijvingen): https://documenter.getpostman.com/view/17991980/UVeCR95T

• link naar de Figma schermontwerpen: https://www.figma.com/file/yv5hJQVzTMvwTT31oyQBRE/Jiro-Closette-design?node-id=0%3A1

• link naar YouTube demo video van de app: https://youtu.be/1NKu80bZs9s

• Deze app op Heroku: https://frontend-closette.herokuapp.com

Nawoord / extra’s

Ik hoop dat nieuwe programmeurs gevoeliger gaan zijn voor diversiteit en nooit meer databases ontwerpen waarin gender slechts binair of een boolean is. Dit project is een eerste oefening in nadenken over toegankelijkheid en genderveiligheid.

Lees mijn stuk over diversiteit in code hier: https://codepen.io/jirosworld/post/how-to-build-diversity-into-your-code

Veel plezier met nakijken!

Saluti,

Jiro Ghianni 2021 / 2022