erp-core/docs/05-user-stories/FASE-8-CORRECCIONES-P2-P3.md

FASE 8: Reporte de Correcciones P2/P3

Fecha: 2026-01-04 Objetivo: Documentar las correcciones P2/P3 aplicadas a los archivos DDL Estado: Completado Basado en: FASE-7 (Validacion Final)

---

1. Resumen Ejecutivo

Se implementaron 6 correcciones de prioridad P2/P3 que completan la alineacion con Odoo:

ID	Correccion	Archivo	Estado
COR-014	Predictive Lead Scoring	11-crm.sql	APLICADO
COR-015	Multi-plan Analytics Hierarchy	03-analytics.sql	APLICADO
COR-016	Recurring Tasks	08-projects.sql	APLICADO
COR-017	Multi-user Assignment	08-projects.sql	APLICADO
COR-019	Auto-assignment Rules	11-crm.sql	APLICADO
COR-020	Duplicate Detection	02-core.sql	APLICADO

Total: 6/6 correcciones P2/P3 aplicadas (100%)

---

2. Detalle por Correccion

2.1 COR-014: Predictive Lead Scoring (CRM)

Archivo: database/ddl/11-crm.sql

Nuevas Tablas:

• crm.lead_scoring_rules - Reglas de scoring configurables
• crm.lead_scoring_history - Historial de cambios de score

Nuevos Campos en leads/opportunities:

• automated_score INTEGER - Score calculado automaticamente
• manual_score_adjustment INTEGER - Ajuste manual
• total_score INTEGER - Score total (GENERATED)
• score_calculated_at TIMESTAMP - Ultima fecha de calculo
• score_tier VARCHAR - Clasificacion (hot/warm/cold)

Nuevas Funciones:

• crm.calculate_lead_score(UUID) - Calcula score basado en reglas

Caracteristicas:

• Reglas basadas en JSONB para flexibilidad
• Soporte para operadores: equals, not_equals, contains, greater_than, less_than
• Scoring por field_value, activity, demographic, behavioral
• Historial completo de cambios de score

2.2 COR-015: Multi-plan Analytics Hierarchy

Archivo: database/ddl/03-analytics.sql

Cambios en analytic_plans:

• parent_id UUID - Para jerarquia de planes
• full_path TEXT - Path completo generado
• code VARCHAR(50) - Codigo unico
• sequence INTEGER - Orden de visualizacion
• applicability VARCHAR - mandatory/optional/unavailable
• default_applicability VARCHAR - Aplicabilidad por defecto
• color VARCHAR - Color para UI

Nuevas Funciones:

• analytics.update_analytic_plan_path() - Actualiza full_path automaticamente

Nuevo Trigger:

• trg_analytic_plans_update_path - Trigger para mantener full_path

2.3 COR-016: Recurring Tasks (Project)

Archivo: database/ddl/08-projects.sql

Nuevo ENUM:

• projects.recurrence_type - daily, weekly, monthly, yearly, custom

Nuevos Campos en tasks:

• is_recurring BOOLEAN - Indica si es recurrente
• recurrence_type - Tipo de recurrencia
• recurrence_interval INTEGER - Intervalo (cada N dias/semanas/etc)
• recurrence_weekdays INTEGER[] - Dias de la semana (0-6)
• recurrence_month_day INTEGER - Dia del mes
• recurrence_end_type VARCHAR - never/count/date
• recurrence_count INTEGER - Numero de repeticiones
• recurrence_end_date DATE - Fecha fin
• recurrence_parent_id UUID - Tarea padre
• last_recurrence_date DATE - Ultima generacion
• next_recurrence_date DATE - Proxima generacion

Nuevas Funciones:

• projects.create_next_recurring_task(UUID) - Crea siguiente ocurrencia

2.4 COR-017: Multi-user Assignment (Project)

Archivo: database/ddl/08-projects.sql

Nueva Tabla:

• projects.task_assignees - Asignacion multiple de usuarios

Campos:

• task_id UUID - Tarea
• user_id UUID - Usuario asignado
• role VARCHAR - Rol (assignee/reviewer/observer)
• is_primary BOOLEAN - Usuario principal

Caracteristicas:

• Mantiene compatibilidad con assigned_to en tasks
• Soporta multiples roles por tarea
• Se copia automaticamente en tareas recurrentes

2.5 COR-019: Auto-assignment Rules (CRM)

Archivo: database/ddl/11-crm.sql

Nueva Tabla:

• crm.lead_assignment_rules - Reglas de asignacion

Campos:

• conditions JSONB - Condiciones de matching
• assignment_type VARCHAR - user/team/round_robin
• user_id UUID - Usuario fijo
• sales_team_id UUID - Equipo de ventas
• round_robin_users UUID[] - Lista para round-robin
• last_assigned_user_id UUID - Tracking de round-robin

