feat: 支持在 user 下直接创建项目

huanyang@alauda.io · huanyang@alauda.io · commit 21f0522cbef1 · 2025-10-30T15:24:57.000+08:00
- 在 UserSpec 和 UserOutput 中添加 Projects 字段
- 实现 createUserProjectsWithOutput 函数，支持用户级项目创建
- 实现 deleteUserProjects 函数，支持用户级项目清理
- 用户级项目使用用户的命名空间（username/project-path）
- 更新示例配置文件和文档
diff --git a/README.md b/README.md
@@ -149,6 +149,13 @@ users:
             path: test-go-api
             description: Go API 服务
             visibility: private
+
+    # 用户级项目（不属于任何组，直接在用户命名空间下）
+    projects:
+      - name: my-personal-project
+        path: my-personal-project
+        description: Personal project under user namespace
+        visibility: private
 ```
 
 ### Token 配置说明
@@ -250,6 +257,13 @@ users:
             description: Go API 服务
             visibility: private
             web_url: https://devops-gitlab.alaudatech.net/tektoncd-backend-group/test-go-api
+    projects:
+      - name: my-personal-project
+        path: tektoncd/my-personal-project
+        project_id: 1438
+        description: Personal project under user namespace
+        visibility: private
+        web_url: https://devops-gitlab.alaudatech.net/tektoncd/my-personal-project
 ```
 
 ### 自定义模板输出
diff --git a/examples/user.yaml b/examples/user.yaml
@@ -31,6 +31,13 @@ users:
             description: demo project
             visibility: private
 
+    # 用户级项目（不属于任何组，直接在用户命名空间下）
+    projects:
+      - name: my-personal-project
+        path: my-personal-project
+        description: Personal project under user namespace
+        visibility: private
+
   # 示例 2: name 模式（不添加时间戳）
   # 使用方法：
   #   1. 创建：./bin/gitlab-cli user create -f user.yaml
diff --git a/internal/processor/processor.go b/internal/processor/processor.go
@@ -86,6 +86,17 @@ func (p *ResourceProcessor) ProcessUserCreation(userSpec types.UserSpec) (*types
 		output.Groups = groupOutputs
 	}
 
+	// 4. 创建用户级项目（不属于任何组的项目）
+	if len(userSpec.Projects) > 0 {
+		log.Printf("  创建 %d 个用户级项目...\n", len(userSpec.Projects))
+		projectOutputs, err := p.createUserProjectsWithOutput(actualUsername, userSpec.Projects, nameMode)
+		if err != nil {
+			log.Printf("  ⚠ 创建用户级项目失败: %v\n", err)
+		} else {
+			output.Projects = projectOutputs
+		}
+	}
+
 	return output, nil
 }
 
@@ -224,6 +235,85 @@ func (p *ResourceProcessor) ensureGroup(username string, groupSpec types.GroupSp
 	return group.ID, group.Path, nil
 }
 
