Gemelo Comercial — Operación

📄 gemelo_comercial_operativo.md — Versión operativa real

  1. Objetivo

El gemelo comercial opera como un sistema práctico para:

descubrir → filtrar → seleccionar → enriquecer → gestionar → enviar a CRM

Con control manual completo desde UI.

  1. Arquitectura de datos (fuente de verdad) data/commercial/

Archivos clave:

2.1 Prospectos prospect_store.jsonl

✔ fuente de verdad ✔ contiene empresa + contacto + contexto + estado CRM

2.2 Lotes prospect_batches.jsonl

✔ histórico de selección ✔ NO se reescribe ✔ contiene snapshot de candidatos (all_candidates)

2.3 Contactos contacts_input.jsonl

✔ enriquecimiento manual

2.4 CRM staging prospect_store_crm_ready.jsonl

✔ usado temporalmente para push a ALEPH

  1. Interfaz (UI real)

Tabs operativos:

Actividades Candidatos Lotes - Crear lote - Historial y estado - Reabrir lote Empresas Contactos Prospectos CRM 4. Flujo operativo real

  1. Actividades → definir perfil de búsqueda

  2. Candidatos → revisar resultados discovery

  3. Lotes → seleccionar empresas

  4. Empresas / Contactos → completar datos

  5. Prospectos CRM → validar y ejecutar

  6. Lógica de lotes 5.1 Crear lote selección manual (user_selected) exclusión (reject_candidate) genera: prospectos snapshot completo (all_candidates) 5.2 Historial muestra estado de gestión cruza: prospect_store contactos estados CRM 5.3 Reabrir lote

Permite:

✔ recuperar candidatos originales ✔ ver estado:

YA_CREADO_COMO_PROSPECTO YA_RECHAZADO_MANUALMENTE PENDIENTE

✔ crear lote complementario

5.4 Lotes complementarios NO modifican lote original crean nuevo lote preservan trazabilidad 6. Gestión de prospectos (UI CRM)

Tabla:

Prospectos CRM

Columnas clave:

company_name country company_nit contact_name crm_state crm_ready retirar_antes_crm 7. Retiro antes de CRM

Funcionalidad:

retirar_antes_crm = True

Permite:

✔ eliminar prospecto de prospect_store.jsonl ✔ SOLO si estado = NEW ✔ crea backup automático

No afecta:

prospect_batches.jsonl 8. Estados reales NEW ENRICH_CONTACTS READY_FOR_OUTREACH CRM_READY 9. Reglas críticas

  • prospect_store.jsonl = fuente de verdad

  • lotes no se mutan

  • eliminación solo en prospect_store

  • CRM requiere: empresa + contacto + due_date

  1. Integración con CRM

Flujo:

Prospectos CRM → push-crm → crm-dry-run → crm-execute

Con:

✔ validación previa ✔ backup automático

  1. Limpieza de datos

Se permite:

✔ eliminar prospectos (estado NEW) ✔ eliminar lotes huérfanos ✔ limpiar contactos asociados

Siempre con:

backup previo automático 12. Estado actual del sistema

✔ UI operativa completa ✔ control manual de pipeline ✔ trazabilidad por lotes ✔ integración CRM funcional ✔ limpieza controlada implementada

  1. Principio operativo central El usuario controla la selección y validación. El sistema estructura, automatiza y ejecuta.

  2. Próxima evolución

  • automatización de enrichment

  • generación de outreach

  • integración con app técnica (gemelo hidráulico) 📌 Fin del documento ✅ 4. Resultado final

Tendrá:

docs/ ├── gemelo_comercial.md ← conceptual ├── gemelo_comercial_operativo.md ← REAL (nuevo) └── _legacy/ ├── gemelo_comercial_prodisys.md ├── gemelo_comercial_cierre_ciclo_crm.md └── gemelo_comercial_V4.md