erp-transportistas-v2/PROJECT-STATUS.md

# PROJECT-STATUS.md - ERP Transportistas

**Proyecto:** erp-transportistas
**Tipo:** CONSUMER (Vertical ERP)
**Version:** 1.0.0
**Actualizado:** 2026-01-25

---

## Estado General

| Metrica | Valor | Descripcion |
|---------|-------|-------------|
| **Progreso General** | 45% | DDL completo, entities principales |
| **DDL** | 100% | 8 archivos DDL completos (01-08) |
| **Backend** | 40% | 24 modulos + entities transporte |
| **Frontend** | 0% | Pendiente |
| **Documentacion** | 100% | Requerimientos completos |

---

## Fase Actual: Desarrollo Backend

### Completado (2026-01-25)
- [x] Estructura de carpetas del proyecto
- [x] CLAUDE.md con especificaciones del giro
- [x] CONSTANTS-PROJECT.yml
- [x] Documentacion de requerimientos (REQ-GIRO-TRANSPORTISTA.md)
- [x] Definicion de modulos MAI/MAE/MAA
- [x] Creacion de repositorios Git (Gitea)
- [x] Registro en SUBMODULES-INVENTORY.yml
- [x] DDL 00-schemas-init.sql (8 schemas + ENUMs)
- [x] Fase 0 SIMCO-REUSE: Copia modulos base (419 archivos, ~69k lineas)
  - shared/, auth, users, tenants, ai, audit
  - notifications, mcp, payment-terminals
  - billing-usage, branches, companies, core
- [x] Fase 1: Copia modulos para adaptar
  - partners, inventory, financial
- [x] Fase 2: Creacion modulos desde patrones
  - ordenes-transporte (de sales)
  - gestion-flota (de products)
  - viajes (de projects)
- [x] Fase 3: Estructura modulos nuevos
  - tracking, tarifas-transporte, combustible-gastos, carta-porte

### Completado (Sesión 2)
- [x] DDL completo schemas 01-08 (~2,976 líneas SQL)
  - 01-transport: OT, embarques, viajes, POD, incidencias
  - 02-fleet: unidades, remolques, operadores, documentos
  - 03-tracking: posiciones GPS, eventos, geocercas, alertas
  - 04-fuel: cargas combustible, peajes, gastos, anticipos
  - 05-maintenance: planes, programacion, ordenes trabajo
  - 06-carriers: carriers, documentos, scorecard
  - 07-billing: lanes, tarifas, recargos, facturas
  - 08-compliance: carta porte CFDI 3.1, HOS, inspecciones
- [x] Adaptar partners → shippers/consignees (TipoPartnerTransporte, ubicaciones, requisitos)
- [x] Entities gestion-flota: Unidad, Operador
- [x] Entity ordenes-transporte: OrdenTransporte
- [x] Entities tracking: EventoTracking, Geocerca

### En Progreso
- [ ] Implementar entities viajes (Viaje, ParadaViaje)
- [ ] Adaptar inventory → refacciones flota
- [ ] Adaptar financial → costeo transporte

### Pendiente
- [ ] Build y lint del backend
- [ ] Entities carta-porte, tarifas, combustible
- [ ] Services y controllers
- [ ] Frontend inicial

---

## Modulos por Fase

