b2bcall/TODO.md

# B2BCall — TODO Operacional

Checklist vivo. Marcar `[x]` somente após testar. Não deixar item concluído sem
validação. Ver critérios de aceite completos em `docs/ARCHITECTURE.md` e no prompt
mestre original (`agente.md`, seções 90-93).

## Fase 0 — Infraestrutura base
- [x] Levantamento do servidor (SO, recursos, rede)
- [x] docs/ARCHITECTURE.md
- [x] TODO.md
- [x] Git init + .gitignore + primeiro commit
- [x] Instalar Docker Engine + Compose plugin (29.7.2 / Compose v5.5.0)
- [x] Estrutura de diretórios do monorepo
- [x] .env.example (+ scripts/generate-secrets.sh, .env real gerado localmente)
- [ ] nftables (firewall base, default-deny administrativo, sem bloquear SSH) —
      adiado para a Fase 9, quando houver serviços/portas reais a proteger

## Fase 1 — Dados e cache
- [x] docker-compose: serviço postgres 17-alpine (schemas application/asterisk) — testado, healthy
- [x] docker-compose: serviço redis 7-alpine (auth, AOF, maxmemory 100mb) — testado, healthy
- [x] Health checks postgres/redis
- [ ] packages/database: schema inicial + migrations tool

## Fase 2 — Asterisk
- [x] Dockerfile Asterisk 22.10.1 LTS compilado do fonte (host network) —
      Debian trixie não tem mais o pacote `asterisk` nos repos oficiais
- [x] PJSIP (transport UDP:5060; chan_sip nem existe mais a partir do Ast 21)
- [x] AMI habilitado — testado login via 127.0.0.1:5038, bloqueado na LAN via nftables
- [x] ARI habilitado — testado GET /ari/asterisk/info via 127.0.0.1:8088, 401 sem auth
- [x] Realtime ODBC -> Postgres schema `asterisk` (sorcery.conf + extconfig.conf
      + res_odbc.conf) — `pjsip show endpoints` consulta o Postgres sem erro
- [x] CDR via cdr_adaptive_odbc — testado, grava em asterisk.cdr (ANSWERED,
      duration/billsec corretos). Nota: coluna `end` renomeada para
      `end_time` (palavra reservada no Postgres, cdr_adaptive_odbc não
      quota identificadores)
- [x] CEL via cel_odbc — testado, grava em asterisk.cel (CHAN_START/ANSWER/
      HANGUP/CHAN_END)
- [x] queue_log habilitado (padrão do app_queue, arquivo em /var/log/asterisk)
- [x] Dialplan inicial de teste (contexto `b2bcall-healthcheck`, exten 600,
      Answer/Playback/Echo) — testado via `channel originate ... extension`
- [x] nftables protegendo AMI/ARI/SIP na interface da LAN (ens18), trazido da
      Fase 9 para já — não testado a partir de outra máquina na LAN (só
      localmente, onde tráfego para o próprio IP vai por `lo` e não
      exercita a regra; revisar quando OpenSIPS/outro host estiver disponível)

### Pendências conhecidas da Fase 2 (não bloqueiam, revisitar depois)
- [ ] `res_pjsip_outbound_registration` recusa carregar no boot (mensagem
      "no existing documentation" para o tipo 'registration' do sorcery) —
      carregamento manual via `module load` funciona mas é desfeito por uma
      flag interna de "declined at boot". Só afeta troncos com registration
      outbound; endpoints/aors funcionam normalmente. Investigar na Fase 4
      ao implementar cadastro de troncos com registration.
- [ ] `res_config_ldap` gera ERROR de log no boot (sem LDAP configurado,
      não usamos). Cosmético — considerar `noload` em modules.conf.
- [ ] `cdr_pgsql`/`cel_pgsql` não compilaram (falta libpq-dev na imagem);
      usamos `cdr_adaptive_odbc`/`cel_odbc` como alternativa funcional via
      ODBC — decisão adequada, não precisa dos módulos pgsql nativos.

## Fase 3 — Backend base
- [ ] apps/api (NestJS + Fastify) bootstrap
- [ ] Autenticação (Argon2id, access+refresh, cookies HttpOnly)
- [ ] Rate limiting (login e endpoints sensíveis)
- [ ] RBAC (users/roles/permissions/user_roles/role_permissions) + tela de perfis
- [ ] Auditoria (audit_logs) + interceptor genérico
- [ ] Health checks /api/health(/live|/ready)
- [ ] Swagger/OpenAPI (desabilitável em produção)

## Fase 4 — Telefonia (camada de aplicação)
- [ ] packages/telephony: TelephonyProvider + AsteriskTelephonyProvider
- [ ] apps/asterisk-events (AMI listener, normalização, persistência, pub/sub)
- [ ] CRUD Troncos (com CPS máximo, ACL, teste de status)
- [ ] CRUD Ramais (senha SIP gerada, reset, status tempo real)
- [ ] Painel visual de Ramais (WebSocket, prioridade de cores)
- [ ] Dialplan estruturado (versionado, modo Advanced, validação+rollback)
- [ ] Administração do Asterisk (abas: geral, pjsip, rtp, filas, cdr, cel, logs,
      ami, ari, modules, diagnóstico com allowlist de comandos)

