---

បង្កើតផ្ទាំងគ្រប់គ្រង

ការបម្លែង createDashboard អនុញ្ញាតឱ្យអ្នកបង្កើតផ្ទាំងគ្រប់គ្រងថ្មីមួយនៅក្នុងក្រុមហ៊ុនឬគម្រោងរបស់អ្នក។ ផ្ទាំងគ្រប់គ្រងគឺជាឧបករណ៍បង្ហាញដ៏មានអំណាចដែលជួយក្រុមតាមដានមាតិកា, ត្រួតពិនិត្យការរីកចម្រើន, និងធ្វើការសម្រេចចិត្តដោយផ្អែកលើទិន្នន័យ។

ឧទាហរណ៍មូលដ្ឋាន

mutation CreateDashboard {
  createDashboard(
    input: {
      companyId: "comp_abc123"
      title: "Sales Performance Dashboard"
    }
  ) {
    id
    title
    createdBy {
      id
      email
      firstName
      lastName
    }
    createdAt
  }
}

ផ្ទាំងគ្រប់គ្រងដែលពាក់ព័ន្ធនឹងគម្រោង

បង្កើតផ្ទាំងគ្រប់គ្រងដែលទាក់ទងនឹងគម្រោងជាក់លាក់មួយ:

mutation CreateProjectDashboard {
  createDashboard(
    input: {
      companyId: "comp_abc123"
      projectId: "proj_xyz789"
      title: "Q4 Project Metrics"
    }
  ) {
    id
    title
    project {
      id
      name
    }
    createdBy {
      id
      email
    }
    dashboardUsers {
      id
      user {
        id
        email
      }
      role
    }
    createdAt
  }
}

ប៉ារ៉ាម៉ែត្រ Input

CreateDashboardInput

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការ	ការពិពណ៌នា
companyId	String!	✅ បាទ	អត្តសញ្ញាណ ID របស់ក្រុមហ៊ុនដែលផ្ទាំងគ្រប់គ្រងនឹងត្រូវបានបង្កើត
title	String!	✅ បាទ	ឈ្មោះរបស់ផ្ទាំងគ្រប់គ្រង។ ត្រូវតែជាអក្សរមិនទំនេរ
projectId	String	មិនត្រូវការ	អត្តសញ្ញាណ ID ជាជម្រើសនៃគម្រោងដែលត្រូវភ្ជាប់ជាមួយផ្ទាំងគ្រប់គ្រងនេះ

វាលចម្លើយ

ការបម្លែងនឹងត្រឡប់មកវិញវត្ថុ Dashboard ពេញលេញ:

វាល	ប្រភេទ	ការពិពណ៌នា
id	String!	អត្តសញ្ញាណឯកតាសម្រាប់ផ្ទាំងគ្រប់គ្រងដែលបានបង្កើត
title	String!	ចំណងជើងផ្ទាំងគ្រប់គ្រងដូចដែលបានផ្តល់
companyId	String!	ក្រុមហ៊ុនដែលផ្ទាំងគ្រប់គ្រងនេះជាប់ពាក់ព័ន្ធ
projectId	String	អត្តសញ្ញាណគម្រោងដែលជាប់ពាក់ព័ន្ធ (ប្រសិនបើបានផ្តល់)
project	Project	វត្ថុគម្រោងដែលជាប់ពាក់ព័ន្ធ (ប្រសិនបើ projectId ត្រូវបានផ្តល់)
createdBy	User!	អ្នកប្រើដែលបានបង្កើតផ្ទាំងគ្រប់គ្រង (អ្នក)
dashboardUsers	[DashboardUser!]!	បញ្ជីអ្នកប្រើដែលមានការចូលប្រើ (ដំបូងគេគ្រាន់តែជាអ្នកបង្កើត)
createdAt	DateTime!	ម៉ោងដែលផ្ទាំងគ្រប់គ្រងត្រូវបានបង្កើត
updatedAt	DateTime!	ម៉ោងនៃការកែប្រែចុងក្រោយ (ដូចគ្នានឹង createdAt សម្រាប់ផ្ទាំងគ្រប់គ្រងថ្មី)

វាល DashboardUser

នៅពេលដែលផ្ទាំងគ្រប់គ្រងត្រូវបានបង្កើត អ្នកបង្កើតនឹងត្រូវបានបន្ថែមដោយស្វ័យប្រវត្តិជាអ្នកប្រើផ្ទាំងគ្រប់គ្រង:

វាល	ប្រភេទ	ការពិពណ៌នា
id	String!	អត្តសញ្ញាណឯកតាសម្រាប់ទំនាក់ទំនងអ្នកប្រើផ្ទាំងគ្រប់គ្រង
user	User!	វត្ថុអ្នកប្រើដែលមានការចូលប្រើផ្ទាំងគ្រប់គ្រង
role	DashboardRole!	តួនាទីរបស់អ្នកប្រើ (អ្នកបង្កើតទទួលបានការចូលប្រើពេញលេញ)
dashboard	Dashboard!	យោងត្រឡប់ទៅផ្ទាំងគ្រប់គ្រង

អាជ្ញាប័ណ្ណដែលត្រូវការ

អ្នកប្រើដែលបានអះអាងណាមួយដែលជាសមាជិកនៃក្រុមហ៊ុនដែលបានកំណត់អាចបង្កើតផ្ទាំងគ្រប់គ្រង។ មិនមានតម្រូវការតួនាទីពិសេសណាមួយទេ។

ស្ថានភាពអ្នកប្រើ	អាចបង្កើតផ្ទាំងគ្រប់គ្រង
Company Member	✅ បាទ
សមាជិកមិនមែនក្រុមហ៊ុន	❌ ទេ
Unauthenticated	❌ ទេ

ចម្លើយកំហុស

