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

# Step 1 · Anagrafica e registro appartamenti su Notion

> Crea e allinea il database Apartments su Notion: fonte canonica per KB, listino e contratti. Deve essere completo prima di ogni altro step.

Il registro appartamenti su Notion è la fonte canonica da cui dipendono tutti gli altri sistemi: la Knowledge Base di Conduit, il listino prezzi, i contratti e le istruzioni di accesso. Nessun altro step può essere completato correttamente se questo database non è allineato al template Mattone e compilato con tutti i dati reali dello studente. Prenditi il tempo necessario per farlo bene prima di proseguire.

## Prerequisiti

Prima di iniziare questo step, verifica che siano soddisfatte queste condizioni:

* Il workspace Notion dello studente è connesso alla piattaforma Mattone tramite OAuth (dalla sezione Connessioni della piattaforma Mattone)
* Hai in mano la lista reale degli appartamenti gestiti dallo studente, ciascuno con:
  * Nome dell'appartamento (es. *Loft Navigli A*)
  * Indirizzo completo
  * PMS di riferimento (es. KrossBooking)
  * `listing_id` assegnato dal PMS

<Info>
  **Cosa dire allo studente, collegare Notion**

  Il collegamento a Notion si fa **da dentro la piattaforma Mattone**, non su Notion e senza incollare nessuna chiave. Passa allo studente queste istruzioni, così come sono:

  1. Vai su [**app.mattone.co**](https://app.mattone.co/connessioni) e accedi.
  2. Apri la sezione **Connessioni**.
  3. Sulla card **Notion**, clicca **Collega Notion**.
  4. Si apre la finestra di **Notion**: fai login (se richiesto) e clicca **Consenti / Autorizza** per dare l'accesso al tuo workspace.
  5. Torni in automatico sulla piattaforma: la connessione **Notion** deve diventare **verde (Connesso)**.

  Da dire chiaro: *"È un collegamento sicuro (OAuth). Non devi copiare né inviarci nessuna password o chiave: autorizzi tu direttamente da Notion e puoi revocare l'accesso quando vuoi."*
</Info>

## Step (in ordine)

<Steps>
  <Step title="Verifica che il database Apartments esiste ed è allineato al template">
    Apri il workspace Notion dello studente e individua il database *Apartments*. Controlla che la struttura delle colonne corrisponda esattamente al template Mattone: se mancano proprietà obbligatorie (es. `listing_id`, `smart_lock`, `pms`) o ne esistono di extra non previste, allinea il database prima di procedere.

    Consulta la guida alla struttura del DB e all'allineamento del template su [Notion · DB Apartments](/integrazioni/notion/db-apartments).
  </Step>

  <Step title="Compila i campi mancanti per ogni appartamento">
    Per ogni riga del database, verifica e completa i seguenti campi:

    * **Foto**: almeno una foto dell'appartamento (usata nella KB)
    * **Indirizzo**: indirizzo completo comprensivo di CAP e città
    * **Note di accesso**: istruzioni per raggiungere l'appartamento, codici citofono, indicazioni per il parcheggio
    * **listing\_id**: identificativo univoco dell'appartamento nel PMS; questo campo è obbligatorio e deve essere valorizzato per ogni appartamento

    Se un campo non è applicabile, inserisci esplicitamente `N/A` per indicare che è stato valutato e non lasciarlo vuoto.
  </Step>

  <Step title="Indica smart lock e PMS per ogni appartamento">
    Per ogni appartamento, compila:

    * **Smart lock**: imposta il valore corretto: `Shelly`, `SwitchBot`, oppure `Nessuna`. Questo campo determina se lo Step 4 (Smart check-in) si applica o meno a quell'appartamento.
    * **PMS**: seleziona il PMS associato (es. `KrossBooking`). In questa fase lo studente usa un solo PMS, ma il campo deve essere valorizzato correttamente per ogni appartamento.
  </Step>
</Steps>

## Verifica

Questo step è **completo** quando:

* Il database *Apartments* su Notion è allineato alla struttura del template Mattone (nessuna colonna obbligatoria mancante)
* Ogni appartamento ha il campo `listing_id` valorizzato con l'ID reale dal PMS
* I campi foto, indirizzo e note di accesso sono compilati per tutti gli appartamenti
* Il campo `smart_lock` è impostato in modo accurato per ogni appartamento

<Note>
  Per la struttura dettagliata del DB Apartments e la guida all'allineamento del template, consulta [Notion · DB Apartments](/integrazioni/notion/db-apartments).
</Note>

***

Step completato? Procedi con → [Step 2 · KrossBooking](/onboarding/2-pms-kross)

<Tip>
  **▷ Prompt Claude Code: Anagrafica & Notion**  ·  incolla in Claude Code:
</Tip>

```text theme={null}
Contesto: in questa sessione di Claude Code NON hai il repo/codice caricato.
Per prima cosa apri il repo `~/Projects/mattone-platform` (bridge Notion ->
registro appartamenti) e LEGGI la pagina mattone-docs /onboarding/1-anagrafica-notion
(leggila davvero, non andare a memoria); usa gli MCP (Notion, Supabase) per i
dati veri. Poi procedi:

Guidami nello step 1 dell'onboarding (Anagrafica & Notion) per lo studente
[NOME], seguendo mattone-docs /onboarding/1-anagrafica-notion. Verifica che il
Notion sia collegato alla Mattone Platform (non solo alla Conduit); controlla
che il DB "Strutture"/"Apartments" sia allineato al template (una pagina per
appartamento) e che la colonna Name abbia i nomi ESATTI dei listing PMS.
Segnalami campi mancanti (WiFi, keybox, indirizzo, CIN/CIR) e cosa è Internal
vs guest-facing. Chiedimi i dati che non hai, non inventarli. Alla fine dimmi
quali righe rischiano di essere scartate dallo split-by-listing e perché.
Se il Notion non è ancora collegato, passami il box "Cosa dire allo studente"
già pronto (app.mattone.co -> Connessioni -> Collega Notion -> Autorizza) da
inoltrare allo studente.
```

<CardGroup cols={2}>
  <Card title="Connessioni (piattaforma)" icon="arrow-up-right-from-square" href="https://app.mattone.co/connessioni">Collega/verifica il Notion dello studente</Card>
  <Card title="Notion dello studente" icon="arrow-up-right-from-square">Apri il workspace e il DB "Strutture"/"Apartments"</Card>
</CardGroup>