3a3eb4089c
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>
202 lines
5.3 KiB
Markdown
202 lines
5.3 KiB
Markdown
# Herencia ERP-Core - ERP Transportistas
|
|
|
|
**Version:** 1.0.0
|
|
**Fecha:** 2026-01-26
|
|
**Tipo:** CONSUMER (Nivel 2)
|
|
|
|
---
|
|
|
|
## Relacion de Herencia
|
|
|
|
```
|
|
template-saas (PROVIDER - L0)
|
|
│
|
|
▼
|
|
erp-core (INTERMEDIATE - L1)
|
|
│
|
|
├── erp-construccion
|
|
├── erp-mecanicas-diesel
|
|
├── erp-clinicas
|
|
├── erp-retail
|
|
├── erp-vidrio-templado
|
|
└── erp-transportistas ◀── ESTE PROYECTO
|
|
```
|
|
|
|
---
|
|
|
|
## Modulos Heredados de erp-core
|
|
|
|
### Foundation (100% Heredado)
|
|
|
|
| Modulo | Codigo Core | Reutilizacion | Modificaciones |
|
|
|--------|-------------|---------------|----------------|
|
|
| Auth | MGN-001 | 100% | Ninguna |
|
|
| Users | MGN-002 | 100% | Ninguna |
|
|
| Roles | MGN-003 | 100% | Roles adicionales transporte |
|
|
| Tenants | MGN-004 | 100% | Ninguna |
|
|
|
|
### Core Business (60-70% Heredado)
|
|
|
|
| Modulo | Codigo Core | Reutilizacion | Extensiones |
|
|
|--------|-------------|---------------|-------------|
|
|
| Catalogs | MGN-005 | 80% | Catalogos vehiculares |
|
|
| Settings | MGN-006 | 90% | Config GPS/tracking |
|
|
| Financial | MGN-012 | 70% | Facturacion transporte |
|
|
| Inventory | MGN-011 | 50% | Combustible, refacciones |
|
|
| Partners | MGN-010 | 60% | Clientes, carriers |
|
|
|
|
### SaaS Features (100% Heredado)
|
|
|
|
| Modulo | Codigo Core | Reutilizacion |
|
|
|--------|-------------|---------------|
|
|
| Billing | MGN-016 | 100% |
|
|
| Plans | MGN-017 | 100% |
|
|
| Webhooks | MGN-018 | 100% |
|
|
| Feature Flags | MGN-019 | 100% |
|
|
|
|
### AI/Intelligence (80% Heredado)
|
|
|
|
| Modulo | Codigo Core | Reutilizacion | Extensiones |
|
|
|--------|-------------|---------------|-------------|
|
|
| AI Integration | MGN-020 | 80% | Optimizacion rutas |
|
|
| WhatsApp | MGN-021 | 100% | - |
|
|
| MCP Server | MGN-022 | 70% | Tools transporte |
|
|
|
|
---
|
|
|
|
## Modulos Especificos de Transporte (MAI/MAE/MAA)
|
|
|
|
### Fase 1 - MAI (Modulo Aplicacion Inicial)
|
|
|
|
| Codigo | Nombre | Herencia Core | Status |
|
|
|--------|--------|---------------|--------|
|
|
| MAI-001 | Fundamentos | MGN-001 a 004 | Heredado |
|
|
| MAI-002 | Clientes y Tarifas | MGN-010 ext | Nuevo 30% |
|
|
| MAI-003 | Ordenes de Transporte | - | Nuevo 100% |
|
|
| MAI-004 | Planeacion TMS | - | Nuevo 100% |
|
|
| MAI-005 | Despacho | - | Nuevo 100% |
|
|
| MAI-006 | Tracking | - | Nuevo 100% |
|
|
| MAI-007 | POD y Cierre | - | Nuevo 100% |
|
|
| MAI-008 | Incidencias | - | Nuevo 100% |
|
|
| MAI-009 | Facturacion Transporte | MGN-012 ext | Nuevo 60% |
|
|
| MAI-010 | Liquidaciones | - | Nuevo 100% |
|
|
| MAI-011 | Gestion de Flota | - | Nuevo 100% |
|
|
| MAI-012 | Combustible y Gastos | MGN-011 ext | Nuevo 70% |
|
|
| MAI-013 | Mantenimiento Flota | - | Nuevo 100% |
|
|
| MAI-014 | Carriers (Terceros) | - | Nuevo 100% |
|
|
| MAI-015 | Portal Cliente | - | Nuevo 100% |
|
|
|
|
### Fase 2 - MAE (Modulo Aplicacion Extendido)
|
|
|
|
| Codigo | Nombre | Herencia Core | Status |
|
|
|--------|--------|---------------|--------|
|
|
| MAE-016 | Carta Porte CFDI | MGN-012 ext | Nuevo 80% |
|
|
| MAE-017 | HOS y Bitacora | - | Nuevo 100% |
|
|
| MAE-018 | Reportes y KPIs | MGN-006 ext | Nuevo 50% |
|
|
|
|
### Fase 3 - MAA (Modulo Aplicacion Avanzado)
|
|
|
|
| Codigo | Nombre | Herencia Core | Status |
|
|
|--------|--------|---------------|--------|
|
|
| MAA-019 | Optimizacion Rutas | MGN-020 ext | Futuro |
|
|
| MAA-020 | Integraciones EDI | - | Futuro |
|
|
|
|
---
|
|
|
|
## Patrones Reutilizados
|
|
|
|
### Desde erp-core
|
|
|
|
1. **Multi-Tenancy con RLS**
|
|
- Aislamiento por tenant_id
|
|
- Politicas RLS en todas las tablas
|
|
- Header X-Tenant-ID
|
|
|
|
2. **Estructura de Modulos Backend**
|
|
```
|
|
module/
|
|
├── entities/
|
|
├── services/
|
|
├── controllers/
|
|
├── dto/
|
|
└── index.ts
|
|
```
|
|
|
|
3. **Naming Conventions**
|
|
- Entities: PascalCase singular
|
|
- Tables: snake_case plural
|
|
- Services: PascalCase + Service
|
|
- Controllers: PascalCase + Controller
|
|
|
|
4. **API REST Standards**
|
|
- Versionado: /api/v1/
|
|
- Pagination: limit, offset
|
|
- Sorting: sort, order
|
|
- Filtering: field=value
|
|
|
|
---
|
|
|
|
## Schemas de Base de Datos
|
|
|
|
### Heredados de erp-core
|
|
- auth
|
|
- catalog
|
|
- settings
|
|
- billing
|
|
- ai
|
|
|
|
### Especificos de Transporte
|
|
- transport (ordenes, embarques, viajes)
|
|
- fleet (unidades, operadores)
|
|
- tracking (eventos, geofences)
|
|
- fuel (cargas combustible)
|
|
- maintenance (mantenimiento flota)
|
|
- carriers (transportistas terceros)
|
|
- billing_transport (facturacion especializada)
|
|
- compliance (HOS, carta porte)
|
|
|
|
---
|
|
|
|
## Directivas Heredadas
|
|
|
|
1. `DIRECTIVA-MULTI-TENANT.md` - Obligatoria
|
|
2. `DIRECTIVA-EXTENSION-VERTICALES.md` - Obligatoria
|
|
3. `ESTANDARES-API-REST-GENERICO.md` - Obligatoria
|
|
4. `TRIGGER-COHERENCIA-CAPAS.md` - Obligatoria
|
|
5. `TRIGGER-INVENTARIOS.md` - Obligatoria
|
|
|
|
---
|
|
|
|
## Propagacion de Cambios
|
|
|
|
### Desde erp-core
|
|
|
|
| Tipo Cambio | Propagacion | SLA |
|
|
|-------------|-------------|-----|
|
|
| Security Fix | FORZADA | 24h |
|
|
| Bug Fix Critico | INMEDIATA | 48h |
|
|
| Feature Nuevo | EVALUADA | 2 semanas |
|
|
| Breaking Change | PLANIFICADA | 1 mes |
|
|
| Docs | INMEDIATA | 1 dia |
|
|
|
|
### Proceso
|
|
|
|
1. Monitorear cambios en erp-core
|
|
2. Evaluar impacto en modulos heredados
|
|
3. Aplicar cambios manteniendo extensiones locales
|
|
4. Validar build + lint + tests
|
|
5. Documentar en PROPAGATION-LOG
|
|
|
|
---
|
|
|
|
## Referencias
|
|
|
|
- `workspace-v2/orchestration/directivas/simco/PROPAGATION-RULES.md`
|
|
- `workspace-v2/orchestration/inventarios/REUSABLE-CODE-INVENTORY.yml`
|
|
- `erp-core/orchestration/directivas/DIRECTIVA-EXTENSION-VERTICALES.md`
|
|
|
|
---
|
|
|
|
*Ultima actualizacion: 2026-01-26*
|
|
*Agente: claude-code-orquestador*
|