ក្រុមហ៊ុនមិនត្រឹមត្រូវ

{
  "errors": [{
    "message": "Company not found",
    "extensions": {
      "code": "NOT_FOUND"
    }
  }]
}

អ្នកប្រើមិននៅក្នុងក្រុមហ៊ុន

{
  "errors": [{
    "message": "You don't have access to this company",
    "extensions": {
      "code": "FORBIDDEN"
    }
  }]
}

គម្រោងមិនត្រឹមត្រូវ

{
  "errors": [{
    "message": "Project not found or doesn't belong to the specified company",
    "extensions": {
      "code": "NOT_FOUND"
    }
  }]
}

ចំណងជើងទទេ

{
  "errors": [{
    "message": "Dashboard title cannot be empty",
    "extensions": {
      "code": "VALIDATION_ERROR"
    }
  }]
}

កំណត់សំខាន់

• ការកាន់កាប់ដោយស្វ័យប្រវត្តិ: អ្នកដែលបង្កើតផ្ទាំងគ្រប់គ្រងនឹងក្លាយជាម្ចាស់ដោយស្វ័យប្រវត្តិជាមួយនឹងអាជ្ញាប័ណ្ណពេញលេញ
• ការភ្ជាប់គម្រោង: ប្រសិនបើអ្នកផ្តល់ projectId វាត្រូវតែជាសមាជិកនៃក្រុមហ៊ុនដដែល
• អាជ្ញាប័ណ្ណដំបូង: មានតែអ្នកបង្កើតដែលមានការចូលប្រើដំបូង។ ប្រើ editDashboard ដើម្បីបន្ថែមអ្នកប្រើបន្ថែម
• តម្រូវការចំណងជើង: ចំណងជើងផ្ទាំងគ្រប់គ្រងត្រូវតែជាអក្សរមិនទំនេរ។ មិនមានតម្រូវការពិសេសសម្រាប់ភាពច្បាស់លាស់
• សមាជិកក្រុមហ៊ុន: អ្នកត្រូវតែជាសមាជិកនៃក្រុមហ៊ុនដើម្បីបង្កើតផ្ទាំងគ្រប់គ្រងនៅក្នុងវា

ដំណើរការបង្កើតផ្ទាំងគ្រប់គ្រង

1. បង្កើតផ្ទាំងគ្រប់គ្រង ដោយប្រើការបម្លែងនេះ
2. កំណត់តារាង និងវីជេត ដោយប្រើ UI សម្រាប់បង្កើតផ្ទាំងគ្រប់គ្រង
3. បន្ថែមសមាជិកក្រុម ដោយប្រើការបម្លែង editDashboard ជាមួយ dashboardUsers
4. កំណត់តម្រង និងជួរថ្ងៃ តាមរយៈចំណុចប្រទាក់ផ្ទាំងគ្រប់គ្រង
5. ចែករំលែកឬបញ្ចូល ផ្ទាំងគ្រប់គ្រងដោយប្រើអត្តសញ្ញាណឯកតារបស់វា

ករណីប្រើប្រាស់

1. ផ្ទាំងគ្រប់គ្រងអគ្គិសនី: បង្កើតទិដ្ឋភាពទូលំទូលាយនៃមាតិកាក្រុមហ៊ុន
2. ការតាមដានគម្រោង: បង្កើតផ្ទាំងគ្រប់គ្រងដែលពាក់ព័ន្ធនឹងគម្រោងដើម្បីត្រួតពិនិត្យការរីកចម្រើន
3. កម្រិតសមត្ថភាពក្រុម: តាមដានផលិតភាពក្រុម និងមាតិកាដែលទទួលបាន
4. ការប្រកាសអតិថិជន: បង្កើតផ្ទាំងគ្រប់គ្រងសម្រាប់ការប្រកាសមុខមាត់អតិថិជន
5. ការត្រួតពិនិត្យពេលវេលាពិត: កំណត់ផ្ទាំងគ្រប់គ្រងសម្រាប់ទិន្នន័យប្រតិបត្តិការពេលវេលាពិត

អនុសាសន៍ល្អ

1. ការកំណត់ឈ្មោះ: ប្រើចំណងជើងដែលច្បាស់ និងពិពណ៌នាដែលបង្ហាញពីគោលបំណងរបស់ផ្ទាំងគ្រប់គ្រង
2. ការភ្ជាប់គម្រោង: ភ្ជាប់ផ្ទាំងគ្រប់គ្រងទៅនឹងគម្រោងនៅពេលដែលវាជាផ្ទាំងគ្រប់គ្រងដែលពាក់ព័ន្ធនឹងគម្រោង
3. ការគ្រប់គ្រងការចូលប្រើ: បន្ថែមសមាជិកក្រុមភ្លាមៗបន្ទាប់ពីការបង្កើតសម្រាប់ការសហការណ៍
4. ការរៀបចំ: បង្កើតស៊ុមផ្ទាំងគ្រប់គ្រងដោយប្រើលំនាំឈ្មោះដែលស្របគ្នា

ប្រតិបត្តិការទាក់ទង

• បញ្ជីផ្ទាំងគ្រប់គ្រង - ទាញយកផ្ទាំងគ្រប់គ្រងទាំងអស់សម្រាប់ក្រុមហ៊ុនឬគម្រោង
• កែប្រែផ្ទាំងគ្រប់គ្រង - ប្តូរឈ្មោះផ្ទាំងគ្រប់គ្រងឬគ្រប់គ្រងអ្នកប្រើ
• ចម្លងផ្ទាំងគ្រប់គ្រង - បង្កើតចម្លងផ្ទាំងគ្រប់គ្រងដែលមានស្រាប់
• លុបផ្ទាំងគ្រប់គ្រង - លុបផ្ទាំងគ្រប់គ្រង