# Reglas de Proyecto - ERP Transportistas (Windsurf)

## Contexto del Proyecto

Este es un ERP vertical para empresas de transporte de carga. Hereda de erp-core y agrega modulos especificos del giro.

## Reglas Criticas

1. **Terminologia**: Usar terminos del giro (OT, Viaje, Operador, POD, Carrier)
2. **Multi-tenancy**: Toda entidad debe tener tenantId
3. **Carta Porte**: Validar datos antes de liberar viajes
4. **Tracking**: Todo evento con timestamp y geolocalizacion

## Estructura de Modulos

```
backend/src/modules/{modulo}/
├── entities/
├── services/
├── controllers/
└── dto/
```

## Nomenclatura

- MAI-XXX: Modulo Aplicacion Inicial
- MAE-XXX: Modulo Aplicacion Extendido
- MAA-XXX: Modulo Aplicacion Avanzado

## Stack

- Backend: NestJS 10.x + TypeScript
- Frontend: React 18.x + Vite + TailwindCSS
- Database: PostgreSQL 15 + PostGIS
- ORM: TypeORM 0.3.x

## Validaciones

```bash
npm run build
npm run lint
npm run test
```

## Referencias

- CLAUDE.md en raiz del proyecto
- docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md