@flowselections/logistiek-engine 1.0.4 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/README.md +24 -24
  2. package/dist-lib/components/FloridayPushCard.d.ts +2 -0
  3. package/dist-lib/components/FloridayPushCard.d.ts.map +1 -0
  4. package/dist-lib/components/FloridayPushCard.js +32 -0
  5. package/dist-lib/components/PrintjobsCard.d.ts +2 -0
  6. package/dist-lib/components/PrintjobsCard.d.ts.map +1 -0
  7. package/dist-lib/components/PrintjobsCard.js +35 -0
  8. package/dist-lib/components/RegiePage.d.ts.map +1 -1
  9. package/dist-lib/components/RegiePage.js +3 -1
  10. package/dist-lib/hooks/useFloridayPushes.d.ts +20 -0
  11. package/dist-lib/hooks/useFloridayPushes.d.ts.map +1 -0
  12. package/dist-lib/hooks/useFloridayPushes.js +55 -0
  13. package/dist-lib/hooks/usePrintjobs.d.ts +19 -0
  14. package/dist-lib/hooks/usePrintjobs.d.ts.map +1 -0
  15. package/dist-lib/hooks/usePrintjobs.js +60 -0
  16. package/dist-lib/index.d.ts +3 -0
  17. package/dist-lib/index.d.ts.map +1 -1
  18. package/dist-lib/index.js +3 -0
  19. package/dist-lib/integrations/supabase/auth-middleware.d.ts +387 -1
  20. package/dist-lib/integrations/supabase/auth-middleware.d.ts.map +1 -1
  21. package/dist-lib/integrations/supabase/client.d.ts +387 -1
  22. package/dist-lib/integrations/supabase/client.d.ts.map +1 -1
  23. package/dist-lib/integrations/supabase/client.server.d.ts +387 -1
  24. package/dist-lib/integrations/supabase/client.server.d.ts.map +1 -1
  25. package/dist-lib/integrations/supabase/types.d.ts +388 -2
  26. package/dist-lib/integrations/supabase/types.d.ts.map +1 -1
  27. package/dist-lib/integrations/supabase/types.js +12 -1
  28. package/dist-lib/lib/floridayDocuments.functions.d.ts +1161 -3
  29. package/dist-lib/lib/floridayDocuments.functions.d.ts.map +1 -1
  30. package/dist-lib/lib/floridayPush.functions.d.ts +20689 -0
  31. package/dist-lib/lib/floridayPush.functions.d.ts.map +1 -0
  32. package/dist-lib/lib/floridayPush.functions.js +20 -0
  33. package/dist-lib/lib/floridayPush.server.d.ts +45 -0
  34. package/dist-lib/lib/floridayPush.server.d.ts.map +1 -0
  35. package/dist-lib/lib/floridayPush.server.js +219 -0
  36. package/dist-lib/lib/handlers/logistics-tick.server.d.ts.map +1 -1
  37. package/dist-lib/lib/handlers/logistics-tick.server.js +11 -0
  38. package/dist-lib/lib/loadCarrierPlanning.functions.d.ts +1940 -35
  39. package/dist-lib/lib/loadCarrierPlanning.functions.d.ts.map +1 -1
  40. package/dist-lib/lib/loadCarrierTaskSync.server.d.ts.map +1 -1
  41. package/dist-lib/lib/loadCarrierTaskSync.server.js +9 -0
  42. package/dist-lib/lib/logisticsRecalcJob.functions.d.ts +774 -2
  43. package/dist-lib/lib/logisticsRecalcJob.functions.d.ts.map +1 -1
  44. package/dist-lib/lib/logisticsRecalculate.functions.d.ts +387 -1
  45. package/dist-lib/lib/logisticsRecalculate.functions.d.ts.map +1 -1
  46. package/dist-lib/lib/modulePrompts.d.ts.map +1 -1
  47. package/dist-lib/lib/modulePrompts.js +949 -911
  48. package/package.json +2 -2
@@ -10,144 +10,144 @@ import { LOGISTICS_MODULES } from "./logisticsTasks";
10
10
  export const LOGISTICS_ENGINE_PROJECT_REF = "wieomvgjyxoerzndxnla";
