rckrdmrd/erp-construccion
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1b19b82073
erp-construccion/docs/02-definicion-modulos/CAMBIOS-Y-ACTUALIZACIONES.md

14 KiB
Raw Blame History

Cambios y Actualizaciones - Fase 1 Ajustada

Fecha: 2025-11-17 Versión: 2.0.0 Estado: ✅ Completo - Listo para revisión

📢 Resumen de Cambios

Basado en el feedback del usuario sobre la importancia de RRHH y asistencias para obra, se realizaron los siguientes ajustes al roadmap inicial:

Cambio Principal: RRHH Movido a Fase 1

Antes:

  • Fase 1: 6 épicas | 14 semanas | $150,000 MXN | 280 SP
  • RRHH estaba en Fase 2

Después:

  • Fase 1: 7 épicas | 16 semanas | $175,000 MXN | 330 SP
  • RRHH incluido en Fase 1 como épica MAI-006 (Prioridad P0)

🎯 Justificación del Cambio

Por qué RRHH debe estar en Fase 1:

  1. Costeo de Mano de Obra es Crítico

    • Necesario para calcular costos reales vs presupuesto
    • Sin RRHH, los reportes de costos están incompletos

  2. Cumplimiento Legal desde Día 1

    • IMSS: Afiliación obligatoria desde el primer día de trabajo
    • INFONAVIT: Aportaciones patronales del 5% mensuales
    • Sanciones por incumplimiento son severas

  3. Control de Personal en Obra

    • Asistencia biométrica evita "aviadores" (trabajadores fantasma)
    • GPS valida que el personal esté realmente en obra
    • Fundamental para productividad y seguridad

  4. Sinergia con App Móvil

    • La app ya se usa para captura de avances (MAI-005)
    • Agregar asistencia biométrica aprovecha el mismo dispositivo
    • Residentes de obra usan 1 sola app para todo

📁 Documentación Generada (Nueva y Actualizada)

Documentos Nuevos ⭐

Archivo Descripción Tamaño
ROADMAP-DETALLADO.md Roadmap completo con 11 sprints detallados ~30 KB
MAI-007-rrhh-asistencias/_MAP.md Épica completa de RRHH ~15 KB
CAMBIOS-Y-ACTUALIZACIONES.md Este documento ~8 KB

Documentos Actualizados 🔄

Archivo Cambios
README.md Actualizado a 7 épicas, presupuesto $175K, 16 semanas
_MAP.md Tabla de épicas actualizada, nuevo total de SP
RESUMEN-EJECUTIVO.md Pendiente de actualización

🗓️ Roadmap Ajustado - Fase 1

Sprints Overview

Sprint Semanas Épica Entregable Principal
Sprint 0 1 Migración Infraestructura base desde GAMILIT
Sprint 1 2-3 MAI-001 Autenticación + Multi-tenancy
Sprint 2 4-5 MAI-002 Gestión de proyectos
Sprint 3-4 6-8 MAI-003 Presupuestos y costos
Sprint 5-6 9-10.5 MAI-004 Compras e inventarios
Sprint 7-8 11-13 MAI-005 Control de obra + App móvil v1
Sprint 9-10 13.5-16 MAI-006 ⭐ RRHH + Asistencia biométrica + IMSS/INFONAVIT
Sprint 11 16-17 MAI-007 Reportes y analytics

Total: 16 semanas | 11 sprints | $175,000 MXN

📱 Especificaciones de App Móvil (MAI-006)

Funcionalidades Principales

1. Asistencia con Biométrico ⭐⭐

Métodos de registro:

  • Huella dactilar (react-native-biometrics)
  • Reconocimiento facial (react-native-camera)
  • QR Code (react-native-qrcode-scanner)
  • Lista manual (fallback)

Validaciones automáticas:

  • ✅ GPS: Empleado dentro del radio de la obra (100m)
  • ✅ Horario: Dentro de jornada laboral (6am-8pm)
  • ✅ Estado: Empleado activo y asignado a la obra
  • ✅ Duplicados: No permitir doble check-in

2. Modo Offline

  • Base de datos local (expo-sqlite)
  • Cola de hasta 500 registros
  • Sincronización automática al reconectar
  • Cache de empleados y templates biométricos

3. Flujo de Usuario

1. Residente abre app
2. Selecciona obra activa
3. Modo "Check-in" o "Check-out"
4. Opciones:
   a) Escanear QR del empleado
   b) Buscar en lista
   c) Captura biométrica
5. Sistema valida (GPS, horario, estado)
6. Captura foto opcional
7. Registra asistencia (online o cola)
8. Confirmación con vibración/sonido

🔌 Integraciones Externas

1. IMSS (Instituto Mexicano del Seguro Social)

API: SOAP/REST Autenticación: Certificado digital (.cer + .key)

Funcionalidades:

  • Alta/baja/modificación de trabajadores
  • Generación de archivos SUA (Sistema Único de Autodeterminación)
  • Consulta de vigencia de derechos
  • Cálculo de cuotas obrero-patronales

