# 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** | 25% | Fase 0-1 copia modulos completada |
| **DDL** | 10% | Schemas init creado |
| **Backend** | 30% | 24 modulos copiados/creados |
| **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

### En Progreso
- [ ] Adaptar partners → shippers/consignees (campos transporte)
- [ ] Adaptar inventory → refacciones flota
- [ ] Adaptar financial → costeo transporte
- [ ] Implementar entities gestion-flota (unidad, operador)
- [ ] Implementar entities ordenes-transporte
- [ ] Implementar entities tracking

### Pendiente
- [ ] DDL completo de schemas (01-08)
- [ ] Build y lint del backend
- [ ] 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** - Padre + backend, frontend, database
2. **Definir DDL transport schema** - Tablas principales de OT, embarque, viaje
3. **Definir DDL fleet schema** - Unidades, remolques, operadores
4. **Implementar MAI-003** - Ordenes de Transporte (core del negocio)
5. **Implementar MAI-011** - Gestion de Flota (prerequisito para viajes)
6. **Implementar MAI-006** - Tracking (valor diferenciador)

---

## 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:      [██                  ] 10%
Backend:  [██████              ] 30%
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*