@burdenoff/microfe-support

中文文档
2026.1031.2发布于 2026/11/01TypeScriptES Module近 30 天下载 8532

负担支持微前端 - 完整的客户支持和出票接口

中文使用文档
文档目录24 节
  1. 概览
  2. 特征
  3. 安装
  4. 发展
  5. 项目结构
  6. 图QL 操作
  7. 查询
  8. 变异
  9. 订阅
  10. 配置
  11. 环境变量
  12. 与壳牌公司合并
  13. 车票优先级
  14. 车票状态
  15. SLA 违反状态
  16. 知识库
  17. 条状结构
  18. SEO- 友好的 URL
  19. 可用的脚本
  20. 技术堆栈
  21. 已知问题
  22. 图QL 生成代码
  23. 最佳做法
  24. 许可证

@ taffleoff/微费支持

Burdenoff平台的客户支持和服务台系统

TypeScript React Vite

概览

支持微前端提供了一个全面的客户支持平台,包括售票管理,售票后的对话,知识库,分析,以及SLA跟踪. 以持久的票证历史和业务见解为客户提供支持.

端口 : 5154 模块类型 : 租户单元 API 网关 : 港口 4018

特征

  • 车票管理

    • 创建和管理支持票
    • 优先级别(低、常、高、关键)
    • 状况跟踪(新、在建、已解决、已关闭)
    • 罚单分配和升级
    • 内部说明和客户答复
    • 文件附件
  • 退票谈话

    • 客户和代理人对支持票的答复
    • 更新票的订阅信件
    • 持久的谈话历史
    • 答复
    • 通过票务流程分配和升级
  • 知识库

    • 自助文章
    • 类别组织
    • 条款查询
    • 视图跟踪
    • 帮助/无帮助投票
    • 相关条款
  • SLA 管理

    • 配置 SLA 政策
    • 跟踪响应时间
    • 决议时间监测
    • 苏丹解放军突破警报
    • 办公时间配置
    • 每个优先级自定义 SLA 规则
  • 分析盘

    • 车票数量趋势
    • 反应时间指标
    • 分辨率时间尺度
    • 代理业绩
    • 客户满意度分数
    • 类别细目
  • 设置配置( S)

    • 常规设置
    • 工作时间
    • 苏丹解放军政策
    • 答复
    • 电子邮件模板
    • 车票类别

安装

# Install dependencies
bun install

# Generate GraphQL types
bun run codegen

发展

# Start development server (port 5154)
bun run dev

# Run linter
bun run lint

# Format code
bun run format

# Type check
bun run type:check

# Build for production
bun run build

# Run all quality checks
bun run sanity

项目结构

src/
├── dev/                      # Development harness
├── support/                  # Main module
│   ├── components/          # React components
│   │   ├── PageLayout.tsx
│   │   ├── analytics/       # Analytics components
│   │   ├── chat/           # Chat components
│   │   ├── settings/       # Settings components
│   │   ├── shared/         # Shared components
│   │   ├── tickets/        # Ticket components
│   │   └── ui.tsx          # UI components
│   ├── graphql/            # GraphQL operations
│   │   ├── client.ts
│   │   ├── generated/      # Generated types
│   │   └── operations/     # Queries/Mutations
│   ├── hooks/              # Custom React hooks
│   │   ├── useAnalyticsOperations.ts
│   │   ├── useChatOperations.ts
│   │   ├── useKnowledgeBaseOperations.ts
│   │   ├── useSettingsOperations.ts
│   │   └── useTicketOperations.ts
│   ├── pages/              # Page components
│   ├── providers/          # Context providers
│   ├── store/              # State management
│   ├── types/              # TypeScript types
│   └── utils/              # Utility functions

图QL 操作

查询

  • getTickets - 名单支持票
  • getTicketDetail - 获取票务信息和状况
  • mySupportTickets - 列出我的支持票
  • getArticles - 列出 KB 文章
  • getArticle - 获取文章细节
  • getSupportAnalytics - 得到分析
  • getSLAPolicies - 列出苏丹解放军的政策
  • getCannedResponses - 获得罐头反应

变异

  • createTicket - 创建支持票
  • updateTicket - 更新票
  • addTicketMessage - 在票上添加消息
  • assignTicket - 指派给特工
  • changeTicketStatus - 最新情况
  • createSLAPolicy - 制定苏丹解放军政策
  • createCannedResponse - 创建罐装反应

订阅

  • ticketUpdated - 车票状态变化(以生成代码)
  • ticketMessageAdded - 实时售票谈话更新(以生成代码)

配置

环境变量

VITE_API_GATEWAY_URL=http://localhost:4018/graphql
VITE_TENANT_ID=your-tenant-id
VITE_WORKSPACE_ID=your-workspace-id

与壳牌公司合并

