Bitzsoft.Integrations.ProjectManagement 1.0.4

Bitzsoft.Integrations.ProjectManagement

项目管理抽象层 — 统一接口定义、基础模型与结果包装。

屏蔽 Asana、Teambition、Jira Cloud、Jira Data Center、Azure DevOps、TAPD、GitHub、GitLab、Gitee、Monday、Trello、ONES、PingCode、阿里云效等供应商差异，提供一致的项目查询与任务创建、查询、更新、完成、列表查询 API。

功能特性

• 统一供应商接口 IProjectManagementService：8 个异步方法覆盖项目与任务全生命周期
• 统一结果包装：PmResult 携带成功标志与错误信息
• 统一异常 ProjectManagementException：封装供应商标识、错误码与请求 ID
• 不可变模型设计：集合返回 List<T>，属性使用 init 保证只读

安装

dotnet add package Bitzsoft.Integrations.ProjectManagement

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

接口

IProjectManagementService

统一的项目管理供应商接口。

说明：部分供应商（如 Jira Cloud、Jira Data Center 等）的项目创建需管理员级 API，其连接器重点聚焦于任务（Issue / Work Item）全生命周期管理（创建、详情获取、信息更新、工作流状态跃迁与列表检索）。

核心模型

枚举

使用示例

抽象层本身只定义接口与模型，具体实现由各供应商包提供。以下示例假设已注册某个供应商实现：

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

public class TaskBoardService
{
    private readonly IProjectManagementService _pm;

    public TaskBoardService(IProjectManagementService pm)
    {
        _pm = pm;
    }

    public async Task<string> PlanTaskAsync(string projectId, string name, string assigneeId, CancellationToken cancellationToken = default)
    {
        var task = await _pm.CreateTaskAsync(new CreateTaskRequest
        {
            ProjectId = projectId,
            Name = name,
            AssigneeId = assigneeId,
            DueDate = DateTimeOffset.UtcNow.AddDays(7),
            Priority = TaskPriority.Medium
        }, cancellationToken);

        return task.TaskId;
    }

    public Task<PmResult> CloseTaskAsync(string taskId, CancellationToken cancellationToken = default)
        => _pm.CompleteTaskAsync(taskId, cancellationToken);
}

多供应商解析

同一应用注册多个供应商时，通过 IIntegrationProviderResolver<IProjectManagementService> 按供应商 ID 解析：

using Bitzsoft.Integrations.Core;
using Bitzsoft.Integrations.ProjectManagement;
using Microsoft.Extensions.DependencyInjection;

var resolver = serviceProvider.GetRequiredService<IIntegrationProviderResolver<IProjectManagementService>>();
var asana = resolver.GetRequired("asana");
var task = await asana.CreateTaskAsync(request);

依赖

• Bitzsoft.Integrations.Core：公共基座（IntegrationException、IIntegrationProviderResolver<T>）

相关包