37ed0aa919
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>
104 lines
2.5 KiB
Markdown
104 lines
2.5 KiB
Markdown
# ERP Transportistas
|
|
|
|
**Vertical ERP para empresas de transporte de carga, logistica y 3PL**
|
|
|
|
[]()
|
|
[]()
|
|
[]()
|
|
|
|
---
|
|
|
|
## 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
|