Componente Signatures per PrimoUpCore/PrimoCore

Convex component per la gestione di firme elettroniche con canali multipli (drawn, stored riusabili, OTP, QR code, link via email).

Caratteristiche

• Drawn: firma disegnata via canvas (data URL → Convex storage)
• Stored reusable: firma salvata una volta e riutilizzabile (es. firma del medico)
• OTP: verifica via codice OTP (SMS/Email)
• QR code: link tramite QR per firma da altro device
• Email link: link temporaneo via email
• Convex storage: tutte le immagini firma vivono come blob in Convex storage con URL firmati on-demand
• Audit log: tutti gli eventi (creazione sessione, invio link, firma, ecc.) sono tracciati
• Scope-agnostic: il componente non sa chi firma, l'host (PrimoUpCore) gestisce ownership

Struttura progetto

.
├── signatures/             # Componente installabile
│   ├── convex.config.ts
│   ├── schema.ts
│   ├── domain/
│   ├── functions/
│   └── permissions.ts
├── convex/                 # App Convex per testing isolato
│   ├── convex.config.ts
│   └── signaturesApi.ts
├── ui-example/             # Demo Vite/React
└── package.json

Quick start

1. Install dependencies:

   npm install

2. Configura Convex (prima volta):

   npx convex dev

   Segui il wizard per creare/collegare un deployment dev dedicato.

Installazione in un app host (es. PrimoUpCore)

yalc add @primocaredentgroup/signatures-component
npm install

In convex/convex.config.ts:

import signatures from "@primocaredentgroup/signatures-component/convex.config.js";
app.use(signatures, { name: "signatures" });

Stato

In sviluppo. API non ancora stabile.