Endpoints implementados:

POST /api/imss/afiliacion/alta
POST /api/imss/afiliacion/baja
POST /api/imss/afiliacion/modificacion
POST /api/imss/sua/generar
GET  /api/imss/vigencia/:nss

2. INFONAVIT

API: REST Autenticación: OAuth 2.0 + API Key

Funcionalidades:

  • Registro patronal
  • Cálculo de aportaciones (5% del salario base)
  • Generación de archivo de pago
  • Consulta de trabajadores acreditados (con crédito INFONAVIT)
  • Descuentos de crédito

Endpoints implementados:

POST /api/infonavit/patron/registro
POST /api/infonavit/aportaciones/calcular
POST /api/infonavit/aportaciones/generar-archivo
GET  /api/infonavit/trabajadores/acreditados/:rfc
POST /api/infonavit/descuentos/aplicar

Cálculo de aportación:

const aportacionMensual = salarioBaseCotizacion * diasTrabajados * 0.05;

📊 Comparación Antes vs Después

Métrica Versión 1.0 (Antes) Versión 2.0 (Después) Diferencia
Épicas 6 7 +1 (RRHH)
Presupuesto $150,000 $175,000 +$25,000
Story Points 280 SP 330 SP +50 SP
Duración 14 semanas 16 semanas +2 semanas
Integraciones 0 2 (IMSS, INFONAVIT) +2
App móvil features Avances + Incidencias + Asistencia biométrica +1 módulo

🎯 Épicas de Fase 1 (Final)

# Épica Nombre SP Presupuesto Prioridad
1 MAI-001 Fundamentos 50 $25,000 P0 - Crítico
2 MAI-002 Proyectos y Estructura 45 $25,000 P0 - Crítico
3 MAI-003 Presupuestos y Costos 50 $25,000 P1 - Alto
4 MAI-004 Compras e Inventarios 50 $25,000 P1 - Alto
5 MAI-005 Control de Obra y Avances 45 $25,000 P0 - Crítico
6 MAI-006 ⭐ RRHH, Asistencias y Nómina 50 $25,000 P0 - Crítico
7 MAI-007 Reportes y Analytics 40 $25,000 P1 - Alto

Total: 330 SP | $175,000 MXN | 16 semanas

🚀 Hitos Críticos (Actualizados)

Semana Hito Entregable
Semana 1 Sprint 0 completado Infraestructura base migrada
Semana 3 MAI-001 completado Auth + Multi-tenancy
Semana 5 MAI-002 completado Gestión de proyectos
Semana 8 MAI-003 completado Presupuestos y costos
Semana 10.5 MAI-004 completado Compras e inventarios
Semana 13 MAI-005 completado Control de obra + App móvil v1
Semana 16 MAI-006 completado ⭐ RRHH + Asistencia biométrica + IMSS/INFONAVIT
Semana 17 MAI-007 completado Reportes y analytics
Semana 17 🎉 Fase 1 completa Deploy a staging

📋 Stack Tecnológico de App Móvil

Dependencias Principales

{
  "dependencies": {
    "react": "18.2.0",
    "react-native": "0.73.0",
    "expo": "~50.0.0",
    "expo-sqlite": "~13.0.0",
    "expo-camera": "~14.0.0",
    "@react-native-community/geolocation": "^3.1.0",
    "react-native-biometrics": "^3.0.0",
    "react-native-qrcode-scanner": "^1.5.5",
    "react-native-maps": "^1.10.0",
    "zustand": "^4.4.0",
    "axios": "^1.6.0",
    "@tanstack/react-query": "^5.0.0"
  }
}

Features de la App

Feature Biblioteca Propósito
Biométrico (huella) react-native-biometrics Autenticación y asistencia
Biométrico (facial) expo-camera + ML Reconocimiento facial
QR Scanner react-native-qrcode-scanner Escanear QR de empleados
GPS @react-native-community/geolocation Validar ubicación en obra
Maps react-native-maps Visualizar radio de obra
Database Local expo-sqlite Modo offline
State Management Zustand Estado global
API Calls axios + react-query Comunicación con backend

🎓 Capacitación Adicional Requerida

Para Equipo de Desarrollo

Tema Duración Cuándo Quién
React Native Fundamentals 8 horas Sprint 7 Mobile developer
Biometrics en React Native 4 horas Sprint 9 Mobile developer
Integración IMSS/INFONAVIT 4 horas Sprint 9 Backend lead
Generación de archivos SUA 2 horas Sprint 9 Backend team
Testing de app móvil 4 horas Sprint 9 QA engineer

🚨 Riesgos Específicos de MAI-006

Riesgo Probabilidad Impacto Mitigación
Integración IMSS/INFONAVIT compleja Alta Alto Iniciar pruebas con sandbox desde Sprint 5
Certificados IMSS difíciles de obtener Media Alto Solicitar certificados al inicio del proyecto
APIs gubernamentales inestables Media Medio Implementar retry logic y fallbacks
Biométrico no funciona en todos devices Media Medio Fallback a QR + foto
GPS impreciso en algunas obras Alta Bajo Radio amplio (100m), permitir override
Sincronización offline falla Media Alto Cola persistente con retry automático

