Projectoverzicht · werkdocument Versie 18·11·26
[Voor het webshopteam]

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

  1. 18·11·26 · nu

    Huidige stap: Dit overzicht: wat we weten en wat nog open ligt.

  2. Open vragen

    Antwoorden van de handelaar en het team.

  3. ERD

    Het datamodel volledig uitgewerkt.

  4. Requirements

    De officiële lijst, goedgekeurd door de klant.

  5. 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.

[De naam]

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.

    Zie V11

  • F03

    Catalogus bladeren

    Categorieën en subcategorieën met productkaarten: foto, naam, wettelijke status, beschikbaarheid en de prijs of ‘Prijs op aanvraag’.

    Zie V03Zie V02

  • F04

    Zoeken

    Op merk, model, kaliber of trefwoord, met suggesties tijdens het typen.

  • F05

    Filteren

    Op merk, kaliber, discipline, wettelijke status, beschikbaarheid en nieuw of occasie. Er is geen filter of sortering op prijs.

    Zie V07Zie V05

  • F06

    Productfiche

    Foto’s, beschrijving, specificaties en de beschikbare uitvoeringen, met de wettelijke status en welke documenten de schutter nodig heeft.

    Zie V08Zie V06

  • F07

    Aanvraaglijst

    Producten verzamelen om in één keer naar prijs en beschikbaarheid te vragen. Dit is geen winkelmand: er wordt niets besteld of betaald.

    Zie V01

  • 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.

    Zie V13

  • F09

    Winkelbezoek aanvragen

    Een moment en een onderwerp voorstellen, bijvoorbeeld advies bij een eerste wapen.

    Zie V14

  • F10

    Infopagina’s

    Zo koopt u een wapen als sportschutter, welke documenten u nodig hebt, veilig opslaan en vervoeren, veelgestelde vragen en over ons.

    Zie V12

  • F11

    Contact en winkelinfo

    Adres, openingsuren, route en de wettelijk verplichte vermeldingen, zoals het erkennings- en ondernemingsnummer.

    Zie V12

Voor de winkel

8 functies
  • F12

    Productbeheer

    Producten aanmaken en wijzigen met foto’s, specificaties, uitvoeringen, categorie en merk. De wettelijke status is verplicht.

    Zie V06Zie V08

  • F13

    Vertalingen

    Per taal de naam, de beschrijving en de teksten voor zoekmachines. Automatisch vertaalde teksten blijven gemarkeerd tot iemand ze nagelezen heeft.

    Zie V11

  • 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.

    Zie V02

  • F15

    Bulkimport

    Productgegevens in één keer inladen uit een spreadsheet of een bestand van de leverancier.

    Zie V09

  • 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.

    Zie V15

  • F19

    Privacy

    Aanvragen worden na een ingestelde bewaartermijn automatisch anoniem gemaakt. Gegevens van een klant kunnen op vraag gewist worden.

    Zie V13

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.

    Zie V04

  • Online verkopen en betalen

    Enkel voor wat geen wapen is, als de winkel dat wil en de wet het toelaat.

    Zie V01

  • 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.

    Zie V14

  • Kassakoppeling en rapportering

    Beschikbaarheid automatisch overnemen, en cijfers over bekeken producten en aanvragen.

    Zie V10

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 entiteiten
  • Categorie

    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 entiteiten
  • Aanvraag

    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 entiteiten
  • Inhoudspagina

    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 vragen
  • Personalisatie

    Per model de opties, de toegelaten combinaties en de voorbeeldbeelden.

    Zie V04

  • Bestelling en betaling

    Winkelmand, bestelling, betaling en levering. Alleen nodig als de winkel niet-wapens online verkoopt.

    Zie V01

  • Klant

    Een klantaccount, alleen nodig bij accounts of online verkoop. Zonder account blijft een aanvraag op zichzelf staan.

    Zie V01

  • Kaliber en discipline

    Nu een specificatie. Als eigen entiteit kunnen we wapens, munitie en laders aan elkaar koppelen.

    Zie V07

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: regulation met vijf waarden in de DBML, en legalCategory met licenseCategories en isOnSportShooterList uit 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.

15 vragen

Aanbod en verkoop

  1. 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.

    Beslist door
    Ons
    Raakt
    ERDRequirementsWetgeving
  2. 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.

    Beslist door
    Ons
    Raakt
    RequirementsWetgeving
  3. 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.

    Beslist door
    Ons
    Raakt
    ERDRequirements
  4. 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?

    Beslist door
    Ons
    Raakt
    ERDRequirements
  5. 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.

    Beslist door
    Ons
    Raakt
    ERD

Producten en gegevens

  1. 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.

    Beslist door
    OnsTeam
    Raakt
    ERD
  2. 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.

    Beslist door
    OnsTeam
    Raakt
    ERDRequirements
  3. 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?

    Beslist door
    Ons
    Raakt
    ERDRequirementsWetgeving
  4. 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.

    Beslist door
    Ons
    Raakt
    Requirements
  5. 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.

    Beslist door
    Ons
    Raakt
    ERDRequirements

Talen en inhoud

  1. 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?

    Beslist door
    Ons
    Raakt
    Requirements
  2. 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.

    Beslist door
    Ons
    Raakt
    RequirementsWetgeving

Aanvragen en beheer

  1. 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.

    Beslist door
    Ons
    Raakt
    ERDRequirements
  2. 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?

    Beslist door
    Ons
    Raakt
    ERDRequirements
  3. 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?

    Beslist door
    Ons
    Raakt
    ERDRequirements