Skip to content
BarujaFe1Public

About

MVP lab: auditable regularity/quality/reliability analytics for noisy public-transit GPS pings. Live Demo + FastAPI/Next.js.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

ViaStat Logo

ViaStat

Mobilidade auditada — regularidade, qualidade e confiabilidade a partir de pings GPS ruidosos.

Audited mobility — regularity, quality and reliability from noisy public-transit GPS pings.

PT-BR · English · Live Demo · Stack · Architecture · Quick Start · Author

Live Demo Next.js TypeScript Python FastAPI Leaflet Lab Demo MIT

Live Demo · Repositório · Portfólio · LinkedIn

ViaStat overview


PT-BR

Visão geral

ViaStat (Mobilidade Auditada) transforma pings GPS ruidosos de transporte público em métricas auditáveis de regularidade, qualidade e confiabilidade, com incerteza explícita. MVP lab com Live Demo + FastAPI/Next.js.

Aviso de lab: demo de portfólio com dados sintéticos/amostra. Não é produto em produção com SLA, integrações reais de clientes ou garantia operacional.


Problema

GPS de ônibus é ruidoso e incompleto. Sem pipeline auditável, indicadores de regularidade viram números opacos.


Para quem

  • Analistas de mobilidade urbana
  • Engenheiros de dados de transporte
  • Gestores públicos avaliando qualidade de serviço (contexto lab)

Funcionalidades

  • Pipeline bronze/silver/gold
  • Métricas de regularidade/qualidade/confiabilidade
  • Mapa (Leaflet) por confiabilidade
  • Brief metodológico
  • Dados sintéticos GTFS-like
  • Testes pytest + Playwright e2e

Escopo e limites

  • É: lab analítico com dados sintéticos reproduzíveis.
  • Não é: operação de cidade real, AVL production, SLA de transporte público.

English

Overview

ViaStat (Audited Mobility) turns noisy public-transit GPS pings into auditable regularity, quality and reliability metrics with explicit uncertainty. MVP lab with Live Demo + FastAPI/Next.js.

Lab notice: portfolio demo with synthetic/sample data. Not a production product with SLA, real customer integrations, or operational guarantees.


Problem

Bus GPS is noisy and incomplete. Without an auditable pipeline, regularity indicators become opaque numbers.


Who it is for

  • Urban mobility analysts
  • Transit data engineers
  • Public managers exploring service quality (lab context)

Features

  • Bronze/silver/gold pipeline
  • Regularity/quality/reliability metrics
  • Leaflet map by reliability
  • Methodological brief
  • Synthetic GTFS-like data
  • pytest + Playwright e2e

Scope and limits

  • Is: analytical lab with reproducible synthetic data.
  • Is not: real-city operations, production AVL, public-transit SLA.

Live Demo

URL: https://viastat-eight.vercel.app

Demo hospedada para avaliação de portfólio / Hosted for portfolio review.

Lab demo — synthetic / sample data unless noted. Not a production SLA product.


Stack / Tecnologias

Tecnologia Uso no projeto
Next.js 16 / React 19 / TypeScript / Tailwind Frontend
Leaflet / react-leaflet / Recharts / Lucide Mapa e charts
FastAPI / Pydantic / Uvicorn API
Polars / NumPy Processamento
Pytest / Playwright Testes

Arquitetura / Architecture

�ackend/ FastAPI + rontend/ Next.js + camadas data/ + scripts/ de geração sintética e docs de auditoria.

xt viastat/ ├── backend/ │ ├── routers/ │ ├── schemas/ │ ├── services/ │ └── main.py ├── frontend/ │ ├── src/ │ └── e2e/ ├── data/ │ ├── raw/ bronze/ silver/ gold/ ├── scripts/ ├── tests/ ├── docs/ ├── assets/ └── vercel.json


Quick Start / Início rápido

Pré-requisitos / Requirements

  • Node.js 20+
  • Python 3.12+
  • npm

Clonar / Clone

�ash git clone https://github.com/BarujaFe1/viastat.git cd viastat

Backend

�ash pip install -r requirements.txt -r backend/requirements.txt uvicorn backend.main:app --reload --port 8000

Frontend

�ash cd frontend npm ci npm run dev

Abra http://localhost:3000

`�ash

testes

pytest cd frontend && npm run lint && npm run typecheck

e2e: API :8000 + Next :3000

cd frontend && npm run test:e2e:install && npm run test:e2e `


Technical decisions / Decisões técnicas

  • Sintético vs real: demo segura e reproduzível; não afirma operação de cidade real.
  • Polars para pipeline tabular eficiente.
  • Incerteza explícita nas métricas de confiabilidade.
  • Leaflet para mapa de rede por confiabilidade.

Roadmap

Implementado

  • Pipeline, métricas, mapa, brief, Live Demo Vercel, testes

Planejado

  • Mais indicadores de headway
  • Comparativos entre dias
  • Empacotamento de dataset gold

Autor / Author

Developed by Felipe Alirio Baruja.


License / Licença

MIT License.

See LICENSE for details.


ViaStat

Mobilidade com métricas auditáveis — lab sintético.

Mobility with auditable metrics — synthetic lab.

About

MVP lab: auditable regularity/quality/reliability analytics for noisy public-transit GPS pings. Live Demo + FastAPI/Next.js.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages