Skip to content

feat(EM-26): deliver Email Workspace events over WebSocket - #590

Open
dbahachuk wants to merge 1 commit into
feature/EM-25-email-distribution-commandsfrom
feature/EM-26-email-workspace-events
Open

dbahachuk wants to merge 1 commit into
feature/EM-25-email-distribution-commandsfrom
feature/EM-26-email-workspace-events

Conversation

@dbahachuk

Copy link
Copy Markdown

Delivers Email Workspace events of email-service to operators over WebSocket, the same way as for calls and chats:

  • the queue of a node with an operator's sockets is bound to the user's key on email.events, and bindings are restored after a channel loss;
  • clients subscribe with subscribe_email and receive the email event;
  • the event envelope is validated (type, domain and user must match the socket);
  • flag EMAIL_WORKSPACE, off by default.

@webitel-review

Copy link
Copy Markdown
Contributor

🤖 Webitel Code Review

Цей PR додає підтримку підписки на події email-сервісу (EM-26) через WebSocket для Workspace. Реалізовано асинхронне прив'язування черг у RabbitMQ, перевірку прав доступу та сесії користувача, дедуплікацію подій за id, обробку переповнення черг та розриву зв'язку з брокером із надсиланням подій синхронізації (resync_required).

📋 Walkthrough (17 файл(и/ів))
Файл Зміни
README.md Додано короткий опис подій Email (EM-26) та посилання на документацію.
app/web_conn.go Додано поля м'ютексу та атомарного вказівника для управління підпискою на Email події у WebConn.
app/web_email.go Реалізовано логіку підписки, перевірки прав доступу, обробки й відправки подій Email для WebSocket-з'єднань.
app/web_email_test.go Додано юніт-тести для підписки, перевірок доступу та доставки Email подій.
app/web_hub.go Інтегровано обробку вихідного каналу Email подій та відв'язування підписок при відключенні сокета у Hub.
docs/email-events.md Додано детальний контракт подій Email для Workspace.
go.mod Оновлено залежність github.com/google/uuid до прямої.
model/config.go Додано конфігураційний прапор EmailWorkspace (EMAIL_WORKSPACE).
model/email_event.go Створено структуру EmailEvent, функції валідації та парсингу маршрутизації RabbitMQ.
model/email_event_test.go Додано тести парсингу та валідації EmailEvent.
model/email_ws.go Реалізовано конвертацію EmailEvent у WebSocketEvent та створення ресинхронізаційних подій.
model/email_ws_test.go Додано тести формування WebSocket-подій для Email.
mq/mq.go Розширено інтерфейс DomainQueue методами для підтримки подій Email.
mq/rabbit/domain_queue.go Додано обробку Email-обмінника, перевірку домену та реакцію на відновлення черги (Rebound).
mq/rabbit/domain_queue_test.go Оновлено фейки та тести DomainQueue.
mq/rabbit/email_binder.go Реалізовано окремий асинхронний обробник binding/unbind операцій Email у RabbitMQ.
mq/rabbit/email_domain_queue_test.go Додано тести асинхронного прив'язування та перепідключення Email-черг у RabbitMQ.

Суттєвих зауважень немає. 👍

