feat(api): implement GetUsers method for WorkspaceService (#149)

* feat(api): implement GetUsers method for WorkspaceService

- Add GetUsers method to WorkspaceService for retrieving project members- Create GetUsersRequest struct for method parameters
- Define User struct to represent user information
- Update features.md to mark GetUsers as implemented
- Add unit tests for GetUsers method
- Include sample response data for GetUsers in testdata

Signed-off-by: Flc <[email protected]>

* refactor(api_workspace): add Tapd API reference for GetUsers function

- Add API reference comment for GetUsers function in WorkspaceService
- Improve code documentation and readability

Signed-off-by: Flc <[email protected]>

---------

Signed-off-by: Flc <[email protected]>

Author: flc1125

api_workspace.go

@@ -11,7 +11,51 @@ type WorkspaceService struct {
 
 // 获取子项目信息
 // 获取项目信息
-// 获取指定项目成员
+
+// GetUsers 获取指定项目成员
+//
+// https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/workspace/users.html
+func (s *WorkspaceService) GetUsers(
+	ctx context.Context, request *GetUsersRequest, opts ...RequestOption,
+) ([]*User, *Response, error) {
+	req, err := s.client.NewRequest(ctx, http.MethodGet, "workspaces/users", request, opts)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	var items []struct {
+		UserWorkspace *User `json:"UserWorkspace"`
+	}
+	resp, err := s.client.Do(req, &items)
+	if err != nil {
+		return nil, resp, err
+	}
+
+	users := make([]*User, 0, len(items))
+	for _, item := range items {
+		users = append(users, item.UserWorkspace)
+	}
+
+	return users, resp, nil
+}
+
+type GetUsersRequest struct {
+	WorkspaceID *int           `url:"workspace_id,omitempty"` // [必须]项目ID
+	User        *Multi[string] `url:"user,omitempty"`         // [可选]用户昵称或ID
+	Fields      *Multi[string] `url:"fields,omitempty"`       // [可选]返回的字段列表，user,user_id,role_id,name,email,real_join_time 可选，以,分隔
+}
+
+type User struct {
+	User             string   `json:"user"`
+	RoleID           []string `json:"role_id"`
+	Name             string   `json:"name"`
+	JoinProjectTime  *string  `json:"join_project_time"`
+	RealJoinTime     string   `json:"real_join_time"`
+	Status           string   `json:"status"`
+	Allocation       string   `json:"allocation"`
+	LeaveProjectTime *string  `json:"leave_project_time"`
+}
+
 // 添加项目成员
 // 获取公司项目列表
 // 获取用户组ID对照关系

api_workspace_test.go

@@ -0,0 +1,50 @@
+package tapd
+
+import (
+	"net/http"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestWorkspaceService_GetUsers(t *testing.T) {
+	_, client := createServerClient(t, http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		assert.Equal(t, http.MethodGet, r.Method)
+		assert.Equal(t, "/workspaces/users", r.URL.Path)
+
+		assert.Equal(t, "11112222", r.URL.Query().Get("workspace_id"))
+		assert.Equal(t, "张三,李四", r.URL.Query().Get("user"))
+		assert.Equal(t, "id,name", r.URL.Query().Get("fields"))
+
+		_, _ = w.Write(loadData(t, "internal/testdata/api/workspace/users.json"))
+	}))
+
+	users, _, err := client.WorkspaceService.GetUsers(ctx, &GetUsersRequest{
+		WorkspaceID: Ptr(11112222),
+		User:        NewMulti("张三", "李四"),
+		Fields:      NewMulti("id", "name"),
+	})
+	require.NoError(t, err)
+	assert.Len(t, users, 2)
+	assert.Contains(t, users, &User{
+		User:             "张三",
+		RoleID:           []string{"11111122222001000029"},
+		Name:             "张三",
+		JoinProjectTime:  nil,
+		RealJoinTime:     "2018-07-03",
+		Status:           "2",
+		Allocation:       "100",
+		LeaveProjectTime: nil,
+	})
+	assert.Contains(t, users, &User{
+		User:             "李四",
+		RoleID:           []string{"11111122222001000028", "11111122222001000143"},
+		Name:             "李四",
+		JoinProjectTime:  nil,
+		RealJoinTime:     "2018-07-09",
+		Status:           "1",
+		Allocation:       "100",
+		LeaveProjectTime: nil,
+	})
+}

features.md

@@ -217,7 +217,7 @@ API 文档：https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/
 
 - [ ] 获取子项目信息
 - [ ] 获取项目信息
-- [ ] 获取指定项目成员
+- [x] 获取指定项目成员
 - [ ] 添加项目成员
 - [ ] 获取公司项目列表
 - [ ] 获取用户组ID对照关系
@@ -228,6 +228,12 @@ API 文档：https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/
 - [ ] 获取项目文档
 - [x] 获取成员活动日志 —— ⚠️ 因无权限，暂未测试过，请谨慎使用
 
+### 项目集
+
+- [ ] 根据视图id获取项目集视图工作项列表
+- [ ] 项目集批量关联/取消关联、修改授权范围项目
+- [ ] 项目集批量关联/取消关联业务对象
+
 ### 工作流
 
 - [ ] 获取工作流流转细则
@@ -236,6 +242,7 @@ API 文档：https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/
 - [ ] 获取工作流状态中英文名对应关系
 - [ ] 获取工作流起始状态
 - [ ] 获取项目下的工作流列表
+- [ ] 获取并行工作节点和状态的对应关系
 
 ### 配置
 

internal/testdata/api/workspace/users.json

@@ -0,0 +1,35 @@
+{
+  "status": 1,
+  "data": [
+    {
+      "UserWorkspace": {
+        "user": "张三",
+        "role_id": [
+          "11111122222001000029"
+        ],
+        "name": "张三",
+        "join_project_time": null,
+        "real_join_time": "2018-07-03",
+        "status": "2",
+        "allocation": "100",
+        "leave_project_time": null
+      }
+    },
+    {
+      "UserWorkspace": {
+        "user": "李四",
+        "role_id": [
+          "11111122222001000028",
+          "11111122222001000143"
+        ],
+        "name": "李四",
+        "join_project_time": null,
+        "real_join_time": "2018-07-09",
+        "status": "1",
+        "allocation": "100",
+        "leave_project_time": null
+      }
+    }
+  ],
+  "info": "success"
+}