# MODULES-CATALOG.md - ERP Transportistas

**Version:** 1.0.0
**Fecha:** 2026-01-26
**Total Modulos:** 42 (22 heredados + 20 propios)

---

## Resumen

| Categoria | Cantidad | Estado |
|-----------|----------|--------|
| Heredados de erp-core | 22 | 100% disponibles |
| Propios Fase 1 (MAI) | 15 | DDL 100%, Backend 40% |
| Propios Fase 2 (MAE) | 3 | DDL 100%, Backend 0% |
| Propios Fase 3 (MAA) | 2 | Planificados |

---

## Modulos Heredados (erp-core)

### Foundation (4)

| Codigo | Nombre | Entities | Reutilizacion |
|--------|--------|----------|---------------|
| MGN-001 | Auth | 20 | 100% |
| MGN-002 | Users | 3 | 100% |
| MGN-003 | Roles | 4 | 100% |
| MGN-004 | Tenants | 2 | 100% |

### Core Business (6)

| Codigo | Nombre | Entities | Reutilizacion |
|--------|--------|----------|---------------|
| MGN-005 | Catalogs | 15 | 80% + extensiones |
| MGN-006 | Settings | 8 | 90% |
| MGN-010 | Partners | 5 | 60% + carriers |
| MGN-011 | Inventory | 14 | 50% (refacciones) |
| MGN-012 | Financial | 15 | 70% + transporte |
| MGN-013 | Purchasing | 10 | 60% |

### Extended (5)

| Codigo | Nombre | Entities | Reutilizacion |
|--------|--------|----------|---------------|
| MGN-007 | Audit | 7 | 100% |
| MGN-008 | Notifications | 6 | 100% |
| MGN-009 | Reports | 5 | 50% + KPIs transporte |
| MGN-014 | CRM | 8 | 60% + shippers |
| MGN-015 | Projects | 10 | 30% (viajes como proyectos) |

### SaaS Platform (4)

| Codigo | Nombre | Entities | Reutilizacion |
|--------|--------|----------|---------------|
| MGN-016 | Billing | 5 | 100% |
| MGN-017 | Plans | 3 | 100% |
| MGN-018 | Webhooks | 4 | 100% |
| MGN-019 | Feature Flags | 2 | 100% |

### AI/Intelligence (3)

| Codigo | Nombre | Entities | Reutilizacion |
|--------|--------|----------|---------------|
| MGN-020 | AI Integration | 7 | 80% + rutas |
| MGN-021 | WhatsApp | 5 | 100% |
| MGN-022 | MCP Server | 2 | 70% + tools transporte |

---

## Modulos Propios - Fase 1 (MAI)

### MAI-001: Fundamentos
- **Hereda de:** MGN-001 a MGN-004
- **Estado:** 100% heredado
- **Descripcion:** Auth, RBAC, multi-tenancy

### MAI-002: Clientes y Tarifas
- **Schema:** transport
- **Entities:** Cliente, Lane, Tarifa, Recargo
- **Estado:** DDL 0%, Backend 0%
- **Descripcion:** Shippers, tarifas por lane, SLAs

### MAI-003: Ordenes de Transporte
- **Schema:** transport
- **Entities:** OrdenTransporte, Embarque, Parada, Restriccion
- **Estado:** DDL 100%, Backend 40%
- **Descripcion:** Solicitudes de servicio, multi-paradas

### MAI-004: Planeacion TMS
- **Schema:** transport
- **Entities:** Consolidacion, AsignacionRecurso, CapacidadRuta
- **Estado:** DDL 100%, Backend 0%
- **Descripcion:** Planeacion de carga, capacidad

### MAI-005: Despacho
- **Schema:** transport
- **Entities:** ChecklistPreViaje, Sello, EvidenciaCarga
- **Estado:** DDL 100%, Backend 0%
- **Descripcion:** Liberacion de viajes