11
11
  function sharedBlock(moduleKey) {
12
12
  const key = moduleKey === "<modulesleutel>" ? "<modulesleutel>" : moduleKey;
13
- return `Alle communicatie met de Logistics Engine loopt uitsluitend via de gedeelde
14
- Supabase-database. Je leest en schrijft gewoon tabellen met de bestaande
15
- Supabase-client van deze module (ingelogde gebruiker, RLS). Geen API-key,
16
- geen header, geen secret, geen edge function.
17
-
18
- Supabase project ref: ${LOGISTICS_ENGINE_PROJECT_REF}
19
- Client: import { supabase } from "../integrations/supabase/client"
20
-
21
- De Engine beslist alles over buffering, belading, picken, controle, printen en
22
- transport. Deze module voert alleen nog taken uit en beslist zelf niets meer.
23
-
24
- --- Gebeurtenis melden: RPC logistics_emit_event (idempotent) ---
25
- const { data } = await supabase.rpc("logistics_emit_event", {
26
- p_source_module: "${key}",
27
- p_event_type: "order.received", // of order.changed, stock.changed
28
- p_order_ref: "SO-12345",
29
- p_payload: {
30
- checkinAt: "2026-08-01T10:00:00Z",
31
- pickupAt: "2026-08-01T14:00:00Z",
32
- customerRef: "CUST-1",
33
- deliveryLocationRef: "LOC-1",
34
- bufferRef: null,
35
- loadCarriers: [{ type: "trolley", count: 3 }],
36
- ruleVersion: null, // optioneel: plan op een vastgelegde regelversie
37
- },
38
- p_strategy_id: null, // uuid van logistics_strategies indien bekend
39
- p_shadow: true,
40
- p_idempotency_key: "${key}:SO-12345:order.received:v1",
41
- });
42
- // data = { eventId, planRunId, status, duplicate }
43
- Geef ALTIJD een p_idempotency_key mee die uniek is per gebeurtenis. Stuur je
44
- dezelfde melding twee keer (retry, dubbele webhook), dan plant de Engine maar
45
- één keer en krijg je duplicate: true terug.
46
- De Engine pakt de rij direct op (status pending -> processed), plant de keten en
47
- zet plan_run_id en error terug op dezelfde rij.
48
-
49
- --- Taken ophalen: SELECT op public.logistics_tasks ---
50
- const { data } = await supabase
51
- .from("logistics_tasks")
52
- .select("*")
53
- .eq("owner_module", "${key}")
54
- .eq("status", "planned")
55
- .order("planned_start", { ascending: true });
56
- Kolommen: order_ref, buffer_ref, task_type, sequence, depends_on,
57
- planned_start, planned_end, due_at, status, shadow, payload, result,
58
- rule_version, claimed_by, claimed_at, error.
59
-
60
- Realtime kan gewoon met supabase.channel() op logistics_tasks (in useEffect,
61
- met removeChannel in de cleanup).
62
-
63
- --- Taak claimen: ALTIJD via RPC, nooit met een eigen UPDATE ---
64
- const { data: taak } = await supabase.rpc("logistics_claim_task", {
65
- p_task_id: taskId, p_worker: "station-3",
66
- });
67
- if (!taak) { /* al door iemand anders geclaimd */ }
68
-
69
- // of automatisch de eerstvolgende taak van deze module:
70
- const { data: volgende } = await supabase.rpc("logistics_claim_next_task", {
71
- p_owner_module: "${key}", p_worker: "station-3",
72
- });
73
-
74
- --- Taak afmelden: ook via RPC ---
75
- await supabase.rpc("logistics_complete_task", { p_task_id: taskId, p_result: { ... } });
76
- await supabase.rpc("logistics_fail_task", { p_task_id: taskId, p_error: "reden" });
77
-
78
- --- Order annuleren ---
79
- await supabase.rpc("logistics_emit_event", {
80
- p_source_module: "${key}",
81
- p_event_type: "order.cancelled",
82
- p_order_ref: "SO-12345",
83
- p_payload: { reason: "klant belde af" },
84
- p_idempotency_key: "${key}:SO-12345:cancel:v1",
85
- });
86
- Al afgeronde taken blijven staan. Annuleer nooit zelf met een eigen UPDATE.
87
-
88
- --- Order splitsen ---
89
- await supabase.rpc("logistics_emit_event", {
90
- p_source_module: "${key}",
91
- p_event_type: "order.split",
92
- p_order_ref: "SO-12345",
93
- p_payload: {
94
- checkinAt: "...", pickupAt: "...",
95
- children: [
96
- { orderRef: "SO-12345-A", loadCarriers: [{ type: "trolley", count: 1 }] },
97
- { orderRef: "SO-12345-B", loadCarriers: [{ type: "trolley", count: 2 }] },
98
- ],
99
- },
100
- p_idempotency_key: "${key}:SO-12345:split:v1",
101
- });
102
-
103
- --- Spoed / prioriteit ---
104
- await supabase.rpc("logistics_set_order_priority", {
105
- p_order_ref: "SO-12345", p_priority: 100,
106
- });
107
-
108
- --- Instellingen inzien (nooit zelf beslissen) ---
109
- public.logistics_strategies de logistieke strategieën
110
- public.logistics_rule_configs settings (jsonb) per strategie + current_version
111
- public.logistics_plan_runs momentopname van de instellingen per planronde
112
- Alleen lezen, en alleen om te tonen.
113
-
114
- Ladingdragers: trolley, danish_container, euro_rolcontainer, pallet, euro_pallet, loose
115
- Taakstatussen: planned, claimed, in_progress, done, skipped, cancelled,
116
- superseded, failed
117
-
118
- Eigenaarschap: meldingen, planruns en taken hebben een kolom user_id die de
119
- database automatisch vult met het ingelogde account.
120
-
121
- Start in schaduwmodus (shadow: true): eigen logica blijft draaien, Engine-taken
122
- worden alleen getoond en vergeleken. Elke taak draagt rule_version — een lopende
13
+ return `Alle communicatie met de Logistics Engine loopt uitsluitend via de gedeelde
14
+ Supabase-database. Je leest en schrijft gewoon tabellen met de bestaande
15
+ Supabase-client van deze module (ingelogde gebruiker, RLS). Geen API-key,
16
+ geen header, geen secret, geen edge function.
17
+
18
+ Supabase project ref: ${LOGISTICS_ENGINE_PROJECT_REF}
19
+ Client: import { supabase } from "../integrations/supabase/client"
20
+
21
+ De Engine beslist alles over buffering, belading, picken, controle, printen en
22
+ transport. Deze module voert alleen nog taken uit en beslist zelf niets meer.
23
+
24
+ --- Gebeurtenis melden: RPC logistics_emit_event (idempotent) ---
25
+ const { data } = await supabase.rpc("logistics_emit_event", {
26
+ p_source_module: "${key}",
27
+ p_event_type: "order.received", // of order.changed, stock.changed
28
+ p_order_ref: "SO-12345",
29
+ p_payload: {
30
+ checkinAt: "2026-08-01T10:00:00Z",
31
+ pickupAt: "2026-08-01T14:00:00Z",
32
+ customerRef: "CUST-1",
33
+ deliveryLocationRef: "LOC-1",
34
+ bufferRef: null,
35
+ loadCarriers: [{ type: "trolley", count: 3 }],
36
+ ruleVersion: null, // optioneel: plan op een vastgelegde regelversie
37
+ },
38
+ p_strategy_id: null, // uuid van logistics_strategies indien bekend
39
+ p_shadow: true,
40
+ p_idempotency_key: "${key}:SO-12345:order.received:v1",
41
+ });
42
+ // data = { eventId, planRunId, status, duplicate }
43
+ Geef ALTIJD een p_idempotency_key mee die uniek is per gebeurtenis. Stuur je
44
+ dezelfde melding twee keer (retry, dubbele webhook), dan plant de Engine maar
45
+ één keer en krijg je duplicate: true terug.
46
+ De Engine pakt de rij direct op (status pending -> processed), plant de keten en
47
+ zet plan_run_id en error terug op dezelfde rij.
48
+
49
+ --- Taken ophalen: SELECT op public.logistics_tasks ---
50
+ const { data } = await supabase
51
+ .from("logistics_tasks")
52
+ .select("*")
53
+ .eq("owner_module", "${key}")
54
+ .eq("status", "planned")
55
+ .order("planned_start", { ascending: true });
56
+ Kolommen: order_ref, buffer_ref, task_type, sequence, depends_on,
57
+ planned_start, planned_end, due_at, status, shadow, payload, result,
58
+ rule_version, claimed_by, claimed_at, error.
59
+
60
+ Realtime kan gewoon met supabase.channel() op logistics_tasks (in useEffect,
61
+ met removeChannel in de cleanup).
62
+
63
+ --- Taak claimen: ALTIJD via RPC, nooit met een eigen UPDATE ---
64
+ const { data: taak } = await supabase.rpc("logistics_claim_task", {
65
+ p_task_id: taskId, p_worker: "station-3",
66
+ });
67
+ if (!taak) { /* al door iemand anders geclaimd */ }
68
+
69
+ // of automatisch de eerstvolgende taak van deze module:
70
+ const { data: volgende } = await supabase.rpc("logistics_claim_next_task", {
71
+ p_owner_module: "${key}", p_worker: "station-3",
72
+ });
73
+
74
+ --- Taak afmelden: ook via RPC ---
75
+ await supabase.rpc("logistics_complete_task", { p_task_id: taskId, p_result: { ... } });
76
+ await supabase.rpc("logistics_fail_task", { p_task_id: taskId, p_error: "reden" });
77
+
78
+ --- Order annuleren ---
79
+ await supabase.rpc("logistics_emit_event", {
80
+ p_source_module: "${key}",
81
+ p_event_type: "order.cancelled",
82
+ p_order_ref: "SO-12345",
83
+ p_payload: { reason: "klant belde af" },
84
+ p_idempotency_key: "${key}:SO-12345:cancel:v1",
85
+ });
86
+ Al afgeronde taken blijven staan. Annuleer nooit zelf met een eigen UPDATE.
87
+
88
+ --- Order splitsen ---
89
+ await supabase.rpc("logistics_emit_event", {
90
+ p_source_module: "${key}",
91
+ p_event_type: "order.split",
92
+ p_order_ref: "SO-12345",
93
+ p_payload: {
94
+ checkinAt: "...", pickupAt: "...",
95
+ children: [
96
+ { orderRef: "SO-12345-A", loadCarriers: [{ type: "trolley", count: 1 }] },
97
+ { orderRef: "SO-12345-B", loadCarriers: [{ type: "trolley", count: 2 }] },
98
+ ],
99
+ },
100
+ p_idempotency_key: "${key}:SO-12345:split:v1",
101
+ });
102
+
103
+ --- Spoed / prioriteit ---
104
+ await supabase.rpc("logistics_set_order_priority", {
105
+ p_order_ref: "SO-12345", p_priority: 100,
106
+ });
107
+
108
+ --- Instellingen inzien (nooit zelf beslissen) ---
109
+ public.logistics_strategies de logistieke strategieën
110
+ public.logistics_rule_configs settings (jsonb) per strategie + current_version
111
+ public.logistics_plan_runs momentopname van de instellingen per planronde
112
+ Alleen lezen, en alleen om te tonen.
113
+
114
+ Ladingdragers: trolley, danish_container, euro_rolcontainer, pallet, euro_pallet, loose
115
+ Taakstatussen: planned, claimed, in_progress, done, skipped, cancelled,
116
+ superseded, failed
117
+
118
+ Eigenaarschap: meldingen, planruns en taken hebben een kolom user_id die de
119
+ database automatisch vult met het ingelogde account.
120
+
121
+ Start in schaduwmodus (shadow: true): eigen logica blijft draaien, Engine-taken
122
+ worden alleen getoond en vergeleken. Elke taak draagt rule_version — een lopende
123
123
  order verandert nooit stilletjes mee als de Rule Engine wijzigt.`;
124
124
  }
125
- const STOCK_CONTRACT = `De Engine bepaalt of een bestelling met producten die niet op voorraad zijn
126
- überhaupt aangemaakt mag worden. Die keuze staat in de Rule Engine
127
- (Order verwerking -> "Bestellingen uitleveren wanneer een product niet op
128
- voorraad is"). Beslis dit NOOIT zelf.
129
-
130
- Roep vóór het opslaan van een nieuwe order (of het wijzigen van de aantallen)
131
- altijd deze RPC aan:
132
-
133
- const { data: check } = await supabase.rpc("logistics_check_order_allowed", {
134
- p_lines: [
135
- { productId: "<uuid of artikelnummer of barcode of floriday trade item id>", quantity: 12 },
136
- ],
137
- p_strategy_id: null, // uuid van logistics_strategies indien bekend
138
- });
139
- // check = { allowed, allowBackorder, shortages: [{ productId, product, wanted, available, missing }], reason }
140
-
141
- Regels:
142
- - allowed === false -> blokkeer het aanmaken/opslaan van de order volledig en
143
- toon per regel uit check.shortages:
144
- "<product>: besteld <wanted>, beschikbaar <available>, tekort <missing>".
145
- Geen omweg, geen "toch doorgaan"-knop. reason = "insufficient_stock".
146
- - allowed === true en shortages niet leeg -> order mag wél aangemaakt worden
147
- (uitleveren zonder voorraad staat aan); de Engine maakt zelf de melding en/of
148
- e-mail aan. Toon de tekorten alleen ter informatie.
149
- - Alleen de instelling opvragen (bv. live waarschuwing tijdens typen):
150
- const { data: mag } = await supabase.rpc("logistics_backorder_allowed", { p_strategy_id: null });
125
+ const STOCK_CONTRACT = `De Engine bepaalt of een bestelling met producten die niet op voorraad zijn
126
+ überhaupt aangemaakt mag worden. Die keuze staat in de Rule Engine
127
+ (Order verwerking -> "Bestellingen uitleveren wanneer een product niet op
128
+ voorraad is"). Beslis dit NOOIT zelf.
129
+
130
+ Roep vóór het opslaan van een nieuwe order (of het wijzigen van de aantallen)
131
+ altijd deze RPC aan:
132
+
133
+ const { data: check } = await supabase.rpc("logistics_check_order_allowed", {
134
+ p_lines: [
135
+ { productId: "<uuid of artikelnummer of barcode of floriday trade item id>", quantity: 12 },
136
+ ],
137
+ p_strategy_id: null, // uuid van logistics_strategies indien bekend
138
+ });
139
+ // check = { allowed, allowBackorder, shortages: [{ productId, product, wanted, available, missing }], reason }
140
+
141
+ Regels:
142
+ - allowed === false -> blokkeer het aanmaken/opslaan van de order volledig en
143
+ toon per regel uit check.shortages:
144
+ "<product>: besteld <wanted>, beschikbaar <available>, tekort <missing>".
145
+ Geen omweg, geen "toch doorgaan"-knop. reason = "insufficient_stock".
146
+ - allowed === true en shortages niet leeg -> order mag wél aangemaakt worden
147
+ (uitleveren zonder voorraad staat aan); de Engine maakt zelf de melding en/of
148
+ e-mail aan. Toon de tekorten alleen ter informatie.
149
+ - Alleen de instelling opvragen (bv. live waarschuwing tijdens typen):
150
+ const { data: mag } = await supabase.rpc("logistics_backorder_allowed", { p_strategy_id: null });
151
151
  - Cache het antwoord niet: de instelling kan op elk moment wijzigen.`;
152
152
  const MODULES = {
153
153
  verkoop: {
@@ -160,16 +160,16 @@ const MODULES = {
160
160
  date: "2026-07-24",
161
161
  summary: "Orderbufferlogica eruit, events en taken via Supabase.",
162
162
  withSharedContract: true,
163
- body: `Haal weg: alle eigen orderbufferlogica, eigen samenvoegregels en alle
164
- fetch-calls naar een Engine-URL plus eventuele secrets.
165
-
166
- Bouw:
167
- - Bij nieuwe/gewijzigde order een gebeurtenis melden via logistics_emit_event
168
- (event_type order.received of order.changed).
169
- - Taken van type buffer.close lezen uit logistics_tasks (owner_module "verkoop"),
170
- uitvoeren en afmelden via logistics_claim_task + logistics_complete_task.
171
- - Buffer-samenstelling tonen zoals die in payload staat (matchCriteria, release).
172
- - release "manual" -> knop Vrijgeven. release "none" -> alleen tonen, niets doen.
163
+ body: `Haal weg: alle eigen orderbufferlogica, eigen samenvoegregels en alle
164
+ fetch-calls naar een Engine-URL plus eventuele secrets.
165
+
166
+ Bouw:
167
+ - Bij nieuwe/gewijzigde order een gebeurtenis melden via logistics_emit_event
168
+ (event_type order.received of order.changed).
169
+ - Taken van type buffer.close lezen uit logistics_tasks (owner_module "verkoop"),
170
+ uitvoeren en afmelden via logistics_claim_task + logistics_complete_task.
171
+ - Buffer-samenstelling tonen zoals die in payload staat (matchCriteria, release).
172
+ - release "manual" -> knop Vrijgeven. release "none" -> alleen tonen, niets doen.
173
173
  - In schaduwmodus: Engine-buffersluittijd naast de eigen berekening tonen.`,
174
174
  },
175
175
  {
@@ -177,16 +177,16 @@ Bouw:
177
177
  title: "Voorraadcontrole vóór het aanmaken van een order",
178
178
  date: "2026-07-31",
179
179
  summary: "Nieuwe eis bovenop prompt 1: order blokkeren als een product niet op voorraad is.",
180
- body: `AANVULLING op koppelprompt 1 (die blijft gewoon geldig, niets terugdraaien).
181
-
182
- Nieuwe verplichting: vóór het aanmaken of wijzigen van een order eerst de
183
- voorraadcontrole van de Engine aanroepen.
184
-
185
- ${STOCK_CONTRACT}
186
-
187
- In de Verkoop-module concreet:
188
- - Blokkeer de opslaan-knop van de order zolang allowed false is.
189
- - Toon de tekorten in het orderscherm, per regel bij het product.
180
+ body: `AANVULLING op koppelprompt 1 (die blijft gewoon geldig, niets terugdraaien).
181
+
182
+ Nieuwe verplichting: vóór het aanmaken of wijzigen van een order eerst de
183
+ voorraadcontrole van de Engine aanroepen.
184
+
185
+ ${STOCK_CONTRACT}
186
+
187
+ In de Verkoop-module concreet:
188
+ - Blokkeer de opslaan-knop van de order zolang allowed false is.
189
+ - Toon de tekorten in het orderscherm, per regel bij het product.
190
190
  - Doe de controle ook opnieuw bij het wijzigen van aantallen of regels.`,
191
191
  },
192
192
  {
@@ -194,51 +194,51 @@ In de Verkoop-module concreet:
194
194
  title: "Bufferen mag alleen als de Engine dat zegt",
195
195
  date: "2026-07-31",
196
196
  summary: "Nieuwe eis bovenop prompt 1 en 2: geen eigen bufferbesluit meer, altijd eerst logistics_buffer_decision aanroepen.",
197
- body: `AANVULLING op koppelprompt 1 en 2 (die blijven gewoon geldig).
198
-
199
- Probleem: er stonden orders in een orderbuffer terwijl bufferen in de Rule Engine
200
- UIT stond. De Verkoop-module beslist dat dus nog zelf. Dat moet eruit.
201
-
202
- Haal weg: elke eigen regel, instelling of code die bepaalt of een order in een
203
- orderbuffer / gecombineerde order terechtkomt, inclusief automatisch aanmaken of
204
- toewijzen van een buffer bij het opslaan van een order.
205
-
206
- Nieuwe verplichting: vraag het per order aan de Engine.
207
-
208
- const { data: besluit } = await supabase.rpc("logistics_buffer_decision", {
209
- p_order: {
210
- orderRef: "SO-12345",
211
- checkinAt: "2026-08-01T10:00:00Z",
212
- customerRef: "CUST-1",
213
- floridayCustomerRef: "FLOR-1",
214
- bvoCustomerRef: "BVO-1",
215
- deliveryLocationRef: "LOC-1",
216
- deliveryDate: "2026-08-01",
217
- carrierRef: "TRANS-1",
218
- loadCarrierType: "trolley",
219
- orderType: "standaard",
220
- },
221
- p_strategy_id: null, // uuid van logistics_strategies indien bekend
222
- });
223
- // besluit = { buffer, reason, bufferRef, bufferKey, matchCriteria,
224
- // closeBeforeMinutes, bufferCloseAt, release }
225
-
226
- Regels:
227
- - besluit.buffer === false (reason "buffering_disabled") -> de order gaat LOS door.
228
- Geen buffer aanmaken, geen bestaande buffer toewijzen, geen buffer tonen.
229
- - besluit.buffer === true -> gebruik exact besluit.bufferRef als buffersleutel.
230
- Orders met dezelfde bufferRef horen in dezelfde gecombineerde order. Bepaal die
231
- groepering nooit zelf op eigen criteria.
232
- - Toon buffersluittijd uit besluit.bufferCloseAt, en de vrijgave uit
233
- besluit.release ("auto" | "manual" | "none"). Bij "manual" een knop Vrijgeven,
234
- bij "none" alleen tonen.
235
- - Cache het antwoord niet: de instelling kan op elk moment wijzigen. Vraag het
236
- opnieuw bij elke wijziging van de order (aanmeldtijd, klant, locatie, aantallen).
237
- - Stuur bufferRef mee in de payload van logistics_emit_event (veld bufferRef),
238
- zodat de Engine en de Verkoop-module dezelfde buffer bedoelen.
239
-
240
- Eenmalige opschoning: haal bij bestaande, nog niet afgehandelde orders de
241
- bufferkoppeling weg zodra logistics_buffer_decision voor die order buffer=false
197
+ body: `AANVULLING op koppelprompt 1 en 2 (die blijven gewoon geldig).
198
+
199
+ Probleem: er stonden orders in een orderbuffer terwijl bufferen in de Rule Engine
200
+ UIT stond. De Verkoop-module beslist dat dus nog zelf. Dat moet eruit.
201
+
202
+ Haal weg: elke eigen regel, instelling of code die bepaalt of een order in een
203
+ orderbuffer / gecombineerde order terechtkomt, inclusief automatisch aanmaken of
204
+ toewijzen van een buffer bij het opslaan van een order.
205
+
206
+ Nieuwe verplichting: vraag het per order aan de Engine.
207
+
208
+ const { data: besluit } = await supabase.rpc("logistics_buffer_decision", {
209
+ p_order: {
210
+ orderRef: "SO-12345",
211
+ checkinAt: "2026-08-01T10:00:00Z",
212
+ customerRef: "CUST-1",
213
+ floridayCustomerRef: "FLOR-1",
214
+ bvoCustomerRef: "BVO-1",
215
+ deliveryLocationRef: "LOC-1",
216
+ deliveryDate: "2026-08-01",
217
+ carrierRef: "TRANS-1",
218
+ loadCarrierType: "trolley",
219
+ orderType: "standaard",
220
+ },
221
+ p_strategy_id: null, // uuid van logistics_strategies indien bekend
222
+ });
223
+ // besluit = { buffer, reason, bufferRef, bufferKey, matchCriteria,
224
+ // closeBeforeMinutes, bufferCloseAt, release }
225
+
226
+ Regels:
227
+ - besluit.buffer === false (reason "buffering_disabled") -> de order gaat LOS door.
228
+ Geen buffer aanmaken, geen bestaande buffer toewijzen, geen buffer tonen.
229
+ - besluit.buffer === true -> gebruik exact besluit.bufferRef als buffersleutel.
230
+ Orders met dezelfde bufferRef horen in dezelfde gecombineerde order. Bepaal die
231
+ groepering nooit zelf op eigen criteria.
232
+ - Toon buffersluittijd uit besluit.bufferCloseAt, en de vrijgave uit
233
+ besluit.release ("auto" | "manual" | "none"). Bij "manual" een knop Vrijgeven,
234
+ bij "none" alleen tonen.
235
+ - Cache het antwoord niet: de instelling kan op elk moment wijzigen. Vraag het
236
+ opnieuw bij elke wijziging van de order (aanmeldtijd, klant, locatie, aantallen).
237
+ - Stuur bufferRef mee in de payload van logistics_emit_event (veld bufferRef),
238
+ zodat de Engine en de Verkoop-module dezelfde buffer bedoelen.
239
+
240
+ Eenmalige opschoning: haal bij bestaande, nog niet afgehandelde orders de
241
+ bufferkoppeling weg zodra logistics_buffer_decision voor die order buffer=false
242
242
  teruggeeft. Al verwerkte/verzonden orders laat je met rust.`,
243
243
  },
244
244
  {
@@ -246,33 +246,33 @@ teruggeeft. Al verwerkte/verzonden orders laat je met rust.`,
246
246
  title: "Correctie bufferbesluit: nieuwe velden en uitleg",
247
247
  date: "2026-08-02",
248
248
  summary: "Nieuwe eis bovenop prompt 3: logistics_buffer_decision is gecorrigeerd, stuur alle matchvelden mee en gebruik de uitleg (trace).",
249
- body: `AANVULLING op koppelprompt 1, 2 en 3 (die blijven gewoon geldig).
250
-
251
- Wat er is gewijzigd aan de Engine-kant:
252
- - logistics_buffer_decision las de Rule Engine-instellingen fout uit en negeerde de
253
- aangevinkte criteria. Dat is opgelost: de gekozen criteria worden nu echt vergeleken.
254
- - De buffersleutel bevat niet langer het exacte sluitmoment. Orders met dezelfde
255
- gegevens maar een iets andere aanmeldtijd komen nu wél in dezelfde buffer.
256
- - De functie heeft een derde parameter p_user_id (laat die weg of op null staan).
257
- - Het antwoord bevat nu ook een veld trace: per criterium waarom het klopt of niet.
258
-
259
- Wat de Verkoop-module moet doen:
260
- 1. Stuur bij elke aanroep ALLE velden mee die als criterium gekozen kunnen zijn.
261
- Ontbreekt een waarde van een aangevinkt criterium, dan combineert de Engine de
262
- order bewust NIET (reason "buffering_enabled_missing_data").
263
- Verplichte velden in p_order:
264
- orderRef, checkinAt, deliveryDate, customerRef, floridayCustomerRef,
265
- bvoCustomerRef, deliveryLocationRef, carrierRef, loadCarrierType, orderType
266
- deliveryLocationRef moet een stabiele sleutel zijn van het afleveradres
267
- (locatie-id of genormaliseerd adres), niet een vrije tekst die per order verschilt.
268
- 2. Toon in het orderscherm de reden uit besluit.reason en, bij twijfel, de regels uit
269
- besluit.trace ("waarom zit deze order niet bij die andere order?").
270
- 3. Vraag het besluit opnieuw op zodra een van bovenstaande velden wijzigt, en
271
- verplaats de order dan naar de nieuwe bufferRef.
272
- 4. Bepaal nooit zelf of twee orders bij elkaar horen; vergelijk alleen bufferRef.
273
-
274
- Eenmalige opschoning: haal voor alle nog niet verwerkte orders opnieuw het besluit op
275
- en werk de bufferkoppeling bij. Orders die volgens de Engine samen horen, moeten daarna
249
+ body: `AANVULLING op koppelprompt 1, 2 en 3 (die blijven gewoon geldig).
250
+
251
+ Wat er is gewijzigd aan de Engine-kant:
252
+ - logistics_buffer_decision las de Rule Engine-instellingen fout uit en negeerde de
253
+ aangevinkte criteria. Dat is opgelost: de gekozen criteria worden nu echt vergeleken.
254
+ - De buffersleutel bevat niet langer het exacte sluitmoment. Orders met dezelfde
255
+ gegevens maar een iets andere aanmeldtijd komen nu wél in dezelfde buffer.
256
+ - De functie heeft een derde parameter p_user_id (laat die weg of op null staan).
257
+ - Het antwoord bevat nu ook een veld trace: per criterium waarom het klopt of niet.
258
+
259
+ Wat de Verkoop-module moet doen:
260
+ 1. Stuur bij elke aanroep ALLE velden mee die als criterium gekozen kunnen zijn.
261
+ Ontbreekt een waarde van een aangevinkt criterium, dan combineert de Engine de
262
+ order bewust NIET (reason "buffering_enabled_missing_data").
263
+ Verplichte velden in p_order:
264
+ orderRef, checkinAt, deliveryDate, customerRef, floridayCustomerRef,
265
+ bvoCustomerRef, deliveryLocationRef, carrierRef, loadCarrierType, orderType
266
+ deliveryLocationRef moet een stabiele sleutel zijn van het afleveradres
267
+ (locatie-id of genormaliseerd adres), niet een vrije tekst die per order verschilt.
268
+ 2. Toon in het orderscherm de reden uit besluit.reason en, bij twijfel, de regels uit
269
+ besluit.trace ("waarom zit deze order niet bij die andere order?").
270
+ 3. Vraag het besluit opnieuw op zodra een van bovenstaande velden wijzigt, en
271
+ verplaats de order dan naar de nieuwe bufferRef.
272
+ 4. Bepaal nooit zelf of twee orders bij elkaar horen; vergelijk alleen bufferRef.
273
+
274
+ Eenmalige opschoning: haal voor alle nog niet verwerkte orders opnieuw het besluit op
275
+ en werk de bufferkoppeling bij. Orders die volgens de Engine samen horen, moeten daarna
276
276
  dezelfde bufferRef hebben.`,
277
277
  },
278
278
  {
@@ -280,44 +280,44 @@ dezelfde bufferRef hebben.`,
280
280
  title: "Alleen ladingdragers tonen die de Engine toestaat",
281
281
  date: "2026-08-03",
282
282
  summary: "Nieuwe eis bovenop prompt 1 t/m 4: uitgeschakelde ladingdragers mogen niet meer kiesbaar zijn.",
283
- body: `AANVULLING op koppelprompt 1, 2, 3 en 4 (die blijven gewoon geldig).
284
-
285
- In de Rule Engine (stap Beladingindeling) staat welke ladingdragers zijn toegestaan.
286
- Staat een ladingdrager uit, dan mag die in de Verkoop-module nergens meer te kiezen
287
- zijn.
288
-
289
- Haal weg: elke eigen, vaste lijst met ladingdragers / verzendmethodes in de code,
290
- in constanten, in dropdowns of in filters.
291
-
292
- Nieuwe verplichting: haal de lijst op bij de Engine.
293
-
294
- const { data: dragers } = await supabase.rpc("logistics_allowed_load_carriers", {
295
- p_strategy_id: null, // uuid van logistics_strategies indien bekend
296
- });
297
- // dragers = {
298
- // allowed: ["trolley","pallet"],
299
- // default: "trolley",
300
- // carriers: [{ code, label, enabled, isDefault }, ...]
301
- // }
302
-
303
- Codes en namen (gebruik exact deze codes):
304
- trolley Stapelwagen
305
- danish_container Deense container
306
- euro_rolcontainer Euro-rolcontainer
307
- pallet Pallet
308
- euro_pallet Euro-pallet
309
- loose Geen ladingdrager
310
-
311
- Regels:
312
- - Toon in elk keuzeveld (order, orderregel, verzendmethode, filter) alleen de
313
- dragers met enabled === true. Uitgeschakelde dragers niet grijs tonen: weglaten.
314
- - Voorselectie = dragers.default.
315
- - Blokkeer opslaan als een order een ladingdrager heeft die niet in allowed staat,
316
- met melding: "Deze ladingdrager is uitgeschakeld in de Logistics Engine."
317
- - Cache de lijst niet langer dan één schermsessie; de instelling kan wijzigen.
318
- - Bestaande, nog niet verwerkte orders met een inmiddels uitgeschakelde drager:
319
- markeer die in het overzicht zodat een medewerker een andere drager kiest.
320
- - Stuur loadCarrierType in logistics_emit_event en logistics_buffer_decision altijd
283
+ body: `AANVULLING op koppelprompt 1, 2, 3 en 4 (die blijven gewoon geldig).
284
+
285
+ In de Rule Engine (stap Beladingindeling) staat welke ladingdragers zijn toegestaan.
286
+ Staat een ladingdrager uit, dan mag die in de Verkoop-module nergens meer te kiezen
287
+ zijn.
288
+
289
+ Haal weg: elke eigen, vaste lijst met ladingdragers / verzendmethodes in de code,
290
+ in constanten, in dropdowns of in filters.
291
+
292
+ Nieuwe verplichting: haal de lijst op bij de Engine.
293
+
294
+ const { data: dragers } = await supabase.rpc("logistics_allowed_load_carriers", {
295
+ p_strategy_id: null, // uuid van logistics_strategies indien bekend
296
+ });
297
+ // dragers = {
298
+ // allowed: ["trolley","pallet"],
299
+ // default: "trolley",
300
+ // carriers: [{ code, label, enabled, isDefault }, ...]
301
+ // }
302
+
303
+ Codes en namen (gebruik exact deze codes):
304
+ trolley Stapelwagen
305
+ danish_container Deense container
306
+ euro_rolcontainer Euro-rolcontainer
307
+ pallet Pallet
308
+ euro_pallet Euro-pallet
309
+ loose Geen ladingdrager
310
+
311
+ Regels:
312
+ - Toon in elk keuzeveld (order, orderregel, verzendmethode, filter) alleen de
313
+ dragers met enabled === true. Uitgeschakelde dragers niet grijs tonen: weglaten.
314
+ - Voorselectie = dragers.default.
315
+ - Blokkeer opslaan als een order een ladingdrager heeft die niet in allowed staat,
316
+ met melding: "Deze ladingdrager is uitgeschakeld in de Logistics Engine."
317
+ - Cache de lijst niet langer dan één schermsessie; de instelling kan wijzigen.
318
+ - Bestaande, nog niet verwerkte orders met een inmiddels uitgeschakelde drager:
319
+ markeer die in het overzicht zodat een medewerker een andere drager kiest.
320
+ - Stuur loadCarrierType in logistics_emit_event en logistics_buffer_decision altijd
321
321
  met een van bovenstaande codes mee, nooit met een eigen naam of vrije tekst.`,
322
322
  },
323
323
  ],
@@ -332,15 +332,15 @@ Regels:
332
332
  date: "2026-07-24",
333
333
  summary: "Eigen beladings- en documentlogica eruit, taken uitvoeren.",
334
334
  withSharedContract: true,
335
- body: `Haal weg: eigen beladingindeling, eigen documentmomenten, eigen controle-instellingen.
336
-
337
- Consumeer deze taaktypes:
338
- - load.compose payload: loadCarriers, fillMode (generated | manual_scan)
339
- - control.execute payload: controlMode (paper), noticeAt
340
- - print.control_note payload: printItems (control_note | control_note_and_shipping)
341
- - print.shipping_note payload: moment (with_packing_slip | with_control | after_control | after_scan)
342
- - transport.dispatch
343
-
335
+ body: `Haal weg: eigen beladingindeling, eigen documentmomenten, eigen controle-instellingen.
336
+
337
+ Consumeer deze taaktypes:
338
+ - load.compose payload: loadCarriers, fillMode (generated | manual_scan)
339
+ - control.execute payload: controlMode (paper), noticeAt
340
+ - print.control_note payload: printItems (control_note | control_note_and_shipping)
341
+ - print.shipping_note payload: moment (with_packing_slip | with_control | after_control | after_scan)
342
+ - transport.dispatch
343
+
344
344
  Wat er geprint wordt en wanneer komt volledig uit de taak-payload. Geen eigen keuzes meer.`,
345
345
  },
346
346
  {
@@ -348,28 +348,28 @@ Wat er geprint wordt en wanneer komt volledig uit de taak-payload. Geen eigen ke
348
348
  title: "Documentvrijgave komt volledig van de Engine",
349
349
  date: "2026-08-03",
350
350
  summary: "Pakbon, stickers, verzendbrief en productiebon alleen nog via Engine-taken.",
351
- body: `Deze prompt vervangt niets uit prompt 1; hij komt er bovenop.
352
-
353
- Haal weg: elke eigen regel over wanneer een pakbon, sticker, verzendbrief of
354
- productiebon wordt vrijgegeven of geprint. De Logistics Engine beslist dit nu.
355
-
356
- Nieuwe taaktypes die je moet verwerken (tabel logistics_tasks):
357
- - print.packing_slip payload: release (with_pick_release | hours_before_pick),
358
- pickStationId, pickStationTypeId, requiresApproval
359
- - print.sticker payload: idem als print.packing_slip
360
- - print.shipping_note payload: release (after_checkin | after_scan |
361
- with_packing_slip | manual_approval), pickStationId,
362
- pickStationTypeId, requiresApproval
363
- - print.production_note payload: release (on_stock_upgrade |
364
- manual_approval_after_upgrade), trigger, pickStationId,
365
- pickStationTypeId, requiresApproval
366
-
367
- Regels:
368
- - planned_start van de taak is het vrijgavemoment. Nooit eerder printen.
369
- - pickStationId verwijst naar public.pick_stations.id; pickStationTypeId naar
370
- public.pick_station_types.id. Stuur het document uitsluitend naar dat station.
371
- - requiresApproval = true: het document blijft in de wachtrij tot iemand het op
372
- het pickstation goedkeurt. Meld de goedkeuring met logistics_complete_task.
351
+ body: `Deze prompt vervangt niets uit prompt 1; hij komt er bovenop.
352
+
353
+ Haal weg: elke eigen regel over wanneer een pakbon, sticker, verzendbrief of
354
+ productiebon wordt vrijgegeven of geprint. De Logistics Engine beslist dit nu.
355
+
356
+ Nieuwe taaktypes die je moet verwerken (tabel logistics_tasks):
357
+ - print.packing_slip payload: release (with_pick_release | hours_before_pick),
358
+ pickStationId, pickStationTypeId, requiresApproval
359
+ - print.sticker payload: idem als print.packing_slip
360
+ - print.shipping_note payload: release (after_checkin | after_scan |
361
+ with_packing_slip | manual_approval), pickStationId,
362
+ pickStationTypeId, requiresApproval
363
+ - print.production_note payload: release (on_stock_upgrade |
364
+ manual_approval_after_upgrade), trigger, pickStationId,
365
+ pickStationTypeId, requiresApproval
366
+
367
+ Regels:
368
+ - planned_start van de taak is het vrijgavemoment. Nooit eerder printen.
369
+ - pickStationId verwijst naar public.pick_stations.id; pickStationTypeId naar
370
+ public.pick_station_types.id. Stuur het document uitsluitend naar dat station.
371
+ - requiresApproval = true: het document blijft in de wachtrij tot iemand het op
372
+ het pickstation goedkeurt. Meld de goedkeuring met logistics_complete_task.
373
373
  - Is er geen taak voor een document, dan wordt dat document niet geprint.`,
374
374
  },
375
375
  {
@@ -377,53 +377,53 @@ Regels:
377
377
  title: "Order- en karindeling altijd via de Logistics Engine",
378
378
  date: "2026-08-04",
379
379
  summary: "Nieuwe eis bovenop prompt 1 en 2: geen eigen indeling van orders en karren meer; stap 3 'Order picken' van de Rule Engine is leidend.",
380
- body: `Deze prompt vervangt niets uit prompt 1 en 2; hij komt er bovenop.
381
-
382
- Geconstateerd probleem: deze module deelt orders en karren nog zelf in en houdt
383
- zich daardoor niet aan stap 3 "Order picken" van de Rule Engine. Dat moet stoppen.
384
-
385
- Haal weg: elke eigen berekening van
386
- - welke orders samen op één belading/kar komen,
387
- - hoeveel orders, klanten, lagen of dozen er op een drager passen,
388
- - wanneer er met picken gestart wordt,
389
- - of er met of zonder scanner gewerkt wordt.
390
-
391
- Zo werkt het vanaf nu:
392
-
393
- 1) Vraag altijd eerst het besluit op voordat je iets indeelt:
394
- const { data: besluit } = await supabase.rpc("logistics_buffer_decision", {
395
- p_order_ref: "SO-12345",
396
- p_customer_ref: "CUST-1",
397
- p_delivery_location_ref: "LOC-1",
398
- p_checkin_at: "2026-08-01T10:00:00Z",
399
- p_pickup_at: "2026-08-01T14:00:00Z",
400
- p_load_carrier_type: "trolley",
401
- p_strategy_id: null,
402
- });
403
- // besluit = { buffer, bufferRef, matchCriteria, release, trace }
404
- Deel de order uitsluitend in bij bufferRef. Is buffer=false, dan blijft de order
405
- los staan: nooit zelf alsnog samenvoegen.
406
-
407
- 2) De feitelijke belading komt uit de taak load.compose in logistics_tasks
408
- (owner_module = "afhandeling"). De payload bevat loadCarriers, fillMode
409
- (generated | manual_scan) en de picksettings uit stap 3: pickMode,
410
- pickStartMode, pickMinutes, staff, reserveMinutes, scanner.
411
- - fillMode = generated: neem de indeling exact over zoals aangeleverd.
412
- - fillMode = manual_scan: laat de medewerker scannen en meld het resultaat
413
- terug; corrigeer de indeling niet zelf.
414
- - scanner = required: geen afronding zonder scan.
415
-
416
- 3) planned_start en planned_end van de taak zijn leidend voor het pickmoment.
417
- Herbereken die nooit zelf, ook niet bij drukte.
418
-
419
- 4) Is er nog geen load.compose taak voor een order, dan meld je dat met
420
- logistics_emit_event (order.received of order.changed) en wacht je op de taak.
421
- Zelf alvast indelen is niet toegestaan.
422
-
423
- 5) Elke taak draagt rule_version. Rond een lopende belading altijd af op de
424
- rule_version van de taak, ook als de Rule Engine intussen is gewijzigd.
425
-
426
- Meld afwijkingen terug met logistics_fail_task inclusief toelichting, zodat de
380
+ body: `Deze prompt vervangt niets uit prompt 1 en 2; hij komt er bovenop.
381
+
382
+ Geconstateerd probleem: deze module deelt orders en karren nog zelf in en houdt
383
+ zich daardoor niet aan stap 3 "Order picken" van de Rule Engine. Dat moet stoppen.
384
+
385
+ Haal weg: elke eigen berekening van
386
+ - welke orders samen op één belading/kar komen,
387
+ - hoeveel orders, klanten, lagen of dozen er op een drager passen,
388
+ - wanneer er met picken gestart wordt,
389
+ - of er met of zonder scanner gewerkt wordt.
390
+
391
+ Zo werkt het vanaf nu:
392
+
393
+ 1) Vraag altijd eerst het besluit op voordat je iets indeelt:
394
+ const { data: besluit } = await supabase.rpc("logistics_buffer_decision", {
395
+ p_order_ref: "SO-12345",
396
+ p_customer_ref: "CUST-1",
397
+ p_delivery_location_ref: "LOC-1",
398
+ p_checkin_at: "2026-08-01T10:00:00Z",
399
+ p_pickup_at: "2026-08-01T14:00:00Z",
400
+ p_load_carrier_type: "trolley",
401
+ p_strategy_id: null,
402
+ });
403
+ // besluit = { buffer, bufferRef, matchCriteria, release, trace }
404
+ Deel de order uitsluitend in bij bufferRef. Is buffer=false, dan blijft de order
405
+ los staan: nooit zelf alsnog samenvoegen.
406
+
407
+ 2) De feitelijke belading komt uit de taak load.compose in logistics_tasks
408
+ (owner_module = "afhandeling"). De payload bevat loadCarriers, fillMode
409
+ (generated | manual_scan) en de picksettings uit stap 3: pickMode,
410
+ pickStartMode, pickMinutes, staff, reserveMinutes, scanner.
411
+ - fillMode = generated: neem de indeling exact over zoals aangeleverd.
412
+ - fillMode = manual_scan: laat de medewerker scannen en meld het resultaat
413
+ terug; corrigeer de indeling niet zelf.
414
+ - scanner = required: geen afronding zonder scan.
415
+
416
+ 3) planned_start en planned_end van de taak zijn leidend voor het pickmoment.
417
+ Herbereken die nooit zelf, ook niet bij drukte.
418
+
419
+ 4) Is er nog geen load.compose taak voor een order, dan meld je dat met
420
+ logistics_emit_event (order.received of order.changed) en wacht je op de taak.
421
+ Zelf alvast indelen is niet toegestaan.
422
+
423
+ 5) Elke taak draagt rule_version. Rond een lopende belading altijd af op de
424
+ rule_version van de taak, ook als de Rule Engine intussen is gewijzigd.
425
+
426
+ Meld afwijkingen terug met logistics_fail_task inclusief toelichting, zodat de
427
427
  Engine kan herplannen. Val nooit terug op eigen logica.`,
