Vloer-configurator — Werking

1. Klant-flow (5 secties)

De vloer-configurator doorloopt 5 logische secties per ruimte:

2. Vloer-keuze (sectie 3)

Sectie 3 toont een filter-paneel + zoek-modal voor de 3.260 vloer-producten uit Zoho (hoofdcategorie Vloeren).

Filter-chips

• Materiaal: PVC / Hout / Laminaat
• Installatie: Zwevend / Lijm (alleen voor PVC + Hout — Laminaat is altijd zwevend)
• Patroon: Rechte stroken / Visgraat / Walvisgraat / Hongaarse punt / Plank / Tegel / etc.
• Geïntegreerde ondervloer: Ja / Nee (alleen bij PVC + Zwevend — Zoho-veld Ge_ntegreerde_ondervloer)
• Zoek-input: vrije tekst op productnaam of code

Gekozen-vloer-strip

Toont per gekozen vloer een groene card met:

• Productnaam + code + prijs/eenheid
• Chips: Installatie, Patroon, Merk, Geïntegreerde ondervloer (alleen PVC zwevend)
• Uitvouwbaar Productdetails-paneel met 3 secties: Vloerdetails (Merk, Pakgrootte, V-groeven, FSC, etc.), Uiterlijk/Afwerking (Kleur, Trends), Afmetingen/Gewichten (Lengte/Breedte/Dikte in mm én cm, Snijverlies, Omrekenfactor)
• × verwijderen-knop — verwijdert ook automatisch alle gerelateerde leg-services

3. Basisvloer-picklist (Zoho + lokaal)

De ruimte-info-veld Basisvloer (huidige ondergrond) komt overeen met het Zoho-veld Basisvloer_2 (label Basisvloer — voorheen Basisvloer/Jumpax; api_name is ongewijzigd zodat zoho-pull-catalog.mjs en COQL-queries blijven werken). De lokale enum BASISVLOEREN in shared/ruimte.js is de bron van de chips/pop-up. Niet elke historische Zoho-waarde staat lokaal — afgewerkte vloeren en niet-fysieke values zijn weggewerkt zodat verkoper alleen werkbare ondergronden ziet.

Synchronisatie met Zoho: node tools/zoho-prune-basisvloer.mjs --apply doet één gecombineerde PATCH op field-id 728921000019490991:

• hernoemt het field-label naar Basisvloer
• verwijdert de hierboven gemarkeerde picklist-waardes
• laat api_name Basisvloer_2 ongewijzigd → alle app-integraties (Vercel-build, products.json-normalisatie, COQL) blijven naadloos werken

State-migratie cleant oude localStorage-arrays automatisch via BASISVLOEREN.includes(v)-filter; de r.basisvloerM2-map wordt op load van onbekende keys ontdaan.

4. Records-systeem

Alle leg-services, plinten, profielen en accessoires worden beheerd via tools/voorbereiden_user_spec.tsv. De generator tools/generate-voorbereiden.py bouwt hieruit configurators/vloer/data/voorbereiden.json; tools/regen-hardcoded.py concateneert de JSON-bestanden tot service-regels-hardcoded.js (instant-load in browser).

Verplicht-niveaus

Filter-attributen (alle records)

5. Chain-mechanismen

conditioneelOp — vervolg-keuze

Een record met conditioneelOp=X verschijnt alleen wanneer een record met productCode X (case-insensitive) al in de selectie staat. Multi-value (semicolon-separated) betekent: één van de parents moet aanwezig zijn. Gebruikt voor:

