First commit - backup RDOC

2026-02-20 07:20:32 -03:00
commit b7415f0586
259 changed files with 51707 additions and 0 deletions
--- a/documentation/Manual_Usuario_RDO.md
+++ b/documentation/Manual_Usuario_RDO.md
@@ -0,0 +1,693 @@
+# Manual do Usuário - App RDO Mobile
+
+## 📋 Índice
+
+1. [Visão Geral do Aplicativo](#visão-geral-do-aplicativo)
+2. [Primeiros Passos](#primeiros-passos)
+3. [Navegação Principal](#navegação-principal)
+4. [Dashboard - Visão Geral](#dashboard---visão-geral)
+5. [Criação de RDO](#criação-de-rdo)
+6. [Gerenciamento de Tarefas](#gerenciamento-de-tarefas)
+7. [Relatórios](#relatórios)
+8. [Cadastros](#cadastros)
+9. [Configurações](#configurações)
+10. [Dicas e Melhores Práticas](#dicas-e-melhores-práticas)
+11. [Solução de Problemas](#solução-de-problemas)
+12. [Glossário](#glossário)
+
+---
+
+## 🏗️ Visão Geral do Aplicativo
+
+### O que é o RDO Mobile?
+
+O **RDO Mobile** é um aplicativo desenvolvido especialmente para profissionais da construção civil que precisam registrar e acompanhar as atividades diárias de suas obras. RDO significa "Relatório Diário de Obra" e é um documento essencial para o controle e gestão de projetos de construção.
+
+### Principais Benefícios
+
+✅ **Substituição do papel**: Elimine planilhas e formulários em papel
+✅ **Acompanhamento em tempo real**: Visualize o progresso das obras instantaneamente
+✅ **Comunicação eficiente**: Melhore a comunicação entre equipe, escritório e clientes
+✅ **Histórico completo**: Mantenha um registro detalhado de todas as atividades
+✅ **Relatórios automáticos**: Gere relatórios profissionais com poucos cliques
+
+### Quem pode usar?
+
+- **Mestres de Obra**: Registram atividades diárias, mão de obra e equipamentos
+- **Engenheiros**: Aprovam RDOs, geram relatórios e supervisionam obras
+- **Gestores**: Acompanham múltiplas obras e indicadores de performance
+- **Clientes**: Visualizam o progresso da obra através de relatórios aprovados
+
+---
+
+## 🚀 Primeiros Passos
+
+### Acessando o Aplicativo
+
+1. **Abra o navegador** em seu dispositivo móvel ou computador
+2. **Digite o endereço** fornecido pela sua empresa
+3. **Faça login** com suas credenciais (usuário e senha)
+4. **Aguarde o carregamento** da tela principal
+
+### Interface Principal
+
+O aplicativo possui uma interface moderna e intuitiva com:
+
+- **Tema claro/escuro**: Adapta-se automaticamente às suas preferências
+- **Design responsivo**: Funciona perfeitamente em celulares, tablets e computadores
+- **Navegação simples**: Menus claros e botões grandes para facilitar o uso
+
+---
+
+## 🧭 Navegação Principal
+
+### Menu Principal
+
+O aplicativo é organizado em 5 seções principais:
+
+1. **🏠 Dashboard**: Visão geral das obras e indicadores
+2. **📝 Criar RDO**: Formulário para registro diário de atividades
+3. **✅ Tarefas**: Gerenciamento de atividades planejadas
+4. **📊 Relatórios**: Visualização e exportação de relatórios
+5. **⚙️ Cadastros**: Gerenciamento de obras, usuários e equipamentos
+
+### Botões e Ícones Importantes
+
+- **🌙/☀️ Alternar tema**: Muda entre modo claro e escuro
+- **➕ Adicionar**: Cria novos itens (obras, RDOs, tarefas)
+- **👁️ Visualizar**: Abre detalhes de um item
+- **✏️ Editar**: Permite modificar informações
+- **🗑️ Excluir**: Remove itens (com confirmação)
+- **⬅️ Voltar**: Retorna à tela anterior
+
+---
+
+## 🏠 Dashboard - Visão Geral
+
+### O que você encontra no Dashboard
+
+O Dashboard é sua tela inicial e oferece uma visão completa de todas as suas obras:
+
+#### Indicadores Principais
+
+- **Obras Ativas**: Número de obras em andamento
+- **RDOs Hoje**: Quantos relatórios foram criados hoje
+- **Pendências**: Itens que precisam de atenção
+- **Progresso Médio**: Percentual médio de conclusão das obras
+
+#### Cards das Obras
+
+Cada obra é apresentada em um card com:
+
+- **Nome da obra** e endereço
+- **Barra de progresso** visual
+- **Status atual** (Ativa, Pausada, Concluída)
+- **Data do último RDO** registrado
+- **Botões de ação** rápida
+
+### Como usar o Dashboard
+
+1. **Visualize os indicadores** na parte superior para ter uma visão geral
+2. **Clique em uma obra** para ver seus detalhes específicos
+3. **Use o botão "Nova Obra"** para cadastrar uma nova obra
+4. **Acesse rapidamente** outras seções através do menu
+
+---
+
+## 📝 Criação de RDO
+
+### O que é um RDO?
+
+O Relatório Diário de Obra (RDO) é um documento que registra todas as atividades realizadas em um dia específico na obra, incluindo:
+
+- Condições climáticas
+- Atividades executadas
+- Mão de obra presente
+- Equipamentos utilizados
+- Ocorrências e problemas
+- Fotos e anexos
+
+### Passo a Passo para Criar um RDO
+
+#### 1. Informações Básicas
+
+- **Data do relatório**: Automaticamente preenchida com a data atual
+- **Condições climáticas**: Selecione entre as opções disponíveis
+  - ☀️ Ensolarado
+  - ⛅ Parcialmente nublado
+  - ☁️ Nublado
+  - 🌦️ Chuvisco
+  - 🌧️ Chuva leve
+  - ⛈️ Chuva forte
+- **Temperatura**: Registre as temperaturas mínima e máxima (opcional)
+- **Observações gerais**: Campo livre para comentários sobre o dia
+
+#### 2. Atividades Executadas
+
+Para cada atividade realizada:
+
+1. **Clique em "Adicionar Atividade"**
+2. **Selecione o tipo** de atividade (ex: Concretagem, Alvenaria, Instalações)
+3. **Descreva a atividade** detalhadamente
+4. **Informe a localização** onde foi executada
+5. **Registre o percentual concluído** (0% a 100%)
+6. **Anote os horários** de início e fim
+
+#### 3. Mão de Obra
+
+Registre todos os funcionários presentes:
+
+1. **Adicione cada funcionário** individualmente
+2. **Informe o nome completo**
+3. **Selecione a função** (Pedreiro, Servente, Eletricista, etc.)
+4. **Registre as horas trabalhadas**
+5. **Marque como presente** ou ausente
+
+#### 4. Equipamentos
+
+Para cada equipamento utilizado:
+
+1. **Selecione o equipamento** da lista
+2. **Registre as horas de operação**
+3. **Anote o combustível consumido** (se aplicável)
+4. **Adicione observações** sobre o estado do equipamento
+
+#### 5. Ocorrências
+
+Registre qualquer problema ou situação especial:
+
+1. **Selecione o tipo** de ocorrência
+2. **Descreva detalhadamente** o que aconteceu
+3. **Classifique a gravidade** (Baixa, Média, Alta)
+4. **Marque se foi resolvida** no mesmo dia
+
+#### 6. Anexos
+
+- **Adicione fotos** das atividades realizadas
+- **Anexe documentos** relevantes
+- **Inclua assinaturas digitais** quando necessário
+
+### Salvando e Enviando o RDO
+
+- **Salvar Rascunho**: Salva o RDO para continuar editando depois
+- **Enviar para Aprovação**: Submete o RDO completo para análise do engenheiro
+
+---
+
+## ✅ Gerenciamento de Tarefas
+
+### Visão Geral das Tarefas
+
+A seção de Tarefas permite planejar e acompanhar todas as atividades da obra:
+
+#### Status das Tarefas
+
+- **⚪ Pendente**: Tarefa ainda não iniciada
+- **🔵 Em Andamento**: Tarefa sendo executada
+- **🟡 Pausada**: Tarefa temporariamente interrompida
+- **🟢 Concluída**: Tarefa finalizada com sucesso
+- **🔴 Cancelada**: Tarefa cancelada
+
+#### Prioridades
+
+- **🟢 Baixa**: Pode ser feita quando houver tempo
+- **🟡 Média**: Importante, mas não urgente
+- **🟠 Alta**: Deve ser feita em breve
+- **🔴 Crítica**: Urgente, pode afetar o cronograma
+
+### Como Gerenciar Tarefas
+
+#### Visualizando Tarefas
+
+1. **Acesse a seção Tarefas** no menu principal
+2. **Use os filtros** para encontrar tarefas específicas:
+   - Por status
+   - Por prioridade
+   - Por responsável
+   - Por obra
+3. **Use a busca** para localizar tarefas pelo nome
+
+#### Criando Nova Tarefa
+
+1. **Clique em "Nova Tarefa"**
+2. **Preencha as informações**:
+   - Título da tarefa
+   - Descrição detalhada
+   - Obra relacionada
+   - Responsável
+   - Prioridade
+   - Data de início
+   - Prazo de conclusão
+   - Tempo estimado
+   - Localização na obra
+
+#### Atualizando Tarefas
+
+- **Altere o status** conforme o progresso
+- **Atualize o percentual** de conclusão
+- **Registre o tempo trabalhado**
+- **Adicione comentários** sobre o andamento
+
+---
+
+## 📊 Relatórios
+
+### Tipos de Relatórios Disponíveis
+
+#### 1. Relatório de Obras
+- Status geral das obras
+- Progresso de cada projeto
+- Obras em andamento, pausadas e concluídas
+- Progresso médio geral
+
+#### 2. Relatório de RDOs
+- Análise dos relatórios diários
+- RDOs pendentes, aprovados e rejeitados
+- Média diária de RDOs criados
+- Histórico mensal
+
+#### 3. Relatório de Equipamentos
+- Status de todos os equipamentos
+- Taxa de utilização
+- Equipamentos em manutenção
+- Disponibilidade por obra
+
+#### 4. Relatório de Produtividade
+- Eficiência das equipes
+- Horas trabalhadas vs. planejadas
+- Atividades concluídas no prazo
+- Identificação de gargalos
+
+#### 5. Relatório Financeiro
+- Orçamento vs. gastos reais
+- Obras dentro do orçamento
+- Economia ou excesso de gastos
+- Projeções financeiras
+
+#### 6. Relatório de Usuários
+- Atividade dos usuários
+- Engajamento com o sistema
+- Novos cadastros
+- Frequência de uso
+
+### Como Gerar Relatórios
+
+1. **Acesse a seção Relatórios**
+2. **Selecione o tipo** de relatório desejado
+3. **Configure os filtros**:
+   - Período (data inicial e final)
+   - Obras específicas
+   - Status desejados
+   - Usuários específicos
+4. **Clique em "Gerar Relatório"**
+5. **Aguarde o processamento**
+
+### Exportando Relatórios
+
+Os relatórios podem ser exportados em diferentes formatos:
+
+- **📄 PDF**: Para apresentações e impressão
+- **📊 Excel**: Para análises detalhadas
+- **📋 CSV**: Para importação em outros sistemas
+
+### Compartilhando Relatórios
+
+- **📧 Email**: Envie diretamente por email
+- **📱 WhatsApp**: Compartilhe via WhatsApp
+- **🔗 Link**: Gere um link para compartilhamento
+
+---
+
+## 📋 Cadastros
+
+### Gerenciamento de Obras
+
+#### Cadastrando Nova Obra
+
+1. **Acesse Cadastros > Obras**
+2. **Clique em "Nova Obra"**
+3. **Preencha as informações**:
+   - Nome da obra
+   - Endereço completo
+   - Cliente/Contratante
+   - Engenheiro responsável
+   - Data de início
+   - Data prevista de conclusão
+   - Orçamento total
+
+#### Informações da Obra
+
+Cada obra cadastrada mostra:
+- **Status atual** (Planejamento, Em andamento, Pausada, Concluída)
+- **Progresso visual** com barra de percentual
+- **Informações financeiras** (orçamento e gastos)
+- **Datas importantes** (início, prazo, último RDO)
+- **Responsáveis** e equipe
+
+### Gerenciamento de Usuários
+
+#### Cadastrando Usuário
+
+1. **Acesse Cadastros > Usuários**
+2. **Clique em "Novo Usuário"**
+3. **Preencha os dados**:
+   - Nome completo
+   - Email
+   - Telefone
+   - Função/Cargo
+   - Empresa
+   - Permissões de acesso
+
+#### Tipos de Usuário
+
+- **Mestre de Obra**: Cria e edita RDOs, gerencia equipe
+- **Engenheiro**: Aprova RDOs, gera relatórios, supervisiona
+- **Gestor**: Acesso completo, múltiplas obras
+- **Cliente**: Visualização de relatórios aprovados
+
+### Gerenciamento de Equipamentos
+
+#### Cadastrando Equipamento
+
+1. **Acesse Cadastros > Equipamentos**
+2. **Clique em "Novo Equipamento"**
+3. **Informe os dados**:
+   - Nome/Identificação
+   - Tipo (Betoneira, Guindaste, etc.)
+   - Modelo e fabricante
+   - Ano de fabricação
+   - Número de série
+   - Data da próxima manutenção
+
+#### Status dos Equipamentos
+
+- **🟢 Disponível**: Pronto para uso
+- **🔵 Em Uso**: Sendo utilizado em uma obra
+- **🟡 Manutenção**: Em manutenção preventiva/corretiva
+- **🔴 Inativo**: Fora de operação
+
+---
+
+## ⚙️ Configurações
+
+### Personalizando o Sistema
+
+A seção de Configurações permite personalizar listas e opções do sistema:
+
+#### Tipos de Atividades
+- **Adicione** novos tipos de atividades específicas da sua empresa
+- **Edite** atividades existentes
+- **Organize** por categorias (Estrutura, Acabamento, Instalações)
+
+#### Condições Climáticas
+- **Customize** as opções de clima disponíveis
+- **Adicione** condições específicas da sua região
+
+#### Tipos de Ocorrências
+- **Configure** os tipos de problemas mais comuns
+- **Classifique** por gravidade
+- **Adicione** procedimentos padrão
+
+#### Funções e Cargos
+- **Mantenha atualizada** a lista de funções da equipe
+- **Adicione** cargos específicos da sua empresa
+
+#### Tipos de Equipamentos
+- **Cadastre** categorias de equipamentos
+- **Organize** por tipo de obra
+
+#### Materiais
+- **Liste** os materiais mais utilizados
+- **Organize** por categoria
+- **Facilite** a seleção nos RDOs
+
+### Backup e Restauração
+
+#### Exportar Configurações
+1. **Acesse Configurações**
+2. **Clique em "Gerenciar"**
+3. **Selecione "Exportar Configurações"**
+4. **Salve o arquivo** em local seguro
+
+#### Importar Configurações
+1. **Clique em "Gerenciar"**
+2. **Selecione "Importar Configurações"**
+3. **Escolha o arquivo** de backup
+4. **Confirme a importação**
+
+#### Restaurar Padrões
+- **Use com cuidado**: Esta ação não pode ser desfeita
+- **Faça backup** antes de restaurar
+- **Confirme** a ação quando solicitado
+
+---
+
+## 💡 Dicas e Melhores Práticas
+
+### Para Mestres de Obra
+
+#### Criação de RDOs Eficientes
+- **📅 Crie o RDO diariamente**: Não acumule vários dias
+- **📸 Tire fotos**: Documente o progresso visualmente
+- **⏰ Registre horários**: Anote início e fim das atividades
+- **👥 Confirme presença**: Verifique todos os funcionários
+- **🔧 Monitore equipamentos**: Registre horas de uso e combustível
+
+#### Gestão de Equipe
+- **✅ Atualize tarefas**: Mantenha o status sempre atual
+- **💬 Use observações**: Detalhe problemas e soluções
+- **📋 Planeje antecipadamente**: Crie tarefas para os próximos dias
+- **🚨 Reporte ocorrências**: Registre todos os problemas imediatamente
+
+### Para Engenheiros
+
+#### Aprovação de RDOs
+- **🔍 Revise diariamente**: Não deixe RDOs pendentes acumularem
+- **📊 Analise tendências**: Observe padrões nos relatórios
+- **💰 Monitore custos**: Acompanhe gastos vs. orçamento
+- **📈 Gere relatórios**: Use dados para tomada de decisões
+
+#### Supervisão de Obras
+- **🎯 Defina metas**: Estabeleça objetivos claros para as equipes
+- **📅 Acompanhe prazos**: Monitore cronograma constantemente
+- **🔧 Gerencie recursos**: Otimize uso de equipamentos e materiais
+- **👥 Desenvolva equipe**: Use dados para identificar necessidades de treinamento
+
+### Para Gestores
+
+#### Visão Estratégica
+- **📊 Use o Dashboard**: Monitore indicadores principais diariamente
+- **📈 Analise relatórios**: Identifique oportunidades de melhoria
+- **💡 Tome decisões**: Base decisões em dados reais
+- **🎯 Defina KPIs**: Estabeleça métricas de sucesso
+
+#### Gestão de Múltiplas Obras
+- **⚖️ Compare performance**: Identifique obras mais/menos eficientes
+- **🔄 Compartilhe boas práticas**: Replique sucessos entre obras
+- **📋 Padronize processos**: Use configurações consistentes
+- **👥 Desenvolva lideranças**: Invista nos melhores mestres de obra
+
+### Dicas Gerais de Produtividade
+
+#### Organização
+- **🗂️ Use categorias**: Organize atividades, equipamentos e materiais
+- **🔍 Use filtros**: Encontre informações rapidamente
+- **⭐ Favorite itens**: Marque obras e tarefas mais importantes
+- **📱 Acesse mobile**: Use o app no canteiro de obra
+
+#### Comunicação
+- **📧 Compartilhe relatórios**: Mantenha todos informados
+- **💬 Use observações**: Comunique-se através dos RDOs
+- **📸 Documente visualmente**: Uma foto vale mais que mil palavras
+- **⏰ Seja pontual**: Registre informações no momento certo
+
+---
+
+## 🔧 Solução de Problemas
+
+### Problemas Comuns e Soluções
+
+#### "Não consigo fazer login"
+
+**Possíveis causas:**
+- Usuário ou senha incorretos
+- Conta desativada
+- Problemas de conexão
+
+**Soluções:**
+1. **Verifique** usuário e senha (atenção a maiúsculas/minúsculas)
+2. **Contate** o administrador do sistema
+3. **Teste** a conexão com a internet
+4. **Limpe** o cache do navegador
+
+#### "O aplicativo está lento"
+
+**Possíveis causas:**
+- Conexão de internet lenta
+- Muitas abas abertas
+- Cache do navegador cheio
+
+**Soluções:**
+1. **Teste** a velocidade da internet
+2. **Feche** abas desnecessárias
+3. **Limpe** o cache do navegador
+4. **Reinicie** o navegador
+
+#### "Não consigo salvar o RDO"
+
+**Possíveis causas:**
+- Campos obrigatórios não preenchidos
+- Problemas de conexão
+- Sessão expirada
+
+**Soluções:**
+1. **Verifique** se todos os campos obrigatórios estão preenchidos
+2. **Teste** a conexão com a internet
+3. **Faça login** novamente
+4. **Salve** como rascunho primeiro
+
+#### "As fotos não estão carregando"
+
+**Possíveis causas:**
+- Arquivos muito grandes
+- Formato não suportado
+- Problemas de conexão
+
+**Soluções:**
+1. **Reduza** o tamanho das imagens
+2. **Use** formatos JPG ou PNG
+3. **Verifique** a conexão com a internet
+4. **Tente** carregar uma foto por vez
+
+#### "Não encontro uma obra/usuário/equipamento"
+
+**Possíveis causas:**
+- Item não cadastrado
+- Filtros ativos
+- Problemas de permissão
+
+**Soluções:**
+1. **Verifique** se o item foi cadastrado
+2. **Limpe** todos os filtros
+3. **Use** a busca por nome
+4. **Contate** o administrador sobre permissões
+
+### Quando Buscar Ajuda
+
+#### Contate o Suporte Técnico quando:
+- **🔐 Problemas de acesso** persistem após tentativas
+- **💾 Perda de dados** ou informações não salvam
+- **🐛 Erros** aparecem na tela
+- **⚡ Performance** muito lenta mesmo com boa internet
+- **🔧 Funcionalidades** não respondem
+
+#### Informações para Fornecer ao Suporte:
+- **📱 Dispositivo** usado (celular, tablet, computador)
+- **🌐 Navegador** e versão
+- **📅 Quando** o problema começou
+- **🔄 Passos** para reproduzir o problema
+- **📸 Prints** da tela de erro (se houver)
+
+---
+
+## 📚 Glossário
+
+### Termos Técnicos
+
+**RDO (Relatório Diário de Obra)**
+Documento que registra todas as atividades, recursos e ocorrências de um dia específico na obra.
+
+**Dashboard**
+Tela principal que apresenta uma visão geral de todas as informações importantes.
+
+**Status**
+Estado atual de uma obra, tarefa ou equipamento (ex: ativo, pausado, concluído).
+
+**Progresso**
+Percentual de conclusão de uma obra ou atividade (0% a 100%).
+
+**Ocorrência**
+Qualquer evento, problema ou situação especial que acontece na obra.
+
+**Mão de Obra**
+Conjunto de trabalhadores envolvidos na execução das atividades da obra.
+
+**Equipamento**
+Máquinas, ferramentas e dispositivos utilizados na construção.
+
+**Anexo**
+Arquivos adicionais como fotos, documentos ou assinaturas digitais.
+
+### Funções e Cargos Comuns
+
+**Mestre de Obra**
+Profissional responsável pela coordenação direta das atividades no canteiro.
+
+**Engenheiro Civil**
+Profissional responsável pelo projeto, supervisão técnica e aprovação de relatórios.
+
+**Pedreiro**
+Profissional especializado em alvenaria, revestimentos e acabamentos.
+
+**Servente**
+Auxiliar geral que apoia as diversas atividades da obra.
+
+**Eletricista**
+Profissional especializado em instalações elétricas.
+
+**Encanador**
+Profissional especializado em instalações hidráulicas.
+
+**Carpinteiro**
+Profissional especializado em estruturas e formas de madeira.
+
+**Armador**
+Profissional especializado em estruturas de ferro e aço.
+
+### Tipos de Atividades
+
+**Fundação**
+Etapa inicial da construção, incluindo escavação, estacas e sapatas.
+
+**Estrutura**
+Etapa de construção da estrutura principal (pilares, vigas, lajes).
+
+**Alvenaria**
+Construção de paredes e divisórias.
+
+**Cobertura**
+Etapa de construção do telhado e impermeabilização.
+
+**Instalações**
+Etapa de instalação de sistemas elétricos, hidráulicos e outros.
+
+**Acabamento**
+Etapa final incluindo revestimentos, pintura e detalhes finais.
+
+---
+
+## 📞 Suporte e Contato
+
+### Precisa de Ajuda?
+
+Se você não encontrou a solução para seu problema neste manual:
+
+1. **📧 Email**: Entre em contato com o suporte técnico
+2. **📱 WhatsApp**: Use o canal de suporte da sua empresa
+3. **👥 Treinamento**: Solicite treinamento adicional
+4. **📖 Documentação**: Consulte a documentação técnica
+
+### Feedback e Sugestões
+
+Sua opinião é importante para melhorarmos o sistema:
+
+- **💡 Sugestões** de novas funcionalidades
+- **🐛 Relatos** de problemas encontrados
+- **⭐ Avaliações** sobre usabilidade
+- **📝 Comentários** sobre este manual
+
+---
+
+**© 2024 RDO Mobile - Manual do Usuário v1.0**
+
+*Este manual foi criado para ajudar você a aproveitar ao máximo o aplicativo RDO Mobile. Mantenha-o sempre atualizado e consulte regularmente para descobrir novas funcionalidades.*