Documentatie

HANDLEIDING

Navigatie & structuur

De applicatie bestaat uit vier hoofdtabbladen, bereikbaar via de zwarte navigatiebalk bovenin het scherm:

Tab	Doel
Dashboard	Overzicht van alle weken — snel zien welke weken een planning hebben en doorklikken naar de weekplanning.
Weekplanning	Per week de bestellingen per klant per brood per dag invoeren en beheren.
Productielijst	Per draaidag berekenen hoeveel broden en ingrediënten nodig zijn, en na productie de werkelijke aantallen vastleggen voor SKAL-administratie.
Beheer & Settings	Stamdata onderhouden: klanten, broden, ingrediënten, recepturen, weekschema en productieschema.

Hoe de onderdelen samenhangen Alles begint bij Beheer: daar leg je klanten, broden, ingrediënten en recepturen vast. Het weekschema bepaalt de standaardbestellingen die automatisch worden ingeladen wanneer je een nieuwe weekplanning activeert. Het productieschema bepaalt welke broden op welke draaidag worden gedraaid. De weekplanning bevat de werkelijke aantallen per week. En de productielijst combineert het productieschema met de weekplanning om te berekenen hoeveel van elk brood en elke ingrediënt nodig is.

Data opslaan & synchroniseren

De applicatie werkt met twee lagen van opslag:

Lokale opslag (automatisch)

Elke wijziging die je maakt wordt automatisch lokaal opgeslagen in je browser. Dit betekent dat je data niet kwijtraakt als je per ongeluk de pagina herlaadt. De lokale opslagtijd is zichtbaar rechtsboven in de navigatiebalk onder "Saved Locally".

Cloud opslag (handmatig)

Om je data definitief op te slaan en te synchroniseren met de server, klik je op de groene SAVE ALL knop rechtsboven. Dit stuurt alle data naar de cloud en ontvangt de meest recente versie terug. De cloudopslagtijd verschijnt onder "Saved in Cloud".

Belangrijk Lokale opslag is tijdelijk — als je je browsercache leegt, gaat lokale data verloren. Klik daarom regelmatig op SAVE ALL om je werk veilig in de cloud op te slaan.

Twee-kolommen weekoverzicht

Het dashboard toont een overzicht van alle weken, gesplitst in twee kolommen:

Kolom	Inhoud
Links: Afgelopen weken	Historische maanden, standaard ingeklapt. Handig voor het terugkijken naar eerdere weekplanningen, facturen of SKAL-controle.
Rechts: Huidig & Komend	De huidige maand (standaard opengeklapt) en toekomstige maanden (standaard dichtgeklapt). De huidige week is direct zichtbaar.

Maandaccordeons

De weken zijn gegroepeerd per maand in zwarte accordeonbalken. Klik op een maandheader om die maand open of dicht te klappen. Historische maanden zijn iets lichter en tonen het label "historie" om ze visueel te onderscheiden van actieve maanden.

Weekkaarten & statussen

Elke week wordt getoond als een kaart met het weeknummer, de datumrange en een status:

Status	Betekenis
Niet Gestart	Er is nog geen weekplanning aangemaakt. De standaardbestellingen uit het weekschema zijn nog niet geladen.
In Planning	De weekplanning is geactiveerd en bevat actieve bestellingen.

De huidige week heeft een oranje rand en een ▸ Nu label, zodat je hem direct herkent.

Navigeren naar weekplanning

Klik op een weekkaart om direct naar de weekplanning voor die week te gaan. De planningsmatrix wordt dan geladen met de bestellingen voor die specifieke week.

Tip Gebruik het dashboard als startpunt van je dagelijkse workflow: open de huidige week, controleer de bestellingen, en navigeer vervolgens naar de productielijst voor de draaidag van vandaag.

Week selecteren & navigeren

In de weekplanning zie je bovenaan het weeknummer en de datumrange. Met de pijltjesknopen (❮ en ❯) navigeer je naar de vorige of volgende week. Je kunt ook via het dashboard een specifieke week openen.

Week activeren

Wanneer je een week opent die nog niet geactiveerd is, zie je een lege state met een knop om de week te starten. Bij het activeren worden automatisch de standaardbestellingen uit het weekschema (Beheer → Weekschema) ingeladen als startpunt.

