---

Overzicht

Projecten zijn de kernorganisatie-eenheid in Blue. Ze bevatten lijsten, taken, aangepaste velden, automatiseringen en alle andere werkgerelateerde gegevens. Projecten behoren tot bedrijven en hebben hun eigen machtigingssystemen, sjablonen en configuraties.

Beschikbare Operaties

Kernprojectoperaties

Operatie	Beschrijving	Link
Create Project	Maak een nieuw project of vanuit een sjabloon	View Details →
List Projects	Raadpleeg en filter projecten	View Details →
Delete Project	Verwijder een project permanent	View Details →
Archive Project	Archiveer/haal projecten uit archief	View Details →
Rename Project	Werk de projectnaam en slug bij	View Details →
Copy Project	Dupliceer een bestaand project	View Details →

Projectcomponenten

Component	Beschrijving	Link
Lists	Beheer takenlijsten binnen projecten	View Details →
Templates	Werk met project-sjablonen	View Details →
Activity	Volg projectactiviteit en wijzigingen	View Details →

Belangrijke Concepten

Projectstructuur

• Projecten behoren tot bedrijven
• Elk project kan meerdere lijsten hebben
• Lijsten bevatten taken
• Projecten ondersteunen aangepaste velden, tags en automatiseringen

Machtigingsmodel

Projecten hebben een meerlaags machtigingsysteem:

Niveau	Machtigingen
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

Projectcategorieën

Projecten kunnen worden gecategoriseerd voor betere organisatie:

• CRM
• CROSS_FUNCTIONAL
• CUSTOMER_SUCCESS
• ONTWERP
• ENGINEERING
• ALGEMEEN (standaard)
• HR
• IT
• MARKETING
• OPERATIES
• PERSOONLIJK
• INKOOP
• PRODUCT
• VERKOOP

Veelvoorkomende Patronen

Een Basisproject Aanmaken

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

Projecten Raadplegen met Filters

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
    }
  }
}

Opmerking: De projectList query is de aanbevolen aanpak voor het raadplegen van projecten. Een legacy projects query bestaat, maar moet niet worden gebruikt voor nieuwe implementaties.

Beheren van Projectlijsten

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

Beste Praktijken

1. Projectnaamgeving

   • Gebruik duidelijke, beschrijvende namen
   • Vermijd speciale tekens die slugs kunnen beïnvloeden
   • Houd namen onder de 50 tekens

2. Machtigingen Beheren

   • Begin met minimale machtigingen
   • Gebruik de CLIENT-rol voor externe belanghebbenden
   • Voer regelmatig audits uit op projecttoegang

3. Organisatie

   • Gebruik categorieën om vergelijkbare projecten te groeperen
   • Archiveer voltooide projecten in plaats van ze te verwijderen
   • Gebruik sjablonen voor repetitieve projecttypes

4. Prestaties

   • Gebruik paginering voor grote projectlijsten
   • Filter op actieve/gearchiveerde status
   • Beperk het aantal lijsten per project (maximaal 50)

Foutafhandeling

Veelvoorkomende fouten die je kunt tegenkomen:

Foutcode	Beschrijving	Oplossing
PROJECT_NOT_FOUND	Project bestaat niet of geen toegang	Verify project ID and permissions
COMPANY_NOT_FOUND	Bedrijf bestaat niet	Check company ID
FORBIDDEN	Onvoldoende machtigingen	Ensure proper role level
BAD_USER_INPUT	Validatiefout (bijv. naam te lang)	Check input validation requirements

Gerelateerde Bronnen

• Records API - Beheer taken/records binnen projecten
• Aangepaste Velden API - Aangepaste velden aan projecten toevoegen
• Automatiseringen API - Projectautomatiseringen instellen
• Gebruikers API - Beheer projectgebruikers en machtigingen