8.9 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 (
#E8F5E9para fundo,#005F40para ícone/texto). - Em Andamento: Azul suave (
#E3F2FDpara fundo,#1E88E5para o indicador de progresso e badges). - Não Iniciado: Tons de cinza médio (
#ECEFF1/#78909C).
- Concluído/Sincronizado: Verde folha (
- Fundo Geral: Cinza neutro muito claro (
- 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.dpa24.dp), sombras suaves (shadow/elevationbaixa) 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 (
CircularProgressIndicatorverde) localizado no canto superior direito, exibindo a porcentagem de tarefas finalizadas (atualmente em2%). - 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:
- Setor: Opções como
"Todos","COGERAÇÃO","EXTRAÇÃO","PREPARAÇÃO". - Equipe: Opções como
"Todas","Mecânica","Elétrica","Confiabilidade". - Status: Opções como
"Todos","Não iniciado","Em andamento","Concluído". - Data: Opções como
"Todas","04/08/26","08/08/26","09/08/26". - 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 (
LinearProgressIndicatorazul) que marca visualmente75%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
- 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.
- 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.
- 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.
- 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.
3.2. Proposta de Recursos Técnicos para Implementação Visando Complexidade
- 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.ktpara 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 campofotoPathno banco local e sincronizada na abahistorydo Sheets.
- Substituir o simulador de fotos estáticas (
- 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.