Estamos finalizando uma ferramenta web que processa contratos imobiliários em pdf através de uma api externa de ia (similar ao chatgpt para documentos).
O frontend React 19 está 100% pronto e funcionando. Não há trabalho de ui/ux.
O Problema Técnico
Hoje a chamada para a API acontece direto no navegador, o que:
Expõe a chave da API (risco de uso indevido)
Impede a monetização por créditos
Precisamos urgentemente:
Mover a lógica para backend seguro (Firebase Cloud Functions)
Implementar sistema de créditos pré-pagos (Firestore)
Integrar pagamento via Mercado Pago
escopo fechado do mvp
este escopo não será alterado durante o projeto.
Backend (Cloud Functions -
Node.js/TypeScript)
Endpoint principal:
Recebe PDF do frontend
Valida formato e tamanho (máx 5MB)
Verifica saldo de créditos no Firestore
Chama API externa (chave protegida no servidor)
Desconta 1 crédito após sucesso
Retorna análise ao frontend
Endpoint secundário:
Consultar saldo de créditos do usuário
Segurança básica:
Rate limiting simples (5 req/minuto)
Timeout de 30 segundos
Validação de input
Integração Mercado Pago
Implementar Checkout Pro (redirecionamento)
3 pacotes fixos de créditos (valores definidos)
Webhook seguro que:
Valida autenticidade do pagamento
Adiciona créditos ao Firestore
Registra log da transação
Firebase (Firestore + Auth)
Estrutura de dados para:
Créditos por usuário
Histórico simplificado de uso
Log de transações
Security Rules:
Usuário só acessa seus próprios dados
Cloud Functions têm permissão administrativa
Firebase Auth já configurado (login Google + email/senha)
Ajustes no Frontend (React 19)
Trocar chamada direta por endpoint do backend
Exibir saldo de créditos atualizado
Botão "Comprar Créditos" → redireciona para Mercado Pago
Tratamento de erros (sem créditos, arquivo inválido, timeout)
Loading durante processamento
Histórico + Download
Salvar apenas: data, nome do arquivo, status
Não armazenar análise completa (reduz custo)
Botão de download: usuário baixa análise em pdf/json após processamento
requisitos obrigatórios
experiência técnica:
firebase (cloud functions, firestore, security rules)
node.js + TypeScript
Integração Mercado Pago (webhooks)
React/TypeScript (ajustes básicos)
Entregáveis:
Código funcional com deploy
Arquivo de Security Rules do Firestore
README com documentação básica dos endpoints
O que enviar na proposta
valor total fixo (preferencial) ou valor/hora + estimativa
prazo realista em dias úteis
portfólio ou links de projetos com firebase + pagamentos
respostas às 3 perguntas técnicas abaixo (obrigatório)
perguntas técnicas (filtro obrigatório)
1. Você já implementou webhook do Mercado Pago? Explique brevemente por que validar a autenticidade do webhook é importante.
2. No Firestore, como você garantiria que usuário A não acesse dados do usuário B? Mencione sua estratégia.
3. Se uma Cloud Function que processa Pdfs estiver falhando ou demorando, quais seus primeiros passos para diagnosticar?
informações importantes
orçamento: a combinar (escopo fechado)
prazo desejado: 10-15 dias úteis
código existente: react funcionando localmente
nda obrigatório: antes do acesso ao código
escopo fixo: sem mudanças durante desenvolvimento
foco exclusivo: backend + segurança + pagamentos
diferenciais
experiência com apis de ia (gemini, openai, etc.)
Conhecimento de boas práticas serverless
Boa comunicação e disponibilidade para alinhamentos
SOBRE O PROJETO
Consultoria de TI com relacionamento de longo prazo com o cliente. Valorizamos profissionais comprometidos que entreguem código limpo e documentado.
Projeto objetivo, com escopo bem definido e possibilidade de continuidade em fase 2 caso o trabalho seja de qualidade.
Prazo de Entrega: Não estabelecido