evo360-types 1.3.602 → 1.3.606

package/dist/apps/shared/zod-schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.zContactSchema = exports.zAddressSchema = exports.zTagSchema = exports.zFireDocSchema = exports.zFirestoreDateSchema = exports.zEvoAppSchema = void 0;
+exports.zCaptureDataMapSchema = exports.zCaptureDataValueSchema = exports.zCaptureDataFieldSchema = exports.zCaptureDataFieldOptionSchema = exports.zCaptureDataFieldTypeSchema = exports.zContactSchema = exports.zAddressSchema = exports.zTagSchema = exports.zFireDocSchema = exports.zFirestoreDateSchema = exports.zEvoAppSchema = void 0;
 const zod_1 = require("zod");
 // Enum for activity read status
 exports.zEvoAppSchema = zod_1.z.enum([
@@ -92,3 +92,41 @@ exports.zContactSchema = zod_1.z.object({
     // WhatsApp BSUID (Business-Scoped User ID) — contato que a Meta entrega sem telefone
     bsuid: zod_1.z.string().nullable().optional(),
 }).passthrough();
+// ----- Campos complementares (capture-data) — feat-196
+exports.zCaptureDataFieldTypeSchema = zod_1.z.enum([
+    "text",
+    "number",
+    "date",
+    "select",
+    "boolean",
+]);
+exports.zCaptureDataFieldOptionSchema = zod_1.z
+    .object({
+    value: zod_1.z.string().min(1).max(255),
+    label: zod_1.z.string().min(1).max(255),
+})
+    .passthrough();
+/**
+ * Campo do dicionário (qualquer entidade). O `code` aceita o legado (1–64);
+ * o slug `^[a-z][a-z0-9_]{0,63}$` é regra de CRIAÇÃO, aplicada no backend.
+ */
+exports.zCaptureDataFieldSchema = exports.zFireDocSchema
+    .extend({
+    code: zod_1.z.string().min(1).max(64),
+    name: zod_1.z.string().min(1).max(255),
+    type: exports.zCaptureDataFieldTypeSchema.optional(),
+    options: zod_1.z.array(exports.zCaptureDataFieldOptionSchema).nullable().optional(),
+    required: zod_1.z.boolean().optional(),
+    order: zod_1.z.number().int().nullable().optional(),
+    searchable: zod_1.z.boolean().optional(),
+    mcp_description: zod_1.z.string().max(2000).nullable().optional(),
+    mcp_enabled: zod_1.z.boolean().optional(),
+})
+    .passthrough();
+exports.zCaptureDataValueSchema = zod_1.z.union([
+    zod_1.z.string(),
+    zod_1.z.number(),
+    zod_1.z.boolean(),
+]);
+/** Mapa `capture_data` gravado na entidade. */
+exports.zCaptureDataMapSchema = zod_1.z.record(exports.zCaptureDataValueSchema);

package/dist/apps/shared/zod-schemas.ts

@@ -107,3 +107,47 @@ export const zContactSchema = z.object({
   // WhatsApp BSUID (Business-Scoped User ID) — contato que a Meta entrega sem telefone
   bsuid: z.string().nullable().optional(),
 }).passthrough();
+
+// ----- Campos complementares (capture-data) — feat-196
+
+export const zCaptureDataFieldTypeSchema = z.enum([
+  "text",
+  "number",
+  "date",
+  "select",
+  "boolean",
+]);
+
+export const zCaptureDataFieldOptionSchema = z
+  .object({
+    value: z.string().min(1).max(255),
+    label: z.string().min(1).max(255),
+  })
+  .passthrough();
+
+/**
+ * Campo do dicionário (qualquer entidade). O `code` aceita o legado (1–64);
+ * o slug `^[a-z][a-z0-9_]{0,63}$` é regra de CRIAÇÃO, aplicada no backend.
+ */
+export const zCaptureDataFieldSchema = zFireDocSchema
+  .extend({
+    code: z.string().min(1).max(64),
+    name: z.string().min(1).max(255),
+    type: zCaptureDataFieldTypeSchema.optional(),
+    options: z.array(zCaptureDataFieldOptionSchema).nullable().optional(),
+    required: z.boolean().optional(),
+    order: z.number().int().nullable().optional(),
+    searchable: z.boolean().optional(),
+    mcp_description: z.string().max(2000).nullable().optional(),
+    mcp_enabled: z.boolean().optional(),
+  })
+  .passthrough();
+
+export const zCaptureDataValueSchema = z.union([
+  z.string(),
+  z.number(),
+  z.boolean(),
+]);
+
+/** Mapa `capture_data` gravado na entidade. */
+export const zCaptureDataMapSchema = z.record(zCaptureDataValueSchema);

package/dist/types/evo-crm/lead/index.d.ts

@@ -1,5 +1,5 @@
 export * from "../fb_collections";
-import { FirestoreDocumentReference, IAddress, IContact, IExternalLink, ITag } from "../../shared";
+import { CaptureDataMap, FirestoreDocumentReference, IAddress, IContact, IExternalLink, ITag } from "../../shared";
 import { IProfile } from "../../evo-people";
 import { QualificationFunnelLevel } from "../dic";
 export declare const EvoCrmLeadPermissions: {
@@ -112,6 +112,8 @@ export interface ILead extends IProfile {
     /** Derivado de `externalLinks` (`"type:id"`) pelo model — habilita `array-contains`. */
     externalLinkKeys?: string[];
     tags?: ITag[] | null;
+    /** Campos complementares (code → valor), validados contra o dicionário `dics/leads/capture-data` (feat-196). */
+    capture_data?: CaptureDataMap | null;
     userRef?: FirestoreDocumentReference;
     ctwa_clid?: string | null;
     /**

package/dist/types/evo-crm/lead/index.ts

@@ -1,6 +1,7 @@
 export * from "../fb_collections";
 
 import {
+  CaptureDataMap,
   FirestoreDocumentReference,
   IAddress,
   IContact,
@@ -154,6 +155,8 @@ export interface ILead extends IProfile {
   /** Derivado de `externalLinks` (`"type:id"`) pelo model — habilita `array-contains`. */
   externalLinkKeys?: string[];
   tags?: ITag[] | null;
+  /** Campos complementares (code → valor), validados contra o dicionário `dics/leads/capture-data` (feat-196). */
+  capture_data?: CaptureDataMap | null;
   userRef?: FirestoreDocumentReference;
   // CTWA attribution (feat-034) — capturado do referral do 1º inbound vindo de anúncio Click-to-WhatsApp.
   ctwa_clid?: string | null;

package/dist/types/evo-csq/index.d.ts

@@ -9,7 +9,11 @@ export * from "./fb_collections";
  *  da rubrica (profissional de saude no canal, nome completo so com agendamento, agenda so pelo
  *  codigo, urgencia = encaixe, soma de familia, responsavel x paciente). Serve para separar as
  *  series antes/depois na analise. */
-export declare const CSQ_RUBRIC_VERSION = "v1.2";
+/** v1.3 (2026-09-24, auditoria dos laudos "encaminhar a supervisao"): mesmos pilares/criterios;
+ *  muda o TEXTO (hierarquia de precedencia: autorizacao da profissional > roteiro do tenant >
+ *  regra generica; familia em horarios vizinhos e esperada; `retorno_apos_vou_verificar` e
+ *  `nomes_corretos` com ponderacao) e a SAIDA do juiz ganha `revalidations` e `resolved_alerts`. */
+export declare const CSQ_RUBRIC_VERSION = "v1.3";
 /** Modo do CSQ por departamento (gravado no binding da HubIA).
  *  - `off`    : nao avalia (default quando ausente).
  *  - `shadow` : avalia e grava o laudo, sem notificar supervisores.
@@ -29,6 +33,14 @@ export type CsqAlertScope = "ticket" | "journey";
 /** Ciclo de vida do alerta. Um alerta da jornada fica `open` no laudo corrente
  *  ate uma avaliacao posterior constatar a correcao; entao vira `resolved`. */
 export type CsqAlertLifecycle = "open" | "resolved";
+/** Por que um alerta virou `resolved` (feat-154 lote 9). Ausente em laudos anteriores.
+ *  - `fact`                      : o recomputo/fato da avaliacao seguinte o encerrou.
+ *  - `judge_resolved`            : o juiz declarou corrigido/insustentavel (alerta `llm`).
+ *  - `judge_dismissed`           : o juiz revalidou um achado automatico e o descartou.
+ *  - `code_guard`                : guarda deterministica aplicada a alerta herdado.
+ *  - `recheck_ok`                : a rechecagem da agenda passou a bater.
+ *  - `supervisor_false_positive` : marcado como falso positivo na revisao do supervisor. */
+export type CsqAlertResolvedReason = "fact" | "judge_resolved" | "judge_dismissed" | "code_guard" | "recheck_ok" | "supervisor_false_positive";
 /** Estado da rechecagem agendada de agenda (adendo §B). Alertas de agenda
  *  nascem `pending` (sem auto-fail nem notificacao) e sao reavaliados em
  *  `closed_at + CSQ_DEFAULTS.recheck_delay_min`.
@@ -145,6 +157,10 @@ export interface ICsqAlert {
     recheck_after?: Date;
     /** Ticket em que o alerta foi constatado como resolvido. */
     resolved_in_ticket?: string;
+    /** Motivo da resolucao (lote 9). */
+    resolved_reason?: CsqAlertResolvedReason;
+    /** Texto do motivo, quando houver (ex.: justificativa do juiz). */
+    resolved_note?: string;
     /** So em alertas de agenda: agendamento com que o claim foi cruzado, para o
      *  Nexus linkar `/{tenant}/evo-med/calendar/{calendar_id}/appointment/{appointment_id}`. */
     appointment_id?: string;
@@ -442,6 +458,18 @@ export interface ICsqLlmUsage {
     /** Tentativas gastas. Contrato: <= 2 (1 retry por falha de schema). */
     rounds?: number;
 }
+/** Veredito do juiz sobre um achado automatico revalidavel (lote 9). O codigo
+ *  so aplica `dismiss` a codigos da allowlist de revalidacao. */
+export interface ICsqJudgeRevalidation {
+    fingerprint: string;
+    verdict: "confirm" | "dismiss";
+    reason: string;
+}
+/** Alerta anterior (fonte `llm`) que o juiz declarou resolvido, com o motivo. */
+export interface ICsqJudgeResolvedAlert {
+    fingerprint: string;
+    reason: string;
+}
 /** Saida estruturada da tool `submit_csq_evaluation`. O juiz NAO recebe tools
  *  de leitura e nao decide o score final: so pontua, extrai e cita evidencia. */
 export interface ICsqJudgeOutput {
@@ -454,6 +482,11 @@ export interface ICsqJudgeOutput {
     /** Fingerprints de alertas anteriores que este atendimento resolveu.
      *  So resolve alertas de fonte `llm` (adendo §G). */
     resolved_alert_ids: string[];
+    /** Lote 9: os mesmos resolvidos, com o motivo. Os fingerprints entram tambem em
+     *  `resolved_alert_ids` na normalizacao. */
+    resolved_alerts?: ICsqJudgeResolvedAlert[];
+    /** Lote 9: veredito sobre os "achados automaticos a revalidar" do prompt. */
+    revalidations?: ICsqJudgeRevalidation[];
     highlights: string[];
     improvements: string[];
     confidence: number;
@@ -472,12 +505,35 @@ export interface ICsqAppointmentFact {
     modality?: string;
     created_at?: Date;
 }
-/** Sobreposicao detectada entre agendamentos do mesmo profissional. */
+/** Agendamento envolvido numa sobreposicao (lote 9). */
+export interface ICsqOverlapAppointmentFact {
+    id: string;
+    patient_id?: string;
+    patient_name?: string;
+    start_at: Date;
+    end_at?: Date;
+    professional_name?: string;
+    /** O agendamento e de paciente vinculado ao lead avaliado. */
+    is_lead: boolean;
+}
+/** Pistas de agendamento de familia numa sobreposicao (lote 9). */
+export interface ICsqOverlapFamilyHints {
+    /** Os pacientes envolvidos (ou o lead) compartilham o sobrenome. */
+    same_surname: boolean;
+    /** O outro paciente tem o mesmo telefone do lead. */
+    same_contact: boolean;
+    /** Todos os pacientes envolvidos estao vinculados ao mesmo lead. */
+    same_lead: boolean;
+}
+/** Sobreposicao detectada entre agendamentos do mesmo profissional. Desde o
+ *  lote 9 so envolve agendamentos em que pelo menos um e do lead. */
 export interface ICsqOverlapFact {
     professional_name?: string;
     appointment_ids: string[];
     start_at: Date;
     end_at: Date;
+    appointments?: ICsqOverlapAppointmentFact[];
+    family_hints?: ICsqOverlapFamilyHints;
 }
 /** Ticket anterior da jornada (motivo, quem fechou). */
 export interface ICsqPreviousTicketFact {
@@ -633,6 +689,9 @@ export interface ICsqLeadReport extends IFireDoc {
     data_quality?: ICsqDataQuality;
     /** Veredito humano (adendo §D). */
     review?: ICsqReview;
+    /** Fingerprints marcados como falso positivo pelo supervisor em laudos anteriores
+     *  (acumulado, lote 9). Alerta com fingerprint aqui fica `resolved` e nao reabre. */
+    suppressed_alert_fingerprints?: string[];
     /** Exclusao (soft delete) pelo supervisor: `deleted_at` vem do IFireDoc. O laudo
      *  some da fila e do historico do lead; a proxima avaliacao do lead comeca do zero.
      *  Transcricao e prompt ficam em `artifacts/` para auditoria. */

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

@@ -34,7 +34,11 @@ __exportStar(require("./fb_collections"), exports);
  *  da rubrica (profissional de saude no canal, nome completo so com agendamento, agenda so pelo
  *  codigo, urgencia = encaixe, soma de familia, responsavel x paciente). Serve para separar as
  *  series antes/depois na analise. */
-exports.CSQ_RUBRIC_VERSION = "v1.2";
+/** v1.3 (2026-09-24, auditoria dos laudos "encaminhar a supervisao"): mesmos pilares/criterios;
+ *  muda o TEXTO (hierarquia de precedencia: autorizacao da profissional > roteiro do tenant >
+ *  regra generica; familia em horarios vizinhos e esperada; `retorno_apos_vou_verificar` e
+ *  `nomes_corretos` com ponderacao) e a SAIDA do juiz ganha `revalidations` e `resolved_alerts`. */
+exports.CSQ_RUBRIC_VERSION = "v1.3";
 // ───────── 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. */

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

@@ -22,7 +22,11 @@ export * from "./fb_collections";
  *  da rubrica (profissional de saude no canal, nome completo so com agendamento, agenda so pelo
  *  codigo, urgencia = encaixe, soma de familia, responsavel x paciente). Serve para separar as
  *  series antes/depois na analise. */
-export const CSQ_RUBRIC_VERSION = "v1.2";
+/** v1.3 (2026-09-24, auditoria dos laudos "encaminhar a supervisao"): mesmos pilares/criterios;
+ *  muda o TEXTO (hierarquia de precedencia: autorizacao da profissional > roteiro do tenant >
+ *  regra generica; familia em horarios vizinhos e esperada; `retorno_apos_vou_verificar` e
+ *  `nomes_corretos` com ponderacao) e a SAIDA do juiz ganha `revalidations` e `resolved_alerts`. */
+export const CSQ_RUBRIC_VERSION = "v1.3";
 
 // ───────── Enums / Literals ─────────
 
@@ -57,6 +61,21 @@ export type CsqAlertScope = "ticket" | "journey";
  *  ate uma avaliacao posterior constatar a correcao; entao vira `resolved`. */
 export type CsqAlertLifecycle = "open" | "resolved";
 
+/** Por que um alerta virou `resolved` (feat-154 lote 9). Ausente em laudos anteriores.
+ *  - `fact`                      : o recomputo/fato da avaliacao seguinte o encerrou.
+ *  - `judge_resolved`            : o juiz declarou corrigido/insustentavel (alerta `llm`).
+ *  - `judge_dismissed`           : o juiz revalidou um achado automatico e o descartou.
+ *  - `code_guard`                : guarda deterministica aplicada a alerta herdado.
+ *  - `recheck_ok`                : a rechecagem da agenda passou a bater.
+ *  - `supervisor_false_positive` : marcado como falso positivo na revisao do supervisor. */
+export type CsqAlertResolvedReason =
+  | "fact"
+  | "judge_resolved"
+  | "judge_dismissed"
+  | "code_guard"
+  | "recheck_ok"
+  | "supervisor_false_positive";
+
 /** Estado da rechecagem agendada de agenda (adendo §B). Alertas de agenda
  *  nascem `pending` (sem auto-fail nem notificacao) e sao reavaliados em
  *  `closed_at + CSQ_DEFAULTS.recheck_delay_min`.
@@ -337,6 +356,10 @@ export interface ICsqAlert {
   recheck_after?: Date;
   /** Ticket em que o alerta foi constatado como resolvido. */
   resolved_in_ticket?: string;
+  /** Motivo da resolucao (lote 9). */
+  resolved_reason?: CsqAlertResolvedReason;
+  /** Texto do motivo, quando houver (ex.: justificativa do juiz). */
+  resolved_note?: string;
   /** So em alertas de agenda: agendamento com que o claim foi cruzado, para o
    *  Nexus linkar `/{tenant}/evo-med/calendar/{calendar_id}/appointment/{appointment_id}`. */
   appointment_id?: string;
@@ -691,6 +714,20 @@ export interface ICsqLlmUsage {
   rounds?: number;
 }
 
+/** Veredito do juiz sobre um achado automatico revalidavel (lote 9). O codigo
+ *  so aplica `dismiss` a codigos da allowlist de revalidacao. */
+export interface ICsqJudgeRevalidation {
+  fingerprint: string;
+  verdict: "confirm" | "dismiss";
+  reason: string;
+}
+
+/** Alerta anterior (fonte `llm`) que o juiz declarou resolvido, com o motivo. */
+export interface ICsqJudgeResolvedAlert {
+  fingerprint: string;
+  reason: string;
+}
+
 /** Saida estruturada da tool `submit_csq_evaluation`. O juiz NAO recebe tools
  *  de leitura e nao decide o score final: so pontua, extrai e cita evidencia. */
 export interface ICsqJudgeOutput {
@@ -703,6 +740,11 @@ export interface ICsqJudgeOutput {
   /** Fingerprints de alertas anteriores que este atendimento resolveu.
    *  So resolve alertas de fonte `llm` (adendo §G). */
   resolved_alert_ids: string[];
+  /** Lote 9: os mesmos resolvidos, com o motivo. Os fingerprints entram tambem em
+   *  `resolved_alert_ids` na normalizacao. */
+  resolved_alerts?: ICsqJudgeResolvedAlert[];
+  /** Lote 9: veredito sobre os "achados automaticos a revalidar" do prompt. */
+  revalidations?: ICsqJudgeRevalidation[];
   highlights: string[];
   improvements: string[];
   confidence: number;
@@ -725,12 +767,37 @@ export interface ICsqAppointmentFact {
   created_at?: Date;
 }
 
-/** Sobreposicao detectada entre agendamentos do mesmo profissional. */
+/** Agendamento envolvido numa sobreposicao (lote 9). */
+export interface ICsqOverlapAppointmentFact {
+  id: string;
+  patient_id?: string;
+  patient_name?: string;
+  start_at: Date;
+  end_at?: Date;
+  professional_name?: string;
+  /** O agendamento e de paciente vinculado ao lead avaliado. */
+  is_lead: boolean;
+}
+
+/** Pistas de agendamento de familia numa sobreposicao (lote 9). */
+export interface ICsqOverlapFamilyHints {
+  /** Os pacientes envolvidos (ou o lead) compartilham o sobrenome. */
+  same_surname: boolean;
+  /** O outro paciente tem o mesmo telefone do lead. */
+  same_contact: boolean;
+  /** Todos os pacientes envolvidos estao vinculados ao mesmo lead. */
+  same_lead: boolean;
+}
+
+/** Sobreposicao detectada entre agendamentos do mesmo profissional. Desde o
+ *  lote 9 so envolve agendamentos em que pelo menos um e do lead. */
 export interface ICsqOverlapFact {
   professional_name?: string;
   appointment_ids: string[];
   start_at: Date;
   end_at: Date;
+  appointments?: ICsqOverlapAppointmentFact[];
+  family_hints?: ICsqOverlapFamilyHints;
 }
 
 /** Ticket anterior da jornada (motivo, quem fechou). */
@@ -905,6 +972,9 @@ export interface ICsqLeadReport extends IFireDoc {
   data_quality?: ICsqDataQuality;
   /** Veredito humano (adendo §D). */
   review?: ICsqReview;
+  /** Fingerprints marcados como falso positivo pelo supervisor em laudos anteriores
+   *  (acumulado, lote 9). Alerta com fingerprint aqui fica `resolved` e nao reabre. */
+  suppressed_alert_fingerprints?: string[];
   /** Exclusao (soft delete) pelo supervisor: `deleted_at` vem do IFireDoc. O laudo
    *  some da fila e do historico do lead; a proxima avaliacao do lead comeca do zero.
    *  Transcricao e prompt ficam em `artifacts/` para auditoria. */

package/dist/types/evo-med/people/index.d.ts

@@ -1,6 +1,6 @@
 export * from "../fb_collections";
 import { IProfile } from "../../evo-people";
-import type { FirestoreDocumentReference, IAddress, IContact, IExternalLink, ITag } from "../../shared";
+import type { CaptureDataMap, FirestoreDocumentReference, IAddress, IContact, IExternalLink, ITag } from "../../shared";
 import { IMedication, PatientAttachmentBaseCategory } from "../dic";
 export declare const EvoMedProfessionalPermissions: {
     readonly List: "evo_med_people_professional_read";
@@ -184,6 +184,8 @@ export interface IPatient extends IProfile {
     attachments?: IPatientAttachment[] | null;
     attachmentExternalLinkKeys?: string[] | null;
     tags?: ITag[] | null;
+    /** Campos complementares (code → valor), validados contra o dicionário `dics/patients/capture-data` (feat-196). */
+    capture_data?: CaptureDataMap | null;
     userRef?: FirestoreDocumentReference;
     [key: string]: unknown;
 }

package/dist/types/evo-med/people/index.ts

@@ -1,6 +1,7 @@
 export * from "../fb_collections";
 import { IProfile } from "../../evo-people";
 import type {
+  CaptureDataMap,
   FirestoreDocumentReference,
   IAddress,
   IContact,
@@ -249,6 +250,8 @@ export interface IPatient extends IProfile {
   attachments?: IPatientAttachment[] | null;
   attachmentExternalLinkKeys?: string[] | null;
   tags?: ITag[] | null;
+  /** Campos complementares (code → valor), validados contra o dicionário `dics/patients/capture-data` (feat-196). */
+  capture_data?: CaptureDataMap | null;
   userRef?: FirestoreDocumentReference;
   [key: string]: unknown; // index signature
 }

package/dist/types/shared/capture-data.d.ts

@@ -0,0 +1,49 @@
+import type { IFireDoc } from "./index";
+/** Nome da subcoleção do dicionário, sob `dics/{entidade}/`. */
+export declare const CAPTURE_DATA_COLLECTION = "capture-data";
+/** Entidades que têm dicionário de campos complementares (= segmento do path em `dics/`). */
+export type CaptureDataEntity = "leads" | "patients";
+export declare const CAPTURE_DATA_FIELD_TYPES: readonly ["text", "number", "date", "select", "boolean"];
+/** Tipo do campo. Ausente no doc = `text` (campos legados de lead). */
+export type CaptureDataFieldType = (typeof CAPTURE_DATA_FIELD_TYPES)[number];
+/**
+ * Valor gravado no mapa `capture_data`. `date` é string `YYYY-MM-DD`;
+ * `select` grava o `value` da opção.
+ */
+export type CaptureDataValue = string | number | boolean;
+/** Mapa gravado na entidade (`lead.capture_data`, `patient.capture_data`). */
+export type CaptureDataMap = Record<string, CaptureDataValue>;
+/**
+ * Regra de CRIAÇÃO do `code` (aplicada no backend). Codes legados fora desse
+ * padrão (ex.: `Convênio`, `nome-paciente`) continuam válidos para leitura.
+ */
+export declare const CAPTURE_DATA_CODE_PATTERN = "^[a-z][a-z0-9_]{0,63}$";
+/** Limite de caracteres de um valor `text`. */
+export declare const CAPTURE_DATA_TEXT_MAX_LENGTH = 2000;
+export interface ICaptureDataFieldOption {
+    /** O que vai gravado no mapa. */
+    value: string;
+    /** O que a UI mostra. */
+    label: string;
+}
+export interface ICaptureDataField extends IFireDoc {
+    /** Chave no mapa `capture_data`. Imutável depois de criado. */
+    code: string;
+    name: string;
+    /** Ausente = `text` (legado). Imutável depois de definido. */
+    type?: CaptureDataFieldType;
+    /** Só para `select`. */
+    options?: ICaptureDataFieldOption[] | null;
+    required?: boolean;
+    order?: number | null;
+    /** Envia o valor ao índice de busca (Algolia, região US). Default false (D2). */
+    searchable?: boolean;
+    /** Instrução para a IA preencher o campo. */
+    mcp_description?: string | null;
+    /** Default true. */
+    mcp_enabled?: boolean;
+}
+/** Compatibilidade: o dicionário de lead é o genérico. */
+export type ILeadCaptureDataField = ICaptureDataField;
+/** Dicionário de campos complementares de paciente. */
+export type IPatientCaptureDataField = ICaptureDataField;

package/dist/types/shared/capture-data.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CAPTURE_DATA_TEXT_MAX_LENGTH = exports.CAPTURE_DATA_CODE_PATTERN = exports.CAPTURE_DATA_FIELD_TYPES = exports.CAPTURE_DATA_COLLECTION = void 0;
+// ----- Campos complementares (capture-data) — feat-196
+//
+// Dicionário genérico por entidade: cada tenant define campos próprios que são
+// gravados em `{entidade}.capture_data` (mapa code → valor).
+//   leads    → tenants/{t}/apps/evo-crm/dics/leads/capture-data/{id}
+//   patients → tenants/{t}/apps/evo-med/dics/patients/capture-data/{id}
+// Herda do `base_tenant` (o tenant atual vence o base, deduplicado por `code`).
+/** Nome da subcoleção do dicionário, sob `dics/{entidade}/`. */
+exports.CAPTURE_DATA_COLLECTION = "capture-data";
+exports.CAPTURE_DATA_FIELD_TYPES = [
+    "text",
+    "number",
+    "date",
+    "select",
+    "boolean",
+];
+/**
+ * Regra de CRIAÇÃO do `code` (aplicada no backend). Codes legados fora desse
+ * padrão (ex.: `Convênio`, `nome-paciente`) continuam válidos para leitura.
+ */
+exports.CAPTURE_DATA_CODE_PATTERN = "^[a-z][a-z0-9_]{0,63}$";
+/** Limite de caracteres de um valor `text`. */
+exports.CAPTURE_DATA_TEXT_MAX_LENGTH = 2000;

package/dist/types/shared/capture-data.ts

@@ -0,0 +1,74 @@
+import type { IFireDoc } from "./index";
+
+// ----- Campos complementares (capture-data) — feat-196
+//
+// Dicionário genérico por entidade: cada tenant define campos próprios que são
+// gravados em `{entidade}.capture_data` (mapa code → valor).
+//   leads    → tenants/{t}/apps/evo-crm/dics/leads/capture-data/{id}
+//   patients → tenants/{t}/apps/evo-med/dics/patients/capture-data/{id}
+// Herda do `base_tenant` (o tenant atual vence o base, deduplicado por `code`).
+
+/** Nome da subcoleção do dicionário, sob `dics/{entidade}/`. */
+export const CAPTURE_DATA_COLLECTION = "capture-data";
+
+/** Entidades que têm dicionário de campos complementares (= segmento do path em `dics/`). */
+export type CaptureDataEntity = "leads" | "patients";
+
+export const CAPTURE_DATA_FIELD_TYPES = [
+  "text",
+  "number",
+  "date",
+  "select",
+  "boolean",
+] as const;
+
+/** Tipo do campo. Ausente no doc = `text` (campos legados de lead). */
+export type CaptureDataFieldType = (typeof CAPTURE_DATA_FIELD_TYPES)[number];
+
+/**
+ * Valor gravado no mapa `capture_data`. `date` é string `YYYY-MM-DD`;
+ * `select` grava o `value` da opção.
+ */
+export type CaptureDataValue = string | number | boolean;
+
+/** Mapa gravado na entidade (`lead.capture_data`, `patient.capture_data`). */
+export type CaptureDataMap = Record<string, CaptureDataValue>;
+
+/**
+ * Regra de CRIAÇÃO do `code` (aplicada no backend). Codes legados fora desse
+ * padrão (ex.: `Convênio`, `nome-paciente`) continuam válidos para leitura.
+ */
+export const CAPTURE_DATA_CODE_PATTERN = "^[a-z][a-z0-9_]{0,63}$";
+
+/** Limite de caracteres de um valor `text`. */
+export const CAPTURE_DATA_TEXT_MAX_LENGTH = 2000;
+
+export interface ICaptureDataFieldOption {
+  /** O que vai gravado no mapa. */
+  value: string;
+  /** O que a UI mostra. */
+  label: string;
+}
+
+export interface ICaptureDataField extends IFireDoc {
+  /** Chave no mapa `capture_data`. Imutável depois de criado. */
+  code: string;
+  name: string;
+  /** Ausente = `text` (legado). Imutável depois de definido. */
+  type?: CaptureDataFieldType;
+  /** Só para `select`. */
+  options?: ICaptureDataFieldOption[] | null;
+  required?: boolean;
+  order?: number | null;
+  /** Envia o valor ao índice de busca (Algolia, região US). Default false (D2). */
+  searchable?: boolean;
+  /** Instrução para a IA preencher o campo. */
+  mcp_description?: string | null;
+  /** Default true. */
+  mcp_enabled?: boolean;
+}
+
+/** Compatibilidade: o dicionário de lead é o genérico. */
+export type ILeadCaptureDataField = ICaptureDataField;
+/** Dicionário de campos complementares de paciente. */
+export type IPatientCaptureDataField = ICaptureDataField;

package/dist/types/shared/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./fb_collections";
 export * from "./external-links";
+export * from "./capture-data";
 export interface FirestoreDocumentReference {
     id: string;
     path: string;

package/dist/types/shared/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.IEvoApp = void 0;
 __exportStar(require("./fb_collections"), exports);
 __exportStar(require("./external-links"), exports);
+__exportStar(require("./capture-data"), exports);
 var IEvoApp;
 (function (IEvoApp) {
     IEvoApp["EvoActivity"] = "evo-activity";

package/dist/types/shared/index.ts

@@ -1,5 +1,6 @@
 export * from "./fb_collections";
 export * from "./external-links";
+export * from "./capture-data";
 
 // ----- FirestoreTypes
 // Definir o tipo unificado para DocumentReference

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evo360-types",
-  "version": "1.3.602",
+  "version": "1.3.606",
   "description": "HREVO360 Shared Types",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",