erp-transportistas-v2/docs/_definitions/MODULES-CATALOG.md
Adrian Flores Cortes 3a3eb4089c docs: Propagar templates de documentacion desde erp-core
Estructura _definitions/:
- _INDEX.yml: Indice de catalogos
- MODULES-CATALOG.md: 42 modulos (22 heredados + 20 propios)
- ENTITIES-CATALOG.md: ~153 entities por schema
- SERVICES-CATALOG.md: ~80 services documentados
- DATABASE-SCHEMA.md: 8 schemas con DDL detallado

Estructura _quick/:
- QUICK-INDEX.yml: Navegacion rapida
- QUICK-MODULES.yml: Estado de modulos
- QUICK-DATABASE.yml: Resumen de BD
- QUICK-API.yml: Endpoints principales

Orchestration:
- HERENCIA-ERP-CORE.md: Documentacion de herencia
- directivas/README.md: Directivas locales
- trazas/README.md: Sistema de trazas

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 23:07:50 -06:00

207 lines
5.7 KiB
Markdown

# 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*