feat: add telephony layer and asterisk-events worker

- 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.
2026-08-27 12:41:41 -03:00
parent a2898fa566
commit 6f3d731581
20 changed files with 1059 additions and 4 deletions
--- a/packages/database/prisma/migrations/20260827153251_add_trunks_extensions_extension_states/migration.sql
+++ b/packages/database/prisma/migrations/20260827153251_add_trunks_extensions_extension_states/migration.sql
@@ -0,0 +1,70 @@
+-- CreateEnum
+CREATE TYPE "TrunkType" AS ENUM ('IP', 'AUTH', 'REGISTRATION');
+
+-- CreateEnum
+CREATE TYPE "DtmfMode" AS ENUM ('rfc4733', 'info', 'inband', 'auto');
+
+-- CreateTable
+CREATE TABLE "trunks" (
+    "id" TEXT NOT NULL,
+    "name" TEXT NOT NULL,
+    "type" "TrunkType" NOT NULL,
+    "host" TEXT NOT NULL,
+    "port" INTEGER NOT NULL DEFAULT 5060,
+    "transport" TEXT NOT NULL DEFAULT 'udp',
+    "username" TEXT,
+    "secret_encrypted" TEXT,
+    "from_user" TEXT,
+    "from_domain" TEXT,
+    "contact_user" TEXT,
+    "outbound_proxy" TEXT,
+    "context" TEXT NOT NULL DEFAULT 'outbound',
+    "caller_id" TEXT,
+    "codecs" TEXT[] DEFAULT ARRAY['ulaw', 'alaw']::TEXT[],
+    "dtmf_mode" "DtmfMode" NOT NULL DEFAULT 'rfc4733',
+    "qualify_frequency" INTEGER NOT NULL DEFAULT 60,
+    "max_channels" INTEGER,
+    "max_cps" INTEGER NOT NULL DEFAULT 5,
+    "allowed_ips" TEXT[] DEFAULT ARRAY[]::TEXT[],
+    "enabled" BOOLEAN NOT NULL DEFAULT true,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "trunks_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "extensions" (
+    "id" TEXT NOT NULL,
+    "number" TEXT NOT NULL,
+    "name" TEXT NOT NULL,
+    "sip_password_encrypted" TEXT NOT NULL,
+    "caller_id" TEXT,
+    "context" TEXT NOT NULL DEFAULT 'b2bcall-agents',
+    "codecs" TEXT[] DEFAULT ARRAY['ulaw', 'alaw']::TEXT[],
+    "transport" TEXT NOT NULL DEFAULT 'udp',
+    "max_contacts" INTEGER NOT NULL DEFAULT 1,
+    "qualify_frequency" INTEGER NOT NULL DEFAULT 60,
+    "enabled" BOOLEAN NOT NULL DEFAULT true,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "extensions_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "extension_states" (
+    "extension" TEXT NOT NULL,
+    "device_state" TEXT,
+    "contact_status" TEXT,
+    "contact_uri" TEXT,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "extension_states_pkey" PRIMARY KEY ("extension")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "trunks_name_key" ON "trunks"("name");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "extensions_number_key" ON "extensions"("number");
--- a/packages/database/prisma/schema.prisma
+++ b/packages/database/prisma/schema.prisma
@@ -131,3 +131,84 @@ model AuditLog {
  @@index([createdAt])
  @@map("audit_logs")
 }
+
+// ===========================================================================
+// Fase 4 — Telefonia. CRUD da aplicação; os objetos PJSIP correspondentes
+// (ps_endpoints/ps_auths/ps_aors/ps_endpoint_id_ips/ps_registrations) são
+// provisionados no schema "asterisk" pelo TrunksService/ExtensionsService
+// (packages/telephony), nunca editados manualmente.
+// ===========================================================================
+
+enum TrunkType {
+  IP
+  AUTH
+  REGISTRATION
+}
+
+enum DtmfMode {
+  rfc4733
+  info
+  inband
+  auto
+}
+
+model Trunk {
+  id              String    @id @default(uuid())
+  name            String    @unique
+  type            TrunkType
+  host            String
+  port            Int       @default(5060)
+  transport       String    @default("udp")
+  username        String?
+  // Segredo cifrado em repouso (AES-256-GCM, master key fora do banco —
+  // agente.md seção 55). Nunca retornado em claro pela API após salvar.
+  secretEncrypted String?   @map("secret_encrypted")
+  fromUser        String?   @map("from_user")
+  fromDomain      String?   @map("from_domain")
+  contactUser     String?   @map("contact_user")
+  outboundProxy   String?   @map("outbound_proxy")
+  context         String    @default("outbound")
+  callerId        String?   @map("caller_id")
+  codecs          String[]  @default(["ulaw", "alaw"])
+  dtmfMode        DtmfMode  @default(rfc4733) @map("dtmf_mode")
+  qualifyFrequency Int      @default(60) @map("qualify_frequency")
+  maxChannels     Int?      @map("max_channels")
+  maxCps          Int       @default(5) @map("max_cps")
+  allowedIps      String[]  @default([]) @map("allowed_ips")
+  enabled         Boolean   @default(true)
+  createdAt       DateTime  @default(now()) @map("created_at")
+  updatedAt       DateTime  @updatedAt @map("updated_at")
+
+  @@map("trunks")
+}
+
+model Extension {
+  id                String   @id @default(uuid())
+  number            String   @unique
+  name              String
+  sipPasswordEncrypted String @map("sip_password_encrypted")
+  callerId          String?  @map("caller_id")
+  context           String   @default("b2bcall-agents")
+  codecs            String[] @default(["ulaw", "alaw"])
+  transport         String   @default("udp")
+  maxContacts       Int      @default(1) @map("max_contacts")
+  qualifyFrequency  Int      @default(60) @map("qualify_frequency")
+  enabled           Boolean  @default(true)
+  createdAt         DateTime @default(now()) @map("created_at")
+  updatedAt         DateTime @updatedAt @map("updated_at")
+
+  @@map("extensions")
+}
+
+// Último estado conhecido de cada ramal — alimentado por
+// apps/asterisk-events a partir de DeviceStateChange/ContactStatus.
+// Fonte do painel de monitoramento (nunca polling do Asterisk no frontend).
+model ExtensionState {
+  extension     String   @id
+  deviceState   String?  @map("device_state")
+  contactStatus String?  @map("contact_status")
+  contactUri    String?  @map("contact_uri")
+  updatedAt     DateTime @updatedAt @map("updated_at")
+
+  @@map("extension_states")
+}