OutbreakAfrica

Uma plataforma de inteligência epidemiológica dedicada à monitorização em tempo real de surtos de doenças e emergências de saúde pública, com foco especial no continente africano.

🚧 Estado: Em construção | Em pausa temporária (feedback técnico bem-vindo)

🎯 O Problema

Informações sobre surtos de doenças e emergências de saúde pública em África estão fragmentadas e difíceis de aceder. O OutbreakAfrica resolve isto agregando dados fiáveis e tornando-os acessíveis para:

• 📰 Jornalistas
• 🔬 Investigadores
• 👥 Qualquer pessoa que precise desta informação

✨ Características Principais

Funcionalidades Implementadas

• ✅ Feed de surtos por país africano — visualize surtos organizados geograficamente
• ✅ Filtros avançados — por doença, país e período
• ✅ Integração estável com ReliefWeb API — através de Cloudflare Workers

Próximas Features

• 📋 Exportação multi-formato — .md, .pdf, .xlsx, CSV e Google Sheets
• 🔄 Comparação entre países — análise cruzada de dados epidemiológicos
• 🔔 Sistema de alertas por email — com condições customizáveis

🛠️ Stack Técnico

Frontend + API Routes
├─ Next.js (App Router)
└─ React + TypeScript

Backend
└─ Cloudflare Workers (Proxy seguro)

Fonte de Dados
└─ ReliefWeb API

Tecnologias

🔐 Por que um Cloudflare Worker?

A ReliefWeb API exige headers específicos que o Next.js server-side não passava corretamente.

Solução: Um Cloudflare Worker como intermediário que:

1. ✅ Resolve o problema dos headers
2. ✅ Mantém as credenciais seguras no server
3. ✅ Fornece um proxy estável e rápido

Cliente (Navegador)
    ↓
Next.js API Routes
    ↓
Cloudflare Worker (intermediário seguro)
    ↓
ReliefWeb API

🚀 Como Começar

Pré-requisitos

• Node.js 18+
• npm ou yarn
• Conta Cloudflare (para deployment do Worker)

Instalação

# Clone o repositório
git clone https://github.com/xmaj2001/OutbreakAfrica.git
cd OutbreakAfrica

# Instale as dependências
npm install

# Configure as variáveis de ambiente
cp .env.example .env.local

# Execute em desenvolvimento
npm run dev

Aceda a http://localhost:3000 no seu navegador.

Configuração do Cloudflare Worker

1. Crie um novo Worker na Dashboard Cloudflare
2. Deploy do Worker (ver instruções em /src/worker)
3. Configure a URL do Worker nas variáveis de ambiente

NEXT_PUBLIC_WORKER_URL=https://seu-worker.seu-dominio.workers.dev

📁 Estrutura do Projeto

OutbreakAfrica/
├── src/
│   ├── app/                   # Next.js App Router
│   │   ├── page.tsx          # Página inicial
│   │   ├── layout.tsx        # Layout raiz
│   │   └── api/              # API Routes
│   ├── components/           # Componentes React reutilizáveis
│   ├── hooks/                # React Hooks customizados
│   └── lib/                  # Utilitários, helpers e funções
├── public/                   # Arquivos estáticos
├── .preview/                 # Ficheiros de preview/demo
├── biome.json               # Configuração do Biome (linter + formatter)
├── components.json          # Configuração do shadcn/ui
├── next.config.ts           # Configuração do Next.js
├── tsconfig.json            # Configuração do TypeScript
├── postcss.config.mjs        # Configuração do PostCSS
├── package.json             # Dependências do projeto
└── README.md                # Este ficheiro

Descrição das Pastas

• src/app/ — Estrutura de rotas do Next.js (App Router). Cada pasta/ficheiro é uma rota.
• src/components/ — Componentes React reutilizáveis (ex: cards, filtros, headers)
• src/hooks/ — Custom React Hooks para lógica reutilizável
• src/lib/ — Funções utilitárias, integrações com APIs, helpers TypeScript
• public/ — Imagens, ícones e outros recursos estáticos servidos na raiz

📚 Documentação

• Guia de Contribuição — ajude-nos a melhorar
• ReliefWeb API Docs — documentação da fonte de dados
• Cloudflare Workers Docs — saiba mais sobre Workers
• Next.js App Router — documentação oficial Next.js

🤝 Contribuições

Este é um projeto open-source. Contribuições são bem-vindas!

1. Fork o repositório
2. Crie uma branch para a sua feature (git checkout -b feature/MinhaFeature)
3. Commit as suas mudanças (git commit -m 'Add MinhaFeature')
4. Push para a branch (git push origin feature/MinhaFeature)
5. Abra um Pull Request

Feedback técnico é especialmente bem-vindo! 👇

📝 Licença

MIT License — Veja o ficheiro LICENSE para detalhes.

🔗 Links Úteis

• 🌍 ReliefWeb — Plataforma de informação humanitária
• ☁️ Cloudflare
• ⚛️ Next.js
• 🟦 TypeScript
• 🧹 Biome — Linter e formatter

👨‍💻 Autor

xmaj2001 — @GitHub

---

#Cloudflare #CloudflareWorkers #NextJS #HealthData #Africa #SideProject #DevLearning