Edgar-Del/ml-rihs-FTL-Angola

RIHS - Recomendador Inteligente de Hospedagem Sustentável API desenvolvida em FastAPI que utiliza modelos de Machine Learning para classificar e pontuar a sustentabilidade de estabelecimentos hoteleiros. O sistema analisa características como eficiência energética, gestão de resíduos, conservação de água e impacto social para fornecer os scores. # Recomendador Inteligente de Hospedagem Sustentável (RIHS) > **API de classificação de sustentabilidade para hotéis angolanos** > Alinhado aos ODS 8, 12 e 13 | Bootcamp Frontier Tech Leaders UNDP Angola 2025 **Deployment em Produção:** rihs-ftl-undp.ew.r.appspot.… --- ## Índice - Visão Geral - Sobre o Projeto - Objectivos de Desenvolvimento Sustentável - Funcionalidades - Arquitetura Técnica - Casos de Uso Práticos - Tecnologias Utilizadas - Estrutura do Projeto - Instalação e Configuração - Uso da API - Deployment - Testes - Documentação - Impacto e Contribuições - Equipa - Referências --- ## Visão Geral O **Recomendador Inteligente de Hospedagem Sustentável (RIHS)** é uma API inteligente baseada em Machine Learning que classifica o nível de sustentabilidade de hotéis angolanos com base em indicadores ambientais, sociais e económicos. O sistema utiliza técnicas avançadas de IA para processar dados multiestruturados e fornecer recomendações personalizadas que promovem o turismo sustentável e consciente. ### Características Principais - ✅ **Classificação Automática** de sustentabilidade usando modelos de ML (XGBoost, Random Forest) - ✅ **API RESTful** completa com FastAPI e documentação automática - ✅ **Autenticação Segura** via API Key - ✅ **Observabilidade** integrada com Prometheus - ✅ **Deployment em Produção** no Google Cloud Platform - ✅ **Containerização** com Docker e Docker Compose - ✅ **Testes Automatizados** com cobertura ≥90% - ✅ **Versionamento de Modelos** com fallback seguro --- ## 📖 Sobre o Projecto ### Contextualização do Problema O sector do turismo em Angola representa uma das maiores oportunidades de diversificação económica e desenvolvimento sustentável do país. Contudo, o modelo actual de hospitalidade enfrenta um problema estrutural: **a invisibilidade dos alojamentos sustentáveis** que praticam gestão ambiental responsável, mas permanecem fora dos grandes circuitos digitais. Em plataformas internacionais como Bo …