Skip to content

feat(EM-25): add Email commands over WebSocket - #586

Open
dbahachuk wants to merge 1 commit into
feature/EM-23-email-attempt-lifecyclefrom
feature/EM-25-email-distribution-commands
Open

dbahachuk wants to merge 1 commit into
feature/EM-23-email-attempt-lifecyclefrom
feature/EM-25-email-distribution-commands

Conversation

@dbahachuk

Copy link
Copy Markdown

Summary

  • Email attempt commands over WebSocket: cc_email_take, postpone, resume, return, complete, renew, transfer, plus cc_email_transfer_agents.
  • Domain, user and agent come from the session; requires email_thread update (and cc_queue read for a transfer to a queue).
  • call_center errors keep their stable id and map to HTTP codes.
  • Config: EMAIL_COMMAND_TIMEOUT (10s).

@webitel-review

webitel-review Bot commented Nov 9, 2026

Copy link
Copy Markdown
Contributor

🤖 Webitel Code Review

Цей PR додає підтримку Email-команд оператора (cc_email_take, cc_email_postpone, cc_email_resume, cc_email_return, cc_email_complete, cc_email_renew та cc_email_transfer) відповідно до специфікації EM-25. Реалізовано перевірку прав доступу на рівні сесії (ОBAC/RBAC для email_thread та cc_queue), автоматичне визначення agent_id за користувачем сесії, конвертацію gRPC-помилок з call_center у AppError, оновлено proto-файли та клієнтські інтерфейси. Зміни є безпечними та добре покритими тестами.

📋 Walkthrough (10 файл(и/ів))
Файл Зміни
README.md Додано документацію щодо контрактів WebSocket для Email-команд оператора (EM-25).
app/cc/client.go Розширено інтерфейс MemberApi новими методами для виконання Email-команд.
app/cc/member.go Реалізовано методи Email-команд у memberApi шляхом делегування до gRPC-клієнта.
app/email_attempt.go Додано бізнес-логіку виконання Email-команд оператора, перевірки агента користувача та отримання кандидатів на трансфер.
app/email_error.go Реалізовано мапінг gRPC-помилок сервісу call_center у відповідні HTTP-статуси та коди AppError.
app/email_error_test.go Додано юніт-тести для перевірки правильності мапінгу gRPC-помилок.
app/grpc_server.go Додано мапінг HTTP StatusTooManyRequests (429) у gRPC-код ResourceExhausted.
controller/email_attempt.go Додано контролер Email-команд з перевіркою прав доступу до email_thread та cc_queue.
controller/email_attempt_test.go Додано юніт-тести для перевірки прав доступу оператора.
gen/cc/cc_member.pb.go Оновлено згенерований Go-код protobuf для Email-команд та відповідей cc_member.

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

🔗 Cross-repo callers змінених символів (40)
  • Enum → mcp_webitel/internal/index/index.go:20
  • Enum → mcp_webitel/internal/index/index.go:38 у Build
  • Enum → mcp_webitel/internal/index/proto.go:155 у ParseProtoFile
  • Enum → mcp_webitel/internal/index/proto.go:304 у parseMessageBody
  • Enum → mcp_webitel/internal/index/proto.go:396 у parseEnumBody
  • Enum → mcp_webitel/internal/index/types.go:21
  • Enum → mcp_webitel/internal/index/types.go:55
  • Enum → mcp_webitel/internal/tools/describe_message.go:97 у findEnums
  • GetAttemptId → flow_manager/app/cc.go:97 у (*FlowManager).JoinIMToInboundQueue (тип ресівера не доведено)
  • GetAttemptId → flow_manager/routes/im/queue.go:163 у (*Router).joinQueue (тип ресівера не доведено)
  • GetAttemptId → flow_manager/store/pg_store/call_store.go:82 у (SqlCallStore).Save (тип ресівера не доведено)
  • GetFlow → mcp_webitel/internal/api/api.go:1305 у (*Handler).flowByID (тип ресівера не доведено)
  • GetId → webitel.go/app/articles.go:589 у (*API).DeleteArticle
  • GetId → webitel.go/app/contacts.go:1536 у (*API).UpdateContact
  • GetId → webitel.go/app/model/contacts/etag.go:77 у (*Tid).GetId
  • GetId → webitel.go/postgres/catalog/contacts.go:378 у (*contactStore).Delete
  • GetId → webitel.go/postgres/catalog/spaces.go:220 у (*spaceStore).Delete
  • GetIss → im-providers-service/internal/whatsapp/gate/gate.server.go:51 у (*whatsAppBusinessAccountServer).CreateWhatsAppGate (тип ресівера не доведено)
  • GetIss → im-providers-service/internal/whatsapp/messaging/messaging.model.go:43 у (*WhatsAppBusinessAccount).DeepClone (тип ресівера не доведено)
  • GetIss → im-providers-service/internal/whatsapp/webhook/webhook.usecase.go:241 у extractPeerFromWhatsAppBusinessAccount (тип ресівера не доведено)
  • GetQueueId → flow_manager/store/pg_store/call_store.go:79 у (SqlCallStore).Save (тип ресівера не доведено)
  • GetResult → engine/grpc_api/call.go:1002 у toEngineHistoryCall (тип ресівера не доведено)
  • GetResult → engine/grpc_api/cc_member.go:925 у (*member).SearchAttempts (тип ресівера не доведено)
  • GetResult → engine/grpc_api/cc_member.go:984 у (*member).ResetActiveAttempts (тип ресівера не доведено)
  • GetRole → webitel.go/postgres/catalog/roles.go:171 у (*Catalog).ReadRole
  • GetSub → im-providers-service/internal/whatsapp/gate/gate.server.go:52 у (*whatsAppBusinessAccountServer).CreateWhatsAppGate (тип ресівера не доведено)
  • GetSub → im-providers-service/internal/whatsapp/messaging/messaging.model.go:44 у (*WhatsAppBusinessAccount).DeepClone (тип ресівера не доведено)
  • GetSub → im-providers-service/internal/whatsapp/messaging/messaging.usecase.go:139 у (*Messaging).prepareOutboundMessageInfo (тип ресівера не доведено)
  • ProtoMessage → webitel.go/app/custom_extensions.go:336 у (CustomExtensionsAPI).CreateType (тип ресівера не доведено)
  • ProtoMessage → webitel.go/app/custom_extensions.go:487 у (CustomExtensionsAPI).UpdateType (тип ресівера не доведено)
  • ProtoReflect → im-account-service/internal/service/updates.go:107 у (*UpdatesManager).PublishUpdate (тип ресівера не доведено)
  • ProtoReflect → im-account-service/internal/service/updates/auth.v1.go:33 у (*UpdateDeviceRegister).ProtoReflect (тип ресівера не доведено)
  • Type → webitel.go/service/custom/data/types.go:9
  • Type → webitel.go/service/custom/internal/types/boolean.go:17
  • Type → webitel.go/service/custom/internal/types/boolean.go:27 у (Boolean).Type
  • Type → webitel.go/service/custom/internal/types/boolean.go:74 у (*BoolValue).Type
  • Type → webitel.go/service/custom/internal/types/cast.go:8 у Cast
  • Type → webitel.go/service/custom/internal/types/datetime.go:22
  • Type → webitel.go/service/custom/internal/types/datetime.go:27 у DateTimeOf
  • Type → webitel.go/service/custom/internal/types/datetime.go:93 у (*DateTimeValue).Type

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