rckrdmrd/erp-transportistas-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
4c538eef9c
erp-transportistas-v2/docs/_definitions/ENTITIES-CATALOG.md
Adrian Flores Cortes 4bbace6345 docs(auditoria): Fase 0 - Purga y correccion de documentacion 
CORRECCION CRITICA:
- Porcentaje backend corregido de 40% a 15%
- Entities: 153 total (109 heredadas + 44 propias)
- Entities especializadas disenadas sin implementar: ~58

Cambios:
- BACKEND_INVENTORY.yml: Reescrito con estado real
- ENTITIES-CATALOG.md: Separacion IMPLEMENTADAS vs DISENADAS
- PROXIMA-ACCION.md: Porcentajes corregidos, gaps identificados
- MAPA-DOCUMENTACION.yml: Estructura actualizada
- MASTER_INVENTORY.yml: Nuevo inventario consolidado

Carpetas vacias eliminadas:
- docs/01-analisis-referencias/
- docs/10-modelado/
- docs/20-user-stories/
- docs/30-integraciones/
- docs/90-transversal/
- docs/97-adr/

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 01:22:27 -06:00

332 lines
12 KiB
Markdown
Raw Blame History

# 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)*
Reference in New Issue View Git Blame Copy Permalink