erp-core/docs/05-user-stories/FASE-8-CORRECCIONES-P2-P3.md
rckrdmrd 4c4e27d9ba feat: Documentation and orchestration updates
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 05:35:20 -06:00

268 lines
8.7 KiB
Markdown

# 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