TRANSCEND Website

Sistema predictivo de tráfico y rutas impulsado por Inteligencia Artificial para la optimización de flotas logísticas.

Tech Stack

• Framework: Next.js 15 (App Router)
• UI: React 19, Tailwind CSS 4, Radix UI
• Lenguaje: TypeScript 5 (strict mode)
• Internacionalización: next-intl
• CMS: Ghost (Content API)
• Analytics: Partytown (web workers para third-party scripts)
• Deployment: Cloudflare Pages (con @cloudflare/next-on-pages)

Características

• Predicción de congestión hasta 72 horas de antelación
• Integración de datos históricos de tráfico, información en tiempo real, variables meteorológicas y eventos
• Mapa interactivo de rutas alternativas
• Simulaciones "What-If" para prever impacto de condiciones
• Índice de riesgo de congestión por franja horaria
• Alertas en tiempo real para transportistas
• API integrable con TMS (Transport Management Systems)
• Sistema predictivomultifuente (tráfico, clima, logística, eventos regionales)
• Soporte multiidioma (ES, EN, PT, FR, IT, GL, DE)
• Deployment edge en Cloudflare

Primeros Pasos

Requisitos

• Node.js 20+
• npm / yarn

Instalación

# Clonar el repositorio
git clone https://github.com/cargoffer/transcend_website.git
cd transcend_website

# Instalar dependencias
yarn install

# Copiar variables de entorno
cp .env.example .env.local

# Editar .env.local con tus credenciales

Variables de Entorno

# Ghost CMS
GHOST_API_URL=https://your-ghost-instance.com
GHOST_CONTENT_API_KEY=your_api_key
GHOST_ADMIN_API_KEY=your_admin_key

# Transcend API (servicio de predicción)
TRANSCEND_API_URL=https://api.transcend.cargoffer.com
TRANSCEND_API_KEY=your_api_key

# Idioma por defecto
NEXT_PUBLIC_DEFAULT_LOCALE=es

Desarrollo

# Iniciar servidor de desarrollo
yarn dev

# Ejecutar lint
yarn lint

# Ejecutar tests
yarn test

# Tests E2E
yarn test:e2e

Estructura del Proyecto

.
├── src/
│   ├── app/              # Next.js App Router (rutas en [locale]/)
│   ├── components/       # Componentes React
│   │   ├── about/       # Componentes de página about
│   │   ├── blog/       # Componentes de blog
│   │   ├── home/       # Componentes de homepage
│   │   ├── layout/     # Layout (header, footer)
│   │   └── pricing/    # Componentes de pricing
│   ├── configs/        # Configuraciones del sitio
│   ├── contexts/       # React Contexts
│   ├── hooks/          # Custom Hooks
│   ├── libs/           # Integraciones externas
│   ├── locales/        # Archivos de traducción JSON
│   ├── middleware.ts  # Middleware de i18n
│   ├── services/      # Lógica de negocio
│   ├── styles/        # Estilos globales
│   ├── types/         # Definiciones TypeScript
│   └── utils/         # Utilidades
├── public/             # Assets estáticos
└── tests/             # Tests E2E (Playwright)

Funcionalidades Principales

Predicción de Congestión

El sistema analiza patrones históricos, eventos en tiempo real y condiciones meteorológicas para predecir congestiones hasta 72 horas antes de que ocurran.

Mapa Interactivo

Visualización de rutas con índices de riesgo por horario. Identificación automática de tramos problemáticos.

Simulaciones What-If

Simulación del impacto de:

• Condiciones meteorológicas adversas
• Aumento de demanda en determinadas franjas
• Eventos programados (ferias, obras, partidos)
• Condiciones fronterizas España-Portugal

Integración TMS

API REST para integración con sistemas de gestión de transporte (TMS) existentes.

Deployment

Cloudflare Pages

# Build y deploy
yarn deploy

# Preview local (simula edge)
yarn preview

El proyecto usa @cloudflare/next-on-pages para compatibilidad con Cloudflare Pages y Workers.

Dominio

Dominio	Descripción
transcend.cargoffer.com	Web de TRANSCEND

Scripts Disponibles

Script	Descripción
yarn dev	Servidor de desarrollo
yarn build	Build de producción
yarn start	Servidor de producción
yarn preview	Preview Cloudflare Pages
yarn deploy	Deploy a Cloudflare
yarn lint	Linting ESLint
yarn lint:fix	Auto-fix linting
yarn check-types	Verificación TypeScript
yarn test	Tests unitarios (Vitest)
yarn test:e2e	Tests E2E (Playwright)
yarn storybook	Storybook dev server
yarn commit	Commit interactivo (Conventional Commits)

Diferencias con cargoffer/website

Característica	cargoffer/website	transcend_website
Propósito	Marketplace transporte	Predicción tráfico/IA
Partytown	No	Sí
Foco	Load board	Optimización rutas
API predicción	No	Sí

Licencia

MIT