erp-transportistas-v2/docs/_definitions/ENTITIES-CATALOG.md

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)