428
428
  },
429
429
  {
@@ -431,50 +431,50 @@ Engine kan herplannen. Val nooit terug op eigen logica.`,
431
431
  title: "Karren verdelen over meerdere ophaalmomenten",
432
432
  date: "2026-08-04",
433
433
  summary: "Nieuwe eis bovenop prompt 1 t/m 4: de Engine verdeelt complete karren over de ophaalmomenten van een dag; deze module toont dat en verzet nooit zelf.",
434
- body: `LEES DIT EERST — hoe je deze prompt uitvoert
435
-
436
- Alles uit prompt 1 t/m 4 blijft gelden. Hier komt er één ding bij: een dag kan
437
- MEERDERE ophaalmomenten hebben, en de Logistics Engine bepaalt welke kar bij
438
- welk ophaalmoment hoort. Jij rekent NIETS zelf uit en verplaatst NOOIT zelf een
439
- kar op basis van eigen logica.
440
-
441
- 1) Ophaalmomenten lezen
442
- Tabel: public.logistics_pickup_moments
443
- Kolommen: id, moment_date, sequence, label, pickup_time, carrier_ref
444
- Toon per dag de ophaalmomenten op volgorde van sequence/pickup_time.
445
-
446
- 2) Karren per ophaalmoment
447
- Tabel public.order_carts heeft nieuwe kolommen:
448
- - pickup_moment_id → bij welk ophaalmoment de kar hoort
449
- - moved_from_moment_id → het ophaalmoment waar de kar oorspronkelijk stond
450
- - moved_reason → 'capacity_shift' als de Engine hem doorschoof
451
- - moved_at → wanneer dat gebeurde
452
- - pickup_locked → true = deze kar mag NIET doorgeschoven worden
453
-
454
- Groepeer de pickagenda en de leveringsplanning voortaan op pickup_moment_id,
455
- niet meer alleen op de dag. Een kar met moved_reason = 'capacity_shift' toon
456
- je met een duidelijk label "doorgeschoven vanaf <label vorig moment>".
457
-
458
- 3) Regels die je moet respecteren
459
- - Alleen COMPLETE karren wisselen van ophaalmoment. Splits nooit een kar en
460
- verplaats nooit losse orderregels naar een ander moment.
461
- - Karren uit een buffer mogen mee, maar alleen als geheel.
462
- - Wil een gebruiker een kar vastzetten op een moment, zet dan
463
- pickup_locked = true. Meer doe je niet; de Engine slaat die kar over.
464
-
465
- 4) Herberekenen
466
- Na elke wijziging die de planning raakt (nieuwe order, annulering, andere
467
- ophaaltijd, andere kar-indeling) roep je aan:
468
- await supabase.rpc("logistics_capacity_plan_day", { p_date: "2026-08-04" })
469
- De functie geeft per ophaalmoment terug: requiredMinutes, availableMinutes,
470
- feasible en movedCarts. Toon die uitkomst; verzin geen eigen berekening.
471
-
472
- 5) Tekort tonen
473
- Tabel public.logistics_capacity_alerts bevat per dag/ophaalmoment het tekort
474
- (shortage_minutes, carts_short, moved_carts, unplanned_carts). Staat er een
475
- rij met status = 'open', toon dan bij dat ophaalmoment een rode waarschuwing
476
- met het tekort en het aantal karren dat niet op tijd verwerkt kan worden.
477
-
434
+ body: `LEES DIT EERST — hoe je deze prompt uitvoert
435
+
436
+ Alles uit prompt 1 t/m 4 blijft gelden. Hier komt er één ding bij: een dag kan
437
+ MEERDERE ophaalmomenten hebben, en de Logistics Engine bepaalt welke kar bij
438
+ welk ophaalmoment hoort. Jij rekent NIETS zelf uit en verplaatst NOOIT zelf een
439
+ kar op basis van eigen logica.
440
+
441
+ 1) Ophaalmomenten lezen
442
+ Tabel: public.logistics_pickup_moments
443
+ Kolommen: id, moment_date, sequence, label, pickup_time, carrier_ref
444
+ Toon per dag de ophaalmomenten op volgorde van sequence/pickup_time.
445
+
446
+ 2) Karren per ophaalmoment
447
+ Tabel public.order_carts heeft nieuwe kolommen:
448
+ - pickup_moment_id → bij welk ophaalmoment de kar hoort
449
+ - moved_from_moment_id → het ophaalmoment waar de kar oorspronkelijk stond
450
+ - moved_reason → 'capacity_shift' als de Engine hem doorschoof
451
+ - moved_at → wanneer dat gebeurde
452
+ - pickup_locked → true = deze kar mag NIET doorgeschoven worden
453
+
454
+ Groepeer de pickagenda en de leveringsplanning voortaan op pickup_moment_id,
455
+ niet meer alleen op de dag. Een kar met moved_reason = 'capacity_shift' toon
456
+ je met een duidelijk label "doorgeschoven vanaf <label vorig moment>".
457
+
458
+ 3) Regels die je moet respecteren
459
+ - Alleen COMPLETE karren wisselen van ophaalmoment. Splits nooit een kar en
460
+ verplaats nooit losse orderregels naar een ander moment.
461
+ - Karren uit een buffer mogen mee, maar alleen als geheel.
462
+ - Wil een gebruiker een kar vastzetten op een moment, zet dan
463
+ pickup_locked = true. Meer doe je niet; de Engine slaat die kar over.
464
+
465
+ 4) Herberekenen
466
+ Na elke wijziging die de planning raakt (nieuwe order, annulering, andere
467
+ ophaaltijd, andere kar-indeling) roep je aan:
468
+ await supabase.rpc("logistics_capacity_plan_day", { p_date: "2026-08-04" })
469
+ De functie geeft per ophaalmoment terug: requiredMinutes, availableMinutes,
470
+ feasible en movedCarts. Toon die uitkomst; verzin geen eigen berekening.
471
+
472
+ 5) Tekort tonen
473
+ Tabel public.logistics_capacity_alerts bevat per dag/ophaalmoment het tekort
474
+ (shortage_minutes, carts_short, moved_carts, unplanned_carts). Staat er een
475
+ rij met status = 'open', toon dan bij dat ophaalmoment een rode waarschuwing
476
+ met het tekort en het aantal karren dat niet op tijd verwerkt kan worden.
477
+
478
478
  Val nooit terug op eigen logica. Wat de Engine teruggeeft, is leidend.`,
