evo360-types 1.3.552 → 1.3.555

package/dist/types/evo-csq/index.js

@@ -0,0 +1,180 @@
+"use strict";
+// Tipos do CSQ 2.0 (Conversation Sales Quality) — feat-154.
+// Schemas zod correspondentes ficam em src/apps/evo-csq/zod-schemas.ts;
+// estes tipos sao escritos a mao e mantidos em paralelo (convencao do projeto:
+// `apps/` = zod, `types/` = interfaces TS).
+//
+// Contrato de nomes/codigos: hub-medica-docs/features/feat-154-csq-2-0/report-spec.md
+// (§2 estrutura, §3 indicadores, §4 rubrica, §5 claims, §6 alertas) e o
+// "Adendo pos-parecer" do plan.md (§A–§I), que prevalece sobre o corpo do plano.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CSQ_DEFAULTS = exports.CSQ_RUBRIC_V1 = exports.CSQ_AUTO_FAIL_POLICY_SUBTYPES = exports.CSQ_AUTO_FAIL_ALERT_CODES = exports.CSQ_SALES_FLOW_SUBTYPES = exports.CSQ_POLICY_VIOLATION_SUBTYPES = exports.CSQ_ALERT_CODES = exports.CSQ_RUBRIC_VERSION = void 0;
+__exportStar(require("./fb_collections"), exports);
+// ───────── Versao da rubrica ─────────
+/** Versao da rubrica da plataforma gravada em cada avaliacao. Pesos e criterios
+ *  sao da plataforma (nao do tenant); mudar pesos exige nova versao. */
+exports.CSQ_RUBRIC_VERSION = "v1";
+// ───────── Catalogo de alertas (report-spec §6) ─────────
+/** Codigos de alerta v1. Os subtipos de `POLITICA_VIOLADA` e
+ *  `FLUXO_VENDA_NAO_SEGUIDO` vivem em `ICsqAlert.subtype`, nao como codigos. */
+exports.CSQ_ALERT_CODES = [
+    "AGENDAMENTO_INFORMADO_NAO_REGISTRADO",
+    "AGENDAMENTO_DIVERGENTE",
+    "AGENDAMENTO_SOBREPOSTO",
+    "CONTRADICAO_PREMISSA_ANTERIOR",
+    "ORIENTACAO_CLINICA_INDEVIDA",
+    "POLITICA_VIOLADA",
+    "ULTIMA_MENSAGEM_SEM_RESPOSTA",
+    "PERGUNTA_NAO_RESPONDIDA",
+    "PROMESSA_NAO_CUMPRIDA",
+    "IDENTIDADE_ERRADA",
+    "DADO_JA_INFORMADO_RECOLETADO",
+    "DADO_OBRIGATORIO_NAO_COLETADO",
+    "FLUXO_VENDA_NAO_SEGUIDO",
+    "MOTIVO_ENCERRAMENTO_INCOMPATIVEL",
+    "SLA_RESPOSTA_ALTO",
+    "LEAD_QUENTE_SEM_FOLLOWUP",
+    "LEAD_ORIGEM_INCONSISTENTE",
+    "LEAD_QUALIFICACAO_INCONSISTENTE",
+    "AUTOMACAO_CONFLITANTE",
+    "DADO_SENSIVEL_SOLICITADO",
+    "URGENCIA_NAO_ENCAMINHADA",
+    "NF_NAO_ENVIADA",
+    "COBRANCA_NAO_ENVIADA",
+];
+/** Subtipos de `POLITICA_VIOLADA` (report-spec §6). */
+exports.CSQ_POLICY_VIOLATION_SUBTYPES = [
+    "valor",
+    "parcelamento",
+    "convenio",
+    "dia_horario",
+    "procedimento",
+    "modalidade",
+];
+/** Subtipos de `FLUXO_VENDA_NAO_SEGUIDO` (report-spec §6). */
+exports.CSQ_SALES_FLOW_SUBTYPES = [
+    "objecao_sem_argumento",
+    "sem_oferta_concreta",
+    "preco_antes_da_queixa",
+];
+/** Alertas que forcam auto-fail (`status='Crítico'`, `score <= 49`,
+ *  `escalate=true`). Para `POLITICA_VIOLADA` o auto-fail so vale nos subtipos
+ *  de `CSQ_AUTO_FAIL_POLICY_SUBTYPES`; alertas de agenda so contam depois da
+ *  rechecagem (`verification='confirmed'`, adendo §B). */
+exports.CSQ_AUTO_FAIL_ALERT_CODES = [
+    "AGENDAMENTO_INFORMADO_NAO_REGISTRADO",
+    "AGENDAMENTO_DIVERGENTE",
+    "CONTRADICAO_PREMISSA_ANTERIOR",
+    "ORIENTACAO_CLINICA_INDEVIDA",
+    "POLITICA_VIOLADA",
+    "ULTIMA_MENSAGEM_SEM_RESPOSTA",
+    "DADO_SENSIVEL_SOLICITADO",
+    "URGENCIA_NAO_ENCAMINHADA",
+];
+/** Subtipos de `POLITICA_VIOLADA` que caracterizam auto-fail (report-spec §4,
+ *  auto-fail 4: valor/parcelamento/convenio contra a politica do roteiro). */
+exports.CSQ_AUTO_FAIL_POLICY_SUBTYPES = [
+    "valor",
+    "parcelamento",
+    "convenio",
+];
+/** Rubrica da plataforma v1. Pesos: 20/25/25/15/15 (report-spec §4).
+ *  Os `code` sao contrato: aparecem em `ICsqCriterionScore.criterion` e no
+ *  schema da tool de saida do juiz. */
+exports.CSQ_RUBRIC_V1 = [
+    {
+        code: "coerencia_historico",
+        name: "Coerência com o histórico do lead",
+        weight: 20,
+        criteria: [
+            { code: "nao_contradiz_premissa", name: "Não contradiz premissa declarada (Estado do lead anterior + conversa)" },
+            { code: "nao_repergunta_dado_informado", name: "Não re-pergunta dado já informado" },
+            { code: "reconhece_contexto", name: "Reconhece o contexto (já é paciente, restrições)" },
+            { code: "nomes_corretos", name: "Trata lead e paciente pelos nomes certos" },
+        ],
+    },
+    {
+        code: "roteiro_conversao",
+        name: "Aderência ao roteiro & fluxo comercial",
+        weight: 25,
+        criteria: [
+            { code: "segue_fluxo_previsto", name: "Segue o fluxo previsto em binding.behavior" },
+            { code: "objecao_tratada_com_argumento", name: "Objeção tratada com o argumento do roteiro" },
+            { code: "dados_obrigatorios_coletados", name: "Dados obrigatórios (capture-data) coletados" },
+            { code: "motivo_fechamento_coerente", name: "Motivo de fechamento coerente com o desfecho (mcp_description)" },
+            { code: "abertura_encerramento_padrao", name: "Abertura e encerramento padrão" },
+        ],
+    },
+    {
+        code: "acuracidade",
+        name: "Acuracidade",
+        weight: 25,
+        criteria: [
+            { code: "fatos_e_politicas_corretos", name: "Fatos e políticas de channel_custom (valores, dias/horários, convênio, inclusos, parcelamento, endereço)" },
+            { code: "datas_horas_coerentes", name: "Datas e horas coerentes" },
+            { code: "agendamento_bate_com_agenda", name: "Agendamento informado bate com a agenda (crítico)" },
+            { code: "nao_promete_o_que_nao_controla", name: "Não promete o que não controla" },
+        ],
+    },
+    {
+        code: "responsividade",
+        name: "Responsividade",
+        weight: 15,
+        criteria: [
+            { code: "nenhuma_pergunta_sem_resposta", name: "Nenhuma pergunta sem resposta" },
+            { code: "tempos_dentro_do_limiar", name: "frt_min e max_gap_min dentro do limiar" },
+            { code: "retorno_apos_vou_verificar", name: "'Vou verificar' seguido de retorno efetivo" },
+            { code: "ultima_mensagem_respondida", name: "Última mensagem do lead respondida" },
+        ],
+    },
+    {
+        code: "cordialidade_linguagem",
+        name: "Cordialidade & linguagem da marca",
+        weight: 15,
+        criteria: [
+            { code: "persona_e_tom", name: "Persona e tom de channel.identity" },
+            { code: "lexico_obrigatorio_proibido", name: "Léxico obrigatório/proibido" },
+            { code: "clareza_objetividade", name: "Clareza e objetividade" },
+            { code: "ortografia", name: "Ortografia" },
+            { code: "empatia_momento_sensivel", name: "Empatia em momento sensível" },
+        ],
+    },
+];
+// ───────── Limiares e orcamentos da plataforma ─────────
+/** Limiares/orcamentos default do CSQ (plataforma, nao por tenant na F1). */
+exports.CSQ_DEFAULTS = {
+    /** FRT liquido acima disso conta como atraso na rubrica (minutos). */
+    frt_min_warn: 15,
+    /** Maior espera acima disso gera SLA_RESPOSTA_ALTO severidade `media`. */
+    max_gap_min_medium: 60,
+    /** Maior espera acima disso gera SLA_RESPOSTA_ALTO severidade `alta`. */
+    max_gap_min_high: 240,
+    /** Tolerancia de horario ao comparar agendamento informado x agenda (min). */
+    appointment_time_tolerance_min: 15,
+    /** Janela de dias ao redor da data informada para procurar o agendamento. */
+    appointment_day_window: 1,
+    /** Janela da jornada considerada (dias). */
+    journey_days: 90,
+    /** Teto de tickets da jornada carregados por avaliacao. */
+    journey_max_tickets: 20,
+    /** Teto de mensagens do artefato de transcricao. */
+    transcript_max_messages: 500,
+    /** Teto de bytes do artefato de transcricao. */
+    transcript_max_bytes: 200000,
+    /** Atraso da rechecagem agendada da agenda (minutos apos closed_at). */
+    recheck_delay_min: 30,
+};