Refactor Comercial Gradual

Fecha: 2026-05-07

Principio

No mover código vivo sin:

  1. baseline limpio,

  2. compileall,

  3. import test,

  4. prueba funcional mínima,

  5. commit pequeño,

  6. punto de retorno.

Estado actual

Núcleo vivo

  • prodisys/comercial/

  • prodisys/comercial/ui/

  • prodisys/comercial/ui/persistence.py

Activo transitorio

  • src/commercial/strategic_scoring.py

  • src/commercial/prospect_enrichment.py

No tocar todavía

  • data/commercial/*.jsonl

  • data/commercial/backups/

  • notebooks legacy útiles

  • gemelo operativo

Orden propuesto

Fase 1 — Documentar frontera de módulos

Sin mover archivos.

Objetivo:

  • declarar qué pertenece al dominio comercial,

  • qué pertenece a UI,

  • qué pertenece a persistencia,

  • qué sigue como transitorio.

Fase 2 — Migración controlada de src/commercial

Mover gradualmente:

  • src/commercial/strategic_scoring.py

  • src/commercial/prospect_enrichment.py

a:

  • prodisys/comercial/strategic_scoring.py

  • prodisys/comercial/prospect_enrichment.py

Solo después de verificar imports.

Fase 3 — Compatibilidad temporal

Mantener wrappers en src/commercial durante una transición corta.

Fase 4 — Unificación CRM state

Normalizar:

  • crm.crm_state

manteniendo:

  • crm.state

como legacy read-only.

Fase 5 — Persistencia JSONL

Continuar convergencia hacia:

  • prodisys/comercial/ui/persistence.py

sin alterar semántica de datos.

Regla de oro

Un refactor por commit.