Saltar al contenido principal

Estándares de Datos y Glosario de Dominio

Documento de referencia para el equipo de desarrollo que asegura coherencia terminológica y homogeneidad en el pipeline de datos.


1. Glosario de Dominio​

TérminoDefinición
RutaVivaPlataforma para el procesamiento, estandarización y tarificación dinámica de flota vehicular urbana.
F1NYC Yellow Taxi Trip Data (CSV histórico con cambios de esquema entre años).
F2Catálogo oficial de Taxi Zones de la TLC (Shapefile y CSV lookup).
F3Datos meteorológicos horarios (históricos de API Open-Meteo).
F4Telemetría GPS en streaming (pulsos cada 15 segundos).
F5Solicitudes continuas de viaje generadas por pasajeros.
F6Registro operativo de conductores, vehículos, licencias y sanciones.
F7Calendario de eventos masivos y emergencias.
Índice de PresiónRelación matemática Presión = Demanda / max(Oferta, 1).
Degradación SeguraMecanismo de fallback por el cual la API retorna multiplicador 1.0 con degraded: true ante fallos o datos obsoletos (>300 s).

2. Convenciones de Desarrollo​

  • Estrategia de Ramas: Git Flow simplificado:
    • main: Código estable y probado para producción.
    • feature/<nombre>: Ramas de funcionalidad aisladas (feature/DataSeed, feature/telemetry-simulator, feature/api).
  • Mensajes de Commit: Formato Conventional Commits:
    • feat: ...: Nueva funcionalidad.
    • fix: ...: Corrección de un defecto.
    • chore: ...: Mantenimiento o configuración.
    • docs ...:Cambios en documentación.
    • refactor: ...Reestructuración del código sin cambiar su funcionalidad.
    • test: ...: Creación o modificación de pruebas.
    • data: ... :Cambios relacionados con datos, esquemas o transformaciones.
  • Tipado y Fechas:
    • Fechas siempre en UTC (TIMESTAMPTZ o naive normalizado en Python con replace(tzinfo=None)).
    • Monedas y multiplicadores representados mediante tipos decimales exactos (NUMERIC).