erp-construccion/orchestration/00-guidelines/HERENCIA-SPECS-CORE.md

160 lines
5.2 KiB
Markdown

# Herencia de SPECS del Core - Construcción
**Fecha:** 2025-12-08
**Versión:** 1.0
**Vertical:** Construcción (MAI/MAE)
**Nivel:** 2B.2
---
## Resumen
| Métrica | Valor |
|---------|-------|
| SPECS Aplicables | 26/30 |
| SPECS Obligatorias | 22 |
| SPECS Opcionales | 4 |
| SPECS No Aplican | 4 |
| Estado Implementación | 0% |
---
## SPECS Obligatorias (Deben Implementarse)
### P0 - Críticas
| SPEC | Gap Original | SP | Estado | Módulos Afectados |
|------|-------------|----:|--------|-------------------|
| SPEC-SISTEMA-SECUENCIAS | ir.sequence | 8 | PENDIENTE | MAI-001, MAE-001 |
| SPEC-VALORACION-INVENTARIO | FIFO/AVCO | 21 | PENDIENTE | MAI-004, MAI-012 |
| SPEC-SEGURIDAD-API-KEYS-PERMISOS | API Keys + ACL | 31 | PENDIENTE | MAI-001 |
| SPEC-REPORTES-FINANCIEROS | Balance/P&L SAT | 13 | PENDIENTE | MAE-003 |
| SPEC-PORTAL-PROVEEDORES | Portal RFQ | 13 | PENDIENTE | MAI-006 |
| SPEC-NOMINA-BASICA | hr_payroll | 21 | PENDIENTE | MAI-008 |
| SPEC-GASTOS-EMPLEADOS | hr_expense | 13 | PENDIENTE | MAI-008 |
| SPEC-TAREAS-RECURRENTES | project.task.recurrence | 13 | PENDIENTE | MAI-002, MAI-005 |
| SPEC-SCHEDULER-REPORTES | ir.cron + mail | 8 | PENDIENTE | MAE-003 |
### P1 - Complementarias
| SPEC | Gap Original | SP | Estado | Módulos Afectados |
|------|-------------|----:|--------|-------------------|
| SPEC-CONTABILIDAD-ANALITICA | Centros de costo | 21 | PENDIENTE | MAE-003 |
| SPEC-CONCILIACION-BANCARIA | Conciliación | 21 | PENDIENTE | MAE-003 |
| SPEC-FIRMA-ELECTRONICA-NOM151 | e.firma | 13 | PENDIENTE | MAE-001, MAI-007 |
| SPEC-TWO-FACTOR-AUTHENTICATION | 2FA | 13 | PENDIENTE | MAI-001 |
| SPEC-TRAZABILIDAD-LOTES-SERIES | Lotes/Series | 13 | PENDIENTE | MAI-004, MAI-012 |
| SPEC-BLANKET-ORDERS | Órdenes marco | 13 | PENDIENTE | MAI-006 |
| SPEC-IMPUESTOS-AVANZADOS | IVA, ISR | 8 | PENDIENTE | MAE-003 |
| SPEC-PLANTILLAS-CUENTAS | Plan contable | 8 | PENDIENTE | MAE-003 |
| SPEC-TASAS-CAMBIO-AUTOMATICAS | Tipos cambio | 5 | PENDIENTE | MAE-003 |
| SPEC-ALERTAS-PRESUPUESTO | Alertas | 8 | PENDIENTE | MAI-012 |
| SPEC-PRESUPUESTOS-REVISIONES | Aprobación | 8 | PENDIENTE | MAI-005, MAI-012 |
| SPEC-RRHH-EVALUACIONES-SKILLS | Evaluaciones | 26 | PENDIENTE | MAI-008 |
| SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN | Burndown | 13 | PENDIENTE | MAI-002, MAI-005 |
| SPEC-LOCALIZACION-PAISES | Localización | 13 | PENDIENTE | MAE-001 |
### Patrones Técnicos
| SPEC | Patrón | SP | Estado | Aplicación |
|------|--------|----:|--------|------------|
| SPEC-MAIL-THREAD-TRACKING | mail.thread | 13 | PENDIENTE | Proyectos, Estimaciones, Obras |
| SPEC-WIZARD-TRANSIENT-MODEL | TransientModel | 8 | PENDIENTE | Wizards de cierre, aprobación |
---
## SPECS Opcionales
| SPEC | Descripción | SP | Decisión | Razón |
|------|-------------|----:|----------|-------|
| SPEC-INTEGRACION-CALENDAR | Calendario | 8 | EVALUAR | Útil para programación de obra |
| SPEC-PRICING-RULES | Reglas precio | 8 | EVALUAR | Para cotizaciones complejas |
| SPEC-OAUTH2-SOCIAL-LOGIN | OAuth2 | 8 | DIFERIR | No prioritario |
| SPEC-CONSOLIDACION-FINANCIERA | Multi-empresa | 13 | DIFERIR | Futuro para constructoras grandes |
---
## SPECS No Aplicables
| SPEC | Razón |
|------|-------|
| SPEC-INVENTARIOS-CICLICOS | No hay inventario tradicional de productos |
| SPEC-INTEGRACION-CALENDAR | El módulo de proyectos maneja calendario propio |
---
## Adaptaciones Requeridas
### Mapeo de Conceptos Core → Construcción
| Concepto Core | Concepto Construcción |
|---------------|----------------------|
| `projects.projects` | Obras, Fraccionamientos |
| `projects.tasks` | Etapas de construcción |
| `inventory.products` | Materiales de construcción |
| `inventory.lots` | Lotes de materiales |
| `hr.employees` | Trabajadores de obra |
| `sales.sale_orders` | Contratos de obra |
| `purchase.purchase_orders` | Órdenes de compra de materiales |
### Extensiones de Entidad
```sql
-- Extensión de projects para construcción
construction.project_extensions (
project_id projects.projects,
tipo_obra ENUM,
numero_licencia VARCHAR,
fecha_inicio_obra DATE,
fecha_fin_estimada DATE,
m2_construccion DECIMAL,
presupuesto_aprobado DECIMAL
)
-- Extensión de employees para construcción
construction.employee_extensions (
employee_id hr.employees,
numero_imss VARCHAR,
categoria_obra ENUM,
especialidad VARCHAR,
certificaciones JSONB
)
```
---
## Plan de Implementación
### Fase 1: Fundamentos (SP: 60)
1. SPEC-SISTEMA-SECUENCIAS
2. SPEC-SEGURIDAD-API-KEYS-PERMISOS
3. SPEC-TWO-FACTOR-AUTHENTICATION
### Fase 2: Core de Negocio (SP: 80)
4. SPEC-VALORACION-INVENTARIO
5. SPEC-TRAZABILIDAD-LOTES-SERIES
6. SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN
### Fase 3: Financiero (SP: 65)
7. SPEC-REPORTES-FINANCIEROS
8. SPEC-CONTABILIDAD-ANALITICA
9. SPEC-IMPUESTOS-AVANZADOS
### Fase 4: RRHH (SP: 60)
10. SPEC-NOMINA-BASICA
11. SPEC-GASTOS-EMPLEADOS
12. SPEC-RRHH-EVALUACIONES-SKILLS
---
## Referencias
- Documento Core: `erp-core/docs/04-modelado/MAPEO-SPECS-VERTICALES.md`
- SPECS del Core: `erp-core/docs/04-modelado/especificaciones-tecnicas/transversal/`
- Herencia DB: `database/HERENCIA-ERP-CORE.md`
---
**Documento de herencia de SPECS oficial**
**Última actualización:** 2025-12-08