Loading...
return (
{investigation?.query}
Status: {investigation?.status}
Progress: {Math.round((investigation?.progress || 0) * 100)}%
Phase: {investigation?.current_phase}
Anomalies: {investigation?.anomalies_found}
{investigation?.status === 'completed' && (
Results
{investigation.results.map(anomaly => (
))}
)}
)
}
```
### Frontend: Realtime Subscription
```typescript
useEffect(() => {
// Subscribe to investigation updates
const channel = supabase
.channel(`investigation:${investigationId}`)
.on(
'postgres_changes',
{
event: 'UPDATE',
schema: 'public',
table: 'investigations',
filter: `id=eq.${investigationId}`,
},
(payload) => {
console.log('Update received:', payload.new)
setInvestigation(payload.new)
}
)
.subscribe()
return () => {
supabase.removeChannel(channel)
}
}, [investigationId])
```
---
## 🔒 Segurança
### Row Level Security (RLS)
✅ **Ativo por padrão** - Usuários só veem suas próprias investigações
✅ **Backend usa service_role_key** - Pode escrever para qualquer usuário
✅ **Frontend usa anon_key** - Respeita RLS automaticamente
### Testando RLS
```sql
-- No SQL Editor do Supabase
-- Simular usuário autenticado
SET LOCAL jwt.claims.sub = 'user-uuid';
-- Esta query só retorna investigações deste usuário
SELECT * FROM investigations;
```
### Políticas RLS Ativas
```sql
-- Ver políticas criadas
SELECT schemaname, tablename, policyname, permissive, roles, cmd
FROM pg_policies
WHERE tablename = 'investigations';
```
---
## 📈 Performance
### Connection Pooling
```python
# Configurado automaticamente
SUPABASE_MIN_CONNECTIONS=5 # Mínimo mantido aberto
SUPABASE_MAX_CONNECTIONS=20 # Máximo permitido
```
Supabase Free Tier: até 60 conexões simultâneas
Supabase Pro: até 200+ conexões
### Índices Otimizados
- **B-tree** para queries por user_id, status, created_at
- **GIN (JSONB)** para pesquisa dentro de filters e results
- **Composite** para queries combinadas (user_id + status)
### Cache Strategy
```python
# Layer 1: Memory (5 min)
# Layer 2: Redis (1 hr) - opcional
# Layer 3: Supabase (persistent)
```
---
## 🧪 Testes
### Script de Validação
```bash
python scripts/test_supabase_connection.py
```
Verifica:
- ✅ Conexão com Supabase
- ✅ Tabela `investigations` existe
- ✅ RLS está habilitado
- ✅ Policies estão ativas
- ✅ CRUD operations funcionam
### Teste Manual via SQL
```sql
-- Criar investigação de teste
INSERT INTO investigations (user_id, query, data_source, status)
VALUES (
'00000000-0000-0000-0000-000000000000',
'Test investigation',
'contracts',
'pending'
);
-- Ver investigações
SELECT id, query, status, progress, created_at
FROM investigations
ORDER BY created_at DESC;
-- Atualizar progresso
UPDATE investigations
SET progress = 0.5, current_phase = 'processing'
WHERE id = 'investigation-uuid';
```
---
## 🚢 Deploy
### HuggingFace Spaces
1. Vá para **Settings > Variables**
2. Adicione:
```
SUPABASE_DB_URL=postgresql://...
SUPABASE_SERVICE_ROLE_KEY=eyJhbGci...
```
3. Reinicie o Space
4. Verificar logs: `Starting Cidadão.AI... Connected to Supabase`
### Docker
```yaml
# docker-compose.yml
services:
backend:
image: cidadao-ai-backend
environment:
- SUPABASE_DB_URL=${SUPABASE_DB_URL}
- SUPABASE_SERVICE_ROLE_KEY=${SUPABASE_SERVICE_ROLE_KEY}
ports:
- "8000:8000"
```
---
## 🐛 Troubleshooting
| Problema | Solução |
|----------|---------|
| `Connection refused` | Verifique `SUPABASE_DB_URL`, teste com `psql` |
| `Permission denied` | Use `SUPABASE_SERVICE_ROLE_KEY` no backend |
| `Table does not exist` | Execute migration no SQL Editor |
| `Realtime not updating` | Habilite Realtime para tabela no dashboard |
| `Too many connections` | Ajuste `MAX_CONNECTIONS` ou upgrade plano |
Veja mais em: [docs/SUPABASE_INTEGRATION.md#troubleshooting](docs/SUPABASE_INTEGRATION.md)
---
## 📚 Recursos
### Documentação
- [SUPABASE_QUICK_START.md](docs/SUPABASE_QUICK_START.md) - Setup em 5 minutos
- [SUPABASE_INTEGRATION.md](docs/SUPABASE_INTEGRATION.md) - Guia completo
- [frontend_integration.tsx](examples/frontend_integration.tsx) - Exemplos React
### Links Externos
- [Supabase Documentation](https://supabase.com/docs)
- [Supabase Realtime](https://supabase.com/docs/guides/realtime)
- [Row Level Security](https://supabase.com/docs/guides/auth/row-level-security)
- [asyncpg](https://magicstack.github.io/asyncpg/)
### Seu Projeto
- **Supabase Dashboard**: https://pbsiyuattnwgohvkkkks.supabase.co
- **Backend API**: https://neural-thinker-cidadao-ai-backend.hf.space
- **Frontend**: (adicionar URL quando deployado)
---
## ✅ Próximos Passos
1. **Executar migration** no Supabase SQL Editor
2. **Configurar variáveis** de ambiente (.env)
3. **Testar conexão** com script
4. **Atualizar código** para usar `investigation_service_supabase`
5. **Deploy** no HuggingFace Spaces com novas variáveis
6. **Configurar frontend** com Supabase Client
7. **Testar fluxo completo** (create → process → monitor)
---
## 🎉 Benefícios da Integração
✅ **Persistência Real** - Dados não se perdem ao reiniciar backend
✅ **Realtime** - Frontend atualiza automaticamente
✅ **Escalabilidade** - Supabase gerencia infraestrutura
✅ **Segurança** - RLS protege dados por usuário
✅ **Backup Automático** - Supabase faz backup diário
✅ **Single Source of Truth** - Um banco para tudo
✅ **Zero Config** - Funciona out-of-the-box após setup inicial
---
**Autor**: Anderson H. Silva
**Data**: 2025-01-07
**Versão**: 1.0.0
**Supabase Project**: pbsiyuattnwgohvkkkks.supabase.co