erp-transportistas-v2/orchestration/BOOTLOADER.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

127 lines
2.9 KiB
Markdown

# BOOTLOADER - ERP Transportistas
**Proyecto:** erp-transportistas
**Tipo:** CONSUMER (Vertical ERP)
**Sistema:** SIMCO v4.0.0 + NEXUS v4.0
---
## Secuencia de Carga de Contexto
### Nivel 0 - Sistema (Heredado)
```
1. workspace-v2/CLAUDE.md
2. workspace-v2/orchestration/directivas/principios/PRINCIPIO-CAPVED.md
3. workspace-v2/orchestration/directivas/simco/SIMCO-TAREA.md
4. workspace-v2/orchestration/directivas/simco/SIMCO-GIT.md
5. workspace-v2/orchestration/directivas/simco/SIMCO-EDICION-SEGURA.md
```
### Nivel 1 - ERP Core (Heredado)
```
6. projects/erp-core/CLAUDE.md
7. projects/erp-core/orchestration/directivas/DIRECTIVA-MULTI-TENANT.md
8. projects/erp-core/orchestration/directivas/DIRECTIVA-HERENCIA-MODULOS.md
```
### Nivel 2 - Proyecto (Local)
```
9. projects/erp-transportistas/CLAUDE.md (ESTE PROYECTO)
10. projects/erp-transportistas/.claude/constants/CONSTANTS-PROJECT.yml
11. projects/erp-transportistas/docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md
```
---
## Aliases Activos
| Alias | Ruta |
|-------|------|
| @BACKEND | backend/src/ |
| @FRONTEND | frontend/src/ |
| @DDL | database/ddl/ |
| @DOCS | docs/ |
| @MODULOS | docs/02-definicion-modulos/ |
| @ORCHESTRATION | orchestration/ |
| @CONSTANTS | .claude/constants/CONSTANTS-PROJECT.yml |
| @REQS | docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md |
---
## Validaciones Obligatorias
### Antes de Implementar
1. Verificar si funcionalidad existe en erp-core
2. Consultar REQ-GIRO-TRANSPORTISTA.md
3. Verificar coherencia DDL <-> Entity
### Despues de Implementar
1. Actualizar PROJECT-STATUS.md
2. Actualizar INVENTARIO.yml
3. Verificar build: `npm run build && npm run lint`
---
## Modulos del Giro Disponibles
### Fase 1 - MAI (Prioritarios)
- MAI-002: Clientes y Tarifas
- MAI-003: Ordenes de Transporte
- MAI-004: Planeacion TMS
- MAI-005: Despacho
- MAI-006: Tracking
- MAI-007: POD y Cierre
- MAI-011: Gestion de Flota
### Fase 2 - MAE (Compliance)
- MAE-016: Carta Porte CFDI
- MAE-017: HOS y Bitacora
---
## Entidades Criticas
| Entidad | Schema | Descripcion |
|---------|--------|-------------|
| OrdenTransporte | transport | Solicitud de servicio |
| Embarque | transport | Agrupacion de OTs |
| Viaje | transport | Ejecucion operativa |
| Unidad | fleet | Tractora/remolque/caja |
| Operador | fleet | Conductor |
| EventoTracking | tracking | Posiciones y eventos |
| POD | transport | Proof of Delivery |
| CartaPorte | compliance | CFDI complemento |
---
## Workflow Principal
```
ORDEN DE TRANSPORTE (OT)
|
v
EMBARQUE (agrupacion)
|
v
PLANEACION (asignacion recursos)
|
v
DESPACHO (checklist, salida)
|
v
VIAJE (tracking en tiempo real)
|
v
POD (entrega con evidencias)
|
v
CIERRE (costos, rentabilidad)
|
v
FACTURACION (CFDI + Carta Porte)
```
---
*Bootloader ERP Transportistas - SIMCO v4.0.0*