Webshop · sportschutters · België
Online bekijken,in de winkelkopen.
PaddleO3 wordt de online catalogus van een erkende wapenhandelaar voor sportschutters. Dit overzicht zet op een rij wat al besproken is en wat nog open ligt, zodat het team het datamodel (ERD) kan afwerken en de officiële lijst met requirements kan opstellen.
Van overzicht naar bouw
-
18·11·26 · nu
Huidige stap: Dit overzicht: wat we weten en wat nog open ligt.
-
Open vragen
Antwoorden van de handelaar en het team.
-
ERD
Het datamodel volledig uitgewerkt.
-
Requirements
De officiële lijst, goedgekeurd door de klant.
-
Bouw versie 1
Eerst de catalogus, daarna personalisatie.
Introductie
Wat we bouwen
PaddleO3 wordt de website van een erkende wapenhandelaar voor sportschutters in België. Het is een online catalogus, geen klassieke webshop: schutters bekijken het aanbod online, sturen een aanvraag en kopen in de winkel.
Die keuze volgt uit de wet. Artikel 19 van de Wapenwet verbiedt de verkoop van wapens op afstand aan particulieren, ook van vrij verkrijgbare wapens. Elke koopintentie wordt daarom een aanvraag of een winkelbezoek. Prijsafspraak, controle van documenten, verkoop en overdracht gebeuren persoonlijk, in de winkel.
Het project heeft twee delen. De catalogus is het grootste deel: het volledige aanbod met productfiches, zoeken, filters en aanvragen. Daarnaast komt personalisatie voor bepaalde modellen, waarmee een schutter online een eigen uitvoering samenstelt en als aanvraag doorstuurt.
Dit document is bedoeld om samen door te nemen. De functionaliteiten en entiteiten tonen wat er nu op tafel ligt. De open vragen zeggen wie moet beslissen en of het antwoord het datamodel, de requirements of allebei verandert.
PaddleO3 verwijst naar Operatie Paddle, augustus 1944, waarmee de Belgische Brigade Piron om 03:00 vertrok. In eerdere documenten en in het eerste datamodel heet het project nog Convoy44.
Sinds het vorige overzicht · 14·11·26
- De merknaam is PaddleO3.
- De site en alle productinformatie zijn meertalig vanaf de eerste versie. Eerder stond dat voor later gepland.
- Een eerste datamodel ligt klaar als basis voor het ERD. Het kan per product een prijs tonen en online verkoop toelaten voor wat geen wapen is. Of we dat ook doen, is nog open.
- Het design system van PaddleO3 staat klaar. Dit overzicht gebruikt het al.
Technische basis · voor het team
- Website
- TanStack Start, met de server in dezelfde app
- Gegevens
- Supabase (databank, login, foto’s), via Prisma
- Teksten
- Vaste sitetekst in vertaalbestanden, productinhoud in de databank
- Hosting
- Railway wordt overwogen
Functionaliteiten · versie 1
Wat de eerste versie kan
De eerste versie bevat wat nodig is om de catalogus wettelijk correct en bruikbaar online te zetten: 11 functies voor bezoekers en 8 voor de winkel. Deze indeling is een voorstel. Een verwijzing naar een vraag betekent dat de uitwerking van die functie nog afhangt van het antwoord.
Voor de bezoeker
11 functies- F01
Leeftijdsmelding 18+
Bij het eerste bezoek bevestigt de bezoeker dat hij 18 jaar of ouder is. Op elke productfiche staat dezelfde vermelding.
- F02
Taalkeuze
De hele site en alle productinformatie in meerdere talen, met een taalkeuze bovenaan elke pagina.
- F03
- F04
Zoeken
Op merk, model, kaliber of trefwoord, met suggesties tijdens het typen.
- F05
- F06
- F07
Aanvraaglijst
Producten verzamelen om in één keer naar prijs en beschikbaarheid te vragen. Dit is geen winkelmand: er wordt niets besteld of betaald.
- F08
Aanvraag versturen
Naam, e-mail, telefoon, contactvoorkeur en de vraag. De bezoeker krijgt een bevestiging per e-mail in zijn taal, met een referentienummer en de vermelding dat het geen bestelling is.
- F09
Winkelbezoek aanvragen
Een moment en een onderwerp voorstellen, bijvoorbeeld advies bij een eerste wapen.
- F10
Infopagina’s
Zo koopt u een wapen als sportschutter, welke documenten u nodig hebt, veilig opslaan en vervoeren, veelgestelde vragen en over ons.
- F11
Contact en winkelinfo
Adres, openingsuren, route en de wettelijk verplichte vermeldingen, zoals het erkennings- en ondernemingsnummer.
Voor de winkel
8 functies- F12
- F13
Vertalingen
Per taal de naam, de beschrijving en de teksten voor zoekmachines. Automatisch vertaalde teksten blijven gemarkeerd tot iemand ze nagelezen heeft.
- F14
Prijs en beschikbaarheid
Per product: in de winkel, te bestellen of op aanvraag. Een prijs kan ingevuld worden zonder dat de site ze toont.
- F15
Bulkimport
Productgegevens in één keer inladen uit een spreadsheet of een bestand van de leverancier.
- F16
Aanvragenbeheer
Eén inbox met een status per aanvraag (nieuw, in behandeling, afspraak gepland, afgerond), toewijzen aan een medewerker en interne notities.
- F17
Inhoudsbeheer
De homepage, infopagina’s en veelgestelde vragen zelf aanpassen, zonder ontwikkelaar.
- F18
Medewerkers en rechten
Elke medewerker logt in met een eigen account en krijgt eigen rechten.
- F19
Privacy
Aanvragen worden na een ingestelde bewaartermijn automatisch anoniem gemaakt. Gegevens van een klant kunnen op vraag gewist worden.
Niet in versie 1 · voorstel
Deze functies komen later, of alleen als de klant ze wil. Een paar zijn in het datamodel al voorbereid, zodat ze geen grote verbouwing vragen.
Personalisatie
Het tweede deel van het project. Het datamodel duidt nu al aan welke modellen personaliseerbaar zijn.
Online verkopen en betalen
Enkel voor wat geen wapen is, als de winkel dat wil en de wet het toelaat.
Klantaccounts en favorieten
Eigen aanvragen opvolgen en producten bewaren, zonder upload van licentie of vergunning.
Passend toebehoren
Bij elk wapen de holsters, optiek en lampen die erop passen. Het datamodel voorziet het al.
Vergelijken
Tot drie producten naast elkaar op hun specificaties.
Meldingen en nieuwsbrief
Een e-mail als een product weer binnen is, en een nieuwsbrief met toestemming.
Afsprakenagenda
Vaste tijdsloten voor winkelbezoeken, met automatische bevestiging.
Kassakoppeling en rapportering
Beschikbaarheid automatisch overnemen, en cijfers over bekeken producten en aanvragen.
Entiteiten · datamodel
Wat de webshop bijhoudt
Een entiteit is een soort gegeven dat de webshop bewaart, zoals een product of een aanvraag. Hieronder staan de 14 entiteiten uit het eerste datamodel, zonder velden. In het ERD worden dat 25 tabellen, omdat vertalingen en koppelingen een eigen tabel krijgen. De technische namen staan onderaan elke kaart.
Catalogus
7 entiteitenCategorie
De hoofd- en subcategorieën van het aanbod, bijvoorbeeld wapens en daaronder pistolen.
categories
Merk
De fabrikant, met logo. Merknamen worden niet vertaald.
brands
Artikel
Een product zoals het in de catalogus staat. Hoort bij één merk en één categorie, en heeft een wettelijke status, nieuw of occasie, beschikbaarheid en een prijs.
articles
Variant
Een uitvoering van een artikel, met een eigen artikelnummer: een ander kaliber, een andere looplengte, kleur of links- of rechtshandig.
article_variants
Specificatie
De kenmerken waarop bezoekers vergelijken en filteren, zoals kaliber, capaciteit of discipline, met hun mogelijke waarden per artikel of variant.
attributes · attribute_options · article_attribute_values · variant_option_values
Beeld
Foto’s en andere beelden, met een beschrijving per taal. Een beeld hoort bij een artikel of bij één variant.
media · article_media
Artikelrelatie
Welke producten bij elkaar passen, zoals een holster bij een pistool. Voorzien, maar pas na versie 1 in gebruik.
article_relations
Aanvragen
3 entiteitenAanvraag
Een vraag naar prijs en beschikbaarheid of naar een winkelbezoek, met contactgegevens, taal, status en referentienummer. Een aanvraag is nooit een bestelling.
inquiries
Aanvraagregel
De producten of uitvoeringen waarover een aanvraag gaat.
inquiry_items
Interne notitie
Wat medewerkers bij een aanvraag noteren. De klant ziet dit niet.
inquiry_notes
Site en beheer
4 entiteitenInhoudspagina
Infopagina’s, veelgestelde vragen en over ons, door de winkel zelf te beheren.
pages
Medewerker
Wie inlogt in het beheer, met een rol en rechten. Aanvragen kunnen aan een medewerker toegewezen worden.
users
Winkelinstellingen
Vaste gegevens van de winkel, zoals adres, erkenningsnummer en contactgegevens, en de bewaartermijn van aanvragen.
shop_settings
Taal
De talen van de site en welke taal de standaard is als een vertaling ontbreekt.
languages
Nog niet in het datamodel
Hangt af van de open vragenPersonalisatie
Per model de opties, de toegelaten combinaties en de voorbeeldbeelden.
Bestelling en betaling
Winkelmand, bestelling, betaling en levering. Alleen nodig als de winkel niet-wapens online verkoopt.
Klant
Een klantaccount, alleen nodig bij accounts of online verkoop. Zonder account blijft een aanvraag op zichzelf staan.
Kaliber en discipline
Nu een specificatie. Als eigen entiteit kunnen we wapens, munitie en laders aan elkaar koppelen.
Vertalingen
Categorie, merk, artikel, specificatie, beeld en inhoudspagina hebben per taal een eigen vertaling. Daarom telt het ERD meer tabellen dan er entiteiten zijn. Vaste teksten van de site, zoals knoppen en meldingen, staan niet in de databank maar in vertaalbestanden.
Voor het ontwikkelteam
- Voor de wettelijke indeling liggen twee voorstellen naast elkaar:
regulationmet vijf waarden in de DBML, enlegalCategorymetlicenseCategoriesenisOnSportShooterListuit de latere uitwerking van de wapenkenmerken. Kies er één bij het afwerken van het ERD (V08). - Medewerkers loggen in via Supabase Auth. Hun id wordt daardoor een uuid in plaats van een oplopend nummer.
- Alle technische namen in de DBML in het Engels, ook de tabelgroepen. Notities mogen in het Nederlands blijven.
Open vragen · 15
Wat we nog moeten weten
Elke vraag zegt wie beslist en wat het antwoord raakt: het datamodel (ERD), de requirements of de wetgeving. Drie vragen bepalen het meest hoe het datamodel eruitziet. Die beantwoorden we eerst.
Aanbod en verkoop
-
V01
Eerst beslissen
Verkopen we wat geen wapen is ook online?
Optiek, lampen, holsters, onderhoud en merch zijn geen wapens. Volgens wat we vonden, lijkt online verkoop daarvan wettelijk mogelijk. De handelaar bevestigt dat vanuit zijn kennis van de wapenwet. Zo ja, dan komen er een winkelmand, bestellingen, betaling, levering en klantgegevens bij: het grootste verschil in het datamodel. Het design system toont nu al een winkelmand bovenaan de site, terwijl de catalogus een aanvraaglijst gebruikt.
-
V02
Tonen we prijzen online?
Volgens de omzendbrief van 2011 mag een erkende handelaar online prijzen vermelden. Tot nu gold toch overal ‘Prijs op aanvraag’. Het datamodel kan het per product instellen. Te beslissen: nergens, per categorie of per product.
-
V03
Welke hoofdcategorieën komen er?
De eerste input telt zeven categorieën: wapens, optiek, wapenlampen, holsters, wapenonderhoud, toebehoren en merch. Het design system gaat uit van wapens, optiek, munitie, herladen, uitrusting en verzamelobjecten. Komen munitie, herlaadmateriaal en verzamelobjecten in de catalogus? Munitie heeft eigen wettelijke regels.
-
V04
Komt personalisatie in versie 1 of erna?
En met welke modellen en welke opties starten we? Wie voert coatings en gravures uit, en dekt de erkenning van die persoon of firma dat werk?
-
V05
Toont de winkel occasies in de catalogus?
Een occasie is één exemplaar met een eigen staat en eigen foto’s, geen model met voorraad. Dat vraagt een andere aanpak dan een nieuw product.
Producten en gegevens
-
V06
Eerst beslissen
Wat is een apart product, en wat is een uitvoering?
Is hetzelfde pistool in 9 mm en in .22 LR één product met twee uitvoeringen, of twee producten? Dezelfde vraag geldt voor looplengte, kleur en links- of rechtshandig. Het antwoord bepaalt hoe artikels, varianten, foto’s en aanvragen aan elkaar hangen.
-
V07
Welke kenmerken tonen we per categorie, en op welke filteren bezoekers?
Voor wapens ligt een voorstel klaar: kaliber, werking, capaciteit, looplengte, discipline en meer. Voor optiek, holsters, lampen en de andere categorieën nog niet.
-
V08
Eerst beslissen
Welke wettelijke informatie tonen we per product, en wie vult ze in?
Vergunningsplichtig of vrij verkrijgbaar, de categorie op de sportschutterslicentie (A tot E), en of een schutter het wapen koopt op vertoon van zijn licentie of eerst een vergunning moet aanvragen. Laders zijn ook vergunningsplichtig. De handelaar draagt de verantwoordelijkheid, dus hij vult dit in of keurt het goed. Gelden dezelfde licentiecategorieën voor Franstalige schutters?
-
V09
Wie levert foto’s, beschrijvingen en specificaties, en in welk formaat?
De invoerders, de leveranciers of de winkel zelf, als spreadsheet of als leverancierslijst. Dat bepaalt hoe de bulkimport werkt.
-
V10
Welk kassa- of voorraadsysteem gebruikt de winkel?
Een latere koppeling vraagt dat elk product ook zijn nummer uit dat systeem bewaart. Dat kunnen we nu al voorzien.
Talen en inhoud
-
V11
Welke talen bij de lancering, en welke is de standaardtaal?
Het design system gaat uit van Nederlands, Frans en Engels. Vertalen we automatisch en lezen we na, of vertaalt iemand alles zelf?
-
V12
Welke infopagina’s en wettelijke vermeldingen komen er, en wie schrijft ze?
Handelsnaam, erkenningsnummer, ondernemingsnummer, adres en openingsuren. Daarnaast de teksten over leeftijd, licenties en documenten, die de handelaar nakijkt voor ze online komen.
Aanvragen en beheer
-
V13
Welke gegevens vragen we bij een aanvraag, en hoelang bewaren we ze?
Voorstel: naam, e-mail, telefoon, contactvoorkeur en de vraag, en nooit gegevens over licentie of wapenbezit. Een datalek zou anders tonen wie waar wapens heeft. De bewaartermijn ligt nog niet vast.
-
V14
Hoe plannen we een winkelbezoek?
Stelt de klant vrij een moment voor, of kiest hij uit vaste tijdsloten? Wie behandelt de aanvragen, en wie krijgt een melding als er een binnenkomt?
-
V15
Wie werkt in het beheer, en wie mag wat?
Bijvoorbeeld producten beheren, aanvragen behandelen, inhoud aanpassen en instellingen wijzigen. Volstaat één rol voor iedereen, of zijn er meerdere?
Wettelijke punten om te bevestigen
De handelaar kent de wapenwet en zijn plichten als erkend handelaar. Deze punten overlopen we met hem voor de lancering: online verkoop van niet-wapens (V01), prijzen online (V02), de wettelijke informatie per product en de grens tussen wapen en niet-wapen (V08), en de teksten over leeftijd, licenties en documenten (V12). De wettelijke verwijzingen in dit overzicht komen uit het projectoverzicht van 14 november 2026. Dit overzicht is geen juridisch advies.