🔗 Cross-repo callers змінених символів (40)
  • Create → im-contact-service/internal/handler/grpc/contact.go:82 у (*ContactServer).CreateContact (тип ресівера не доведено)
  • Create → im-contact-service/internal/handler/grpc/via.go:48 у (*ViaServer).Create (тип ресівера не доведено)
  • Create → im-contact-service/internal/service/contact.go:67 у (*contactService).Create (тип ресівера не доведено)
  • EmailEvent → cases/internal/api_handler/grpc/case_timeline.go:275 у (*CaseTimelineService).MarshalTimeline
  • EmailEvent → cases/internal/api_handler/grpc/case_timeline.go:407 у (*CaseTimelineService).MarshalEmailEvent
  • EmailEvent → cases/internal/model/timeline_counter.go:71 у (*TimelineEvent).UnmarshalEventData
  • Events → im-thread-service/internal/service/message.go:1207 у (*MessageService).dispatchInteractiveCallbackEvents (тип ресівера не доведено)
  • Events → im-thread-service/internal/service/message.go:1224 у (*MessageService).dispatchReactionEvents (тип ресівера не доведено)
  • Events → im-thread-service/internal/service/message.go:1238 у (*MessageService).dispatchMessageEvents (тип ресівера не доведено)
  • GetSession → engine/app/cc_agent.go:210 у (*App).GetAgentSession (тип ресівера не доведено)
  • GetSession → engine/app/grpc_server.go:359 у (*App).getSessionFromCtx (тип ресівера не доведено)
  • NewDomainQueue → engine/app/web_hub.go:54 у (*App).NewWebHub (тип ресівера не доведено)
  • NewDomainQueue → engine/mq/layered_mq.go:50 у (*LayeredMQ).NewDomainQueue (тип ресівера не доведено)
  • RegisterWebsocket → engine/app/web_hub.go:97 у (*Hub).start (тип ресівера не доведено)
  • RegisterWebsocket → engine/mq/layered_mq.go:54 у (*LayeredMQ).RegisterWebsocket (тип ресівера не доведено)
  • SocketSession → engine/app/screen.go:25 у (*App).RequestScreenShare (тип ресівера не доведено)
  • SocketSession → engine/app/screen.go:71 у (*App).Screenshot (тип ресівера не доведено)
  • SocketSession → engine/app/screen.go:94 у (*App).ScreenShareRecordStart (тип ресівера не доведено)
  • SocketSession → engine/app/web_conn.go:351 у (*WebConn).SocketSession
  • SocketSession → engine/app/web_conn.go:352 у (*WebConn).SocketSession
  • SocketSession → engine/app/web_hubs.go:25
  • SocketSession → engine/store/sqlstore/socket_session.go:46 у (*SqlSocketSessionStore).Create
  • SocketSession → engine/store/store.go:558
  • Start → call_center/app/app.go:140 у New (тип ресівера не доведено)
  • Start → call_center/app/app.go:161 у New (тип ресівера не доведено)
  • Start → call_center/app/app.go:176 у New (тип ресівера не доведено)
  • Stop → call_center/app/app.go:256 у (*App).Shutdown (тип ресівера не доведено)
  • Stop → call_center/app/app.go:260 у (*App).Shutdown (тип ресівера не доведено)
  • Stop → call_center/app/app.go:264 у (*App).Shutdown (тип ресівера не доведено)
  • UnRegisterWebsocket → engine/app/web_hub.go:118 у (*Hub).start (тип ресівера не доведено)
  • UnRegisterWebsocket → engine/mq/layered_mq.go:58 у (*LayeredMQ).UnRegisterWebsocket (тип ресівера не доведено)
  • Unbind → engine/mq/rabbit/domain_queue.go:254 у (*DomainQueue).BulkUnbind (тип ресівера не доведено)
  • WebSocketEvent → engine/app/web_conn.go:276 у (*WebConn).writePump
  • WebSocketEvent → engine/app/web_conn.go:282 у (*WebConn).writePump
  • WebSocketEvent → engine/app/web_conn.go:442 у (*WebConn).ShouldSendEvent
  • WebSocketEvent → engine/app/web_hub.go:25
  • WebSocketEvent → engine/app/web_hub.go:43 у (*App).NewWebHub
  • WebSocketEvent → engine/model/call.go:828 у NewWebSocketCallEvent
  • WebSocketEvent → engine/model/cc_agent.go:515 у NewWebSocketCallCenterEvent
  • WebSocketEvent → engine/model/cc_agent.go:516 у NewWebSocketCallCenterEvent

Index-grounded review across the Webitel codebase. Знахідки можуть бути неточними — перевіряйте перед застосуванням.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant