---

Översikt

Projekt är den centrala organisatoriska enheten i Blue. De innehåller listor, att-göra-punkter, anpassade fält, automatiseringar och all annan arbetsrelaterad data. Projekt tillhör företag och har sina egna behörighetssystem, mallar och konfigurationer.

Tillgängliga operationer

Kärnprojektoperationer

Operation	Beskrivning	Länk
Create Project	Skapa ett nytt projekt eller från mall	View Details →
List Projects	Fråga och filtrera projekt	View Details →
Delete Project	Permanently ta bort ett projekt	View Details →
Archive Project	Arkivera/återställ projekt	View Details →
Rename Project	Uppdatera projektnamn och slug	View Details →
Copy Project	Duplicera ett befintligt projekt	View Details →

Projektkomponenter

Komponent	Beskrivning	Länk
Lists	Hantera att-göra-listor inom projekt	View Details →
Templates	Arbeta med projektmallar	View Details →
Activity	Spåra projektaktivitet och förändringar	View Details →

Nyckelkoncept

Projektstruktur

• Projekt tillhör företag
• Varje projekt kan ha flera listor
• Listor innehåller att-göra-punkter
• Projekt stödjer anpassade fält, taggar och automatiseringar

Behörighetsmodell

Projekt har ett flernivåbehörighetssystem:

Nivå	Behörigheter
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

Projektkategorier

Projekt kan kategoriseras för bättre organisation:

• CRM
• TVÄRFUNKTIONELL
• KUNDFRAMGÅNG
• DESIGN
• INGENJÖRING
• ALLMÄN (standard)
• HR
• IT
• MARKNADSFÖRING
• OPERATIV
• PERSONLIG
• INKÖP
• PRODUKT
• FÖRSÄLJNING

Vanliga mönster

Skapa ett grundläggande projekt

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

Fråga projekt med filter

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

Notera: Den projectList frågan är den rekommenderade metoden för att fråga projekt. En gammal projects fråga finns men bör inte användas för nya implementationer.

Hantera projektlistor

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

Bästa praxis

1. Projektnamn

   • Använd tydliga, beskrivande namn
   • Undvik specialtecken som kan påverka slugs
   • Håll namn under 50 tecken

2. Behörighetsadministration

   • Börja med minimala behörigheter
   • Använd CLIENT-roll för externa intressenter
   • Genomför regelbundna granskningar av projektåtkomst

3. Organisation

   • Använd kategorier för att gruppera liknande projekt
   • Arkivera avslutade projekt istället för att ta bort dem
   • Använd mallar för repetitiva projekttyper

4. Prestanda

   • Använd paginering för stora projektlistor
   • Filtrera efter aktiv/arkiverad status
   • Begränsa antalet listor per projekt (max 50)

Felhantering

Vanliga fel du kan stöta på:

Felkod	Beskrivning	Lösning
PROJECT_NOT_FOUND	Projektet finns inte eller ingen åtkomst	Verify project ID and permissions
COMPANY_NOT_FOUND	Företaget finns inte	Check company ID
FORBIDDEN	Otillräckliga behörigheter	Ensure proper role level
BAD_USER_INPUT	Valideringsfel (t.ex. namn för långt)	Check input validation requirements

Relaterade resurser

• Records API - Hantera att-göra-punkter/registreringar inom projekt
• Custom Fields API - Lägga till anpassade fält till projekt
• Automations API - Ställa in projektautomatiseringar
• Users API - Hantera projektanvändare och behörigheter