joaquimmulaza/kamba-legal

# Kamba Legal 🇦🇴⚖️ > **Assistente digital de processos burocráticos para Angola** Kamba Legal é uma plataforma de inteligência artificial que auxilia cidadãos angolanos a navegar em processos burocráticos de forma clara, simples e acessível. O assistente responde a perguntas sobre documentação, procedimentos legais e serviços públicos em Angola, guiando o utilizador passo a passo como se tivesse um especialista ao seu lado. --- ## 📋 Índice - Visão Geral - Arquitetura - Tecnologias - Pré-requisitos - Configuração e Instalação - Backend - Frontend - Variáveis de Ambiente - Execução Local - Deploy - Backend — Google Cloud Run - Frontend — Firebase Hosting - Endpoints da API - Estrutura do Projeto - Roadmap --- ## Visão Geral Kamba Legal resolve um problema real: a burocracia angolana é complexa e muitos cidadãos não sabem quais os documentos necessários, os passos a seguir ou onde se dirigir para resolver os seus assuntos. O assistente usa o modelo de linguagem **Gemini** da Google para fornecer respostas contextualizadas, claras e passo a passo. **Fluxo principal:** 1. O utilizador abre o chat na interface web. 2. Escreve a sua pergunta (ex: "Como tirar o BI em Angola?"). 3. O frontend envia a pergunta à API do backend. 4. O backend constrói um prompt especializado e consulta a **Gemini AI**. 5. A resposta é devolvida ao utilizador de forma clara e estruturada. --- ## Arquitetura O projeto está dividido em dois serviços independentes: ``` kamba-legal/ ├── kamba-legal-backend/ # API REST em Python (FastAPI) └── kamba-legal-frontend/ # SPA em React + TypeScript ``` ``` ┌─────────────────────────────────────────────────────────┐ │ Utilizador │ │ (Browser / PWA) │ └──────────────────────┬──────────────────────────────────┘ │ HTTPS ┌──────────────────────▼──────────────────────────────────┐ │ Frontend — Firebase Hosting │ │ React 19 + …