# Layout maker (pakbonnen, verzendbrieven, ectra)

blank project start

This project was built with [Lovable](https://lovable.dev).

## Build with Lovable

Continue developing this project in the [Lovable editor](https://lovable.dev/projects/4735fccb-b385-4b48-b4f8-ef135f63f4f7).

- **Ship faster**: describe what you want to build and Lovable handles the code.
- **Stay in sync**: every change made in Lovable is committed straight to this repository.
- **Full ownership**: this code is yours. Push to `main` on GitHub and your changes sync back into Lovable, ready for your next prompt.

## Development

Prefer working locally? You need Node.js and npm — [install with nvm](https://github.com/nvm-sh/nvm#installing-and-updating).

```sh
git clone <this-repository-url>
cd <repository-name>
npm i
npm run dev
```

## Installeren in een andere shell

1. Draai `sql/print-schema.sql` één keer in de Supabase-database van die shell
   (SQL editor). Het script is idempotent en zet tabellen, rechten, RLS,
   functies, de geplande taken én de opslagmap `layout-logos` voor de Logo
   Bibliotheek klaar. Zorg dat de extensies `pg_cron` en `pg_net` aan staan.

2. Zet in de omgeving van de shell:
   - `SUPABASE_URL` en `SERVICE_ROLE_KEY` — nodig voor achtergrondprinten
   - `CENTRAL_AUTH_URL` en `CENTRAL_AUTH_SECRET` — nodig voor de printdienst
3. Zorg dat de shell het tick-eindpunt host. De setup-CLI doet dit automatisch
   op basis van `flowselections.serverRoutes` in `package.json`. Handmatig
   opgezette shells maken zelf dit bestand aan:

   ```ts
   // src/routes/api/public/print/queue-tick.ts
   import { createFileRoute } from "@tanstack/react-router";
   import { behandelQueueTick } from "@flowselections/layout-maker/print";

   export const Route = createFileRoute("/api/public/print/queue-tick")({
     server: {
       handlers: {
         POST: async ({ request }) => {
           // De shell levert de databaseverbinding; de module maakt er nooit zelf een.
           const { supabaseAdmin } = await import(
             "../../../../integrations/supabase/client.server"
           );
           return behandelQueueTick(request, supabaseAdmin);
         },
       },
     },
   });
   ```

   Het eindpunt accepteert drie toegangsbewijzen: een runner-sleutel uit
   `print_queue_runners.tick_sleutel`, `SUPABASE_PUBLISHABLE_KEY` (de cron) of
   het sessietoken van een ingelogde gebruiker (de knop in de Printwachtrij).


4. Klaar. Zodra de module in de shell draait meldt hij zichzelf aan als
   verwerker van de printwachtrij. Een nieuwe printopdracht wordt meteen
   opgepakt; daarnaast verwerkt de geplande taak `print-queue-tick` elke minuut
   de wachtende opdrachten. Reageert een shell een uur lang niet, dan wordt hij
   automatisch op inactief gezet. De taak `print-queue-cleanup` ruimt dagelijks
   oude opdrachten en bestanden op.

## Printen vanuit een andere module

Andere modules in dezelfde shell gebruiken uitsluitend de print-API van deze
module; zij hoeven de printtabellen niet te kennen en mogen er ook niet zelf in
schrijven (dan blijft de opdracht wachten tot de volgende cronronde).

```ts
import {
  printDocument, printPdf, printHtml,
  printerVoorWerkplek, printerVoorDocumenttype, volgJobStatus,
} from "@flowselections/layout-maker";

// 1. Document dat via een ontwerp uit deze module wordt opgemaakt
const { jobId } = await printDocument({
  documenttype: "pakbon",          // moet een bestaande documentsoort zijn
  documentnaam: "PB-2601284",
  payload: { order, order_id: order.id }, // order_id: verplicht kenmerk
});

// 2. Kant-en-klare PDF (Floriday-document, klantsticker, externe factuur)
//    Zonder printerId wordt de printer bepaald via de gekoppelde layout van
//    de documentsoort (of de koppeling op papierformaat).
await printPdf({
  documenttype: "factuur",
  documentnaam: "F-2026-00123",
  pdfBase64,                       // met of zonder data:-voorvoegsel
  payload: { order_id: factuur.id },
});

// Geef in payload altijd een order-kenmerk mee: queue_item_id, order_id of
// ordernummer. De wachtrij gebruikt dat om dubbele aanvragen te herkennen;
// zonder kenmerk kunnen twee orders met dezelfde documentnaam binnen tien
// minuten als dubbel worden gezien.


// Of expliciet per werkplek:
const printerId = await printerVoorWerkplek("PICKSTATION-1", "A4");
await printPdf({
  documenttype: "afleverbrief",
  documentnaam: "AFL-12345",
  pdfBase64,
  printerId: printerId!,
});


// 3. Eigen opmaak afdrukken (geen layout, anders wint de layout)
await printHtml({
  documenttype: "controlelijst",
  documentnaam: "Controlelijst kar 12",
  html,
  printerId: printerId!,
});

// Status live volgen (realtime staat aan op print_jobs)
const stop = volgJobStatus(jobId, (s) => console.log(s.status, s.foutmelding));
```

Belangrijk:

- **Documentsoorten** liggen vast in de database: pakbon, factuur, offerte,
  orderbevestiging, etiket, verzendlabel, productlabel, barcode_label,
  magazijnlijst, controlelijst, transportdocument, sticker, productiebon,
  veilingbon, afleverbrief, veilingbrief en vrij.
- **Beslisvolgorde bij het afdrukken**: kant-en-klare PDF > gekoppelde layout >
  meegestuurde opmaak > actieve layout van de documentsoort.
- **Dubbelbeveiliging**: een identieke aanvraag binnen 10 minuten wordt
  genegeerd; de aanroep werpt dan `DubbeleAanvraagFout`. Geef bij bulkprints per
  document een eigen `documentnaam` zodat elke opdracht uniek is.