Files
gestao_de_manutencao/README.md

2.2 KiB

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:

    • 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:

    • Registro de alterações por versão (Versão Atual: 1.1.0 - versionCode 2).
  • Arquitetura do Sistema:

    • 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 / 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:
    ./gradle_9_3_1/gradle-9.3.1/bin/gradle test
    
  4. Execute o aplicativo em um emulador ou dispositivo físico Android.