Altri Composables

import { useAttivitaDashboard } from '@pzeta/vue-attivita'

const {
  attivita, utente, contatori, loading, error, filtriAttivi,
  fetchDashboard, fetchContatori, applyFiltri,
  groupByTipo, groupByScadenza
} = useAttivitaDashboard()

onMounted(fetchDashboard)

// Raggruppamento per scadenza
const { in_ritardo, oggi, futuro } = groupByScadenza()

// Filtra per tipo
await applyFiltri({ codtipoattivita: 'telefonata', stato: 'pianificata' })

attivita:scadenza-imminente { totale_in_ritardo, oggi }

import { useAttivitaCalendario } from '@pzeta/vue-attivita'

const {
  attivita, loading, currentRange, viewMode, error,
  fetchForRange, updateScadenza, setViewMode, navigateMonth
} = useAttivitaCalendario()

await fetchForRange({ start: '2026-05-01', end: '2026-05-31' })

// Drag-and-drop — UI aggiornata subito, rollback automatico se fallisce
await updateScadenza(idattivita, '2026-05-20')

// Navigazione (guard anti-race-condition: ignora click mentre fetch è in corso)
await navigateMonth(1)   // mese successivo
await navigateMonth(-1)  // mese precedente

setViewMode('week')      // ref informativa — il rendering è responsabilità del consumer/View

import { useAttivitaContext } from '@pzeta/vue-attivita'

const { repository, getToken, onEvent, apiBaseUrl, refreshSignal } = useAttivitaContext()

import { useTipiAttivita } from '@pzeta/vue-attivita'

const {
  tipi, loading, loaded,
  fetchTipi, createTipo, updateTipo, deleteTipo,
  getTipoById, getTipoByCode, getTipiAttivi, getTipoRiunione
} = useTipiAttivita()

await fetchTipi()              // primo load
await fetchTipi(true)          // force refresh

const attivi = getTipiAttivi()                    // solo `attivo === true`
const tipo = getTipoById(3)
const email = getTipoByCode('email')
const riunione = getTipoRiunione()                // primo tipo con `azione === 'riunione'`

// Admin
const created = await createTipo({
  nome: 'Visita ispettiva',
  codtipoattivita: 'visita',
  // ... resto dei campi
})
const updated = await updateTipo(idtipoattivita, { nome: 'Visita ispettiva (revisione)' })

// Hard delete (v1.0.0) — lancia errore FK se ci sono attività referenziate
try {
  await deleteTipo(idtipoattivita)
} catch (e) {
  // Tipico: violazione FK perché esistono attività di questo tipo.
  // Considera updateTipo({ attivo: false }) come soft delete alternativo.
}

import { ref } from 'vue'
import { useConcatenamento } from '@pzeta/vue-attivita'
import type { AttivitaSuccessiva } from '@pzeta/vue-attivita'

const attivitaSuggerite = ref<AttivitaSuccessiva[]>([])

const {
  showSuggerimento,    // visibilità popup corrente
  suggeritaCorrente,   // AttivitaSuccessiva | null
  processResponse,     // (response: CompletaAttivitaResponse) => void
  accetta,             // () => Partial<AttivitaFormState>  ← per pre-fillare AttivitaForm
  rifiuta,             // () => void  ← passa al successivo o chiude
  modifica,            // () => Partial<AttivitaFormState>  ← alias di accetta
  hasNext,             // () => boolean
} = useConcatenamento(attivitaSuggerite)

// Dopo un completamento
async function completa(idattivita: number, risultato: string) {
  const response = await repository.completaAttivita({ p_idattivita: idattivita, p_risultato: risultato })
  processResponse(response)   // popola attivitaSuggerite e apre popup se ci sono `suggerita`
}

// Nel template del popup
function onAccetta() {
  const prefillState = accetta()   // pre-compila AttivitaForm
  apriAttivitaFormCon(prefillState)
}

import { useRicorrenza } from '@pzeta/vue-attivita'

const {
  ricorrenzaAbilitata,        // Ref<boolean> — toggle UI
  ricorrenzaForm,             // Ref<RicorrenzaForm> — campi form
  mostraGiorniAnticipo,       // ComputedRef<boolean> — true se trigger='data_fissa'
  reset, loadFromExisting, buildPayload,
  fetchRicorrenza, saveRicorrenza, disattivaRicorrenza,
} = useRicorrenza()

await fetchRicorrenza(idattivita)            // popola form se esiste
const ricorrenza = await saveRicorrenza(idattivita)  // create o update
await disattivaRicorrenza(idricorrenza)

import { useDocumento } from '@pzeta/vue-attivita'

const { isUploading, documento, error, uploadFile } = useDocumento()

await uploadFile(idattivita, file, 'descrizione opzionale')
// → POST {apiBaseUrl}/api/attivita/{idattivita}/upload-documento  (multipart/form-data)
// documento.value → UploadDocumentoResult { iddocumento, nome, url, dimensione }

import { useRichiestafirma } from '@pzeta/vue-attivita'

const { isInviando, risultato, error, inviaRichiesta } = useRichiestafirma()

await inviaRichiesta(idattivita, {
  iddocumento: 10,
  firmatari: [{ email: 'mario@example.com', nome: 'Mario Rossi', ordine: 1 }],
  messaggio: 'Firma il contratto',
  scadenzafirma: '2026-12-31',
  firmadelrichiedente: null,
})
// → POST {apiBaseUrl}/api/attivita/{idattivita}/richiedi-firma
// risultato.value → RichiestafirmaResult { idrichiestafirma, stato, urlfirma }