479
479
  },
480
480
  {
@@ -482,131 +482,131 @@ Val nooit terug op eigen logica. Wat de Engine teruggeeft, is leidend.`,
482
482
  title: "Order handmatig verzetten en ophaaltijd wijzigen",
483
483
  date: "2026-08-04",
484
484
  summary: "Nieuwe eis bovenop prompt 1 t/m 3: een medewerker mag een order handmatig naar een andere dag en/of ophaaltijd zetten, via twee vaste RPC's van de Engine.",
485
- body: `LEES DIT EERST — hoe je deze prompt uitvoert
486
-
487
- Deze prompt beschrijft één nieuwe functie in de Afhandeling-module: "Order
488
- verzetten". Je bouwt hem volledig, niet gedeeltelijk. Alles wat hieronder staat
489
- is verplicht. Er is GEEN eigen rekenwerk: de Logistics Engine levert twee kant-en-
490
- klare database-functies, jij bouwt alleen het scherm eromheen en toont wat de
491
- Engine teruggeeft.
492
-
493
- Concreet ben je klaar als dit alle vier waar is:
494
- 1. Er is een knop "Verzetten" bij een order (planning-/agenda-/leverscherm).
495
- 2. Het dialoogvenster toont een DAGKEUZE en een OPHAALTIJD (van/tot).
496
- 3. Voor het opslaan is logistics_reschedule_preview aangeroepen en wordt de
497
- uitkomst daarvan letterlijk aan de gebruiker getoond.
498
- 4. Opslaan gebeurt uitsluitend met logistics_reschedule_order.
499
-
500
- ------------------------------------------------------------------
501
- DE TWEE REGELS DIE DE GEBRUIKER WIL
502
- ------------------------------------------------------------------
503
-
504
- A. Order gaat NAAR VOREN (nieuwe ophaaldag is eerder dan de huidige)
505
- -> Het AFLEVERMOMENT (leverdatum naar de klant) blijft ONGEWIJZIGD.
506
- De order wordt dus eerder klaargemaakt en opgehaald, maar de klant krijgt
507
- hem op dezelfde dag als afgesproken. Je verandert de leverdatum NIET.
508
- Er gaat GEEN melding naar de klant.
509
-
510
- B. Order gaat NAAR ACHTEREN (nieuwe ophaaldag is later)
511
- -> Het aflevermoment schuift mee.
512
- -> De gebruiker MOET in het dialoogvenster de keuze krijgen:
513
- "Klant informeren over de nieuwe leverdatum" (aan/uit) plus een reden.
514
- Staat het aan, dan zorgt de Engine voor de klantmelding. Bouw daar zelf
515
- geen mailflow voor.
516
-
517
- C. Alleen de OPHAALTIJD wijzigen (zelfde dag, andere van/tot-tijd) mag altijd
518
- en geldt niet als verzetten: geen klantmelding, leverdatum blijft gelijk.
519
-
520
- ------------------------------------------------------------------
521
- STAP 1 — VOORVERTONING (verplicht vóór opslaan)
522
- ------------------------------------------------------------------
523
- const { data: preview } = await supabase.rpc("logistics_reschedule_preview", {
524
- p_order_ref: "SO-12345", // orders.order_number
525
- p_pickup_date: "2026-08-07", // nieuwe ophaaldag (YYYY-MM-DD), null = ongewijzigd
526
- p_pickup_from: "06:00", // nieuwe starttijd, null = ongewijzigd
527
- p_pickup_to: "09:00", // nieuwe eindtijd, null = ongewijzigd
528
- });
529
-
530
- preview bevat:
531
- {
532
- ok: true,
533
- orderRef, orderId, bufferId, planLocked,
534
- current: { pickupDate, pickupFrom, pickupTo, deliveryDate },
535
- next: { pickupDate, pickupFrom, pickupTo, deliveryDate },
536
- direction: "earlier" | "later" | "same",
537
- dayShift: -2, // aantal dagen verschil
538
- timeChanged: true,
539
- keepDeliveryMoment: true, // true bij naar voren: leverdatum blijft
540
- customerNoticeRequired: true, // true bij naar achteren: toon de klantoptie
541
- affectedTasks: 8 // aantal taken dat opnieuw wordt ingepland
542
- }
543
-
544
- Wat je met deze velden DOET in het scherm:
545
- - ok === false -> toon preview.error en blokkeer opslaan.
546
- - direction === "earlier" -> toon: "Order wordt X dag(en) eerder opgehaald. Het
547
- aflevermoment blijft {current.deliveryDate}." Verberg de klantoptie.
548
- - direction === "later" -> toon: "Order wordt X dag(en) later. Nieuwe leverdatum:
549
- {next.deliveryDate}." Toon de schakelaar "Klant informeren" (standaard AAN) en
550
- een verplicht redenveld.
551
- - direction === "same" && timeChanged -> toon alleen de nieuwe ophaaltijd.
552
- - Toon altijd affectedTasks: "X taken worden opnieuw ingepland."
553
-
554
- ------------------------------------------------------------------
555
- STAP 2 — OPSLAAN
556
- ------------------------------------------------------------------
557
- const { data: result } = await supabase.rpc("logistics_reschedule_order", {
558
- p_order_ref: "SO-12345",
559
- p_pickup_date: "2026-08-07",
560
- p_pickup_from: "06:00",
561
- p_pickup_to: "09:00",
562
- p_notify_customer: true, // alleen relevant bij direction "later"
563
- p_reason: "Aanvoer bloemen vertraagd",
564
- p_source_module: "afhandeling",
565
- p_user_id: null,
566
- });
567
- // result = preview-velden + { applied: true, rescheduleId, delayAlertId,
568
- // customerNotified, pickupMoment }
569
-
570
- De Engine doet hierbij zelf al ALLES hieronder — doe dit dus niet nogmaals:
571
- - orders.custom_fields.pickup_moment bijwerken ("YYYY-MM-DD|van|tot");
572
- - leverdatum alleen aanpassen bij naar achteren;
573
- - de order uit zijn orderbuffer halen zodat hij niet aan de oude dag vastzit;
574
- - de klantmelding aanmaken als p_notify_customer true is;
575
- - een order.changed-melding sturen en de hele takenketen (buffer, pick, controle,
576
- printen, transport) opnieuw inplannen met logistics_schedule_tasks;
577
- - het verzetten vastleggen in public.logistics_reschedules.
578
-
579
- ------------------------------------------------------------------
580
- WAT JE ABSOLUUT NIET DOET
581
- ------------------------------------------------------------------
582
- - Geen eigen UPDATE op orders, order_buffers, order_carts of logistics_tasks om
583
- een datum of tijd te verzetten. Uitsluitend via de twee RPC's hierboven.
584
- - Zelf planned_start / planned_end / due_at van taken herberekenen. Na het
585
- opslaan lees je de taken gewoon opnieuw; ze staan dan al goed.
586
- - Bij naar voren de leverdatum meeschuiven. Dat is expliciet fout.
587
- - Bij naar achteren de klant informeren zonder dat de gebruiker dat heeft
588
- aangevinkt, of een eigen mail sturen buiten de Engine om.
589
-
590
- ------------------------------------------------------------------
591
- NA HET OPSLAAN
592
- ------------------------------------------------------------------
593
- 1. Herlaad de taken van deze order uit logistics_tasks (planned_start bepaalt
594
- waar de order in de pickagenda en het leverscherm verschijnt).
595
- 2. Toon een bevestiging met de nieuwe ophaaldag, de ophaaltijd, de leverdatum en
596
- of de klant is geïnformeerd (result.customerNotified).
597
- 3. De verzetgeschiedenis kun je tonen met:
598
- supabase.from("logistics_reschedules").select("*").eq("order_ref", ref)
599
- .order("created_at", { ascending: false });
600
-
601
- ------------------------------------------------------------------
602
- CONTROLELIJST VOOR JEZELF (loop deze af voor je klaar meldt)
603
- ------------------------------------------------------------------
604
- [ ] Knop "Verzetten" bestaat bij een order.
605
- [ ] Dagkeuze én ophaaltijd van/tot zijn in te vullen.
606
- [ ] preview wordt live aangeroepen bij elke wijziging in het formulier.
607
- [ ] Naar voren: leverdatum ongewijzigd, geen klantoptie zichtbaar.
608
- [ ] Naar achteren: nieuwe leverdatum zichtbaar + klantoptie + reden.
609
- [ ] Opslaan gaat via logistics_reschedule_order, nergens een eigen UPDATE.
485
+ body: `LEES DIT EERST — hoe je deze prompt uitvoert
486
+
487
+ Deze prompt beschrijft één nieuwe functie in de Afhandeling-module: "Order
488
+ verzetten". Je bouwt hem volledig, niet gedeeltelijk. Alles wat hieronder staat
489
+ is verplicht. Er is GEEN eigen rekenwerk: de Logistics Engine levert twee kant-en-
490
+ klare database-functies, jij bouwt alleen het scherm eromheen en toont wat de
491
+ Engine teruggeeft.
492
+
493
+ Concreet ben je klaar als dit alle vier waar is:
494
+ 1. Er is een knop "Verzetten" bij een order (planning-/agenda-/leverscherm).
495
+ 2. Het dialoogvenster toont een DAGKEUZE en een OPHAALTIJD (van/tot).
496
+ 3. Voor het opslaan is logistics_reschedule_preview aangeroepen en wordt de
497
+ uitkomst daarvan letterlijk aan de gebruiker getoond.
498
+ 4. Opslaan gebeurt uitsluitend met logistics_reschedule_order.
499
+
500
+ ------------------------------------------------------------------
501
+ DE TWEE REGELS DIE DE GEBRUIKER WIL
502
+ ------------------------------------------------------------------
503
+
504
+ A. Order gaat NAAR VOREN (nieuwe ophaaldag is eerder dan de huidige)
505
+ -> Het AFLEVERMOMENT (leverdatum naar de klant) blijft ONGEWIJZIGD.
506
+ De order wordt dus eerder klaargemaakt en opgehaald, maar de klant krijgt
507
+ hem op dezelfde dag als afgesproken. Je verandert de leverdatum NIET.
508
+ Er gaat GEEN melding naar de klant.
509
+
510
+ B. Order gaat NAAR ACHTEREN (nieuwe ophaaldag is later)
511
+ -> Het aflevermoment schuift mee.
512
+ -> De gebruiker MOET in het dialoogvenster de keuze krijgen:
513
+ "Klant informeren over de nieuwe leverdatum" (aan/uit) plus een reden.
514
+ Staat het aan, dan zorgt de Engine voor de klantmelding. Bouw daar zelf
515
+ geen mailflow voor.
516
+
517
+ C. Alleen de OPHAALTIJD wijzigen (zelfde dag, andere van/tot-tijd) mag altijd
518
+ en geldt niet als verzetten: geen klantmelding, leverdatum blijft gelijk.
519
+
520
+ ------------------------------------------------------------------
521
+ STAP 1 — VOORVERTONING (verplicht vóór opslaan)
522
+ ------------------------------------------------------------------
523
+ const { data: preview } = await supabase.rpc("logistics_reschedule_preview", {
524
+ p_order_ref: "SO-12345", // orders.order_number
525
+ p_pickup_date: "2026-08-07", // nieuwe ophaaldag (YYYY-MM-DD), null = ongewijzigd
526
+ p_pickup_from: "06:00", // nieuwe starttijd, null = ongewijzigd
527
+ p_pickup_to: "09:00", // nieuwe eindtijd, null = ongewijzigd
528
+ });
529
+
530
+ preview bevat:
531
+ {
532
+ ok: true,
533
+ orderRef, orderId, bufferId, planLocked,
534
+ current: { pickupDate, pickupFrom, pickupTo, deliveryDate },
535
+ next: { pickupDate, pickupFrom, pickupTo, deliveryDate },
536
+ direction: "earlier" | "later" | "same",
537
+ dayShift: -2, // aantal dagen verschil
538
+ timeChanged: true,
539
+ keepDeliveryMoment: true, // true bij naar voren: leverdatum blijft
540
+ customerNoticeRequired: true, // true bij naar achteren: toon de klantoptie
541
+ affectedTasks: 8 // aantal taken dat opnieuw wordt ingepland
542
+ }
543
+
544
+ Wat je met deze velden DOET in het scherm:
545
+ - ok === false -> toon preview.error en blokkeer opslaan.
546
+ - direction === "earlier" -> toon: "Order wordt X dag(en) eerder opgehaald. Het
547
+ aflevermoment blijft {current.deliveryDate}." Verberg de klantoptie.
548
+ - direction === "later" -> toon: "Order wordt X dag(en) later. Nieuwe leverdatum:
549
+ {next.deliveryDate}." Toon de schakelaar "Klant informeren" (standaard AAN) en
550
+ een verplicht redenveld.
551
+ - direction === "same" && timeChanged -> toon alleen de nieuwe ophaaltijd.
552
+ - Toon altijd affectedTasks: "X taken worden opnieuw ingepland."
553
+
554
+ ------------------------------------------------------------------
555
+ STAP 2 — OPSLAAN
556
+ ------------------------------------------------------------------
557
+ const { data: result } = await supabase.rpc("logistics_reschedule_order", {
558
+ p_order_ref: "SO-12345",
559
+ p_pickup_date: "2026-08-07",
560
+ p_pickup_from: "06:00",
561
+ p_pickup_to: "09:00",
562
+ p_notify_customer: true, // alleen relevant bij direction "later"
563
+ p_reason: "Aanvoer bloemen vertraagd",
564
+ p_source_module: "afhandeling",
565
+ p_user_id: null,
566
+ });
567
+ // result = preview-velden + { applied: true, rescheduleId, delayAlertId,
568
+ // customerNotified, pickupMoment }
569
+
570
+ De Engine doet hierbij zelf al ALLES hieronder — doe dit dus niet nogmaals:
571
+ - orders.custom_fields.pickup_moment bijwerken ("YYYY-MM-DD|van|tot");
572
+ - leverdatum alleen aanpassen bij naar achteren;
573
+ - de order uit zijn orderbuffer halen zodat hij niet aan de oude dag vastzit;
574
+ - de klantmelding aanmaken als p_notify_customer true is;
575
+ - een order.changed-melding sturen en de hele takenketen (buffer, pick, controle,
576
+ printen, transport) opnieuw inplannen met logistics_schedule_tasks;
577
+ - het verzetten vastleggen in public.logistics_reschedules.
578
+
579
+ ------------------------------------------------------------------
580
+ WAT JE ABSOLUUT NIET DOET
581
+ ------------------------------------------------------------------
582
+ - Geen eigen UPDATE op orders, order_buffers, order_carts of logistics_tasks om
583
+ een datum of tijd te verzetten. Uitsluitend via de twee RPC's hierboven.
584
+ - Zelf planned_start / planned_end / due_at van taken herberekenen. Na het
585
+ opslaan lees je de taken gewoon opnieuw; ze staan dan al goed.
586
+ - Bij naar voren de leverdatum meeschuiven. Dat is expliciet fout.
587
+ - Bij naar achteren de klant informeren zonder dat de gebruiker dat heeft
588
+ aangevinkt, of een eigen mail sturen buiten de Engine om.
589
+
590
+ ------------------------------------------------------------------
591
+ NA HET OPSLAAN
592
+ ------------------------------------------------------------------
593
+ 1. Herlaad de taken van deze order uit logistics_tasks (planned_start bepaalt
594
+ waar de order in de pickagenda en het leverscherm verschijnt).
595
+ 2. Toon een bevestiging met de nieuwe ophaaldag, de ophaaltijd, de leverdatum en
596
+ of de klant is geïnformeerd (result.customerNotified).
597
+ 3. De verzetgeschiedenis kun je tonen met:
598
+ supabase.from("logistics_reschedules").select("*").eq("order_ref", ref)
599
+ .order("created_at", { ascending: false });
600
+
601
+ ------------------------------------------------------------------
602
+ CONTROLELIJST VOOR JEZELF (loop deze af voor je klaar meldt)
603
+ ------------------------------------------------------------------
604
+ [ ] Knop "Verzetten" bestaat bij een order.
605
+ [ ] Dagkeuze én ophaaltijd van/tot zijn in te vullen.
606
+ [ ] preview wordt live aangeroepen bij elke wijziging in het formulier.
607
+ [ ] Naar voren: leverdatum ongewijzigd, geen klantoptie zichtbaar.
608
+ [ ] Naar achteren: nieuwe leverdatum zichtbaar + klantoptie + reden.
609
+ [ ] Opslaan gaat via logistics_reschedule_order, nergens een eigen UPDATE.
610
610
  [ ] Na opslaan worden de taken opnieuw geladen en klopt de agenda.`,
611
611
  },
