Bitzsoft.Integrations.ProjectManagement.Gitee 1.0.4

Bitzsoft.Integrations.ProjectManagement.Gitee

码云 Gitee OpenAPI v5 项目管理与工单协同连接器实现。遵循项目管理通用抽象规范，实现 IProjectManagementService 接口与专属的 IGiteeProjectManagementService 扩展接口。

功能特性

• 通用契约对齐：实现 IProjectManagementService 抽象规范，统一映射 Gitee 仓库（Repo）与 Issues 工单，支持创建、查询详情、更新属性、完成与状态过滤。
• Personal Access Token 鉴权：支持通过码云私人令牌（PAT）进行安全 API 请求。
• Issue 讨论与评论管理：支持向指定 Issue 追加讨论评论（AddCommentAsync）与列举历史评论列表（ListCommentsAsync）。
• Issue 状态流转管理：专有支持工单状态流转（UpdateIssueStateAsync，如 open、progressing、closed 等）。
• Pull Requests 检索：支持按仓库与状态检索 Pull Request 列表（ListPullRequestsAsync）。
• 智能缺省回退：支持配置全局 DefaultOwner 与 DefaultRepo，在业务请求未显式指定时自动缺省填充。
• 工业级弹性韧性：集成 Polly 标准韧性管道（429/503 指数退避重试与熔断保护）及全量出站请求审计日志（RequestLogging）。

安装

dotnet add package Bitzsoft.Integrations.ProjectManagement.Gitee

<PackageReference Include="Bitzsoft.Integrations.ProjectManagement.Gitee" Version="1.0.0" />

配置

在 appsettings.json 中配置 Gitee 连接器参数：

{
  "ProjectManagement": {
    "Gitee": {
      "BaseUrl": "https://gitee.com/api/v5",
      "AccessToken": "your-gitee-personal-access-token",
      "DefaultOwner": "my-org",
      "DefaultRepo": "my-project"
    }
  }
}

配置项说明

注册服务

支持通过配置源绑定或委托方式进行依赖注入注册：

using Microsoft.Extensions.DependencyInjection;

// 方式 1：通过 IConfiguration 绑定注册（推荐，默认读取 ProjectManagement:Gitee）
services.AddBitzsoftGiteeProjectManagement(configuration);

// 自定义配置节路径：
// services.AddBitzsoftGiteeProjectManagement(configuration, "Integrations:Gitee");

// 方式 2：通过委托手动配置注册
services.AddBitzsoftGiteeProjectManagement(options =>
{
    options.BaseUrl = "https://gitee.com/api/v5";
    options.AccessToken = "your-gitee-personal-access-token";
    options.DefaultOwner = "my-org";
    options.DefaultRepo = "my-project";
});

使用示例（通用 IProjectManagementService）

以下代码演示如何在业务类中通过依赖注入使用通用的 IProjectManagementService 契约操作 Gitee Issues：

using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
using Bitzsoft.Integrations.ProjectManagement;
using Bitzsoft.Integrations.ProjectManagement.Dtos;
using TaskStatus = Bitzsoft.Integrations.ProjectManagement.Dtos.TaskStatus;

namespace YourNamespace;

public class GiteeIssueAppService
{
    private readonly IProjectManagementService _pmService;

    public GiteeIssueAppService(IProjectManagementService pmService)
    {
        _pmService = pmService;
    }

    public async Task<PmTask> ReportIssueAsync(
        string repoPath,
        string title,
        string description,
        string? assignee = null,
        CancellationToken cancellationToken = default)
    {
        var request = new CreateTaskRequest
        {
            ProjectId = repoPath,
            Name = title,
            Description = description,
            AssigneeId = assignee,
            Priority = TaskPriority.Medium
        };

        return await _pmService.CreateTaskAsync(request, cancellationToken);
    }

    public async Task<PmTask> GetIssueAsync(
        string issueNumber,
        CancellationToken cancellationToken = default)
    {
        return await _pmService.GetTaskAsync(issueNumber, cancellationToken);
    }

    public async Task<List<PmTask>> ListActiveIssuesAsync(
        string repoPath,
        CancellationToken cancellationToken = default)
    {
        var request = new ListTasksRequest
        {
            ProjectId = repoPath,
            Status = TaskStatus.InProgress,
            PageIndex = 1,
            PageSize = 20
        };

        return await _pmService.ListTasksAsync(request, cancellationToken);
    }

    public async Task<PmResult> CloseIssueAsync(
        string issueNumber,
        CancellationToken cancellationToken = default)
    {
        return await _pmService.CompleteTaskAsync(issueNumber, cancellationToken);
    }
}

专有扩展能力（IGiteeProjectManagementService）

当业务需要针对 Gitee 特有机制（如发表与查询评论、直接修改状态字段、查询仓库 PR 列表）进行精细化操作时，可直接注入专属接口 IGiteeProjectManagementService：

using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
using Bitzsoft.Integrations.ProjectManagement.Gitee;
using Bitzsoft.Integrations.ProjectManagement.Gitee.Dtos;

namespace YourNamespace;

public class GiteeAdvancedCollaborationService
{
    private readonly IGiteeProjectManagementService _giteeService;

    public GiteeAdvancedCollaborationService(IGiteeProjectManagementService giteeService)
    {
        _giteeService = giteeService;
    }

    public async Task AddCommentAsync(
        string owner,
        string repo,
        string issueNumber,
        string commentBody,
        CancellationToken cancellationToken = default)
    {
        await _giteeService.AddCommentAsync(owner, repo, issueNumber, commentBody, cancellationToken);
    }

    public async Task<List<GiteeCommentDto>> GetCommentsAsync(
        string owner,
        string repo,
        string issueNumber,
        CancellationToken cancellationToken = default)
    {
        return await _giteeService.ListCommentsAsync(owner, repo, issueNumber, cancellationToken);
    }

    public async Task UpdateStateAsync(
        string owner,
        string repo,
        string issueNumber,
        string state,
        CancellationToken cancellationToken = default)
    {
        // Gitee 支持状态如 "open"、"progressing"、"closed"、"rejected"
        await _giteeService.UpdateIssueStateAsync(owner, repo, issueNumber, state, cancellationToken);
    }

    public async Task<List<GiteePullRequestDto>> GetOpenPullRequestsAsync(
        string owner,
        string repo,
        CancellationToken cancellationToken = default)
    {
        return await _giteeService.ListPullRequestsAsync(owner, repo, "open", cancellationToken);
    }
}

依赖

相关包