erp-transportistas-v2/.claude/referencias/PATHS-TRABAJO.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

4.0 KiB

Paths de Trabajo - ERP Transportistas

Proyecto: erp-transportistas Actualizado: 2026-01-25


Paths Absolutos

Raiz del proyecto:
C:/Empresas/ISEM/workspace-v2/projects/erp-transportistas/

Backend:
C:/Empresas/ISEM/workspace-v2/projects/erp-transportistas/backend/src/

Frontend:
C:/Empresas/ISEM/workspace-v2/projects/erp-transportistas/frontend/src/

Database:
C:/Empresas/ISEM/workspace-v2/projects/erp-transportistas/database/ddl/

Documentacion:
C:/Empresas/ISEM/workspace-v2/projects/erp-transportistas/docs/

Orchestration:
C:/Empresas/ISEM/workspace-v2/projects/erp-transportistas/orchestration/

Aliases Rapidos

Alias Path Relativo Descripcion
@BACKEND backend/src/ Codigo fuente backend
@MODULES backend/src/modules/ Modulos NestJS
@ENTITIES backend/src/modules/*/entities/ Entidades TypeORM
@SERVICES backend/src/modules/*/services/ Servicios de negocio
@CONTROLLERS backend/src/modules/*/controllers/ Controllers REST
@FRONTEND frontend/src/ Codigo fuente frontend
@FEATURES frontend/src/features/ Features React
@PAGES frontend/src/pages/ Paginas React
@DDL database/ddl/ Scripts SQL
@DOCS docs/ Documentacion
@MODULOS docs/02-definicion-modulos/ Definicion de modulos
@REQS docs/03-requerimientos/ Requerimientos
@ORCHESTRATION orchestration/ Sistema SIMCO local
@CONSTANTS .claude/constants/CONSTANTS-PROJECT.yml Constantes

Modulos Backend por Crear

backend/src/modules/
├── clientes-tarifas/       # MAI-002
│   ├── entities/
│   ├── services/
│   ├── controllers/
│   └── dto/
├── ordenes-transporte/     # MAI-003
├── planeacion-tms/         # MAI-004
├── despacho/               # MAI-005
├── tracking/               # MAI-006
├── pod-cierre/             # MAI-007
├── incidencias/            # MAI-008
├── facturacion-transporte/ # MAI-009
├── liquidaciones/          # MAI-010
├── gestion-flota/          # MAI-011
├── combustible-gastos/     # MAI-012
├── mantenimiento-flota/    # MAI-013
├── carriers-terceros/      # MAI-014
├── portal-cliente/         # MAI-015
├── carta-porte-cfdi/       # MAE-016
├── hos-bitacora/           # MAE-017
└── reportes-kpis/          # MAE-018

DDL por Crear

database/ddl/
├── 01-transport-schema-ddl.sql      # OT, Embarques, Viajes
├── 02-fleet-schema-ddl.sql          # Unidades, Remolques, Operadores
├── 03-tracking-schema-ddl.sql       # Eventos, GPS, Alertas
├── 04-fuel-schema-ddl.sql           # Combustible, Peajes
├── 05-maintenance-schema-ddl.sql    # Mantenimiento
├── 06-carriers-schema-ddl.sql       # Terceros
├── 07-billing-transport-ddl.sql     # Tarifas, Facturacion
├── 08-compliance-schema-ddl.sql     # Carta Porte, HOS
└── 99-rls-transport-modules.sql     # Row Level Security

Documentacion por Crear

docs/02-definicion-modulos/
├── MAI-002-clientes-tarifas/
├── MAI-003-ordenes-transporte/
├── MAI-004-planeacion-tms/
├── MAI-005-despacho/
├── MAI-006-tracking/
├── MAI-007-pod-cierre/
├── MAI-008-incidencias/
├── MAI-009-facturacion-transporte/
├── MAI-010-liquidaciones/
├── MAI-011-gestion-flota/
├── MAI-012-combustible-gastos/
├── MAI-013-mantenimiento-flota/
├── MAI-014-carriers-terceros/
├── MAI-015-portal-cliente/
├── MAE-016-carta-porte-cfdi/
├── MAE-017-hos-bitacora/
└── MAE-018-reportes-kpis/

Paths Heredados (erp-core)

Modulos base (referencia):
../erp-core/backend/src/modules/auth/
../erp-core/backend/src/modules/users/
../erp-core/backend/src/modules/tenants/
../erp-core/backend/src/modules/partners/
../erp-core/backend/src/modules/catalogs/
../erp-core/backend/src/modules/financial/

Paths de Trabajo ERP Transportistas - SIMCO v4.0.0