Matheus
f051fe3162
Fecha agente.md secao 54-55 (infraestrutura) e 161 (WebSocket multi-tenant).
Entrega o pipeline de push em tempo real completo — o consumo visual
("Monitoramento -> Filas/Ramais") fica pra fase Frontend.
Requisito central da secao 161 ("nao transmitir tudo e filtrar so no
browser"): RealtimeGateway tem um unico ponto de emissao,
broadcastToTenant(), sempre server.to(`tenant:<id>`), nunca broadcast
global. Cada socket entra na room do proprio tenant no handshake, nunca
escolhe a room.
Autenticacao na conexao (handshake.auth.token, nao Authorization header):
valida o JWT (mesmo verifyAccessToken do JwtAuthGuard), exige tenantId no
token e a permission monitoring.view (ja existia desde RBAC, sem
consumidor ate agora) — mesmo principio de nunca confiar em tenant_id do
client, so do JWT ja emitido por /auth/select-tenant.
Origem dos eventos: canal Redis unico b2bcall:events (o mesmo desde Event
Socket). Dois produtores: b2bcall-fs-events (eventos do FreeSWITCH,
resolvendo tenantId por fan-out quando nao ha channel variable, ver
tenant-resolve.ts) e apps/api (mudancas no nosso Agent.state via
agents-me.controller, tenantId direto do JWT, sem fan-out).
Bug real achado e corrigido ao construir esta fase: nenhum evento CUSTOM do
ESL (sofia::register, sofia::gateway_state, callcenter::info) jamais
chegava em b2bcall-fs-events nesta sessao inteira. Causa: event_json(...)
mandava "CUSTOM" como ultimo token do comando `event json`, sem subclass
depois — mod_event_socket exige os subclasses logo depois do token CUSTOM
no mesmo comando pra serem entregues. Corrigido separando PLAIN_EVENTS
(viram listener .on()) de CUSTOM_SUBCLASSES (so compoem o comando de
assinatura). Resolve as lacunas ja documentadas em docs/TRUNKS.md e
docs/AGENTS.md. De quebra, corrigido um bug de nome de campo
(CC-Agent-Status, que nao existe -> CC-Agent-State) e um segundo bug real
em trunk-sync.ts (rescan nunca descarregava gateway removido -> agora roda
`killgw` antes do rescan).
Novos tipos normalizados a partir de callcenter::info, com nomes de campo
confirmados contra uma fila real: AGENT_OFFERED_CALL, AGENT_BRIDGE_FAILED,
QUEUE_MEMBER_COUNT (chamadas esperando, secao 54), QUEUE_MEMBER_LEFT (com
cause/cancelReason e timestamps — base pra Service Level/Abandon Rate
quando CDR existir).
Verificado ponta a ponta com um client socket.io real: login/pause/resume/
logout emitindo AGENT_STATE_CHANGED; chamada de teste numa fila com agente
logado emitindo QUEUE_MEMBER_COUNT/LEFT, AGENT_OFFERED_CALL,
AGENT_BRIDGE_FAILED, AGENT_STATUS_CHANGED (CC-Agent-State correto); token
ausente/invalido desconectado na hora, sem vazar nenhum evento.
Achado sistemico durante o teste (documentado, nao corrigido nesta fase):
@@unique combinado com soft delete, sem excluir deletedAt, em
Agent/Extension/Trunk/Queue/PauseReason — nao da pra reusar numero/nome/
codigo depois de apagar. Precisa de indice unico parcial em cada um, fora
do escopo desta fase.
typecheck do workspace inteiro limpo. ~144MB de memoria total nos
containers (fs-events 44MB, fs-config 45MB, freeswitch 26MB, postgres
21MB, redis 8MB).
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01X1HxY46WGU4G1zmVDNKcWw
287 lines
18 KiB
Markdown
287 lines
18 KiB
Markdown
# TODO — B2BCall
|
|
|
|
## PHASE 01 — Infrastructure
|
|
- [x] Diagnóstico do servidor (Debian 13, 2 vCPU, ~1.9GB RAM, 26GB disco livre)
|
|
- [x] Docker + Docker Compose instalados
|
|
- [x] Estrutura de monorepo criada (apps/, packages/, infrastructure/, scripts/, docs/)
|
|
- [x] PostgreSQL 18 (docker-compose, porta 127.0.0.1:5432)
|
|
- [x] Redis 7 (docker-compose, porta 127.0.0.1:6379)
|
|
- [x] Secrets gerados em `.env` (POSTGRES_PASSWORD, REDIS_PASSWORD, JWT_SECRET, JWT_REFRESH_SECRET, ENCRYPTION_KEY, ESL_PASSWORD)
|
|
- [x] `FREESWITCH_PAT` configurado em `.env` (não commitado)
|
|
- [x] FreeSWITCH (imagem própria via pacotes SignalWire, não compilada da fonte —
|
|
ver docs/FREESWITCH.md; rodando, saudável, ~44MB RAM, senha ESL customizada,
|
|
nenhuma porta exposta ao host)
|
|
- [ ] nginx (reverse proxy)
|
|
|
|
## PHASE 05 — FreeSWITCH (agente.md secao 232)
|
|
- [x] Imagem própria (`infrastructure/freeswitch/`), pacotes SignalWire (PAT via
|
|
BuildKit secret, nunca na imagem final — verificado com `docker history`)
|
|
- [x] Módulos mínimos carregados: sofia, event_socket, commands, dptools,
|
|
callcenter, avmd, curl, local_stream, etc. (mod_xml_curl instalado mas
|
|
desativado até existir b2bcall-fs-config)
|
|
- [x] Senha do Event Socket trocada da padrão via entrypoint runtime (nunca
|
|
fica na imagem); porta 8021 não publicada no host
|
|
- [x] docs/FREESWITCH.md, docs/NETWORK_ARCHITECTURE.md (decisão de
|
|
network_mode adiada pra quando existir tronco SIP real)
|
|
- [ ] Diretório/dialplan ainda são os estáticos da config vanilla (ramais de
|
|
teste 1000-1019, senhas fracas) — substituir por mod_xml_curl na fase
|
|
Extensions/Trunks/Dialplan
|
|
|
|
## PHASE 06 — Event Socket (agente.md secao 21-25, 195)
|
|
- [x] `packages/telephony`: interface `TelephonyProvider` + `FreeSwitchTelephonyProvider`
|
|
(sobre a lib `esl`, reconexão com backoff já embutida na lib)
|
|
- [x] `normalizeEslEvent()`: eventos ESL crus → vocabulário interno (secao 24)
|
|
- [x] `apps/freeswitch-events` (b2bcall-fs-events): conexão ESL permanente,
|
|
resubscreve a cada reconexão, publica eventos normalizados no canal Redis
|
|
`b2bcall:events`
|
|
- [x] Achado: FreeSWITCH 1.11 aplica ACL implícita (só loopback) sem
|
|
`apply-inbound-acl` — bloqueava conexão de outro container mesmo com
|
|
senha certa. Corrigido com ACL própria cobrindo loopback + rede Docker.
|
|
- [x] Testado ponta a ponta com chamada loopback local: CALL_CREATED →
|
|
CALL_ANSWERED → CALL_ENDED corretos no Redis
|
|
- [ ] Reconciliação pós-reconexão (calls/agents/queues/registrations/gateways)
|
|
— não é possível ainda, sem essas tabelas persistidas
|
|
|
|
## PHASE 07 — XML Curl (agente.md secao 26)
|
|
- [x] `apps/freeswitch-config` (b2bcall-fs-config): responde ao protocolo
|
|
XML Curl do FreeSWITCH (POST form-encoded → XML), containerizado
|
|
- [x] `mod_xml_curl` reativado, binding restrito a `directory|dialplan`
|
|
(não `configuration` — evita chamadas HTTP desnecessárias no boot)
|
|
- [x] Por enquanto sempre "not found" (sem tabela extensions/dialplan ainda);
|
|
verificado que a config estática vanilla continua funcionando como
|
|
fallback (`user/8888` → SUBSCRIBER_ABSENT via fs-config,
|
|
`user/1000` → USER_NOT_REGISTERED via config estática — achou o usuário)
|
|
- [ ] Sem autenticação HTTP ainda — ok enquanto só responde "not found";
|
|
adicionar `gateway-credentials` antes de servir directory/dialplan reais
|
|
|
|
## PHASE 02 — SaaS Core
|
|
- [x] Monorepo Node.js/TypeScript (pnpm workspaces, tsconfig base)
|
|
- [x] Node 22 LTS + pnpm instalados no host
|
|
- [x] `packages/database` (Prisma 7 + driver adapter `pg`, migration inicial)
|
|
- [x] `packages/types` (TenantStatus, AgentState), `packages/shared`
|
|
- [x] Tabela `tenants` criada via migration (seção 29 do agente.md)
|
|
|
|
## PHASE 03 — Tenant Isolation
|
|
- [x] Tabelas `users` + `tenant_memberships` (tenant-scoped)
|
|
- [x] RLS (`ENABLE`/`FORCE ROW LEVEL SECURITY` + policy) em `tenant_memberships`
|
|
- [x] Tenant context via `set_config('app.current_tenant_id', ..., true)` (transaction-local)
|
|
- [x] Helper `withTenantContext()` em `packages/database`
|
|
- [x] Role de banco separado para runtime (`b2bcall_app`, sem SUPERUSER/BYPASSRLS) —
|
|
achado crítico: o role padrão do Docker Postgres é SUPERUSER e SEMPRE ignora RLS,
|
|
até com FORCE. Ver `docs/TENANT_ISOLATION.md`.
|
|
- [x] Teste automatizado de isolamento (`pnpm --filter @b2bcall/database run test:isolation`)
|
|
|
|
## PHASE 04 — Authentication / RBAC
|
|
- [x] `packages/auth`: hash Argon2id (`@node-rs/argon2`), JWT access token (`jose`),
|
|
refresh token opaco com rotation
|
|
- [x] Tabelas `roles`, `permissions`, `role_permissions`, `user_roles`, `sessions`, `audit_logs`
|
|
- [x] `login()` / `refreshSession()` / `logout()` / `listUserTenants()` / `setActiveTenant()`
|
|
- [x] `userHasPermission()` (RBAC com scope PLATFORM/TENANT)
|
|
- [x] Seed: catálogo de permissions + roles de sistema + Platform Super Admin inicial
|
|
(senha em `FIRST_LOGIN.txt`, fora do Git, `mustChangePassword=true`)
|
|
- [x] Teste automatizado (`pnpm --filter @b2bcall/auth run test:auth`)
|
|
- [x] `apps/api` (NestJS + Fastify): endpoints de auth, JwtAuthGuard, DomainExceptionFilter,
|
|
rate limit de login via Redis (5/min por IP e por e-mail), helmet/cors, health checks
|
|
— testado ponta a ponta com curl (login, refresh rotation, logout, RBAC, 401/403/429)
|
|
- [ ] Password reset por e-mail — depende de SMTP configurado
|
|
|
|
## PHASE 08 — Extensions (agente.md secao 39-40, 178)
|
|
- [x] Tabela `extensions` (tenant-scoped, RLS) — number, sip_password_enc,
|
|
caller_id, context, sofia_profile, codecs, max_registrations
|
|
- [x] `packages/shared/src/crypto.ts`: AES-256-GCM (senha SIP cifrada em
|
|
repouso), `generateStrongPassword()`, `maskSecret()`
|
|
- [x] `apps/api/src/extensions`: CRUD (POST/GET/GET:id/DELETE), RBAC via novo
|
|
`PermissionGuard` genérico (`@RequirePermission`), tenant só do JWT
|
|
- [x] Senha SIP só aparece em texto puro na resposta do POST, nunca depois
|
|
(destructuring explícito, não spread — evita vazamento por acidente)
|
|
- [x] `b2bcall-fs-config` resolve directory real: Tenant.telephonyDomain →
|
|
Extension.number, decifra a senha, monta XML com dial-string
|
|
- [x] `Tenant.telephonyDomain` fixo (`b2bcall.local`) via patch no `vars.xml`
|
|
do FreeSWITCH — antes usava o IP dinâmico do container, instável
|
|
- [x] HTTP Basic auth entre FreeSWITCH e fs-config (`gateway-credentials`,
|
|
timingSafeEqual) — adicionada nesta mesma fase, não deixada pendente
|
|
- [x] Testado ponta a ponta: criar ramal → `user/1500` dá USER_NOT_REGISTERED
|
|
(achou, sem telefone) → deletar → volta a SUBSCRIBER_ABSENT
|
|
- [x] Achado: `PermissionGuard` injetando `Reflector` via construtor dava
|
|
`undefined` em runtime rodando via `tsx`/esbuild (emissão de metadata
|
|
de tipo não é 100% confiável cross-file) — corrigido com `@Inject()`
|
|
explícito; atenção pra isso em guards/services futuros
|
|
- [ ] Quota de ramais — depende de Plans/Entitlements (não existe ainda)
|
|
- [ ] Multi-domínio real por tenant — hoje só um domínio fixo pra todos
|
|
|
|
## PHASE 09 — Trunks (agente.md secao 41-42)
|
|
- [x] Tabela `trunks` (tenant-scoped, RLS) — host/proxy/realm, register,
|
|
username/password_enc (AES-256-GCM), dtmf_mode, ping, transport,
|
|
status/status_updated_at
|
|
- [x] `apps/api/src/trunks`: CRUD (POST/GET/GET:id/DELETE), mesmo padrão de
|
|
RBAC/tenant de Extensions, senha nunca exposta em nenhum GET
|
|
- [x] `packages/telephony`: `buildGatewayXml()` (XML de gateway Sofia)
|
|
- [x] `b2bcall-fs-config`: gera `sip_profiles/external/<trunk_id>.xml` (volume
|
|
Docker compartilhado com o FreeSWITCH) e roda `sofia profile external
|
|
rescan` via ESL — sincroniza no boot e sob demanda via Redis pub/sub
|
|
(`b2bcall:trunks:sync`, publicado pela API a cada create/delete)
|
|
- [x] Achado: 1º sync no boot corria antes da conexão ESL terminar de se
|
|
estabelecer (erro cosmético) — corrigido com
|
|
`FreeSwitchTelephonyProvider.waitUntilConnected()`
|
|
- [x] Testado ponta a ponta com host fake: criar trunk → arquivo gerado →
|
|
`sofia status gateway` mostra o gateway real (FAIL_WAIT, esperado) →
|
|
deletar → arquivo removido (limpeza também tirou o `example.com` da
|
|
vanilla que tinha sido copiado pro volume — comportamento correto)
|
|
- [ ] **Lacuna real, não resolvida**: `Trunk.status` deveria ser atualizado
|
|
via eventos `sofia::gateway_state` (código escrito em
|
|
`apps/freeswitch-events/src/trunk-status.ts`, baseado no mesmo
|
|
`normalizeEslEvent` já testado pra eventos CHANNEL_*), mas o evento
|
|
**não foi observado chegando** em ~90s de monitoramento mesmo com o
|
|
gateway mudando de estado de verdade no FreeSWITCH (FAIL_WAIT/DOWN).
|
|
Os eventos `sofia::*` (CUSTOM) nunca foram provados funcionando nesta
|
|
sessão — só CHANNEL_* foi verificado de ponta a ponta até agora.
|
|
Precisa de investigação com um alvo SIP real (outro FreeSWITCH, por
|
|
exemplo) antes de confiar em atualização automática de status em
|
|
produção. Ver docs/TRUNKS.md.
|
|
- [ ] Quota de troncos — depende de Plans/Entitlements (não existe ainda)
|
|
|
|
## PHASE 10 — Dialplan (agente.md secao 43-44)
|
|
- [x] `dialplan_extensions` (tenant-scoped, RLS) — editor estruturado:
|
|
context, condition field/expr, actions/anti-actions (JSON), continue,
|
|
order, enabled
|
|
- [x] `dialplan_versions` (tenant-scoped, RLS) — gerar/validar/versionar/
|
|
ativar; reativar versão antiga = rollback (sem endpoint separado)
|
|
- [x] `apps/api/src/dialplan`: extensions CRUD + `versions/generate` +
|
|
`versions/:id/activate`, permissions `freeswitch.view`/`.configure`
|
|
- [x] Allowlist de applications seguras (`ALLOWED_DIALPLAN_APPLICATIONS`,
|
|
sem `system`/`exec`/etc — agente.md secao 180)
|
|
- [x] `b2bcall-fs-config` serve a versão ACTIVE dinamicamente por chamada
|
|
(resolve tenant via `variable_b2bcall_tenant_id`, não domain — não
|
|
sofre da limitação de multi-domínio do directory)
|
|
- [x] Testado ponta a ponta: criar extension → gerar v1 → ativar → originate
|
|
passando pelo dialplan de verdade → CALL_CREATED/ANSWERED/ENDED com
|
|
tenantId correto. Criar v2 → ativar (v1 vira SUPERSEDED) → reativar v1
|
|
(rollback, v2 vira SUPERSEDED). Tudo confirmado via API.
|
|
|
|
- [x] **ACHADO CRÍTICO, corrigido nesta fase**: testando a allowlist com
|
|
`application: "system"`, a API aceitou (201) — `ValidationPipe` do
|
|
Nest estava **completamente inoperante** em toda `apps/api` desde que
|
|
ela foi criada (todo `@Body()`, todos os controllers) porque `tsx`
|
|
(esbuild) não emite `design:paramtypes` corretamente pra tipos
|
|
importados de outro arquivo, e o Nest pula validação silenciosamente
|
|
quando não reconhece o tipo. Corrigido: `apps/api` agora builda com
|
|
`tsc` de verdade antes de rodar (`tsc && tsx dist/main.js`) — nunca
|
|
mais `tsx src/main.ts` direto. Ver docs/VALIDATION_PIPE_BUG.md.
|
|
Reverificado com 2 testes deliberados pós-correção, ambos
|
|
corretamente rejeitados com 400.
|
|
- [ ] Só 1 condition por extension (simplificação) — FreeSWITCH suporta
|
|
múltiplas em sequência, não implementado
|
|
- [ ] `dialplan.view`/`.manage` não existem — reusei `freeswitch.*`
|
|
|
|
## PHASE 11 — mod_callcenter / Queues (agente.md secao 37, 50-51)
|
|
- [x] Investigado `help callcenter_config` real antes de codar: filas só
|
|
têm `load`/`unload`/`reload` (XML estático + reload, sem `queue add`);
|
|
agentes e tiers são 100% dinâmicos via comando ESL (`agent add`,
|
|
`tier add`) — próxima fase, sem arquivo nenhum
|
|
- [x] `queues` table (tenant-scoped, RLS) — strategy, moh/announce,
|
|
wait times, tier rules, discard/abandoned, skip-external-calls,
|
|
recording_enabled
|
|
- [x] `packages/telephony`: `buildQueueXml()`
|
|
- [x] `overrides/autoload_configs/callcenter.conf.xml` própria (zera
|
|
agents/tiers estáticos da vanilla, inclui
|
|
`callcenter_queues.conf.d/*.xml` via X-PRE-PROCESS)
|
|
- [x] `apps/api/src/queues`: CRUD (POST/GET/GET:id/DELETE), permissions
|
|
`queues.view`/`.manage`
|
|
- [x] `b2bcall-fs-config` (`queue-sync.ts`): 1 arquivo por fila (volume
|
|
compartilhado), sincroniza via Redis pub/sub (`b2bcall:queues:sync`)
|
|
- [x] Achado real, confirmado testando manualmente antes de escrever código:
|
|
`queue load` falha se o arquivo foi adicionado depois do boot —
|
|
precisa de `reloadxml` primeiro; depois disso, `queue reload` sozinho
|
|
serve tanto pra criar quanto atualizar
|
|
- [x] Testado ponta a ponta: criar fila (ROUND_ROBIN, maxWaitTime=120,
|
|
discardAbandonedAfter=90) → `callcenter_config queue list` mostra os
|
|
parâmetros corretos → deletar → lista volta vazia
|
|
- [ ] Agentes/Tiers/Pausas (secao 45-49) — próxima fase
|
|
- [ ] Monitoramento em tempo real (secao 54) — depende de WebSocket
|
|
- [ ] Quota de filas — depende de Plans/Entitlements
|
|
|
|
## PHASE 12 — Agentes, Tiers, Pausas (agente.md secao 45-49, 52)
|
|
- [x] `agents`/`tiers`/`agent_sessions`/`agent_state_events`/
|
|
`pause_reasons`/`agent_pause_events` (tenant-scoped, RLS) — separa
|
|
User/Agent/Extension (secao 45)
|
|
- [x] Corrigidos bugs reais em `FreeSwitchTelephonyProvider` (nunca
|
|
testados antes): `addAgentToQueue`/`removeAgentFromQueue` usavam
|
|
"queue add/del member", que **não existe** — comando certo é
|
|
`tier add`/`tier del`. Adicionados `addAgent`/`removeAgent`
|
|
(`agent add`/`agent del`), que faltavam por completo.
|
|
- [x] Confirmado manualmente antes de codar: `agent add`/`tier add`
|
|
duplicado dá erro ("already exist", capturado e ignorado no sync);
|
|
`agent del`/`tier del` em algo inexistente não dá erro; `agent set
|
|
status` só aceita `Available`/`On Break`/`Logged Out`
|
|
- [x] Sync 100% dinâmico via ESL (sem arquivo, diferente de Trunks/Queues):
|
|
`b2bcall:agents:sync`/`b2bcall:tiers:sync` (Redis pub/sub com payload
|
|
por ação, não um resync geral)
|
|
- [x] `apps/api`: `/agents` (CRUD provisionamento), `/agents/me/login|
|
|
logout|pause|resume` (sempre sobre o agente do usuário autenticado,
|
|
nunca um id arbitrário do client), `/pause-reasons`,
|
|
`/queues/:id/agents` (tier assignment)
|
|
- [x] Achado de corrida real, visto no teste ponta a ponta: atribuir tier
|
|
antes do primeiro login falha (agente ainda não existe no
|
|
FreeSWITCH) — login sempre re-sincroniza todos os tiers do agente,
|
|
autocorrigindo. Confirmado acontecendo exatamente assim no teste.
|
|
- [x] Testado ponta a ponta os 4 estados: login→Available, pause→On Break,
|
|
resume→Available, logout→Logged Out — todos confirmados batendo
|
|
entre `Agent.state` (banco) e `callcenter_config agent list`
|
|
(FreeSWITCH)
|
|
- [x] Estados derivados de chamada (RINGING/IN_CALL/WRAP_UP/RESERVED) —
|
|
mecanismo de entrega do `callcenter::info` corrigido e confirmado
|
|
(ver PHASE 13); persistir em `Agent.state` ainda não implementado
|
|
- [ ] `PauseReason.maxDuration` não é aplicado automaticamente
|
|
- [ ] Quota de agentes — depende de Plans/Entitlements
|
|
- [ ] Achado sistêmico: `@@unique` combinado com soft delete (sem excluir
|
|
`deletedAt`) em `Agent`/`Extension`/`Trunk`/`Queue`/`PauseReason` —
|
|
não dá pra reusar número/nome/código depois de apagar. Precisa de
|
|
índice único parcial em cada um, migration própria (ver docs/AGENTS.md)
|
|
|
|
## PHASE 13 — Realtime Monitoring / WebSocket multi-tenant (agente.md secao 54-55, 161)
|
|
- [x] **Bug real, achado nesta fase**: nenhum evento CUSTOM do ESL
|
|
(`sofia::register`, `sofia::gateway_state`, `callcenter::info`) jamais
|
|
chegava em `b2bcall-fs-events` — `event_json(...)` mandava `"CUSTOM"`
|
|
como último token do comando `event json`, sem subclass depois
|
|
(mod_event_socket exige os subclasses logo depois do token CUSTOM no
|
|
mesmo comando). Corrigido separando `PLAIN_EVENTS`/`CUSTOM_SUBCLASSES`.
|
|
Resolve as lacunas documentadas em PHASE 09/12 e docs/TRUNKS.md/AGENTS.md.
|
|
- [x] Corrigido de quebra: `CC-Agent-Status` (não existe) → `CC-Agent-State`
|
|
(campo real); novos tipos normalizados `AGENT_OFFERED_CALL`,
|
|
`AGENT_BRIDGE_FAILED`, `QUEUE_MEMBER_COUNT`, `QUEUE_MEMBER_LEFT`
|
|
- [x] Corrigido de quebra: `sofia profile external rescan` nunca descarregava
|
|
um gateway cujo arquivo foi apagado (fantasma na memória do Sofia) —
|
|
`trunk-sync.ts` agora roda `killgw <nome>` pra cada gateway removido
|
|
- [x] `tenant-resolve.ts` (fs-events): resolve tenantId por fan-out
|
|
(agente/fila não carregam `b2bcall_tenant_id` — só existe a partir do
|
|
Predictive Engine), cacheado por id
|
|
- [x] `apps/api`: `RealtimeGateway` (socket.io sobre o Fastify HTTP server),
|
|
auth via JWT no handshake (`monitoring.view`), uma room por tenant
|
|
(`tenant:<id>`) — nunca broadcast global, sempre `server.to(room)`
|
|
(secao 161: tenant-scoped no servidor, nunca filtrar só no browser)
|
|
- [x] `RealtimeRedisBridge`: assina `b2bcall:events` (canal único, mesmo
|
|
usado desde Event Socket), reencaminha pro tenant certo
|
|
- [x] `AGENT_STATE_CHANGED` publicado direto de `agents-me.controller.ts`
|
|
(login/logout/pause/resume) — tenantId já vem do JWT, sem fan-out
|
|
- [x] Testado ponta a ponta: login/pause/resume/logout via WS, chamada de
|
|
teste numa fila real (QUEUE_MEMBER_COUNT/LEFT, AGENT_OFFERED_CALL,
|
|
AGENT_BRIDGE_FAILED, AGENT_STATUS_CHANGED com CC-Agent-State correto),
|
|
token inválido desconectado na hora
|
|
- [ ] Ramais/extensões (secao 55 completa: busy/registro) — precisa de SIP
|
|
real pra testar, e extrair ramal dos headers de canal (não feito)
|
|
- [ ] TME/TMA/Service Level/Abandon Rate — dependem de CDR (fase futura)
|
|
- [ ] Snapshot/reconciliação ao reconectar o WebSocket
|
|
|
|
## PHASE 14+ — ver `agente.md` seções 56 em diante (Predictive Dialer,
|
|
Recordings, AI, Billing, Frontend, Reports, Security, Tests)
|
|
|
|
---
|
|
|
|
## Riscos conhecidos
|
|
- **RAM da VM (1.9GB total)**: medido com Postgres+Redis+FreeSWITCH rodando juntos —
|
|
~91MB no total (Postgres 37MB, Redis 10MB, FreeSWITCH 44MB), bem tranquilo. O risco
|
|
real ainda não testado é o build/runtime do Next.js (frontend) e vários workers Node
|
|
simultâneos — reavaliar quando chegarmos lá.
|
|
- **Disco (26GB livre)**: build do FreeSWITCH + imagens Docker + gravações vão consumir
|
|
espaço rápido. Monitorar com `df -h`.
|