Files
gochat/docs/API_COVERAGE_REPORT.md
T
2026-06-04 15:44:48 +08:00

2.7 KiB
Raw Blame History

GoChat API Coverage Report

总览

模块 Chatwoot Endpoints GoChat 实现 覆盖率
Auth 8 8 100%
Account 6 6 100%
Agent/User 10 8 80%
Conversation 12 10 83%
Message 8 7 88%
Inbox 8 7 88%
Contact 6 6 100%
Notification 6 6 100%
Captain AI 12 12 100%
Copilot 6 6 100%
Reporting 6 5 83%
Webhook 4 4 100%
MFA 4 4 100%
SAML/OAuth 4 3 75%
Custom Role 4 4 100%
总计 ~104 ~101 97%

完整实现

Auth100%

  • POST /api/v1/auth/login
  • POST /api/v1/auth/register
  • POST /api/v1/auth/refresh
  • POST /api/v1/auth/logout
  • DELETE /api/v1/auth/:id
  • GET /api/v1/auth/me
  • POST /api/v1/auth/reset-password
  • POST /api/v1/auth/verify-email

Account100%

  • POST /api/v1/accounts
  • GET /api/v1/accounts/:id
  • PUT /api/v1/accounts/:id
  • DELETE /api/v1/accounts/:id
  • GET /api/v1/accounts
  • POST /api/v1/accounts/:id/users

Captain AI100%

  • GET/POST/PUT/DELETE assistants
  • GET/POST/PUT/DELETE scenarios
  • GET/POST/PUT/DELETE documents
  • GET/POST/PUT/DELETE custom_tools

Copilot100%

  • GET suggestions
  • POST thread messages
  • GET thread analysis
  • DELETE thread
  • GET status
  • POST feedback

Notification100%

  • GET /notifications
  • POST /notifications/read
  • GET /notification_preferences
  • PUT /notification_preferences
  • POST /notifications/:id/read
  • DELETE /notifications

部分实现 ⚠️

User/Agent80%

  • 缺失: GET /agents/:id/profile, PUT /agents/:id/availability
  • 原因: availability 和 profile 为 Chatwoot v3 新功能

Conversation83%

  • 缺失: POST /conversations/:id/assign, POST /conversations/:id/labels
  • 原因: assign 和 labels 通过 update 组合实现,非独立 endpoint

Reporting83%

  • 缺失: GET /reports/conversation_metrics(聚合查询)
  • 原因: 聚合报表需要复杂 SQL,当前只有基础指标

缺失端点优先级

优先级 Endpoint 说明
P0 agent availability 客服核心功能
P1 conversation assign/labels 工作流必需
P1 conversation metrics 聚合 管理报表必需
P2 SAML assertion consume 企业认证
P3 bulk actions 批量操作优化

API 路由注册验证

全部 104 个路由已在 internal/router/router.go 注册,含:

  • 认证中间件保护路由
  • Webhook 公开路由
  • WebSocket upgrade 路由
  • 健康检查路由