### MAI-006: Tracking
- **Schema:** tracking
- **Entities:** EventoTracking, Geocerca, AlertaTracking, ETA
- **Estado:** DDL 100%, Backend 20%
- **Descripcion:** GPS, eventos, alertas

### MAI-007: POD y Cierre
- **Schema:** transport
- **Entities:** POD, FirmaDigital, FotoEntrega, TiempoReal
- **Estado:** DDL 100%, Backend 0%
- **Descripcion:** Proof of Delivery

### MAI-008: Incidencias
- **Schema:** transport
- **Entities:** Incidencia, ReclamoCliente, ImpactoServicio
- **Estado:** DDL 100%, Backend 0%
- **Descripcion:** Reclamaciones

### MAI-009: Facturacion Transporte
- **Schema:** billing
- **Entities:** FacturaTransporte, LineaFactura, FuelSurcharge
- **Estado:** DDL 100%, Backend 30%
- **Descripcion:** Facturacion especializada

### MAI-010: Liquidaciones
- **Schema:** billing
- **Entities:** LiquidacionOperador, Viatico, Deduccion
- **Estado:** DDL 100%, Backend 0%
- **Descripcion:** Pago a operadores

### MAI-011: Gestion de Flota
- **Schema:** fleet
- **Entities:** Unidad, Remolque, Operador, LicenciaOperador
- **Estado:** DDL 100%, Backend 40%
- **Descripcion:** Control de activos

### MAI-012: Combustible y Gastos
- **Schema:** fuel
- **Entities:** CargaCombustible, CrucePeaje, GastoViaje, Anticipo
- **Estado:** DDL 100%, Backend 50%
- **Descripcion:** Control antifraude

### MAI-013: Mantenimiento Flota
- **Schema:** maintenance
- **Entities:** OrdenTrabajo, ProgramaMantenimiento, Refaccion
- **Estado:** DDL 100%, Backend 0%
- **Descripcion:** Preventivo/correctivo

### MAI-014: Carriers (Terceros)
- **Schema:** carriers
- **Entities:** Carrier, DocumentoCarrier, ScorecardCarrier
- **Estado:** DDL 100%, Backend 0%
- **Descripcion:** Subcontratacion

### MAI-015: Portal Cliente
- **Schema:** transport
- **Entities:** UsuarioPortal, ConfigPortal
- **Estado:** DDL 100%, Backend 0%
- **Descripcion:** Autoservicio clientes

---

## Modulos Propios - Fase 2 (MAE)

### MAE-016: Carta Porte CFDI
- **Schema:** compliance
- **Entities:** CartaPorte, ComplementoFiscal, ExpedienteCFDI
- **Estado:** DDL 100%, Backend 0%
- **Descripcion:** Complemento 3.1 obligatorio

### MAE-017: HOS y Bitacora
- **Schema:** compliance
- **Entities:** RegistroHOS, Bitacora, InspeccionUnidad
- **Estado:** DDL 100%, Backend 0%
- **Descripcion:** Horas de servicio, NOM-087

### MAE-018: Reportes y KPIs
- **Schema:** analytics
- **Entities:** KPITransporte, ReporteOTIF, DashboardConfig
- **Estado:** DDL 100%, Backend 0%
- **Descripcion:** Metricas de desempeno

---

## Modulos Propios - Fase 3 (MAA)

### MAA-019: Optimizacion Rutas
- **Estado:** Planificado
- **Descripcion:** ML para optimizacion, prediccion ETA

### MAA-020: Integraciones EDI
- **Estado:** Planificado
- **Descripcion:** Intercambio electronico datos

---

## Referencias

- Inventario Backend: `orchestration/inventarios/BACKEND_INVENTORY.yml`
- Inventario Database: `orchestration/inventarios/DATABASE_INVENTORY.yml`
- CLAUDE.md: `CLAUDE.md`

---

*Ultima actualizacion: 2026-01-26*