Produto por assinatura sob encomenda, feito para conversar com o resto
Ateliê de software em Petrópolis. Construímos o serviço completo — definição, telas, código, planos e pagamento, área do assinante e área interna — e tratamos com o mesmo cuidado a parte que costuma virar remendo: as ligações com outros sistemas e a interface pública que o cliente do seu cliente vai usar.
- Ambiente de teste desde a semana dois
- Aviso automático com nova tentativa
- Interface pública versionada
- 10integrações mantidas em produção
- 4revisões do contrato de interface
- 5semanas até o ambiente de teste
- 9pessoas no time
Sete costumes que evitam o remendo de terça-feira
Integração quebra: a outra ponta muda campo, cai, devolve um erro novo. Estes sete costumes não impedem isso — eles fazem a quebra aparecer cedo, em lugar visível, com caminho de volta. Role de lado para ler.
Contrato antes do código
Quais campos entram, quais saem, o que é obrigatório e qual erro cada caso devolve. Uma página, aprovada pelos dois lados.
Ambiente de teste desde cedo
Chaves separadas, dados falsos e um botão para zerar tudo. Quem integra precisa errar à vontade antes de tocar em produção.
Nova tentativa com espera crescente
Quando a outra ponta não responde, a fila tenta de novo em intervalos maiores e guarda o que ficou pendurado.
Aviso automático que pode ser reenviado
Todo evento importante sai como aviso assinado, com registro do que foi entregue e botão para mandar outra vez.
Versão com data de aposentadoria
Interface muda. Quando muda, a versão antiga continua de pé por um prazo anunciado, e quem usa recebe o aviso antes.
Limite de chamadas explicado
Quantas chamadas por minuto, o que acontece ao passar disso e como o sistema avisa que está perto do teto.
Registro que serve para discutir
Cada chamada guarda pedido, resposta e horário por um prazo combinado. Sem isso, «funcionou aqui» é a única prova de qualquer lado.
Do contrato de interface ao primeiro parceiro integrado
A ordem importa: quem integra precisa de ambiente de teste muito antes de o produto ficar pronto, senão a integração vira a última semana.
Mapa das pontas
Que sistemas conversam com o produto, quem é dono de cada um e o que cada ponta espera receber.
Contrato de interface
Campos, formatos, erros e exemplos, numa página que os dois lados assinam antes de existir código.
Ambiente de teste no ar
Chaves, dados falsos e o botão de zerar, para o parceiro começar a errar cedo.
Núcleo do produto
Contas, permissões e o trabalho que o assinante veio fazer, já conversando com a interface pública.
Fila e nova tentativa
Espera crescente, pendências visíveis e reenvio manual quando for preciso.
Avisos automáticos
Eventos assinados, registro de entrega e página onde o parceiro vê o que recebeu.
Planos e pagamento
Assinatura, limites por plano e o limite de chamadas ligado ao plano contratado.
Primeiro parceiro
Uma integração real conduzida por nós, do teste à produção, com acompanhamento diário.
Três formas de encomendar
Compare o que entra em cada formato antes de escolher.
| Formato | Valor | O que entra | Começar |
|---|---|---|---|
| Contrato e testeTrês semanas | R$ 600 |
| Pedir um encontro |
| Produto encomendadoNove a treze semanas | R$ 2.840 |
| Pedir um encontro |
| Manutenção de pontesMensal | R$ 4.930 |
| Pedir um encontro |
Quem parou de descobrir a quebra pelo cliente
Relatos das últimas encomendas, publicados com autorização de cada um.
O contrato de interface de uma página acabou com três semanas de discussão por e-mail. Os dois lados assinaram e começaram no mesmo dia.
Quando o emissor mudou um campo, o nosso painel mostrou as pendências na mesma manhã. Antes a gente descobria pelo cliente, dias depois.
O ambiente de teste ficou pronto na semana três. Meu time integrou enquanto o produto ainda estava sendo escrito.
Os avisos automáticos podem ser reenviados por botão. Isso tirou o desenvolvedor do meio de toda conferência.
A versão antiga da interface ficou de pé pelo prazo anunciado. Nenhum dos meus parceiros ficou de fora na virada.
O que nos perguntam antes de encomendar
Seis respostas, com o que conseguimos sustentar por escrito no contrato.
Pedir um encontroVocês fazem o produto inteiro ou só a camada de integração?
O produto inteiro: definição, telas, código, planos e pagamento, área do assinante, área interna e acompanhamento depois do lançamento. As integrações e a interface pública são o exemplo que usamos porque é onde mais projetos tropeçam.
E se a outra ponta for antiga e mal documentada?
É o caso mais comum. Começamos capturando chamadas reais para descobrir o comportamento de verdade, escrevemos o contrato a partir disso e isolamos essa ponta atrás de uma camada nossa, para que o resto do produto não dependa dela.
Quanto tempo a versão antiga da interface continua funcionando?
O prazo é combinado em contrato, normalmente entre seis e doze meses, com aviso aos usuários no momento em que a versão nova sai.
Como vocês tratam queda de uma integração?
Fila com nova tentativa em intervalos crescentes, pendências visíveis na área interna, aviso por mensagem para quem estiver de plantão e registro de tudo o que ficou para trás. Instabilidade da outra ponta acontece; o que combinamos é quanto tempo até alguém saber.
A documentação fica com quem?
Com a sua empresa, no mesmo repositório do código. A página pública da interface é gerada a partir dela, para não existirem duas verdades.
Como é o pagamento?
Encomenda em três parcelas — contrato de interface aprovado, ambiente de teste no ar e produto em produção. A manutenção de pontes é mensal, com trinta dias de aviso para encerrar.
Diga quais sistemas o seu produto vai ter de encarar
Com a lista das pontas e um exemplo de cada retorno já conseguimos dizer o que é ponte curta, o que é obra e o que é melhor não integrar agora.
Escreva para o ateliê
Conte com que sistemas o produto precisa conversar e quem cuida de cada um.
Rua Visconde da Penha 72
Petrópolis — RJ
CEP 25625-220
Segunda a sexta, das 8h às 18h
Sábados, das 10h30 às 14h30
Domingos e feriados: fechado
CNPJ 26.310.221/0001-50
