joaquimmulaza/kamba-legal
Domain:
digital infrastructureRecord type:
software
Creator:
joa
Host:
# 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 + …