Fase 9 (segurança e produção):
- GET /api/metrics: endpoint Prometheus com métricas reais (chamadas,
agentes, filas, CPS por campanha), protegido por permissão
- scripts/backup.sh, restore.sh, healthcheck.sh, install.sh, update.sh —
testados contra o ambiente real (backup.sh e healthcheck.sh rodados de
verdade; install.sh/update.sh validados por inspeção, ambiente atual já
provisionado)
- POST /api/agent-console/dispose: aplica disposição de chamada de verdade
(lacuna deixada aberta desde a Fase 6), com ações CALLBACK (agenda
retorno) e DO_NOT_CALL (suprime automaticamente)
- apps/dialer-worker/src/callback-sweep.ts: reativa leads com callback
vencido; GET /api/callbacks para consulta
- apps/dialer-worker/src/wrap-up-sweep.ts: transição automática
WRAP_UP -> AVAILABLE + despausa real na fila do Asterisk. Exigiu corrigir
main.ts para conectar ao AMI mesmo em DIALER_SIMULATION=true
(DIALER_SIMULATION deve impedir só originação de chamada, não ações
administrativas de fila)
- nftables revisado (sem alterações necessárias)
- Documentação completa: INSTALL, OPERATIONS, BACKUP_RESTORE, SECURITY,
DATABASE, API, ASTERISK, OPENSIPS (não implementado, motivo
documentado), TROUBLESHOOTING
- README.md e CHANGELOG.md reescritos
Fase 10 (testes e aceite):
- Quality gate completo executado: build/typecheck (7 workspaces), lint,
46 testes unitários, docker compose config/ps, healthcheck — tudo verde
- Aceite de segurança (seção 92): 13 itens verificados ao vivo contra o
sistema real, não só por inspeção de código
- Aceite Asterisk (seção 93): os 5 comandos executados e documentados,
comunicação API->AMI->Asterisk validada
- docs/RELATORIO_FINAL.md: relatório final no formato da seção 96
Todos os fixtures de teste desta fase foram removidos/desativados ao
final. Credenciais de acesso entregues separadamente em CREDENCIAIS.txt
(fora do git, nunca versionado).
- apps/frontend: Next.js 15 (App Router) + Tailwind v4 + componentes estilo
shadcn/ui sobre Radix UI + TanStack Query. Tema light/dark, logo
processada. Menu completo (secao 52) com gating por permissao real.
Todas as telas do checklist de aceite (secao 90) conectadas a endpoints
reais (nao mockup): login, usuarios, perfis/permissoes, ramais/troncos,
dialplan, filas/agentes, console do agente, campanhas (CPS/CSV/
iniciar/pausar), monitoramento ao vivo (polling, nao WebSocket real),
TME/TMA, busca/export de chamadas, administracao do Asterisk, auditoria
- infrastructure/nginx: reverse proxy colocando frontend+API na mesma
origem (porta 80), antecipado da Fase 9 pois a API nao publica porta
propria
- apps/api: GET /api/monitoring/agents (estado corrente real via
agent_state_events em aberto) e filtro queueId em GET /api/reports/calls
Pendencia registrada: tela de Callbacks nao implementada (schema existe
desde a Fase 6, mas nunca houve controller/service — construir a tela sem
API real seria mockup). Verificacao visual em navegador nao foi possivel
neste ambiente headless; validado via tsc/eslint/next build limpos + curl
reproduzindo as chamadas do navegador (middleware de auth, 24 paginas
protegidas via Nginx, endpoints de dados com cookie de sessao).
- apps/dialer-worker: motor do discador preditivo completo
- predictive-engine.ts: EWMA de answerProbability/avgTalkTimeSeconds/
abandonRate, previsao de liberacao de agentes, calculo de quantas
chamadas originar. Logica pura, 14 testes unitarios
- cps-limiter.ts: token bucket via script Lua atomico no Redis (dois
buckets independentes campanha+tronco, min() dos dois, seguro com
multiplos workers)
- lead-repository.ts: reserva atomica via FOR UPDATE SKIP LOCKED,
recuperacao de reservas orfas apos queda de worker
- campaign-lock.ts: lock distribuido por campanha (Redis SET NX PX +
token de posse, renovacao/liberacao seguras via Lua)
- schedule.ts: janela de horario da campanha (timezone real via
Intl.DateTimeFormat, dias da semana), 6 testes unitarios
- retry-rules.ts: motor de retentativa por causa de encerramento,
configuravel por campanha, nunca infinito
- simulation.ts + campaign-worker.ts (modo DIALER_SIMULATION): permite
testar o motor inteiro sem tronco de operadora real
- simulation-harness.ts: reproduz em tempo discreto e deterministico o
cenario exato de aceite da secao 66 (20 agentes/10 CPS/30% atendimento/
TMA 180s) — 6 testes validando CPS nunca excedido, concorrencia nunca
excedida, pacing nao diverge
- campaign-worker.ts: orquestra tudo contra Postgres/Redis/Asterisk reais
- docs/PREDICTIVE_DIALER.md: algoritmo documentado, incluindo dois bugs
reais encontrados e corrigidos durante o teste do cenario de aceite
(concorrencia nao contava chamadas em atendimento; pacing subia sem
limite durante periodos ociosos, causando rajada maxima assim que um
agente ficava livre) e limitacoes conhecidas (AMD e wrap-up automatico
via eventos reais ainda pendentes, documentados sem esconder)
Testado ponta a ponta contra containers reais (Postgres/Redis/Asterisk):
campanha completa criada -> agente disponivel via API -> leads importados
-> campanha iniciada -> reserva atomica -> CPS respeitado -> simulacao de
NO_ANSWER (retry agendado) e ANSWERED (AGENT_CONNECTED, EWMA atualizada ao
vivo) -> parada sem derrubar chamadas em andamento.
- packages/database: Campaign, LeadImport, Lead, DialAttempt,
CallDisposition, Callback, SuppressionEntry (agente.md secao 53)
- packages/shared: normalizePhone (BR, E.164) com 7 testes unitarios
- apps/api/src/campaigns: CRUD completo (todos os campos da secao 24) com
maquina de estados validada (DRAFT/READY/RUNNING/PAUSED/DRAINING/
STOPPED/COMPLETED) — edicao bloqueada com campanha RUNNING
- apps/api/src/leads: import CSV via streaming multipart (deteccao
automatica de delimitador, mapeamento de coluna por header, validacao+
normalizacao+dedupe em lotes de 500, CSV de rejeitados com motivo, modo
dryRun para preview)
- apps/api/src/suppression: CRUD + import CSV da lista de bloqueio,
remocao sempre exige motivo e e auditada, isSuppressed() pronto para o
dialer-worker checar antes de originar
- apps/api/src/dispositions: CRUD de disposicoes de chamada
Testado ponta a ponta: campanha criada com defaults corretos, import de
CSV real (3 validos/1 invalido/1 duplicado, contadores batendo), leads
persistidos com telefone normalizado, transicoes de estado da campanha
rejeitando movimentos invalidos (PAUSED->PAUSED = 400).
- apps/api/src/telephony: TelephonyModule (conexao AMI da API para
comandos de controle) + PjsipRealtimeService (unico ponto de escrita nas
tabelas realtime do schema 'asterisk' via Prisma $executeRaw
parametrizado)
- apps/api/src/trunks: CRUD completo (tipos IP/AUTH/REGISTRATION), secret
cifrado em repouso (AES-256-GCM), endpoint de teste de status via
PJSIPShowContacts/pjsip show registration
- apps/api/src/extensions: CRUD completo, senha SIP gerada
automaticamente, endpoint de reset, nunca reexibe a senha apos a criacao
- apps/api/src/monitoring: GET /api/monitoring/extensions com prioridade
de cor (agente.md secao 15) a partir do ExtensionState alimentado por
apps/asterisk-events
- health check agora reporta status real do Asterisk/AMI via heartbeat do
asterisk-events no Redis, sem precisar de conexao AMI propria para isso
Testado ponta a ponta contra o Asterisk real: ramal e tronco criados via
API aparecem imediatamente via 'pjsip show endpoint' sem reload (realtime
funcionando), secret nunca retornado pela API, exclusao em cascata
confirmada (ps_endpoints/ps_auths/ps_aors/ps_contacts/ps_registrations).
- packages/telephony: cliente AMI proprio sobre TCP puro (sem dependencia
de terceiros pouco mantida) + interface TelephonyProvider +
AsteriskTelephonyProvider (Originate, Hangup, QueuePause/Add/Remove,
QueueStatus, ExtensionState, DeviceState, PJSIPShowEndpoints/Contacts,
Reload, runCommand, stream de eventos). Testado contra o Asterisk real —
o formato de resposta do Command mudou entre versoes do Asterisk
(headers 'Output:' repetidos em vez de 'Response: Follows'/'--END
COMMAND--'), corrigido apos inspecionar os bytes crus do protocolo
- apps/asterisk-events: worker dedicado a manter a conexao AMI viva,
normalizar eventos (Newchannel, DialBegin/End, Hangup, DeviceStateChange,
ContactStatus, eventos de fila/agente), persistir ExtensionState no
Postgres e publicar em Redis pub/sub para consumo em tempo real.
Containerizado, alcanca o Asterisk (host network) via
host.docker.internal a partir da rede bridge. Heartbeat no Redis para
health check
- packages/database: novos modelos Trunk, Extension, ExtensionState
(migration aplicada)
- packages/shared: secret-crypto.ts (AES-256-GCM para credenciais de trunk
e senha SIP em repouso, master key externa ao banco)
Testado ponta a ponta: chamada real originada -> eventos normalizados
recebidos via Redis SUBSCRIBE, heartbeat renovando no TTL correto.
- packages/database: schema Prisma (users/sessions/roles/permissions/
user_roles/role_permissions/audit_logs/password_reset_tokens), migration
inicial e seed (permissoes+perfis+bootstrap super_admin com senha
aleatoria em FIRST_LOGIN.txt). Decisao de ORM (Prisma) documentada em
docs/ARCHITECTURE.md
- packages/shared: catalogo de permissoes (fonte unica usada por seed e API)
- apps/api: NestJS 11 + Fastify
- autenticacao: Argon2id, access JWT + refresh token opaco com rotacao,
cookies HttpOnly/SameSite=Lax, change/forgot/reset password
- rate limiting progressivo de login via Redis (bloqueio crescente por IP)
- RBAC reforcado no backend (PermissionsGuard), protecao contra
auto-elevacao de privilegio
- auditoria (audit_logs) nas acoes sensiveis, com redacao de segredos
- health checks reais (postgres+redis), swagger desabilitavel, logs
estruturados JSON com request_id de correlacao, filtro global de
excecoes sem vazar erro cru
- infrastructure/docker/api.Dockerfile: build multi-stage do monorepo pnpm
- docker-compose.yml: servico api na rede interna, sem porta publicada
Testado via containers reais: login, /me, refresh, change-password,
rate limit (7 tentativas -> 429), RBAC (nega/permite), bloqueio de
auto-elevacao (403), audit log populado, health checks, lint e testes
unitarios passando.
