Collectopoly

Een catalogus voor je bordspelverzameling, waarin een spel toevoegen seconden kost in plaats van een formulier.

Type
Privé / hobby
Duur
Doorlopend
Stack

Collectopoly is een catalogus voor een fysieke verzameling bordspellen, begonnen bij Monopoly-edities en -varianten. Je legt vast wat je hebt, houdt een verlanglijst bij en die lijst kun je publiek delen zodat anderen weten wat ze je kunnen geven.

Waarom

Twee dingen die ik leuk vind kwamen hier samen: websites bouwen en Monopoly-edities verzamelen. Het begon als een online inventaris om zelf bij te houden wat ik had en vanaf daar is het uitgebouwd met steeds meer koppelingen.

Wat de vorm bepaalde is wannéér je iets toevoegt. Dat is bijna nooit een moment waarop je achter een computer zit. Je staat in een winkel, of je scrolt door een advertentie op je telefoon, of je bedenkt je ineens dat je die ene editie hebt. Wat je op dat moment bij je hebt verschilt: soms een barcode, soms alleen een titel, soms een link die je net gekopieerd hebt.

Een formulier met verplichte velden is dan precies verkeerd. Dus is het uitgangspunt geworden dat toevoegen seconden mag kosten en dat alles wat je nu niet weet later ingevuld mag worden, vanuit hetzelfde record.

Hoe het werkt

Laravel aan de achterkant met Horizon voor de wachtrijen, Nuxt aan de voorkant, samen in één monorepo. Het datamodel scheidt de editie zelf van wat een gebruiker ermee heeft: een spel bestaat één keer in de catalogus en daarnaast staat of jij het bezit of het op je verlanglijst hebt staan.

De kern is één endpoint. Je gooit er iets in (een titel, een barcode van dertien cijfers, of een winkel-URL) en het zoekt uit wat je bedoelde. Bij een titel gaat het langs de zoekfunctie van bol en daarna langs BoardGameGeek. Bij een barcode eerst bol en alleen als die het spel niet voert een tweede bron erachteraan. Bij een gekopieerde link wordt eerst het product-id eruit gevist en daarna dezelfde route gevolgd.

Kernpunten waar ik trots op ben

  • Vier externe bronnen gekoppeld: Go-UPC voor EAN-nummers, bol.com, BoardGameGeek en eBay. Elk met zijn eigen eigenaardigheden en zijn eigen gegevens.
  • Een eigen interne lookup-API die de resultaten beoordeelt en er één gemengd antwoord van maakt. Je gooit er een titel, een barcode of een gekopieerde winkellink in; hij zoekt uit wat je bedoelde, gaat de juiste bronnen langs en levert alles in dezelfde vorm terug. Een bron die faalt komt apart terug in plaats van de hele zoekopdracht mee te trekken.
  • Domeinherkenning en link-canonicalisatie op elke schrijfactie. Je hoeft niet aan te geven van welke winkel een link is en bij het opslaan gaan de trackingparameters eraf.
  • Geautomatiseerde sweeps langs de API-bronnen om bestaande gegevens bij te werken, zodat de catalogus niet stilstaat bij wat er op de dag van invoeren bekend was.
  • Gedeeltelijke goedkeuring van wijzigingsvoorstellen van andere gebruikers. Een voorstel komt in een wachtrij met de betrokken velden erin en een beheerder kan er een paar van accepteren in plaats van alles of niets.

Wat er nog niet in zit

Er staan nog wat leuke dingen op de planning. Dit is een project dat waarschijnlijk nooit echt af zal zijn.

Wat het opleverde

Meer ervaring in het maken van visuele variaties en in de infrastructuur eromheen: hoe je dit soort gegevens opslaat en weergeeft. Verder werk met barcodes en EAN-nummers en koppelingen met Go-UPC, eBay, BoardGameGeek en bol.