• leg-egaliseren + 9 vervolg-records (Leg-6mmegaliseren, Leg-carbonprimer, leg-fermacell-ega, etc.)
• leg-laminaat + 7 ondervloer-keuzes (Set A bij VVE+VV, Set B bij geen VV+geen VVE)
• Leg-zwevendhout + 7 ondervloer-keuzes
• leg-platteplint + 162 platte-plint-keuzes
• Leg-massieve-plint + 45 deklijst-keuzes
• leg-hogeplint + 28 hoge-plint-keuzes
• Leg-profiel + 62 profiel-keuzes (zie §6 multi-keuze)
• Leg-pvcbies + 2 voegstrip-keuzes (kit-kokers)
• Leg-afkithogeplint + KC25 290261-chain (Aanbevolen — auto-toegevoegd bij leg-hogeplint; klant kan opt-outen via Verwijder-knop. Uitzondering: bij zwarte plinten (RAL 9005) wordt deze regel onderdrukt — de witte kit zou een lelijke contrastrand geven)
• Leg-afkitvloer + KC25 100325-chain
• Verstek (twee varianten): Leg-binnenhoekverste Verplicht met conditioneelOp = 28 ronde-bovenkant-plinten (koloniale/eigentijdse/romantische/barok/renaissance), én Optioneel-variant met conditioneelOp = 95 rechte plinten. Same-productCode dedupe zorgt dat alleen één in de cart komt.
• Leg-dichtzet-vlrvrwa heeft 3-staps matrix per aanleggenVerwarming (alleen bij typeVerwarming=Gefreesd):
  • LAB21 (VOORBEREIDEN-11009) — Verplicht, auto-add. LAB21 freest zelf en dicht de freesgangen verplicht zelf af.
  • Klant (VOORBEREIDEN-11010) — Optioneel. Klant/3e partij heeft VV ingefreesd; LAB21 kan op verzoek dichtzetten. Verkoper voegt expliciet toe via "Toevoegen"-card in de Voorbereiden-tab.
  • Bestaand — geen record fires. Bestaande VV is al gedicht; niets te doen.

chainProduct — auto-add vervolgartikel

Wanneer een record een chainProduct=productCode heeft, wordt dat product (uit Zoho Products) als keuzeproductRef opgeslagen. Bij selectie van het parent-record wordt het chain-product automatisch toegevoegd via syncVerplichteSelecties. Voorbeelden:

• Leg-laminaatvisgraat → 91632 (Parketman D3 nadenlijm)
• Set B ondervloeren (4905112319, 865612) → 861202 (vochtwerende folie)
• Klik-PVC 4944250419 → 861202
• Laminaat-Set B chain → 861202

bronVoorAantal — afgeleid aantal

Records met bronVoorAantal=parent-productCode krijgen hun aantal afgeleid van het parent-record via een formule:

Formule per maten-type:

• m¹ / m²: aantal = ceil(bron × snijfactor / pakLengte) × pakLengte (resultaat in m¹/m², afgerond naar veelvoud van pakLengte)
• Stuk / Koker / Bus: aantal = max(1, ceil(bron × snijfactor / pakLengte)) (resultaat in stuks)

Voorbeelden:

• Plint bij leg-hogeplint=25m¹: ceil(25 × 1.10 / 2.4) × 2.4 = 28.8 m¹ = 12 stuks à 2.4m
• Kit KC25 bij Leg-afkitvloer=50m¹: max(1, ceil(50 × 1 / 20)) = 3 bussen
• Voegstrip 419210 bij Leg-pvcbies=100m¹: max(1, ceil(100 × 1 / 75.55)) = 2 kokers

6. Multi-keuze (profielen)

Standaard hebben Keuze-groepen radio-gedrag: één keuze per parent (één plint, één ondervloer). Voor parents in MULTI_KEUZE_PARENTS mag de klant meerdere kinderen tegelijk kiezen, elk met eigen aantal. Geldt nu voor:

• Leg-profiel — klant geeft eerst een totaal-aantal op via het Leg-profiel parent-record (bv. 5 profielen), opent dan de "Kies profiel"-modal en kiest 2× profiel A + 3× profiel B.

Limiet: som ≤ parent-aantal

Het totaal-aantal op het parent-record (Leg-profiel) is de bovengrens voor de som van de gekozen kinderen. De modal toont een live "X van Y profielen toegewezen"-banner; bij overschrijding kleurt deze rood. ± knoppen per rij + aantal-input klemmen automatisch op het resterende budget. Aantal op 0 zetten verwijdert de regel.

Default-aantal bij multi-keuze

Bij een nieuwe kind-pick is het default-aantal parent_aantal − reeds_gebruikt (niet de volledige suggestAantal). Voorkomt dat een tweede profiel-keuze direct de limiet overschrijdt.

7. Fysieke producten vs services

