Bitzsoft.Integrations.HumanResources.Moka 1.0.2

Bitzsoft.Integrations.HumanResources.Moka

Moka 人力资源服务实现，实现 IHumanResourcesService 统一接口。

功能特性

• 员工全生命周期：创建、查询、更新、停用（离职）、分页列表查询
• 部门管理：创建部门、查询部门列表
• 考勤管理：提交考勤、按日期范围查询考勤记录
• HTTP Basic Auth 鉴权：API Key 作为用户名、API Secret 作为密码
• 统一接口：实现 IHumanResourcesService，ProviderName 返回 Moka 供应商标识
• 配置校验：注册时通过 MokaOptionsValidator 校验必填项
• 请求审计：内置 RequestLogging 管道，记录出站请求

安装

dotnet add package Bitzsoft.Integrations.HumanResources.Moka

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

配置

appsettings.json

{
  "HumanResources": {
    "Moka": {
      "ApiBaseUrl": "https://api.mokahr.com/api",
      "ApiKey": "your-api-key",
      "ApiSecret": "your-api-secret"
    }
  }
}

注册服务

从 IConfiguration 绑定（推荐）

using Microsoft.Extensions.DependencyInjection;

builder.Services.AddMokaHumanResources(
    builder.Configuration.GetSection("HumanResources:Moka"));

委托配置

builder.Services.AddMokaHumanResources(options =>
{
    options.ApiBaseUrl = "https://api.mokahr.com/api";
    options.ApiKey = "your-api-key";
    options.ApiSecret = "your-api-secret";
});

注册后 IHumanResourcesService（ProviderName = Moka）可用，可通过 IIntegrationProviderResolver<IHumanResourcesService> 按供应商 ID（moka）解析。

使用示例

using Bitzsoft.Integrations.Core;
using Bitzsoft.Integrations.HumanResources;

public class EmployeeSyncService(IIntegrationProviderResolver<IHumanResourcesService> resolver)
{
    public async Task<HrEmployee> CreateEmployeeAsync(string name, string email, CancellationToken ct)
    {
        var service = resolver.GetRequired("moka");

        return await service.CreateEmployeeAsync(new CreateEmployeeRequest
        {
            Name = name,
            Email = email
        }, ct);
    }

    public async Task<List<HrEmployee>> ListByDepartmentAsync(string departmentId, CancellationToken ct)
    {
        var service = resolver.GetRequired("moka");
        return await service.ListEmployeesAsync(new ListEmployeesRequest
        {
            DepartmentId = departmentId,
            PageSize = 100
        }, ct);
    }

    public async Task<List<HrAttendanceRecord>> GetAttendanceAsync(
        string employeeId, DateTimeOffset start, DateTimeOffset end, CancellationToken ct)
    {
        var service = resolver.GetRequired("moka");
        return await service.ListAttendanceRecordsAsync(employeeId, start, end, ct);
    }
}

依赖

相关包

• Bitzsoft.Integrations.HumanResources -- 抽象层
• Bitzsoft.Integrations.HumanResources.Xinrenxinshi -- 薪人薪事实现
• Bitzsoft.Integrations.HumanResources.All -- 聚合包