Pulso da Cidade

# Crie "City Pulse": um atlas 3D interativo da mobilidade dos táxis de Nova York (janeiro de 2025)

## Objetivo
Uma visualização web de página única, em inglês, que mostre como Nova York se movimenta ao longo de um mês:
31 dias, 24 horas, 263 zonas de táxi. O leitor deve poder acompanhar o ritmo diário da cidade,
comparar qualquer dia com um dia útil ou fim de semana típico e analisar qualquer zona em detalhes.
Esta é uma ferramenta de análise descritiva, não um produto em tempo real nem baseado em GPS. Todo elemento visual deve indicar o que uma marca representa.

## Dados
Fontes (públicas):
- NYC TLC Trip Record Data, Yellow Taxi, janeiro de 2025 (Parquet)
- NYC TLC Taxi Zones (263 zonas, formas geométricas + correspondência com os distritos)
- Pegadas de edifícios do NYC Open Data (apenas Manhattan, como contexto visual)

Pré-processamento (Python + DuckDB ou pandas), com saída em pequenos arquivos JSON estáticos:
- Filtrar viagens inválidas: embarque fora de janeiro de 2025, duração não positiva ou superior a 3 h, zonas desconhecidas (264/265).
- Por dia, zona e hora: contagem de embarques, duração mediana da viagem.
- Por dia e hora: principais pares de zonas de origem → destino (fluxos agregados, top N por hora).
- Médias de referência por zona-hora: média de dias úteis (23 dias) e média de fins de semana (8 dias), médias por dia; feriados permanecem no grupo de dias úteis.
- Escala fixa para o mês: máximo de embarques por zona-hora, usada em todos os dias para manter as alturas comparáveis.
- Metadados das zonas: id, nome, distrito, centroide e âncora do rótulo. Simplificar a geometria das zonas.
Arquivos: month.json (totais diários, escala e principais zonas), weekday.json, weekend.json, days/2025-01-DD.json, zones geojson.
Carregar o dia atual sob demanda; manter o primeiro carregamento rápido.

## Stack
- Um único arquivo HTML autocontido (ou um pequeno app Vite) com Three.js 0.160 (módulos ES via importmap), OrbitControls, EffectComposer + bloom.
- D3 apenas para escalas/formatação e pequenos gráficos SVG.
- Nenhum framework é necessário. Sem chamadas a APIs externas durante a execução; tudo deve ler os arquivos JSON estáticos.

## Layout (a versão para desktop em 1920×1080 deve caber em uma única tela, sem rolagem)
1. Cabeçalho: "CITY PULSE / MOBILITY ATLAS", status "Recorded replay", link "Data & methods".
2. Linha de status: "A city, in motion." + três KPIs: embarques em toda a cidade (hora selecionada), comparação com a média e duração mediana da viagem.
3. Faixa do mês: 31 botões de dia como barras em miniatura (altura da barra = embarques diários, fins de semana marcados), dia anterior/próximo, seletor de data, seletor "Compare with" (Weekday average · 23 days / Weekend average · 8 days).
4. Barra narrativa: "Every movement leaves a pattern." com 4 capítulos (01 Watch, 02 Unfold, 03 Compare, 04 Share) e "Start the story".
5. Abas de visualização: 01 Connections, 02 Volume city, 03 Unfold 24h, 04 Ghost city, além de "Share finding" e "Create briefing".
6. Área de trabalho: palco do mapa 3D (à esquerda) + inspetor Location Insight (à direita, ~330 px, com rolagem interna).
7. Linha do tempo: Play day, velocidade (0.25×–4×), controle de busca da hora sobre um gráfico de barras de 24 horas do dia selecionado versus a média.
A altura do palco do mapa deve se adaptar à janela de visualização (limitada entre ~470 px e ~780 px) para que todo o console, incluindo a linha do tempo, fique visível com zoom de 100%.

## Cena 3D
- Piso escuro, contornos das zonas como linhas finas e pegadas dos edifícios de Manhattan como contexto sutil do mundo real.
- Câmera: perspectiva, órbita + zoom e botão para recentralizar. Manter a câmera do usuário ao trocar de visualização, exceto em "Unfold 24h", que deve sempre reenquadrar a cena para mostrar toda a matriz.
- Ao passar o cursor sobre uma zona: tooltip com nome e embarques. Ao clicar em uma zona: selecioná-la (atualiza o inspetor e os fluxos).

Visualizações (toda troca deve ser animada, sem mudanças bruscas):
- 01 Connections: viagens agregadas entre zonas como arcos luminosos com partículas de luz em movimento; densidade das partículas ∝ viagens; identificar o fluxo em destaque ("FROM / Midtown Center → TO / Upper East Side North, 71 trips / 18:00"). Legenda: "Recorded zone-to-zone trips · schematic motion. Not GPS."
- 02 Volume city: extrudar cada zona; altura = embarques na escala mensal fixa; destacar a zona selecionada.