612
612
  {
@@ -614,40 +614,40 @@ CONTROLELIJST VOOR JEZELF (loop deze af voor je klaar meldt)
614
614
  title: "Capaciteitswaarschuwing tonen in de pick agenda",
615
615
  date: "2026-08-04",
616
616
  summary: "Nieuwe eis bovenop prompt 1 t/m 5: als er op een dag meer karren gepland staan dan er met het beschikbare personeel gepickt kunnen worden, moet de planning dat zichtbaar waarschuwen.",
617
- body: `LEES DIT EERST
618
-
619
- De Logistics Engine rekent per pickdag uit hoeveel picktijd alle geplande karren
620
- kosten en hoeveel picktijd er beschikbaar is (aantal medewerkers x werktijden uit
621
- "4. Pickstations"). Jij rekent NIETS zelf uit; je toont alleen wat de Engine geeft.
622
-
623
- STAP 1 — BEREKENEN (bij het openen van een week/dag)
624
- const { data: dagen } = await supabase.rpc("logistics_capacity_day_check", {
625
- p_from: "2026-08-03", // eerste dag van de getoonde periode
626
- p_to: "2026-08-09", // laatste dag
627
- });
628
-
629
- dagen is een array met per dag:
630
- { date, carts, requiredMinutes, availableMinutes, shortageMinutes, staff }
631
-
632
- STAP 2 — OPEN WAARSCHUWINGEN LEZEN
633
- const { data: alerts } = await supabase
634
- .from("logistics_capacity_alerts")
635
- .select("plan_date, required_minutes, available_minutes, shortage_minutes, carts_total, carts_short")
636
- .eq("status", "open");
637
-
638
- STAP 3 — TONEN (verplicht)
639
- - Weekoverzicht: elke dag met shortageMinutes > 0 krijgt een duidelijk zichtbare
640
- waarschuwing (amber/rood) met de tekst:
641
- "Te weinig capaciteit: {carts} karren vragen {requiredMinutes} min picktijd,
642
- beschikbaar is {availableMinutes} min ({staff} medewerkers).
643
- Circa {carts_short} karren passen niet op deze dag."
644
- - Dagdetails: dezelfde waarschuwing bovenaan het dagscherm.
645
- - Dagen zonder tekort krijgen GEEN waarschuwing.
646
- - Verzin geen eigen drempels, kleuren-logica of eigen berekening van picktijd.
647
-
648
- CONTROLELIJST
649
- [ ] logistics_capacity_day_check wordt aangeroepen bij elke periodewissel.
650
- [ ] Dagen met tekort tonen de waarschuwing in het weekoverzicht én in dagdetails.
617
+ body: `LEES DIT EERST
618
+
619
+ De Logistics Engine rekent per pickdag uit hoeveel picktijd alle geplande karren
620
+ kosten en hoeveel picktijd er beschikbaar is (aantal medewerkers x werktijden uit
621
+ "4. Pickstations"). Jij rekent NIETS zelf uit; je toont alleen wat de Engine geeft.
622
+
623
+ STAP 1 — BEREKENEN (bij het openen van een week/dag)
624
+ const { data: dagen } = await supabase.rpc("logistics_capacity_day_check", {
625
+ p_from: "2026-08-03", // eerste dag van de getoonde periode
626
+ p_to: "2026-08-09", // laatste dag
627
+ });
628
+
629
+ dagen is een array met per dag:
630
+ { date, carts, requiredMinutes, availableMinutes, shortageMinutes, staff }
631
+
632
+ STAP 2 — OPEN WAARSCHUWINGEN LEZEN
633
+ const { data: alerts } = await supabase
634
+ .from("logistics_capacity_alerts")
635
+ .select("plan_date, required_minutes, available_minutes, shortage_minutes, carts_total, carts_short")
636
+ .eq("status", "open");
637
+
638
+ STAP 3 — TONEN (verplicht)
639
+ - Weekoverzicht: elke dag met shortageMinutes > 0 krijgt een duidelijk zichtbare
640
+ waarschuwing (amber/rood) met de tekst:
641
+ "Te weinig capaciteit: {carts} karren vragen {requiredMinutes} min picktijd,
642
+ beschikbaar is {availableMinutes} min ({staff} medewerkers).
643
+ Circa {carts_short} karren passen niet op deze dag."
644
+ - Dagdetails: dezelfde waarschuwing bovenaan het dagscherm.
645
+ - Dagen zonder tekort krijgen GEEN waarschuwing.
646
+ - Verzin geen eigen drempels, kleuren-logica of eigen berekening van picktijd.
647
+
648
+ CONTROLELIJST
649
+ [ ] logistics_capacity_day_check wordt aangeroepen bij elke periodewissel.
650
+ [ ] Dagen met tekort tonen de waarschuwing in het weekoverzicht én in dagdetails.
651
651
  [ ] De getoonde cijfers komen letterlijk uit de Engine.`,
652
652
  },
653
653
  {
@@ -655,31 +655,31 @@ CONTROLELIJST
655
655
  title: "Geen capaciteitsmeldingen in Planning en leveringen",
656
656
  date: "2026-08-04",
657
657
  summary: "Nieuwe eis bovenop prompt 1 t/m 6: verwijder alle capaciteits- en foutmeldingen uit de agenda Planning en leveringen; de Engine blijft op de achtergrond controleren.",
658
- body: `AANVULLING op prompt 1 t/m 6. Deze nieuwste eis vervangt uitsluitend de
659
- zichtbare meldingen uit prompt 5 en 6 binnen het scherm "Planning en leveringen".
660
-
661
- Verwijder uit het weekoverzicht en de dagdetails van "Planning en leveringen":
662
- - de melding "Te weinig capaciteit";
663
- - aantallen tekortkomende minuten, medewerkers of karren;
664
- - rode, amberkleurige of andere fout-/waarschuwingsblokken uit
665
- public.logistics_capacity_alerts;
666
- - foutmeldingen die afkomstig zijn van logistics_capacity_day_check.
667
-
668
- De agenda toont alleen de planning, bestellingen, karren, planten en statussen.
669
- Een tekort mag de agenda niet visueel blokkeren of als foutmelding worden getoond.
670
-
671
- BELANGRIJK — alleen de zichtbaarheid vervalt:
672
- - Blijf logistics_capacity_day_check en logistics_capacity_plan_day uitvoeren waar
673
- dat nodig is voor de planning en automatische herverdeling.
674
- - Verwijder of sluit public.logistics_capacity_alerts niet.
675
- - Capaciteitsmeldingen blijven beschikbaar in het Regieoverzicht van de Logistics
676
- Engine en in het centrale Meldingencentrum.
677
- - Verberg echte technische fouten niet: een mislukte laad- of opslagactie mag nog
678
- steeds via een normale toast worden gemeld, maar niet als melding in de agenda.
679
-
680
- CONTROLELIJST
681
- [ ] In Planning en leveringen staat bij geen enkele dag een capaciteitsmelding.
682
- [ ] Het openen en wisselen van weken blijft de Engine-berekening uitvoeren.
658
+ body: `AANVULLING op prompt 1 t/m 6. Deze nieuwste eis vervangt uitsluitend de
659
+ zichtbare meldingen uit prompt 5 en 6 binnen het scherm "Planning en leveringen".
660
+
661
+ Verwijder uit het weekoverzicht en de dagdetails van "Planning en leveringen":
662
+ - de melding "Te weinig capaciteit";
663
+ - aantallen tekortkomende minuten, medewerkers of karren;
664
+ - rode, amberkleurige of andere fout-/waarschuwingsblokken uit
665
+ public.logistics_capacity_alerts;
666
+ - foutmeldingen die afkomstig zijn van logistics_capacity_day_check.
667
+
668
+ De agenda toont alleen de planning, bestellingen, karren, planten en statussen.
669
+ Een tekort mag de agenda niet visueel blokkeren of als foutmelding worden getoond.
670
+
671
+ BELANGRIJK — alleen de zichtbaarheid vervalt:
672
+ - Blijf logistics_capacity_day_check en logistics_capacity_plan_day uitvoeren waar
673
+ dat nodig is voor de planning en automatische herverdeling.
674
+ - Verwijder of sluit public.logistics_capacity_alerts niet.
675
+ - Capaciteitsmeldingen blijven beschikbaar in het Regieoverzicht van de Logistics
676
+ Engine en in het centrale Meldingencentrum.
677
+ - Verberg echte technische fouten niet: een mislukte laad- of opslagactie mag nog
678
+ steeds via een normale toast worden gemeld, maar niet als melding in de agenda.
679
+
680
+ CONTROLELIJST
681
+ [ ] In Planning en leveringen staat bij geen enkele dag een capaciteitsmelding.
682
+ [ ] Het openen en wisselen van weken blijft de Engine-berekening uitvoeren.
683
683
  [ ] Het Regieoverzicht kan de capaciteitsmeldingen nog steeds tonen.`,
684
684
  },
