erp-transportistas-v2/orchestration/CONTEXT-MAP.yml
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

197 lines
5.9 KiB
YAML

# CONTEXT-MAP.yml - ERP Transportistas
# Mapa de contexto del proyecto
# Sistema SIMCO v4.0.0 + NEXUS v4.0
version: "1.0.0"
project: "erp-transportistas"
updated: "2026-01-25"
# ═══════════════════════════════════════════════════════════════════════════════
# NIVELES DE CONTEXTO
# ═══════════════════════════════════════════════════════════════════════════════
context_levels:
L0_sistema:
descripcion: "Contexto global del workspace"
archivos:
- path: "../../CLAUDE.md"
alias: "@WORKSPACE"
carga: "automatica"
- path: "../../orchestration/directivas/principios/PRINCIPIO-CAPVED.md"
alias: "@CAPVED"
carga: "automatica"
- path: "../../orchestration/directivas/simco/SIMCO-GIT.md"
alias: "@GIT"
carga: "automatica"
L1_proyecto:
descripcion: "Contexto del proyecto ERP Transportistas"
archivos:
- path: "./CLAUDE.md"
alias: "@PROJECT"
carga: "automatica"
- path: "./.claude/constants/CONSTANTS-PROJECT.yml"
alias: "@CONSTANTS"
carga: "automatica"
- path: "./PROJECT-STATUS.md"
alias: "@STATUS"
carga: "bajo_demanda"
- path: "./docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md"
alias: "@REQS"
carga: "bajo_demanda"
L2_operacion:
descripcion: "Contexto por tipo de operacion"
tipos:
ddl:
archivos:
- path: "./database/ddl/"
alias: "@DDL"
backend:
archivos:
- path: "./backend/src/modules/"
alias: "@MODULES"
frontend:
archivos:
- path: "./frontend/src/"
alias: "@FRONTEND"
docs:
archivos:
- path: "./docs/"
alias: "@DOCS"
L3_tarea:
descripcion: "Contexto especifico de tarea"
dinamico: true
ubicacion: "./orchestration/tareas/"
# ═══════════════════════════════════════════════════════════════════════════════
# DOMINIOS DE NEGOCIO
# ═══════════════════════════════════════════════════════════════════════════════
business_domains:
transport:
descripcion: "Gestion de ordenes, embarques y viajes"
schema: "transport"
modulos:
- MAI-002
- MAI-003
- MAI-004
- MAI-005
- MAI-007
- MAI-008
- MAI-009
entidades:
- OrdenTransporte
- Embarque
- Viaje
- ParadaViaje
- POD
fleet:
descripcion: "Gestion de flota y operadores"
schema: "fleet"
modulos:
- MAI-011
- MAI-013
entidades:
- Unidad
- Remolque
- Operador
- LicenciaOperador
- DocumentoUnidad
tracking:
descripcion: "Tracking y visibilidad en tiempo real"
schema: "tracking"
modulos:
- MAI-006
entidades:
- EventoTracking
- Geocerca
- Alerta
fuel:
descripcion: "Control de combustible y gastos"
schema: "fuel"
modulos:
- MAI-012
entidades:
- CargaCombustible
- CrucePeaje
- GastoViaje
maintenance:
descripcion: "Mantenimiento de flota"
schema: "maintenance"
modulos:
- MAI-013
entidades:
- OrdenMantenimiento
- PlanPreventivo
- HistorialMantenimiento
carriers:
descripcion: "Gestion de terceros"
schema: "carriers"
modulos:
- MAI-014
entidades:
- Carrier
- DocumentoCarrier
- ScorecardCarrier
billing:
descripcion: "Tarifas y facturacion"
schema: "billing"
modulos:
- MAI-002
- MAI-009
entidades:
- Tarifa
- Recargo
- FacturaTransporte
compliance:
descripcion: "Cumplimiento normativo"
schema: "compliance"
modulos:
- MAE-016
- MAE-017
entidades:
- CartaPorte
- BitacoraHOS
- InspeccionUnidad
# ═══════════════════════════════════════════════════════════════════════════════
# ALIASES RAPIDOS
# ═══════════════════════════════════════════════════════════════════════════════
aliases:
# Estructura
"@BACKEND": "backend/src/"
"@FRONTEND": "frontend/src/"
"@DDL": "database/ddl/"
"@DOCS": "docs/"
"@MODULOS": "docs/02-definicion-modulos/"
"@ORCHESTRATION": "orchestration/"
# Configuracion
"@CONSTANTS": ".claude/constants/CONSTANTS-PROJECT.yml"
"@STATUS": "PROJECT-STATUS.md"
"@INVENTORY": "INVENTARIO.yml"
# Requerimientos
"@REQS": "docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md"
"@VISION": "docs/00-vision-general/VISION-ERP-TRANSPORTISTAS.md"
# ═══════════════════════════════════════════════════════════════════════════════
# METADATA
# ═══════════════════════════════════════════════════════════════════════════════
metadata:
created_by: "META-ORQUESTADOR"
created_at: "2026-01-25"