MEGAINFRA-WEBAPP/docs/superpowers
DEls e7df31f7e1 docs(delivery-notes): spec the inbox pipeline, unit fix and Kanban board
Diagnoses why multi-note delivery slips lose data and specifies phases 1-3
of the fix.

Root cause: the n8n workflow's "Match items to PO" Code node runs in
runOnceForAllItems mode and returns a single item, so the workflow makes
exactly two callbacks regardless of how many notes a document holds. A
4-note scan produced 2 promoted notes and 2 empty records in an invisible
status, while reporting auto-verified at 95% confidence.

Also found: delivery notes are weighbridge tickets in kg while PO lines are
priced per ton, and nothing converts. po-fulfilment and delivery-note-value
therefore overstate received quantity 1000x across all 57 existing rows.

Phase 1 fixes the unit model and migrates existing data. Phase 2 moves
ingestion into a staged inbox with a deterministic validation gate, so
nothing reaches delivery_notes unless every page is accounted for. Phase 3
renders that state machine as a Kanban board.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 11:00:46 +02:00
..
plans docs(clock): add implementation plan for MEGA Clock timeclock PWA 2026-09-12 00:30:54 +02:00
specs docs(delivery-notes): spec the inbox pipeline, unit fix and Kanban board 2026-09-17 11:00:46 +02:00