### Fase 1 - MAI (Modulo Aplicacion Inicial) - 15 modulos
| Codigo | Nombre | DDL | Backend | Frontend | Estado |
|--------|--------|:---:|:-------:|:--------:|--------|
| MAI-001 | Fundamentos | - | - | - | Heredado |
| MAI-002 | Clientes y Tarifas | - | - | - | Pendiente |
| MAI-003 | Ordenes de Transporte | - | - | - | Pendiente |
| MAI-004 | Planeacion TMS | - | - | - | Pendiente |
| MAI-005 | Despacho | - | - | - | Pendiente |
| MAI-006 | Tracking | - | - | - | Pendiente |
| MAI-007 | POD y Cierre | - | - | - | Pendiente |
| MAI-008 | Incidencias | - | - | - | Pendiente |
| MAI-009 | Facturacion Transporte | - | - | - | Pendiente |
| MAI-010 | Liquidaciones | - | - | - | Pendiente |
| MAI-011 | Gestion de Flota | - | - | - | Pendiente |
| MAI-012 | Combustible y Gastos | - | - | - | Pendiente |
| MAI-013 | Mantenimiento Flota | - | - | - | Pendiente |
| MAI-014 | Carriers (Terceros) | - | - | - | Pendiente |
| MAI-015 | Portal Cliente | - | - | - | Pendiente |

### Fase 2 - MAE (Modulo Aplicacion Extendido) - 3 modulos
| Codigo | Nombre | DDL | Backend | Frontend | Estado |
|--------|--------|:---:|:-------:|:--------:|--------|
| MAE-016 | Carta Porte CFDI | - | - | - | Pendiente |
| MAE-017 | HOS y Bitacora | - | - | - | Pendiente |
| MAE-018 | Reportes y KPIs | - | - | - | Pendiente |

### Fase 3 - MAA (Modulo Aplicacion Avanzado) - 2 modulos
| Codigo | Nombre | DDL | Backend | Frontend | Estado |
|--------|--------|:---:|:-------:|:--------:|--------|
| MAA-019 | Optimizacion Rutas | - | - | - | Futuro |
| MAA-020 | Integraciones EDI | - | - | - | Futuro |

---

## Proximos Pasos (Priorizados)

1. ~~**Crear repositorios Git**~~ ✅ - Completado
2. ~~**Definir DDL schemas 01-08**~~ ✅ - Completado
3. ~~**Implementar entities principales**~~ ✅ - Unidad, Operador, OrdenTransporte, EventoTracking, Geocerca
4. **Completar entities Viaje** - ParadaViaje, POD
5. **Build y validación backend** - npm run build, lint
6. **Services y controllers** - CRUD básico para entities
7. **Frontend inicial** - Dashboard, listados básicos

---

## Dependencias Criticas

| Modulo | Depende de | Prioridad |
|--------|------------|-----------|
| MAI-003 OT | MAI-002 Tarifas, MAI-011 Flota | Alta |
| MAI-004 Planeacion | MAI-003 OT | Alta |
| MAI-005 Despacho | MAI-004 Planeacion, MAI-011 Flota | Alta |
| MAI-006 Tracking | MAI-005 Despacho | Alta |
| MAI-007 POD | MAI-006 Tracking | Media |
| MAI-009 Facturacion | MAI-007 POD | Media |
| MAE-016 Carta Porte | MAI-009 Facturacion | Alta |

---

## Riesgos y Mitigaciones

| Riesgo | Impacto | Mitigacion |
|--------|---------|------------|
| Complejidad Carta Porte 3.1 | Alto | Iniciar MAE-016 temprano, PAC confiable |
| Integracion GPS multiple | Medio | Abstraccion de proveedores |
| Volumen de eventos tracking | Alto | Redis para buffer, batch processing |
| Offline en carretera | Alto | PWA con sincronizacion |

---

## Metricas de Avance

```
DDL:      [████████████████████] 100%
Backend:  [████████            ] 40%
Frontend: [                    ] 0%
Docs:     [████████████████████] 100%
Tests:    [                    ] 0%
```

---

## Archivos Copiados (Fase 0-1 SIMCO-REUSE)

| Fuente | Destino | Archivos | Lineas |
|--------|---------|----------|--------|
| erp-core/backend/src/ | erp-transportistas/backend/src/ | 419 | ~69,484 |

**Token savings estimado:** ~65% (~10,675 lineas no generadas)

---

*Actualizado: 2026-01-25 por Claude Code - Fase Copia Modulos*