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

# Ruoli e permessi

> Matrice dei permessi per ogni ruolo e ogni modulo.

Reference completo dei permessi di ogni ruolo standard. Per configurare ruoli custom vedi [Team e ruoli](/it/impostazioni/team-e-ruoli).

## Ruoli standard

<CardGroup cols={2}>
  <Card title="Admin">Controllo totale workspace.</Card>
  <Card title="Manager">Gestione team e automazioni.</Card>
  <Card title="User">Utilizzo quotidiano operativo.</Card>
  <Card title="Read-only">Solo consultazione (commercialista).</Card>
  <Card title="Guest">Accesso limitato a progetti specifici.</Card>
</CardGroup>

## Matrice permessi CRM

| Azione                    | Admin | Manager | User | Read-only | Guest |
| ------------------------- | ----- | ------- | ---- | --------- | ----- |
| Vedere deal del workspace | ✅     | ✅       | ❌    | ✅         | ❌     |
| Vedere propri deal        | ✅     | ✅       | ✅    | ✅         | 🔸    |
| Vedere deal del team      | ✅     | ✅       | 🔸   | ✅         | ❌     |
| Creare deal               | ✅     | ✅       | ✅    | ❌         | ❌     |
| Modificare propri         | ✅     | ✅       | ✅    | ❌         | ❌     |
| Modificare altrui         | ✅     | 🔸      | ❌    | ❌         | ❌     |
| Eliminare deal            | ✅     | 🔸      | ❌    | ❌         | ❌     |
| Esportare CSV             | ✅     | ✅       | 🔸   | ✅         | ❌     |
| Import bulk               | ✅     | ✅       | ❌    | ❌         | ❌     |

🔸 = condizionale (es. solo se owner del record, o solo sui membri del team)

## Matrice permessi Finance

| Azione                     | Admin | Manager | User | Read-only |
| -------------------------- | ----- | ------- | ---- | --------- |
| Vedere fatture attive      | ✅     | ✅       | 🔸   | ✅         |
| Emettere fatture           | ✅     | ✅       | 🔸   | ❌         |
| Vedere fatture passive     | ✅     | ✅       | ❌    | ✅         |
| Approvare fatture passive  | ✅     | 🔸      | ❌    | ❌         |
| Riconciliazione bancaria   | ✅     | 🔸      | ❌    | ❌         |
| Vedere bilancio            | ✅     | 🔸      | ❌    | ✅         |
| Chiusura periodo           | ✅     | ❌       | ❌    | ❌         |
| Modificare piano dei conti | ✅     | ❌       | ❌    | ❌         |

## Matrice permessi HR

| Azione                         | Admin HR | Manager  | User         | Dipendente (self) |
| ------------------------------ | -------- | -------- | ------------ | ----------------- |
| Anagrafica completa dipendenti | ✅        | 🔸       | ❌            | Solo propria      |
| Buste paga                     | ✅        | ❌        | ❌            | Solo proprie      |
| Stipendi e costi               | ✅        | ❌        | ❌            | Solo proprio      |
| Approvare ferie team           | ✅        | ✅        | ❌            | ❌                 |
| Vedere ferie colleghi          | ✅        | ✅        | 🔸           | Team              |
| Modificare contratti           | ✅        | ❌        | ❌            | ❌                 |
| Performance review             | ✅        | ✅ (team) | Solo proprie | Solo proprie      |

## Matrice permessi automazioni

| Azione                    | Admin | Manager | User |
| ------------------------- | ----- | ------- | ---- |
| Creare workflow           | ✅     | ✅       | ❌    |
| Modificare workflow       | ✅     | 🔸      | ❌    |
| Attivare/disattivare      | ✅     | 🔸      | ❌    |
| Vedere run history        | ✅     | ✅       | 🔸   |
| Eseguire workflow manuali | ✅     | ✅       | ✅    |
| Configurare webhook       | ✅     | ❌       | ❌    |

## Matrice permessi settings

| Azione                 | Admin | Manager             | User |
| ---------------------- | ----- | ------------------- | ---- |
| Impostazioni workspace | ✅     | ❌                   | ❌    |
| Team e ruoli           | ✅     | 🔸 (invito al team) | ❌    |
| Billing                | ✅     | ❌                   | ❌    |
| Integrazioni           | ✅     | 🔸                  | ❌    |
| Oggetti custom         | ✅     | ❌                   | ❌    |
| Automazioni globali    | ✅     | 🔸                  | ❌    |

## Ownership e visibility

Oltre ai ruoli, ogni record ha:

<AccordionGroup>
  <Accordion title="Owner">
    Chi "possiede" il record (es. commerciale per deal). Sempre può modificare.
  </Accordion>

  <Accordion title="Team assegnato">
    Team può vedere/modificare in base al ruolo.
  </Accordion>

  <Accordion title="Visibility flag">
    * **Pubblico**: tutto il workspace
    * **Team**: solo team assegnato
    * **Privato**: solo owner + admin
  </Accordion>

  <Accordion title="Permessi granulari">
    Admin può definire regole custom per record specifici (es. "questo deal visibile solo a 3 persone specifiche").
  </Accordion>
</AccordionGroup>

## Permessi a livello campo

Per campi sensibili puoi rendere un attributo:

* **Visibile solo a certi ruoli**
* **Read-only per certi ruoli**
* **Nascosto a certi ruoli**

Esempio: campo "Stipendio" su employee → visibile solo ad Admin HR e CEO.

## Ruoli custom

Se i 5 standard non bastano, crea custom da **Impostazioni → Team → Ruoli → + Nuovo**:

* Clone da esistente (es. User + qualche permesso extra)
* Definisci granulare per ogni modulo
* Applica a utenti esistenti o nuovi

## Audit log

Ogni azione sensibile è loggata:

* Chi (utente)
* Cosa (tipo azione)
* Quando (timestamp UTC)
* Dove (IP + device)
* Dati (before/after per modifiche)

Accedi da **Impostazioni → Sicurezza → Audit log**. Esportabile in CSV per compliance.

## Domande frequenti

<AccordionGroup>
  <Accordion title="Cosa succede se un utente cambia ruolo?">I permessi si applicano immediatamente. Record già aperti potrebbero richiedere refresh.</Accordion>
  <Accordion title="Posso delegare permessi temporaneamente?">Sì, funzione "Impersonate" (solo Admin). Tutte le azioni sono loggate come "X per conto di Y".</Accordion>
</AccordionGroup>