# ERP Transportistas

**Vertical ERP para empresas de transporte de carga, logistica y 3PL**

[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)]()
[![Status](https://img.shields.io/badge/status-development-yellow.svg)]()
[![License](https://img.shields.io/badge/license-proprietary-red.svg)]()

---

## Descripcion

ERP Transportistas es una solucion integral para la gestion de empresas de autotransporte de carga. Implementa todas las funcionalidades necesarias para operar una empresa de logistica, desde la captura de ordenes de transporte hasta la facturacion con CFDI y Carta Porte.

### Funcionalidades Principales

- **Gestion de Flota**: Control de unidades tractoras, remolques, cajas y operadores
- **Ordenes de Transporte**: Captura de OTs con restricciones logisticas y multi-paradas
- **Planeacion TMS**: Consolidacion, capacidad y asignacion de recursos
- **Tracking en Tiempo Real**: GPS, eventos, alertas y ETA dinamico
- **POD Digital**: Proof of Delivery con firma electronica y evidencias
- **CFDI Carta Porte**: Cumplimiento fiscal con complemento 3.1
- **Control de Costos**: Combustible, peajes, viaticos, mantenimiento
- **Portal de Clientes**: Autoservicio para tracking y documentos

---

## Stack Tecnologico

| Capa | Tecnologia |
|------|------------|
| Backend | NestJS 10.x + TypeScript |
| Frontend | React 18.x + Vite + TailwindCSS |
| Database | PostgreSQL 15 + PostGIS |
| Cache | Redis 7.x |
| Mobile | React Native / Expo |

---

## Estructura del Proyecto

```
erp-transportistas/
├── backend/           # API NestJS
├── frontend/          # SPA React
├── database/          # DDL PostgreSQL
├── docs/              # Documentacion
├── orchestration/     # Sistema SIMCO
└── .claude/           # Configuracion Claude Code
```

---

## Requisitos

- Node.js 20.x
- PostgreSQL 15+
- Redis 7.x
- Git

---

## Instalacion

```bash
# Clonar repositorio
git clone https://github.com/rckrdmrd/erp-transportistas-v2.git
cd erp-transportistas

# Inicializar submodulos
git submodule update --init --recursive

# Backend
cd backend
npm install
cp .env.example .env
npm run dev

# Frontend (otra terminal)
cd frontend
npm install
npm run dev
```

---

## Documentacion

- [Requerimientos del Giro](docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md)
- [Arquitectura](docs/10-modelado/)
- [API Reference](docs/30-integraciones/)

---

## Contribuir

Este proyecto sigue el sistema SIMCO de desarrollo. Consultar `CLAUDE.md` para directivas de implementacion.

---

## Licencia

Propietario - ISEM 2026