Nuevas Funciones:

• crm.auto_assign_lead(UUID) - Asigna lead automaticamente

Caracteristicas:

• Soporte para asignacion fija a usuario
• Soporte para asignacion a lider de equipo
• Soporte para round-robin entre usuarios

2.6 COR-020: Duplicate Detection (Partners)

Archivo: database/ddl/02-core.sql

Nueva Tabla:

• core.partner_duplicates - Posibles duplicados detectados

Campos:

• partner1_id, partner2_id UUID - Partners comparados
• similarity_score INTEGER - Puntuacion (0-100)
• matching_fields JSONB - Campos que coinciden
• status VARCHAR - pending/merged/ignored/false_positive

Nuevas Funciones:

• core.calculate_partner_similarity(UUID, UUID) - Calcula similitud
• core.find_partner_duplicates(UUID, INTEGER) - Busca duplicados
• core.auto_detect_duplicates_on_create() - Trigger function

Nuevo Trigger:

• trg_partners_detect_duplicates - Detecta duplicados al crear

Criterios de Scoring:

• Email exacto: 40 puntos
• Telefono exacto: 20 puntos
• Tax ID exacto: 30 puntos
• Nombre exacto: 30 puntos
• Nombre parcial: 15 puntos

---

3. Resumen de Cambios

3.1 Nuevas Tablas (6)

Schema	Tabla	Campos	Descripcion
crm	lead_scoring_rules	11	Reglas de scoring
crm	lead_scoring_history	9	Historial de scoring
crm	lead_assignment_rules	12	Reglas de asignacion
projects	task_assignees	6	Asignacion multiple
core	partner_duplicates	10	Duplicados detectados

3.2 Nuevos Campos (22)

Tabla	Campo	Tipo
crm.leads	automated_score	INTEGER
crm.leads	manual_score_adjustment	INTEGER
crm.leads	total_score	INTEGER (GENERATED)
crm.leads	score_calculated_at	TIMESTAMP
crm.leads	score_tier	VARCHAR
crm.opportunities	automated_score	INTEGER
crm.opportunities	manual_score_adjustment	INTEGER
crm.opportunities	total_score	INTEGER (GENERATED)
crm.opportunities	score_calculated_at	TIMESTAMP
crm.opportunities	score_tier	VARCHAR
analytics.analytic_plans	parent_id	UUID
analytics.analytic_plans	full_path	TEXT
analytics.analytic_plans	code	VARCHAR
analytics.analytic_plans	sequence	INTEGER
analytics.analytic_plans	applicability	VARCHAR
analytics.analytic_plans	default_applicability	VARCHAR
analytics.analytic_plans	color	VARCHAR
projects.tasks	is_recurring	BOOLEAN
projects.tasks	recurrence_type	ENUM
projects.tasks	recurrence_interval	INTEGER
projects.tasks	(+ 8 campos mas de recurrencia)	...

3.3 Nuevas Funciones (6)

Schema	Funcion	Descripcion
crm	calculate_lead_score	Calcula score de lead
crm	auto_assign_lead	Asigna lead automaticamente
analytics	update_analytic_plan_path	Actualiza path de plan
projects	create_next_recurring_task	Crea tarea recurrente
core	calculate_partner_similarity	Calcula similitud
core	find_partner_duplicates	Busca duplicados

3.4 Nuevos Triggers (2)

Schema	Trigger	Tabla	Descripcion
analytics	trg_analytic_plans_update_path	analytic_plans	Actualiza path
core	trg_partners_detect_duplicates	partners	Detecta duplicados

3.5 Nuevos ENUMs (1)

Schema	ENUM	Valores
projects	recurrence_type	daily, weekly, monthly, yearly, custom

---

4. Archivos Modificados

Archivo	Lineas Agregadas	Correcciones
11-crm.sql	~330	COR-014, COR-019
03-analytics.sql	~30	COR-015
08-projects.sql	~150	COR-016, COR-017
02-core.sql	~220	COR-020

Total: ~730 lineas de codigo SQL agregadas

---

5. Metricas Consolidadas (P1 + P2/P3)

Metrica	P1 (FASE 6-7)	P2/P3 (FASE 8)	Total
Correcciones	14	6	20
Tablas nuevas	9	5	14
Campos nuevos	25	22+	47+
Funciones nuevas	2	6	8
ENUMs nuevos/modificados	3	1	4
Triggers nuevos	0	2	2

---

6. Proximos Pasos

1. Validacion de sintaxis: Ejecutar validacion SQL en todos los archivos
2. Tests unitarios: Crear tests para nuevas funciones
3. Documentacion API: Actualizar documentacion de endpoints
4. Migracion: Crear scripts de migracion para entornos existentes

---

Generado: 2026-01-04 Herramienta: Claude Code Estado Final: TODAS LAS CORRECCIONES P2/P3 COMPLETADAS