> ## Documentation Index
> Fetch the complete documentation index at: https://manuale.bakney.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Istruttori

> In questa sezione troverai tutte le informazioni per gestire gli istruttori della tua associazione sportiva in Bakney Sport.

## Introduzione

La sezione Istruttori ti permette di gestire in modo completo il personale che tiene i corsi
nella tua associazione. Puoi creare profili, registrare le ore lavorate, calcolare i compensi
e generare report dettagliati.

<CardGroup cols={2}>
  <Card title="Aggiungi un Istruttore" icon="user-plus" href="#aggiungere-un-istruttore">
    Come creare un nuovo profilo istruttore.
  </Card>

  <Card title="Registrare le ore" icon="clock" href="#registrare-le-ore-lavorate">
    Come registrare le ore di lavoro giornaliere.
  </Card>

  <Card title="Compensi" icon="calculator" href="#tipi-di-compenso">
    Come funzionano i compensi orari e a percentuale.
  </Card>

  <Card title="Report Istruttori" icon="print" href="#generare-un-report">
    Come generare un report delle attività degli istruttori.
  </Card>
</CardGroup>

## Aggiungere un Istruttore

Per aggiungere un istruttore vai nella sezione **Istruttori** e clicca su **Istruttore** (il pulsante in alto a destra).
Si aprirà la pagina di creazione con un modulo da compilare.

### Informazioni obbligatorie

Per creare un istruttore devi inserire almeno i seguenti campi:

1. **Nome**: il nome dell'istruttore
2. **Cognome**: il cognome dell'istruttore
3. **Email**: l'indirizzo email dell'istruttore

### Informazioni anagrafiche

Puoi inoltre completare il profilo con ulteriori dati anagrafici:

* **Data di nascita**: la data di nascita dell'istruttore
* **Città di nascita**: la città di nascita
* **Provincia di nascita**: la provincia di nascita
* **Codice fiscale**: il codice fiscale dell'istruttore
* **Città di residenza**: la città dove risiede
* **Indirizzo**: l'indirizzo di residenza
* **Civico**: il numero civico
* **Provincia di residenza**: la provincia di residenza
* **Telefono**: il numero di telefono principale
* **Telefono 2**: un secondo numero di telefono (opzionale)

### Informazioni contratto

Se l'istruttore ha un contratto con l'associazione, puoi compilare anche:

* **È un volontario**: attiva questa opzione se l'istruttore è un volontario. In questo caso i campi relativi al contratto verranno disabilitati
* **Data stipula contratto**: la data in cui è stato firmato il contratto
* **Titolo di studio**: il titolo di studio dell'istruttore
* **Ruolo**: il ruolo dell'istruttore all'interno dell'associazione (il valore predefinito è "Istruttore")

### Tariffe predefinite

Puoi impostare le tariffe predefinite che verranno usate automaticamente ogni volta che registri le ore di questo istruttore:

* **Tariffa oraria di default (€/ora)**: il compenso orario predefinito. Ad esempio, se imposti 15,00 €/ora, ogni volta che aggiungi le ore lavorate il sistema userà questa tariffa per calcolare il compenso
* **Percentuale di default (%)**: la percentuale predefinita sugli introiti dei corsi. Utile per istruttori che ricevono una quota dei pagamenti degli atleti

<Tip>
  Impostare le tariffe predefinite ti fa risparmiare tempo: non dovrai inserirle ogni volta
  che registri le ore di un istruttore.
</Tip>

### Account collaboratore associato

Puoi associare l'istruttore ad un account collaboratore esistente. In questo modo, quando quel collaboratore
accede a Bakney Sport, vedrà solamente le proprie informazioni e i propri compensi.

<Info>
  L'associazione ad un account collaboratore è facoltativa. Se non associ un account,
  solo tu (come amministratore) potrai vedere i dati dell'istruttore.
</Info>

Una volta compilati tutti i campi necessari, clicca su **Crea Istruttore** per salvare il profilo.

## Modificare un Istruttore

Per modificare le informazioni di un istruttore, dalla lista degli istruttori clicca sull'icona di modifica
(la matita) accanto al nome dell'istruttore. Si aprirà una finestra con tutti i campi del profilo
che potrai aggiornare.

