# Guinchos Brasil — pré-lançamento Android 0.2.0

Dois aplicativos de testes para Android 8.0 ou posterior. Não publicados na Play Store.

## Instalar

Baixe o APK do Cliente ou do Prestador no Android, abra o arquivo e siga a confirmação de instalação do aparelho. São aplicativos distintos e podem coexistir. Não é necessário inserir cartão, chave Pix, senha de banco ou dados reais.

## Testar o Cliente

1. Toque em Carregar atendimento de teste.
2. Abra Controles de teste e simule a confirmação da outra parte.
3. Escolha Pix, boleto ou cartão e toque em Simular confirmação do pagamento. Não será gerada cobrança.
4. Nos controles, simule o início do trajeto e a entrega no destino.
5. Escolha Confirmar entrega e liberar pagamento ou Abrir contestação. Na contestação, descreva somente um exemplo fictício.
6. Feche e abra o aplicativo: o estado desse teste é guardado localmente.

## Testar o Prestador

1. Veja a tabela única, selecione nota fiscal e altere preços fictícios.
2. Toque em Carregar atendimento de teste e confirme como prestador.
3. Tente iniciar antes de simular o pagamento: o fluxo deve bloquear.
4. Abra Controles de teste e simule o pagamento do cliente.
5. Inicie, conclua e simule a liberação do cliente nos controles.
6. Confira o aviso de proibição de pagamentos por fora e os exemplos de gestão financeira.

## Limites desta entrega

- Aplicativos independentes com dados fictícios. Não trocam chamados, mensagens, liberações ou localização entre aparelhos.
- Não há autenticação real, validação de documentos, notificações push, rastreamento contínuo nem conexão ao Asaas.
- Pagamento, retenção, liberação e contestação são estados simulados. Nenhum dinheiro é cobrado ou transferido.
- A pesquisa de endereço e as imagens do mapa precisam de internet e usam OpenStreetMap/Nominatim. A posição atual pode ser solicitada mediante permissão; isso não inicia rastreamento contínuo.
- Distâncias e preços dos trajetos são demonstrações, não roteamento comercial pelas ruas. Tarifas de pedágios automáticas ainda não integradas.
- Os exemplos financeiros não são o saldo da conta Asaas nem suas taxas vigentes.
- Sem aparelho Android conectado nesta sessão: compilação, lint, assinatura, alinhamento e fluxos em tela web móvel verificados; falta teste de instalação e execução em aparelho real.

## Verificação e fontes

SHA256SUMS.txt contém os hashes dos instaladores. assinaturas.txt contém os certificados públicos. release.json registra os resultados da embalagem.
Fonte: pacote guinchos-brasil-android-fonte-0.2.0.zip. Assinatura de testes exclusiva e preservada localmente; chaves privadas e senhas não integram o pacote de fonte nem o site.

As próximas etapas são servidor e login reais, comunicação entre celulares, GPS em serviço, pagamentos e confirmação por webhook, retenção/liberação compatível com o provedor e análise de contestação pela administração.