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.

La página /informe es el reporte público completo del estudio de demanda de transporte estudiantil de la UNRC Unidad Tijuana. Es una página SSR (Server Side Rendered) construida con el App Router de Next.js 16 que consolida métricas, gráficas interactivas, el diseño de las dos rutas piloto, testimonios de estudiantes y enlaces de descarga en una sola vista navegable.

Carga de datos: loadSiteData()

El componente de página es un async Server Component que llama a loadSiteData() antes de renderizar. Esta función lee sincrónicamente dos archivos de public/data/:
  • summary.json — métricas agregadas, series de datos, sugerencias, metadatos del autor y URLs de descarga
  • map_points.json — puntos geocodificados en formato MapPayload para el mapa de calor
Los datos se pasan como props a los componentes hijos; ningún dato personal (nombres, correos, matrículas) es accesible desde el servidor de estos archivos, ya que el procesamiento Python los elimina antes de generar los JSONs públicos.

Métricas clave del estudio

El encabezado hero de la página muestra cuatro paneles de métricas (metric-panel) derivados directamente de summary.metrics:

192

Estudiantes encuestados
Total de respuestas procesadas de la encuesta distribuida a la comunidad UNRC Unidad Tijuana.

190

Ubicaciones identificadas
El 98.96% de los encuestados pudo ubicarse en el mapa con coordenadas válidas (geolocated).

146

Sugerencias recibidas
El 76% de los estudiantes compartió propuestas concretas sobre rutas, tarifas, horarios y seguridad.

70

Colonias de origen
Se identificaron 70 colonias distintas en la zona metropolitana de Tijuana. La colonia con mayor concentración es Natura (30 estudiantes, 15.6%).
El hero también muestra:
  • El título del reporte: “Reporte de demanda de transporte estudiantil”
  • La institución destinataria: “Universidad Nacional Rosario Castellanos Unidad Tijuana”
  • El nombre y correo del autor: Daniel Cruz (daniel.cruz@tijuana.cloud)
  • Botones de acción: descarga del PDF y enlace al mapa interactivo
La página tiene un índice de anclas (anchor-row) que permite saltar directamente a cualquier sección:
AnclaSección
#mapaMapa de calor de demanda
#rutas-pilotoDiseño de las dos rutas piloto
#seriesGráficas de turnos, días y colonias
#sugerenciasTemas más mencionados y propuestas de tarifa
#nubeTestimonios de estudiantes
#procesoPipeline de datos (4 pasos)
#metodologiaTransparencia y protección de datos
#descargasPDF y CSV descargables
#tecnicoStack tecnológico del proyecto

