Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/danitocsc/transporte-unrc-web-public/llms.txt

Use this file to discover all available pages before exploring further.

Puedes tener el sitio corriendo en tu máquina en menos de cinco minutos. Elige el método que mejor se adapte a tu entorno: Docker Compose produce una imagen de producción idéntica a la que corre en Vercel, mientras que el servidor de desarrollo de Next.js ofrece recarga en caliente y es ideal para explorar o modificar el código.

Requisitos previos

Antes de empezar asegúrate de tener instalados:
  • Node.js 20 o superior — requerido por Next.js 16 y por la imagen base del Dockerfile (node:20-alpine).
  • Docker (solo para la pista Docker Compose) — cualquier versión que incluya el subcomando docker compose (Docker Desktop 4+ o Docker Engine 20.10+).
  • Git — para clonar el repositorio.

Elige tu método de ejecución

Esta pista construye la imagen de producción con un build multi-etapa (deps → builder → runner) usando node:20-alpine y levanta el contenedor transporte-web escuchando en el puerto 3000. No necesitas instalar dependencias de Node manualmente.
1

Clona el repositorio

Clona el proyecto y entra en el directorio raíz:
git clone https://github.com/danitocsc/transporte-unrc-web-public.git
cd transporte-unrc-web-public
2

Construye e inicia el servicio

Ejecuta Docker Compose en modo detached. La primera vez compilará la imagen completa de Next.js (puede tardar un par de minutos):
docker compose up --build -d
Docker Compose leerá el docker-compose.yml en la raíz, construirá el contexto desde ./web y arrancará el contenedor transporte-web con NODE_ENV=production y HOSTNAME=0.0.0.0.
3

Abre el sitio en tu navegador

Navega a http://localhost:3000. La ruta raíz redirige automáticamente a /mapa-demanda, donde verás el mapa interactivo con las paradas y rutas piloto del estudio.
El docker-compose.yml no publica explícitamente el puerto en un bloque ports: estándar — si tu contenedor no responde, asegúrate de exponer el puerto 3000 añadiendo lo siguiente bajo el servicio web:
ports:
  - "3000:3000"
4

Verifica el healthcheck

Confirma que el servicio está sano consultando el endpoint de healthcheck:
curl http://localhost:3000/api/health
Respuesta esperada:
{"status":"ok"}
Docker Compose ejecuta este mismo chequeo cada 30 segundos internamente. Puedes ver el estado con docker inspect transporte-web --format='{{.State.Health.Status}}'.

Rutas disponibles

Una vez que el sitio esté corriendo, estas son todas las rutas que puedes explorar:
RutaDescripción
/Redirige automáticamente a /mapa-demanda
/mapa-demandaMapa interactivo con paradas y rutas piloto
/mapa-demanda?sidebar=trueMapa con el panel lateral de paradas abierto
/informeReporte completo de demanda con gráficas, metodología y testimonios
/api/healthHealthcheck del servicio — devuelve {"status":"ok"}

Datos incluidos en el repositorio

Los archivos JSON en web/public/data/ ya están versionados en el repositorio y se sirven como activos estáticos. No necesitas configurar ninguna base de datos externa ni ejecutar scripts de procesamiento para levantar el sitio.
ArchivoContenido
paradas.jsonCoordenadas y metadatos de las paradas propuestas
custom_routes.jsonGeometrías de las rutas piloto identificadas en el estudio
summary.jsonMétricas agregadas del análisis de demanda
map_points.jsonPuntos georeferenciados para la capa de calor del mapa
Si deseas regenerar estos archivos desde la encuesta original, consulta la sección Pipeline de datos.

Build docs developers (and LLMs) love