refactor: 将客服后端重构为宿主可嵌入模块

- 注入数据库、运行时配置、统一响应、文件存储和平台 AI 能力,补充业务读写工具与客户快捷操作契约。

- 移除模块内重复的组织、客户、工单、标签、技能、旧工作流、MCP 和迁移实现,将身份权限与业务主体交由宿主管理。

- 使用 libSQL 重构向量存储,并完善图片消息、访客身份、排队调度、企业微信和支持聊天页面。

- 统一 HTTP、DTO 与 WebSocket 的 snake_case 协议,补齐模块初始化、业务动作和公共载荷等回归测试。
This commit is contained in:
t
2026-08-28 22:23:13 +08:00
parent 6845c728f8
commit 18c9354095
377 changed files with 13199 additions and 22881 deletions
@@ -1,6 +1,8 @@
package api
import (
"log/slog"
"code.tczkiot.com/wlw/ai-agent/internal/builders"
"code.tczkiot.com/wlw/ai-agent/internal/pkg/dto/request"
"code.tczkiot.com/wlw/ai-agent/internal/pkg/dto/response"
@@ -13,6 +15,68 @@ import (
"github.com/gin-gonic/gin"
)
func ConversationGetQuick_actions(ctx *gin.Context) {
if services.ChannelService.GetEnabledChannel(ctx) == nil {
httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0211"))
return
}
external := httpx.GetExternalUser(ctx)
if external == nil {
httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0150"))
return
}
conversationID, _ := params.GetInt64(ctx, "conversation_id")
conversation := services.ConversationService.Get(conversationID)
if conversation == nil {
httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0116"))
return
}
if !services.ConversationService.IsCustomerConversationOwner(conversation, *external) {
httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0222"))
return
}
actions, err := services.CustomerQuickActionService.ListForConversation(ctx, conversation)
if err != nil {
httpx.WriteJSON(ctx, err)
return
}
results := make([]response.CustomerQuickActionResponse, 0, len(actions))
for _, action := range actions {
results = append(results, response.CustomerQuickActionResponse{
Code: action.Code, Title: action.Title, Description: action.Description,
})
}
httpx.WriteJSON(ctx, results)
}
func ConversationPostQuick_action(ctx *gin.Context) {
if services.ChannelService.GetEnabledChannel(ctx) == nil {
httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0211"))
return
}
external := httpx.GetExternalUser(ctx)
if external == nil {
httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0150"))
return
}
req := request.ExecuteCustomerQuickActionRequest{}
if err := params.ReadJSON(ctx, &req); err != nil {
httpx.WriteJSON(ctx, err)
return
}
customerMessage, replyMessage, err := services.CustomerQuickActionService.ExecuteAndRecord(
ctx, req.ConversationID, req.Code, req.ClientMsgID, *external, httpx.GetRequestID(ctx),
)
if err != nil {
httpx.WriteJSON(ctx, err)
return
}
httpx.WriteJSON(ctx, response.CustomerQuickActionExecutionResponse{
CustomerMessage: builders.BuildMessageWithLocale(customerMessage, i18nx.Locale(ctx)),
ReplyMessage: builders.BuildMessageWithLocale(replyMessage, i18nx.Locale(ctx)),
})
}
func ConversationGetBy(ctx *gin.Context) {
id, ok := httpx.GetPathInt64(ctx, "id")
if !ok {
@@ -59,6 +123,11 @@ func ConversationPostCreate_or_match(ctx *gin.Context) {
item, err := services.ConversationService.Create(*external, channel.ID, channel.AIAgentID)
if err != nil {
slog.ErrorContext(ctx.Request.Context(), "create or match conversation failed",
"channel_id", channel.ID,
"ai_agent_id", channel.AIAgentID,
"error", err,
)
httpx.WriteJSON(ctx, err)
return
}
+8 -8
View File
@@ -27,7 +27,7 @@ func MessageAnyList(ctx *gin.Context) {
return
}
conversationID, _ := params.GetInt64(ctx, "conversationId")
conversationID, _ := params.GetInt64(ctx, "conversation_id")
if conversationID <= 0 {
httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0064"))
return
@@ -43,8 +43,8 @@ func MessageAnyList(ctx *gin.Context) {
}
var (
senderType, _ = params.Get(ctx, "senderType")
messageType, _ = params.Get(ctx, "messageType")
senderType, _ = params.Get(ctx, "sender_type")
messageType, _ = params.Get(ctx, "message_type")
cursor, _ = params.GetInt64(ctx, "cursor")
limit, _ = params.GetInt(ctx, "limit")
)
@@ -72,7 +72,7 @@ func MessagePostSend(ctx *gin.Context) {
return
}
item, err := services.MessageService.SendCustomerMessageWithRequestID(req.ConversationID, req.ClientMsgID, req.MessageType, req.Content, req.Payload, *external, httpx.GetRequestID(ctx))
item, err := services.MessageService.SendCustomerMessageWithContextAndRequestID(ctx.Request.Context(), req.ConversationID, req.ClientMsgID, req.MessageType, req.Content, req.Payload, *external, httpx.GetRequestID(ctx))
if err != nil {
httpx.WriteJSON(ctx, err)
return
@@ -114,7 +114,7 @@ func MessagePostUpload_image(ctx *gin.Context) {
return
}
rawConv := strings.TrimSpace(params.FormValue(ctx, "conversationId"))
rawConv := strings.TrimSpace(params.FormValue(ctx, "conversation_id"))
if rawConv == "" {
httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0064"))
return
@@ -148,7 +148,7 @@ func MessagePostUpload_image(ctx *gin.Context) {
return
}
item, err := services.AssetService.UploadFile(header, "images", nil)
item, err := services.AssetService.UploadConversationImageFile(header, "images", conversationID, nil)
if err != nil {
httpx.WriteJSON(ctx, err)
return
@@ -167,7 +167,7 @@ func MessagePostUpload_attachment(ctx *gin.Context) {
return
}
rawConv := strings.TrimSpace(params.FormValue(ctx, "conversationId"))
rawConv := strings.TrimSpace(params.FormValue(ctx, "conversation_id"))
if rawConv == "" {
httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0064"))
return
@@ -187,7 +187,7 @@ func MessagePostUpload_attachment(ctx *gin.Context) {
httpx.WriteJSON(ctx, httpx.JsonErrorMsg(ctx, "error.e0324"))
return
}
item, err := services.AssetService.UploadFile(header, "attachments", nil)
item, err := services.AssetService.UploadConversationFile(header, "attachments", conversationID, nil)
if err != nil {
httpx.WriteJSON(ctx, err)
return