# ENTITIES-CATALOG.md - ERP Transportistas

**Version:** 2.0.0
**Fecha:** 2026-01-27 (Corregido en Auditoria Fase 0)
**Total Entities en Codigo:** 153 (109 heredadas + 44 propias)
**Entities Especializadas Disenadas (sin implementar):** 58

---

## IMPORTANTE: Clarificacion de Estado

Este documento distingue entre:
1. **IMPLEMENTADAS**: Entities que EXISTEN en el codigo backend
2. **DISENADAS**: Entities definidas en documentacion/DDL pero NO implementadas aun

| Categoria | Cantidad | Estado |
|-----------|----------|--------|
| Heredadas de erp-core | 109 | Implementadas |
| Propias implementadas | 44 | Implementadas (pero genericas) |
| Propias especializadas disenadas | ~58 | NO implementadas |

---

## Parte 1: Entities IMPLEMENTADAS (153 total)

### 1.1 Entities Heredadas (erp-core) - 109

#### Schema: auth (20 implementadas)
| Entity | Archivo | Estado |
|--------|---------|--------|
| User | user.entity.ts | 100% |
| Role | role.entity.ts | 100% |
| Permission | permission.entity.ts | 100% |
| Session | session.entity.ts | 100% |
| Tenant | tenant.entity.ts | 100% |
| Company | company.entity.ts | 100% |
| Group | group.entity.ts | 100% |
| ApiKey | api-key.entity.ts | 100% |
| PasswordReset | password-reset.entity.ts | 100% |
| OAuthProvider | oauth-provider.entity.ts | 100% |
| OAuthState | oauth-state.entity.ts | 100% |
| OAuthUserLink | oauth-user-link.entity.ts | 100% |
| TrustedDevice | trusted-device.entity.ts | 100% |
| VerificationCode | verification-code.entity.ts | 100% |
| MfaAuditLog | mfa-audit-log.entity.ts | 100% |
| Device | device.entity.ts | 100% |
| UserProfile | user-profile.entity.ts | 100% |
| UserProfileAssignment | user-profile-assignment.entity.ts | 100% |
| ProfileTool | profile-tool.entity.ts | 100% |
| ProfileModule | profile-module.entity.ts | 100% |

#### Schema: ai (7 implementadas)
| Entity | Archivo | Estado |
|--------|---------|--------|
| Completion | completion.entity.ts | 100% |
| Conversation | conversation.entity.ts | 100% |
| Embedding | embedding.entity.ts | 100% |
| KnowledgeBase | knowledge-base.entity.ts | 100% |
| Model | model.entity.ts | 100% |
| Prompt | prompt.entity.ts | 100% |
| Usage | usage.entity.ts | 100% |

#### Schema: audit (7 implementadas)
| Entity | Archivo | Estado |
|--------|---------|--------|
| AuditLog | audit-log.entity.ts | 100% |
| ConfigChange | config-change.entity.ts | 100% |
| DataExport | data-export.entity.ts | 100% |
| EntityChange | entity-change.entity.ts | 100% |
| LoginHistory | login-history.entity.ts | 100% |
| PermissionChange | permission-change.entity.ts | 100% |
| SensitiveDataAccess | sensitive-data-access.entity.ts | 100% |

#### Schema: billing-usage (13 implementadas)
- BillingAlert, InvoiceItem, PaymentMethod, SubscriptionPlan, UsageEvent
- + 8 entities adicionales

#### Schema: branches (5 implementadas)
- Branch, BranchInventorySettings, BranchPaymentTerminal, BranchSchedule, UserBranchAssignment

#### Schema: core (10 implementadas)
- Entities base compartidas

#### Schema: financial (15 implementadas)
- AccountMapping, AccountType, BankReconciliationRule, BankStatement, BankStatementLine
- FiscalPeriod, FiscalYear, Invoice, InvoiceLine, JournalEntry
- JournalEntryLine, Journal, Payment, Tax, + 1

#### Schema: inventory (15 implementadas)
- InventoryAdjustment, InventoryAdjustmentLine, InventoryCount, InventoryCountLine
- Location, Lot, Picking, StockLevel, StockMove, StockMovement
- StockQuant, StockValuationLayer, TransferOrder, TransferOrderLine, + 1

#### Schema: mcp (2 implementadas)
- ToolCall, ToolCallResult

#### Schema: notifications (6 implementadas)
- Channel, InAppNotification, Notification, NotificationBatch, Preference, Template

#### Schema: partners (6 implementadas)
- PartnerSegment, PartnerTaxInfo, PartnerAddress, PartnerBankAccount, PartnerContact, + 1

#### Schema: payment-terminals (3 implementadas)
- TerminalPayment, TerminalWebhookEvent, TenantTerminalConfig

---

### 1.2 Entities Propias Implementadas - 44

