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

# Reconciliation: accesso e tenant

> Come uno studente entra nel tool dalla Mattone Platform, cosa viene creato al primo accesso, quali ruoli esistono.

## Come si entra

Si entra **sempre dalla Mattone Platform** (`app.mattone.co` → voce **Reconciliation**). La platform genera un codice usa-e-getta, valido pochi istanti (circa un minuto), e ti porta su `reconciliation.mattone.co` già dentro il tuo spazio. Non serve una seconda password.

La scadenza del codice è controllata **dalla platform**, che è anche l'unica a bruciarlo dopo il primo uso: il tool si limita a passarglielo e a fidarsi della risposta. Se il codice è scaduto o già usato, è la platform a rifiutarlo e tu torni alla schermata di login.

Esiste anche il login classico con utente, password e nome del tenant. È riservato agli amministratori e a Cosmica: uno studente non deve mai avere credenziali dirette del tool.

## Cos'è il tenant

Il **tenant** è lo spazio dello studente: conti bancari, movimenti, prenotazioni, riconciliazioni ed export sono tutti legati al suo tenant.

Quale tenant tocchi lo decide la platform, in quest'ordine:

1. **il tenant Reconciliation assegnato allo studente** sulla platform: è la fonte buona, ed è quella che va compilata. Se lo studente ne ha più di uno, vince quello marcato come principale;
2. solo **in mancanza del primo**, lo **slug dell'organizzazione** dello studente.

È il secondo passo a essere pericoloso: due persone nella stessa organizzazione senza tenant assegnato finiscono nello stesso spazio, e chi ha un'organizzazione mal collegata entra **nello spazio sbagliato**. Se qualcuno vede dati che non sono suoi, il primo controllo è il tenant Reconciliation assegnato sulla platform, non il tool.

## Cosa succede al primo accesso

Al primo ingresso il tool crea da solo:

* il **tenant**, se non esiste;
* l'**utente** dello studente, collegato al suo account Mattone.

Non ci sono dati: movimenti e prenotazioni si caricano dopo.

I **tre conti bancari** vuoti già pronti (Revolut, Sella, Intesa) **non nascono al login**: li crea il tool quando il suo backend si avvia, controllando quali spazi non hanno ancora nessun conto. In pratica:

* se un tenant esisteva già al momento dell'avvio, i tre conti ci sono e li trovi subito;
* se il tenant nasce **dopo** l'ultimo avvio — cioè un ragazzo che entra oggi per la prima volta — la pagina **Conti Bancari** gli risulta **vuota fino al riavvio successivo** del tool.

<Warning>
  **Un primo accesso senza conti bancari non è un guasto**, ma non aspettare in silenzio: segnalalo al team Mattone, che sa far ripartire il tool. Puoi anche crearti il conto a mano dalla pagina **Conti Bancari** scegliendo il tipo giusto — sappi però che da quel momento il tuo spazio non è più «vuoto», e i tre conti pronti **non arriveranno più**: la creazione automatica riguarda solo gli spazi che non hanno ancora nessun conto. Quello che hai creato tu non viene mai toccato né sovrascritto.
</Warning>

I conti, comunque creati, si possono rinominare, cambiare di tipo o affiancare ad altri dalla pagina **Conti Bancari**.

## Il menu

Dashboard · Riconciliazione · Transazioni bancarie · Conti Bancari · Proprietari · Pagamenti · Prenotazioni · Fatture · Cedolare Secca · **Import Mensile** (il wizard) · Integrazioni · Guida e FAQ. La voce **Amministrazione** compare solo agli amministratori di Mattone.

## Ruoli

| Ruolo | Chi | Cosa può fare |
| - | - | - |
| `user` | ogni studente, creato al primo accesso | tutto dentro il proprio tenant: import, riconciliazione, export |
| `super_admin` | team Mattone | in più la sezione Amministrazione, su tutti i tenant |

Non esistono ruoli intermedi (es. "solo lettura"): chi entra nel tenant può importare e cancellare.

<Warning>
  **Un utente nel tenant sbagliato vede la banca di quel tenant.** È successo con un account collegato a Cosmica: chi crea o corregge collegamenti sulla platform deve verificare il tenant Reconciliation assegnato — e, se manca, sapere che si finisce sullo slug dell'organizzazione — **prima** di far entrare la persona.
</Warning>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.