INICIO¶
Documentación y Especificación Técnica: CRM de Fuerza de Ventas y Ecosistema SIGFA Pro¶
Fecha: 2026-09-10
Autores: Kevin Delgado, David Garcia & Duval Alcivar
Arquitectura: Microservicios Desacoplados + Multi-Tenancy RLS (BIGINT)
Bases de Datos: core, crm, erp
Gestión de ENUMs: Gestionados en la capa de código / backend (FastAPI / Pydantic / SQLAlchemy 2.0); en PostgreSQL se persisten como VARCHAR(...).
1. Contexto y Principios de Diseño¶
El sistema legacy (SIGFA / SIGFAPRO) mantenía tablas monolíticas desnormalizadas (por ejemplo, i133t_cartera_clientes con 68 columnas y i127t_promotor con 61 columnas) donde se mezclaban datos de identidad personal, encuestas socioeconómicas, datos transaccionales, credenciales de acceso y blobs binarios (bytea).
Para la nueva arquitectura de microservicios, el ecosistema se normaliza en Tercera Forma Normal (3NF) práctica y se estructura respetando los siguientes principios rectores de diseño:
- Aislamiento por Microservicios y Bounded Contexts:
- La plataforma se divide en tres bases de datos físicas independientes:
core(servicios transversales de identidad y empresa),crm(gestión comercial de clientes y fuerza de ventas) yerp(operaciones contables, pedidos y logística). -
Desacoplamiento Cross-Database: No existen Foreign Keys físicas entre bases de datos distintas. La integración entre servicios se realiza mediante correlación lógica por
UUID(p. ej.,cliente_id,promotor_id,usuario_id,persona_id). -
Aislamiento Multi-Tenant por Empresa (PostgreSQL RLS):
- Toda tabla con tenencia incorpora la columna obligatoria
empresa_id BIGINT NOT NULL. -
El aislamiento se garantiza a nivel de motor de base de datos mediante PostgreSQL Row-Level Security (RLS) utilizando la variable de sesión
app.current_empresa_id:ALTER TABLE <schema>.<tabla> ENABLE ROW LEVEL SECURITY; CREATE POLICY rls_<tabla>_empresa ON <schema>.<tabla> FOR ALL USING (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT) WITH CHECK (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT); -
Integridad Referencial Compuesta Intra-Servicio:
- Todas las claves foráneas internas dentro del mismo esquema/base de datos que involucran tablas con tenencia son compuestas:
CONSTRAINT fk_<tabla>_<relacion> FOREIGN KEY (empresa_id, <fk_id>) REFERENCES <schema>.<tabla_padre> (empresa_id, id) ON DELETE RESTRICT -- o ON DELETE CASCADE según el caso -
Cada tabla dispone de la restricción
CONSTRAINT uq_<tabla>_empresa_id UNIQUE (empresa_id, id)como destino de integridad. -
Identificadores y Códigos de Negocio:
- La clave primaria estándar es
id UUID NOT NULL DEFAULT gen_random_uuid()(a excepción deidentidad.mae_empresasque actúa como raíz numérica conid BIGINT GENERATED ALWAYS AS IDENTITY). -
Los códigos de negocio (
codigo VARCHAR(30) NOT NULL) son únicos por empresa medianteCONSTRAINT uq_<tabla>_empresa_codigo UNIQUE (empresa_id, codigo). -
Auditoría Estándar Unificada:
- Todas las entidades implementan el bloque de auditoría estándar de 6 columnas:
is_activo BOOLEAN NOT NULL DEFAULT true,created_at TIMESTAMPTZ NOT NULL DEFAULT now(),updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),deleted_at TIMESTAMPTZ,created_by UUID,updated_by UUID.
2. Especificación Detallada de Tablas + DBML + Script SQL¶
Orden de especificación arquitectónica: MAE > TRX > TRX ... DETALLE > CAT > REL > LOG > CFG.
2.1. Base de Datos Core (core)¶
Servicio centralizado encargado de la gobernanza de tenants, identidades personales, usuarios del sistema, sucursales y catálogos geográficos y fiscales globales.
2.1.1. Tablas Maestras (mae)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
identidad.mae_empresas |
identidad |
i034t_empresa |
Entidad troncal y raíz de empresas/tenants de toda la plataforma SIGFA Pro. | Ver Especificación |
identidad.mae_personas |
identidad |
i127t (identidad) |
Registro centralizado de personas naturales (nombres, apellidos, documento de identidad, contacto y fotografía). | Ver Especificación |
identidad.mae_sucursales |
identidad |
i145t_sucursal |
Sedes y sucursales físicas operativas de la empresa con ubicación geográfica y datos de contacto. | Ver Especificación |
identidad.mae_usuarios |
identidad |
i127t (credenciales) |
Cuenta de acceso de usuario al sistema (autenticación, username, password hash y estado de sesión). | Ver Especificación |
identidad.mae_entidades |
identidad |
— | Raíz polimórfica del patrón party: persona natural o jurídica (ADR 0022). | Ver Especificación |
identidad.mae_personas_juridicas |
identidad |
— | Personas jurídicas externas (nombre, identificación fiscal, ubicación) con cuenta de usuario (ADR 0022). | Ver Especificación |
2.1.2. Tablas Transaccionales (trx)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
identidad.trx_refresh_tokens |
identidad |
— | Rotación de refresh tokens (hash SHA-256) con expiración y revocación lógica. | Ver Especificación |
2.1.3. Tablas Transaccionales Detalle (trx ... detalle)¶
No aplica para este esquema / servicio.
2.1.4. Tablas Catálogos (cat)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
identidad.cat_paises |
identidad |
i123t_pais |
Catálogo global de países (ISO 3166-1 alfa-3). | Ver Especificación |
identidad.cat_ciudades |
identidad |
i126t_ciudad |
Catálogo global de ciudades asociadas a países. | Ver Especificación |
identidad.cat_tipos_identificacion |
identidad |
i035t_doc_ident |
Tipos de documentos de identificación tributaria y civil (RUC, Cédula, Pasaporte). | Ver Especificación |
identidad.cat_generos |
identidad |
— | Géneros para el perfil de personas. | Ver Especificación |
identidad.cat_monedas |
identidad |
i124t_moneda |
Catálogo global de monedas soportadas (código ISO 4217 y símbolo). | Ver Especificación |
identidad.cat_aplicaciones |
identidad |
— | Aplicaciones del núcleo activables por empresa. | Ver Especificación |
identidad.cat_permisos |
identidad |
— | Permisos reutilizables a nivel global o por empresa. | Ver Especificación |
identidad.cat_tipos_usuario |
identidad |
— | Tipos de cuenta de usuario (usuario, root, externo). |
Ver Especificación |
2.1.5. Tablas Relación (rel)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
identidad.rel_usuario_empresa |
identidad |
— | Membresía de usuarios a empresas del núcleo. | Ver Especificación |
identidad.rel_usuario_sucursal |
identidad |
— | Sucursales asignadas a cada usuario. | Ver Especificación |
identidad.rel_empresa_aplicacion |
identidad |
— | Aplicaciones habilitadas por empresa. | Ver Especificación |
identidad.rel_usuario_permiso |
identidad |
— | Permisos efectivos por usuario (global o por empresa). | Ver Especificación |
identidad.rel_usuario_menu |
identidad |
— | Menús autorizados por usuario y empresa. | Ver Especificación |
identidad.rel_usuario_menu_accion |
identidad |
— | Acciones habilitadas por usuario sobre menús. | Ver Especificación |
2.1.6. Tablas de Auditoría y Trazabilidad (log)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
identidad.log_sesiones |
identidad |
— | Bitácora de eventos de sesión (login, logout, fallos). | Ver Especificación |
erp.audit_log |
erp |
— | Bitácora de auditoría particionada por mes, en la base del producto. | Ver Especificación |
2.1.7. Tablas de Configuración (cfg)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
identidad.cfg_modulos |
identidad |
— | Módulos configurados por empresa y aplicación. | Ver Especificación |
identidad.cfg_menu |
identidad |
— | Menú jerárquico por empresa y módulo (niveles 1..3). | Ver Especificación |
identidad.cfg_menu_acciones |
identidad |
— | Acciones autorizables por menú. | Ver Especificación |
2.2. Base de Datos ERP (erp)¶
Módulos transaccionales y financieros encargados del procesamiento de órdenes de pedido comercial, planificación de entregas escalonadas y recaudaciones de cobranza en ruta.
2.2.1. Tablas Maestras (mae)¶
No aplica para este esquema / servicio.
2.2.2. Tablas Transaccionales (trx)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
contable.trx_cobros_campo |
contable |
c213t_amortizacion_cliente |
Registro de cobros y recaudaciones comerciales efectuadas directamente en campo por promotores o cobradores móviles. Conecta los ingresos recibidos en ruta con el módulo de tesorería y contabilidad del ERP. | Ver Especificación |
contable.trx_cobros_campo_imputaciones |
contable |
c213t (descompone arrays co_aviso / nu_abono_aviso) |
Desglose de amortizaciones e imputaciones aplicadas por cada cobro en campo hacia facturas pendientes de cobro u órdenes de cobranza vinculadas. | Ver Especificación |
pedidos.trx_pedidos |
pedidos |
c067t_pedido |
Cabecera de órdenes de pedido generadas desde la aplicación móvil de promotores hacia el dominio de pedidos del ERP. Aplica integración desacoplada mediante UUIDs de correlación hacia CRM y Core. | Ver Especificación |
pedidos.trx_pedidos_planificaciones |
pedidos |
c072t_planificacion_pedido |
Cronograma de entregas parciales y despachos escalonados vinculados a una orden de pedido o a líneas específicas de producto. | Ver Especificación |
2.2.3. Tablas Transaccionales Detalle (trx ... detalle)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
pedidos.trx_pedidos_detalle |
pedidos |
c066t_detalle_pedido |
Desglose ítem por ítem de los productos solicitados en el pedido, con alta precisión decimal en precio unitario (NUMERIC(14,4)), cantidades fraccionables (NUMERIC(12,4)) y desglose tributario de descuentos e impuestos. |
Ver Especificación |
2.2.4. Tablas Catálogos (cat)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
contable.cat_bancos |
contable |
co_banco |
Catálogo de instituciones bancarias y financieras para el registro de transferencias, depósitos y cheques recibidos en campo. | Ver Especificación |
contable.cat_estados_cobro |
contable |
co_estatus |
Catálogo de estados de ciclo de vida de cobros en campo (PENDIENTE, VALIDADO, DEPOSITADO, ANULADO, RECHAZADO). | Ver Especificación |
contable.cat_metodos_pago |
contable |
co_forma |
Catálogo de métodos y formas de pago aceptados para recaudación contable en ruta. | Ver Especificación |
2.2.5. Tablas Relación (rel)¶
No aplica para este esquema / servicio.
2.2.6. Tablas de Auditoría y Trazabilidad (log)¶
No aplica para este esquema / servicio.
2.2.7. Tablas de Configuración (cfg)¶
No aplica para este esquema / servicio.
2.3. Base de Datos CRM (crm)¶
Módulo comercial principal enfocado en la administración integral de clientes, cartera crediticia, gestión de promotores de venta, planificación y ejecución de visitas en ruta, encuestas comerciales y avisos de cobranza.
2.3.1. Tablas Maestras (mae)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
clientes.mae_clientes |
clientes |
i133t_cartera_clientes (68 col) |
Entidad central del cliente comercial. Contiene la información de identidad comercial, categorización y estado de relación con la empresa. Los aspectos financieros y fiscales se delegan a satélites 1:1 o servicios especializados. | Ver Especificación |
clientes.mae_contactos_cliente |
clientes |
i134t_contacto_cliente |
Directorio maestro de personas de contacto comercial para clientes. | Ver Especificación |
clientes.mae_prospectos |
clientes |
c063t_agenda_actividades |
Gestión de oportunidades comerciales y leads capturados en campo por los promotores antes de su conversión y alta formal como clientes. | Ver Especificación |
clientes.mae_documentos_cliente |
clientes |
i287t_documentos_cliente |
Expediente digital de documentos mercantiles y legales (RUC, Cédula Representante, Contrato de Crédito, Pagaré, Permisos) almacenados en Object Storage (S3 / MinIO). | Ver Especificación |
clientes.mae_locales_cliente |
clientes |
i339t_locales_cliente |
Sucursales, almacenes y puntos de entrega físicos geolocalizados del cliente para visitas de promotores, geocercas móviles y despacho logístico de mercadería. | Ver Especificación |
fuerza_ventas.mae_promotores |
fuerza_ventas |
i127t_promotor (61 col) |
Perfil comercial del promotor de ventas. Aísla la identidad de usuario y credenciales (delegadas a core.identidad) y se enfoca en parámetros comerciales, metas, comisiones y cupos de crédito comercial. | Ver Especificación |
fuerza_ventas.mae_metas_promotores |
fuerza_ventas |
i176t_meta_promotor |
Objetivos mensuales o periódicos de ventas, cobertura de clientes compradores, visitas efectivas y recaudación asignados a los promotores comerciales. | Ver Especificación |
fuerza_ventas.mae_agencias |
fuerza_ventas |
i283t_agencia_promotor |
Células organizacionales y agencias comerciales intermedias para estructurar grupos de venta regionales y líneas de supervisión comercial. | Ver Especificación |
fuerza_ventas.mae_presupuestos_cliente |
fuerza_ventas |
i714t_presupuesto_cliente |
Presupuesto comercial y proyección mensual de ventas acordada por cada cliente específico bajo la atención de un promotor determinado. | Ver Especificación |
fuerza_ventas.mae_equipos_consignacion |
fuerza_ventas |
c221t / c222t |
Control y trazabilidad de activos de la empresa entregados a clientes en calidad de comodato o consignación (neveras, dispensadores, exhibidores POP, racks, balanzas). | Ver Especificación |
2.3.2. Tablas Transaccionales (trx)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
clientes.trx_encuestas_cliente |
clientes |
c061t / c062t |
Cabecera de encuestas, censos comerciales y evaluaciones de satisfacción aplicadas en campo por promotores durante visitas a clientes o prospectos. | Ver Especificación |
fuerza_ventas.trx_visitas |
fuerza_ventas |
c063t_agenda_actividades |
Cabecera principal de actividades y visitas en ruta de la fuerza de ventas. Incorpora validación de exclusividad de destino (cliente formal vs prospecto lead) y registro georreferenciado de check-in / check-out móvil. | Ver Especificación |
fuerza_ventas.trx_visitas_requerimientos |
fuerza_ventas |
c065t_requerimientos_visita |
Requerimientos comerciales, técnicos, materiales POP y reclamos solicitados durante una visita. Normaliza requerimientos 1:N con ciclo de vida, fechas de compromiso y asignación de responsables. | Ver Especificación |
fuerza_ventas.trx_visitas_documentos |
fuerza_ventas |
c064t_documentos_agenda |
Evidencias fotográficas, firmas digitales y actas de visita capturadas en la app móvil y almacenadas en Object Storage (S3 / MinIO). | Ver Especificación |
fuerza_ventas.trx_avisos_cobro |
fuerza_ventas |
c213t_amortizacion_cliente / vi_aviso_cobro |
Programación y seguimiento de órdenes de cobranza asignadas a los promotores en campo para la gestión y recaudación de facturas de clientes. | Ver Especificación |
2.3.3. Tablas Transaccionales Detalle (trx ... detalle)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
clientes.trx_encuestas_cliente_detalle |
clientes |
c061t / c062t |
Detalle tipado de respuestas abiertas, numéricas, booleanas y opciones de selección múltiple/única registradas en las encuestas comerciales. | Ver Especificación |
fuerza_ventas.trx_visitas_requerimiento_detalle |
fuerza_ventas |
c065t_requerimientos_visita |
Desglose y seguimiento granular de los ítems de requerimiento solicitados por el cliente durante la visita en campo. | Ver Especificación |
fuerza_ventas.trx_avisos_cobro_detalle |
fuerza_ventas |
c213t (arrays paralelos normalizados) |
Desglose de facturas y documentos de deuda vinculados a una orden de cobro en campo. | Ver Especificación |
2.3.4. Tablas Catálogos (cat)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
clientes.cat_canales_comerciales |
clientes |
i282t_canales |
Define los canales de distribución comercial de la empresa (p. ej., Tradicional, Moderno, Horeca, Institucional, Exportación). Permite segmentar estrategias de precios y promociones. | Ver Especificación |
clientes.cat_tipos_canal_comercial |
clientes |
i747t_tipo_canal |
Sub-clasificación técnica de los canales comerciales (Mayorista, Minorista, Supermercados, Cadenas) por tenant. | Ver Especificación |
clientes.cat_clases_cliente |
clientes |
i248t_clase_cliente |
Categorización comercial de clientes según volumen, facturación o importancia estratégica (A, B, C, Clave, Corporativo, Distribuidor). | Ver Especificación |
clientes.cat_grupos_economicos |
clientes |
i143t_grupo_economico |
Permite agrupar diferentes clientes y razones sociales bajo un mismo holding empresarial para consolidar análisis de riesgo y cupo global de crédito. | Ver Especificación |
clientes.cat_modelos_comerciales |
clientes |
i746t_modelo_comercial |
Define las modalidades de negocio aplicables a la relación comercial con el cliente (Venta Directa, Consignación, Distribución Exclusiva, Preventa, Autoventa). | Ver Especificación |
clientes.cat_tipos_credito |
clientes |
i132t_tipo_credito |
Condiciones y líneas de financiamiento comercial otorgadas a clientes (Crédito Ordinario, Carta de Crédito, Pagaré, Crédito Documentario). | Ver Especificación |
clientes.cat_terminos_pago |
clientes |
i132t_termino_pago |
Plazos y acuerdos comerciales para la cancelación de pedidos y facturas (Contado Inmediato, 7 días, 15 días, 30 días, 60 días, Anticipado). | Ver Especificación |
clientes.cat_tipos_actividad |
clientes |
i137t_actividad |
Catálogo de tipos de gestión en campo realizadas durante visitas de promotores (Venta, Cobranza, Entrega de Muestras, Auditoría POP, Capacitación, Reclamo). | Ver Especificación |
clientes.cat_tipos_envio |
clientes |
i149t_tipo_envio |
Métodos y modalidades logísticas para entrega de pedidos (Flota Propia, Transporte Tercerizado, Retiro en Planta, Courier Expreso). | Ver Especificación |
clientes.cat_incoterms |
clientes |
i746t_incoterm |
Términos estándar internacionales para operaciones de exportación y despacho comercial (EXW, FOB, CIF, CFR, DDP, DAP). | Ver Especificación |
clientes.cat_tipos_carga |
clientes |
i743t_tipo_carga |
Especificaciones térmicas y de manipulación de la mercancía durante despacho (Carga Seca, Refrigerada, Congelada, Frágil, Peligrosa). | Ver Especificación |
clientes.cat_metodos_pago |
clientes |
i135t_metodo_pago |
Instrumentos monetarios válidos para transacciones y recaudación en campo (Efectivo, Cheque al Día, Cheque Posfechado, Transferencia Bancaria, Tarjeta de Débito/Crédito, Depósito). | Ver Especificación |
clientes.cat_unidades_comerciales |
clientes |
i136t_unidad_comercial |
Divisiones o líneas estratégicas de negocio de la empresa (p. ej., Consumo Masivo, Farmacéutica, Industrial, Institucional) para asignación de promotores. | Ver Especificación |
clientes.cat_encuesta_preguntas |
clientes |
c061t / c062t |
Catálogo formal de preguntas y reactivos utilizados en encuestas de prospección, satisfacción y auditoría de punto de venta (reemplaza arrays desnormalizados y JSON libres). | Ver Especificación |
clientes.cat_encuesta_opciones |
clientes |
c062t_respuesta_pregunta_cerrada |
Opciones predefinidas para preguntas de selección cerrada o múltiple en encuestas comerciales de campo. | Ver Especificación |
clientes.cat_estados_cliente |
clientes |
i014t_estatus |
Catálogo estandarizado de estados comerciales y operativos del cliente (PROSPECTO, ACTIVO, INACTIVO, SUSPENDIDO_CREDITO, BLOQUEADO_LEGAL, DADO_DE_BAJA). | Ver Especificación |
clientes.cat_estados_prospecto |
clientes |
c063t_agenda_actividades |
Fases del embudo de ventas y calificación de leads (NUEVO, EN_CALIFICACION, VISITA_AGENDADA, PROPUESTA_PRESENTADA, CONVERTIDO_A_CLIENTE, DESCARTADO). | Ver Especificación |
clientes.cat_estados_visita |
clientes |
c063t_agenda_actividades |
Máquina de estados de la gestión de visitas en campo (PROGRAMADA, EN_RUTA, INICIADA_CHECKIN, COMPLETADA_CHECKOUT, CANCELADA_NO_CONTACTO, REPROGRAMADA). | Ver Especificación |
clientes.cat_tipos_clientes |
clientes |
i035t_tipo_cliente |
Catálogo maestro de personería jurídica y tributaria del cliente (Persona Natural, Persona Jurídica / Empresa, etc.). | Ver Especificación |
fuerza_ventas.cat_estados_cobro |
fuerza_ventas |
co_estatus |
Catálogo maestro de estados de cobro en ruta para órdenes y avisos de cobranza. | Ver Especificación |
fuerza_ventas.cat_estados_visita |
fuerza_ventas |
co_estatus |
Catálogo de estados de ciclo de vida de visitas para el equipo de promotores. | Ver Especificación |
fuerza_ventas.cat_modalidades_pago_comision |
fuerza_ventas |
i127t.tx_modalidad_pago_comision |
Modalidad de liquidación y pago de comisiones de promotores (CONTADO / CRÉDITO). | Ver Especificación |
fuerza_ventas.cat_tipos_actividad |
fuerza_ventas |
i137t_actividad |
Tipologías de actividad comercial y gestión presencial en campo para promotores. | Ver Especificación |
fuerza_ventas.cat_tipos_requerimiento_visita |
fuerza_ventas |
c065t_req_cliente |
Tipos de requerimiento levantados en visitas (cotizaciones, muestras, material POP, calidad, reclamo). | Ver Especificación |
fuerza_ventas.cat_unidades_comerciales |
fuerza_ventas |
i747t_unidad_comercial |
Unidades de negocio comerciales para asignación y segmentación de promotores. | Ver Especificación |
2.3.5. Tablas Relación (rel)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
clientes.rel_clientes_promotores |
clientes |
i137t_cliente_promotor |
Asignación de clientes a la cartera comercial de los promotores, definiendo el vendedor titular, el día de visita habitual y la secuencia en la ruta diaria. | Ver Especificación |
clientes.rel_unidades_comerciales_sucursales |
clientes |
i144t_unidad_comercial_sucursal |
Habilitación y despliegue operativo de las líneas y unidades comerciales de negocio en cada sucursal física de la empresa. | Ver Especificación |
clientes.rel_canal_tipo_empresa |
clientes |
i747t / i748t |
Matriz de configuración y habilitación de canales y tipos de canal comercial autorizados para operar en cada tenant empresarial. | Ver Especificación |
clientes.rel_clientes_contactos |
clientes |
i134t_contacto_cliente |
Vinculación N:M entre clientes comerciales y contactos con atribuciones operativas (compras, recepción, autorizaciones). | Ver Especificación |
fuerza_ventas.rel_promotores_supervisores |
fuerza_ventas |
i127t_promotor (co_promotor_padre) |
Asignación jerárquica histórica y activa entre promotores de campo y sus supervisores comerciales dentro de la estructura de ventas. | Ver Especificación |
fuerza_ventas.rel_promotores_sucursales |
fuerza_ventas |
i146t_promotor_sucursal |
Mapeo de cobertura comercial y asignación de promotores sobre las diferentes sucursales operativas de la empresa. | Ver Especificación |
fuerza_ventas.rel_promotores_paises |
fuerza_ventas |
i142t_promotor_pais |
Cobertura territorial internacional y países autorizados para la operación y venta de promotores de exportación. | Ver Especificación |
fuerza_ventas.rel_agencias_sucursales |
fuerza_ventas |
i283t_agencia_promotor |
Mapeo de relación y cobertura entre agencias comerciales intermedias y las sucursales físicas operativas de la empresa. | Ver Especificación |
fuerza_ventas.rel_promotores_agencias |
fuerza_ventas |
i284t_agencia_vendedor |
Pertenencia y asignación de los promotores a las diferentes agencias o células comerciales de ventas. | Ver Especificación |
2.3.6. Tablas de Auditoría y Trazabilidad (log)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
clientes.log_cambios_cliente |
clientes |
c297t_historia_cliente |
Bitácora de auditoría histórica e inmutable para el rastreo de modificaciones en campos sensibles de la ficha del cliente (límites de crédito, estados, términos de pago). | Ver Especificación |
fuerza_ventas.log_ubicaciones_promotores |
fuerza_ventas |
c550t (14,2 M filas) |
Telemetría GPS en ruta de promotores móviles (particionada mensualmente por rango de fecha para alto rendimiento). | Ver Especificación |
2.3.7. Tablas de Configuración (cfg)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
clientes.cfg_registro_cliente_sucursal |
clientes |
i406t_parametros_cliente |
Valores y comportamientos por defecto del formulario de alta y registro de clientes según la sucursal operadora. | Ver Especificación |
clientes.cfg_reglas_credito_tipo_empresa |
clientes |
i417t_regla_credito |
Reglas y políticas comerciales automáticas para asignación de líneas de crédito según el tipo de empresa y sucursal. | Ver Especificación |
3. Matriz Consolidada de Integración¶
Para consultar la matriz completa de referencias DBML y los diagramas Mermaid Entity-Relationship de toda la plataforma, consultar el documento central: * Matriz Integral de Relaciones DBML