erp-transportistas-v2/PROJECT-STATUS.md
Adrian Flores Cortes 37ed0aa919 feat: Initial project structure for ERP Transportistas
Vertical ERP for freight transport and logistics companies.

Includes:
- Project configuration (CLAUDE.md, SIMCO orchestration)
- Backend submodule (NestJS 10.x)
- Frontend submodule (React 18.x + Vite)
- Database submodule (PostgreSQL 15 + PostGIS)
- Requirements documentation (REQ-GIRO-TRANSPORTISTA.md)
- 20 modules defined (MAI/MAE/MAA phases)

Key features:
- Transport orders (OT) management
- Fleet and driver management
- Real-time GPS tracking
- POD (Proof of Delivery)
- CFDI with Carta Porte 3.1 compliance
- Fuel and maintenance control
- Third-party carrier management

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 09:53:54 -06:00

128 lines
4.1 KiB
Markdown

# 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** | 5% | Proyecto recien creado |
| **DDL** | 0% | Schemas por definir |
| **Backend** | 0% | Modulos por implementar |
| **Frontend** | 0% | Pendiente |
| **Documentacion** | 100% | Requerimientos completos |
---
## Fase Actual: Inicializacion
### Completado
- [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
### En Progreso
- [ ] Creacion de repositorios Git
- [ ] Registro en inventarios del workspace
### Pendiente
- [ ] DDL de schemas principales
- [ ] Entities TypeORM base
- [ ] 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** - 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: [ ] 0%
Backend: [ ] 0%
Frontend: [ ] 0%
Docs: [████████████████████] 100%
Tests: [ ] 0%
```
---
*Actualizado: 2026-01-25 por META-ORQUESTADOR*