# Modulo: CRM

**Odoo Module:** crm
**Version:** 1.9
**Categoria:** Sales/CRM
**Es Aplicacion:** Si

---

## 1. Descripcion General

El modulo **crm** gestiona el pipeline de ventas completo de Odoo.
Desde leads hasta oportunidades ganadas/perdidas con scoring predictivo.

### Funcionalidades Principales:
- **Leads/Opportunities (crm.lead):** Gestion unificada de prospectos
- **Pipeline de Ventas (crm.stage):** Etapas configurables
- **Equipos de Venta (crm.team):** Organizacion comercial
- **Predictive Lead Scoring (PLS):** Probabilidades automaticas
- **Conversion Lead→Opportunity:** Flujo de calificacion
- **Fusion de Oportunidades:** Merge de duplicados

---

## 2. Dependencias

### 2.1 Dependencias Explicitas (manifest)

| Modulo | Tipo | Descripcion |
|--------|------|-------------|
| base_setup | Requerido | Configuracion base |
| sales_team | Requerido | Equipos de venta |
| mail | Requerido | Mensajeria |
| calendar | Requerido | Calendario |
| resource | Requerido | Recursos |
| utm | Requerido | Tracking UTM |
| web_tour | Requerido | Tours guiados |
| contacts | Requerido | Contactos |
| digest | Requerido | Resumenes |
| phone_validation | Requerido | Validacion telefonos |

### 2.2 Dependencias Implicitas

| Modelo Externo | Campo | Modulo Origen |
|---------------|-------|---------------|
| res.partner | partner_id | base |
| res.company | company_id | base |
| res.users | user_id | base |
| crm.team | team_id | sales_team |
| utm.campaign | campaign_id | utm |

---

## 3. Modelos Principales

### 3.1 CRM Core

| Modelo | Descripcion | Archivo |
|--------|-------------|---------|
| crm.lead | Leads/Opportunities | crm_lead.py |
| crm.stage | Etapas pipeline | crm_stage.py |
| crm.team | Extension equipos | crm_team.py |
| crm.team.member | Miembros equipo | crm_team_member.py |

### 3.2 Configuracion

| Modelo | Descripcion | Archivo |
|--------|-------------|---------|
| crm.lost.reason | Razones de perdida | crm_lost_reason.py |
| crm.recurring.plan | Planes recurrentes | crm_recurring_plan.py |
| crm.tag | Etiquetas | crm_tag.py (sales_team) |

### 3.3 Lead Scoring

| Modelo | Descripcion | Archivo |
|--------|-------------|---------|
| crm.lead.scoring.frequency | Frecuencias Naive Bayes | crm_lead_scoring_frequency.py |

---

## 4. Tipos de Registro (type)

| Tipo | Descripcion | Uso |
|------|-------------|-----|
| lead | Lead | Pre-calificado, requiere investigacion |
| opportunity | Opportunity | Calificado, en proceso de venta |

---

## 5. Estados de Oportunidad (won_status)

| Estado | Descripcion | Condicion |
|--------|-------------|-----------|
| won | Ganada | probability=100 Y stage.is_won=True |
| lost | Perdida | active=False Y probability=0 |
| pending | Pendiente | Cualquier otro caso |

---

## 6. Etapas Predeterminadas

| Etapa | Sequence | Descripcion |
|-------|----------|-------------|
| New | 1 | Nueva lead |
| Qualified | 2 | Calificada |
| Proposition | 3 | Propuesta enviada |
| Won | 70 | Ganada (is_won=True) |

---

## 7. Predictive Lead Scoring (PLS)

Sistema Naive Bayes para predecir probabilidad de cierre:

| Componente | Descripcion |
|------------|-------------|
| Variables | country_id, source_id, campaign_id, etc. |
| Frecuencias | won_count, lost_count por valor |
| Calculo | P(Won|A,B) basado en frecuencias |
| Resultado | automated_probability (0-100%) |

---

## 8. Grupos de Seguridad

| Grupo | Permiso |
|-------|---------|
| sales_team.group_sale_salesman | Vendedor |
| sales_team.group_sale_manager | Gerente ventas |

---

## 9. Wizards

| Wizard | Funcion |
|--------|---------|
| crm.lead2opportunity.partner | Convertir lead a opportunity |
| crm.lead.lost | Marcar como perdida |

---

## 10. Estadisticas del Modulo

| Metrica | Valor |
|---------|-------|
| Lineas crm_lead.py | 2,877 |
| Modelos principales | 7 |
| Campos en crm.lead | 80+ |
| Complejidad | ALTA |

---

**Referencias:**
- Fuente: `addons/crm/`
- Manifest: `addons/crm/__manifest__.py`