## 1. Cos'è la console del partner La **console del partner** è una terza applicazione, distinta dalla Piattaforma delle agenzie clienti e dal pannello interno dello staff: vive in `/partner/*` dentro la stessa app Admin (in locale, `localhost:3001/partner/login`) ma con un proprio login e una propria identità visiva. È il pannello di un **partner a marchio bianco**: un'azienda che rivende la Piattaforma ai propri clienti sotto il proprio marchio, gestisce il proprio portafoglio di tenant, incassa dai propri clienti (oppure paga una quota di plazas alla Piattaforma) e personalizza l'aspetto che vedono quei clienti. La barra laterale della console riunisce le sue sezioni in quest'ordine: **Riepilogo** (questo manuale), **Clienti** (Manuale 38), **Wallet** e **Fatturazione** (Manuale 39), **Marchio**, **Referral**, **Team** e **Attività** (Manuale 41), **Piani** — il tuo catalogo proprio di piani, inclusi quelli personalizzati (Manuale 40, paragrafo 1, e Manuale 38, paragrafo 5) — e **IA** (Manuale 40), **Annunci** (Manuale 41) e **Supporto** (Manuale 42). «Il mio account», con la verifica in due passaggi, si apre dal menu del tuo profilo in alto a destra (Manuale 42). > **Nota — «Referral» potrebbe non comparire nel tuo menu** > > Se il tuo account è in modalità **Marchio bianco** e non ha mai avuto alcun referral (nemmeno una > commissione, nemmeno di uno già disiscritto), il menu non mostra «Referral» — non si applica al tuo modo > di lavorare, quindi non occupa spazio. Non appena avrai il primo referral con attività, ricompare da > solo. Se il tuo account è in modalità **Referral**, «Referral» si mostra sempre, qualunque sia la tua > attività — è il centro della tua console (Manuale 54 «Referral: come funziona il denaro»). ## Ruoli all'interno della console: Proprietario e Membro Ogni account della console del partner ha uno di questi due ruoli: | Ruolo | Ambito | | --- | --- | | Proprietario | Accesso completo alla console: tutto ciò che ha il Membro, più le azioni finanziarie o a livello dell'intera organizzazione — ricaricare il Wallet, la tua quota di plazas e l'incasso manuale (Manuale 39), creare/versionare piani propri e gestire credenziali BYOK/attivare modelli in IA (Manuale 40), Marchio e Dominio proprio, Annunci a tutti i tuoi tenant, e Team (invitare e disattivare utenti, Manuale 41). | | Membro | Account invitato da un Proprietario, con accesso alla stessa console ma in **sola lettura** sulle azioni sopra. PUÒ compiere, alla pari del Proprietario, le azioni operative quotidiane: registrare un nuovo tenant, entrare nel pannello di un cliente (impersonare), collegare il proprio WhatsApp e gestire i ticket di supporto — nessuna di queste è esclusiva del Proprietario. | > **Nota — Wallet, Fatturazione, Piani, IA, Marchio, Dominio, Annunci e Team sono del Proprietario** > > Sono le azioni finanziarie o che riguardano tutto il tuo account partner in una volta — il permesso > reale (`partner:wallet.manage`, `partner:billing.manage`, `partner:plans.manage`, > `partner:credentials.manage`, `partner:branding.manage`, `partner:domain.manage`, > `partner:announcements.manage`, `partner:users.manage`) lo ha solo il ruolo Proprietario; un Membro vede > quelle schermate, ma i suoi pulsanti di scrittura sono nascosti o l'azione viene respinta se forzata. > Come nel resto della piattaforma, il backend è la fonte di verità dei permessi. ## 2. Procedura: accedere **Requisiti:** account partner attivo (Proprietario o Membro). 1. Apri `/partner/login`. La schermata è divisa in due: a sinistra, un pannello scuro con il messaggio «La tua console partner gestisce i tuoi clienti» e tre punti («Registrazione tenant in pochi minuti», «Monitoraggio commissioni e saldo», «Accesso esclusivo per partner»); a destra, il modulo «Accedi (Partner)». 2. Scrivi la tua **Email** e **Password**. 3. (Facoltativo) Seleziona **«Mantieni sessione attiva»**. 4. Premi **Accedi**. **Risultato:** entri nel **Riepilogo** della tua console. Se il tuo account ha attiva la verifica in due passaggi (Manuale 42), ti viene chiesto prima un codice a 6 cifre dalla tua app di autenticazione prima di completare l'accesso. ## 3. Il Riepilogo, a colpo d'occhio È la schermata iniziale dopo il login. Mostra tre card: - **Tenant**: numero di clienti nel tuo portafoglio. - **Modalità**: la tua modalità partner (per esempio, «Marchio bianco»). - **Saldo Wallet**: il saldo attuale del tuo wallet di credito (Manuale 39). Sotto le card, due chip di stato: **Stato** del tuo account partner («Attivo»…) e **Stripe Connect** — lo stato del tuo collegamento con Stripe per incassare direttamente dai tuoi clienti (Manuale 39, «Incassi dai clienti»): **«In corso»** finché non hai completato la procedura guidata di Stripe, e un altro valore una volta completata. > **Avviso — Da dove proseguire** > > Per registrare il tuo primo cliente e capire le plazas, vai al Manuale 38 · Clienti. Per scegliere il > tuo piano di plazas e attivare gli incassi dai tuoi clienti, Manuale 39 · Wallet e Fatturazione. ## 4. La tua valuta di contratto: euro o dollari, fissata alla registrazione Il tuo account partner ha un contratto con la Piattaforma denominato in **un'unica valuta** — euro (€) o dollari statunitensi (US$) — decisa dal team della Piattaforma al momento della tua registrazione come partner. Non è un'impostazione che puoi cambiare tu stesso: oggi non esiste alcuna schermata «cambia valuta» né alcun selettore nella tua console. Se in qualche momento hai bisogno di cambiarla, è una decisione contrattuale — parlane con il tuo account manager. Quella è la valuta che vedrai in **tutti gli importi che sono tuoi**: il Saldo Wallet di questo Riepilogo, la tua quota di plazas e le tue ricariche (Manuale 39), e i prezzi di rivendita e il margine della tua IA (Manuale 40) usano sempre la stessa — non vedrai mai un mix di € e US$ dentro quelle schermate. Non c'è nessuna card che dica letteralmente «Valuta: EUR» o «Valuta: USD»: la riconosci dal simbolo che accompagna ogni importo. > **Avviso — Le tue commissioni Referral sono l'unica eccezione** > > A differenza di tutto il resto, un importo di **Referral** (Manuale 41, paragrafo 4) non è garantito che > usi la tua stessa valuta di contratto: ogni commissione è denominata nella valuta reale del contratto del > **cliente referenziato**, non nella tua. In pratica coincide quasi sempre (la registrazione self-service > di un referral parte sempre in euro), ma se un giorno vedi una commissione in una valuta diversa da > quella del tuo wallet, non è un errore — il motivo è spiegato nel Manuale 54 «Referral: come funziona il > denaro», paragrafo 5. > **Nota** > > La maggior parte dei partner lavora in euro; alcuni partner internazionali operano in dollari. È la > stessa console con lo stesso funzionamento in entrambi i casi — cambia solo il simbolo degli importi.