import { SupportRoot } from '@burdenoff/microfe-support';

function App() {
  return (
    <SupportRoot
      basePath="/support"
      navigate={navigate}
      apiGatewayUrl="http://localhost:4018/graphql"
      workspaceId="workspace-123"
      currentUser={{
        id: 'user-1',
        email: '[email protected]',
        displayName: 'Support Agent',
      }}
      onTicketCreated={(ticket) => {
        console.log('Ticket created:', ticket);
      }}
      onChatStarted={(session) => {
        console.log('Ticket conversation started:', session);
      }}
      onArticleViewed={(article) => {
        console.log('Article viewed:', article);
      }}
    />
  );
}

车票优先级

优先权苏丹解放军的回应苏丹解放军决议使用大小写
关键15分钟4小时系统关闭,数据丢失
高级1小时8小时主要功能已断开
常规4小时24小时一般问题
低级24小时72小时问题、请求

车票状态

  • 新设 - 刚刚创建,尚未指定
  • 进行中 - 被特工调查
  • 等待客户 - 等待客户回应
  • 决定 - 定案,等待确认
  • 关闭 - 确认已解决
  • 重新打开 - 关闭后重新开放

SLA 违反状态

  • 无 - 在轨道上
  • 警告 50% - 时间的50%
  • 警告:75% - 75%的时间
  • 警告 90% - 90%的时间
  • 被突破 - 苏丹解放军时间超过

知识库

条状结构

  • 标题和说明
  • 文章内容( 马可达)
  • 类别
  • 搜索标记
  • 相关条款
  • 查看计数跟踪
  • 帮助收视率

SEO- 友好的 URL

/knowledge-base/getting-started
/knowledge-base/account-management/password-reset
/knowledge-base/billing/upgrade-plan

可用的脚本

脚本说明
bun run dev启动开发服务器
bun run build生产建筑
bun run lint运行 ESLint
bun run format格式为 Pretier
bun run type:check脚本类型检查
bun run codegen生成图QL 类型
bun run sanity运行所有质量检查

技术堆栈

  • 框架: 使用类型脚本 5.9 的反应 19
  • 构建工具 : 视频 7
  • 州管理层: Zu5
  • 图QL 客户端 : 阿波罗客户端
  • 风格: 尾风 CSS v4
  • UI 组件 : Radix 用户界面
  • 图标 : 路西德反应
  • 跑道: 反应路由器 DOM 7
  • 实时 : 图QL 订阅

已知问题

图QL 生成代码

2 类型脚本出错 src/support/graphql/generated/operations.ts (行778,787)与阿波罗客户端订阅类型相容性有关. 这些在 生成代码 当图形QL 方案重新生成时, 将解决它。 尽管存在这些错误,该模块仍然充分发挥作用.

最佳做法

  1. 车票管理

    • 在苏丹解放军时间内作出反应
    • 不断更新客户信息
    • 使用内部注释进行团队通信
    • 立即关闭已解决的罚单
  2. 现场聊天

    • 快速问候顾客
    • 使用罐装反应提高效率
    • 必要时转至专家
    • 礼貌地结束聊天
  3. 知识库

    • 写清楚,简洁的文章
    • 包含截图/视频
    • 内容不断更新
    • 监测文章的有用性

许可证

版权所有——版权2025 Burdenoff咨询服务有限公司.

版本与发布记录

@burdenoff/microfe-support 共发布 75 个版本,首次发布于 2026/05/11;过去 12 个月发布了 75 个版本。

版本发布日期距今
2026.1031.2latest2026/11/018 天前
2026.1031.1alpha2026/11/018 天前
2026.1029.32026/10/309 天前
2026.1029.22026/10/309 天前
2026.1029.12026/10/309 天前
2026.1014.102026/10/1524 天前

关于 @burdenoff/microfe-support 的常见问题

@burdenoff/microfe-support 是什么?

负担支持微前端 - 完整的客户支持和出票接口

如何安装 @burdenoff/microfe-support?

在项目目录运行 npm install @burdenoff/microfe-support,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^19.0.0)、zustand(^5.0.0)、react-dom(^19.0.0)、@apollo/client(^4.0.9)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@burdenoff/microfe-support 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@burdenoff/microfe-support 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@burdenoff/microfe-support 可以商用吗?

@burdenoff/microfe-support 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@burdenoff/microfe-support 的下载量有多少?

根据 npm 官方下载统计,@burdenoff/microfe-support 在 2026/10/09 – 2026/11/07 这 30 天内被下载 8,532 次,日均约 284 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@burdenoff/microfe-support 还在维护吗?

最新版本 2026.1031.2 发布于 2026/11/01(8 天前);至今共发布 75 个版本,其中过去 12 个月发布了 75 个;首次发布于 2026/05/11。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。