685
685
  {
@@ -687,28 +687,28 @@ CONTROLELIJST
687
687
  title: "Tekort in medewerkers tonen in de capaciteitswaarschuwing",
688
688
  date: "2026-08-04",
689
689
  summary: "Nieuwe eis bovenop prompt 1 t/m 7: elke capaciteitswaarschuwing vermeldt hoeveel medewerkers er tekort zijn, niet alleen minuten en karren.",
690
- body: `AANVULLING op prompt 6. De waarschuwing blijft weg uit "Planning en
691
- leveringen" (prompt 7); overal waar je hem WEL toont (Regieoverzicht,
692
- Meldingencentrum, dagdetails buiten de agenda) geldt onderstaande tekst.
693
-
694
- BEREKENING (verplicht, geen eigen variant)
695
- minutenPerMedewerker = availableMinutes / staff // staff > 0
696
- medewerkersTekort = Math.ceil(shortageMinutes / minutenPerMedewerker)
697
- Is staff 0 of availableMinutes 0, toon dan geen aantal maar de tekst
698
- "vul het gemiddeld aantal medewerkers in bij 3. Order picken".
699
-
700
- TEKST
701
- "Te weinig capaciteit: {carts} karren vragen {requiredMinutes} min picktijd,
702
- beschikbaar is {availableMinutes} min ({staff} medewerkers).
703
- Je komt {medewerkersTekort} medewerker(s) tekort — samen
704
- {staff + medewerkersTekort} nodig. Circa {carts_short} karren passen niet
705
- op deze dag."
706
-
707
- Gebruik enkelvoud "medewerker" bij 1, anders "medewerkers".
708
-
709
- CONTROLELIJST
710
- [ ] Elke zichtbare capaciteitswaarschuwing noemt het tekort in medewerkers.
711
- [ ] Het aantal komt uit de formule hierboven, niet uit een eigen aanname.
690
+ body: `AANVULLING op prompt 6. De waarschuwing blijft weg uit "Planning en
691
+ leveringen" (prompt 7); overal waar je hem WEL toont (Regieoverzicht,
692
+ Meldingencentrum, dagdetails buiten de agenda) geldt onderstaande tekst.
693
+
694
+ BEREKENING (verplicht, geen eigen variant)
695
+ minutenPerMedewerker = availableMinutes / staff // staff > 0
696
+ medewerkersTekort = Math.ceil(shortageMinutes / minutenPerMedewerker)
697
+ Is staff 0 of availableMinutes 0, toon dan geen aantal maar de tekst
698
+ "vul het gemiddeld aantal medewerkers in bij 3. Order picken".
699
+
700
+ TEKST
701
+ "Te weinig capaciteit: {carts} karren vragen {requiredMinutes} min picktijd,
702
+ beschikbaar is {availableMinutes} min ({staff} medewerkers).
703
+ Je komt {medewerkersTekort} medewerker(s) tekort — samen
704
+ {staff + medewerkersTekort} nodig. Circa {carts_short} karren passen niet
705
+ op deze dag."
706
+
707
+ Gebruik enkelvoud "medewerker" bij 1, anders "medewerkers".
708
+
709
+ CONTROLELIJST
710
+ [ ] Elke zichtbare capaciteitswaarschuwing noemt het tekort in medewerkers.
711
+ [ ] Het aantal komt uit de formule hierboven, niet uit een eigen aanname.
712
712
  [ ] Zonder ingevuld personeel toont de melding de invulhint in plaats van 0.`,
713
713
  },
714
714
  ],
@@ -723,12 +723,12 @@ CONTROLELIJST
723
723
  date: "2026-07-24",
724
724
  summary: "Pick-taken tonen en terugmelden.",
725
725
  withSharedContract: true,
726
- body: `Haal weg: eigen pickvolgorde en eigen bepaling van de starttijd.
727
-
728
- Bouw:
729
- - pick.execute taken tonen, gesorteerd op planned_start.
730
- - Payload: pickMode, pickStartMode, pickMinutes, staff, reserveMinutes, scanner, loadCarriers.
731
- - Voortgang terugmelden via RPC: logistics_claim_task bij starten, logistics_complete_task bij afronden.
726
+ body: `Haal weg: eigen pickvolgorde en eigen bepaling van de starttijd.
727
+
728
+ Bouw:
729
+ - pick.execute taken tonen, gesorteerd op planned_start.
730
+ - Payload: pickMode, pickStartMode, pickMinutes, staff, reserveMinutes, scanner, loadCarriers.
731
+ - Voortgang terugmelden via RPC: logistics_claim_task bij starten, logistics_complete_task bij afronden.
732
732
  - Te-laat-dreigende belading markeren op basis van planned_end; niet zelf herrekenen.`,
733
733
  },
734
734
  {
@@ -736,26 +736,26 @@ Bouw:
736
736
  title: "Documenten per pickstation vanuit de Engine",
737
737
  date: "2026-08-03",
738
738
  summary: "Documenttaken tonen op het juiste pickstation, inclusief goedkeuring.",
739
- body: `Deze prompt vervangt niets uit prompt 1; hij komt er bovenop.
740
-
741
- Haal weg: eigen logica over welk document op welk pickstation verschijnt en
742
- wanneer. De Logistics Engine bepaalt dit volledig.
743
-
744
- Verwerk deze taaktypes uit logistics_tasks:
745
- - print.packing_slip, print.sticker, print.shipping_note, print.production_note
746
-
747
- Payload per taak:
748
- - release wanneer het document vrijkomt
749
- - pickStationId public.pick_stations.id waar het document heen moet
750
- - pickStationTypeId public.pick_station_types.id dat het document mag ontvangen
751
- - requiresApproval true = eerst handmatige goedkeuring op het pickstation
752
-
753
- Regels:
754
- - Toon een document pas vanaf planned_start van de taak.
755
- - Filter de wachtrij van een pickstation op pickStationId; is die leeg, gebruik
756
- dan pickStationTypeId. Toon nooit documenten van een ander station.
757
- - requiresApproval = true: toon een goedkeurknop; pas na goedkeuren printen en
758
- daarna logistics_complete_task aanroepen (bij weigeren logistics_fail_task).
739
+ body: `Deze prompt vervangt niets uit prompt 1; hij komt er bovenop.
740
+
741
+ Haal weg: eigen logica over welk document op welk pickstation verschijnt en
742
+ wanneer. De Logistics Engine bepaalt dit volledig.
743
+
744
+ Verwerk deze taaktypes uit logistics_tasks:
745
+ - print.packing_slip, print.sticker, print.shipping_note, print.production_note
746
+
747
+ Payload per taak:
748
+ - release wanneer het document vrijkomt
749
+ - pickStationId public.pick_stations.id waar het document heen moet
750
+ - pickStationTypeId public.pick_station_types.id dat het document mag ontvangen
751
+ - requiresApproval true = eerst handmatige goedkeuring op het pickstation
752
+
753
+ Regels:
754
+ - Toon een document pas vanaf planned_start van de taak.
755
+ - Filter de wachtrij van een pickstation op pickStationId; is die leeg, gebruik
756
+ dan pickStationTypeId. Toon nooit documenten van een ander station.
757
+ - requiresApproval = true: toon een goedkeurknop; pas na goedkeuren printen en
758
+ daarna logistics_complete_task aanroepen (bij weigeren logistics_fail_task).
759
759
  - Bepaal nooit zelf een vrijgavemoment en print nooit vooruit.`,
760
760
  },
761
761
  {
@@ -763,32 +763,32 @@ Regels:
763
763
  title: "Documenten ophalen via de Floriday-gateway",
764
764
  date: "2026-08-04",
765
765
  summary: "Geen eigen Floriday-token of florydayFetch meer; gebundeld printen per kar.",
766
- body: `Deze prompt vervangt niets uit prompt 1 en 2; hij komt er bovenop.
767
-
768
- Haal weg: eigen Floriday-tokenlogica, eigen florydayFetch, eigen keuze van
769
- staging/live en eigen HTTP-aanroepen naar de Floriday-gateway.
770
-
771
- Alle modules draaien in dezelfde shell op dezelfde database. Importeer de
772
- gateway daarom rechtstreeks en geef de service-role supabase-client van de
773
- shell mee:
774
-
775
- import {
776
- runActiveEnvironment,
777
- runPdf,
778
- runPdfBulkMerged,
779
- } from "@flowselections/floriday-authenticatie-module/gateway";
780
-
781
- Regels:
782
- - De omgeving komt altijd uit runActiveEnvironment(supabase). Nooit zelf kiezen.
783
- - Eén document (print.packing_slip, print.sticker, print.shipping_note,
784
- print.production_note): runPdf.
785
- - Trigger "kar afgemeld" of "kar-scan": bundel alle regels van die kar en roep
786
- runPdfBulkMerged aan, zodat het pickstation één printjob krijgt in plaats van
787
- losse documenten.
788
- - Toon bovenin het scherm welke koppeling actief is (label, GLN, staging/live).
789
- - Print nooit twee keer hetzelfde: controleer public.logistics_document_prints
790
- op (order_ref, document_type, trigger) voordat je print.
791
- - Trigger en pickstation blijven van de Logistics Engine; de gateway levert
766
+ body: `Deze prompt vervangt niets uit prompt 1 en 2; hij komt er bovenop.
767
+
768
+ Haal weg: eigen Floriday-tokenlogica, eigen florydayFetch, eigen keuze van
769
+ staging/live en eigen HTTP-aanroepen naar de Floriday-gateway.
770
+
771
+ Alle modules draaien in dezelfde shell op dezelfde database. Importeer de
772
+ gateway daarom rechtstreeks en geef de service-role supabase-client van de
773
+ shell mee:
774
+
775
+ import {
776
+ runActiveEnvironment,
777
+ runPdf,
778
+ runPdfBulkMerged,
779
+ } from "@flowselections/floriday-authenticatie-module/gateway";
780
+
781
+ Regels:
782
+ - De omgeving komt altijd uit runActiveEnvironment(supabase). Nooit zelf kiezen.
783
+ - Eén document (print.packing_slip, print.sticker, print.shipping_note,
784
+ print.production_note): runPdf.
785
+ - Trigger "kar afgemeld" of "kar-scan": bundel alle regels van die kar en roep
786
+ runPdfBulkMerged aan, zodat het pickstation één printjob krijgt in plaats van
787
+ losse documenten.
788
+ - Toon bovenin het scherm welke koppeling actief is (label, GLN, staging/live).
789
+ - Print nooit twee keer hetzelfde: controleer public.logistics_document_prints
790
+ op (order_ref, document_type, trigger) voordat je print.
791
+ - Trigger en pickstation blijven van de Logistics Engine; de gateway levert
792
792
  alleen het PDF-bestand.`,
793
793
  },
794
794
  {
@@ -796,29 +796,29 @@ Regels:
796
796
  title: "Strikte documentroutering per pickstation",
797
797
  date: "2026-08-04",
798
798
  summary: "Een pickstation toont uitsluitend de documentsoorten die eraan gekoppeld zijn.",
799
- body: `Deze prompt vervangt niets uit prompt 1 t/m 3; hij komt er bovenop.
800
-
801
- Probleem: op "Pickstation Orders" verschenen naast pakbonnen ook veilingbrieven
802
- en transportbrieven. Dat mag nooit.
803
-
804
- Haal weg: elke query die de wachtrij alleen op station_id filtert, en elke
805
- fallback die "overige documenten" toch ergens toont.
806
-
807
- Regels:
808
- - Filter de wachtrij ALTIJD op screen_id van het geopende scherm, niet op
809
- station_id. Elk scherm heeft via public.pick_screen_document_types precies de
810
- documenttypes die het mag tonen.
811
- - Toon nooit een document waarvan het document_type_id niet aan dat scherm is
812
- gekoppeld. Geen "rest"-categorie, geen samengevoegde stationweergave.
813
- - De koppeling documentsoort -> pickstation komt uit de Logistiek Engine
814
- (Rule Engine, stap "Pickstations"). In de database is dat opvraagbaar met
815
- select public.logistics_document_station('pakbon').
816
- - De printwachtrij public.pick_queue heeft een trigger die station_id en
817
- screen_id herschrijft volgens die instelling. Schrijf zelf nooit een
818
- station_id dat daarvan afwijkt; dat wordt overschreven of geweigerd.
819
- - Taken uit logistics_tasks dragen payload.documentType en payload.pickStationId.
820
- Gebruik die twee samen; nooit alleen het taaktype.
821
- - Standaardweergave is "documenten van vandaag". Oudere, niet-geprinte regels
799
+ body: `Deze prompt vervangt niets uit prompt 1 t/m 3; hij komt er bovenop.
800
+
801
+ Probleem: op "Pickstation Orders" verschenen naast pakbonnen ook veilingbrieven
802
+ en transportbrieven. Dat mag nooit.
803
+
804
+ Haal weg: elke query die de wachtrij alleen op station_id filtert, en elke
805
+ fallback die "overige documenten" toch ergens toont.
806
+
807
+ Regels:
808
+ - Filter de wachtrij ALTIJD op screen_id van het geopende scherm, niet op
809
+ station_id. Elk scherm heeft via public.pick_screen_document_types precies de
810
+ documenttypes die het mag tonen.
811
+ - Toon nooit een document waarvan het document_type_id niet aan dat scherm is
812
+ gekoppeld. Geen "rest"-categorie, geen samengevoegde stationweergave.
813
+ - De koppeling documentsoort -> pickstation komt uit de Logistiek Engine
814
+ (Rule Engine, stap "Pickstations"). In de database is dat opvraagbaar met
815
+ select public.logistics_document_station('pakbon').
816
+ - De printwachtrij public.pick_queue heeft een trigger die station_id en
817
+ screen_id herschrijft volgens die instelling. Schrijf zelf nooit een
818
+ station_id dat daarvan afwijkt; dat wordt overschreven of geweigerd.
819
+ - Taken uit logistics_tasks dragen payload.documentType en payload.pickStationId.
820
+ Gebruik die twee samen; nooit alleen het taaktype.
821
+ - Standaardweergave is "documenten van vandaag". Oudere, niet-geprinte regels
822
822
  horen in een apart tabblad, niet in de dagwachtrij.`,
823
823
  },
824
824
  {
@@ -826,41 +826,41 @@ Regels:
826
826
  title: "Documenten altijd renderen met de layout uit de Layout maker",
827
827
  date: "2026-08-04",
828
828
  summary: "Geen eigen pakbon-opmaak meer; de layout komt uit public.document_layouts.",
829
- body: `Deze prompt vervangt niets uit prompt 1 t/m 4; hij komt er bovenop.
830
-
831
- Probleem: het pickstation print een eigen, hardgecodeerde pakbon. De pakbon die
832
- in de module "Layout maker (pakbonnen, verzendbrieven, extra)" is ontworpen
833
- wordt genegeerd.
834
-
835
- Haal weg: elke eigen HTML/PDF-opmaak van pakbonnen, verzendbrieven, stickers,
836
- productiebonnen en controlelijsten. Ook alle vaste kolommen, logo's, marges en
837
- papierformaten die in de pickstation-code staan.
838
-
839
- Regels:
840
- - De opmaak komt ALTIJD uit public.document_layouts (+ document_layout_elements,
841
- document_layout_variables, document_layout_versions, layout_logos). Nooit een
842
- eigen sjabloon, ook niet als fallback.
843
- - Welke layout bij een documentsoort hoort, bepaal je niet zelf. Gebruik:
844
- select public.logistics_document_layout('pakbon');
845
- Dat geeft { layoutId, layoutName, layoutVersion, layoutDocumentType } van de
846
- actieve layout (voorkeur: is_standaard).
847
- - Elke regel in public.pick_queue draagt deze gegevens al mee in payload:
848
- documentType, layoutId, layoutName, layoutVersion. Gebruik payload.layoutId
849
- als die er staat; val alleen terug op de functie hierboven als hij ontbreekt.
850
- - Render met de renderer van de Layout maker, niet met eigen code. Papierformaat,
851
- oriëntatie en marges komen uit de layoutrij (papierformaat, breedte_mm,
852
- hoogte_mm, marge_*, orientatie, page_settings).
853
- - Ontbreekt er een actieve layout voor een documentsoort? Print dan niet, maar
854
- toon "Geen layout ingesteld voor <documentsoort>" met een verwijzing naar de
855
- Layout maker. Nooit stilzwijgend een eigen pakbon printen.
856
- - Floriday-documenten (prompt 3) blijven via de gateway lopen; alles wat we zelf
857
- opmaken loopt via de Layout maker.
858
- - Log bij het afronden van de taak welke layoutId en layoutVersion zijn gebruikt
859
- in het result van logistics_complete_task.
860
-
861
- CONTROLELIJST
862
- [ ] Geen enkel eigen documentsjabloon meer in de code.
863
- [ ] Pakbon in het pickstation is visueel identiek aan de preview in de Layout maker.
829
+ body: `Deze prompt vervangt niets uit prompt 1 t/m 4; hij komt er bovenop.
830
+
831
+ Probleem: het pickstation print een eigen, hardgecodeerde pakbon. De pakbon die
832
+ in de module "Layout maker (pakbonnen, verzendbrieven, extra)" is ontworpen
833
+ wordt genegeerd.
834
+
835
+ Haal weg: elke eigen HTML/PDF-opmaak van pakbonnen, verzendbrieven, stickers,
836
+ productiebonnen en controlelijsten. Ook alle vaste kolommen, logo's, marges en
837
+ papierformaten die in de pickstation-code staan.
838
+
839
+ Regels:
840
+ - De opmaak komt ALTIJD uit public.document_layouts (+ document_layout_elements,
841
+ document_layout_variables, document_layout_versions, layout_logos). Nooit een
842
+ eigen sjabloon, ook niet als fallback.
843
+ - Welke layout bij een documentsoort hoort, bepaal je niet zelf. Gebruik:
844
+ select public.logistics_document_layout('pakbon');
845
+ Dat geeft { layoutId, layoutName, layoutVersion, layoutDocumentType } van de
846
+ actieve layout (voorkeur: is_standaard).
847
+ - Elke regel in public.pick_queue draagt deze gegevens al mee in payload:
848
+ documentType, layoutId, layoutName, layoutVersion. Gebruik payload.layoutId
849
+ als die er staat; val alleen terug op de functie hierboven als hij ontbreekt.
850
+ - Render met de renderer van de Layout maker, niet met eigen code. Papierformaat,
851
+ oriëntatie en marges komen uit de layoutrij (papierformaat, breedte_mm,
852
+ hoogte_mm, marge_*, orientatie, page_settings).
853
+ - Ontbreekt er een actieve layout voor een documentsoort? Print dan niet, maar
854
+ toon "Geen layout ingesteld voor <documentsoort>" met een verwijzing naar de
855
+ Layout maker. Nooit stilzwijgend een eigen pakbon printen.
856
+ - Floriday-documenten (prompt 3) blijven via de gateway lopen; alles wat we zelf
857
+ opmaken loopt via de Layout maker.
858
+ - Log bij het afronden van de taak welke layoutId en layoutVersion zijn gebruikt
859
+ in het result van logistics_complete_task.
860
+
861
+ CONTROLELIJST
862
+ [ ] Geen enkel eigen documentsjabloon meer in de code.
863
+ [ ] Pakbon in het pickstation is visueel identiek aan de preview in de Layout maker.
864
864
  [ ] Ontbrekende layout geeft een duidelijke melding in plaats van een print.`,
865
865
  },
