# Aplicativo de Gestão de Manutenção de Parada (Android) Aplicativo Android **offline-first** desenvolvido em Kotlin e Jetpack Compose para gerenciamento, acompanhamento e auditoria de Ordens de Serviço (OS) em plantas industriais. --- ## 📚 Documentação Técnica do Projeto - **[Documentação de Fluxo de Dados, Salvamento e Sincronização](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/documentacao/fluxo_de_dados_e_sincronizacao.md)**: - Estrutura completa das 7 tabelas do banco de dados local Room (`maintenance_activities`, `os_findings`, `os_update_history`, `app_logs`, `sync_conflict_logs`, `user_access`, `app_config`). - Fluxo detalhado de salvamento de progresso e achados com tipo exclusivo `FOTO`. - Processo de compactação (<= 500KB) e upload para Firebase Storage. - Sincronização bidirecional com Google Sheets (abas `project`, `history`, `achados`, `config` e `usage_history`). - Sincronização de links úteis da aba `config` para a Tela de Informações Importantes (posicionada à esquerda do Dashboard). - Rastreamento em tempo real do último acesso por dispositivo, e-mail de Google Sign-In e versão do sistema na aba `usage_history`. - Carregamento e download de fotos **sob demanda** (On-Demand Loading) para múltiplos celulares sem erros HTTP 403. - **[Changelog / Histórico de Versões](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/CHANGELOG.md)**: - Registro de alterações por versão (Versão Atual: **`1.2.0`** - `versionCode 3`). - **[Arquitetura do Sistema](file:///home/cesarjhony/dev/projects/gestao_de_manutencao/documentacao/arquitetura/arquitetura_do_sistema.md)**: - Diagramas de arquitetura MVVM + Repository Pattern. - Mapeamento de componentes Compose, ViewModel e Room DAO. - Algoritmo de reconciliação de dados e auditoria transacional. --- ## 🚀 Como Executar o Projeto **Pré-requisitos:** [Android Studio](https://developer.android.com/studio) / JDK 17+ 1. Abra o Android Studio. 2. Selecione **Open** e escolha a pasta deste projeto (`gestao_de_manutencao`). 3. Execute os testes unitários via linha de comando ou terminal do estúdio: ```bash ./gradle_9_3_1/gradle-9.3.1/bin/gradle test ``` 4. Execute o aplicativo em um emulador ou dispositivo físico Android.