+// createUserProjectsWithOutput 创建用户级别的项目（不属于任何组）
+func (p *ResourceProcessor) createUserProjectsWithOutput(username string, projects []types.ProjectSpec, userNameMode string) ([]types.ProjectOutput, error) {
+	var projectOutputs []types.ProjectOutput
+
+	// 获取用户信息以获取用户的 namespace ID
+	user, err := p.Client.GetUser(username)
+	if err != nil || user == nil {
+		return nil, fmt.Errorf("获取用户信息失败: %w", err)
+	}
+
+	for _, projSpec := range projects {
+		// 确定项目的 nameMode（如果项目没有指定，则继承用户的 nameMode）
+		projectNameMode := projSpec.NameMode
+		if projectNameMode == "" {
+			projectNameMode = userNameMode
+		}
+
+		// 根据 nameMode 生成实际的 project path
+		var actualProjectPath string
+		if projectNameMode == "name" {
+			// name 模式：直接使用配置文件中的名称
+			actualProjectPath = projSpec.Path
+			if actualProjectPath == "" {
+				actualProjectPath = projSpec.Name
+			}
+			log.Printf("    使用 name 模式，项目 path: %s\n", actualProjectPath)
+		} else {
+			// prefix 模式：添加时间戳
+			if projSpec.Path == "" {
+				actualProjectPath = utils.GenerateProjectPathWithTimestamp(projSpec.Name)
+			} else {
+				actualProjectPath = utils.GenerateProjectPathWithTimestamp(projSpec.Path)
+			}
+			log.Printf("    使用 prefix 模式，生成项目 path: %s\n", actualProjectPath)
+		}
+
+		// 用户级项目的 full path 是 username/project-path
+		fullPath := fmt.Sprintf("%s/%s", username, actualProjectPath)
+		existingProj, _ := p.Client.GetProject(fullPath)
+
+		var projectID int
+		var webURL string
+
+		if existingProj != nil {
+			log.Printf("    ⚠ 项目 '%s' 已存在 (ID: %d)\n", projSpec.Name, existingProj.ID)
+			projectID = existingProj.ID
+			webURL = existingProj.WebURL
+		} else {
+			log.Printf("    创建用户级项目: %s (path: %s)\n", projSpec.Name, actualProjectPath)
+			// 用户级项目使用用户的 ID 作为 namespace ID
+			project, err := p.Client.CreateProject(
+				username,
+				user.ID, // 使用用户 ID 作为 namespace ID
+				projSpec.Name,
+				actualProjectPath,
+				projSpec.Description,
+				utils.GetVisibility(projSpec.Visibility),
+			)
+			if err != nil {
+				log.Printf("    ⚠ 创建项目失败 %s: %v\n", projSpec.Name, err)
+				continue
+			}
+			log.Printf("    ✓ 项目创建成功 (ID: %d, Path: %s)\n", project.ID, project.PathWithNamespace)
+			projectID = project.ID
+			webURL = project.WebURL
+		}
+
+		projectOutputs = append(projectOutputs, types.ProjectOutput{
+			Name:        projSpec.Name,
+			Path:        fullPath,
+			ProjectID:   projectID,
+			Description: projSpec.Description,
+			Visibility:  projSpec.Visibility,
+			WebURL:      webURL,
+		})
+	}
+	return projectOutputs, nil
+}
+
 // createProjectsWithOutput 创建多个项目并返回输出结果
 func (p *ResourceProcessor) createProjectsWithOutput(username string, groupID int, groupPath string, projects []types.ProjectSpec, groupNameMode string) ([]types.ProjectOutput, error) {
 	var projectOutputs []types.ProjectOutput
@@ -314,7 +404,13 @@ func (p *ResourceProcessor) ProcessUserCleanup(userSpec types.UserSpec) error {
 
 	log.Printf("  找到用户 '%s' (ID: %d, 邮箱: %s)\n", user.Username, user.ID, user.Email)
 
-	// 1. 删除配置文件中定义的组和项目
+	// 1. 删除用户级项目（不属于任何组的项目）
+	if len(userSpec.Projects) > 0 {
+		log.Printf("  删除 %d 个用户级项目...\n", len(userSpec.Projects))
+		p.deleteUserProjects(userSpec.Username, userSpec.Projects)
+	}
+
+	// 2. 删除配置文件中定义的组和项目
 	if len(userSpec.Groups) > 0 {
 		log.Printf("  删除 %d 个组及其项目...\n", len(userSpec.Groups))
 		p.deleteConfiguredGroups(userSpec.Groups)
@@ -341,6 +437,33 @@ func (p *ResourceProcessor) ProcessUserCleanup(userSpec types.UserSpec) error {
 	return nil
 }
 
+// deleteUserProjects 删除用户级项目
+func (p *ResourceProcessor) deleteUserProjects(username string, projects []types.ProjectSpec) {
+	for i, projSpec := range projects {
+		log.Printf("  ------------------------------------------\n")
+		log.Printf("  处理用户级项目 [%d/%d]: %s\n", i+1, len(projects), projSpec.Name)
+
+		// 用户级项目的 full path 是 username/project-path
+		projectPath := projSpec.Path
+		if projectPath == "" {
+			projectPath = projSpec.Name
+		}
+		fullPath := fmt.Sprintf("%s/%s", username, projectPath)
+		project, _ := p.Client.GetProject(fullPath)
+
+		if project != nil {
+			log.Printf("    删除项目: %s (ID: %d)\n", projSpec.Name, project.ID)
+			if err := p.Client.DeleteProject(project.ID); err != nil {
+				log.Printf("    ⚠ 删除项目失败: %v\n", err)
+			} else {
+				log.Printf("    ✓ 项目删除成功\n")
+			}
+		} else {
+			log.Printf("    ⚠ 项目不存在，跳过: %s\n", fullPath)
+		}
+	}
+}
+
 // deleteConfiguredGroups 删除配置文件中定义的组及其项目
 func (p *ResourceProcessor) deleteConfiguredGroups(groups []types.GroupSpec) {
 	for j, groupSpec := range groups {
diff --git a/pkg/types/types.go b/pkg/types/types.go
@@ -7,13 +7,14 @@ type UserConfig struct {
 
 // UserSpec 用户规格定义
 type UserSpec struct {
-	NameMode string      `yaml:"nameMode,omitempty"` // 命名模式: "prefix" (添加时间戳) 或 "name" (不添加时间戳)，默认为 "prefix"
-	Username string      `yaml:"username"`
-	Email    string      `yaml:"email"`
-	Name     string      `yaml:"name"`
-	Password string      `yaml:"password"`
-	Token    *TokenSpec  `yaml:"token"`  // Personal Access Token 配置
-	Groups   []GroupSpec `yaml:"groups"` // 支持多个组
+	NameMode string        `yaml:"nameMode,omitempty"` // 命名模式: "prefix" (添加时间戳) 或 "name" (不添加时间戳)，默认为 "prefix"
+	Username string        `yaml:"username"`
+	Email    string        `yaml:"email"`
+	Name     string        `yaml:"name"`
+	Password string        `yaml:"password"`
+	Token    *TokenSpec    `yaml:"token"`    // Personal Access Token 配置
+	Groups   []GroupSpec   `yaml:"groups"`   // 支持多个组
+	Projects []ProjectSpec `yaml:"projects"` // 用户级别的项目（不属于任何组）
 }
 
 // TokenSpec Personal Access Token 规格定义
@@ -54,12 +55,13 @@ type OutputConfig struct {
 
 // UserOutput 用户输出结果
 type UserOutput struct {
-	Username string              `yaml:"username"`
-	Email    string              `yaml:"email"`
-	Name     string              `yaml:"name"`
-	UserID   int                 `yaml:"user_id"`
-	Token    *TokenOutput        `yaml:"token,omitempty"`
-	Groups   []GroupOutput       `yaml:"groups,omitempty"`
+	Username string          `yaml:"username"`
+	Email    string          `yaml:"email"`
+	Name     string          `yaml:"name"`
+	UserID   int             `yaml:"user_id"`
+	Token    *TokenOutput    `yaml:"token,omitempty"`
+	Groups   []GroupOutput   `yaml:"groups,omitempty"`
+	Projects []ProjectOutput `yaml:"projects,omitempty"` // 用户级别的项目
 }
 
 // TokenOutput Token 输出结果
