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

6.4 KiB

Raw Blame History

PROXIMA-ACCION.md - ERP Transportistas

Ultima Actualizacion: 2026-01-27 (Auditoria Fase 0) Sistema: SIMCO v4.0.0 Estado del Proyecto: 15% completado | DDL 100% | Backend 15% | Frontend 0%

CORRECCION IMPORTANTE (2026-01-27)

La auditoria de documentacion revelo discrepancias significativas entre lo documentado y el estado real del codigo. Los porcentajes han sido corregidos:

Aspecto	Antes (Incorrecto)	Ahora (Real)
Backend	40%	15%
Entities nuevas	58 propias	44 (muchas genericas)
Entities especializadas	"~25 implementadas"	11 implementadas

Estado Actual (2026-01-27)

Progreso General

Capa	Progreso	Notas
DDL	100%	8 schemas especializados transporte
Backend	15%	153 entities (109 heredadas + 44 propias), faltan services/DTOs
Frontend	0%	Pendiente
Documentacion	25%	Requerimientos definidos, falta especificar modulos

Desglose de Entities

Categoria	Cantidad	Estado
Heredadas erp-core	109	100% funcionales
Propias genericas	33	Entity only, sin services
Propias especializadas	11	Entity only, sin services
Disenadas sin implementar	~58	GAP CRITICO

Entities Especializadas Creadas (2026-01-25)

Modulo: combustible-gastos (MAI-012) - 5 entities

carga-combustible.entity.ts
cruce-peaje.entity.ts
gasto-viaje.entity.ts
anticipo-viatico.entity.ts
control-rendimiento.entity.ts

Modulo: tarifas-transporte (MAI-009) - 6 entities

lane.entity.ts
tarifa.entity.ts
recargo-catalogo.entity.ts
factura-transporte.entity.ts
linea-factura.entity.ts
fuel-surcharge.entity.ts

Controladores Creados

operadores.controller.ts (gestion-flota)
unidades.controller.ts (gestion-flota)
ordenes-transporte.controller.ts (ordenes-transporte)
tracking.controller.ts (tracking)
viajes.controller.ts (viajes)

Gaps Criticos Identificados

Entities Especializadas Faltantes (~58)

Modulo	Entities Faltantes	Prioridad
MAI-003	OrdenTransporte, Embarque, Parada, etc.	P0
MAI-011	Unidad, Remolque, Operador, etc.	P0
MAI-007	POD, FirmaDigital, FotoEntrega	P0
MAI-004	Consolidacion, AsignacionRecurso	P0
MAI-005	ChecklistPreViaje, Sello, EvidenciaCarga	P0
MAI-006	EventoTracking, Geocerca, AlertaTracking	P1
MAI-013	OrdenTrabajo, ProgramaMantenimiento	P2
MAI-014	Carrier, DocumentoCarrier, Scorecard	P2

Documentacion Faltante

Modulo	Tiene REQUERIMIENTOS.md	Tiene User Stories
MAI-003	Si	Si (10 US)
MAI-006	Si	No
MAI-011	Si	No
MAE-016	Si	Si (10 US)
MAI-002	No	No
MAI-004	No	No
MAI-005	No	No
MAI-007	No	No
MAI-009	No	No
MAI-010	No	No

Proximas Acciones

P0 - Inmediato (Auditoria Fase 0 en progreso)

Completar purga de documentacion - En progreso
- Eliminar carpetas vacias
- Reescribir BACKEND_INVENTORY.yml
- Reescribir ENTITIES-CATALOG.md
- Actualizar PROXIMA-ACCION.md
- Crear MASTER_INVENTORY.yml
- Actualizar MAPA-DOCUMENTACION.yml

P0 - Especificacion de Modulos Criticos

Crear REQUERIMIENTOS.md para modulos P0
- MAI-007 (POD y Cierre) - Bloquea facturacion
- MAI-004 (Planeacion TMS) - Workflow critico
- MAI-005 (Despacho) - Workflow + NOM-068
- MAI-002 (Tarifas y SLA) - Base comercial
Crear User Stories para modulos con REQUERIMIENTOS
- MAI-006 (Tracking) - 5-10 US
- MAI-011 (Gestion Flota) - 5-10 US

P1 - Completar Backend

Implementar entities especializadas
- OrdenTransporte, Embarque, Parada (MAI-003)
- Unidad, Remolque, Operador (MAI-011)
- POD, FirmaDigital (MAI-007)
Crear services y DTOs para entities existentes
- combustible-gastos
- tarifas-transporte

P1 - Especificacion Modulos Secundarios

Crear especificaciones MAI-009 (Facturacion)
Crear especificaciones MAI-010 (Liquidaciones)
Crear especificaciones MAI-008 (Incidencias)

P2 - Mediano Plazo

Modulo Carta Porte CFDI 3.1
- Validar entities vs requisitos SAT
- Integracion PAC
Integracion GPS/Telematica
Portal de clientes

Modulos del Sistema - Estado Corregido

Fase 1 - MAI (Inicial)

Codigo	Nombre	DDL	Backend	Docs	Frontend
MAI-001	Fundamentos	-	100%	-	-
MAI-002	Clientes y Tarifas	-	0%	0%	0%
MAI-003	Ordenes de Transporte	100%	10%	80%	0%
MAI-004	Planeacion TMS	100%	0%	0%	0%
MAI-005	Despacho	100%	0%	0%	0%
MAI-006	Tracking	100%	5%	60%	0%
MAI-007	POD y Cierre	100%	0%	0%	0%
MAI-008	Incidencias	100%	0%	0%	0%
MAI-009	Facturacion Transporte	100%	15%	0%	0%
MAI-010	Liquidaciones	100%	0%	0%	0%
MAI-011	Gestion de Flota	100%	10%	60%	0%
MAI-012	Combustible y Gastos	100%	20%	30%	0%
MAI-013	Mantenimiento Flota	100%	0%	0%	0%
MAI-014	Carriers (Terceros)	100%	0%	0%	0%
MAI-015	Portal Cliente	100%	0%	0%	0%

Fase 2 - MAE (Extendido)

Codigo	Nombre	DDL	Backend	Docs	Frontend
MAE-016	Carta Porte CFDI	100%	10%	80%	0%
MAE-017	HOS y Bitacora	100%	0%	0%	0%
MAE-018	Reportes y KPIs	100%	0%	0%	0%

Fase 3 - MAA (Avanzado)

Codigo	Nombre	DDL	Backend	Frontend
MAA-019	Optimizacion Rutas	-	0%	0%
MAA-020	Integraciones EDI	-	0%	0%

Referencias

Recurso	Ubicacion
Inventario BD	`orchestration/inventarios/DATABASE_INVENTORY.yml`
Inventario Backend	`orchestration/inventarios/BACKEND_INVENTORY.yml`
Catalogo Entities	`docs/_definitions/ENTITIES-CATALOG.md`
Requerimientos Giro	`docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md`
CLAUDE.md	`CLAUDE.md`

Historial de Cambios

Fecha	Cambio
2026-01-25	Creacion inicial
2026-01-27	CORRECCION: Porcentajes ajustados tras auditoria

Sistema SIMCO v4.0.0 - ERP Transportistas

6.4 KiB Raw Blame History