📱 Demanda Controller

Guia Completo do Usuário

Versão 1.0.8 · Maio de 2026

📑 Índice

  1. Introdução e Visão Geral
  2. Primeiro Acesso e Autenticação
  3. Cadastro e Configuração da Empresa
  4. Gerenciamento de Sites
  5. Relatório Diário TSSR
  6. Dashboard e Monitoramento Financeiro
  7. Gestão de Adiantamentos
  8. Exportação e Backup
  9. Resolução de Problemas
  10. Novidades da Versão 1.0.8

1. Introdução e Visão Geral

Bem-vindo ao Demanda Controller, sua ferramenta profissional de gestão operacional e financeira para projetos de telecomunicações. Este aplicativo foi desenvolvido para:

✓ Rastreamento em Tempo Real

Acompanhe o status de cada site operado, com histórico completo e rastreabilidade para auditoria.

✓ Gestão Financeira Precisa

Controle ganhos, perdas e adiantamentos com precisão, gerando relatórios confiáveis.

✓ Sincronização em Nuvem

Todos os dados são sincronizados com Google Drive e Firebase, garantindo backup automático e segurança.

✓ Exportação e Compartilhamento

Gere relatórios em PDF, compartilhe via WhatsApp ou copie dados para análise em planilhas.

Fluxo Principal do Aplicativo:

1. Autenticação → 2. Cadastro de Empresa → 3. Adicionar Sites → 4. Registrar Relatório Diário → 5. Exportar/Compartilhar

2. Primeiro Acesso e Autenticação

O primeiro acesso ao aplicativo requer autenticação segura. Siga os passos abaixo:

1 Abra o Aplicativo

Localize o ícone "Demanda Controller" na tela inicial do seu dispositivo e toque para abrir.

2 Entre com Suas Credenciais

Insira seu e-mail profissional e senha. Se não possuir credenciais, crie sua conta no aplicativo ou solicite ao seu gerente.

3 Autenticação com Google

O aplicativo solicitará acesso ao seu Google Drive para backup automático. Selecione sua conta e autorize o acesso.

4 Opção: Lembrar Credenciais

Em dispositivos pessoais confiáveis, você pode marcar "Lembrar credenciais" para entrar automaticamente na próxima vez.

💡 Dica de Segurança

Ative a autenticação de dois fatores em sua conta para proteção extra. Se você tiver dúvidas sobre segurança, consulte nossa Política de Privacidade.

3. Cadastro e Configuração da Empresa

Após o primeiro acesso, você precisa cadastrar sua empresa ou projeto. Este é um passo essencial para começar a operação.

Como Cadastrar uma Empresa

1 Acesse "Cadastrar Empresa"

Na tela inicial, procure pelo botão ou menu "Cadastrar Empresa" ou "Nova Empresa".

2 Preencha os Dados Básicos

Nome da Empresa: Digite o nome do seu projeto ou razão social. Exemplo: "Projeto Expandix - SP"

3 Defina o Valor por Site

Especifique quanto sua empresa ganha por site concluído. Este valor é fundamental para o cálculo financeiro automático. Exemplo: R$ 250,00

4 Configure Política de Adiantamento

Defina quantos sites você deve cumprir antes de receber um adiantamento. Valores comuns: 10, 20 ou 50 sites.

5 Salve as Alterações

Clique em "Salvar" ou "Confirmar". Seus dados serão sincronizados com a nuvem automaticamente.

✅ Pronto!

Sua empresa foi cadastrada com sucesso. Agora você pode começar a adicionar sites e registrar operações.

Editar Dados da Empresa

Se precisar alterar valores ou políticas, acesse a tela da empresa e toque em "Editar" ou no ícone de lápis. As alterações entram em vigor imediatamente para novos sites, mas não afetam históricos anteriores.

4. Gerenciamento de Sites

Sites são os locais/atividades que você precisa executar. O aplicativo oferece duas formas de adicionar sites: manual ou via importação.

Adicionar Site Manualmente

1 Acesse a Lista de Sites

Após cadastrar a empresa, você verá a opção "Adicionar Site" ou um botão com ícone "+". Toque para começar.

2 Digite o ID do Site

Insira o identificador único do site. Pode ser um código fornecido pelo seu gerente. Exemplo: "SP-2026-001"

3 Defina o Status Inicial

Escolha entre: Pendente (padrão), Concluído ou Não Concluído.

4 Salve

Toque em "Adicionar" ou "Salvar". O site será incluído na lista e contabilizado nos cálculos financeiros.

Importar Sites via Arquivo

Acesse a Opção de Importação

Na tela de sites, procure por "Importar" ou "Carregar Lista". Selecione um arquivo CSV ou Excel com os IDs dos sites. O formato esperado é uma coluna com os IDs, uma por linha.

