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

139 lines
4.0 KiB
Markdown

# 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*