Mapa de calor (#mapa)

Esta sección muestra un mapa interactivo cargado por <DashboardMapLoader> que recibe el objeto map de summary.json y los puntos de map_points.json. El mapa visualiza la densidad de origen de los 190 estudiantes geolocalizados. Los datos de map_points.json siguen la interfaz MapPayload:
interface MapPayload {
  generatedAt: string;
  center: [number, number];       // [32.464653, -116.924751]
  focusBounds: [[number, number], [number, number]];
  points: PublicPoint[];
}

interface PublicPoint {
  punto_id: string;
  colonia: string;
  turno: string;
  dias: string;
  licenciatura: string;
  lat_publica: number;
  lon_publica: number;
  fuente_coordenada_publica: string;
  sugerencia_publica: string;
}
Junto al mapa, un panel de insights destaca:
  • Natura es la colonia con más estudiantes
  • Se identificaron 190 puntos de salida en la zona metropolitana
  • El turno Matutino concentra la mayor demanda (96 estudiantes, 50%)
  • Resumen de tarifas: los montos más repetidos son 15(13),15 (13), 10 (10) y $18 (9) pesos

Diseño de rutas piloto (#rutas-piloto)

A partir de la muestra operativa con ubicación validada, se diseñaron dos rutas piloto que cubren el 100% de la demanda, con tiempos de viaje estimados de 90 minutos por trayecto.

Ruta 1: Centro → UNRC vía Corredor 2000

DatoValor
Estudiantes cubiertos107
Matutino49 alumnos
Intermedio32 alumnos
Vespertino26 alumnos
Paradas principalesPlaza Paseo 2000, Puente Peatonal Real de San Francisco / Plaza Oasis, Parada Sendero
Salida Matutino5:30 am
Salida Intermedio9:30 am
Salida Vespertino1:30 pm

Ruta 2: La Mesa → UNRC vía Camino Verde

DatoValor
Estudiantes cubiertos83
Matutino47 alumnos
Intermedio21 alumnos
Vespertino15 alumnos
Paradas principalesCalzapato Carrousel, Mitote, Oxxo Monte Bello
Salida Matutino5:30 am
Salida Intermedio9:30 am
Salida Vespertino1:30 pm

Gráficas de distribución (#series)

La sección de datos muestra tres gráficas Recharts a través del componente <ChartCard>:
Distribución de los 192 estudiantes por turno de asistencia:
TurnoCantidadPorcentaje
Matutino9650.0%
Intermedio5327.6%
Vespertino4221.9%
Matutino (7:00 a 11:00)10.5%
Colores de la escala: ["#BC955C", "#630038", "#235B4E", "#B80845", "#F75F17", "#0DA870"]

Sugerencias y propuestas (#sugerencias)

Temas más mencionados

Los 146 comentarios se clasificaron en ocho temas recurrentes. Cada tema aparece con un icono SVG, un conteo y su porcentaje sobre el total de encuestados con sugerencias:
TemaMenciones%
Tarifa estudiantil / precio justo5537.7%
Ruta directa y menos transbordos4832.9%
Cobertura en colonias específicas4631.5%
Seguridad y cruce peatonal3926.7%
Horarios y puntualidad3624.7%
Retorno o llegada a la entrada3221.9%
Apoyo a grupos vulnerables42.7%
Seguimiento del transporte21.4%

Tarifas propuestas

Los estudiantes proponen una tarifa entre 8y8 y 20 pesos según la ruta. Los montos más frecuentes:
TarifaEstudiantes que la propusieron
$15 pesos13
$10 pesos10
$18 pesos9
$20 pesos8
$8 pesos7
El bloque de resumen de tarifas señala: “Los montos más repetidos se concentran en 15 pesos (13), 10 pesos (10), 18 pesos (9).”

Testimonios de estudiantes (#nube)

La sección muestra un carrusel horizontal desplazable (testimonials-scroll) con todos los testimonios de summary.suggestions.highlights. Cada tarjeta incluye la cita textual del estudiante, su colonia de origen y su turno. Algunos ejemplos representativos:
“Una ruta que pase por urbi 1, delicias, natura donde somos más personas las que asisten de esos fraccionamientos”
— Urbi Villas del Prado · Matutino
“Un transporte para los estudiantes, ya que tenemos que cruzar la calle al tomar el transporte ya que no quieren retornar los choferes”
— Natura · Matutino
“Que obliguen a las demás rutas dejar en la universidad pues solo los taxis blanco que van a natura lo hacen”
— 5 y 10 · Intermedio

Pipeline de datos (#proceso)

La metodología del proyecto se visualiza como una cadena de cuatro pasos en un layout de flechas tipo “chevron”:
1

Recolección

Encuestas en Google Forms con respuestas abiertas de direcciones de origen y necesidades de transporte de los estudiantes de la UNRC.
2

Procesamiento (Python)

Limpieza con pandas y geocodificación automática de direcciones en texto libre mediante la API de Geopy / Nominatim (OpenStreetMap).
3

Análisis Logístico

Clustering espacial de los puntos geolocalizados para definir paradas óptimas y trazado de rutas basado en la densidad de demanda real.
4

Visualización (React)

Dashboard interactivo SSR con Next.js 16, MapLibre GL JS y generación de reportes en PDF con fpdf2 y matplotlib.

Transparencia y privacidad (#metodologia)

La sección de metodología declara explícitamente qué datos son públicos y cuáles se protegen: Datos públicos disponibles:
  • Estadísticas agregadas de turnos, días, colonias y sugerencias
  • Puntos en el mapa con coordenadas con jitter (desplazamiento aleatorio de pocos metros) para mostrar densidad sin revelar domicilios exactos
  • Reporte PDF y dataset CSV descargable para análisis independiente
Datos protegidos (nunca publicados):
  • Identidad de los estudiantes (nombres, correos, teléfonos, matrículas)
  • Direcciones exactas o referencias domiciliarias
  • Ubicaciones reales de origen sin anonimizar
  • Ningún enlace de mapa compartido por estudiantes en la encuesta

Descargas (#descargas)

Reporte completo en PDF

Incluye hallazgos, gráficas, recomendaciones y un código QR para acceder al mapa interactivo desde cualquier dispositivo.Ruta: /downloads/reporte-demanda-transporte.pdf

Dataset CSV de puntos públicos

Puntos geocodificados anónimos con colonia, turno y días de asistencia, listos para análisis en Excel, Python o R.Ruta: /downloads/public_points.csv

Stack tecnológico (#tecnico)

Procesamiento de datos

  • Python 3.12 con pandas para limpieza y análisis
  • Geopy / Nominatim para geocodificación de direcciones
  • fpdf2 para generación automática del reporte PDF
  • matplotlib para gráficas estadísticas

Sitio web

  • Next.js 16 con App Router y TypeScript
  • Recharts para gráficos interactivos (<ChartCard>)
  • MapLibre GL JS para mapas vectoriales acelerados por hardware

Infraestructura

  • Vercel para alojamiento y despliegue continuo del frontend
  • Hosting bajo la marca Tijuana Cloud (tijuana.cloud)

Código fuente

El proyecto es completamente abierto. El repositorio está disponible en GitHub para consulta, contribución o adaptación a otras instituciones educativas.github.com/danitocsc/transporte-unrc

Build docs developers (and LLMs) love