Relatie met weekschema Het weekschema fungeert als template. Zodra je een week activeert, worden de standaardwaarden gekopieerd naar die specifieke week. Wijzigingen in de weekplanning hebben geen effect op het weekschema, en andersom. Als je het weekschema wijzigt en een bestaande weekplanning wilt bijwerken, moet je de week opnieuw activeren — maar let op: dit overschrijft eventuele handmatige aanpassingen die je al had gemaakt.

De planningsmatrix

De planningsmatrix is een tabel met:

As	Inhoud
Rijen (verticaal)	Alle actieve klanten, gesorteerd op hun volgorde uit Beheer → Klanten.
Kolommen (horizontaal)	Per actief brood zes dagkolommen: MA, DI, WO, DO, VR, ZA. De broden zijn gesorteerd op hun volgorde uit Beheer → Broden.
Cellen	Het aantal broden dat die klant op die dag van dat broodtype bestelt.

De klantnaam links en de broodnamen bovenaan zijn "sticky" — ze blijven zichtbaar als je door de tabel scrollt. Bij het klikken op een cel worden de klantnaam en dagheader gehighlight, zodat je altijd ziet waar je bent.

Aantallen invoeren

Klik op een cel en typ het gewenste aantal. Het veld accepteert alleen cijfers. Lege cellen of de waarde 0 betekenen: geen bestelling. Elke wijziging wordt direct lokaal opgeslagen. Vergeet niet om op SAVE ALL te klikken om de wijzigingen naar de cloud te sturen.

Weekoverzicht & accordeons

Bij het openen van de Productielijst-tab zie je een overzicht van de afgelopen 3 weken, de huidige week en de komende week. Elke week is een zwarte accordeonbalk die je kunt open- en dichklappen.

In de accordeonheader zie je rechts vijf stippen die de draaidagen maandag t/m vrijdag vertegenwoordigen:

Stip	Betekenis
Grijs	Niet gestart — er is nog geen productielijst aangemaakt voor deze dag.
Oranje	Aangemaakt — er is een productielijst gegenereerd, maar deze is nog niet definitief.
Groen	Afgerond — de productielijst is definitief afgetikt.

Dagen die in het productieschema niet als draaidag zijn ingesteld, worden vervaagd weergegeven en zijn niet klikbaar.

Klap een week open om de vijf dagkaarten te zien. Klik op een dagkaart om de detail-view voor die draaidag te openen.

Statussen

Elke productielijst doorloopt drie statussen:

Niet gestart → Aangemaakt → Afgerond

Niet gestart: Er is nog geen productielijst. Je kunt er een aanmaken door op "Maak Productielijst" te klikken.

Aangemaakt: De productielijst is gegenereerd. Je kunt aantallen invullen, THT-datums aanpassen, handmatige broden toevoegen, en de Excel downloaden. De lijst kan op dit moment nog opnieuw gegenereerd worden.

Afgerond: De productielijst is definitief. Alle velden zijn read-only. De lijst kan niet meer worden gewijzigd of opnieuw gegenereerd. Dit is de eindstatus voor SKAL-compliance.

Productielijst aanmaken

Wanneer je een draaidag opent die nog geen productielijst heeft, klik je op "Maak Productielijst". Het systeem doet dan het volgende:

1. Het zoekt in het productieschema welke broden een draaidag (DR) hebben op de geselecteerde dag.

2. Per brood worden de bakdagen (BA) opgezocht — de dagen waarop dat brood gebakken en uitgeleverd wordt.

3. Voor elke bakdag worden de aantallen uit de weekplanning opgeteld over alle klanten.

4. De recepturen worden geladen en de ingrediënten worden berekend op basis van het totaal aantal broden.

5. De actuele THT-datums uit de ingrediëntenlijst worden als snapshot overgenomen.

Voorbeeld Biobrood heeft draaidag woensdag (DR=WO) en bakdagen donderdag en vrijdag (BA=DO,VR). In de weekplanning staat voor donderdag 10 biobroden en voor vrijdag 20 biobroden. De productielijst toont dan 30 biobroden, met de ingrediënten berekend op basis van 30 × het recept.

Automatische broden