866
866
  {
@@ -868,52 +868,90 @@ CONTROLELIJST
868
868
  title: "Sectie-layouts uit de Layout maker correct printen",
869
869
  date: "2026-08-04",
870
870
  summary: "Een geldige pakbon in document_layouts.config mag nooit als ontbrekende layout worden afgewezen.",
871
- body: `Deze prompt vervangt niets uit prompt 1 t/m 5; hij komt er bovenop.
872
-
873
- Probleem: de gekoppelde layout "packbon hoofd" is een geldige sectie-layout.
874
- De opbouw staat in public.document_layouts.config.pakbon.secties en niet in
875
- public.document_layout_elements. Het pickstation ondersteunt nu alleen
876
- canvas-elementen en toont daardoor ten onrechte "Geen layout ingesteld".
877
-
878
- Haal weg:
879
- - elke controle die een layout als ontbrekend beschouwt wanneer
880
- document_layout_elements leeg is;
881
- - elke renderer die uitsluitend document_layout_elements ondersteunt;
882
- - de algemene MissingLayoutError voor een wel bestaande, actieve layoutrij.
883
-
884
- Regels:
885
- - Een layout ontbreekt uitsluitend als public.document_layouts geen actieve rij
886
- voor het door de Engine aangeleverde layoutId bevat. Nul canvas-elementen is
887
- geen ontbrekende layout.
888
- - Lees eerst payload.layoutId (of payload.layout_id) uit public.pick_queue.
889
- De huidige pakbonnen verwijzen daarmee naar de gekoppelde layoutrij.
890
- - Kies daarna de renderer op basis van de opgeslagen layoutvorm:
891
- 1. config.pakbon.secties is een array: gebruik dezelfde sectie-/pakbonrenderer
892
- en dezelfde datamapping als de preview van de Layout maker;
893
- 2. document_layout_elements bevat rijen: gebruik de canvasrenderer;
894
- 3. geen van beide bevat inhoud: meld "Layout heeft nog geen inhoud", niet
895
- "Geen layout ingesteld".
896
- - Importeer de renderer en bijbehorende types bij voorkeur rechtstreeks uit de
897
- Layout maker-module. Kopieer geen pakbonsjabloon naar deze module. Als de
898
- Layout maker de renderer nog niet exporteert, voeg daar named exports toe voor
899
- de sectierenderer en de order-naar-pakbon-datamapping en gebruik die hier.
900
- - Respecteer config.pakbon.secties volledig: volgorde, zichtbaar, condities,
901
- opties, karren, lagen, producten, totalen en logo. Respecteer daarnaast
902
- papierformaat, oriëntatie, marges en page_settings van document_layouts.
903
- - Vul vóór renderen de volledige ordercontext voor payload.orderId of
904
- order_number: order, klant, afleveradres, orderregels, karren, lagen,
905
- producten en fusten. De wachtrijregel alleen bevat hiervoor onvoldoende data.
906
- - Markeer de wachtrijregel pas als geprint nadat renderen is gelukt en de
907
- printdialoog is geopend. Laat de regel bij een renderfout in de wachtrij staan.
908
-
909
- CONTROLELIJST
910
- [ ] "packbon hoofd" opent vanuit Pickstation Orders zonder MissingLayoutError.
911
- [ ] De afdruk is visueel gelijk aan de preview in de Layout maker.
912
- [ ] Karren, lagen en producten van de gekozen order staan op de pakbon.
913
- [ ] Een lege layout geeft "Layout heeft nog geen inhoud".
914
- [ ] Een werkelijk ontbrekende/inactieve layoutrij geeft pas "Geen layout ingesteld".
871
+ body: `Deze prompt vervangt niets uit prompt 1 t/m 5; hij komt er bovenop.
872
+
873
+ Probleem: de gekoppelde layout "packbon hoofd" is een geldige sectie-layout.
874
+ De opbouw staat in public.document_layouts.config.pakbon.secties en niet in
875
+ public.document_layout_elements. Het pickstation ondersteunt nu alleen
876
+ canvas-elementen en toont daardoor ten onrechte "Geen layout ingesteld".
877
+
878
+ Haal weg:
879
+ - elke controle die een layout als ontbrekend beschouwt wanneer
880
+ document_layout_elements leeg is;
881
+ - elke renderer die uitsluitend document_layout_elements ondersteunt;
882
+ - de algemene MissingLayoutError voor een wel bestaande, actieve layoutrij.
883
+
884
+ Regels:
885
+ - Een layout ontbreekt uitsluitend als public.document_layouts geen actieve rij
886
+ voor het door de Engine aangeleverde layoutId bevat. Nul canvas-elementen is
887
+ geen ontbrekende layout.
888
+ - Lees eerst payload.layoutId (of payload.layout_id) uit public.pick_queue.
889
+ De huidige pakbonnen verwijzen daarmee naar de gekoppelde layoutrij.
890
+ - Kies daarna de renderer op basis van de opgeslagen layoutvorm:
891
+ 1. config.pakbon.secties is een array: gebruik dezelfde sectie-/pakbonrenderer
892
+ en dezelfde datamapping als de preview van de Layout maker;
893
+ 2. document_layout_elements bevat rijen: gebruik de canvasrenderer;
894
+ 3. geen van beide bevat inhoud: meld "Layout heeft nog geen inhoud", niet
895
+ "Geen layout ingesteld".
896
+ - Importeer de renderer en bijbehorende types bij voorkeur rechtstreeks uit de
897
+ Layout maker-module. Kopieer geen pakbonsjabloon naar deze module. Als de
898
+ Layout maker de renderer nog niet exporteert, voeg daar named exports toe voor
899
+ de sectierenderer en de order-naar-pakbon-datamapping en gebruik die hier.
900
+ - Respecteer config.pakbon.secties volledig: volgorde, zichtbaar, condities,
901
+ opties, karren, lagen, producten, totalen en logo. Respecteer daarnaast
902
+ papierformaat, oriëntatie, marges en page_settings van document_layouts.
903
+ - Vul vóór renderen de volledige ordercontext voor payload.orderId of
904
+ order_number: order, klant, afleveradres, orderregels, karren, lagen,
905
+ producten en fusten. De wachtrijregel alleen bevat hiervoor onvoldoende data.
906
+ - Markeer de wachtrijregel pas als geprint nadat renderen is gelukt en de
907
+ printdialoog is geopend. Laat de regel bij een renderfout in de wachtrij staan.
908
+
909
+ CONTROLELIJST
910
+ [ ] "packbon hoofd" opent vanuit Pickstation Orders zonder MissingLayoutError.
911
+ [ ] De afdruk is visueel gelijk aan de preview in de Layout maker.
912
+ [ ] Karren, lagen en producten van de gekozen order staan op de pakbon.
913
+ [ ] Een lege layout geeft "Layout heeft nog geen inhoud".
914
+ [ ] Een werkelijk ontbrekende/inactieve layoutrij geeft pas "Geen layout ingesteld".
915
915
  [ ] De wachtrij wordt alleen afgerond na een geslaagde render/printactie.`,
916
916
  },
917
+ {
918
+ number: 7,
919
+ title: "Altijd de actuele layout, behalve bij kant-en-klare PDF's",
920
+ date: "2026-08-14",
921
+ summary: "Layout wint boven meegestuurde HTML; klantstickers en Floriday-documenten gaan als bestaande PDF ongewijzigd naar de printer.",
922
+ body: `Deze prompt vervangt niets uit prompt 1 t/m 6; hij komt er bovenop.
923
+
924
+ Uitgangspunt: wat er geprint wordt is ALTIJD de actuele layout uit de Layout
925
+ maker, gevuld met de echte gegevens van de order en de klant. Enige uitzondering:
926
+ documenten die al als kant-en-klare PDF bestaan (klantstickers en
927
+ Floriday-documenten). Die worden ongewijzigd doorgestuurd.
928
+
929
+ Volgorde van beslissen bij een printopdracht in public.print_jobs:
930
+ 1. Is er een kant-en-klare PDF meegegeven (pdf-veld op de opdracht / bron uit
931
+ floriday_customer_sticker_pdfs_cache): die PDF ongewijzigd naar de printer.
932
+ Niet opnieuw opmaken, niet renderen.
933
+ 2. Is print_jobs.layout_id gevuld: die layout wint. Negeer een eventueel
934
+ meegestuurde render_html en render vers uit public.document_layouts.
935
+ 3. Pas als beide leeg zijn: meegestuurde render_html, en anders de actieve
936
+ layout bij het documenttype.
937
+
938
+ Haal weg:
939
+ - elke eigen HTML-sjabloon die om de layout heen print;
940
+ - elke gecachte kopie van een layout; de layout wordt per opdracht live gelezen.
941
+
942
+ Regels:
943
+ - layout_id en printer_id komen uit de Engine (public.pick_enqueue_print_job).
944
+ Kies zelf nooit een andere layout of printer wanneer die velden gevuld zijn.
945
+ - Statussen blijven binnen de enum print_job_status: wachtend, bezig, voltooid,
946
+ mislukt, geannuleerd. Andere modules luisteren daarop.
947
+ - Geen PDF én geen layout: markeer de opdracht als mislukt met een leesbare
948
+ reden in foutmelding. Nooit blanco printen.
949
+
950
+ CONTROLELIJST
951
+ [ ] Layout aangepast in de Layout maker -> eerstvolgende print toont de wijziging.
952
+ [ ] Klantsticker en Floriday-document komen er exact uit zoals aangeleverd.
953
+ [ ] Geen enkele printer- of layoutnaam hardcoded in deze module.`,
954
+ },
917
955
  ],
918
956
  },
919
957
  scanners: {
@@ -926,12 +964,12 @@ CONTROLELIJST
926
964
  date: "2026-07-24",
927
965
  summary: "Scan- en controletaken uitvoeren.",
928
966
  withSharedContract: true,
929
- body: `Haal weg: eigen aannames over wat en wanneer er gescand moet worden.
930
-
931
- Bouw:
932
- - scan.verify taken; payload reason = pick_scanner_required of kar_vullen_manual_scan.
933
- - control.execute taken met controlMode "scanner" = de scancontrole.
934
- - Scanresultaat meesturen in logistics_complete_task (p_result).
967
+ body: `Haal weg: eigen aannames over wat en wanneer er gescand moet worden.
968
+
969
+ Bouw:
970
+ - scan.verify taken; payload reason = pick_scanner_required of kar_vullen_manual_scan.
971
+ - control.execute taken met controlMode "scanner" = de scancontrole.
972
+ - Scanresultaat meesturen in logistics_complete_task (p_result).
935
973
  - Bij afwijking logistics_fail_task met toelichting.`,
936
974
  },
937
975
  ],
@@ -946,11 +984,11 @@ Bouw:
946
984
  date: "2026-07-24",
947
985
  summary: "Reserveringstaken uitvoeren en voorraadwijzigingen melden.",
948
986
  withSharedContract: true,
949
- body: `Haal weg: eigen beslissing wanneer er gereserveerd of afgeboekt wordt.
950
-
951
- Bouw:
952
- - stock.reserve taken uitvoeren; payload bevat loadCarriers.
953
- - Bij relevante voorraadwijziging een gebeurtenis melden met event_type
987
+ body: `Haal weg: eigen beslissing wanneer er gereserveerd of afgeboekt wordt.
988
+
989
+ Bouw:
990
+ - stock.reserve taken uitvoeren; payload bevat loadCarriers.
991
+ - Bij relevante voorraadwijziging een gebeurtenis melden met event_type
954
992
  stock.changed en dezelfde order_ref, zodat de Engine kan herplannen.`,
955
993
  },
956
994
  ],
@@ -965,10 +1003,10 @@ Bouw:
965
1003
  date: "2026-07-24",
966
1004
  summary: "Strategie koppelen aan klant en klantgroep.",
967
1005
  withSharedContract: true,
968
- body: `Bouw:
969
- - Per klant en per klantgroep een koppelveld naar de logistieke strategie
970
- (logistics_strategies.id), zodat de Engine weet welke rule config geldt.
971
- - Dit veld meegeven als strategy_id bij logistics_emit_event, of beschikbaar
1006
+ body: `Bouw:
1007
+ - Per klant en per klantgroep een koppelveld naar de logistieke strategie
1008
+ (logistics_strategies.id), zodat de Engine weet welke rule config geldt.
1009
+ - Dit veld meegeven als strategy_id bij logistics_emit_event, of beschikbaar
972
1010
  maken zodat de Verkoop-module het kan meegeven.`,
973
1011
  },
974
1012
  ],
@@ -983,18 +1021,18 @@ Bouw:
983
1021
  date: "2026-07-31",
984
1022
  summary: "Eerste koppelprompt: mail alleen omzetten naar order als de Engine dat toestaat.",
985
1023
  withSharedContract: true,
986
- body: `Haal weg: eigen aannames over of een bestelling met te weinig voorraad
987
- toch mag worden aangemaakt.
988
-
989
- ${STOCK_CONTRACT}
990
-
991
- In de Mailbox-module concreet:
992
- - Vóór het omzetten van een mail naar een bestelling altijd
993
- logistics_check_order_allowed aanroepen met alle orderregels.
994
- - allowed = false -> maak de bestelling NIET aan. Zet de mail op status
995
- "geblokkeerd - onvoldoende voorraad" en toon per product wanted/available/missing
996
- uit check.shortages, zodat een medewerker het handmatig kan oplossen.
997
- - allowed = true -> bestelling normaal aanmaken en daarna de gebeurtenis melden
1024
+ body: `Haal weg: eigen aannames over of een bestelling met te weinig voorraad
1025
+ toch mag worden aangemaakt.
1026
+
1027
+ ${STOCK_CONTRACT}
1028
+
1029
+ In de Mailbox-module concreet:
1030
+ - Vóór het omzetten van een mail naar een bestelling altijd
1031
+ logistics_check_order_allowed aanroepen met alle orderregels.
1032
+ - allowed = false -> maak de bestelling NIET aan. Zet de mail op status
1033
+ "geblokkeerd - onvoldoende voorraad" en toon per product wanted/available/missing
1034
+ uit check.shortages, zodat een medewerker het handmatig kan oplossen.
1035
+ - allowed = true -> bestelling normaal aanmaken en daarna de gebeurtenis melden
998
1036
  via logistics_emit_event (order.received) met een unieke p_idempotency_key.`,
999
1037
  },
1000
1038
  {
@@ -1002,39 +1040,39 @@ In de Mailbox-module concreet:
1002
1040
  title: "Bufferbesluit altijd bij de Engine opvragen",
1003
1041
  date: "2026-08-02",
1004
1042
  summary: "Nieuwe eis bovenop prompt 1: geen eigen bufferlogica; bufferRef komt uit logistics_buffer_decision.",
1005
- body: `AANVULLING op koppelprompt 1 (die blijft gewoon geldig).
1006
-
1007
- Haal weg: elke eigen regel of aanname over het samenvoegen van bestellingen uit
1008
- dezelfde mail, dezelfde afzender of hetzelfde afleveradres.
1009
-
1010
- Nieuwe verplichting: vraag na de voorraadcontrole, vóór het aanmaken van de
1011
- bestelling, het bufferbesluit op bij de Engine:
1012
-
1013
- const { data: besluit } = await supabase.rpc("logistics_buffer_decision", {
1014
- p_order: {
1015
- orderRef: "MAIL-12345",
1016
- checkinAt: "2026-08-03T09:00:00Z",
1017
- deliveryDate: "2026-08-03",
1018
- customerRef: "CUST-1",
1019
- floridayCustomerRef: "FLOR-1",
1020
- bvoCustomerRef: "BVO-1",
1021
- deliveryLocationRef: "LOC-1",
1022
- carrierRef: "TRANS-1",
1023
- loadCarrierType: "trolley",
1024
- orderType: "standaard",
1025
- },
1026
- p_strategy_id: null,
1027
- });
1028
- // besluit = { buffer, reason, bufferRef, bufferKey, matchCriteria,
1029
- // closeBeforeMinutes, bufferCloseAt, release, trace }
1030
-
1031
- Regels:
1032
- - besluit.buffer === false -> bestelling los aanmaken, geen buffer toewijzen.
1033
- - besluit.buffer === true -> gebruik exact besluit.bufferRef en stuur die mee in de
1034
- payload van logistics_emit_event.
1035
- - Ontbrekende velden zorgen ervoor dat de Engine NIET combineert; vul daarom altijd
1036
- alle bovenstaande velden zo compleet mogelijk uit de mail/klantgegevens.
1037
- - Toon besluit.reason en besluit.trace in het mailscherm, zodat een medewerker ziet
1043
+ body: `AANVULLING op koppelprompt 1 (die blijft gewoon geldig).
1044
+
1045
+ Haal weg: elke eigen regel of aanname over het samenvoegen van bestellingen uit
1046
+ dezelfde mail, dezelfde afzender of hetzelfde afleveradres.
1047
+
1048
+ Nieuwe verplichting: vraag na de voorraadcontrole, vóór het aanmaken van de
1049
+ bestelling, het bufferbesluit op bij de Engine:
1050
+
1051
+ const { data: besluit } = await supabase.rpc("logistics_buffer_decision", {
1052
+ p_order: {
1053
+ orderRef: "MAIL-12345",
1054
+ checkinAt: "2026-08-03T09:00:00Z",
1055
+ deliveryDate: "2026-08-03",
1056
+ customerRef: "CUST-1",
1057
+ floridayCustomerRef: "FLOR-1",
1058
+ bvoCustomerRef: "BVO-1",
1059
+ deliveryLocationRef: "LOC-1",
1060
+ carrierRef: "TRANS-1",
1061
+ loadCarrierType: "trolley",
1062
+ orderType: "standaard",
1063
+ },
1064
+ p_strategy_id: null,
1065
+ });
1066
+ // besluit = { buffer, reason, bufferRef, bufferKey, matchCriteria,
1067
+ // closeBeforeMinutes, bufferCloseAt, release, trace }
1068
+
1069
+ Regels:
1070
+ - besluit.buffer === false -> bestelling los aanmaken, geen buffer toewijzen.
1071
+ - besluit.buffer === true -> gebruik exact besluit.bufferRef en stuur die mee in de
1072
+ payload van logistics_emit_event.
1073
+ - Ontbrekende velden zorgen ervoor dat de Engine NIET combineert; vul daarom altijd
1074
+ alle bovenstaande velden zo compleet mogelijk uit de mail/klantgegevens.
1075
+ - Toon besluit.reason en besluit.trace in het mailscherm, zodat een medewerker ziet
1038
1076
  waarom een bestelling wel of niet is samengevoegd.`,
