Uúba Tech — Sprint Report

Plataforma de cobrança inteligente para PMEs brasileiras
10 a 16 de Março 2026

1 Resumo Executivo

Semana de fundação completa do projeto. Saímos do zero para uma API funcional em produção com documentação pública, 174 testes automatizados e CI/CD.

30
Commits
6.760
Linhas de código
14
Endpoints REST
174
Testes automatizados
7
Bugs corrigidos
2.4s
Tempo dos testes

2 Entregas da Semana

Site Institucional

Publicado uuba.tech

API REST

Em produção api.uuba.tech

Documentação

Publicada developers.uuba.tech

CI/CD

Verde GitHub Actions

Infraestrutura

VPS Docker Compose + Nginx + Let's Encrypt SSL

3 API — 14 Endpoints

MétodoEndpointDescrição
POST/api/v1/clientesCadastrar cliente
GET/api/v1/clientesListar clientes
GET/api/v1/clientes/{id}Buscar cliente
PATCH/api/v1/clientes/{id}Atualizar cliente
GET/api/v1/clientes/{id}/metricasMétricas financeiras
POST/api/v1/faturasRegistrar fatura
GET/api/v1/faturasListar faturas
GET/api/v1/faturas/{id}Buscar fatura
PATCH/api/v1/faturas/{id}Atualizar status/promessa
POST/api/v1/cobrancasRegistrar cobrança
GET/api/v1/cobrancasListar cobranças
GET/api/v1/cobrancas/{id}/historicoTimeline da fatura
PATCH/api/v1/cobrancas/{id}/pausarPausar régua
PATCH/api/v1/cobrancas/{id}/retomarRetomar régua

4 Qualidade — 174 Testes

3 fases do Testing Arsenal aplicadas:

Foundation (unit + integration)86 testes
49%
API Breaker (security)66 testes
38%
Data Integrity22 testes
13%

Vetores de Ataque Testados

Auth bypass SQL injection XSS Mass assignment Path traversal FK constraints Encoding (emoji/CJK) Pagination abuse State machine RFC 9457 contracts

5 Bugs Encontrados e Corrigidos

Todos encontrados pelos testes automatizados, corrigidos antes do deploy:

#BugSeveridadeStatus
1Middleware bloqueava exception handlersCRITICACorrigido
2IntegrityError não capturado (clientes)ALTACorrigido
3IntegrityError não capturado (faturas)ALTACorrigido
4IntegrityError não capturado (cobranças)ALTACorrigido
5Input inválido em filtro de período crasheavaALTACorrigido
6Paginação aceitava limit negativoMEDIACorrigido
7Comparação de datas com timezone inconsistenteMEDIACorrigido

6 Arquitetura Planejada

┌─────────────┐ ┌──────────────────┐ ┌─────────────┐ │ WhatsApp │────▶│ n8n Workflows │────▶│ Claude AI │ │ Cliente │◀────│ │◀────│ 3 Agentes │ └─────────────┘ └────────┬───────────┘ └─────────────┘ │ ┌────────▼───────────┐ │ FastAPI (REST) │ ◀── api.uuba.tech │ 14 endpoints │ └────────┬───────────┘ │ ┌────────▼───────────┐ │ PostgreSQL 16 │ │ clientes │ │ faturas │ │ cobrancas │ │ agent_decisions │ ◀── Sprint 3 └────────────────────┘

3 Agentes IA (próximo sprint)

AgenteModeloFunção
TriagemClaude HaikuClassifica urgência e decide próxima ação
CobrançaClaude SonnetGera mensagens personalizadas por tom/canal
RelatóriosClaude SonnetAnalisa carteira e gera insights

7 Próximos Passos

PrioridadeItemSprint
P0Rodar migração Alembic na VPS (criar tabelas)Imediato
P0Sistema de agentes (agent_decisions, prompts, examples)Sprint 3
P1Escalação, relatórios, dashboard, webhooksSprint 4
P1Workflows n8n com agentes IASprint 5
P2SonarCloud — badges de qualidadeSprint 6
P2Testes de performance (k6 load testing)Sprint 6

Progresso Geral do MVP

Fase 1 — MVP Completo (25 tasks, 7 chunks)Chunks 1-2 de 7
28%

8 Links Úteis

Site
uuba.tech
API
api.uuba.tech
Docs
developers.uuba.tech
Repositório
GitHub (privado)
Uúba Tech © 2026 — Relatório gerado automaticamente