Clima Cuida

App web estático, feito com Vite, React e TypeScript, para transformar dados de clima e qualidade do ar em uma recomendação simples do dia. A primeira tela já é o produto: busca de cidade, geolocalização opcional, seletor de perfil e um "Semáforo do Dia" com recomendações práticas.

Dor que resolve

Dados meteorológicos normalmente chegam separados: temperatura em um lugar, chuva em outro, UV em outro e qualidade do ar em outro. Para uma pessoa comum, isso dificulta decidir se vale sair, levar criança ou idoso para a rua, fazer exercício, dirigir, fechar janelas ou se proteger do sol e da chuva.

O Clima Cuida reúne esses fatores em uma leitura acionável, com score local de risco de 0 a 100 e explicação em linguagem simples.

APIs usadas

• Open-Meteo Weather Forecast API: clima atual, próximas horas e previsão diária.
• Open-Meteo Air Quality API: AQI dos EUA, PM2.5, PM10 e UV.
• Open-Meteo Geocoding API: busca de cidades por nome.

Não há chaves privadas, backend próprio, banco de dados ou coleta de conta de usuário. A geolocalização acontece somente no navegador e é usada apenas para chamar as APIs públicas.

Como rodar localmente

npm install
npm run dev

Para validar antes de publicar:

npm test
npm run build

Como publicar no GitHub Pages

O projeto está configurado para o repositório clima-cuida-care-weather em vite.config.ts:

base: command === 'build' ? '/clima-cuida-care-weather/' : '/'

Fluxo manual:

1. Rode npm run build.
2. Publique a pasta dist/ no GitHub Pages.
3. Se o repositório tiver outro nome, ajuste o base em vite.config.ts.

Fluxo automático:

1. Envie este projeto para o GitHub.
2. Em Settings -> Pages, selecione GitHub Actions.
3. Faça push na branch main; o workflow .github/workflows/deploy.yml gera o build e publica o artefato.

Como demonstrar em aula

1. Mostre a arquitetura em src/api, src/lib, src/components e src/data.
2. Execute npm test para demonstrar o cálculo de risco com testes unitários.
3. Rode npm run dev e pesquise uma cidade real.
4. Troque perfis para mostrar como criança, idoso, rinite/asma e atividade física mudam o risco.
5. Desligue a internet ou bloqueie a API no DevTools para mostrar o fallback com dados de exemplo.
6. Rode npm run build para provar que o projeto é estático e compatível com GitHub Pages.

Scripts

• npm run dev: servidor local Vite.
• npm test: testes unitários com Vitest.
• npm run build: typecheck e build de produção.
• npm run preview: prévia local do build.

Aviso

Use como orientação geral, não como recomendação médica.