import { Steps } from '@astrojs/starlight/components';
import Figure from '@components/Figure.astro';

**Per chi è:** un nuovo partner (Proprietario) che vuole rivendere Aymar Agents con la propria marca —
prima di questo percorso, la tua consolle funziona ma i tuoi clienti vedono la marca predefinita di
Aymar Agents invece della tua.

**Requisiti:** account partner attivo con ruolo **Proprietario** — Marca, Dominio, Piani e Team sono azioni
esclusive del Proprietario ([Primi passi](/docs/it/getting-started/)); un Membro può seguire il passo di
registrazione del cliente, ma non i passi di marca, dominio e piani.

## Cosa otterrai

Alla fine, i tuoi clienti entrano nella **loro** Piattaforma sotto il tuo dominio (o il dominio predefinito
mentre verifichi il tuo), con il tuo logo, i tuoi colori e la tua lingua predefinita — mai con il nome
«Aymar Agents» visibile. Avrai almeno un piano tuo, con il tuo prezzo, pronto da assegnare. E il tuo primo
cliente esiste già: il suo amministratore può entrare e iniziare a configurare il proprio agente.

## Passi nella consolle

<Steps>

1. **Entra nella tua consolle** con la tua email e password — è un'applicazione distinta dalla Piattaforma
   dei tuoi clienti, con un proprio login. Vedi **[Accesso e riepilogo](/docs/it/getting-started/)**.

2. **Personalizza la tua marca**, in **Marca**: scegli il **colore primario** e il **colore accento**,
   scrivi il **nome del tuo prodotto** (quello che vedranno i tuoi clienti al posto di «Aymar Agents»),
   la tua **lingua predefinita** e, se vuoi sostituire i documenti legali predefiniti della Piattaforma, i
   tuoi URL di **termini e condizioni** e **informativa privacy** — se li lasci vuoti, si usano quelli della
   Piattaforma. Carica le tue tre immagini: **logo per sfondo chiaro**, **logo per sfondo scuro** e
   **favicon**. Premi **Salva modifiche**.

   <Figure
     src="/captures/partner-marca-branding.png"
     alt="Pagina Marca con i selettori Colore primario e Colore accento in viola, il campo Nome del prodotto con «Horizonte Inmobiliaria Digital», il selettore Lingua predefinita ES, i campi URL termini e condizioni e URL informativa privacy vuoti con la nota «Se lo lasci vuoto si usano i documenti legali predefiniti della Piattaforma», l'avviso «Modifiche salvate», il pulsante Salva modifiche, e tre blocchi Logo sfondo chiaro, Logo sfondo scuro e Favicon ciascuno con pulsante Carica"
     caption="Colori, nome del prodotto, lingua e documenti legali — più i tre loghi che sostituiscono la marca della Piattaforma ovunque guardi il tuo cliente."
   />

3. **Registra il tuo dominio proprio**, nella stessa schermata Marca, sezione «Dominio proprio»: scrivi il
   dominio completo che vuoi usare (per esempio `app.tuaagenzia.com`). La consolle ti fornisce il **Name** e
   il **Value** del record CNAME che devi registrare presso il tuo fornitore di domini — fuori dalla
   Piattaforma. Il tuo dominio resta in stato **«In attesa di verifica»** finché il sistema non rileva il
   DNS (lo controlla automaticamente ogni 15 minuti; «Aggiorna stato» rilegge solo l'ultimo risultato, non
   forza un nuovo controllo).

   <Figure
     src="/captures/partner-marca-dominio-dns.png"
     alt="Sezione Dominio personalizzato con «app.partnerdemo.es» in stato In attesa di verifica, il testo «Non abbiamo ancora rilevato il record DNS, il sistema controlla automaticamente ogni 15 minuti, usa Aggiorna stato per vedere il risultato più recente a schermo», e sotto l'inizio della tabella «Configura questo record DNS»"
     caption="Finché il DNS non è verificato, i tuoi clienti continuano a entrare tramite l'URL predefinito della Piattaforma — non si rompe nulla."
   />

