> ## 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.

# Concetti chiave

> Workspace, oggetti, record, attributi, viste: il vocabolario che devi sapere per usare Arya.

Arya Nest è costruito intorno a un modello dati configurabile. Capire cinque concetti ti basta per usare qualsiasi modulo — dal CRM alle HR — con lo stesso linguaggio.

## Workspace

Il **workspace** è l'ambiente isolato della tua azienda. Contiene tutti i dati (deal, contatti, progetti, fatture, dipendenti), le automazioni, le integrazioni e gli utenti. Ogni workspace è separato dagli altri: se la tua azienda ha più filiali, puoi avere workspace diversi oppure un unico workspace con oggetti condivisi.

<Frame>
  <img src="https://mintcdn.com/agevole/BUuJGD62nuns4mJL/images/hero/workspace-structure.svg?fit=max&auto=format&n=BUuJGD62nuns4mJL&q=85&s=152ff026cf35105a133319dbf832b8cf" alt="Diagramma del workspace con oggetti, record, utenti e integrazioni" width="1200" height="720" data-path="images/hero/workspace-structure.svg" />
</Frame>

## Oggetti

Un **oggetto** è un tipo di entità che puoi gestire in Arya. Gli oggetti standard sono:

| Oggetto  | Cosa rappresenta                      |
| -------- | ------------------------------------- |
| Deal     | Opportunità di vendita                |
| Company  | Azienda cliente o fornitore           |
| Contact  | Persona fisica collegata a un'azienda |
| Task     | Attività operativa da completare      |
| Project  | Commessa, lavoro multi-task           |
| Invoice  | Fattura emessa o ricevuta             |
| Employee | Dipendente o collaboratore            |

Puoi creare **oggetti personalizzati** (per esempio `Fornitore`, `Asset`, `Polizza`) dalle [impostazioni](/it/impostazioni/oggetti-personalizzati). Un oggetto custom ha le stesse funzionalità di uno standard: viste, filtri, automazioni, AI.

## Record

Un **record** è una singola istanza di un oggetto. Esempi:

* Il deal `Acquisto nuovo software Acme SpA` è un record dell'oggetto `Deal`.
* Il contatto `Mario Rossi` è un record dell'oggetto `Contact`.
* La fattura `FT-2026-0042` è un record dell'oggetto `Invoice`.

Ogni record ha un URL stabile, uno storico attività, commenti, allegati e link ad altri record.

## Attributi

Un **attributo** è un campo di un oggetto. Ogni oggetto ha attributi built-in (nome, data, stato) e puoi aggiungere **attributi personalizzati**. Tipi di attributo disponibili:

<AccordionGroup>
  <Accordion title="Testo">
    Stringa libera. Usato per nomi, descrizioni, note brevi.
  </Accordion>

  <Accordion title="Numero e valuta">
    Numerico con eventuale formato valuta (EUR, USD, ecc.). Usato per importi, quantità, percentuali.
  </Accordion>

  <Accordion title="Data e data/ora">
    Seleziona un giorno o un timestamp. Usato per scadenze, creazione, date di firma.
  </Accordion>

  <Accordion title="Select (dropdown)">
    Scelta tra opzioni predefinite. Usato per stati, categorie, priorità.
  </Accordion>

  <Accordion title="Checkbox">
    Vero / falso. Usato per flag come `è cliente`, `fattura pagata`.
  </Accordion>

  <Accordion title="Riferimento a record">
    Link a un altro record. Usato per collegare un deal all'azienda, una fattura al progetto.
  </Accordion>

  <Accordion title="Formula">
    Calcolato da altri attributi. Usato per margini, valore ponderato, totali.
  </Accordion>

  <Accordion title="Stato (status)">
    Select speciale con workflow definito (es. `Prospect → Qualified → Won`).
  </Accordion>
</AccordionGroup>

Vedi la [Lezione 3](/it/arya-101/lezione-3-attributi) per un walkthrough pratico.

## Viste e liste

Una **vista** è un modo di guardare un insieme di record. Sugli stessi deal puoi avere:

* Una vista Kanban (drag-and-drop per stage)
* Una vista tabella (righe e colonne come Excel)
* Una vista calendario (per data di chiusura)
* Una vista Gantt (per progetti)

Una **lista** è un insieme filtrato di record con le proprie colonne. Può essere:

* **Statica**: aggiungi e rimuovi record manualmente.
* **Dinamica**: contiene automaticamente tutti i record che rispettano un filtro (es. `deal > 50.000 € creati quest'anno`).

Approfondisci in [Liste](/it/liste/overview).

## Relazioni

I record si **collegano tra loro**. Esempi:

* Un `Deal` ha una `Company` (azienda cliente) e uno o più `Contact`.
* Un `Project` ha una `Company`, uno o più `Task` e uno o più `Quote`.
* Una `Invoice` appartiene a una `Company` e (opzionalmente) a un `Project`.

Le relazioni permettono di navigare: apri un deal e vedi istantaneamente tutti i contatti collegati, i task aperti, i preventivi inviati, le chiamate registrate.

## Utenti, ruoli e permessi

Gli **utenti** sono le persone del tuo team con accesso al workspace. A ogni utente assegni un **ruolo** che determina cosa può fare:

| Ruolo     | Può fare                                                        |
| --------- | --------------------------------------------------------------- |
| Admin     | Tutto, incluso modifiche a impostazioni, fatturazione, team     |
| Manager   | Vedere e modificare tutti i record del team, creare automazioni |
| User      | Vedere e modificare i propri record e quelli condivisi          |
| Read-only | Solo lettura su tutto il workspace                              |

I permessi possono essere raffinati per modulo e per campo. Vedi [Ruoli e permessi](/it/riferimenti/ruoli-e-permessi).

## Automazioni

Un'**automazione** (o *workflow*) è una sequenza di azioni che parte al verificarsi di un evento. Esempio: *"Quando un deal viene spostato su `Won`, crea un progetto, notifica Slack e invia email di conferma al cliente"*.

Le automazioni sono visuali, senza codice. Vedi [Automazioni](/it/automazioni/overview).

## AI e crediti

Arya integra l'AI in ogni modulo tramite **AryaChat** (chat conversazionale), assistente contestuale sulle pagine e **Arya Report Chat** (analisi dei report in linguaggio naturale). L'uso dell'AI consuma **crediti**, che ricarichi mensilmente col piano o acquisti separatamente. Vedi [AryaChat e crediti AI](/it/arya-101/lezione-10-ai-e-aryachat).

## Prossimi passi

<CardGroup cols={2}>
  <Card title="Guida rapida" icon="rocket" href="/it/quickstart">
    Metti in pratica questi concetti in 10 minuti.
  </Card>

  <Card title="Arya 101" icon="graduation-cap" href="/it/arya-101/overview">
    Dieci lezioni per diventare completamente operativo.
  </Card>
</CardGroup>