Dopo aver effettuato le modifiche, clicca su **Salva** per confermare.

## Eliminare un Istruttore

Per eliminare un istruttore, dalla lista degli istruttori clicca sull'icona del cestino accanto
al nome dell'istruttore. Ti verrà chiesta una conferma prima di procedere con l'eliminazione.

<Warning>
  L'eliminazione di un istruttore è definitiva e comporta anche la perdita di tutti i dati
  relativi alle ore lavorate e ai compensi associati.
</Warning>

## La scheda dell'Istruttore

Per accedere alla scheda completa di un istruttore, clicca sul suo **nome** nella lista degli istruttori.
Si aprirà la pagina con il riepilogo dei compensi e la tabella delle ore registrate.

Nella parte superiore della scheda troverai quattro indicatori riassuntivi:

* **Ore lavorate**: il totale delle ore registrate nel periodo selezionato
* **Compenso totale**: la somma di tutti i compensi nel periodo selezionato
* **Compenso da pagare**: la somma dei compensi non ancora pagati
* **Compenso pagato**: la somma dei compensi già pagati

<Tip>
  Puoi filtrare i dati per periodo usando il selettore di date in alto. Per impostazione predefinita
  viene mostrato il mese corrente, ma puoi scegliere tra filtri rapidi come "Oggi", "Mese scorso",
  "Ultimi 30 giorni" oppure selezionare un periodo personalizzato.
</Tip>

## Registrare le ore lavorate

Per registrare le ore di un istruttore, dalla scheda dell'istruttore clicca su **Aggiungi** in alto a destra.
Si aprirà una finestra dove potrai inserire i dettagli.

### Campi principali

* **Data**: la data in cui sono state svolte le ore
* **Stato**: indica se il compenso è già stato pagato o è ancora da pagare

### Tipi di compenso

Bakney Sport supporta due modalità di compenso per gli istruttori. Puoi scegliere il tipo di compenso
tramite le schede **Orario** e **Percentuale**.

#### Compenso orario

Il compenso orario è il metodo più diretto: inserisci il numero di ore lavorate e la tariffa oraria,
e il sistema calcola automaticamente l'importo totale.

* **Ore**: il numero di ore lavorate (puoi inserire anche mezze ore, ad esempio 1,5)
* **€/ora**: la tariffa oraria dell'istruttore. Se hai impostato una tariffa predefinita nel profilo, questo campo sarà già compilato

Il compenso viene calcolato automaticamente: **Ore x €/ora = Compenso totale**.

<Info>
  Ad esempio, se un istruttore lavora 3 ore a 15,00 €/ora, il compenso totale sarà di 45,00 €.
</Info>

#### Compenso a percentuale

Il compenso a percentuale ti permette di calcolare il compenso dell'istruttore in base ad una
percentuale sui pagamenti degli atleti iscritti ai corsi.

<Steps>
  <Step title="Seleziona i corsi">
    Scegli uno o più corsi da cui calcolare gli introiti.
  </Step>

  <Step title="Imposta la percentuale">
    Inserisci la percentuale sugli introiti che spetta all'istruttore (ad esempio 20%).
  </Step>

  <Step title="Seleziona il periodo">
    Scegli il periodo di riferimento per il calcolo (ad esempio il mese corrente).
  </Step>

  <Step title="Clicca su Calcola">
    Il sistema analizza tutti i pagamenti degli atleti per i corsi selezionati nel periodo indicato e calcola il compenso.
  </Step>
</Steps>

Dopo aver cliccato su **Calcola**, vedrai il dettaglio di ogni pagamento con il nome dell'atleta,
il corso, la data del pagamento e il calcolo della percentuale. Se necessario, puoi rimuovere
singole voci dal calcolo cliccando sull'icona del cestino accanto a ciascuna.

<Note>
  Il calcolo a percentuale considera solo i pagamenti che risultano effettivamente saldati
  dagli atleti nel periodo selezionato.
</Note>

### Note e salvataggio

In ogni registrazione puoi aggiungere delle **Note** (massimo 500 caratteri) per annotare informazioni
aggiuntive, come ad esempio il tipo di lezione svolta.