## Fase 5 — Call Center
- [ ] Agentes (agents, agent_sessions) separados de users
- [ ] Máquina de estados do agente (OFFLINE..PAUSED)
- [ ] Motivos de pausa (CRUD)
- [ ] Filas (CRUD + estratégias documentadas)
- [ ] Tela do agente (login dinâmico, pausa/retomada, disposição)
- [ ] Disposições de chamada (CRUD + ações: callback, DNC)
- [ ] Callback (agendamento + scheduler)
- [ ] Monitoramento de Filas (tempo real)

## Fase 6 — Campanhas e discador preditivo
- [ ] CRUD Campanhas (todos os campos da seção 24)
- [ ] Import CSV streaming (preview, mapeamento, validação, duplicados, rejeitados)
- [ ] Normalização de telefone (serviço dedicado, BR inicialmente)
- [ ] Lista de supressão (DNC) + checagem obrigatória pré-originação
- [ ] CPS limiter (token bucket, coordenado via Redis, multi-worker)
- [ ] Reserva concorrente de leads (FOR UPDATE SKIP LOCKED + timeout)
- [ ] Idempotência de originação (attempt_id/call_id/uniqueid/linkedid, state machine)
- [ ] PredictiveDialerEngine (EWMA, pacing, previsão de liberação de agentes)
- [ ] Controle de abandono (pacing cai / suspende originação)
- [ ] AMD opcional por campanha
- [ ] Wrap-up time
- [ ] Retry engine (regras por causa, limite de tentativas)
- [ ] Horário de campanha (timezone, dias/horários, WAITING_SCHEDULE)
- [ ] Lock distribuído por campanha (Redis)
- [ ] docs/PREDICTIVE_DIALER.md

## Fase 7 — CDR, métricas e relatórios
- [ ] Modelo consolidado de chamadas (CDR+CEL+AMI+queue_log)
- [ ] Reconciliação de estados órfãos após restart
- [ ] TME / TMA (definições documentadas, cálculo correto)
- [ ] Relatório de Chamadas (filtros, paginação server-side, export CSV)
- [ ] Relatório de Agentes (tempos, pausas detalhadas)
- [ ] Dashboard geral (cards + gráficos reais)
- [ ] Dashboard do discador (por campanha, tempo real)
- [ ] Compliance de Chamadas (parâmetros configuráveis, alertas, contadores)

## Fase 8 — Frontend completo
- [ ] Bootstrap Next.js + Tailwind + shadcn/ui + TanStack Query + WS client
- [ ] Logo processada (b2bcall.png) + tema light/dark
- [ ] Menu completo (seção 52)
- [ ] Todas as telas do checklist de aceite (seção 90)

## Fase 9 — Segurança e produção
- [ ] Criptografia de segredos de trunk (AES-256-GCM)
- [ ] HTTP security headers, CORS, CSRF, Helmet
- [ ] nftables final revisado
- [ ] Logs estruturados JSON (sem segredos)
- [ ] Correlation IDs (request_id/attempt_id/call_id)
- [ ] Métricas Prometheus (/metrics)
- [ ] Bootstrap super_admin (senha aleatória, FIRST_LOGIN.txt, forçar troca)
- [ ] Seed (permissões, perfis, pausas, disposições) sem dados fake em produção
- [ ] Backup/restore (postgres, asterisk config, .env seguro)
- [ ] scripts/install.sh, update.sh, backup.sh, restore.sh, healthcheck.sh
- [ ] Nginx reverse proxy (80/443, WS, HTTPS documentado)

## Fase 10 — Testes e aceite
- [ ] Unit tests (predictive engine, CPS limiter, permissions, phone norm, retry,
      state machines, TME/TMA, scheduling)
- [ ] Integration tests (postgres, redis, repositories, API, AMI mock)
- [ ] E2E (login → ... → RBAC, conforme seção 64)
- [ ] Modo simulação (DIALER_SIMULATION=true) + testes do predictive engine
- [ ] Prova de CPS respeitado / concorrência máxima / sem discagem dupla /
      pausa efetiva / recuperação após restart / pacing reage a abandono /
      supressão respeitada / horário respeitado
- [ ] Quality gate (lint, typecheck, unit, integration, e2e, compose config,
      compose ps, health checks) — tudo verde
- [ ] Aceite de segurança (seção 92)
- [ ] Aceite Asterisk (seção 93, comandos documentados)
- [ ] README final completo
- [ ] Relatório final da implementação

---
**Nota de ambiente:** VM atual com 1.9 GiB RAM / 2 vCPU — adequada para dev e
simulação, não para carga real de produção. Ver docs/ARCHITECTURE.md seção 1.