workspace-v1/shared/knowledge-base/reference/odoo/docs/90-transversal/CLASIFICACION-MODULOS.md

Clasificacion de Modulos Odoo 18.0

Fecha: 2026-01-04 Version: 1.0 Modulos Clasificados: 10 (prioritarios)

---

1. Clasificacion por Tipo

1.1 Modulos de Infraestructura

Modulos que proveen servicios fundamentales para otros modulos.

Modulo	Funcion	Caracteristica Clave
base	Fundamento ORM	res.partner, res.users, ir.*
mail	Mensajeria	Chatter, actividades
analytic	Contabilidad analitica	Distribucion multi-cuenta

1.2 Modulos de Datos Maestros

Modulos que definen entidades centrales del negocio.

Modulo	Entidad	Caracteristica Clave
product	Productos	Variantes, atributos
hr	Empleados	Departamentos, versiones

1.3 Modulos de Proceso

Modulos que implementan flujos de negocio con estados.

Modulo	Proceso	Estados
account	Contabilidad	draft → posted → cancel
stock	Inventario	draft → confirmed → assigned → done
purchase	Compras	draft → sent → purchase → done
sale	Ventas	draft → sent → sale → done
project	Proyectos	in_progress → done/canceled
crm	Comercial	Lead → Opportunity → Won/Lost

---

2. Clasificacion por Complejidad

2.1 Complejidad MUY ALTA

Modulos con:

• Mas de 5,000 lineas de codigo
• Multiples modelos interconectados
• Workflows complejos con estados
• Integracion profunda con otros modulos

Modulo	Lineas	Modelos	Razon Complejidad
base	20,000+	50+	Fundamento de todo
account	10,000+	15+	Regulaciones contables
stock	8,000+	12+	Multi-almacen, valoracion

2.2 Complejidad ALTA

Modulos con:

• 3,000-5,000 lineas
• Workflows definidos
• Logica de negocio significativa

Modulo	Lineas	Modelos	Razon Complejidad
product	3,000+	8	Variantes, atributos
project	4,000+	6	Subtareas, dependencias
crm	3,500+	5	Lead Scoring (ML)

2.3 Complejidad MEDIA-ALTA

Modulo	Lineas	Modelos	Razon Complejidad
purchase	2,500+	4	Flujo aprobacion
sale	3,000+	5	Firmas, pagos online

2.4 Complejidad MEDIA

Modulo	Lineas	Modelos	Razon Complejidad
hr	2,000+	6	Versionado empleados
analytic	1,500+	5	Distribucion JSON

---

3. Clasificacion por Patron de Implementacion

3.1 Patron State Machine

Modulos con campo state y transiciones definidas.

┌─────────┐    action_*()   ┌─────────┐    action_*()   ┌─────────┐
│  draft  │ ──────────────► │ confirm │ ──────────────► │  done   │
└─────────┘                 └─────────┘                 └─────────┘
     │                           │
     └───────────────────────────┴──────────► cancel

Modulos: account, stock, purchase, sale, project

3.2 Patron Stage-Based (Kanban)

Modulos con campo stage_id para progreso visual.

┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐
│ New      │ → │ Working  │ → │ Review   │ → │ Done     │
└──────────┘   └──────────┘   └──────────┘   └──────────┘

Modulos: crm, project

3.3 Patron Master Data

Modulos sin workflow, solo CRUD de datos.

Modulos: product, hr, analytic

3.4 Patron Mixin

Modulos que proveen funcionalidad reutilizable.

Modulo	Mixin	Funcion
mail	mail.thread	Chatter en cualquier modelo
analytic	analytic.mixin	Distribucion analitica
base	portal.mixin	Acceso portal

---

4. Clasificacion por Dominio Funcional

4.1 Finanzas y Contabilidad

Modulo	Funcion	Integracion
account	Libro mayor	purchase, sale, stock
analytic	Centros de costo	project, hr_timesheet

4.2 Cadena de Suministro

Modulo	Funcion	Integracion
stock	Inventario	purchase, sale
purchase	Compras	stock, account

4.3 Ventas y Marketing

Modulo	Funcion	Integracion
sale	Ventas	stock, account, crm
crm	Oportunidades	sale, contacts

4.4 Operaciones

Modulo	Funcion	Integracion
project	Gestion proyectos	analytic, hr_timesheet
hr	Empleados	project, expense

4.5 Datos Maestros

Modulo	Funcion	Usado Por
product	Catalogo	stock, sale, purchase
base	Contactos/Usuarios	TODOS

---

5. Clasificacion por Uso de Recursos

5.1 Modulos CPU-Intensivos

Modulo	Operacion	Mitigacion
crm	Lead Scoring (PLS)	Batch processing
stock	Valoracion FIFO/AVCO	Queue jobs
account	Cierres contables	Async

5.2 Modulos IO-Intensivos

Modulo	Operacion	Mitigacion
stock	Movimientos masivos	Batch write
account	Reconciliacion	Indices PostgreSQL

5.3 Modulos Memoria-Intensivos

Modulo	Operacion	Mitigacion
product	Variantes multiples	Lazy loading
crm	Reportes pipeline	Pagination

---

6. Clasificacion por Riesgo de Cambios

6.1 Riesgo CRITICO

Cambios pueden romper multiples modulos.

Modulo	Razon	Precaucion
base	Fundamento	Tests exhaustivos
account	Regulado	Cumplimiento legal

6.2 Riesgo ALTO

Cambios afectan flujos de negocio importantes.

Modulo	Razon	Precaucion
stock	Inventario fisico	Validacion stock
sale	Ingresos	Tests integracion
purchase	Costos	Aprobaciones

6.3 Riesgo MEDIO

Cambios localizados pero visibles.

Modulo	Razon	Precaucion
project	Productividad	UAT
crm	Pipeline ventas	Validacion usuarios
hr	Datos sensibles	Seguridad

6.4 Riesgo BAJO

Modulos auxiliares o de soporte.

Modulo	Razon
analytic	Sin impacto directo en operaciones

---

7. Matriz de Clasificacion Consolidada

Modulo	Tipo	Complejidad	Patron	Dominio	Riesgo
base	Infra	MUY ALTA	N/A	Datos Maestros	CRITICO
product	Master	ALTA	Master Data	Datos Maestros	MEDIO
account	Proceso	MUY ALTA	State Machine	Finanzas	CRITICO
stock	Proceso	MUY ALTA	State Machine	Supply Chain	ALTO
purchase	Proceso	MEDIA-ALTA	State Machine	Supply Chain	ALTO
sale	Proceso	MEDIA-ALTA	State Machine	Ventas	ALTO
hr	Master	MEDIA	Master Data	Operaciones	MEDIO
crm	Proceso	ALTA	Stage-Based	Ventas	MEDIO
analytic	Infra	MEDIA	Mixin	Finanzas	BAJO
project	Proceso	ALTA	State+Stage	Operaciones	MEDIO

---

8. Recomendaciones por Clasificacion

Para Personalizacion

1. Preferir herencia sobre modificacion directa
2. Modulos auxiliares tienen menor riesgo
3. Tests obligatorios para modulos de proceso

Para Integracion

1. Usar APIs oficiales de modulos core
2. Respetar estados en workflows
3. Validar dependencias antes de desinstalar

Para Rendimiento

1. Batch processing para operaciones masivas
2. Indices para campos de busqueda frecuente
3. Lazy loading para modelos con muchos campos

---

Referencias:

• Analisis de codigo: odoo-18.0/addons/
• Documentacion modelos: 03-modelado-datos/
• Documentacion flujos: 04-logica-negocio/