1039
1077
  },
1040
1078
  {
@@ -1042,39 +1080,39 @@ Regels:
1042
1080
  title: "Alleen ladingdragers gebruiken die de Engine toestaat",
1043
1081
  date: "2026-08-03",
1044
1082
  summary: "Nieuwe eis bovenop prompt 1 en 2: uitgeschakelde ladingdragers mogen niet meer worden gekozen of ingelezen.",
1045
- body: `AANVULLING op koppelprompt 1 en 2 (die blijven gewoon geldig).
1046
-
1047
- In de Rule Engine (stap Beladingindeling) staat welke ladingdragers zijn toegestaan.
1048
- Staat een ladingdrager uit, dan mag de Mailbox-module die niet meer kiezen of
1049
- automatisch invullen.
1050
-
1051
- Haal weg: elke eigen lijst met ladingdragers / verzendmethodes en elke eigen
1052
- vertaling van tekst uit een mail naar een ladingdrager die niet uit de Engine komt.
1053
-
1054
- Nieuwe verplichting: haal de lijst op bij de Engine.
1055
-
1056
- const { data: dragers } = await supabase.rpc("logistics_allowed_load_carriers", {
1057
- p_strategy_id: null,
1058
- });
1059
- // dragers = { allowed: [...], default: "trolley",
1060
- // carriers: [{ code, label, enabled, isDefault }, ...] }
1061
-
1062
- Codes en namen (gebruik exact deze codes):
1063
- trolley Stapelwagen
1064
- danish_container Deense container
1065
- euro_rolcontainer Euro-rolcontainer
1066
- pallet Pallet
1067
- euro_pallet Euro-pallet
1068
- loose Geen ladingdrager
1069
-
1070
- Regels:
1071
- - In het mailscherm alleen dragers met enabled === true tonen; de rest weglaten.
1072
- - Herkent de mail een ladingdrager die niet in allowed staat, maak de bestelling dan
1073
- NIET automatisch aan. Zet de mail op "handmatig controleren - ladingdrager
1074
- uitgeschakeld" en toon welke drager in de mail stond.
1075
- - Is er niets herkend, gebruik dan dragers.default.
1076
- - Stuur loadCarrierType in logistics_check_order_allowed, logistics_buffer_decision
1077
- en logistics_emit_event altijd met een van bovenstaande codes mee.
1083
+ body: `AANVULLING op koppelprompt 1 en 2 (die blijven gewoon geldig).
1084
+
1085
+ In de Rule Engine (stap Beladingindeling) staat welke ladingdragers zijn toegestaan.
1086
+ Staat een ladingdrager uit, dan mag de Mailbox-module die niet meer kiezen of
1087
+ automatisch invullen.
1088
+
1089
+ Haal weg: elke eigen lijst met ladingdragers / verzendmethodes en elke eigen
1090
+ vertaling van tekst uit een mail naar een ladingdrager die niet uit de Engine komt.
1091
+
1092
+ Nieuwe verplichting: haal de lijst op bij de Engine.
1093
+
1094
+ const { data: dragers } = await supabase.rpc("logistics_allowed_load_carriers", {
1095
+ p_strategy_id: null,
1096
+ });
1097
+ // dragers = { allowed: [...], default: "trolley",
1098
+ // carriers: [{ code, label, enabled, isDefault }, ...] }
1099
+
1100
+ Codes en namen (gebruik exact deze codes):
1101
+ trolley Stapelwagen
1102
+ danish_container Deense container
1103
+ euro_rolcontainer Euro-rolcontainer
1104
+ pallet Pallet
1105
+ euro_pallet Euro-pallet
1106
+ loose Geen ladingdrager
1107
+
1108
+ Regels:
1109
+ - In het mailscherm alleen dragers met enabled === true tonen; de rest weglaten.
1110
+ - Herkent de mail een ladingdrager die niet in allowed staat, maak de bestelling dan
1111
+ NIET automatisch aan. Zet de mail op "handmatig controleren - ladingdrager
1112
+ uitgeschakeld" en toon welke drager in de mail stond.
1113
+ - Is er niets herkend, gebruik dan dragers.default.
1114
+ - Stuur loadCarrierType in logistics_check_order_allowed, logistics_buffer_decision
1115
+ en logistics_emit_event altijd met een van bovenstaande codes mee.
1078
1116
  - Cache de lijst niet; de instelling kan op elk moment wijzigen.`,
1079
1117
  },
1080
1118
  ],
@@ -1089,56 +1127,56 @@ Regels:
1089
1127
  date: "2026-08-04",
1090
1128
  withSharedContract: true,
1091
1129
  summary: "Deze module schrijft de dagbezetting weg en toont per dag of de Logistics Engine alle ophaalmomenten haalt.",
1092
- body: `LEES DIT EERST — hoe je deze prompt uitvoert
1093
-
1094
- Deze module is de bron van de bezetting. De Logistics Engine rekent daarmee uit
1095
- of alle karren voor ieder ophaalmoment op tijd gepickt kunnen worden. Je bouwt
1096
- twee dingen: wegschrijven van de planning, en het tonen van de waarschuwing.
1097
- Zelf rekenen doe je niet.
1098
-
1099
- 1) Dagbezetting wegschrijven
1100
- Tabel: public.logistics_staff_planning
1101
- Kolommen: plan_date (date), staff_count (aantal medewerkers),
1102
- start_time, end_time (werktijden), source_module, note.
1103
- Eén rij per dag (uniek op gebruiker + plan_date). Schrijf of update deze rij
1104
- telkens wanneer de gebruiker de bezetting of de werktijden van een dag
1105
- wijzigt:
1106
-
1107
- await supabase.from("logistics_staff_planning").upsert({
1108
- plan_date: "2026-08-04",
1109
- staff_count: 7,
1110
- start_time: "06:00",
1111
- end_time: "16:00",
1112
- source_module: "personeelsplanning",
1113
- }, { onConflict: "user_id,plan_date" })
1114
-
1115
- 2) Direct laten herrekenen
1116
- Roep na iedere wijziging aan:
1117
- await supabase.rpc("logistics_capacity_plan_day", { p_date: "2026-08-04" })
1118
- De Engine berekent dan opnieuw of alle ophaalmomenten haalbaar zijn en
1119
- verplaatst waar nodig automatisch COMPLETE karren naar een later
1120
- ophaalmoment. Jij verplaatst zelf nooit karren.
1121
-
1122
- 3) Rode waarschuwing tonen
1123
- Tabel: public.logistics_capacity_alerts, filter op plan_date en
1124
- status = 'open'. Toon op de betreffende dag een duidelijk rode melding met:
1125
- - shortage_minutes → hoeveel capaciteit tekort is (toon in uren + minuten)
1126
- - pickup_label / pickup_time → welk ophaalmoment niet gehaald wordt
1127
- - carts_short → hoeveel karren niet op tijd verwerkt kunnen worden
1128
- - moved_carts → welke karren automatisch zijn doorgeschoven
1129
- - unplanned_carts → welke karren nog steeds niet ingepland kunnen worden
1130
- Zijn er geen open rijen, toon dan géén waarschuwing (groen/neutraal).
1131
-
1132
- 4) Ophaalmomenten
1133
- Tabel public.logistics_pickup_moments bevat per dag de ophaalmomenten
1134
- (sequence, label, pickup_time). Gebruik die om de waarschuwing per
1135
- ophaalmoment te tonen. Aanmaken of wijzigen van ophaalmomenten mag alleen
1136
- als de gebruiker daar in deze module om vraagt; anders alleen lezen.
1137
-
1138
- 5) Wat je NIET doet
1139
- - Geen eigen capaciteitsberekening of eigen picktijden.
1140
- - Geen karren splitsen of verplaatsen.
1141
- - Geen eigen mail sturen bij een tekort; de Engine regelt e-mail en het
1130
+ body: `LEES DIT EERST — hoe je deze prompt uitvoert
1131
+
1132
+ Deze module is de bron van de bezetting. De Logistics Engine rekent daarmee uit
1133
+ of alle karren voor ieder ophaalmoment op tijd gepickt kunnen worden. Je bouwt
1134
+ twee dingen: wegschrijven van de planning, en het tonen van de waarschuwing.
1135
+ Zelf rekenen doe je niet.
1136
+
1137
+ 1) Dagbezetting wegschrijven
1138
+ Tabel: public.logistics_staff_planning
1139
+ Kolommen: plan_date (date), staff_count (aantal medewerkers),
1140
+ start_time, end_time (werktijden), source_module, note.
1141
+ Eén rij per dag (uniek op gebruiker + plan_date). Schrijf of update deze rij
1142
+ telkens wanneer de gebruiker de bezetting of de werktijden van een dag
1143
+ wijzigt:
1144
+
1145
+ await supabase.from("logistics_staff_planning").upsert({
1146
+ plan_date: "2026-08-04",
1147
+ staff_count: 7,
1148
+ start_time: "06:00",
1149
+ end_time: "16:00",
1150
+ source_module: "personeelsplanning",
1151
+ }, { onConflict: "user_id,plan_date" })
1152
+
1153
+ 2) Direct laten herrekenen
1154
+ Roep na iedere wijziging aan:
1155
+ await supabase.rpc("logistics_capacity_plan_day", { p_date: "2026-08-04" })
1156
+ De Engine berekent dan opnieuw of alle ophaalmomenten haalbaar zijn en
1157
+ verplaatst waar nodig automatisch COMPLETE karren naar een later
1158
+ ophaalmoment. Jij verplaatst zelf nooit karren.
1159
+
1160
+ 3) Rode waarschuwing tonen
1161
+ Tabel: public.logistics_capacity_alerts, filter op plan_date en
1162
+ status = 'open'. Toon op de betreffende dag een duidelijk rode melding met:
1163
+ - shortage_minutes → hoeveel capaciteit tekort is (toon in uren + minuten)
1164
+ - pickup_label / pickup_time → welk ophaalmoment niet gehaald wordt
1165
+ - carts_short → hoeveel karren niet op tijd verwerkt kunnen worden
1166
+ - moved_carts → welke karren automatisch zijn doorgeschoven
1167
+ - unplanned_carts → welke karren nog steeds niet ingepland kunnen worden
1168
+ Zijn er geen open rijen, toon dan géén waarschuwing (groen/neutraal).
1169
+
1170
+ 4) Ophaalmomenten
1171
+ Tabel public.logistics_pickup_moments bevat per dag de ophaalmomenten
1172
+ (sequence, label, pickup_time). Gebruik die om de waarschuwing per
1173
+ ophaalmoment te tonen. Aanmaken of wijzigen van ophaalmomenten mag alleen
1174
+ als de gebruiker daar in deze module om vraagt; anders alleen lezen.
1175
+
1176
+ 5) Wat je NIET doet
1177
+ - Geen eigen capaciteitsberekening of eigen picktijden.
1178
+ - Geen karren splitsen of verplaatsen.
1179
+ - Geen eigen mail sturen bij een tekort; de Engine regelt e-mail en het
1142
1180
  Meldingencentrum via de instellingen in de Rule Engine.`,
1143
1181
  },
1144
1182
  ],
@@ -1157,16 +1195,16 @@ export const MODULE_PROMPTS = Object.keys(MODULES)
1157
1195
  export function buildRevisionPrompt(prompt, revision) {
1158
1196
  const shared = revision.withSharedContract
1159
1197
  ? `\n## Gedeeld contract\n\n${sharedBlock(prompt.moduleKey)}\n`
1160
- : `\n(Deze prompt is een aanvulling. Het gedeelde contract uit koppelprompt 1 blijft
1198
+ : `\n(Deze prompt is een aanvulling. Het gedeelde contract uit koppelprompt 1 blijft
1161
1199
  onverkort gelden — niets terugdraaien.)\n`;
1162
- return `# Koppelprompt ${revision.number} — ${prompt.label}
1163
- ## ${revision.title} (${revision.date})
1164
-
1165
- ${revision.summary}
1166
- ${shared}
1167
- ## Wat deze module moet doen
1168
-
1169
- ${revision.body}
1200
+ return `# Koppelprompt ${revision.number} — ${prompt.label}
1201
+ ## ${revision.title} (${revision.date})
1202
+
1203
+ ${revision.summary}
1204
+ ${shared}
1205
+ ## Wat deze module moet doen
1206
+
1207
+ ${revision.body}
1170
1208
  `;
1171
1209
  }
1172
1210
  export function buildModulePrompt(prompt) {
@@ -1174,18 +1212,18 @@ export function buildModulePrompt(prompt) {
1174
1212
  }
1175
1213
  /** Alle modules, met per module de volledige promptgeschiedenis. */
1176
1214
  export function buildAllModulePrompts() {
1177
- const sections = MODULE_PROMPTS.map((p) => `# ${p.order}. ${p.label} (module: ${p.moduleKey})
1178
-
1179
- ${p.summary}
1180
-
1215
+ const sections = MODULE_PROMPTS.map((p) => `# ${p.order}. ${p.label} (module: ${p.moduleKey})
1216
+
1217
+ ${p.summary}
1218
+
1181
1219
  ${p.revisions.map((r) => buildRevisionPrompt(p, r)).join("\n---\n\n")}`).join("\n\n====================\n\n");
1182
- return `# Koppelprompts voor de aangesloten modules
1183
-
1184
- Per module staan de prompts op volgorde. Een nieuwe eis komt er altijd als
1185
- NIEUWE prompt bij; eerdere prompts blijven geldig en worden niet herschreven.
1186
- Er worden geen secrets gebruikt: alle communicatie loopt via de gedeelde
1187
- Supabase-database.
1188
-
1220
+ return `# Koppelprompts voor de aangesloten modules
1221
+
1222
+ Per module staan de prompts op volgorde. Een nieuwe eis komt er altijd als
1223
+ NIEUWE prompt bij; eerdere prompts blijven geldig en worden niet herschreven.
1224
+ Er worden geen secrets gebruikt: alle communicatie loopt via de gedeelde
1225
+ Supabase-database.
1226
+
1189
1227
  ${sections}`;
1190
1228
  }
1191
1229
  export function modulePromptFilename(moduleKey, revisionNumber) {