refactor: update visitor references to guest in WebSocket service and related files

internal/bootstrap/server.go

@@ -28,9 +28,9 @@ func NewServer() (*iris.Application, error) {
 	app := iris.New()
 	corsHandler := cors.New().
 		AllowOrigin("*").
-		AllowHeaders("Origin", "Content-Type", "Accept", "Authorization", "X-Requested-With", "X-Visitor-Id", "X-Channel-Id", "X-External-Source", "X-External-Id", "X-External-Name").
+		AllowHeaders("Origin", "Content-Type", "Accept", "Authorization", "X-Requested-With", "X-Guest-Id", "X-Channel-Id", "X-External-Source", "X-External-Id", "X-External-Name").
 		MaxAge(600).
-		ExposeHeaders("Content-Length", "Content-Type", "Authorization", "X-Visitor-Id", "X-Channel-Id", "X-External-Source", "X-External-Id", "X-External-Name").
+		ExposeHeaders("Content-Length", "Content-Type", "Authorization", "X-Guest-Id", "X-Channel-Id", "X-External-Source", "X-External-Id", "X-External-Name").
 		Handler()
 	app.UseRouter(func(ctx iris.Context) {
 		// WebSocket upgrade is validated by the upgrader's origin policy.

internal/builders/conversation_builder.go

@@ -38,7 +38,7 @@ func BuildConversation(item *models.Conversation) response.ConversationResponse
 		AgentLastReadMessageID:    readStateMessageID(agentReadState),
 		AgentLastReadSeqNo:        readStateSeqNo(agentReadState),
 		AgentLastReadAt:           readStateAt(agentReadState),
-		CustomerOnline:            services.WsService.IsVisitorOnline(item.ExternalID),
+		CustomerOnline:            services.WsService.IsGuestOnline(item.ExternalID),
 		ClosedAt:                  utils.FormatTimePtr(item.ClosedAt),
 		ClosedBy:                  item.ClosedBy,
 		CloseReason:               item.CloseReason,

internal/services/ws_realtime_types.go

@@ -28,7 +28,7 @@ const (
 
 const (
 	realtimeTopicUserPrefix         = "user:"
-	realtimeTopicVisitorPrefix      = "visitor:"
+	realtimeTopicGuestPrefix        = "guest:"
 	realtimeTopicAdminPrefix        = "admin:"
 	realtimeTopicConversationPrefix = "conversation:"
 	realtimeTopicAdminAll           = "admin:all"
@@ -54,7 +54,7 @@ type RealtimeEventPayload interface {
 type RealtimeConnectedPayload struct {
 	ConnID       string   `json:"connId,omitempty"`
 	UserID       int64    `json:"userId,omitempty"`
-	VisitorID    string   `json:"visitorId,omitempty"`
+	GuestID      string   `json:"guestId,omitempty"`
 	Role         string   `json:"role,omitempty"`
 	TerminalType string   `json:"terminalType,omitempty"`
 	Topics       []string `json:"topics,omitempty"`

internal/services/ws_service.go

@@ -132,7 +132,7 @@ func (s *wsService) upgradeConnection(ctx iris.Context, principal *dto.AuthPrinc
 		Payload: RealtimeConnectedPayload{
 			ConnID:       session.ID,
 			UserID:       logUserID,
-			VisitorID:    logExternalID,
+			GuestID:      logExternalID,
 			Role:         role,
 			TerminalType: session.TerminalType,
 			Topics:       session.topicList(),
@@ -500,12 +500,12 @@ func (s *wsService) PublishToTopics(topics []string, event RealtimeEvent) {
 	}
 }
 
-func (s *wsService) IsVisitorOnline(visitorID string) bool {
-	visitorID = strings.TrimSpace(visitorID)
-	if visitorID == "" {
+func (s *wsService) IsGuestOnline(guestID string) bool {
+	guestID = strings.TrimSpace(guestID)
+	if guestID == "" {
 		return false
 	}
-	return s.manager.HasTopic(s.visitorTopic(visitorID))
+	return s.manager.HasTopic(s.guestTopic(guestID))
 }
 
 func (s *wsService) routeConversationTopics(conversation *models.Conversation) []string {
@@ -515,7 +515,7 @@ func (s *wsService) routeConversationTopics(conversation *models.Conversation) [
 
 	topics := []string{s.conversationTopic(conversation.ID)}
 	if strings.TrimSpace(conversation.ExternalID) != "" {
-		topics = append(topics, s.visitorTopic(conversation.ExternalID))
+		topics = append(topics, s.guestTopic(conversation.ExternalID))
 	}
 	if conversation.CurrentAssigneeID > 0 {
 		topics = append(topics, s.adminTopic(conversation.CurrentAssigneeID))
@@ -537,9 +537,9 @@ func (s *wsService) defaultTopics(session *ClientSession) []string {
 		}
 		return []string{s.adminTopic(session.Principal.UserID), realtimeTopicAdminAll}
 	default:
-		// 开放 IM：仅 External、无 AuthPrincipal 的访客连接必须仍能订阅 visitor:{externalId}，否则收不到推送。
+		// 开放 IM：仅 External、无 AuthPrincipal 的访客连接必须仍能订阅 guest:{externalId}，否则收不到推送。
 		if session.External != nil && strings.TrimSpace(session.External.ExternalID) != "" {
-			return []string{s.visitorTopic(session.External.ExternalID)}
+			return []string{s.guestTopic(session.External.ExternalID)}
 		}
 		if session.Principal != nil && session.Principal.UserID > 0 {
 			return []string{s.userTopic(session.Principal.UserID)}
@@ -637,8 +637,8 @@ func (s *wsService) userTopic(userID int64) string {
 	return realtimeTopicUserPrefix + strconv.FormatInt(userID, 10)
 }
 
-func (s *wsService) visitorTopic(visitorID string) string {
-	return realtimeTopicVisitorPrefix + strings.TrimSpace(visitorID)
+func (s *wsService) guestTopic(guestID string) string {
+	return realtimeTopicGuestPrefix + strings.TrimSpace(guestID)
 }
 
 func (s *wsService) adminTopic(userID int64) string {