✅ Checklist de Implementación MAI-006

Backend

  • CRUD de empleados, cuadrillas, oficios
  • API de registro de asistencia
  • Validaciones (GPS, horario, estado)
  • Servicio de cálculo de costeo de mano de obra
  • Integración IMSS (sandbox → producción)
  • Integración INFONAVIT (sandbox → producción)
  • Generación de archivos SUA
  • Exportación de reportes

App Móvil

  • Login y autenticación
  • Selector de obra
  • Scanner QR
  • Captura biométrica (huella)
  • Captura biométrica (facial) - opcional
  • GPS validation
  • Base de datos local (SQLite)
  • Cola de sincronización offline
  • UI/UX optimizada para campo

Frontend Web

  • Gestión de empleados
  • Dashboard de asistencias
  • Reportes de costeo
  • Exportación IMSS/INFONAVIT
  • Logs de sincronización

Database

  • Schemas: hr, attendance, payroll
  • Tablas de empleados, asistencia, costeo
  • Funciones de cálculo
  • Triggers de validación
  • Índices optimizados

Testing

  • Unit tests >80% coverage
  • E2E tests de flujo completo
  • Integration tests con IMSS/INFONAVIT (sandbox)
  • Tests de app móvil (offline, GPS, biométrico)

Deployment

  • Variables de entorno (API keys, certificados)
  • Secrets management (certificados IMSS encrypted)
  • Deploy de app a TestFlight (iOS)
  • Deploy de app a Google Play (Android)
  • Configuración de monitoreo
  • Documentación de integración

📞 Próximos Pasos Inmediatos

Esta Semana

  • Aprobar roadmap ajustado (7 épicas, 16 semanas, $175K)
  • Confirmar que RRHH en Fase 1 es correcto
  • Validar presupuesto adicional de $25,000 MXN
  • Revisar especificaciones de app móvil

Próxima Semana

  • Completar documentos RF, ET, US de MAI-006
  • Iniciar gestión de certificados IMSS
  • Solicitar acceso a APIs sandbox de IMSS/INFONAVIT
  • Asignar mobile developer al equipo

Sprint 0 (Semana 1)

  • Setup de repositorio
  • Migración de componentes GAMILIT
  • Configurar proyecto de app móvil (React Native + Expo)

💡 Recomendaciones Finales

Priorizar Integraciones IMSS/INFONAVIT

  • Iniciar gestión de certificados desde Sprint 1
  • Proceso puede tomar 2-4 semanas
  • Solicitar acceso a sandboxes inmediatamente

App Móvil Simplificada al Inicio

  • Sprint 7-8: App con avances + incidencias (básico)
  • Sprint 9-10: Agregar asistencia biométrica
  • No intentar todo en un solo sprint

Testing Exhaustivo de Modo Offline

  • Crítico: La obra no siempre tiene buena conexión
  • Probar escenarios:
    • 100+ registros en cola
    • Conflictos de sincronización
    • Batería baja del dispositivo

UX Simple para Residentes

  • Target: Residentes no son técnicos
  • UI debe ser intuitiva, con iconos grandes
  • Flujo de 3-4 taps máximo para registrar asistencia
  • Confirmaciones visuales y hápticas

📊 Métricas de Éxito (Actualizadas)

KPI Target Medición
Tiempo de desarrollo Fase 1 ≤ 16 semanas Tracking semanal
Presupuesto Fase 1 $175,000 ±5% Tracking financiero
Reducción vs desde cero ≥ 25% Comparación post-mortem
Código reutilizado de GAMILIT ≥ 50% Análisis de código
Coverage de tests ≥ 80% CI/CD reports
Bugs críticos en staging 0 Issue tracker
Integración IMSS funcionando ✅ Tests de integración
Integración INFONAVIT funcionando ✅ Tests de integración
App móvil en stores ✅ TestFlight + Play Store

📚 Documentos de Referencia

Generados en esta sesión:

  1. ROADMAP-DETALLADO.md - Roadmap completo con 11 sprints
  2. MAI-007-rrhh-asistencias/_MAP.md - Épica RRHH completa
  3. CAMBIOS-Y-ACTUALIZACIONES.md - Este documento

Actualizados:

  1. README.md - 7 épicas, $175K
  2. _MAP.md - Tabla de épicas actualizada

Pendientes de actualizar:

  1. RESUMEN-EJECUTIVO.md - Reflejar 7 épicas
  2. ANALISIS-REUTILIZACION-GAMILIT.md - Agregar MAI-006

Generado: 2025-11-17 Versión: 2.0.0 Autor: Análisis Técnico Estado: ✅ Completo - Listo para aprobación Próxima acción: Aprobar roadmap y presupuesto ajustado