Files
gestao_de_manutencao/documentacao/design/descricao_layout_e_recursos.md

9.4 KiB

Especificação de Design e Recursos Visuais

Esta documentação descreve os recursos visuais e a estrutura de tela do aplicativo Gestão de Manutenção (Gestão Parada OS) baseando-se no layout atual de produção (conforme print do app em execução).

O objetivo deste documento é servir de guia detalhado para expandir a complexidade do aplicativo, adicionando novas telas, fluxos de navegação e componentes visuais mais robustos.


1. Análise da Identidade Visual e Estilo (Design System)

O aplicativo utiliza um visual moderno que busca equilibrar a seriedade industrial com a identidade visual da marca.

  • Paleta de Cores:
    • Fundo Geral: Cinza neutro muito claro (#F5F7F6 / LightGrey), reduzindo a fadiga visual sob luz solar em campo.
    • Cor Primária (Destaques da Marca): Verde escuro da marca (#005F40), utilizado no cabeçalho do usuário, botões de ação prioritários e nos chips selecionados.
    • Cor Secundária (Textos e Títulos): Preto carvão (#1A1A1A), oferecendo alto contraste para textos e números.
    • Cores de Status (Feedback Visual):
      • Concluído/Sincronizado: Verde folha (#E8F5E9 para fundo, #005F40 para ícone/texto).
      • Em Andamento: Azul suave (#E3F2FD para fundo, #1E88E5 para o indicador de progresso e badges).
      • Não Iniciado: Tons de cinza médio (#ECEFF1 / #78909C).
  • Tipografia: Fonte Sans-Serif limpa e de alta legibilidade, com variações de peso (Bold para títulos de OS e contadores métricos, Medium para subtítulos e chips, Regular para prazos e descrições).
  • Formatos e Contornos: Uso de cartões elevados (Card / Surface) com cantos arredondados generosos (16.dp a 24.dp), sombras suaves (shadow / elevation baixa) e bordas finas para delimitação visual clara.

2. Descrição Detalhada dos Componentes da Tela Principal

A tela única atual (MaintenanceDashboardScreen.kt) está estruturada verticalmente nas seguintes seções:

2.1. Barra Superior de Controle (App Bar)

  • Título: "Gestão OS" alinhado à esquerda.
  • Indicador de Conectividade: Um Box quadrado verde-claro com um ícone de nuvem (Cloud) verde escuro, demonstrando se o app está online e pareado.
  • Ação de Sincronismo: Botão circular com ícone de setas giratórias (Sync) que rotaciona visualmente quando o processo assíncrono de sincronização bidirecional com o Google Sheets está ativo.
  • Painel de Usuário: Card do Google Sign-In exibindo a foto do perfil (ou inicial do nome "J"), o nome do usuário ("Jhony"), o e-mail ("cesarjhony@gmail.com") e uma seta indicativa de dropdown para logout ou troca de conta.

2.2. Painel de Métricas da Parada (KPI Dashboard)

  • Estrutura: Card branco elevado com cantos arredondados contendo o título "Progresso Parada Industrial" e subtítulo "Visão Geral de Campo".
  • Gráfico de Progresso Global: Um indicador de progresso circular (CircularProgressIndicator verde) localizado no canto superior direito, exibindo a porcentagem de tarefas finalizadas (atualmente em 2%).
  • Contadores de Metas (Grid de Indicadores): Quatro colunas horizontais exibindo:
    • ▶ 595 / Não Inic. (Cinza)
    • ☁ 9 / Em Andam. (Azul)
    • ✔ 13 / Concluídas (Verde)
    • 🔧 617 / Total OSs (Preto)

2.3. Campo de Pesquisa Dinâmica

  • Design: Caixa de texto de largura total, com cantos arredondados, ícone de lupa (Search) e placeholder "Buscar por OS, descrição...".
  • Comportamento: Filtra a lista instantaneamente enquanto o usuário digita.

2.4. Grade Modular de Filtros (Chips de Categoria)

O app organiza os filtros em 5 linhas horizontais com rolagem lateral (LazyRow). Cada categoria inicia com o chip "Todos" ou "Todas" ativo na cor verde escura:

  1. Setor: Opções como "Todos", "COGERAÇÃO", "EXTRAÇÃO", "PREPARAÇÃO".
  2. Equipe: Opções como "Todas", "Mecânica", "Elétrica", "Confiabilidade".
  3. Status: Opções como "Todos", "Não iniciado", "Em andamento", "Concluído".
  4. Data: Opções como "Todas", "04/08/26", "08/08/26", "09/08/26".
  5. Recurso (Técnico): Opções como "Todos", "ADILSON", "AGIL", "ALAN", "ALEX".

2.5. Cartão de Cronograma Geral do Projeto

  • Título: "Ordens de Serviço (617)" acompanhado de um ícone de maximizar/redimensionar grade no canto direito.
  • Barra de Progresso: Um indicador linear horizontal (LinearProgressIndicator azul) que marca visualmente 75% de avanço (progresso temporal do cronograma da parada).
  • Prazos: Subtexto detalhado mostrando a janela de execução (ex: "Prazo: qui. 27/08/26 07:00 até qui. 27/08/26 17:00").

2.6. Lista de Cartões de Ordens de Serviço (OS Cards)

  • Visual da Linha: Um card branco com contorno fino e espaçamento confortável.
  • Código e Sincronismo: Identificador da OS (ex: "OS-1019") seguido de um ícone de nuvem com check verde indicando pareamento perfeito com o banco central.
  • Badge de Status: Um marcador com cor temática no canto superior direito (ex: "Em andamento" com fundo azul claro e texto azul escuro).
  • Subtexto: Código do TAG/Equipamento (ex: "CV-101001").

3. Diretrizes para Adicionar Telas e Aumentar a Complexidade

Para expandir o aplicativo de sua estrutura atual de tela única ("Single Screen Dashboard") para um ecossistema multiplataforma robusto de campo, deve-se seguir as seguintes diretrizes de expansão:

                  [Fluxo de Navegação Sugerido]

                   +------------------------+
                   |  Dashboard Principal   | (Tela Atual)
                   +-----------+------------+
                               |
         +---------------------+---------------------+
         | (Clique na OS)                            | (Clique em Métricas/Analítico)
         v                                           v
+------------------------+                  +------------------------+
|   Detalhes da OS       |                  | Dashboard Analítico M3 |
+--------+---------------+                  +------------------------+
         |
         +---------------------+
         | (Anexar Evidência)  | (Ver Histórico)
         v                     v
+-----------------+   +-----------------+
| Scanner & Foto  |   |   Auditoria &   |
| Real (CameraX)  |   |    Timeline     |
+-----------------+   +-----------------+

3.1. Proposta de Novas Telas

  1. Tela de Detalhes Aprofundados da OS (OSDetailScreen):
    • Recurso: Exibição de árvore de sub-tarefas (checklists de segurança, permissões de trabalho - PT).
    • Recurso: Visualização e zoom de fotos anexadas em alta definição.
    • Recurso: Lista de materiais e ferramentas necessárias separadas por equipe.
  2. Tela de Linha do Tempo e Auditoria Geral (TimelineAuditoriaScreen):
    • Recurso: Feed contínuo contendo todas as atualizações de todas as OSs efetuadas pelos técnicos em campo na parada atual, exibindo quem alterou, quando alterou, o que alterou (observações) e fotos vinculadas.
  3. Tela de Métricas Analíticas Avançadas (AnalyticsScreen):
    • Recurso: Gráficos de barra de produtividade por Equipe (ex: Mecânica concluiu X%, Elétrica concluiu Y%).
    • Recurso: Gráfico de linha acumulado ("S-Curve") comparando o planejado com o realizado.
    • Recurso: Gráfico de quebras (Pareto) listando os setores com maior número de anomalias relatadas nas observações.
  4. Tela de Configurações do Planejador PCM (SettingsScreen):
    • Recurso: Formulário para alterar dinamicamente o ID da Planilha Google Sheets ativa.
    • Recurso: Status de cota e conexão da API do Google, permitindo testar credenciais em tempo real.
    • Recurso: Console para forçar limpezas na base SQLite ou exportar backup do banco de dados local.
  5. Módulo de Simulação de Data do Sistema (SettingsScreen / DateSimulationSection):
    • Recurso: Painel com controle de permissão por Nível Total. Permite escolher a data simulada (Material3 DatePickerDialog) e o modo (Somente Visualização vs Edição do Progresso das Ordens).
    • Recurso: Possui encerramento automático após 15 minutos de simulação contínua e exibe banner de alerta no topo do Dashboard indicando a data simulada, modo ativo e ação de desativação rápida.

3.2. Proposta de Recursos Técnicos para Implementação Visando Complexidade

  1. Câmera Nativa com Upload Real (Firebase Storage), Suporte a HEIC e Compactação (<= 500KB):
    • Substituir o simulador de fotos estáticas (mockPhotos) por captura real utilizando câmera nativa do Android ou seleção de Galeria (com suporte nativo a HEIC, JPEG e PNG).
    • As imagens são compactadas pelo ImageCompressor.kt para no máximo 500 KB mantendo excelente qualidade e correção automática de rotação EXIF. As imagens são enviadas de forma única ao Firebase Storage (photos/OS_{numeroOs}/) via SDK assíncrono. A URL de download obtida é gravada no campo fotoPath no banco local e sincronizada na aba history do Sheets.
  2. Sincronização em Segundo Plano Resiliente (WorkManager):
    • Substituir o clique manual em "Sincronizar" por um agendador automático em segundo plano que detecta conectividade Wi-Fi e envia logs pendentes sem travar ou exigir ação do inspetor.