erp-core/docs/04-modelado/MAPEO-SPECS-VERTICALES.md

214 lines
8.2 KiB
Markdown

# Mapeo de Especificaciones Transversales a Verticales
**Fecha:** 2025-12-08
**Versión:** 1.1
**Autor:** Sistema SIMCO
**Ubicación SPECS:** `docs/04-modelado/especificaciones-tecnicas/transversal/`
---
## Propósito
Este documento define qué especificaciones transversales del ERP-Core son **relevantes como referencia** para cada proyecto vertical del ERP-Suite.
**Importante:** Las verticales son **proyectos independientes** que implementan y adaptan estas specs según su dominio. No son extensiones del core, sino sistemas autónomos que reutilizan patrones donde tiene sentido.
---
## Leyenda
| Símbolo | Significado |
|---------|-------------|
| ✓ | Relevante - Recomendado implementar/adaptar |
| ○ | Opcional - Puede implementarse según necesidad del proyecto |
| ✗ | No relevante - No aporta valor al dominio de la vertical |
---
## Matriz de Aplicabilidad
### SPECS P0 - Funcionales (Críticos)
| SPEC | Descripción | Construcción | Mecánicas | Vidrio | Retail | Clínicas |
|------|-------------|:------------:|:---------:|:------:|:------:|:--------:|
| SPEC-SISTEMA-SECUENCIAS | Secuencias automáticas de documentos | ✓ | ✓ | ✓ | ✓ | ✓ |
| SPEC-VALORACION-INVENTARIO | FIFO/AVCO valorización | ✓ | ✓ | ✓ | ✓ | ○ |
| SPEC-SEGURIDAD-API-KEYS-PERMISOS | API Keys + ACL + RLS | ✓ | ✓ | ✓ | ✓ | ✓ |
| SPEC-REPORTES-FINANCIEROS | Balance/P&L SAT | ✓ | ✓ | ✓ | ✓ | ✓ |
| SPEC-PORTAL-PROVEEDORES | Portal RFQ | ✓ | ✓ | ✓ | ○ | ✗ |
| SPEC-NOMINA-BASICA | hr_payroll | ✓ | ✓ | ✓ | ✓ | ✓ |
| SPEC-GASTOS-EMPLEADOS | hr_expense | ✓ | ✓ | ✓ | ✓ | ✓ |
| SPEC-TAREAS-RECURRENTES | project.task.recurrence | ✓ | ✓ | ✓ | ○ | ○ |
| SPEC-SCHEDULER-REPORTES | ir.cron + mail | ✓ | ✓ | ✓ | ✓ | ✓ |
| SPEC-INTEGRACION-CALENDAR | calendar integration | ○ | ✗ | ✗ | ✗ | ✓ |
### SPECS P1 - Complementarios
| SPEC | Descripción | Construcción | Mecánicas | Vidrio | Retail | Clínicas |
|------|-------------|:------------:|:---------:|:------:|:------:|:--------:|
| SPEC-CONTABILIDAD-ANALITICA-MULTIDIMENSIONAL | Centros de costo | ✓ | ✓ | ✓ | ✓ | ✓ |
| SPEC-CONCILIACION-BANCARIA | Conciliación automática | ✓ | ✓ | ✓ | ✓ | ✓ |
| SPEC-FIRMA-ELECTRONICA-NOM151 | Firma electrónica | ✓ | ○ | ○ | ○ | ✓ |
| SPEC-TWO-FACTOR-AUTHENTICATION | 2FA, TOTP, SMS | ✓ | ✓ | ✓ | ✓ | ✓ |
| SPEC-TRAZABILIDAD-LOTES-SERIES | Lotes y números de serie | ✓ | ✓ | ✓ | ✓ | ✓ |
| SPEC-PRICING-RULES | Reglas de precios | ○ | ✓ | ✓ | ✓ | ○ |
| SPEC-BLANKET-ORDERS | Órdenes marco | ✓ | ✓ | ✓ | ✓ | ✗ |
| SPEC-OAUTH2-SOCIAL-LOGIN | OAuth2, Google, Microsoft | ○ | ○ | ○ | ○ | ✓ |
| SPEC-INVENTARIOS-CICLICOS | Conteo cíclico | ○ | ✓ | ○ | ✓ | ○ |
| SPEC-IMPUESTOS-AVANZADOS | IVA, ISR configurables | ✓ | ✓ | ✓ | ✓ | ✓ |
| SPEC-PLANTILLAS-CUENTAS | Plan de cuentas por país | ✓ | ✓ | ✓ | ✓ | ✓ |
| SPEC-CONSOLIDACION-FINANCIERA | Multi-empresa | ○ | ○ | ○ | ○ | ○ |
| SPEC-TASAS-CAMBIO-AUTOMATICAS | Tipos de cambio | ✓ | ✓ | ✓ | ✓ | ✓ |
| SPEC-ALERTAS-PRESUPUESTO | Alertas de exceso | ✓ | ✓ | ✓ | ✓ | ✓ |
| SPEC-PRESUPUESTOS-REVISIONES | Aprobación de presupuestos | ✓ | ✓ | ✓ | ○ | ○ |
| SPEC-RRHH-EVALUACIONES-SKILLS | Evaluaciones, skills | ✓ | ✓ | ✓ | ✓ | ✓ |
| SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN | Dependencias, burndown | ✓ | ✗ | ✓ | ✗ | ✗ |
| SPEC-LOCALIZACION-PAISES | Configuración por país | ✓ | ✓ | ✓ | ✓ | ✓ |
### Patrones Técnicos P0
| SPEC | Descripción | Construcción | Mecánicas | Vidrio | Retail | Clínicas |
|------|-------------|:------------:|:---------:|:------:|:------:|:--------:|
| SPEC-MAIL-THREAD-TRACKING | mail.thread mixin | ✓ | ✓ | ✓ | ✓ | ✓ |
| SPEC-WIZARD-TRANSIENT-MODEL | TransientModel | ✓ | ✓ | ✓ | ✓ | ✓ |
---
## Resumen por Vertical
### Construcción (MAI/MAE)
- **SPECS Aplicables:** 26/30
- **SPECS Obligatorias:** 22
- **SPECS Opcionales:** 4
- **SPECS No Aplican:** 4
- **Enfoque:** Proyectos, control de obra, estimaciones, RRHH construcción
### Mecánicas-Diesel (MMD)
- **SPECS Aplicables:** 25/30
- **SPECS Obligatorias:** 23
- **SPECS Opcionales:** 2
- **SPECS No Aplican:** 5
- **Enfoque:** Órdenes de trabajo, inventario refacciones, diagnósticos
### Vidrio-Templado (VT)
- **SPECS Aplicables:** 25/30
- **SPECS Obligatorias:** 22
- **SPECS Opcionales:** 3
- **SPECS No Aplican:** 5
- **Enfoque:** Producción, control de calidad, hornos de templado
### Retail (RT)
- **SPECS Aplicables:** 24/30
- **SPECS Obligatorias:** 21
- **SPECS Opcionales:** 3
- **SPECS No Aplican:** 6
- **Enfoque:** POS, inventario multi-sucursal, promociones, caja
### Clínicas (CL)
- **SPECS Aplicables:** 24/30
- **SPECS Obligatorias:** 20
- **SPECS Opcionales:** 4
- **SPECS No Aplican:** 6
- **Enfoque:** Expediente clínico, citas, calendario, cumplimiento normativo
---
## Detalle por Vertical
### Construcción
**SPECS Críticas para el Dominio:**
1. `SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN` - Control de obra y avances
2. `SPEC-VALORACION-INVENTARIO` - Costeo de materiales de construcción
3. `SPEC-TRAZABILIDAD-LOTES-SERIES` - Trazabilidad de materiales
4. `SPEC-PRESUPUESTOS-REVISIONES` - Control presupuestal de obras
**Adaptaciones Requeridas:**
- Proyectos = Obras/Fraccionamientos
- Tareas = Etapas de construcción
- Productos = Materiales de construcción
### Mecánicas-Diesel
**SPECS Críticas para el Dominio:**
1. `SPEC-VALORACION-INVENTARIO` - Costeo de refacciones
2. `SPEC-TRAZABILIDAD-LOTES-SERIES` - Tracking de partes OEM
3. `SPEC-INVENTARIOS-CICLICOS` - Control de stock
4. `SPEC-PRICING-RULES` - Reglas de precio por tipo de servicio
**Adaptaciones Requeridas:**
- Productos = Refacciones, partes
- Órdenes de venta = Órdenes de servicio
- Partners = Clientes con vehículos
### Vidrio-Templado
**SPECS Críticas para el Dominio:**
1. `SPEC-VALORACION-INVENTARIO` - Costeo de materia prima y producto terminado
2. `SPEC-TRAZABILIDAD-LOTES-SERIES` - Lotes de producción de vidrio
3. `SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN` - Órdenes de producción
4. `SPEC-PRICING-RULES` - Precios por dimensiones y tipos de vidrio
**Adaptaciones Requeridas:**
- Productos = Tipos de vidrio (templado, laminado, etc.)
- Producción = Control de hornos y parámetros
- Calidad = Inspecciones de fragmentación
### Retail
**SPECS Críticas para el Dominio:**
1. `SPEC-PRICING-RULES` - Promociones y descuentos
2. `SPEC-INVENTARIOS-CICLICOS` - Conteos en sucursales
3. `SPEC-TRAZABILIDAD-LOTES-SERIES` - Productos con lote/serie
4. `SPEC-VALORACION-INVENTARIO` - Costeo de mercancía
**Adaptaciones Requeridas:**
- Almacenes = Sucursales
- Ventas = Transacciones POS
- Clientes = Programa de lealtad
### Clínicas
**SPECS Críticas para el Dominio:**
1. `SPEC-INTEGRACION-CALENDAR` - Agenda de citas médicas
2. `SPEC-MAIL-THREAD-TRACKING` - Historial de comunicación con pacientes
3. `SPEC-RRHH-EVALUACIONES-SKILLS` - Credenciales médicas
4. `SPEC-FIRMA-ELECTRONICA-NOM151` - Firma de expedientes
**Adaptaciones Requeridas:**
- Partners = Pacientes
- Productos = Servicios médicos, medicamentos
- Calendario = Agenda de consultas
- Cumplimiento = NOM-024-SSA3-2012
---
## Workflows Aplicables
| Workflow | Construcción | Mecánicas | Vidrio | Retail | Clínicas |
|----------|:------------:|:---------:|:------:|:------:|:--------:|
| WORKFLOW-CIERRE-PERIODO-CONTABLE | ✓ | ✓ | ✓ | ✓ | ✓ |
| WORKFLOW-3-WAY-MATCH | ✓ | ✓ | ✓ | ○ | ○ |
| WORKFLOW-PAGOS-ANTICIPADOS | ✓ | ✓ | ✓ | ✗ | ✓ |
---
## Próximos Pasos
1. Crear `HERENCIA-SPECS-CORE.md` en cada vertical con detalle de implementación
2. Actualizar `HERENCIA-ERP-CORE.md` con referencia a SPECS aplicables
3. Documentar adaptaciones específicas por vertical en carpeta `transversal-core/`
---
## Referencias
- SPECS del Core: `erp-core/docs/04-modelado/especificaciones-tecnicas/transversal/`
- Análisis de Gaps: `erp-core/orchestration/01-analisis/ANALISIS-GAPS-CONSOLIDADO.md`
- Directiva de Extensión: `erp-core/orchestration/directivas/DIRECTIVA-EXTENSION-VERTICALES.md`
---
**Documento de referencia canónico para propagación de SPECS**
**Última actualización:** 2025-12-08