> For the complete documentation index, see [llms.txt](https://docs.griaule.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.griaule.com/aplicacoes/babyid.md).

# BabyID

### Visão Geral

O BabyID é a solução da Griaule para emissão da CIN a partir da maternidade ou do cartório, da captura biométrica do recém-nascido até a impressão do documento.

Este manual descreve o aplicativo de captura, a primeira etapa dessa cadeia. O aplicativo roda no navegador e é instalado no celular a partir do próprio Google Chrome, sem loja de aplicativos. Depois de instalado, se atualiza sozinho e continua funcionando sem conexão.

**O BabyID não tem campos para digitar nome, data de nascimento ou CPF.** Esses dados vêm das imagens dos documentos fotografados e são resolvidos adiante na cadeia, no SMART.

O aplicativo organiza o trabalho em três etapas, na ordem em que aparecem na tela. Ao tocar em **Enviar**, na última etapa, o cadastro é **gravado no aparelho** e a tela volta para o início, liberando o operador imediatamente. O envio ao servidor acontece sozinho, em segundo plano, assim que houver conexão, sem tela própria e sem exigir nenhuma ação do operador. Veja *O que acontece ao enviar* para os detalhes.

***

### Antes de começar

#### Instale o LiveCapture Connector

O LiveCapture Connector é um aplicativo que dá ao BabyID acesso aos recursos de câmera necessários para a captura biométrica.

O próprio BabyID disponibiliza um botão de instalação sempre que necessário, como na primeira configuração do aparelho.

Após instalá-lo, abra o aplicativo e conceda as permissões pedidas. Quando ele estiver rodando, uma notificação aparecerá na barra de notificações do dispositivo indicando que ele está rodando e pronto para realizar capturas.

Para realizar um cadastro, é necessário:

* **Documento do bebê**: a **Certidão de Nascimento** ou a **DNV**. Um dos dois basta.
* **Documento de pelo menos uma filiação**: com **frente e verso**, porque o aplicativo pede as duas faces. É possível registrar até quatro (mãe, pai, representante legal e outro).
* **Presença física dessa filiação**: o aplicativo tira uma **foto do rosto** na hora, pela câmera do aparelho. Não é permitido importar fotos.
* **O bebê presente**: a face e as digitais são capturadas ao vivo, também pela câmera do aparelho.
* **Qual é o posto de retirada** da CIN. A lista de postos é carregada do servidor automaticamente. Para que ela apareça é preciso ter entrado no aplicativo com internet **pelo menos uma vez**. Depois disso, ela fica salva no aparelho e funciona mesmo offline.
* **Conta de acesso ao sistema.** A entrada no aplicativo é feita pelo provedor de identidade da instituição (autenticação única corporativa). É necessário estar **online** para fazer login pela primeira vez. Depois de logado, a captura pode continuar mesmo se a conexão cair.
* **Bateria e espaço no celular.** O processo tem várias fotos.

{% hint style="info" %}
**O que fica salvo automaticamente:** cada captura confirmada (uma digital, uma foto de rosto, um documento) é gravada no aparelho assim que é confirmada. Não é preciso terminar o cadastro inteiro para não perder o que já foi feito. Fechar o aplicativo, perder a conexão ou recarregar a página **não apaga** o que já foi capturado e confirmado. Ao reabrir, o cadastro continua de onde parou. Só o botão **"Descartar cadastro"** (✕) ou o **logout** apagam um cadastro em andamento, conforme *Interromper um cadastro*.
{% endhint %}

***

### Entrar no app

O BabyID não tem uma tela própria de login. Ao abrir o aplicativo sem uma sessão ativa, ele **redireciona automaticamente** para a página de autenticação da instituição.

* Sem conexão neste momento, o aplicativo mostra a mensagem "Sem conexão. É preciso estar online para entrar. As capturas salvas neste aparelho estão guardadas e serão enviadas depois." e aguarda a rede voltar para tentar de novo sozinho.
* Com conexão, é exibida a tela de login da organização.
* Após a autenticação, o aplicativo retorna à etapa 1 do cadastro, ou ao ponto onde um cadastro estava em andamento.

Depois do login, a sessão permanece válida no aparelho mesmo offline por um tempo, e a captura continua normalmente. Se a sessão expirar sem conexão, isso **não bloqueia a captura**, apenas o envio ao servidor, que é feito depois em segundo plano. Se for necessário novo login para esse envio, o aplicativo pede automaticamente quando a conexão voltar, sem perder o que já foi capturado. A exceção é uma captura que estava aberta e não confirmada no exato momento da expiração, que precisa ser refeita.

{% hint style="success" %}
**Use sempre a sua própria conta.** Os cadastros ficam registrados em nome de quem está logado no aparelho.
{% endhint %}

#### **Se aparecer "Sem permissão para cadastrar"**

O acesso ao BabyID depende de uma permissão específica para registrar cadastros. Uma conta pode estar autenticada corretamente e ainda assim não ter essa permissão. Nesse caso, no lugar do fluxo normal de captura aparece a mensagem **"Sem permissão para cadastrar"**.

Peça a liberação ao administrador do sistema da sua instituição. Assim que a permissão for concedida, o fluxo de captura aparece sozinho, sem precisar sair e entrar de novo.

***

### Elementos da interface

O cabeçalho azul fica sempre no alto e mostra apenas:

* **"BabyID" e a versão do aplicativo**, à esquerda.
* **Um círculo com um ícone de pessoa**, à direita. Toque para abrir o menu da conta.

Logo abaixo do cabeçalho, nas três etapas do cadastro, fica a barra de progresso com três traços e o texto "Etapa X de 3 - Nome da etapa". O traço azul é a etapa atual, os verdes já foram concluídos, os cinzas ainda não chegaram.

Acima dessa barra, fora do cabeçalho azul, pode aparecer uma linha com até dois botões:

* **"‹" (Voltar)**: volta para a etapa anterior. Aparece a partir da etapa 2.
* **Botão vermelho "✕" (Descartar cadastro)**: aparece **em qualquer etapa**, assim que houver algo capturado no cadastro atual, mesmo só o posto de retirada escolhido. Em um cadastro totalmente em branco, esse botão não aparece.

**O menu da conta**

Toque no círculo do cabeçalho. Abre uma tela cheia, não um menu suspenso, com:

* Um avatar com as iniciais do operador, ou um ícone genérico se o nome não estiver disponível, e o nome.
* O botão **"Sair da conta"**.

O envio ao servidor é automático e não tem tela própria.

{% hint style="warning" %}
**Sair da conta descarta o cadastro em andamento.** Ao tocar em "Sair da conta" com uma captura não finalizada na tela, os dados capturados até ali são apagados do aparelho. Cadastros já **enviados ou na fila de envio** não são afetados, apenas o que ainda está sendo preenchido na tela.
{% endhint %}

***

### O cadastro passo a passo

#### **Etapa 1 de 3 · Documentos**

Nesta etapa são informados o posto de retirada da CIN, o documento do bebê e a assinatura do responsável.

**Escolher o posto de retirada**

* Toque no campo "Selecione o posto de retirada".
* Digite parte do nome para filtrar a lista. Abrir o campo sem digitar nada mostra a lista completa.
* Toque no posto desejado. Ele some da lista com um "✓" ao lado quando já está selecionado.
* Para trocar, toque no "✕" cinza que aparece dentro do campo e escolha de novo.

Se não houver opções para o texto digitado, aparece "Nenhuma opção disponível".

**Fotografar o documento do bebê**

* Em "CAPTURA", toque em "Capturar documento".
* Abre a câmera do aparelho com um guia de enquadramento na tela. É a mesma tela cheia de captura, "Live Capture", usada nas demais fotos do aplicativo. A captura é feita pelo botão de dois círculos concêntricos, no canto inferior direito. Ele é o mesmo em todas as telas de captura, assim como a seta circular usada para refazer uma captura.
* Alinhe o documento dentro do guia. A imagem é recortada exatamente pelo guia, não pelas bordas reais do documento, então um documento torto ou fora do guia sai cortado errado.
* Confirme a foto. O bloco do documento vira verde, mostra uma **miniatura da foto tirada** e o texto muda para "Documento capturado - toque para capturar novamente".
* Logo abaixo, em "Selecione o tipo do documento capturado", toque em **"Certidão de nascimento"** ou em **"DNV"**. Nenhum dos dois vem pré-marcado.

**Colher a assinatura**

* Toque no bloco **"Assinatura do responsável"**.
* Abre a tela de captura com o aviso "Vire o celular na horizontal". Gire o aparelho.
* Assine com o dedo na área de desenho.
* Toque em **"Limpar"** para apagar e assinar de novo, ou confirme para seguir adiante.
* Depois de confirmada, o bloco mostra "Assinatura capturada - toque para refazer".

**A etapa se dá como completa** quando o posto de retirada, o documento do bebê e o tipo do documento estiverem informados. Só então o botão **"Próximo"**, no rodapé, é habilitado. A assinatura **não** é exigida para avançar. Enquanto faltar algo, o botão fica desabilitado sem aviso visível na tela. O motivo é anunciado apenas para leitores de tela.

***

#### Etapa 2 de 3 · Filiações

Nesta etapa são capturados o rosto e o documento de cada filiação. A tela mostra quatro cartões: "Mãe", "Pai", "Representante legal" e "Outro".

Cada cartão tem um contador que começa em "0/2". Os dois itens são:

* a **face** da pessoa;
* o **documento**, que só conta quando frente **e** verso estiverem capturados. É um único item, não dois.

**Para cada filiação presente:**

1. Toque em "Realizar capturas" no cartão da pessoa.
2. Abre a captura de face ("Captura facial"). Enquadre o rosto e capture.
3. Confirme. A sequência avança sozinha para "Documento - frente (1 de 2)".
4. Fotografe a frente do documento e confirme. A sequência avança para "Documento - verso (2 de 2)".
5. Fotografe o verso e confirme.

**O cartão se dá como completo** quando o contador vira "2/2", o cartão fica verde e o botão muda de "Realizar capturas" para "Capturas realizadas".

Preencha apenas os cartões das filiações presentes no caso e deixe os demais em "0/2".

{% hint style="warning" %}
**A sequência não pode ser interrompida.** Ao fechar a captura no "✕" no meio do caminho, perde-se o que ainda não foi confirmado naquela sequência e é preciso recomeçar o cartão.
{% endhint %}

**A etapa se dá como completa** quando ao menos uma filiação estiver com o cartão em 2/2. Não é preciso completar mais de uma.

***

#### Etapa 3 de 3 · Cadastro do bebê

Nesta etapa são capturadas as biometrias do recém-nascido.

**Bebê gêmeo**

Marque a caixa "Bebê gêmeo" se for o caso. A marcação é apenas uma declaração registrada junto com o cadastro, selecionada ou não, e não altera o restante do fluxo de captura.

**Biometria facial**

1. Em "Biometrias", toque em "Biometria Facial".
2. Abre a câmera com um guia oval na tela e uma barra de qualidade.
3. Enquadre o rosto do bebê dentro do guia e aguarde a qualidade subir.
4. A captura acontece **automaticamente** assim que a qualidade fica boa e se mantém estável por um instante. Não é preciso tocar em nenhum botão, basta manter o rosto do bebê enquadrado e parado. Ainda assim, o botão de captura continua visível na tela e pode ser usado para capturar antes do disparo automático.
5. Confira a foto capturada. Se não ficou boa, toque para refazer.

**O processo se dá como completo** quando o bloco fica verde e o texto muda para "Capturado via câmera - toque para refazer".

**Biometrias digitais**

1. Toque em "Biometrias Digitais".
2. Abre a tela de captura sequencial, com o mapa das duas mãos no alto. A sequência começa pela **mão direita**, do polegar ao mínimo, depois passa para a mão esquerda na mesma ordem.
3. Posicione o dedo pedido na câmera e aguarde o aplicativo ajustar o foco.
4. Capture o dedo. Se a qualidade não ficar boa, é possível capturar o mesmo dedo mais de uma vez, e até três tentativas são guardadas por dedo. Use o botão de **seta circular (Recapturar)** para refazer o dedo atual, ou toque diretamente no ícone daquele dedo no mapa das mãos para voltar a ele.
5. Se um dedo não puder ser capturado, por exemplo por uma bandagem, toque na **seta para a direita (Pular)**. É pedido um motivo (amputado, enfaixado, danificado, impressão impossível de obter, ou outro) antes de a sequência avançar.
6. Toque em **"Próximo"** para seguir ao dedo seguinte.
7. Repita para todos os dedos possíveis.
8. Assim que **pelo menos um dedo** tiver sido capturado, aparece no rodapé o botão **"Finalizar captura"**. Toque nele a qualquer momento para encerrar a sequência. Não é preciso completar os dez dedos.

**As cores no mapa das mãos:**

* **Verde**: dedo capturado.
* **Laranja**: dedo pulado, **ou** dedo com suspeita de duplicidade, ou seja, o mesmo dedo capturado duas vezes na sequência. Nesse segundo caso, mantenha o toque sobre o ícone para ver de qual outro dedo ele parece ser cópia e considere recapturar.
* **Cinza**: ainda não capturado.
* **Borda azul**: dedo da vez.

Ao sair da tela de digitais e voltar depois, os dedos já capturados continuam lá: a sequência não recomeça do zero.

> **"Finalizar captura" só aparece depois de pelo menos uma digital capturada.** Dedos pulados sozinhos, sem nenhuma digital de verdade, não liberam o encerramento da sequência.

**A etapa se dá como completa** quando os blocos "Biometria Facial" e "Biometrias Digitais" estiverem preenchidos.

**O cadastro pode ser enviado** quando a **face do bebê** e **pelo menos uma digital de verdade**, não pulada, estiverem capturadas. Só então o botão **"Enviar"**, no rodapé, é habilitado. Enquanto faltar algo, o botão fica desabilitado sem aviso visível na tela.

***

### Boas capturas

Uma captura ruim significa refazer o cadastro depois. Vale gastar dez segundos a mais.

**Para todas as capturas**

* Procure luz boa e uniforme. Evite contraluz.
* Não use flash direto sobre documento plastificado nem sobre o rosto do bebê.
* Segure o celular com as duas mãos e espere a imagem parar de tremer.
* Limpe a lente da câmera antes de começar.

**Documento**

* Apoie o documento em uma superfície plana, sem dobras.
* Alinhe o documento dentro do guia da tela. A foto é recortada exatamente pelo guia, então um documento torto ou parcialmente fora dele sai cortado errado, mesmo que a imagem original esteja correta.
* Fotografe de cima, com o celular paralelo ao papel.
* Confira se é possível ler os nomes e números antes de confirmar.

**Face (filiações e bebê)**

* A tela mostra a qualidade em três níveis: **"Insuficiente"** (vermelho), **"Adequado"** (amarelo) e **"Excelente"** (verde), com uma mensagem de orientação abaixo.
* Em "Insuficiente" a captura não é liberada. Melhore a luz e centralize o rosto.
* No bebê, a captura tende a disparar sozinha assim que a qualidade chega em "Excelente". Espere um momento de calma, sem forçar a posição.
* Rosto inteiro dentro da guia, olhando para a câmera, sem boné, óculos escuros ou mão na frente.

**Digitais**

* O dedo do bebê precisa estar limpo e seco.
* Estique o dedinho com cuidado e mantenha-o parado durante a captura.
* Se o dedo escorregar ou a captura sair ruim, use a seta circular (Recapturar) antes de avançar para o próximo dedo.

***

### O que acontece ao enviar

**Ao tocar em "Enviar"**

Na etapa 3, tocar em **"Enviar"** mostra a tela **"Registrando o processo para envio..."**. O cadastro é gravado no aparelho nesse momento.

{% hint style="danger" %}
**Não feche o aplicativo durante essa mensagem.** É rápido, mas espere a tela seguinte aparecer.
{% endhint %}

Ao terminar, aparece a tela **"Concluído!"**, com a mensagem "O cadastro foi processado e salvo com sucesso no dispositivo." e o botão:

* **"Iniciar novo processo"**: limpa a tela e volta para a etapa 1, pronto para o próximo bebê.

Não há botão de voltar nessa tela.

**O envio de verdade acontece sozinho, em segundo plano**

Assim que o aparelho tiver conexão, os cadastros pendentes são enviados ao servidor automaticamente, sem nenhuma ação do operador. Não há tela de fila nem botão de reenviar. O resultado é indicado por um aviso no canto superior direito da tela:

| Mensagem                                                             | Quando aparece                                                                                        |
| -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| "Processos pendentes enviados."                                      | Pelo menos um cadastro da fila foi enviado com sucesso.                                               |
| "Falha ao sincronizar um processo; tentaremos novamente mais tarde." | Um cadastro específico falhou ao enviar: ele continua na fila e será tentado de novo automaticamente. |
| "Falha na sincronização."                                            | O processo de envio, como um todo, não conseguiu nem ler a fila local. Situação rara.                 |

Se a sessão tiver expirado no momento do envio, o aplicativo pede o login novamente, sem apagar a fila, e retoma o envio sozinho em seguida.

***

### Interromper um cadastro

O botão vermelho **"✕" (Descartar cadastro)** aparece em **qualquer etapa** do cadastro, desde que já exista algo preenchido: o posto escolhido, uma foto, uma digital, a marcação de gêmeo. Em um cadastro totalmente em branco, o botão não aparece.

1. Toque no "✕" vermelho.
2. Aparece a caixa "Abandonar processo", com o aviso "Tem certeza que deseja abandonar o processo? Todos os dados serão perdidos".
3. Para **apagar tudo**, toque no botão claro **"Sim"**, no topo da caixa.
4. Para **continuar o cadastro**, toque no botão vermelho **"Cancelar"**, logo abaixo.

Ao confirmar o descarte, aparece "Processo descartado." e o aplicativo retorna à etapa 1 com tudo em branco.

**O que é perdido:** o posto de retirada, o documento do bebê e seu tipo, a assinatura, todas as faces e documentos das filiações, a marcação de gêmeo, a face e todas as digitais do bebê.

Cadastros que **já foram enviados** para a fila local **não são afetados** pelo descarte. Este botão só existe durante a captura, antes do envio.

**Outras formas de interromper:**

* **Sair da conta** também descarta um cadastro em andamento, mas não um já enviado. Ver *O menu da conta*.
* Fechar o aplicativo ou perder a conexão **não** apaga nada que já tenha sido confirmado. Só uma captura aberta e ainda não confirmada no exato momento é que se perde.

***

### Perguntas frequentes

**Por que não há campo para o nome, a data de nascimento ou o CPF do bebê?** Porque o BabyID faz a captura biométrica e documental. Os dados civis vêm das imagens dos documentos fotografados e são resolvidos adiante na cadeia, no SMART.

**Preciso da Certidão de Nascimento e da DNV?** Não. Um dos dois basta. Fotografe o documento disponível e depois toque no botão correspondente para indicar qual é.

**Errei o tipo de documento depois de fotografar. Preciso fotografar de novo?** Não. Basta tocar na outra opção, "Certidão de nascimento" ou "DNV". A troca só corrige o rótulo, sem exigir nova foto.

**E se só a mãe estiver presente?** Preencha o cartão "Mãe" e deixe os outros em "0/2". O aplicativo libera o avanço com uma única filiação completa.

**A captura da face não dispara. O que faço?** Ela fica bloqueada enquanto a qualidade estiver em "Insuficiente". Melhore a iluminação e centralize o rosto. A captura tende a disparar sozinha assim que a qualidade chega em "Excelente".

**Preciso capturar os dez dedos?** Não. Basta pelo menos um dedo de verdade, não pulado, para poder enviar o cadastro. Capture quantos conseguir e toque em "Finalizar captura".

**Capturei um dedo errado ou com qualidade ruim. Como corrijo?** Toque no ícone daquele dedo no mapa da mão para voltar a ele, e depois na seta circular (Recapturar).

**O que significa um dedo aparecer em laranja no mapa?** Pode ser um dedo pulado, ou um dedo que o sistema suspeita ser cópia de outro já capturado. Mantenha o toque sobre o ícone para ver a explicação e considere recapturar se for duplicidade.

**Assinei errado e já confirmei a assinatura. Como refaço?** Dentro da tela de assinatura, use "Limpar" **antes** de confirmar. Depois de sair da tela de captura, toque de novo no bloco "Assinatura do responsável", na etapa 1, para assinar outra vez.

**Não consigo assinar agora. Posso pular?** A assinatura não é exigida para avançar a etapa 1. Para não coletar agora, basta não abrir o bloco "Assinatura do responsável".

**Perdi a conexão no meio do cadastro. Perdi tudo?** Não. Cada captura confirmada já fica salva no aparelho na hora. Termine o cadastro normalmente e toque em "Enviar". Ele é gravado localmente mesmo sem internet e é enviado sozinho ao servidor assim que a conexão voltar, sem necessidade de reenvio manual.

**Como sei se meu cadastro já chegou ao servidor?** Pelos avisos que aparecem no canto superior direito. "Processos pendentes enviados." confirma que algo foi enviado. Não havendo aviso de falha, o aplicativo continua tentando sozinho em segundo plano.

**Posso fechar o app durante a tela "Registrando o processo para envio..."?** Evite. Espere a tela "Concluído!" aparecer.

***

### O que acontece depois

Após o envio, o servidor do BabyID cria o processo no SMART com os documentos e as biometrias. Os dados civis do bebê são preenchidos nessa etapa, por outro operador, já no SMART. Nada disso exige ação no BabyID.

***

### Glossário

**Live Capture**: nome da tela de captura em tela cheia usada para face, documento, assinatura e digitais.

**Filiação**: cada pessoa ligada ao bebê no registro, entre "Mãe", "Pai", "Representante legal" e "Outro".

**DNV**: Declaração de Nascido Vivo, documento emitido pela maternidade, alternativa à Certidão de Nascimento.

**CIN**: Carteira de Identidade Nacional. O "Posto de Retirada" é o local onde ela será retirada, e a lista de postos é sincronizada automaticamente com o servidor.

**SMART**: sistema para o qual o BabyID encaminha automaticamente o processo criado a partir do cadastro.

**"Insuficiente", "Adequado", "Excelente"**: os três níveis de qualidade da captura de face. Em "Insuficiente" a captura fica bloqueada.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.griaule.com/aplicacoes/babyid.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
