工单系统域把 ITSM(IT 服务管理)核心对象抽象为 ITicketService,消费方通过 DI 注入接口即可,无需关心具体供应商。
统一接口
ITicketService(命名空间 Bitzsoft.Integrations.Ticketing)定义 7 个方法:
| 方法 | 说明 |
|---|---|
CreateTicketAsync | 创建工单 |
GetTicketAsync | 查询单个工单详情 |
UpdateTicketAsync | 更新工单信息 |
AssignTicketAsync | 分配工单给处理人 |
ChangeStatusAsync | 变更工单状态 |
AddCommentAsync | 添加工单评论/回复 |
ListTicketsAsync | 查询工单列表 |
接口还暴露 ProviderName 属性,返回运行时供应商名称(如 "Zendesk")。
包结构
Bitzsoft.Integrations.Ticketing/ ← 抽象层Bitzsoft.Integrations.Ticketing.All/ ← 聚合包(拉入全部 4 家)Bitzsoft.Integrations.Ticketing.Zendesk/Bitzsoft.Integrations.Ticketing.Zentao/ ← 禅道Bitzsoft.Integrations.Ticketing.Freshdesk/Bitzsoft.Integrations.Ticketing.ServiceNow/ ← 适配器(只读)供应商清单
| 供应商 | Provider ID | 鉴权 | 文档 |
|---|---|---|---|
| Zendesk | zendesk | Basic Auth({email}/token:{apiToken}) | zendesk.mdx |
| 禅道 Zentao | zentao | Session Token / API Token | zentao.mdx |
| Freshdesk | freshdesk | Basic Auth(api_key:x) | freshdesk.mdx |
| ServiceNow | servicenow | OAuth 2.0(适配器,只读) | servicenow.mdx |