Atualizar Status de um Site

Status Significado Impacto Financeiro
Concluído Site operado com sucesso Conta como ganho de R$ (valor por site)
Não Concluído Site não pôde ser operado Registra uma perda, pode exigir motivo
Pendente Aguardando execução Não conta como ganho nem perda
💡 Dica Importante

Atualize o status dos sites em tempo real ou no final do dia. Isso garante que o dashboard reflita sua real produtividade e evita divergências financeiras.

5. Relatório Diário TSSR

O relatório diário é o registro oficial de suas operações no campo. Ele deve ser preenchido diariamente para garantir rastreabilidade.

Como Acessar o Relatório Diário

Na tela inicial, procure pela aba ou botão "Relatório Diário" ou "Daily Report".

Campos Obrigatórios

Campo Descrição Exemplo
Operadora Nome da operadora (cliente) Vivo, Claro, TIM, Oi
Projeto Identificação do projeto Expandix 2026, Upgrade RF
Fabricante Fabricante da tecnologia/equipamento Nokia, Ericsson, Samsung
Região Região geográfica operada Sudeste, Nordeste, Sul

Registrando Resultados por Site

1 Selecione "Adicionar Resultado"

Dentro do relatório diário, toque em "Novo Resultado" ou "Adicionar Site".

2 Escolha o Site

Selecione o ID do site na lista de sites cadastrados da sua empresa.

3 Registre o Resultado

Marque como "Feito" se o site foi concluído com sucesso, ou "Problema" se houve impedimento.

4 Se "Problema", Registre o Motivo

Exemplos: "Cliente não disponível", "Equipamento com defeito", "Acesso negado".

5 Salve o Relatório

Toque em "Salvar Relatório". A data e hora são registradas automaticamente.

✅ Relatório Salvo!

Seus dados estão sincronizados com a nuvem. Você pode revisar qualquer relatório passado a qualquer momento.

📌 Regra Importante

Quando você marca um site como "Concluído" no relatório diário, isso também pode impactar automaticamente a conclusão da empresa se a política de adiantamento for atingida. Sempre verifique o dashboard após salvar.

6. Dashboard e Monitoramento Financeiro

O Dashboard oferece uma visão consolidada de sua performance financeira e operacional.

Indicadores Principais

📊 Ganho Total

Soma de todos os sites concluídos multiplicado pelo valor por site. Atualizado em tempo real.

❌ Perdido Total

Quantia associada a sites que não foram concluídos. Afeta seu saldo final.

💰 Saldo a Receber

Ganho total menos perdido total. Este é o valor que você deve receber da empresa.

📈 Taxa de Conclusão

Percentual de sites concluídos vs. total de sites operados. Indica sua eficiência.

Leitura dos Indicadores

Indicador O que significa Quando aparecer vermelho (preocupante)
Ganho Seu faturamento bruto Nunca fica vermelho; reflete sua produção
Perdido Deduções por sites não completados Acima de 30% do ganho é considerado alto
Saldo Seu valor final a receber Negativo (vermelho) significa você deve dinheiro
💡 Conselho

O Dashboard e Relatório Diário se comunicam: Quando você marca um site como "Concluído" ou "Com Problema" no Relatório Diário, o Dashboard é atualizado automaticamente. Seu saldo não muda sozinho — ele reflete exatamente o que você registrou. Portanto, mantenha os dois sincronizados: após preencher o Relatório Diário, revise o Dashboard para confirmar que os valores estão corretos. Se o saldo não coincide com suas operações, algo foi registrado diferente do esperado.

7. Gestão de Adiantamentos

Adiantamentos são pagamentos parciais que você recebe ao atingir metas operacionais (política de adiantamento).

Como Funciona a Política de Adiantamento

Exemplo de Política: 20 Sites

Se sua política é 20 sites por adiantamento, a cada 20 sites concluídos, você receberá um adiantamento de R$ 5.000,00 (20 × R$ 250).

Registrando um Adiantamento Recebido

1 Acesse "Adiantamentos" ou "Financeiro"

Na tela principal, procure pela aba de gestão financeira.

2 Clique em "Registrar Adiantamento"

Preencha o valor recebido e a data do recebimento.

3 Salve

O adiantamento é descontado automaticamente do seu saldo a receber.

✅ Adiantamento Registrado

Seu saldo será ajustado para refletir o pagamento recebido.

Rastreando Pagamentos

Todos os adiantamentos, parcelas e pagamentos são listados cronologicamente. Você pode visualizar histórico completo a qualquer momento, importante para auditoria e conferência de valores.

8. Exportação e Backup

O Demanda Controller oferece múltiplas formas de exportar seus dados, garantindo que você sempre tenha cópias de segurança.

Opções de Exportação Disponíveis

