---

បញ្ជីអ្នកប្រើប្រាស់

Blue ផ្តល់នូវការស្វែងរកជាច្រើនដើម្បីបញ្ជីអ្នកប្រើប្រាស់នៅក្នុងសម្រង់ផ្សេងៗ - នៅក្រុមហ៊ុនទាំងមូល, ជាក់លាក់គម្រោង, ឬការស្វែងរកអ្នកប្រើប្រាស់តែម្នាក់។ ការស្វែងរកទាំងនេះគាំទ្រការបែងចែកទំព័រ, ការកំណត់ត្រា, និងការតម្រៀបដើម្បីគ្រប់គ្រងមូលដ្ឋានអ្នកប្រើប្រាស់ធំៗបានយ៉ាងមានប្រសិទ្ធភាព។

ឧទាហរណ៍មូលដ្ឋាន - អ្នកប្រើប្រាស់ក្រុមហ៊ុន

បញ្ជីអ្នកប្រើប្រាស់ទាំងអស់នៅក្នុងក្រុមហ៊ុន៖

query ListCompanyUsers {
  companyUserList(companyId: "acme-corp") {
    users {
      id
      email
      fullName
      jobTitle
      lastActiveAt
    }
    pageInfo {
      totalItems
      hasNextPage
    }
  }
}

ឧទាហរណ៍កម្រិតខ្ពស់ - អ្នកប្រើប្រាស់គម្រោងដែលបានកំណត់ត្រា

បញ្ជីអ្នកប្រើប្រាស់គម្រោងជាមួយនឹងការស្វែងរក និងការបែងចែកទំព័រ៖

