---

Panoramica dei Modelli

Blue supporta due tipi di modelli:

• Modelli Aziendali: Creati dalla tua organizzazione per uso interno
• Modelli Ufficiali: Creati da Blue per tutti gli utenti (modelli standard di settore)

I modelli preservano l'intera struttura del progetto, inclusi todo, elenchi, campi personalizzati, automazioni e altro ancora.

Modelli di Elenco

Utilizzo della Query dei modelli

query GetTemplates {
  templates(
    companyId: "company-123"
    isOfficialTemplate: false
    category: MARKETING
  ) {
    id
    name
    description
    category
    isOfficialTemplate
    icon
    color
    image {
      thumbnail
      small
    }
  }
}

Utilizzo di projectList con Filtro Modello

query ListTemplates {
  projectList(
    filter: {
      companyIds: ["company-id"]
      isTemplate: true
    }
    sort: [updatedAt_DESC]
    take: 20
    skip: 0
  ) {
    items {
      id
      slug
      name
      description
      category
      isTemplate
      isOfficialTemplate
      color
      icon
      createdAt
      updatedAt
    }
    pageInfo {
      hasNextPage
      totalItems
    }
    totalCount
  }
}

Crea Progetto da Modello

Per creare un nuovo progetto da un modello esistente:

mutation CreateFromTemplate {
  createProject(
    input: {
      templateId: "template-id-or-slug"
      name: "Q1 Marketing Campaign"
      companyId: "company-id"
      description: "Marketing initiatives for Q1"
      color: "#10B981"
    }
  ) {
    id
    name
    slug
  }
}

Converti Progetto in Modello

Trasforma un progetto esistente in un modello riutilizzabile:

mutation ConvertToTemplate {
  convertProjectToTemplate(
    input: {
      projectId: "project-123"
      isOfficialTemplate: false
    }
  ) {
    id
    name
    isTemplate
    isOfficialTemplate
  }
}

Rimuovi Stato Modello

Converti un modello di nuovo in un progetto normale:

mutation RemoveTemplateStatus {
  removeProjectFromTemplates(projectId: "template-123") {
    id
    name
    isTemplate
  }
}

Ottieni Modello Singolo

Recupera dettagli su un modello specifico:

query GetTemplate {
  template(templateId: "template-123") {
    id
    name
    description
    category
    isOfficialTemplate
    todoLists {
      name
      todos {
        title
      }
    }
  }
}

Parametri della Query

Query dei modelli

Parametro	Tipo	Richiesto	Descrizione
companyId	String	No	Filtra i modelli per azienda. Ometti per vedere i modelli ufficiali.
isOfficialTemplate	Boolean	No	Mostra solo i modelli ufficiali di Blue
category	ProjectCategory	No	Filtra per categoria di progetto

Input convertProjectToTemplate

Parametro	Tipo	Richiesto	Descrizione
projectId	String!	✅ Sì	Il progetto da convertire in un modello
isOfficialTemplate	Boolean!	✅ Sì	Contrassegna come modello ufficiale (solo per dipendenti Blue)

Categorie di Modelli

Valore	Descrizione
CRM	Gestione delle Relazioni con i Clienti
CROSS_FUNCTIONAL	Progetti di team interfunzionali
CUSTOMER_SUCCESS	Iniziative di successo del cliente
DESIGN	Progetti di design e creativi
ENGINEERING	Ingegneria e sviluppo
GENERAL	Progetti generali (predefiniti)
HR	Risorse Umane
IT	Tecnologia dell'Informazione
MARKETING	Campagne di marketing
OPERATIONS	Operazioni e logistica
PRODUCT	Gestione del prodotto
SALES	Vendite e sviluppo commerciale

Cosa Viene Copiato dai Modelli

Quando si crea un progetto da un modello, viene copiato quanto segue:

• ✅ Struttura: Tutti gli elenchi di todo e i todo con le loro posizioni
• ✅ Contenuto: Descrizioni, commenti e allegati
• ✅ Organizzazione: Tag, etichette e campi personalizzati
• ✅ Automazione: Tutte le regole e i flussi di lavoro di automazione
• ✅ Moduli: Moduli di progetto e le loro configurazioni
• ✅ Documenti: Pagine wiki e documentazione
• ✅ Impostazioni: Configurazioni di copertura e preferenze di visualizzazione
• ✅ Ruoli: Definizioni dei ruoli utente (ma non le assegnazioni utente)

Non copiato:

• ❌ Assegnazioni utente (eccetto il creatore)
• ❌ Cronologia delle attività
• ❌ Dati di tracciamento del tempo
• ❌ Stato completato dei todo

Permessi Richiesti

Creazione di Modelli

Azione	Ruolo Richiesto
Convert project to template	Project OWNER or ADMIN
Create official template	Blue employee only
Remove template status	Project OWNER or ADMIN

Utilizzo dei Modelli

Tipo di Modello	Chi Può Usare
Company templates	Users in the same company
Official templates	All Blue users

Risposte di Errore

Modello Non Trovato

{
  "errors": [{
    "message": "Template not found",
    "extensions": {
      "code": "TEMPLATE_NOT_FOUND"
    }
  }]
}

Troppi Todo

{
  "errors": [{
    "message": "This project has more than 250,000 todos and cannot be used as a template",
    "extensions": {
      "code": "TOO_MANY_TODOS"
    }
  }]
}

Note Importanti

• Limite di Dimensione: I progetti con più di 250.000 todo non possono essere utilizzati come modelli
• Copia Asincrona: Il contenuto del modello viene copiato in background tramite la coda di lavoro
• Stato Archivio: Convertire in modello disarchivia automaticamente il progetto
• Rimozione della Cartella: I modelli vengono rimossi dalle cartelle quando convertiti
• Controllo Accessi: I modelli ufficiali sono visibili a tutti, i modelli aziendali solo ai membri
• Aggiornamenti in Tempo Reale: Iscriviti ai cambiamenti del modello utilizzando la sottoscrizione subscribeToProject