---

Panoramica

I progetti sono l'unità organizzativa centrale in Blue. Contengono elenchi, attività, campi personalizzati, automazioni e tutti gli altri dati relativi al lavoro. I progetti appartengono alle aziende e hanno i propri sistemi di autorizzazione, modelli e configurazioni.

Operazioni Disponibili

Operazioni Principali sui Progetti

Operazione	Descrizione	Link
Create Project	Crea un nuovo progetto o da un modello	View Details →
List Projects	Interroga e filtra i progetti	View Details →
Delete Project	Elimina permanentemente un progetto	View Details →
Archive Project	Archivia/riattiva progetti	View Details →
Rename Project	Aggiorna il nome e lo slug del progetto	View Details →
Copy Project	Duplica un progetto esistente	View Details →

Componenti del Progetto

Componente	Descrizione	Link
Lists	Gestisci elenchi di attività all'interno dei progetti	View Details →
Templates	Lavora con modelli di progetto	View Details →
Activity	Monitora l'attività e le modifiche del progetto	View Details →

Concetti Chiave

Struttura del Progetto

• I progetti appartengono alle aziende
• Ogni progetto può avere più elenchi
• Gli elenchi contengono attività
• I progetti supportano campi personalizzati, tag e automazioni

Modello di Permessi

I progetti hanno un sistema di autorizzazione a più livelli:

Livello	Permessi
OWNER	Full control, can delete project
ADMIN	Manage project settings, users, and content
MEMBER	Create and edit content
CLIENT	Limited edit access
VIEW_ONLY	Read-only access
COMMENT_ONLY	Can only comment

Categorie di Progetto

I progetti possono essere categorizzati per una migliore organizzazione:

• CRM
• CROSS_FUNCTIONAL
• CUSTOMER_SUCCESS
• DESIGN
• ENGINEERING
• GENERALE (predefinito)
• HR
• IT
• MARKETING
• OPERAZIONI
• PERSONALE
• APPROVVIGIONAMENTO
• PRODOTTO
• VENDITE

Modelli Comuni

Creazione di un Progetto di Base

mutation CreateProject {
  createProject(input: {
    name: "Q1 Marketing Campaign"
    companyId: "company-123"
    category: MARKETING
  }) {
    id
    name
    slug
  }
}

Interrogazione dei Progetti con Filtri

query GetProjects {
  projectList(
    filter: {
      companyIds: ["company-123"]
      isArchived: false
      categories: [MARKETING, SALES]
    }
    sort: [{ field: updatedAt, direction: DESC }]
    take: 20
  ) {
    items {
      id
      name
      category
      todosCount
      todosDoneCount
    }
    pageInfo {
      hasNextPage
      total
    }
  }
}

Nota: La query projectList è l'approccio raccomandato per interrogare i progetti. Esiste una query legacy projects ma non dovrebbe essere utilizzata per nuove implementazioni.

Gestione degli Elenchi di Progetto

# Get all lists in a project
query GetProjectLists {
  todoLists(projectId: "project-123") {
    id
    title
    position
    todosCount
  }
}

# Create a new list
mutation CreateList {
  createTodoList(input: {
    projectId: "project-123"
    title: "To Do"
    position: 1.0
  }) {
    id
    title
  }
}

Migliori Pratiche

1. Nominare i Progetti

   • Usa nomi chiari e descrittivi
   • Evita caratteri speciali che potrebbero influenzare gli slug
   • Mantieni i nomi sotto i 50 caratteri

2. Gestione dei Permessi

   • Inizia con permessi minimi
   • Usa il ruolo CLIENT per le parti interessate esterne
   • Esegui regolarmente audit dell'accesso ai progetti

3. Organizzazione

   • Usa categorie per raggruppare progetti simili
   • Archivia i progetti completati invece di eliminarli
   • Usa modelli per tipi di progetto ripetitivi

4. Prestazioni

   • Usa la paginazione per elenchi di progetti di grandi dimensioni
   • Filtra per stato attivo/archiviato
   • Limita il numero di elenchi per progetto (max 50)

Gestione degli Errori

Errori comuni che potresti incontrare:

Codice Errore	Descrizione	Soluzione
PROJECT_NOT_FOUND	Il progetto non esiste o non hai accesso	Verify project ID and permissions
COMPANY_NOT_FOUND	L'azienda non esiste	Check company ID
FORBIDDEN	Permessi insufficienti	Ensure proper role level
BAD_USER_INPUT	Errore di validazione (ad es., nome troppo lungo)	Check input validation requirements

Risorse Correlate

• API dei Record - Gestione delle attività/record all'interno dei progetti
• API dei Campi Personalizzati - Aggiunta di campi personalizzati ai progetti
• API delle Automazioni - Configurazione delle automazioni di progetto
• API degli Utenti - Gestione degli utenti e dei permessi del progetto