In fondo alla finestra è sempre visibile il **Compenso totale** calcolato. Clicca su **Salva** per
confermare la registrazione.

## Gestire i compensi

### Creare un compenso

Una volta registrate le ore, puoi creare un compenso ufficiale (pagamento) selezionando
le ore dalla tabella nella scheda dell'istruttore.

<Steps>
  <Step title="Seleziona le ore">
    Nella tabella delle ore, spunta le caselle accanto alle registrazioni che vuoi includere nel compenso.
  </Step>

  <Step title="Clicca su Crea compenso">
    Comparirà il pulsante **Crea compenso** con il numero di ore selezionate. Clicca su di esso.
  </Step>

  <Step title="Conferma">
    Ti verrà mostrata una finestra di conferma. Il sistema creerà il compenso solo per le ore che non sono ancora state pagate e che non hanno già un pagamento associato.
  </Step>
</Steps>

<Info>
  Il compenso creato verrà registrato nella sezione **Contabilità > Pagamenti** come spesa
  nella categoria "Compensi e Rimborsi Spese". Per ogni compenso viene generato automaticamente
  un documento in formato PDF.
</Info>

### Stato dei compensi

Nella tabella delle ore, ogni registrazione mostra uno stato:

* **Da pagare**: il compenso non è ancora stato saldato
* **Pagato**: il compenso è stato pagato

Quando il pagamento associato viene saldato dalla contabilità, lo stato si aggiorna automaticamente.

### Documento del compenso

Per ogni compenso pagato viene generato un documento PDF che puoi visualizzare e scaricare
cliccando sull'icona del documento nella colonna delle azioni. Il documento può anche essere
firmato digitalmente dall'istruttore direttamente dalla piattaforma.

## Modificare o eliminare le ore registrate

### Modificare una registrazione

Per modificare una registrazione, clicca sull'icona di modifica (la matita) nella riga corrispondente.
Si aprirà la finestra di modifica dove potrai aggiornare tutti i campi.

<Note>
  Non è possibile modificare una registrazione che ha già un pagamento associato.
  Per modificarla, dovrai prima gestire il pagamento dalla sezione contabilità.
</Note>

### Eliminare una registrazione

Per eliminare una registrazione, clicca sull'icona del cestino nella riga corrispondente.
Ti verrà chiesta una conferma prima di procedere.

<Warning>
  Non è possibile eliminare una registrazione che ha già un pagamento associato.
</Warning>

## Generare un report

Puoi generare un report completo delle attività di tutti gli istruttori.
Il report include le presenze registrate nei registri dei corsi.

<Steps>
  <Step title="Apri la finestra del report">
    Dalla lista degli istruttori, clicca sul pulsante **Stampa Report** in alto.
  </Step>

  <Step title="Seleziona il periodo">
    Inserisci la data di inizio e la data di fine del periodo che vuoi analizzare.
  </Step>

  <Step title="Genera il report">
    Clicca su **Genera Report** per scaricare il file Excel.
  </Step>
</Steps>

Il report generato in formato Excel contiene le seguenti informazioni per ogni lezione:

* **Nome e Cognome** dell'istruttore
* **Corso**: il nome del corso
* **Titolo**: il titolo della lezione
* **Descrizione**: la descrizione della lezione
* **Data**: la data e l'ora della lezione
* **Numero di partecipanti**: quanti atleti erano presenti
* **Partecipanti**: i nomi degli atleti presenti
* **Assenti previsti**: i nomi degli atleti segnati come assenti

<Tip>
  Il report è particolarmente utile a fine mese per verificare le ore effettivamente
  lavorate dagli istruttori prima di calcolare i compensi.
</Tip>

## Assegnare un istruttore ai corsi

Gli istruttori possono essere assegnati alle lezioni dei corsi direttamente dal calendario
del corso. Quando crei o modifichi una lezione nel calendario, puoi selezionare l'istruttore
che la terrà.

Per maggiori informazioni sulla gestione del calendario e delle lezioni, consulta la sezione
[Corsi](/docs/corsi#calendario-delle-lezioni).