📄 PDF

Gere um relatório em PDF pronto para impressão ou envio formal para auditores.

📋 Copiar para Clipboard

Copie os dados formatados para colar em planilhas (Excel, Sheets).

💬 Compartilhar via WhatsApp

Envie um resumo formatado diretamente para contatos via WhatsApp.

☁️ Backup Automático

Todos os dados são automaticamente sincronizados com Google Drive.

Como Gerar um PDF

1 Acesse a Tela "Exportar"

Na menu principal, procure por "Exportar" ou "Relatórios".

2 Escolha "Gerar PDF"

Selecione o intervalo de datas e a empresa/projeto desejado.

3 Personalize (Opcional)

Você pode escolher quais seções incluir (sites, relatórios, financeiro).

4 Baixe o Arquivo

O PDF será gerado e automaticamente salvo em sua pasta de Downloads. Você pode compartilhar, imprimir ou arquivar.

Compartilhar via WhatsApp

Uma forma rápida de enviar um resumo para seu gerente ou cliente:

Toque em "Compartilhar WhatsApp"

Um resumo formatado será copiado. Selecione um contato no WhatsApp e cole a mensagem.

Backup Automático com Google Drive

🔐 Segurança Garantida

O Demanda Controller sincroniza seus dados com Google Drive a cada alteração. Mesmo que seu dispositivo seja perdido, seus dados estarão seguros e você poderá recuperá-los em qualquer outro dispositivo.

💡 Dica

Verifique regularmente se sua sincronização está ativa. Você pode conferir em "Configurações" > "Google Drive" ou "Backup".

9. Resolução de Problemas

❌ Erro: "Não foi possível conectar ao Drive"

Solução:

1. Certifique-se de que a internet está conectada
2. Tente novamente selecionar sua conta Google
3. Se o erro persistir, reinicie o aplicativo
4. Verifique se sua conta Google tem espaço disponível no Drive
5. Se ainda não funcionar, entre em contato com o suporte

❌ Dados não sincronizam automaticamente

Solução:

1. Verifique sua conexão de internet
2. Vá para "Configurações" e toque em "Sincronizar Agora"
3. Verifique se o backup automático está ativado
4. Se a sincronização falhar, tente fazer logout e login novamente

❌ Botões de compartilhamento desabilitados

Explicação:

Os botões de copiar, compartilhar e exportar ficam desabilitados quando não há dados para compartilhar (nenhuma empresa cadastrada ou nenhum relatório registrado). Isso é uma proteção para evitar envios vazios. Adicione dados e tente novamente.

❌ Tela branca ou congelamento

Solução:

1. Feche completamente o aplicativo
2. Aguarde 10 segundos
3. Abra novamente
4. Se o problema persistir, execute "Limpar Cache" em Configurações

❌ Valores incorretos no dashboard

Solução:

1. Verifique se o status de todos os sites foi atualizado corretamente
2. Revise a "Política de Adiantamento" para confirmar o critério
3. Se mudou o "Valor por Site", novos cálculos aplicam-se adiante
4. Toque em "Atualizar" ou puxe para baixo para forçar recálculo

❌ Não conseguo importar sites

Verificações:

1. Certifique-se que o arquivo é CSV ou Excel (.xlsx)
2. Verifique se há apenas uma coluna com IDs (sem cabeçalhos extras)
3. Não há espaços ou caracteres especiais antes/depois do ID
4. O arquivo não está corrompido ou aberto em outro programa

10. Novidades da Versão 1.0.8

🔧 Correções Importantes

  • Resolvido: Erro "não foi possível conectar ao drive" ao selecionar conta de Google
  • Melhorado: Validação de autenticação com Google Drive mais robusta
  • Fixado: Sincronização de dados em segundo plano

📋 Melhorias de Usabilidade

  • Novo: Valor por site agora inicia zerado no cadastro de empresa
  • Ajuste: Campo "sites por lote" não é mais preenchido automaticamente com "1"
  • Inteligência: Botões de compartilhamento/copiar ficam bloqueados quando não há dados
  • Feedback: Mensagem "Sem dados para compartilhar ainda" orientar melhor o usuário

🎨 Melhorias na Interface

  • Visual: Telas vazias mantêm comportamento fixo (sem rolagem desnecessária)
  • UX: Botões de exportação desabilitados aparecem visualmente diferentes para clareza
  • Responsividade: Melhor adaptação para telas menores

📱 Técnico

  • Build: AAB otimizado (51.3 MB)
  • Compatibilidade: Android 7.0+ (API 24+)
  • Performance: Carregamento mais rápido de dados em lote
✨ Recomendação

Atualize para a versão 1.0.8 para aproveitar todas as correções e melhorias. A atualização é gratuita e leva menos de 2 minutos.