Trasla - Plataforma de Fletes y Mudanzas

Una plataforma web marketplace que conecta clientes con transportistas y cargadores para servicios de fletes y mudanzas programadas.

Arquitectura

Trasla2/
├── trasla-frontend/     # Angular 18 SPA
└── trasla-backend/      # Node.js + Express API

Inicio Rápido

Requisitos Previos

• Node.js 18+
• PostgreSQL 14+
• npm o yarn

Base de Datos

1. Crear base de datos PostgreSQL:

CREATE DATABASE trasla_db;

2. Ejecutar el schema:

psql -d trasla_db -f trasla-backend/database/schema.sql

Backend

cd trasla-backend

# Instalar dependencias
npm install

# Configurar variables de entorno
cp .env.example .env
# Editar .env con tus credenciales de BD

# Iniciar servidor de desarrollo
npm run dev

El backend estará disponible en http://localhost:3000

Frontend

cd trasla-frontend

# Instalar dependencias
npm install

# Iniciar servidor de desarrollo
ng serve

El frontend estará disponible en http://localhost:4200

Usuarios de Demo

Tipo	Email	Contraseña
Cliente	cliente@demo.com	password123
Transportista	transportista@demo.com	password123
Cargador	cargador@demo.com	password123

API Endpoints

Autenticación

• POST /api/auth/register - Registrar usuario
• POST /api/auth/login - Iniciar sesión
• POST /api/auth/refresh - Renovar token
• GET /api/auth/me - Obtener usuario actual

Solicitudes

• POST /api/requests - Crear solicitud (cliente)
• GET /api/requests/my - Mis solicitudes (cliente)
• GET /api/requests/available - Solicitudes disponibles (transportista)
• GET /api/requests/:id - Detalle de solicitud
• POST /api/requests/:id/accept - Aceptar solicitud (transportista)

Tecnologías

Frontend:

• Angular 18 (standalone components)
• TypeScript
• SCSS con variables modernas
• RxJS

Backend:

• Node.js + Express
• PostgreSQL
• JWT para autenticación
• Joi para validación
• Winston para logging

Estructura del Proyecto

Frontend

trasla-frontend/src/app/
├── core/           # Servicios, guards, interceptors
├── shared/         # Componentes reutilizables
├── features/       # Módulos por funcionalidad
│   ├── auth/       # Login, registro
│   ├── client/     # Panel de cliente
│   ├── transporter/# Panel de transportista
│   ├── loader/     # Panel de cargador
│   └── profile/    # Perfil de usuario
└── models/         # Interfaces TypeScript

Backend

trasla-backend/src/
├── config/         # Configuración (DB, JWT)
├── middleware/     # Auth, roles, validación
├── controllers/    # Manejadores de rutas
├── services/       # Lógica de negocio
├── routes/         # Definición de rutas
├── validators/     # Schemas Joi
└── utils/          # Helpers (logger, tokens)

📄 Licencia

MIT