De broden die automatisch verschijnen op basis van het productieschema staan in de linkerkolom onder "Productieschema — automatisch". Deze broden en hun aantallen worden berekend uit de weekplanning en kunnen niet handmatig worden verwijderd — ze zijn gekoppeld aan het productieschema.

Handmatige broden toevoegen

In de rechterkolom onder "Overige — handmatig" kun je broden toevoegen die niet in het productieschema staan voor die draaidag. Dit is bedoeld voor onregelmatige producten zoals croissants of kaneelbroodjes die bijvoorbeeld één keer per drie weken worden gebakken.

Klik op "+ Toevoegen" om een modal te openen. Selecteer het gewenste brood (alleen broden die nog niet in de lijst staan verschijnen) en vul het aantal in. De ingrediënten worden automatisch berekend op basis van het recept.

Je kunt het aantal later aanpassen door op het stuks-veld in de zwarte header te klikken, of het brood verwijderen met de ✕ knop.

Ingrediëntenberekening & THT

Klap een broodkaart open om de ingrediënttabel te zien. Elke ingrediënt toont:

Kolom	Uitleg
Ingrediënt	De naam van het ingrediënt, gesorteerd op de volgorde (#) uit het recept. Als een brood meerdere onderdelen heeft (bijv. Deeg + Vulling), worden deze gegroepeerd met een oranje koptekst.
Per brood	De hoeveelheid van dit ingrediënt die nodig is per brood, zoals vastgelegd in het recept.
THT	De houdbaarheidsdatum van het ingrediënt. Deze wordt automatisch overgenomen uit Beheer → Ingrediënten bij het genereren van de lijst. Je kunt de waarde hier ook handmatig aanpassen als er bijvoorbeeld een nieuwe zak is geopend. Een leeg THT-veld heeft een gele achtergrond als visuele herinnering.
Totaal	De totale hoeveelheid die nodig is = Per brood × Aantal broden. Dit wordt automatisch berekend.

THT als snapshot De THT-waarde die in de productielijst staat is een kopie (snapshot) van de waarde op het moment van genereren. Als je later de THT in Beheer → Ingrediënten aanpast, verandert dat niet de THT in eerder gegenereerde productielijsten. Dit is belangrijk voor SKAL-traceerbaarheid: elke productielijst legt vast welke THT-datums van toepassing waren op het moment van productie.

Productie-administratie

Klap een broodkaart open om de vier administratievelden te zien. Deze worden ingevuld na de productie om de werkelijke aantallen vast te leggen:

Veld	Betekenis
Productie	Het werkelijke aantal broden dat is geproduceerd. Dit kan afwijken van het geplande aantal.
Vriezer	Hoeveel broden er naar de vriezer zijn gegaan.
Verlies	Hoeveel broden er verloren zijn gegaan (mislukt, beschadigd, etc.).
Verkocht	Hoeveel broden er zijn verkocht of uitgeleverd.

Deze velden worden op broodniveau ingevuld (niet per ingrediënt). Elke wijziging wordt direct lokaal opgeslagen.

SKAL-validatie & statusbolletjes

In de zwarte header van elke broodkaart zie je drie kleine bolletjes, links van het aantal stuks. Deze geven in één oogopslag aan of de administratie voor dit brood compleet is:

Bolletje	Controle	Groen = OK wanneer
1e bolletje	Productie = Gepland	Het ingevulde productie-aantal is gelijk aan het berekende geplande aantal.
2e bolletje	SKAL-outflow	Productie = Vriezer + Verlies + Verkocht. Alle geproduceerde broden zijn verantwoord.
3e bolletje	THT compleet	Alle ingrediënten van dit brood hebben een ingevulde THT-datum.

Een grijs bolletje betekent dat de check nog niet van toepassing is (bijv. productie is nog niet ingevuld). Een groen bolletje betekent dat alles klopt.

Wanneer een check niet klopt, verschijnt er een waarschuwingsmelding direct onder de zwarte header, boven de invoervelden. Er zijn drie mogelijke meldingen:

● Productie (28) ≠ Vriezer + Verlies + Verkocht (26) — de outflow-aantallen tellen niet op tot het productie-aantal.

● Productie (28) wijkt af van gepland aantal (30) — er zijn meer of minder broden geproduceerd dan gepland.

● Niet alle THT-datums zijn ingevuld (3 ontbreekt) — sommige ingrediënten missen nog een THT-waarde.

Definitief maken

Wanneer alle aantallen zijn ingevuld en de administratie klopt, klik je op de groene knop "✓ Maak Definitief". Er verschijnt een bevestigingsdialoog. Na bevestiging wordt de productielijst vergrendeld:

— Alle invoervelden worden read-only.

— De knoppen "Maak Opnieuw", "Download Excel" en "+ Toevoegen" verdwijnen.

— Een groene banner toont "Deze productielijst is definitief afgerond".

— De dagstip in het weekoverzicht kleurt groen.

SKAL-compliance De definitieve status is cruciaal voor de SKAL-massabalans. Een afgeronde productielijst kan niet meer worden aangepast en dient als bewijs van de werkelijke productie, inclusief ingrediëntgebruik met THT-datums, productie-aantallen, verlies en verkoop.

Opnieuw genereren

Zolang een productielijst de status "Aangemaakt" heeft (nog niet definitief), kun je deze opnieuw genereren met de knop "↻ Maak Opnieuw". Dit is handig als je de weekplanning of het productieschema hebt aangepast en de productielijst wilt bijwerken.

Er verschijnt een waarschuwing: "Er bestaat al een productielijst voor WO in week 11. Weet je zeker dat je een nieuwe wilt draaien? De bestaande data wordt overschreven." Bij bevestiging worden alle eerder ingevulde aantallen (productie, vriezer, verlies, verkocht) en THT-waarden gewist en vervangen door de nieuwe berekening.

Excel export

Klik op "Download Excel" om een opgemaakt Excel-bestand te downloaden. Het bestand bevat per brood:

— Een zwarte titelbalk met de broodnaam en het totaal aantal stuks.

— Vier invulvelden voor Productie, Vriezer, Verlies en Verkocht (gele achtergrond in Excel).

— Een ingrediënttabel met Per brood, THT en Totaal kolommen.

— Ingrediënten gegroepeerd op onderdeel (Deeg, Vulling, etc.) als het recept meerdere onderdelen heeft.

Het bestand is ingesteld op liggend afdrukken (landscape) en past automatisch op de paginabreedte.

Weekschema

Het weekschema is een template voor wekelijkse bestellingen. Het bevat de standaardaantallen die elke klant normaal gesproken op elke dag bestelt. Het weekschema wordt gebruikt als startpunt wanneer je een nieuwe weekplanning activeert.

De matrix is identiek aan de weekplanning: rijen zijn klanten, kolommen zijn broden × dagen. Pas hier de standaardwaarden aan als een klant structureel meer of minder gaat bestellen.

Weekschema vs. Weekplanning Het weekschema is het "standaard" — wat elke week hetzelfde is. De weekplanning is het "werkelijke" — de specifieke aantallen voor die ene week. Wanneer je een weekplanning activeert maar vervolgens niet aanpast en weer verwijdert, worden wijzigingen in het weekschema weer zichtbaar bij de volgende activering. De weekplanning overschrijft het weekschema zodra deze is geactiveerd.

Productieschema

Het productieschema bepaalt het productieproces per brood: wanneer wordt het desem gemaakt, wanneer wordt er gedraaid, en op welke dagen wordt er gebakken? Dit schema is de motor achter de automatische productielijst.

Per brood kun je meerdere batches aanmaken. Elke batch heeft:

Veld	Betekenis
Brood	Het broodtype waarvoor deze batch geldt.
Batch	Een volgnummer (automatisch oplopend) om batches te onderscheiden als een brood meerdere batches per week heeft.
Draaien (DR)	De dag waarop het deeg wordt gedraaid. Dit is de draaidag die als trigger dient voor de productielijst.
Desem (DE)	Wordt automatisch berekend als de dag vóór de draaidag.
Bakken (BA)	De dag(en) waarop het brood wordt gebakken en uitgeleverd. Er kunnen meerdere bakdagen per batch zijn.

Relatie met productielijst Wanneer je op de productielijst-tab een draaidag selecteert, zoekt het systeem alle batches in dit schema waar DR overeenkomt met die dag. Per batch worden de bakdagen (BA) opgezocht, en voor elke bakdag worden de aantallen uit de weekplanning opgeteld. Dit geeft het totaal aantal broden dat geproduceerd moet worden.

Klanten

De klantentabel bevat alle afnemers. Alleen actieve klanten verschijnen in de weekplanning en het weekschema.

Kolom	Uitleg
Klantnaam	De naam van de klant, zoals weergegeven in de planningsmatrix.
Betaalwijze	Factuur, Kassa of Intern — bepaalt hoe de klant afrekent.
Prio	Vink aan als dit een prioriteitsklant is.
# (Sortering)	Bepaalt de volgorde waarin klanten verschijnen in de planningsmatrix. Lager nummer = hoger in de lijst.
Actief	Schakel uit om een klant te verbergen uit de planning zonder deze te verwijderen.

Broden

De brodentabel bevat alle broodtypen. Alleen actieve broden verschijnen in de weekplanning, het weekschema en de productielijst.

Kolom	Uitleg
Weergavenaam	De korte naam die in de planningsmatrix wordt gebruikt (bijv. "Boeren 800gr").
Volledige naam	De officiele naam die op de productielijst en in de Excel verschijnt (bijv. "Biologisch Boerenbrood 800gr").
# (Sortering)	Bepaalt de kolomvolgorde in de planningsmatrix.
Actief	Schakel uit om een brood te verbergen zonder te verwijderen.

Ingrediënten

Alle grondstoffen die in recepten worden gebruikt. Ingrediënten worden getoond in de receptureneditor en verschijnen in de productielijst bij de ingrediëntenberekening.

Kolom	Uitleg
Ingrediënt Naam	De naam van het ingrediënt (bijv. "BIO Tarwebloem").
Bio?	Vink aan als dit een biologisch ingrediënt is. Relevant voor SKAL-administratie.
THT	De actuele tenminste-houdbaar-tot datum van de momenteel geopende zak of bak. Dit is een vrij tekstveld — je kunt dus "18-01, 20-01" invullen als je uit meerdere zakken haalt. Bij het genereren van een productielijst wordt deze waarde als snapshot overgenomen naar de lijst.
Actief	Schakel uit om een ingrediënt te verbergen zonder te verwijderen.

THT bijhouden De THT-kolom in de ingrediëntenlijst bevat altijd de huidige waarde — de datum van de zak die nu open is. Zodra je een nieuwe zak opent, pas je de THT aan. Er is geen historie nodig op dit niveau, want de historie wordt automatisch vastgelegd in de productielijsten als snapshots.

Recepturen

Per brood leg je hier vast welke ingrediënten in welke hoeveelheden nodig zijn. De receptureneditor bestaat uit een broodlijst links en een detailweergave rechts.

Selecteer een brood in de lijst om het recept te zien en bewerken. Elke receptregel bevat:

Kolom	Uitleg
Onderdeel	Tot welk onderdeel dit ingrediënt behoort: Deeg, Vulling, Zoete Starter of Tangzhong. In de productielijst worden ingrediënten gegroepeerd per onderdeel als er meerdere onderdelen zijn.
Ingrediënt	Selecteer het ingrediënt uit de dropdown. Alleen ingrediënten die zijn aangemaakt in Beheer → Ingrediënten zijn beschikbaar.
Aantal	De hoeveelheid van dit ingrediënt die nodig is per brood.
Eenheid	De meeteenheid: gram, ml, tl (theelepel), el (eetlepel), stuks of %.
# (Volgorde)	Bepaalt de volgorde waarin ingrediënten worden getoond in de productielijst en de Excel export. Lager nummer = hoger in de lijst.
X (Verwijderen)	Klik om deze receptregel te verwijderen.

Relatie met productielijst Wanneer een productielijst wordt gegenereerd, worden de recepturen geladen en vermenigvuldigd met het totaal aantal broden. Als je later het recept wijzigt, heeft dit geen effect op eerder gegenereerde productielijsten — die bevatten een snapshot van het recept op het moment van genereren. Nieuwe productielijsten gebruiken wel het bijgewerkte recept.

Alles hangt samen De kracht van het systeem zit in de samenhang: Klanten en Broden vormen de assen van de weekplanning. Ingrediënten en Recepturen bepalen wat er nodig is per brood. Het Productieschema koppelt broden aan draai- en bakdagen. En de Weekplanning levert de werkelijke aantallen. De Productielijst brengt dit alles samen tot een concreet werkdocument voor de bakker.