4. **Crea il tuo primo piano**, in **Piani**: premi **«Crea piano»** e compila il modulo guidato — nome,
   prezzo, valuta, istanze del nucleo (canali, agenti, flussi…) e le integrazioni incluse. L'editor stesso
   detrae ogni capacità dal **tuo plafond** con la Piattaforma in tempo reale, così non puoi mai creare un
   piano che superi ciò che hai disponibile. Vedi **[Il tuo catalogo di piani e
   IA](/docs/it/guides/planes-ia/)**.

   <Figure
     src="/captures/partner-planes-tabla.png"
     alt="Tabella Piani con una riga: Plan Esencial, plan-esencial, v1, 49 EUR, Attivo, 0 abbonati, con i pulsanti Nuova versione e Archivia"
     caption="Il tuo piano è pubblicato con il suo prezzo — pronto da assegnare a un cliente nel passo successivo."
   />

5. **Registra il tuo primo cliente**, in **Clienti**: premi **«Nuovo cliente»**, scrivi il nome
   dell'attività, l'email e la password iniziale del suo amministratore, scegli la lingua e, se applicabile,
   il settore. Vedi **[Clienti](/docs/it/guides/clientes/)**.

   <Figure
     src="/captures/partner-cliente-alta-relleno.png"
     alt="Modale Nuovo cliente compilato con Nome dell'attività «Inmobiliaria Prueba Partner», Slug «inmobiliaria-prueba-partner», Nome amministratore «Ana Prueba», Email «ana@partnerprueba.dev», Password iniziale, Lingua ES e Settore Immobiliare"
     caption="Lo stesso meccanismo di registrazione usato dalla registrazione self-service pubblica — solo che lo attivi tu, come partner."
   />

6. **Assegna il tuo piano al nuovo cliente**, dalla tabella Piani: premi **«Assegna»** sulla riga del piano,
   conferma il cliente di destinazione — il suo abbonamento cambia immediatamente.

</Steps>

## Cosa vede il tuo cliente

Il suo amministratore entra nella Piattaforma con la **tua** marca: il tuo logo, i tuoi colori e il nome
del tuo prodotto in ogni schermata, in ogni email che riceve e nel widget che installa sul proprio sito —
mai «Aymar Agents». Se hai già verificato il tuo dominio proprio, entra tramite il tuo URL; altrimenti,
continua a entrare tramite l'URL predefinito della Piattaforma senza che nulla si rompa. E se hai attivato
il portale di documentazione per la tua marca, la sua documentazione pubblica vive sotto il tuo
sottodominio docs, con la stessa personalizzazione.

## Cosa configurare

- **Marca**: colori, nome del prodotto, lingua predefinita, documenti legali (facoltativo) e i tre loghi.
- **Dominio proprio**: facoltativo ma consigliato — finché non è verificato, i tuoi clienti usano l'URL
  predefinito senza alcun problema.
- **Almeno un piano tuo**: con il tuo prezzo e le capacità che include, entro il tuo plafond.
- **Il primo cliente**: nome dell'attività, amministratore e, se applicabile, settore.

## Limiti e onestà

- Marca, Dominio, Piani e Team sono azioni esclusive del ruolo **Proprietario** — un Membro le vede, ma non
  può salvare modifiche.
- Lo stato **«Verificato»** del dominio conferma solo che il tuo DNS punta correttamente — è la base
  necessaria, ma l'hosting sotto il tuo dominio è un passo successivo; nel frattempo i tuoi clienti
  continuano a entrare tramite l'URL predefinito della Piattaforma.
- Ogni capacità di un nuovo piano viene detratta dal tuo **plafond** con la Piattaforma — non puoi offrire
  più di quanto il tuo fornitore ti ha assegnato. Vedi **[Il tuo catalogo di piani e
  IA](/docs/it/guides/planes-ia/)**, sezione «Il tuo plafond di capacità».
- Non esiste un pulsante di eliminazione massiva per la tua marca o il tuo dominio: ogni modifica si salva
  o si annulla una alla volta, dalla stessa schermata.

## Vedi anche

- **[Accesso e riepilogo](/docs/it/getting-started/)** — ruoli Proprietario/Membro e cosa vede ciascuno.
- **[Clienti](/docs/it/guides/clientes/)** — la procedura completa di registrazione, posti e piani
  personalizzati.
- **[Il tuo catalogo di piani e IA](/docs/it/guides/planes-ia/)** — prezzi, versioni, plafond di capacità.
- **[Marca, team, annunci e attività](/docs/it/guides/marca-equipo/)** — il resto di ciò che personalizza la
  tua consolle.