Initial Clima Cuida app

README.md

@@ -0,0 +1,71 @@
+# 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
+
+```bash
+npm install
+npm run dev
+```
+
+Para validar antes de publicar:
+
+```bash
+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`:
+
+```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.