39 lines
2.2 KiB
Markdown
39 lines
2.2 KiB
Markdown
# 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.
|