#### Modulo: ordenes-transporte (5)
| Entity | Archivo | Nota |
|--------|---------|------|
| Quotation | quotation.entity.ts | GENERICA - no especializada |
| QuotationItem | quotation-item.entity.ts | GENERICA |
| SalesOrder | sales-order.entity.ts | GENERICA |
| SalesOrderItem | sales-order-item.entity.ts | GENERICA |
| + 1 adicional | | |

**Gap**: Falta OrdenTransporte, Embarque, Parada especializadas

#### Modulo: gestion-flota (9)
| Entity | Archivo | Nota |
|--------|---------|------|
| Product | product.entity.ts | GENERICA |
| ProductCategory | product-category.entity.ts | GENERICA |
| ProductVariant | product-variant.entity.ts | GENERICA |
| ProductAttribute | product-attribute.entity.ts | GENERICA |
| ProductAttributeValue | product-attribute-value.entity.ts | GENERICA |
| ProductPrice | product-price.entity.ts | GENERICA |
| ProductSupplier | product-supplier.entity.ts | GENERICA |
| + 2 adicionales | | |

**Gap**: Falta Unidad, Remolque, Operador especializadas

#### Modulo: tracking (2)
| Entity | Archivo | Nota |
|--------|---------|------|
| 2 entities basicas | | Estructura minima |

**Gap**: Falta EventoTracking, Geocerca, AlertaTracking

#### Modulo: viajes (4)
| Entity | Archivo | Nota |
|--------|---------|------|
| Timesheet | timesheet.entity.ts | GENERICA de projects |
| + 3 adicionales | | |

**Gap**: Falta Viaje, Ruta, ParadaViaje especializadas

#### Modulo: combustible-gastos (5) - ESPECIALIZADAS
| Entity | Archivo | Estado |
|--------|---------|--------|
| CargaCombustible | carga-combustible.entity.ts | Entity creada, sin service |
| CrucePeaje | cruce-peaje.entity.ts | Entity creada, sin service |
| GastoViaje | gasto-viaje.entity.ts | Entity creada, sin service |
| AnticipoViatico | anticipo-viatico.entity.ts | Entity creada, sin service |
| ControlRendimiento | control-rendimiento.entity.ts | Entity creada, sin service |

#### Modulo: tarifas-transporte (6) - ESPECIALIZADAS
| Entity | Archivo | Estado |
|--------|---------|--------|
| Lane | lane.entity.ts | Entity creada, sin service |
| Tarifa | tarifa.entity.ts | Entity creada, sin service |
| RecargoCatalogo | recargo-catalogo.entity.ts | Entity creada, sin service |
| FacturaTransporte | factura-transporte.entity.ts | Entity creada, sin service |
| LineaFactura | linea-factura.entity.ts | Entity creada, sin service |
| FuelSurcharge | fuel-surcharge.entity.ts | Entity creada, sin service |

#### Modulo: carta-porte (7)
| Entity | Archivo | Estado |
|--------|---------|--------|
| 7 entities basicas | | Estructura para Carta Porte |

#### Modulo: fiscal (6)
| Entity | Archivo | Estado |
|--------|---------|--------|
| 6 entities fiscales | | Integracion fiscal Mexico |

---

## Parte 2: Entities DISENADAS (No Implementadas) - ~58

Las siguientes entities estan definidas en documentacion funcional y/o DDL
pero **NO EXISTEN** aun en el codigo backend.

### Schema: transport (~25 disenadas)

#### Ordenes de Transporte (MAI-003)
| Entity | Tabla DDL | Estado Backend |
|--------|-----------|----------------|
| OrdenTransporte | ordenes_transporte | NO EXISTE |
| Embarque | embarques | NO EXISTE |
| Parada | paradas | NO EXISTE |
| RestriccionOT | restricciones_ot | NO EXISTE |
| ItemOT | items_ot | NO EXISTE |

#### Viajes y Rutas (MAI-004, MAI-005)
| Entity | Tabla DDL | Estado Backend |
|--------|-----------|----------------|
| Viaje | viajes | NO EXISTE |
| Ruta | rutas | NO EXISTE |
| ParadaViaje | paradas_viaje | NO EXISTE |
| ChecklistPreViaje | checklists_pre_viaje | NO EXISTE |
| SelloViaje | sellos_viaje | NO EXISTE |
| EvidenciaCarga | evidencias_carga | NO EXISTE |

#### POD y Cierre (MAI-007)
| Entity | Tabla DDL | Estado Backend |
|--------|-----------|----------------|
| POD | pods | NO EXISTE |
| FirmaDigital | firmas_digitales | NO EXISTE |
| FotoEntrega | fotos_entrega | NO EXISTE |
| TiempoReal | tiempos_reales | NO EXISTE |

