GPSi - Auditoria operacional na palma da mão
Aplicativo iOS de checklist e inspeção para as equipes de campo do Grupo GPS, construído do zero a partir de um Android sem código-fonte nem documentação.
Levar a auditoria de campo para o iPhone
O Grupo GPS é uma das maiores operações de facilities do país, com equipes espalhadas por contratos de clientes de grande porte. O GPSi é a ferramenta que essas equipes usam para registrar a realidade do contrato: o encarregado lê um QR Code no ambiente, o aplicativo abre o checklist daquele ponto, e a liderança enxerga a qualidade do serviço sem depender de papel nem de planilha enviada depois.
Existia uma versão Android, em uso, mantida pela equipe interna do cliente. Faltava o iOS, e era ele que a liderança carregava no bolso.
O desafio
A X-Apps recebeu o projeto sem os dois insumos que normalmente sustentam uma porta para outra plataforma.
- Não havia código-fonte da aplicação Android, nem documentação da API que ela consumia. O Android continuou evoluindo durante o desenvolvimento do iOS, com mudanças que apareciam sem aviso. As regras de negócio do checklist viviam na configuração do sistema, divergiam entre áreas e, em alguns pontos, não batiam com o que o Android fazia na prática. * A API do cliente respondia o mesmo campo ora como número, ora como texto, e havia chamadas que não funcionavam nem no Android.
Engenharia reversa como método, não como gambiarra
Sem fonte e sem documentação, a única descrição confiável do sistema era o próprio aplicativo Android rodando. Foi de lá que a especificação saiu.
A equipe instalou o APK num emulador, colocou um proxy entre o aplicativo e o servidor e passou a usar o sistema funcionalidade por funcionalidade, gravando cada chamada. Desse tráfego saíram os endpoints, os formatos de resposta e o modelo de dados. Cada tela do iOS foi construída contra um contrato observado, não suposto.
Foi um método caro e assumido como tal: mapear uma única funcionalidade custava cerca de três horas de observação antes de qualquer linha de código. Em troca, o iOS nasceu com uma documentação de API que não existia antes e que ficou com o cliente.
Quando as regras de checklist se mostraram contraditórias, a saída foi a mesma: uma call técnica com o cliente e um documento consolidando o que valia de verdade, pilar a pilar.
Um formulário que muda de forma
O coração do GPSi é o checklist, e ele nunca é o mesmo. Cada área da operação pergunta coisas diferentes, de jeitos diferentes, e essas diferenças mudam com o tempo.
A escolha foi não programar uma tela por área. O formulário é montado em tempo de execução a partir da configuração que o servidor devolve, e o mesmo componente atende a operação inteira. As diferenças entre áreas viraram configuração, não código.
O formulário aceita os tipos de resposta que uma inspeção de campo exige de verdade:
- texto, número, seleção e múltipla escolha; foto tirada na hora, anexada ao item inspecionado; assinatura do responsável, capturada na própria tela; * registro de não conformidade com tratativa.
Um pedido que chegou durante a execução, apresentar mais de um checklist por QR Code, entrou justamente porque a estrutura dinâmica permitia: a mudança valeu para todas as telas de leitura de uma vez.
A operação inteira, área por área
O aplicativo cobre as frentes que o Grupo GPS audita em campo.
Recursos Organizacionais. Roteiro programado e roteiro realizado, resposta de checklist com envio de foto, consulta ao que já foi enviado e tratativa de não conformidade.
Recursos Humanos. Acompanhamento de benefícios, com solicitações, detalhes e comentários, registro e envio de treinamentos, e não conformidade de benefícios e abandono.
Percepção do Cliente. Checklist de inspeção da qualidade percebida pelo contratante, com envio imediato.
Recursos Tecnológicos. Carga e envio de checklist, abertura e encerramento de chamado.
Segurança e Saúde. Registro imediato de acidente de trabalho com foto, inspeção mensal e envio das inspeções.
Tudo isso funcionando com sincronização e banco local, porque o encarregado nem sempre tem rede boa no ponto em que está inspecionando.
Stack e práticas
- iOS nativo em Swift, com Storyboards e auto layout ajustado para as diferentes telas de iPhone. Alamofire na camada HTTP e RealmSwift como banco de dados local, para a sincronização. Leitura de QR Code implementada sem biblioteca de terceiros, em um componente próprio reaproveitado por todas as telas que precisam escanear. Verificação de atualização de versão dentro do próprio aplicativo. Sprints com apontamento em Jira, versionamento em Bitbucket e daily assíncrona integrada ao canal do projeto. * Builds de teste distribuídas ao cliente durante todo o projeto, e não só no final.
A entrega
O GPSi foi publicado na App Store em setembro de 2018. No dia seguinte subiu uma versão com o tratamento das imagens herdadas do Android, que reduziu o tamanho do pacote à metade, e com o ajuste de tempo limite na sincronização.
Depois da publicação veio o pós-projeto, com correção dos pontos de atenção e acompanhamento diário da aplicação durante a garantia. O código-fonte foi entregue ao Grupo GPS e a titularidade do aplicativo na App Store foi transferida para a conta do próprio cliente, que segue mantendo o GPSi.
Depoimento
"A X-Apps nos atendeu com excelência e agilidade no desenvolvimento de aplicativos para iOS, demonstrando know-how para outras tecnologias e nos permitindo gerar uma parceria para novos projetos."
Milton Foti - Gerente de Sistemas, Grupo GPS
Tem um sistema sem documentação para levar adiante?
Herdar um sistema sem fonte, sem documentação e em uso é mais comum do que parece, e não precisa travar a evolução do produto. A X-Apps monta o time que observa, documenta e reconstrói, com entrega em builds testáveis desde o começo.