# 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`](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/app/src/main/java/com/example/ui/screens/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.3. Recursos de Achados e Auditoria Visuais por OS (`EditActivityBottomSheet`) 1. **Banner de Última Observação**: Exibe no topo do modal da OS o texto da última observação registrada (`tipo = "OBS"`). 2. **Seções de Achados de Segurança e Manutenção**: - **Achados de Segurança (🛡️)**: Card em tom laranja/bege (`#FFF3E0`) permitindo a criação de múltiplos achados por OS, com opções de edição e exclusão física dos itens ativos. - **Achados de Manutenção (🔧)**: Card em tom azul/turquesa (`#E0F7FA`) permitindo a criação de múltiplos achados de manutenção por OS, com edição e exclusão. 3. **Badges Visualmente Diferenciados no Histórico da OS (`TimelineLogItem`)**: - 🛡️ **Achado de Segurança**: Badge laranja/vermelho com ícone de escudo. - 🔧 **Achado de Manutenção**: Badge azul/turquesa com ícone de chave. - 📝 **Observação**: Badge roxo/cinza com ícone de comentário. - 📊 **Progresso**: Badge verde/azul indicando alterações percentuais (% anterior ➜ % novo). ### 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.