# 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.

2. 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

3. 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
5. 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
10. Integración con CRM

Flujo:

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

Con:

✔ validación previa
✔ backup automático

11. 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

13. Principio operativo central
El usuario controla la selección y validación.
El sistema estructura, automatiza y ejecuta.
14. 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