Het order-overzicht onderscheidt twee buckets: Producten (fysieke SKU's die LAB21 inkoopt en levert) en Service (leg-arbeid, voorbereiding, verwijderen). De helper isFysiekProduct(art) bepaalt waar een regel verschijnt:

Plinten en kit-bussen hebben in Zoho hoofdcategorie=Diensten (legacy) maar zijn fysieke producten — de helper corrigeert dit op basis van het parent-record dat de leg-arbeid representeert.

8. Hoge-plint sub-flow (afkit + verstek)

De hoge-plint sub-flow heeft drie gerelateerde diensten:

Leg-hogeplint (Optioneel) — leg-arbeid

Klant kiest m¹ in te leggen plint. Verschijnt onder Voorbereiden samen met "Kies hoge plint"-knop (opent de keuze-modal voor de child-plint SKU). Hoge-plint modal heeft een filter-funnel: hoogte (70/90/120/150 mm) → dikte (12/15/18 mm) → kleur → variant (Standaard / Geluidreducerend met uitsparing).

Leg-afkithogeplint (Aanbevolen) — afkit-arbeid

Wordt automatisch toegevoegd aan het order-overzicht zodra leg-hogeplint in de selectie van een ruimte staat. Triggert KC25 290261 (witte acrylaatkit) als Verplicht-vervolgrecord (1 bus per 20 m¹). Klant kan opt-outen via de Verwijder-knop in sectie 6 — keuze wordt onthouden per ruimte (optedOutByRuimte) zodat een wijziging in plint-keuze niet de opt-out resette.

Leg-binnenhoekverste (twee varianten) — verstek-zagen

Vervolg-dienst die wordt getriggerd door de gekozen plint-SKU (niet door de parent leg-hogeplint). Twee records met dezelfde productCode, verschillende verplicht-status:

• Verplicht (VOORBEREIDEN-11387) — 28 plinten met ronde bovenkant (koloniale 16002-16014, eigentijdse 16015-16051, romantische 16053/16055, barok 16060/16062, renaissance 16066/16068/16069, massieve 11812). Wordt auto-toegevoegd zodra een van deze plint-codes in de selectie staat.
• Optioneel (VOORBEREIDEN-11394) — 95 rechte plinten (moderne 15924-15980, tijdloze 16089-16097, etc.). Verschijnt als toevoegbare card; verkoper voegt toe wanneer klant verstek-binnenhoeken wil i.p.v. de standaard stoot-aansluiting.

De filterTab-dedupe op productCode zorgt dat slechts één variant tegelijk in de cart kan staan — bij een mix van Verplicht-plinten en Optioneel-plinten wint de Verplicht-variant.

Deurmat-sub-flow (multi-instance)

leg-deurmat is een Optioneel TSV-record met een eigen modal-flow: klant kiest kleur (702 BRUIN / 705 ZWART) + gewenste lengte/breedte in cm; systeem berekent welke XCX-mat (135 of 200 cm breed) + aantal 10cm-stroken. Een ruimte mag meerdere deurmat-instances bevatten — elk met eigen deurmatInstanceId, eigen kleur/maat-config en eigen mat-chain. De deurmat-card toont per instance een eigen "Geconfigureerd"-blok met Wijzigen-/Verwijderen-knoppen, plus een "➕ Extra deurmat toevoegen"-knop voor nieuwe instances. Chain-cleanup is instance-aware: bij verwijderen van leg-deurmat-instance X gaat alleen de mat-sel met dezelfde instanceId mee — andere instances in dezelfde ruimte blijven bestaan.

9. Order-overzicht

Het rechter-paneel (sticky) toont een live order-overzicht per ruimte:

Klant kan vloer-producten verwijderen via × in de Producten-rij. Bij verwijdering worden alle gerelateerde leg-services en chain-records automatisch ook weggehaald (syncVerplichteSelecties fase 1 verwijdert records die niet meer applicable zijn).

Verwijder-knoppen op elke regel

Naast de × op vloer-producten (Producten-tabel) heeft elke Service-rij ook een eigen ×-knop rechts naast het regel-totaal. Tooltip onderscheidt drie scenario's:

• Verplicht — record wordt verwijderd, maar syncVerplichteSelecties zet hem direct terug zodra de bron-keuze nog van toepassing is.
• Aanbevolen — record wordt verwijderd én de code wordt opgenomen in optedOutByRuimte[ruimteId]. Geen automatische terugkeer; sync respecteert de opt-out tot ruimte-context wijzigt.
• Optioneel — gewone verwijdering, geen tracking nodig.

De data-rm event-handler triggert het Aanbevolen-opt-out spoor algemeen — vroeger werd dat alleen voor autoBinnenbreng (Etage-X) en autoDroogbouw getrackt, waardoor records zoals Leg-afkithogeplint na verwijdering direct terugkwamen.

Cascade-strip bij multi-niveau chains

Fase 1 van syncVerplichteSelecties draait in een fixed-point loop (max 10 iteraties) tot er geen records meer worden verwijderd. Voor ketens als leg-hogeplint → Leg-afkithogeplint → KC25 290261 verwijdert één pass alleen het directe kind van het verwijderde parent-record; de tweede pass haalt het kleinkind ook weg. Voorkomt wees-records in de cart.

Reset-dropdown (sticky onderaan)

De Reset-knop in het order-overzicht is een dropdown met 5 opties — elke vraagt eerst bevestiging:

• Alleen ruimtes leeghalen — wist Ruimte.LS_KEY + per-ruimte maps (selecties/opt-outs/optTabs); reload.
• Alleen orderregels wissen — leegt selectiesByRuimte + optedOutByRuimte + verzendkosten-keuze; geen reload. Verplicht/Aanbevolen records komen via sync direct terug.
• Alleen vloer-keuze wissen — strijdt records met hoofdcategorie=Vloeren + servicetype=Product; sync-engine ruimt de bijbehorende leg-services automatisch op.
• Alleen klant/order-info leeghalen — state.orderInfo = {} + OrderInfo.clear() + legacy keys; ruimtes en orderregels blijven.
• Alles wissen (rood) — volledige localStorage-wipe + reload.

Ruimte verwijderen — purgeRuimteState

Wanneer de gebruiker een ruimte verwijdert (× in de switcher), roept Ruimte.remove() de nieuwe onRemove(id)-callback aan vóór de blank-fallback. De vloer-app bindt daaraan purgeRuimteState(id) die selectiesByRuimte[id], optTabsByRuimte[id] en optedOutByRuimte[id] wist. Voorheen erfden nieuwe blank-ruimtes met dezelfde id (Ruimte.blank(1) bij lege lijst) de orderregels van de zojuist verwijderde — die bug is opgelost.

Per-stuk-display voor plinten en profielen

Voor records met pakLengte én maten in m¹/m² toont formatAantalStuks() de aantal-cel als "5 stuks à 2,4m (12 m¹)". Achter de schermen blijft aantal opgeslagen in m¹ (zodat regelPrijs blijft kloppen).

Dynamische aantallen — m² volgt ruimte-attributen

De §1b-loop in syncVerplichteSelecties herrekent het aantal van bepaalde records bij elke render, zodat ze meebewegen met de ruimte-state:

Het VV-m²-veld verschijnt in de Ruimte-info-card zodra Aanleggen vloerverwarming = LAB21 wordt gekozen, met prefill = r.m2. Klant kan het naar beneden bijstellen wanneer VV maar een deel van de ruimte bedekt; de ega- en dichtzet-aantallen zakken automatisch mee bij iedere wijziging (notify → renderAll → §1b).

Invariant: r.vloerverwarmingM2 ≤ r.m2 — VV-m² mag nooit groter zijn dan de basisvloer-m² van dezelfde ruimte. clampVloerverwarmingM2() in shared/ruimte.js klemt de waarde stilletjes naar boven af bij elke mutatie (input-onchange, Ruimte.update(), lengte/breedte-recompute). De input heeft ook een max="${r.m2}"-attribuut voor browser-level feedback.

Transport / Bezorging / Afhalen

De order kent drie transport-niveaus, gestuurd door het order-info-veld Levering (Bezorging default / Afhalen Amersfoort) en automatisch ge-dedupliceerd:

• Order-niveau bezorging — Bgbezorging (€400, BG-bezorging) of Etage1/2/3-levering (€500/600/700 bij geen lift + hogere verdieping). Auto-toegevoegd via syncBinnenbrengenSelecties in de hoogste-verdieping-ruimte zodra LAB21 ergens de vloer legt en Levering = Bezorging.
• Order-niveau afhalen — AfhAfoort (€0, marker-record voor "klant haalt zelf op in Amersfoort"). Auto-toegevoegd zodra Levering met "Afhalen" begint; vervangt Bgbezorging/Etage-X volledig.
• Per-vloer transport — TP (Transport PVC/Laminaat €100) / TH (Transport hout €130) / TPL (Verzendkosten Randafwerking €40). Komen op de proppen bij specifieke vloer-types als Optioneel/Verplicht.

Dedupe-regels (in syncBinnenbrengenSelecties + isArticleApplicable):

• Bgbezorging / Etage-X in één ruimte → TP / TH / TPL geblokkeerd op de hele order.
• Levering = Afhalen Amersfoort → TP / TH / TPL geblokkeerd (klant regelt zelf transport).
• Klant kan via renderOrderInfo tussen Bezorging ⇄ Afhalen schakelen; bij iedere wisseling worden transport-/afhaal-opt-outs gereset zodat de keuze schoon kan binden (geen sticky lock-in).
• Bgbezorging × verwijderen blijft sticky (optedOutByRuimte); TP/TH klappen dan terug in via de standaard applicable-check.

Chain-protect: 861202 / Xcx170123 onder Jumpax

Jumpax-keuzes (86564/86568/86576) chain via keuzeproductRef naar een pair-product (861202 vochtwerende folie of Xcx170123 Allround 10DB). Die pair-products hebben vloerType=["Ondervloeren"] dat niet matcht met PVC/Hout/Laminaat — zonder bescherming zou Phase 1 van syncVerplichteSelecties ze direct verwijderen. De Phase 1-loop heeft daarom een chain-protect: een sel met autoFromCode blijft staan zolang het parent-record (de Jumpax-Keuze) nog in sels zit. Zodra de parent wordt weggehaald (bv. radio-clear bij een andere Jumpax-keuze), ruimt pickArtikel de chain via de bestaande autoFromCode-cleanup automatisch op.

Order-niveau verzendkosten (sectie 5)

Verzendkosten worden order-breed gekozen via een card bovenaan sectie 5. De card verschijnt pas wanneer álle ruimtes m² hebben ingevuld. Default-keuze is Binnenbrengservice — wordt automatisch ingesteld als klant nog geen keuze maakte.

• Afhaal — géén transport-record; alle bestaande TP/Etage-records (auto én handmatig) worden geschrapt.
• Standaard verzendkosten — 1× TP-record (€100) op de eerste ruimte met autoVerzendkosten=true.
• Binnenbrengservice — 1× transport-record. Altijd beschikbaar, default-keuze. pickBinnenbrengenEtage() bepaalt het record op basis van Lift + orderInfo.aantalVerdiepingen:
  • Lift = Ja → Bgbezorging (€400), ongeacht aantal verdiepingen.
  • Lift = Nee, aantal verdiepingen = 1 → Bgbezorging (€400).
  • Lift = Nee, aantal verdiepingen = 2 → Etage1-levering (€500).
  • Lift = Nee, aantal verdiepingen = 3 → Etage2-levering (€600).
  • Lift = Nee, aantal verdiepingen = 4 → Etage3-levering (€700).
  • Lift = Nee, aantal verdiepingen ≥ 5 → geen standaard-record; UI toont melding "Wij hebben geen standaardservice voor deze situatie, indien nodig vragen wij een speciale service voor u aan."
  Bestaande TP/Bg/Etage-records worden bij elke wisseling van keuze of bron-signaal automatisch opgeschoond.

Engine-functie: syncVerzendkostenOrder(). State: state.orderInfo.verzendkosten. Eenmalige migratie vanuit per-ruimte r.verzendkosten via migrateVerzendkostenToOrderLevel() tijdens init — kiest de meest-voorkomende waarde over alle ruimtes en zet de oude per-ruimte velden leeg.

10. Advies-banners

Banner-waarschuwingen voor onuitvoerbare combinaties (geen orderregels — alleen advies):

11. Canonieke scenario's (regressie-checklist)

De auto-add-cases hieronder vormen de regressie-checklist voor de Voorbereiden-flow. Alle basis-criteria zijn: Subcategorie = PVC · Installatie = Gelijmd · Uitvoering leggen = LAB21 · Type VV = Geen · VVE met onderburen = Nee. De basisvloer-keuze bepaalt vervolgens welke voorbewerking-services extra worden aangezet. Verandert één van de basis-criteria (bv. Zwevend i.p.v. Gelijmd) → géén van de Voorbereiden-records firet, en de orderlijst bevat enkel de gekozen vloer + transport.

Andere automatische gedragingen

12. Vloeren order samenstellen records (auto-gegenereerd)

Onderstaande tabel wordt automatisch gegenereerd uit configurators/vloer/data/voorbereiden.json via tools/gen-werking-table.py. Filter-condities die op Alle staan worden niet getoond.