Selfie
Selfie
A Selfie é uma das formas de comprovação de entrega do aplicativo do motorista: uma foto do recebedor, tirada pela câmera frontal do aparelho, que fica associada à entrega.
Visão Geral
A Selfie é uma das formas de comprovação de entrega do aplicativo do motorista: uma foto do recebedor, tirada pela câmera frontal do aparelho, que fica associada à entrega. Ela entra no fluxo de finalização de uma entrega junto com as demais evidências possíveis (assinatura digital do recebedor e canhoto físico fotografado), e cada carga define quais dessas evidências são exigidas para aquela entrega específica.
A tela de Selfie é aberta em um destes três momentos do fluxo de finalização de entrega, sempre que a carga permite a coleta de selfie:
- diretamente, ao confirmar a finalização da entrega, quando a carga não exige coleta de dados do recebedor nem assinatura digital;
- depois que o motorista preenche e valida os dados do recebedor (nome e CPF/CNPJ), quando a carga exige esses dados mas não exige assinatura digital;
- depois que a assinatura digital do recebedor é salva, quando a carga exige assinatura.
Depois de salvar a selfie, o aplicativo segue automaticamente para a próxima etapa da comprovação: a captura do canhoto físico (se a carga também exigir esse comprovante) ou, não havendo mais nenhuma evidência pendente, a conclusão da entrega.
Pré-requisitos
- A carga da entrega precisa permitir explicitamente a coleta de selfie; sem essa permissão, a tela de Selfie nunca é aberta e o motorista segue direto para a próxima etapa da comprovação (canhoto físico ou conclusão da entrega).
- Quando a carga também exige assinatura digital do recebedor, a selfie só é oferecida depois que a assinatura for concluída — a Selfie nunca antecede a assinatura.
- Quando a carga exige apenas a coleta de dados do recebedor (sem assinatura), a Selfie só é oferecida depois que o motorista preencher e validar o nome e o CPF/CNPJ do recebedor.
- A câmera frontal do aparelho precisa estar disponível e com permissão concedida pelo motorista; se a permissão for negada ou a câmera falhar, a captura não é concluída e o aplicativo informa o erro (ver Troubleshooting).
Fluxo Operacional
- O aplicativo abre a tela de Selfie já na orientação retrato, com a orientação da tela travada para essa entrega.
- Se já existir uma selfie salva anteriormente para aquela entrega, ela aparece imediatamente na tela, sem exigir nova captura.
- O motorista toca no botão de captura e o aplicativo abre a câmera frontal do aparelho.
- Após a captura, a foto aparece na tela; o motorista pode descartá-la e capturar outra, ou confirmar o salvamento.
- Ao confirmar, a foto é gravada no aparelho; enquanto a gravação acontece, os botões ficam temporariamente desabilitados.
- Concluída a gravação com sucesso, o aplicativo avança automaticamente: para a captura do canhoto físico (se exigido pela carga) ou para a conclusão da entrega (se não houver mais evidência pendente).
Interface e Comportamentos
Tela de Coleta de Selfie
Antes de qualquer captura, a tela mostra um espaço vazio com um ícone de câmera e o texto de instrução para o motorista tocar no botão abaixo para coletar a imagem do recebedor, além de um único botão de captura.
Depois que uma foto é capturada (ou quando a tela é aberta já com uma selfie salva anteriormente), o espaço vazio é substituído pela imagem, e o botão único de captura dá lugar a dois botões lado a lado: um para descartar a foto e capturar outra, e outro para confirmar o salvamento.
Durante o salvamento, o botão de confirmar fica desabilitado (assim como o de descartar) e passa a mostrar um indicador de carregamento em seu lugar.
Câmera de Captura da Selfie
A captura usa sempre a câmera frontal do aparelho (voltada para quem segura o celular), nunca a câmera traseira. A imagem capturada é comprimida a 85% de qualidade e redimensionada para no máximo 1024 por 1024 pixels antes de ficar disponível para o motorista revisar.
Feedbacks ao Usuário
| Situação | Feedback | Texto exato |
|---|---|---|
| Falha ao capturar a foto (erro do dispositivo/câmera) | Aviso na tela | “Erro ao tirar a foto: ” + detalhe técnico do erro |
| Tentativa de salvar sem nenhuma foto capturada | Aviso na tela | “Nenhuma imagem selecionada.” |
| Falha ao gravar a selfie no armazenamento do aparelho | Aviso na tela | “Erro ao persistir Imagem.” |
| Exceção inesperada ao gravar a selfie | Aviso na tela | “Erro ao persistir Imagem. ” + detalhe técnico do erro |
Regras de Negócio
Ordem de prioridade das evidências na finalização da entrega. Ao confirmar a finalização de uma entrega, o aplicativo segue esta ordem: primeiro verifica se a carga exige coleta de dados do recebedor (e, dentro desse caminho, se também exige assinatura digital); se não exigir dados nem assinatura, verifica se a carga permite coleta de selfie; se não permitir selfie, verifica se permite comprovante físico (canhoto); se nenhuma dessas evidências for exigida, a entrega é concluída imediatamente. A Selfie, portanto, só é oferecida quando as evidências de prioridade mais alta (dados do recebedor e assinatura) já foram atendidas ou não são exigidas para aquela carga.
Reaproveitamento de selfie já capturada. Se o motorista já tiver salvo uma selfie para aquela entrega anteriormente (por exemplo, ao revisitar a tela depois de voltar da captura do canhoto físico), a tela de Selfie abre mostrando essa imagem já salva, sem obrigar nova captura. O motorista pode simplesmente confirmar de novo ou substituir por uma nova foto.
Qualidade e enquadramento da captura. A selfie é sempre capturada com a câmera frontal do aparelho, com qualidade de imagem de 85% e redimensionamento máximo de 1024×1024 pixels — esses valores são fixos e iguais para todas as entregas.
Gravação como evidência única por entrega. A selfie é armazenada localmente associada à entrega: identificador da entrega, caminho do arquivo da imagem, placa do veículo e data/hora de criação. Uma nova selfie salva para a mesma entrega substitui a selfie salva anteriormente — não existe histórico de múltiplas selfies por entrega.
Encadeamento após salvar a selfie. Ao salvar a selfie com sucesso, se a carga também permitir a coleta de comprovante físico (canhoto), o aplicativo avança automaticamente para a tela de captura do canhoto físico, levando junto o comprovante físico já salvo anteriormente para aquela entrega, se existir. Se a carga não permitir comprovante físico, o aplicativo retorna à lista de cargas e conclui a entrega automaticamente, sem exigir nenhuma ação adicional do motorista.
Comportamento Offline e Dados Locais
A captura e o salvamento da selfie funcionam inteiramente sem conexão: a foto é sempre gravada primeiro no aparelho, mesmo sem internet no momento. O envio ao servidor não acontece na hora — ele é feito automaticamente mais tarde, junto com a próxima sincronização de evidências da entrega, assim que houver conexão disponível.
Evidências e Documentos Gerados
Selfie do recebedor. A foto do recebedor é gerada pelo próprio aplicativo, usando a câmera frontal do aparelho, no momento da finalização da entrega. Uma nova captura confirmada pelo motorista substitui a selfie salva anteriormente para aquela entrega — não fica guardada mais de uma selfie por entrega. A selfie é enviada ao servidor junto com as demais evidências da entrega (foto avulsa, canhoto físico, nota fiscal) na próxima sincronização automática com conexão disponível; ela não é enviada assim que é capturada, mesmo que o aparelho esteja conectado naquele momento.
Troubleshooting
Selfie some ou aparece o texto “Erro ao tirar a foto” ao tentar capturar
Cenário: o motorista tocou no botão para coletar a imagem, mas a câmera do aparelho falhou (por exemplo, permissão de câmera negada, ou outra falha do dispositivo).
Mensagem exibida: “Erro ao tirar a foto: ” seguido do detalhe técnico do erro.
O que fazer: verificar se o aplicativo tem permissão de câmera concedida nas configurações do aparelho e tentar novamente.
Botão “Salvar” não avança e aparece “Nenhuma imagem selecionada”
Cenário: o motorista tentou salvar sem antes capturar (ou depois de descartar) a foto.
Mensagem exibida: “Nenhuma imagem selecionada.”
O que fazer: capturar a selfie antes de tocar em “Salvar”.
Selfie capturada, mas o app mostra “Erro ao persistir Imagem” ao salvar
Cenário: a foto foi capturada normalmente, mas a gravação no armazenamento do aparelho falhou.
Mensagem exibida: “Erro ao persistir Imagem.” (ou, em caso de erro inesperado, “Erro ao persistir Imagem. ” seguido do detalhe técnico do erro)
O que fazer: tentar salvar novamente; se o erro persistir, verificar o espaço de armazenamento livre no aparelho e reiniciar o aplicativo.
Casos de Uso
Caso 1 — Entrega sem exigência de dados nem assinatura, apenas selfie
O motorista confirma a finalização de uma entrega cuja carga não exige coleta de dados do recebedor nem assinatura digital, apenas selfie. A tela de Selfie abre diretamente; o motorista captura a foto do recebedor, confirma o salvamento e o aplicativo conclui a entrega automaticamente, sem etapas adicionais.
Caso 2 — Entrega com coleta de dados do recebedor seguida de selfie
A carga exige que o motorista colete o nome e o CPF/CNPJ do recebedor, mas não exige assinatura digital. Depois de validar os dados no formulário, o aplicativo abre a tela de Selfie; o motorista captura e salva a foto, e a entrega é concluída em seguida.
Caso 3 — Entrega com assinatura digital seguida de selfie e canhoto físico
A carga exige assinatura digital do recebedor, selfie e comprovante físico. Depois que a assinatura é salva, o aplicativo abre a Selfie; o motorista captura e salva a foto, e o aplicativo avança automaticamente para a captura do canhoto físico, encerrando a comprovação da entrega naquela etapa.
Caso 4 — Motorista revisita a tela de Selfie com foto já salva
Depois de salvar a selfie e avançar para a captura do canhoto físico, o motorista precisa voltar à tela de Selfie (por exemplo, para corrigir o comprovante físico antes de prosseguir). A tela de Selfie abre já mostrando a foto salva anteriormente, sem exigir nova captura, e o motorista pode apenas confirmar novamente ou substituir a imagem.