query ListProjectUsers {
  projectUserList(
    projectId: "web-redesign"
    search: "engineer"
    first: 20
    orderBy: lastActiveAt_DESC
  ) {
    edges {
      node {
        id
        email
        fullName
        accessLevel
        customRole {
          id
          name
        }
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

សំណើដែលអាចប្រើបាន

companyUserList

បញ្ជីអ្នកប្រើប្រាស់ទាំងអស់នៅក្នុងក្រុមហ៊ុនជាមួយនឹងការកំណត់ត្រាដែលជាជម្រើស។

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

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការទេ	ការពិពណ៌នា
companyId	String!	✅ បាទ	ID ឬ slug នៃក្រុមហ៊ុន
notInProjectId	String	ទេ	បដិសេធអ្នកប្រើប្រាស់ដែលមានរួចនៅក្នុងគម្រោងនេះ
search	String	ទេ	ស្វែងរកតាមឈ្មោះឬអ៊ីមែល
first	Int	ទេ	ចំនួនលទ្ធផលដែលត្រូវត្រឡប់ (ការបែងចែកទំព័រទៅមុខ)
after	String	ទេ	Cursor សម្រាប់ការបែងចែកទំព័រទៅមុខ
last	Int	ទេ	ចំនួនលទ្ធផលដែលត្រូវត្រឡប់ (ការបែងចែកទំព័រទៅក្រោយ)
before	String	ទេ	Cursor សម្រាប់ការបែងចែកទំព័រទៅក្រោយ
skip	Int	ទេ	ចំនួនលទ្ធផលដែលត្រូវរំលង
orderBy	UserOrderByInput	ទេ	ការតម្រៀបលំដាប់ (មើលខាងក្រោម)

projectUserList

បញ្ជីអ្នកប្រើប្រាស់ទាំងអស់នៅក្នុងគម្រោងជាក់លាក់។

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

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការទេ	ការពិពណ៌នា
projectId	String!	✅ បាទ	ID ឬ slug នៃគម្រោង
search	String	ទេ	ស្វែងរកតាមឈ្មោះឬអ៊ីមែល
first	Int	ទេ	ចំនួនលទ្ធផល (អតិបរិមា: 200)
after	String	ទេ	Cursor សម្រាប់ការបែងចែកទំព័រ
orderBy	UserOrderByInput	ទេ	ការតម្រៀបលំដាប់

user

ទាញយកអ្នកប្រើប្រាស់តែម្នាក់តាម ID។

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

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការទេ	ការពិពណ៌នា
id	String!	✅ បាទ	ID នៃអ្នកប្រើប្រាស់

ជម្រើសការតម្រៀប

UserOrderByInput តម្លៃ

តម្លៃ	ការពិពណ៌នា
createdAt_ASC	តម្រៀបតាមកាលបរិច្ឆេទចុះឈ្មោះ (ចាស់ជាងគេមុន)
createdAt_DESC	តម្រៀបតាមកាលបរិច្ឆេទចុះឈ្មោះ (ថ្មីជាងគេមុន)
lastActiveAt_ASC	តម្រៀបតាមសកម្មភាពចុងក្រោយ (ចាស់ជាងគេមុន)
lastActiveAt_DESC	តម្រៀបតាមសកម្មភាពចុងក្រោយ (ថ្មីជាងគេមុន)
firstName_ASC	តម្រៀបតាមឈ្មោះដំបូង (A-Z)
firstName_DESC	តម្រៀបតាមឈ្មោះដំបូង (Z-A)
lastName_ASC	តម្រៀបតាមឈ្មោះចុងក្រោយ (A-Z)
lastName_DESC	តម្រៀបតាមឈ្មោះចុងក្រោយ (Z-A)
email_ASC	តម្រៀបតាមអាសយដ្ឋានអ៊ីមែល (A-Z)
email_DESC	តម្រៀបតាមអាសយដ្ឋានអ៊ីមែល (Z-A)
username_ASC	តម្រៀបតាមឈ្មោះអ្នកប្រើប្រាស់ (A-Z)
username_DESC	តម្រៀបតាមឈ្មោះអ្នកប្រើប្រាស់ (Z-A)
jobTitle_ASC	តម្រៀបតាមចំណងជើងការងារ (A-Z)
jobTitle_DESC	តម្រៀបតាមចំណងជើងការងារ (Z-A)

វាលឆ្លើយតប

វត្ថុអ្នកប្រើប្រាស់

វាល	ប្រភេទ	ការពិពណ៌នា
id	String!	អត្តសញ្ញាណអ្នកប្រើប្រាស់ដ៏ឯកត្ត
uid	String!	Firebase authentication UID
username	String!	ឈ្មោះអ្នកប្រើប្រាស់ដែលបានជ្រើសរើស
email	String!	អាសយដ្ឋានអ៊ីមែល (មើលឃើញដោយ OWNER/ADMIN ប៉ុណ្ណោះ)
firstName	String	ឈ្មោះដំបូង
lastName	String	ឈ្មោះចុងក្រោយ
fullName	String	ឈ្មោះដំបូង និងឈ្មោះចុងក្រោយដែលបានរួមបញ្ចូល
jobTitle	String	ចំណងជើងវិជ្ជាជីវៈ
phoneNumber	String	លេខទំនាក់ទំនង
dateOfBirth	DateTime	ថ្ងៃខែឆ្នាំកំណើត
isEmailVerified	Boolean!	ស្ថានភាពការបញ្ជាក់អ៊ីមែល
lastActiveAt	DateTime	ម៉ោងសកម្មភាពចុងក្រោយ
createdAt	DateTime!	ថ្ងៃខែឆ្នាំបង្កើតគណនី
updatedAt	DateTime!	ការអាប់ដេតប្រវត្តិចុងក្រោយ
isOnline	Boolean!	ស្ថានភាពអនឡាញបច្ចុប្បន្ន
timezone	String	តំបន់ពេលវេលារបស់អ្នកប្រើប្រាស់
locale	String	ការជ្រើសរើសភាសា
theme	JSON	ការជ្រើសរើសប្រធានបទ UI
image	Image	វត្ថុរូបភាពប្រវត្តិ

វាលបន្ថែមអ្នកប្រើប្រាស់គម្រោង

នៅពេលបញ្ជីអ្នកប្រើប្រាស់គម្រោង, វាលបន្ថែមអាចមានស្រាប់៖

វាល	ប្រភេទ	ការពិពណ៌នា
accessLevel	UserAccessLevel!	តួនាទីរបស់អ្នកប្រើប្រាស់នៅក្នុងគម្រោង
customRole	ProjectUserRole	ព័ត៌មានតួនាទីកំណត់បើមាន
joinedAt	DateTime!	ពេលណាអ្នកប្រើប្រាស់បានចូលរួមក្នុងគម្រោង

ព័ត៌មានការបែងចែកទំព័រ

វាល	ប្រភេទ	ការពិពណ៌នា
totalItems	Int!	ចំនួនសរុបនៃអ្នកប្រើប្រាស់
totalPages	Int	ចំនួនទំព័រសរុប (សម្រាប់ការបែងចែកទំព័រ)
page	Int	លេខទំព័របច្ចុប្បន្ន
perPage	Int	វត្ថុក្នុងមួយទំព័រ
hasNextPage	Boolean!	លទ្ធផលបន្ថែមដែលអាចមាន
hasPreviousPage	Boolean!	លទ្ធផលមុននេះដែលអាចមាន
startCursor	String	Cursor សម្រាប់វត្ថុទីមួយ
endCursor	String	Cursor សម្រាប់វត្ថុទីចុង

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

សំណើ	អាជ្ញាប័ណ្ណដែលត្រូវការ
companyUserList	Any authenticated user in the company
projectUserList	Any project member (including VIEW_ONLY)
user	Any authenticated user

ការឆ្លើយតបកំហុស

ក្រុមហ៊ុនមិនឃើញ

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

គម្រោងមិនឃើញ

{
  "errors": [{
    "message": "Project not found",
    "extensions": {
      "code": "PROJECT_NOT_FOUND"
    }
  }]
}

ការចូលប្រើប្រាស់មិនមានសិទ្ធិ

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

កំណត់ចំណាំសំខាន់

• សមត្ថភាព: ប្រើការបែងចែកទំព័សម្រាប់បញ្ជីអ្នកប្រើប្រាស់ធំៗ (អតិបរិមា 200 អ្នកប្រើប្រាស់ក្នុងមួយសំណើ)
• ការស្វែងរក: ស្វែងរកតាមឈ្មោះដំបូង, ឈ្មោះចុងក្រោយ, និងវាលអ៊ីមែល
• ភាពឯកជនអ៊ីមែល: អាសយដ្ឋានអ៊ីមែលត្រូវបានមើលឃើញតែសម្រាប់អ្នកប្រើប្រាស់ដែលមានកម្រិតចូលប្រើ OWNER ឬ ADMIN ប៉ុណ្ណោះ
• ស្ថានភាពអនឡាញ: isOnline អាប់ដេតក្នុងពេលវេលាពិតប្រាកដតាមការតភ្ជាប់ WebSocket
• រូបភាពប្រវត្តិ: ប្រើវាល image.variants សម្រាប់ទំហំផ្សេងៗ
• ការកំណត់ត្រា: ប៉ារ៉ាម៉ែត្រ notInProjectId មានប្រយោជន៍នៅពេលកសាងចំណុចជ្រើសរើសអ្នកប្រើប្រាស់
• កម្រិតចូលប្រើ: បញ្ជីអ្នកប្រើប្រាស់គម្រោងរួមបញ្ចូលព័ត៌មានតួនាទីដែលមិនមាននៅក្នុងបញ្ជីក្រុមហ៊ុន

ប្រតិបត្តិការដែលពាក់ព័ន្ធ

• ទិដ្ឋភាពទាំងមូលនៃការគ្រប់គ្រងអ្នកប្រើប្រាស់ - ប្រតិបត្តិការគ្រប់គ្រងអ្នកប្រើប្រាស់
• លុបអ្នកប្រើប្រាស់ - លុបអ្នកប្រើប្រាស់ចេញពីគម្រោង
• តួនាទីកំណត់បន្ថែម - គ្រប់គ្រងសិទ្ធិអ្នកប្រើប្រាស់