Manual do Usuário — Milling

Este manual explica cada função do app passo a passo. Se for a sua primeira vez, comece pela seção 1.

Prints: Os espaços marcados com 📷 print serão substituídos por capturas de tela reais do app.

Índice

1. Calculadora — Entrada Manual de Pontuação
2. Modo Partida Cronometrado
3. Captura Guiada por Câmera
4. Detecção Automática de Furos
5. Lupa de Refino
6. Trace Mode — Marcação Manual
7. Análise de Perdas
8. Histórico de Sessões
9. Caderno de Treino
10. Exportação PDF e CSV

1. Calculadora {#1-calculadora}

A calculadora é o ponto de partida do app. Você seleciona a modalidade e registra os seus tiros manualmente, série a série.

Como usar:

1. Abra o app — você chega direto na tela da calculadora
2. Toque no seletor de modalidade no topo da tela e escolha a sua modalidade (ex: 25 m Pistola Sport)
3. Toque em Iniciar sessão e selecione Treino
4. Para cada tiro, toque no valor correspondente (0 a 10) ou use o teclado numérico
5. O app contabiliza os pontos da série e passa automaticamente para a próxima quando você completa o número de tiros
6. Ao terminar todas as séries, o placar final aparece no topo

Dica: Se errou um valor, toque no tiro para corrigi-lo antes de finalizar a série.

2. Modo Partida {#2-modo-partida}

O Modo Partida simula as condições de uma competição real: cada série tem um tempo limite, igual ao regulamento ISSF.

Como usar:

1. Na calculadora, selecione a modalidade desejada
2. Toque em Iniciar sessão e selecione Partida
3. O timer começa automaticamente ao iniciar a primeira série
4. Digite cada tiro antes que o tempo acabe — o app aceita o valor e descontado do tempo restante
5. Ao fim da série, o app pausa e mostra o placar parcial; toque em Próxima série para continuar
6. Ao terminar todas as fases, o placar final da partida aparece com o resumo por série

Atenção: O timer começa assim que a série é iniciada. Prepare-se antes de tocar em "Próxima série".

3. Captura Guiada por Câmera {#3-captura-guiada}

A Captura Guiada usa a câmera do celular para fotografar o alvo com qualidade suficiente para a detecção automática de furos. O overlay de alinhamento te ajuda a posicionar o celular corretamente.

Requer: compra ativa ou trial de 7 dias (função premium).

Como usar:

1. Inicie uma sessão (Treino ou Partida) e toque no ícone de câmera quando for registrar a foto do alvo
2. Selecione Captura Guiada
3. Aponte o celular para o alvo — uma moldura aparece na tela
4. Mova o celular até que os cantos da moldura fiquem verdes: isso indica que o alvo está enquadrado, na distância certa e sem tremulação
5. Toque em Capturar quando o botão estiver ativo (não acinzentado)
6. O app processa a foto e passa para a tela de Detecção Automática

Dica: Mantenha o celular paralelo ao alvo. Iluminação uniforme ajuda muito — evite reflexos no papel.

4. Detecção Automática de Furos {#4-deteccao-automatica}

Após a captura, o app analisa a foto e identifica os furos automaticamente. Cada furo detectado recebe uma pontuação com base na zona do alvo.

Como funciona:

1. O app analisa a foto que você acabou de tirar (ou importou da galeria)
2. Em alguns segundos, os furos aparecem marcados sobre a imagem com anéis numerados
3. O placar calculado aparece no topo da tela
4. Se algum furo estiver na posição errada, toque em Refinar Furos para corrigir (ver seção 5)
5. Se tudo estiver certo, toque em Confirmar para salvar a pontuação no histórico

A detecção errou muito? Use o Trace Mode para marcar os furos você mesmo.

5. Lupa de Refino {#5-lupa-de-refino}

A Lupa de Refino permite ajustar a posição de cada furo após a detecção automática. Útil quando um ou dois furos foram detectados ligeiramente fora do lugar.

Como usar:

1. Na tela de resultado da detecção, toque em Refinar Furos
2. A imagem do alvo aparece ampliada com os furos detectados marcados com anéis numerados
3. Toque e segure um furo para selecioná-lo
4. Arraste o furo para a posição correta no alvo
5. Repita para cada furo que precisar de ajuste
6. Toque em Confirmar para salvar a pontuação corrigida

Remover um furo: Deslize o furo horizontalmente para a esquerda ou direita para removê-lo. Ou pressione e segure para abrir o menu com a opção "Remover".

6. Trace Mode — Marcação Manual {#6-trace-mode}

O Trace Mode é para quando a detecção automática não é suficiente, ou quando você tem uma foto do alvo já tirada. Você calibra o alvo na foto e marca os furos manualmente, um a um.

Como usar:

1. Inicie ou abra uma sessão e selecione Trace Mode no fluxo de captura
2. Escolha uma foto do alvo da sua galeria (ou tire uma nova)
3. Calibração: Toque no centro do alvo e depois na borda externa — dois toques definem a escala
4. Após a calibração, toque em cada furo na foto para marcá-lo
5. Um anel numerado aparece sobre cada furo marcado com a pontuação calculada
6. Quando todos os furos estiverem marcados, toque em Confirmar

Erro de calibração? Toque em Recalibrar para refazer os dois toques. Os furos já marcados podem ser mantidos ou apagados.

Remover um furo específico: Pressione e segure o furo para abrir o menu com as opções Mover, Remover e Cancelar.

7. Análise de Perdas {#7-analise-de-perdas}

A Análise de Perdas mostra a diferença entre o seu score real (o que você fez) e o seu score potencial (o que você poderia ter feito se cada tiro tivesse ido para o ponto mais alto da zona em que caiu).

Como acessar:

1. Abra o Histórico e toque em uma sessão
2. Na tela de detalhes da sessão, role até a seção Análise de Perdas
3. O app mostra o score real, o score potencial e a diferença (quantos pontos você "deixou na mesa")

O que fazer com essa informação:

• Se as perdas estão concentradas na zona 8: seus tiros estão agrupando bem, mas o grupo está deslocado — ajuste a mira
• Se as perdas estão espalhadas em várias zonas: trabalhe na consistência antes de ajustar a mira

8. Histórico de Sessões {#8-historico}

O Histórico guarda todas as suas sessões de treino e partida. Você pode filtrar, buscar e ver o detalhamento de cada sessão.

Como usar:

1. Toque em Histórico no menu inferior do app
2. A lista mostra todas as sessões, da mais recente para a mais antiga
3. Use os filtros no topo para ver apenas Treinos, apenas Partidas ou uma modalidade específica
4. Toque em qualquer sessão para ver o detalhamento completo: tiros por série, placar, análise de perdas, foto do alvo

Na tela de detalhes da sessão você encontra:

• Resumo por série com cada tiro registrado
• Mapa de calor (quando há foto do alvo)
• Análise de Perdas
• Caderno de Treino (notas da sessão)
• Botões para exportar em PDF e CSV

9. Caderno de Treino {#9-caderno-de-treino}

O Caderno de Treino é um campo de texto livre vinculado a cada sessão. Use para anotar o que quiser: arma usada, lote de munição, condições do vento, temperatura, ajustes feitos na mira — qualquer coisa que ajude a interpretar os resultados depois.

Como usar:

1. Abra o Histórico e toque na sessão em que quer adicionar notas
2. Role até o card Observações (ícone de lápis ao lado do título)
3. Toque no card — um campo de texto abre
4. Digite suas anotações (até 6 linhas visíveis; o campo aceita qualquer quantidade de texto)
5. Toque em Salvar — as notas ficam salvas automaticamente nessa sessão

Exemplos do que anotar:

• Pistola: Walther PP Sport | Mun: Sellier & Bellot 40gr | Temp: 22°C | Vento leve NE
• Treino focado na série rápida. Apertura mais lenta nos tiros 3 e 4 — revisar pegada
• Mira ajustada 2 cliques p/ direita após série 1. Série 2 melhorou centralização

As notas ficam no seu celular. Não são sincronizadas para nenhum servidor.

10. Exportação PDF e CSV {#10-exportacao}

O Milling permite exportar os dados de qualquer sessão em dois formatos: PDF (relatório visual) e CSV (planilha compatível com Excel e Google Sheets).

Requer: compra ativa ou trial de 7 dias (função premium).

Como exportar:

1. Abra o Histórico e toque na sessão que quer exportar
2. Na barra superior da tela de detalhes, você vê dois ícones:
   • Ícone de tabela (CSV): exporta todos os tiros em planilha
   • Ícone de PDF (PDF): gera o relatório visual da sessão
3. Toque no formato desejado
4. O app gera o arquivo e abre o menu de compartilhamento do Android
5. Escolha onde enviar: WhatsApp, e-mail, Google Drive, salvar localmente, etc.

Sobre o PDF:

• Sessões de Treino: relatório com séries, tiros e placar, com layout padrão
• Sessões de Partida: relatório com layout Partida Oficial, cabeçalho verde e seções por fase

Sobre o CSV:

• Uma linha por tiro, campos separados por vírgula
• Compatível com Excel, Google Sheets e LibreOffice Calc
• Encoding UTF-8 com BOM (acentos funcionam corretamente no Excel do Windows)

Onde o arquivo fica salvo? O arquivo é criado numa pasta temporária e compartilhado diretamente. Para guardar permanentemente, use a opção "Salvar em" no menu de compartilhamento.