#### Incidencias (MAI-008)
| Entity | Tabla DDL | Estado Backend |
|--------|-----------|----------------|
| Incidencia | incidencias | NO EXISTE |
| ReclamoCliente | reclamos_clientes | NO EXISTE |

### Schema: fleet (~15 disenadas)

#### Unidades y Remolques (MAI-011)
| Entity | Tabla DDL | Estado Backend |
|--------|-----------|----------------|
| Unidad | unidades | NO EXISTE |
| Remolque | remolques | NO EXISTE |
| ConfiguracionVehicular | configuraciones_vehiculares | NO EXISTE |
| DocumentoUnidad | documentos_unidades | NO EXISTE |

#### Operadores (MAI-011)
| Entity | Tabla DDL | Estado Backend |
|--------|-----------|----------------|
| Operador | operadores | NO EXISTE |
| LicenciaOperador | licencias_operadores | NO EXISTE |
| DocumentoOperador | documentos_operadores | NO EXISTE |
| DisponibilidadOperador | disponibilidad_operadores | NO EXISTE |

### Schema: tracking (~10 disenadas)

#### Eventos GPS (MAI-006)
| Entity | Tabla DDL | Estado Backend |
|--------|-----------|----------------|
| EventoTracking | eventos_tracking | NO EXISTE |
| Geocerca | geocercas | NO EXISTE |
| AlertaTracking | alertas_tracking | NO EXISTE |
| ETADinamico | eta_dinamico | NO EXISTE |
| DispositivoGPS | dispositivos_gps | NO EXISTE |

### Schema: maintenance (~12 disenadas)

#### Mantenimiento (MAI-013)
| Entity | Tabla DDL | Estado Backend |
|--------|-----------|----------------|
| OrdenTrabajo | ordenes_trabajo | NO EXISTE |
| ProgramaMantenimiento | programas_mantenimiento | NO EXISTE |
| RefaccionFlota | refacciones_flota | NO EXISTE |
| HistorialMantenimiento | historial_mantenimiento | NO EXISTE |
| ProveedorMantenimiento | proveedores_mantenimiento | NO EXISTE |

### Schema: carriers (~8 disenadas)

#### Terceros (MAI-014)
| Entity | Tabla DDL | Estado Backend |
|--------|-----------|----------------|
| Carrier | carriers | NO EXISTE |
| DocumentoCarrier | documentos_carriers | NO EXISTE |
| ScorecardCarrier | scorecard_carriers | NO EXISTE |
| TarifaCarrier | tarifas_carriers | NO EXISTE |

### Schema: billing (~10 disenadas)

#### Liquidaciones (MAI-010)
| Entity | Tabla DDL | Estado Backend |
|--------|-----------|----------------|
| LiquidacionOperador | liquidaciones_operadores | NO EXISTE |
| Deduccion | deducciones | NO EXISTE |

### Schema: compliance (~10 disenadas)

#### Carta Porte (MAE-016)
| Entity | Tabla DDL | Estado Backend |
|--------|-----------|----------------|
| CartaPorte | cartas_porte | PARCIAL (7 entities basicas) |
| UbicacionCartaPorte | ubicaciones_carta_porte | NO EXISTE |
| MercanciaCartaPorte | mercancias_carta_porte | NO EXISTE |
| AutoTransporteFederal | autotransporte_federal | NO EXISTE |
| FiguraTransporte | figuras_transporte | NO EXISTE |

#### HOS y Bitacora (MAE-017)
| Entity | Tabla DDL | Estado Backend |
|--------|-----------|----------------|
| RegistroHOS | registros_hos | NO EXISTE |
| Bitacora | bitacoras | NO EXISTE |
| InspeccionUnidad | inspecciones_unidades | NO EXISTE |

---

## Resumen de Gaps

| Schema | Disenadas | Implementadas | Gap |
|--------|-----------|---------------|-----|
| transport | 25 | 0 especializadas | -25 |
| fleet | 15 | 0 especializadas | -15 |
| tracking | 10 | 2 basicas | -8 |
| maintenance | 12 | 0 | -12 |
| carriers | 8 | 0 | -8 |
| billing | 10 | 6 (tarifas) | -4 |
| compliance | 10 | 7 (carta-porte parcial) | -3 |
| **TOTAL** | **~90** | **15** | **~75** |

---

## Referencias

- Backend Inventory: `orchestration/inventarios/BACKEND_INVENTORY.yml`
- Database Inventory: `orchestration/inventarios/DATABASE_INVENTORY.yml`
- DDL: `database/ddl/`

---

## Historial

| Fecha | Version | Cambio |
|-------|---------|--------|
| 2026-01-26 | 1.0.0 | Creacion inicial |
| 2026-01-27 | 2.0.0 | CORRECCION: Separacion clara IMPLEMENTADAS vs DISENADAS |

---

*Ultima actualizacion: 2026-01-27 (Auditoria Fase 0)*