@primocaredentgroup/elettromedicali 0.1.0

package/src/component/schema.ts

@@ -0,0 +1,842 @@
+import { defineSchema, defineTable } from 'convex/server';
+import { v } from 'convex/values';
+
+export default defineSchema({
+  // Roles table
+  roles: defineTable({
+    name: v.string(),
+    description: v.string(),
+    policies: v.optional(v.object({
+      canViewAllClinics: v.optional(v.boolean()),
+      canEditClinics: v.optional(v.boolean()),
+      canViewAllDevices: v.optional(v.boolean()),
+      canEditDevices: v.optional(v.boolean()),
+      canViewAllTickets: v.optional(v.boolean()),
+      canEditTickets: v.optional(v.boolean()),
+      canManageUsers: v.optional(v.boolean()),
+      canManageRoles: v.optional(v.boolean()),
+      canViewReports: v.optional(v.boolean()),
+    })),
+    createdAt: v.optional(v.number()),
+  }).index('by_name', ['name']),
+
+  // User profiles with roles
+  user_profiles: defineTable({
+    auth0Id: v.string(),
+    roleId: v.optional(v.id('roles')), // Made optional for backward compatibility
+    role: v.optional(v.string()), // Legacy field - will be migrated to roleId
+    clinicId: v.optional(v.id('clinics')),
+    supplierId: v.optional(v.id('suppliers')),
+    email: v.string(),
+    name: v.optional(v.string()),
+    // PrimoUP user clinics data
+    primoupClinics: v.optional(v.array(v.any())), // Array of clinic objects from PrimoUP
+    selectedClinicId: v.optional(v.number()), // Currently selected PrimoUP clinic ID
+    clinicChangeCounter: v.optional(v.number()), // Increments every time clinic changes
+    // Impersonation (admin only)
+    impersonatingUserId: v.optional(v.id('user_profiles')), // ID of user being impersonated
+    // Account status
+    isActive: v.optional(v.boolean()), // Default true, false = account disabilitato
+  })
+    .index('by_auth0Id', ['auth0Id'])
+    .index('by_email', ['email'])
+    .index('by_roleId', ['roleId'])
+    .index('by_clinicId', ['clinicId'])
+    .index('by_supplierId', ['supplierId'])
+    .index('by_isActive', ['isActive']),
+
+  // PrimoUP authentication tokens
+  primoup_tokens: defineTable({
+    userId: v.string(), // Auth0 user ID
+    token: v.string(),
+    refreshToken: v.optional(v.string()),
+    expiresAt: v.optional(v.number()),
+    createdAt: v.number(),
+    lastUsedAt: v.optional(v.number()),
+    isActive: v.boolean(), // Only one active token per user
+  })
+    .index('by_userId', ['userId'])
+    .index('by_userId_active', ['userId', 'isActive']),
+
+  // PrimoUP access logs
+  primoup_access_logs: defineTable({
+    userId: v.string(), // Auth0 user ID
+    action: v.string(), // 'login', 'refresh', 'api_call', etc.
+    endpoint: v.optional(v.string()), // API endpoint called
+    success: v.boolean(),
+    errorMessage: v.optional(v.string()),
+    timestamp: v.number(),
+    metadata: v.optional(v.any()), // Additional info
+  })
+    .index('by_userId', ['userId'])
+    .index('by_timestamp', ['timestamp'])
+    .index('by_userId_timestamp', ['userId', 'timestamp']),
+
+  // Clinics
+  clinics: defineTable({
+    name: v.string(),
+    address: v.string(),
+    contact_email: v.string(),
+    contact_phone: v.string(),
+    region: v.optional(v.string()), // Regione della clinica
+    primoupId: v.optional(v.string()), // PrimoUP clinic ID for sync
+  }).index('by_primoupId', ['primoupId']),
+
+  // Devices
+  devices: defineTable({
+    clinicId: v.id('clinics'),
+    primoupClinicId: v.optional(v.number()), // PrimoUP clinic ID (for filtering)
+    supplierId: v.optional(v.id('suppliers')), // Fornitore che fornisce assistenza
+    name: v.string(),
+    category: v.string(),
+    brand: v.string(),
+    model: v.string(),
+    serial_number: v.string(),
+    photo: v.optional(v.string()), // Legacy base64 - will be migrated
+    photoStorageId: v.optional(v.id('_storage')), // New: Convex file storage ID
+    status: v.union(
+      v.literal('active'),
+      v.literal('in_maintenance'),
+      v.literal('out_of_service')
+    ),
+    metadata: v.optional(v.any()),
+    
+    // Nuovi campi per enhancement
+    // Identificazione
+    internalId: v.optional(v.string()), // ID interno azienda (warehouse_article id)
+    articleId: v.optional(v.string()), // Article ID from PrimoUP (article id)
+    primoupCategoryId: v.optional(v.string()), // PrimoUP category ID (article_category_id)
+    industry40Data: v.optional(v.string()), // Dati Industry 4.0
+    quantity: v.optional(v.number()), // Quantità disponibile in questa clinica
+    
+    // Acquisto
+    purchaseDate: v.optional(v.number()), // Data acquisto (timestamp)
+    vendor: v.optional(v.string()), // Venditore
+    purchaseCost: v.optional(v.number()), // Costo acquisto
+    
+    // Garanzia
+    warrantyEndDate: v.optional(v.number()), // Fine garanzia (timestamp)
+    
+    // Ricambi
+    spareParts: v.optional(v.array(v.object({
+      name: v.string(),
+      code: v.string(),
+      photoStorageId: v.optional(v.id('_storage')),
+      quantity: v.number(),
+      notes: v.optional(v.string()),
+    }))),
+    
+    // Allegati
+    maintenanceManualStorageId: v.optional(v.id('_storage')), // Manuale manutenzione PDF
+    maintenanceReportsStorageIds: v.optional(v.array(v.id('_storage'))), // Verbali manutenzione programmata
+    conformityDeclarationStorageId: v.optional(v.id('_storage')), // Dichiarazione conformità
+    authorizationsStorageIds: v.optional(v.array(v.id('_storage'))), // Autorizzazioni
+    otherAttachmentsStorageIds: v.optional(v.array(v.id('_storage'))), // Altri allegati
+  })
+    .index('by_clinicId', ['clinicId'])
+    .index('by_primoupClinicId', ['primoupClinicId'])
+    .index('by_supplierId', ['supplierId'])
+    .index('by_category', ['category'])
+    .index('by_status', ['status'])
+    .index('by_internalId', ['internalId'])
+    .index('by_articleId', ['articleId'])
+    .index('by_primoupCategoryId', ['primoupCategoryId']),
+
+  // Storico riparazioni attrezzature
+  device_repair_history: defineTable({
+    deviceId: v.id('devices'),
+    clinicId: v.id('clinics'),
+    ticketId: v.optional(v.id('maintenance_tasks')),
+    sentToRepairAt: v.number(),
+    returnedAt: v.optional(v.number()),
+    statusAfterRepair: v.optional(v.union(
+      v.literal('active'),
+      v.literal('out_of_service')
+    )),
+    notes: v.optional(v.string()),
+    createdBy: v.string(),
+    returnedBy: v.optional(v.string()),
+  })
+    .index('by_deviceId', ['deviceId'])
+    .index('by_clinicId', ['clinicId'])
+    .index('by_deviceId_sentAt', ['deviceId', 'sentToRepairAt']),
+
+  // Supplier Categories
+  supplier_categories: defineTable({
+    name: v.string(),
+    description: v.optional(v.string()),
+    createdAt: v.number(),
+  }).index('by_name', ['name']),
+
+  // SLA Rules
+  sla_rules: defineTable({
+    name: v.optional(v.string()), // Nome SLA (opzionale per retrocompatibilità)
+    supplierId: v.id('suppliers'),
+    deviceCategory: v.optional(v.string()), // Categoria attrezzatura (opzionale = SLA generico)
+    priority: v.union(v.literal('low'), v.literal('medium'), v.literal('high')),
+    responseTimeHours: v.number(), // Tempo di risposta in ore
+    resolutionTimeHours: v.number(), // Tempo di risoluzione in ore
+    description: v.optional(v.string()),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+  })
+    .index('by_supplierId', ['supplierId'])
+    .index('by_supplierId_priority', ['supplierId', 'priority'])
+    .index('by_supplierId_category_priority', ['supplierId', 'deviceCategory', 'priority']),
+
+  // Suppliers
+  suppliers: defineTable({
+    name: v.string(),
+    contact_email: v.string(),
+    contact_phone: v.string(),
+    categories: v.array(v.string()),
+    sla_days: v.number(),
+    notes: v.optional(v.string()),
+    primoupId: v.optional(v.string()), // PrimoUP vendor ID for sync
+    type: v.optional(v.string()), // warehouse, clinic, lab
+  }).index('by_primoupId', ['primoupId']),
+
+  // Vendor Articles (pivot table: which vendor sells which article/device)
+  vendor_articles: defineTable({
+    vendorId: v.id('suppliers'), // Convex supplier ID
+    deviceId: v.id('devices'), // Convex device ID (article)
+    primoupVendorId: v.optional(v.string()), // PrimoUP vendor ID
+    primoupArticleId: v.optional(v.string()), // PrimoUP article ID
+    metadata: v.optional(v.any()),
+  })
+    .index('by_vendorId', ['vendorId'])
+    .index('by_deviceId', ['deviceId'])
+    .index('by_vendorId_deviceId', ['vendorId', 'deviceId'])
+    .index('by_primoupVendorId', ['primoupVendorId'])
+    .index('by_primoupArticleId', ['primoupArticleId']),
+
+  // Contracts
+  contracts: defineTable({
+    supplierId: v.id('suppliers'),
+    clinicId: v.optional(v.id('clinics')), // Legacy: single clinic (deprecated)
+    clinicIds: v.optional(v.array(v.id('clinics'))), // New: multiple clinics (empty = all clinics)
+    start_date: v.number(),
+    end_date: v.number(),
+    amount: v.number(),
+    type: v.union(v.literal('full'), v.literal('on_demand'), v.literal('mixed')),
+    description: v.optional(v.string()), // Description of the contract
+    pdfStorageId: v.optional(v.id('_storage')), // PDF file stored in Convex
+    pdf_url: v.optional(v.string()), // Legacy: external URL
+    related_devices: v.array(v.id('devices')),
+  })
+    .index('by_supplierId', ['supplierId'])
+    .index('by_clinicId', ['clinicId']),
+
+  // Ticket statuses (configurable)
+  ticket_statuses: defineTable({
+    name: v.string(), // e.g., 'open', 'assigned_to_supplier', 'in_progress', 'completed', 'cancelled'
+    slug: v.optional(v.string()), // Slug per API esterna (Abaddon): 'open', 'in_progress', 'waiting_customer', 'closed', etc.
+    label: v.string(), // e.g., 'Aperto', 'Assegnato', 'In Corso', 'Completato', 'Annullato'
+    color: v.string(), // e.g., 'warning', 'info', 'primary', 'success', 'danger'
+    order: v.number(), // Order for display
+    isActive: v.boolean(), // Can be disabled without deleting
+    createdAt: v.number(),
+  })
+    .index('by_name', ['name'])
+    .index('by_slug', ['slug'])
+    .index('by_order', ['order'])
+    .index('by_isActive', ['isActive']),
+
+  // Custom fields configuration (admin-defined fields for tickets)
+  ticket_custom_fields: defineTable({
+    name: v.string(), // Nome del campo (es. "Priorità", "Tipo di guasto")
+    fieldType: v.union(
+      v.literal('text'),
+      v.literal('textarea'),
+      v.literal('number'),
+      v.literal('select'),
+      v.literal('multiselect'),
+      v.literal('date'),
+      v.literal('checkbox'),
+      v.literal('radio')
+    ),
+    options: v.optional(v.array(v.string())), // Per select/multiselect/radio
+    isRequired: v.boolean(),
+    placeholder: v.optional(v.string()),
+    helpText: v.optional(v.string()),
+    order: v.number(), // Ordine di visualizzazione nel form
+    isActive: v.boolean(), // Può essere disabilitato senza cancellare
+    // Filtri di applicabilità
+    applyToAll: v.boolean(), // Se true, si applica a tutte le attrezzature
+    categories: v.optional(v.array(v.string())), // Categorie di attrezzature (es. ["Riuniti", "Autoclavi"])
+    deviceIds: v.optional(v.array(v.id('devices'))), // Specifiche attrezzature
+    // Campi dipendenti/concatenati
+    parentFieldId: v.optional(v.id('ticket_custom_fields')), // Campo padre (se è un campo figlio)
+    parentFieldValue: v.optional(v.string()), // Valore del campo padre che attiva questo campo
+    // Struttura alternativa: mappa di campi figli per ogni opzione
+    childFields: v.optional(v.array(v.object({
+      parentValue: v.string(), // Valore dell'opzione che attiva i figli
+      childFieldIds: v.array(v.id('ticket_custom_fields')), // Array di campi figli
+    }))),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+  })
+    .index('by_order', ['order'])
+    .index('by_isActive', ['isActive'])
+    .index('by_applyToAll', ['applyToAll'])
+    .index('by_parentFieldId', ['parentFieldId']),
+
+  // Maintenance tasks (tickets)
+  maintenance_tasks: defineTable({
+    ticketNumber: v.optional(v.string()), // Numero ticket incrementale (es: TICK-00001)
+    title: v.optional(v.string()), // Titolo del ticket
+    deviceId: v.optional(v.id('devices')), // Opzionale per ticket esterni senza device specifico
+    clinicId: v.id('clinics'),
+    supplierId: v.optional(v.id('suppliers')),
+    created_by: v.string(), // Auth0 user ID
+    createdByEmail: v.optional(v.string()), // Email del creatore (per webhook)
+    description: v.string(),
+    photos: v.array(v.string()), // Legacy base64 - kept for backward compatibility
+    photoStorageIds: v.optional(v.array(v.id('_storage'))), // New: Convex file storage
+    status: v.string(), // References ticket_statuses.name
+    priority: v.optional(v.union(
+      v.literal('low'),
+      v.literal('medium'),
+      v.literal('high')
+    )), // Priorità del ticket (usata per SLA)
+    notes: v.optional(v.string()), // Additional notes from supplier/admin
+    customFields: v.optional(v.any()), // Valori dei campi custom (oggetto dinamico)
+    deviceQuestionAnswers: v.optional(v.array(v.object({
+      questionId: v.id('device_questions'),
+      question: v.string(), // Testo della domanda (salvato per storico)
+      answer: v.any(), // Risposta (può essere string, number, array, boolean)
+    }))), // Risposte alle domande specifiche dell'attrezzatura
+    slaDeadline: v.optional(v.number()), // Scadenza SLA calcolata automaticamente
+    slaBreached: v.optional(v.boolean()), // True se SLA è stato violato
+    slaWarningSent: v.optional(v.boolean()), // True se warning email è stata inviata
+    // External system integration (Abaddon)
+    externalTicketId: v.optional(v.string()), // ID del ticket nel sistema esterno
+    externalTicketNumber: v.optional(v.number()), // Numero ticket nel sistema esterno
+    // Import tracking
+    importSource: v.optional(v.string()), // Es: "legacy_zammad", "external_api" per ticket importati
+    legacyTicketId: v.optional(v.number()), // ID originale nel sistema legacy
+    // External ticket flags
+    isExternal: v.optional(v.boolean()), // True se ticket creato da API esterna (senza device)
+    needsAssignment: v.optional(v.boolean()), // True se ticket da gestire (senza fornitore assegnato)
+    created_at: v.number(),
+    updated_at: v.number(),
+    closed_at: v.optional(v.number()), // Data chiusura (quando status diventa completed/cancelled)
+  })
+    .index('by_ticketNumber', ['ticketNumber'])
+    .index('by_deviceId', ['deviceId'])
+    .index('by_clinicId', ['clinicId'])
+    .index('by_supplierId', ['supplierId'])
+    .index('by_status', ['status'])
+    .index('by_status_created_at', ['status', 'created_at'])
+    .index('by_priority', ['priority'])
+    .index('by_created_at', ['created_at'])
+    .index('by_slaDeadline', ['slaDeadline'])
+    .index('by_externalTicketId', ['externalTicketId'])
+    .index('by_importSource', ['importSource']),
+
+  // Dashboard stats cache - pre-computed every 10 min to avoid bytes read limit
+  dashboard_stats_cache: defineTable({
+    lastUpdated: v.number(),
+    totalClinics: v.number(),
+    totalSuppliers: v.number(),
+    totalDevices: v.number(),
+    deviceCountByStatus: v.any(), // { active: N, in_maintenance: N, out_of_service: N }
+    ticketStats: v.any(),         // { open: N, closed: N, ... }
+    totalTickets: v.number(),
+  }),
+
+  // Push subscriptions for notifications
+  push_subscriptions: defineTable({
+    userId: v.string(), // Auth0 user ID
+    subscription: v.any(), // PushSubscription object
+  }).index('by_userId', ['userId']),
+
+  // Ticket automation triggers
+  ticket_triggers: defineTable({
+    name: v.string(), // Nome del trigger (es. "Auto-assegna Riuniti urgenti")
+    description: v.optional(v.string()),
+    isActive: v.boolean(),
+    priority: v.number(), // Ordine di esecuzione (più basso = più alta priorità)
+    
+    // CONDIZIONI (quando si attiva il trigger)
+    conditions: v.object({
+      // Logica di combinazione condizioni (AND = tutte devono essere vere, OR = almeno una deve essere vera)
+      // DEPRECATO: usare conditionsList per operatori individuali
+      conditionLogic: v.optional(v.union(v.literal('AND'), v.literal('OR'))), // Default: AND
+      
+      // NUOVO: Lista condizioni con operatori individuali tra ogni coppia
+      // Se presente, ha priorità sui campi legacy
+      conditionsList: v.optional(v.array(v.object({
+        type: v.union(
+          v.literal('trigger_event'),  // Evento trigger (create, status_change, etc.)
+          v.literal('status'),         // Stato ticket
+          v.literal('category'),       // Categoria attrezzatura
+          v.literal('brand'),          // Marca attrezzatura
+          v.literal('model'),          // Modello attrezzatura
+          v.literal('region'),         // Regione clinica
+          v.literal('priority'),       // Priorità ticket
+          v.literal('custom_field')    // Campo custom
+        ),
+        negated: v.boolean(),          // NON (nega la condizione)
+        value: v.union(v.string(), v.array(v.string())), // Valore o valori
+        nextOperator: v.union(v.literal('AND'), v.literal('OR')), // Operatore verso la prossima condizione
+        // Per custom_field
+        customFieldId: v.optional(v.id('ticket_custom_fields')),
+        customFieldOperator: v.optional(v.union(
+          v.literal('equals'),
+          v.literal('not_equals'),
+          v.literal('contains'),
+          v.literal('greater_than'),
+          v.literal('less_than'),
+          v.literal('is_empty'),
+          v.literal('is_not_empty')
+        )),
+      }))),
+      
+      // Filtri per categorie attrezzature (LEGACY)
+      categories: v.optional(v.array(v.string())), // Es. ["Riuniti", "Autoclavi"]
+      applyToAllCategories: v.boolean(), // Se true, ignora categories
+      
+      // Filtri per regioni cliniche (LEGACY)
+      regions: v.optional(v.array(v.string())), // Es. ["Lombardia", "Lazio"]
+      applyToAllRegions: v.optional(v.boolean()), // Se true, ignora regions
+      
+      // Filtri per marche (LEGACY)
+      brands: v.optional(v.array(v.string())),
+      brandOperator: v.optional(v.union(v.literal('is'), v.literal('is_not'))),
+      
+      // Filtri per modelli (LEGACY)
+      models: v.optional(v.array(v.string())),
+      modelOperator: v.optional(v.union(v.literal('is'), v.literal('is_not'))),
+      
+      // Filtri per stati (LEGACY)
+      statuses: v.optional(v.array(v.string())), // Es. ["open", "in_progress"]
+      statusOperator: v.optional(v.union(v.literal('is'), v.literal('is_not'))), // Default: 'is'
+      
+      // Filtri per campi custom (condizioni AND)
+      customFieldConditions: v.optional(v.array(v.object({
+        fieldId: v.id('ticket_custom_fields'),
+        operator: v.union(
+          v.literal('equals'),           // Uguale a
+          v.literal('not_equals'),       // Diverso da
+          v.literal('contains'),         // Contiene (per testo)
+          v.literal('greater_than'),     // Maggiore di (per numeri)
+          v.literal('less_than'),        // Minore di (per numeri)
+          v.literal('is_empty'),         // È vuoto
+          v.literal('is_not_empty')      // Non è vuoto
+        ),
+        value: v.optional(v.any()), // Valore da confrontare
+      }))),
+      
+      // Trigger su eventi specifici
+      triggerOn: v.union(
+        v.literal('create'),           // Alla creazione ticket
+        v.literal('status_change'),    // Al cambio stato ticket
+        v.literal('update'),           // Ad ogni modifica ticket
+        v.literal('sla_warning'),      // Quando SLA sta per scadere
+        v.literal('sla_breach'),       // Quando SLA è scaduto
+        // Eventi ordini ricambi
+        v.literal('spare_part_order_created'),       // Alla creazione ordine ricambio
+        v.literal('spare_part_order_status_change')  // Al cambio stato ordine ricambio
+      ),
+      
+      // Filtri specifici per ordini ricambi
+      sparePartOrderFilters: v.optional(v.object({
+        supplierIds: v.optional(v.array(v.id('suppliers'))), // Fornitori specifici
+        applyToAllSuppliers: v.optional(v.boolean()),        // Se true, applica a tutti
+        statuses: v.optional(v.array(v.string())),           // Stati ordine (pending, approved, etc.)
+      })),
+    }),
+    
+    // AZIONI (cosa fa il trigger)
+    actions: v.object({
+      // Cambia stato
+      changeStatus: v.optional(v.string()), // Nome del nuovo stato
+      
+      // Assegna fornitore (azienda)
+      assignSupplier: v.optional(v.id('suppliers')),
+      
+      // Assegna utente specifico (utente con ruolo supplier)
+      assignUser: v.optional(v.id('user_profiles')),
+      
+      // Imposta SLA (ore)
+      setSlaHours: v.optional(v.number()),
+      
+      // Applica regola SLA automatica (basata su fornitore e priorità)
+      applySlaRule: v.optional(v.boolean()),
+      
+      // Aggiungi nota automatica
+      addNote: v.optional(v.string()),
+      
+      // Invia notifica
+      sendNotification: v.optional(v.object({
+        recipients: v.array(v.union(
+          // Nuovo formato (oggetti)
+          v.object({
+            type: v.union(
+              v.literal('admin'),              // Tutti gli admin
+              v.literal('supplier'),           // Fornitore assegnato al ticket
+              v.literal('ticket_creator'),     // Utente che ha aperto il ticket
+              v.literal('ticket_assignee'),    // Utente assegnatario del ticket
+              v.literal('specific_user'),      // Utente specifico
+              v.literal('specific_supplier')   // Fornitore specifico
+            ),
+            userId: v.optional(v.id('user_profiles')),    // Per specific_user
+            supplierId: v.optional(v.id('suppliers')),    // Per specific_supplier
+          }),
+          // Vecchio formato (stringhe) - per retrocompatibilità temporanea
+          v.literal('admin'),
+          v.literal('supplier'),
+          v.literal('clinic')
+        )),
+        message: v.string(),
+      })),
+      
+      // Imposta priorità (se esiste campo custom priorità)
+      setPriority: v.optional(v.string()),
+      
+      // Richiedi allegato obbligatorio
+      requireAttachment: v.optional(v.boolean()),
+      
+      // Azioni specifiche per ordini ricambi
+      sparePartOrderActions: v.optional(v.object({
+        changeOrderStatus: v.optional(v.string()),  // Cambia stato ordine
+        addOrderNote: v.optional(v.string()),       // Aggiungi nota all'ordine
+        sendOrderNotification: v.optional(v.object({
+          recipients: v.array(v.union(
+            v.literal('admin'),
+            v.literal('supplier'),
+            v.literal('order_creator')
+          )),
+          message: v.string(),
+        })),
+      })),
+    }),
+    
+    createdAt: v.number(),
+    updatedAt: v.number(),
+    createdBy: v.string(), // Auth0 user ID
+  })
+    .index('by_isActive', ['isActive'])
+    .index('by_priority', ['priority'])
+    .index('by_createdAt', ['createdAt']),
+
+  // Ticket Macros (azioni manuali sui ticket)
+  ticket_macros: defineTable({
+    name: v.string(), // Nome della macro
+    description: v.optional(v.string()),
+    isGlobal: v.boolean(), // true = visibile a tutti, false = solo creatore
+    isActive: v.boolean(),
+    
+    // Azioni (stesse dei trigger)
+    actions: v.object({
+      changeStatus: v.optional(v.string()), // Cambia stato
+      assignSupplier: v.optional(v.id('suppliers')), // Assegna azienda fornitrice
+      assignUser: v.optional(v.id('user_profiles')), // Assegna utente specifico
+      setSlaHours: v.optional(v.number()), // Imposta SLA
+      applySlaRule: v.optional(v.boolean()), // Applica regola SLA automatica
+      addNote: v.optional(v.string()), // Aggiungi nota automatica
+      sendNotification: v.optional(v.object({
+        recipients: v.array(v.union(
+          v.object({
+            type: v.union(
+              v.literal('admin'),
+              v.literal('supplier'),
+              v.literal('ticket_creator'),
+              v.literal('ticket_assignee'),
+              v.literal('specific_user'),
+              v.literal('specific_supplier')
+            ),
+            userId: v.optional(v.id('user_profiles')),
+            supplierId: v.optional(v.id('suppliers')),
+          }),
+          v.literal('admin'),
+          v.literal('supplier'),
+          v.literal('clinic')
+        )),
+        message: v.string(),
+      })),
+      setPriority: v.optional(v.string()), // Imposta priorità
+    }),
+    
+    createdAt: v.number(),
+    updatedAt: v.number(),
+    createdBy: v.id('user_profiles'), // Chi ha creato la macro
+  })
+    .index('by_createdBy', ['createdBy'])
+    .index('by_isGlobal', ['isGlobal'])
+    .index('by_isActive', ['isActive']),
+
+  // Device Questions (Domande per attrezzature)
+  device_questions: defineTable({
+    deviceId: v.id('devices'), // Attrezzatura specifica
+    question: v.string(), // Testo della domanda
+    questionType: v.union(
+      v.literal('text'),        // Risposta testuale libera
+      v.literal('textarea'),    // Risposta testuale lunga
+      v.literal('select'),      // Scelta singola
+      v.literal('multiselect'), // Scelta multipla
+      v.literal('yes_no'),      // Sì/No
+      v.literal('number'),      // Numero
+      v.literal('date')         // Data
+    ),
+    options: v.optional(v.array(v.string())), // Opzioni per select/multiselect
+    isRequired: v.boolean(), // Se la risposta è obbligatoria
+    order: v.number(), // Ordine di visualizzazione
+    placeholder: v.optional(v.string()), // Testo placeholder
+    helpText: v.optional(v.string()), // Testo di aiuto
+    
+    // Logica condizionale - Mostra questa domanda solo se le condizioni sono soddisfatte
+    conditionalLogic: v.optional(v.object({
+      enabled: v.boolean(), // Se la logica condizionale è abilitata
+      conditions: v.array(v.object({
+        questionId: v.id('device_questions'), // ID della domanda da cui dipende
+        operator: v.union(
+          v.literal('equals'),           // uguale a
+          v.literal('not_equals'),       // diverso da
+          v.literal('contains'),         // contiene (per multiselect/text)
+          v.literal('not_contains'),     // non contiene
+          v.literal('greater_than'),     // maggiore di (per number)
+          v.literal('less_than'),        // minore di (per number)
+          v.literal('is_empty'),         // è vuoto
+          v.literal('is_not_empty')      // non è vuoto
+        ),
+        value: v.any(), // Valore da confrontare (può essere string, number, boolean, array)
+      })),
+      logic: v.union(
+        v.literal('AND'), // Tutte le condizioni devono essere vere
+        v.literal('OR')   // Almeno una condizione deve essere vera
+      ),
+    })),
+    
+    isActive: v.boolean(), // Se la domanda è attiva
+    createdAt: v.number(),
+    updatedAt: v.number(),
+    createdBy: v.string(), // Auth0 user ID dell'admin che l'ha creata
+  })
+    .index('by_deviceId', ['deviceId'])
+    .index('by_deviceId_order', ['deviceId', 'order'])
+    .index('by_isActive', ['isActive']),
+
+  // Spare parts (Ricambi)
+  spare_parts: defineTable({
+    // Warehouse item fields (colonne 1-16)
+    warehouseItemId: v.number(), // id from warehouse_items
+    name: v.string(),
+    quantity: v.optional(v.number()),
+    dentalUnitQuantity: v.optional(v.number()),
+    minQuantity: v.optional(v.number()),
+    minimumStockAmount: v.optional(v.number()),
+    lot: v.optional(v.string()),
+    netPrice: v.optional(v.number()),
+    deadlineDate: v.optional(v.string()),
+    warehouseOrisId: v.optional(v.string()),
+    articleId: v.number(),
+    clinicId: v.number(), // PrimoUP clinic ID
+    vendorId: v.optional(v.number()),
+    warehouseCreatedAt: v.optional(v.string()),
+    warehouseUpdatedAt: v.optional(v.string()),
+    warehouseDeletedAt: v.optional(v.string()),
+    
+    // Article fields (colonne 17-36)
+    articleInternalId: v.optional(v.number()), // second id column
+    code: v.optional(v.string()),
+    barcode: v.optional(v.string()),
+    articleName: v.optional(v.string()),
+    brand: v.optional(v.string()),
+    model: v.optional(v.string()),
+    articleCategoryId: v.optional(v.number()),
+    mu: v.optional(v.string()), // unit of measure
+    sellingUnit: v.optional(v.string()),
+    warehouseUnit: v.optional(v.string()),
+    case: v.optional(v.string()),
+    package: v.optional(v.string()),
+    articleOrisId: v.optional(v.string()),
+    articleDeadlineDate: v.optional(v.string()),
+    alternativeArticleId: v.optional(v.number()),
+    type: v.optional(v.string()),
+    labelInfosLength: v.optional(v.number()),
+    articleCreatedAt: v.optional(v.string()),
+    articleUpdatedAt: v.optional(v.string()),
+    articleDeletedAt: v.optional(v.string()),
+    
+    // Category fields (colonne 37-44)
+    categoryId: v.optional(v.number()), // third id column
+    categoryName: v.optional(v.string()),
+    parentId: v.optional(v.number()),
+    activeWarehouseCategory: v.optional(v.number()),
+    categoryOrisId: v.optional(v.string()),
+    categoryType: v.optional(v.string()),
+    categoryCreatedAt: v.optional(v.string()),
+    categoryUpdatedAt: v.optional(v.string()),
+  })
+    .index('by_clinicId', ['clinicId'])
+    .index('by_articleId', ['articleId'])
+    .index('by_warehouseItemId', ['warehouseItemId'])
+    .index('by_vendorId', ['vendorId'])
+    .index('by_articleCategoryId', ['articleCategoryId']),
+
+  // API Keys (Chiavi per accesso API esterno)
+  api_keys: defineTable({
+    name: v.string(), // Nome descrittivo della chiave (es. "Integrazione PrimoUp")
+    keyHash: v.string(), // Hash SHA-256 della chiave (la chiave originale non viene salvata!)
+    keyPrefix: v.string(), // Primi 8 caratteri della chiave (per identificazione)
+    permissions: v.array(v.string()), // Permessi: ["comments:add", "tickets:read", etc.]
+    createdBy: v.string(), // Auth0 ID dell'admin che l'ha creata
+    createdByEmail: v.optional(v.string()), // Email per riferimento
+    isActive: v.boolean(), // Se false, la chiave è revocata
+    lastUsedAt: v.optional(v.number()), // Ultimo utilizzo
+    usageCount: v.optional(v.number()), // Conteggio utilizzi
+    expiresAt: v.optional(v.number()), // Scadenza opzionale
+    revokedAt: v.optional(v.number()), // Data revoca
+    revokedBy: v.optional(v.string()), // Chi ha revocato
+    notes: v.optional(v.string()), // Note opzionali
+    createdAt: v.number(),
+  })
+    .index('by_keyHash', ['keyHash'])
+    .index('by_keyPrefix', ['keyPrefix'])
+    .index('by_isActive', ['isActive'])
+    .index('by_createdBy', ['createdBy']),
+
+  // Ticket comments (Commenti sulle segnalazioni)
+  ticket_comments: defineTable({
+    taskId: v.id('maintenance_tasks'), // Segnalazione a cui appartiene
+    authorId: v.string(), // Auth0 user ID dell'autore
+    authorName: v.optional(v.string()), // Nome dell'autore (cached)
+    authorEmail: v.optional(v.string()), // Email dell'autore (cached)
+    authorRole: v.optional(v.string()), // Ruolo dell'autore (admin, user, supplier)
+    content: v.string(), // Contenuto del commento
+    isInternal: v.optional(v.boolean()), // Se true, visibile solo ad admin e fornitori
+    isFromApi: v.optional(v.boolean()), // Se true, commento ricevuto via API esterna
+    attachments: v.optional(v.array(v.id('_storage'))), // Allegati opzionali
+    mentions: v.optional(v.array(v.object({
+      userId: v.id('user_profiles'),
+      name: v.string(),
+      email: v.string(),
+    }))), // Utenti taggati nel commento
+    createdAt: v.number(),
+    updatedAt: v.optional(v.number()),
+  })
+    .index('by_taskId', ['taskId'])
+    .index('by_authorId', ['authorId'])
+    .index('by_taskId_createdAt', ['taskId', 'createdAt']),
+
+  // Spare part orders (Ordini ricambi)
+  spare_part_orders: defineTable({
+    orderNumber: v.string(), // Numero ordine generato automaticamente
+    clinicId: v.number(), // PrimoUP clinic ID
+    supplierId: v.id('suppliers'), // Fornitore
+    status: v.union(
+      v.literal('draft'),        // Bozza
+      v.literal('pending'),      // In attesa
+      v.literal('confirmed'),    // Confermato
+      v.literal('shipped'),      // Spedito
+      v.literal('delivered'),    // Consegnato
+      v.literal('cancelled')     // Annullato
+    ),
+    items: v.array(v.object({
+      sparePartId: v.id('spare_parts'),
+      articleId: v.number(),
+      articleName: v.string(),
+      code: v.optional(v.string()),
+      quantity: v.number(),
+      unitPrice: v.optional(v.number()),
+      totalPrice: v.optional(v.number()),
+      notes: v.optional(v.string()),
+    })),
+    totalAmount: v.optional(v.number()),
+    notes: v.optional(v.string()),
+    requestedDeliveryDate: v.optional(v.number()),
+    actualDeliveryDate: v.optional(v.number()),
+    createdBy: v.string(), // Auth0 user ID
+    createdAt: v.number(),
+    updatedAt: v.number(),
+    confirmedAt: v.optional(v.number()),
+    shippedAt: v.optional(v.number()),
+    deliveredAt: v.optional(v.number()),
+  })
+    .index('by_clinicId', ['clinicId'])
+    .index('by_supplierId', ['supplierId'])
+    .index('by_status', ['status'])
+    .index('by_orderNumber', ['orderNumber'])
+    .index('by_createdAt', ['createdAt']),
+
+  // Device Categories (Categorie attrezzature da PrimoUP)
+  device_categories: defineTable({
+    primoupId: v.number(), // ID originale da PrimoUP
+    name: v.string(), // Nome categoria
+    parentId: v.optional(v.number()), // ID categoria padre (per gerarchia)
+    activeWarehouseCategory: v.optional(v.number()), // 0 o 1
+    orisId: v.optional(v.string()), // ID ORIS
+    type: v.optional(v.string()), // clinic, warehouse, lab
+    note: v.optional(v.string()), // null, "1" (attrezzature), "2" (ricambi), "3" (entrambi)
+    createdAt: v.optional(v.string()), // Data creazione originale da PrimoUP
+    updatedAt: v.optional(v.string()), // Data aggiornamento originale da PrimoUP
+    importedAt: v.number(), // Timestamp import in Convex
+  })
+    .index('by_primoupId', ['primoupId'])
+    .index('by_parentId', ['parentId'])
+    .index('by_note', ['note'])
+    .index('by_type', ['type'])
+    .index('by_name', ['name']),
+
+  // Email Logs (Log invio email via Resend)
+  email_logs: defineTable({
+    from: v.string(),
+    to: v.union(v.string(), v.array(v.string())),
+    subject: v.string(),
+    html: v.string(),
+    ticketId: v.optional(v.id('maintenance_tasks')),
+    status: v.union(
+      v.literal('sent'),
+      v.literal('failed'),
+      v.literal('pending')
+    ),
+    resendId: v.optional(v.string()), // ID email da Resend
+    errorMessage: v.optional(v.string()),
+    sentAt: v.number(),
+  })
+    .index('by_ticketId', ['ticketId'])
+    .index('by_status', ['status'])
+    .index('by_sentAt', ['sentAt']),
+
+  // Ticket History (Storico eventi ticket)
+  ticket_history: defineTable({
+    ticketId: v.id('maintenance_tasks'),
+    eventType: v.union(
+      v.literal('created'),           // Ticket creato
+      v.literal('status_change'),     // Cambio stato
+      v.literal('assignee_change'),   // Cambio assegnatario (fornitore)
+      v.literal('priority_change'),   // Cambio priorità
+      v.literal('trigger_executed'),  // Trigger eseguito
+      v.literal('comment_added'),     // Commento aggiunto
+      v.literal('sla_set'),           // SLA impostato
+      v.literal('sla_warning'),       // Warning SLA
+      v.literal('sla_breach'),        // SLA violato
+      v.literal('updated')            // Modifica generica
+    ),
+    // Dettagli evento
+    oldValue: v.optional(v.string()), // Valore precedente (es. stato precedente)
+    newValue: v.optional(v.string()), // Nuovo valore (es. nuovo stato)
+    // Per trigger
+    triggerName: v.optional(v.string()), // Nome del trigger che ha eseguito l'azione
+    triggerId: v.optional(v.id('ticket_triggers')), // ID del trigger
+    // Per assegnatario
+    oldSupplierId: v.optional(v.id('suppliers')),
+    newSupplierId: v.optional(v.id('suppliers')),
+    oldSupplierName: v.optional(v.string()),
+    newSupplierName: v.optional(v.string()),
+    // Chi ha fatto l'azione
+    performedBy: v.optional(v.string()), // Auth0 user ID (null se sistema/trigger)
+    performedByName: v.optional(v.string()), // Nome utente
+    performedByEmail: v.optional(v.string()), // Email utente
+    isSystemAction: v.boolean(), // True se azione automatica (trigger/sistema)
+    // Note aggiuntive
+    notes: v.optional(v.string()),
+    timestamp: v.number(),
+  })
+    .index('by_ticketId', ['ticketId'])
+    .index('by_ticketId_timestamp', ['ticketId', 'timestamp'])
+    .index('by_eventType', ['eventType'])
+    .index('by_timestamp', ['timestamp']),
+});