JCRing App - Smart Ring Health Monitoring Application

Uma aplicação Android moderna para monitoramento de saúde usando o smart ring JCRing (modelo J2301A).

📱 Funcionalidades

Conexão Bluetooth

• Escaneamento e descoberta de dispositivos JCRing
• Conexão automática e gerenciamento de estado
• Monitoramento de nível de bateria em tempo real
• Reconexão automática quando disponível

Monitoramento de Saúde

• Frequência Cardíaca: Medição em tempo real e histórico
• SpO2: Saturação de oxigênio no sangue
• Temperatura Corporal: Monitoramento contínuo
• Atividade Física: Passos, calorias, distância
• HRV: Variabilidade da frequência cardíaca
• Sono: Análise de padrões de sono (futura implementação)
• Exercícios: Múltiplos modos de exercício (futura implementação)

Interface de Usuário

• Dashboard: Visão geral dos dados de saúde
• Dispositivos: Gerenciamento de conexões Bluetooth
• Dados de Saúde: Visualização detalhada dos dados coletados
• Configurações: Configurações do dispositivo e aplicativo

🛠️ Tecnologias Utilizadas

Framework Android

• Kotlin: Linguagem principal
• Jetpack Compose: Interface de usuário moderna
• Material 3: Design system moderno
• ViewModel & LiveData: Gerenciamento de estado
• Coroutines & Flow: Programação assíncrona

Arquitetura

• MVVM: Model-View-ViewModel pattern
• Repository Pattern: Separação de fontes de dados
• Clean Architecture: Separação clara de responsabilidades

Bibliotecas

• BLE SDK J2301A: SDK oficial do smart ring
• PermissionX: Gerenciamento simplificado de permissões
• Navigation Component: Navegação entre telas
• Room Database: Armazenamento local (futuro)

📋 Pré-requisitos

• Android Studio Arctic Fox ou superior
• Android SDK 21+ (Android 5.0)
• Dispositivo Android com Bluetooth Low Energy (BLE)
• Smart ring JCRing modelo J2301A

🚀 Instalação e Configuração

1. Clonar o Repositório

git clone [URL_DO_REPOSITORIO]
cd ring/JCRingApp

2. Abrir no Android Studio

1. Abra o Android Studio
2. Selecione "Open an existing project"
3. Navegue até a pasta JCRingApp
4. Aguarde o sync do Gradle

3. Configurar SDK BLE

O módulo blesdk_2301 já está incluído no projeto com todas as dependências necessárias.

4. Permissões Necessárias

A aplicação requer as seguintes permissões:

• BLUETOOTH / BLUETOOTH_CONNECT
• BLUETOOTH_ADMIN / BLUETOOTH_SCAN
• ACCESS_FINE_LOCATION
• ACCESS_COARSE_LOCATION

🔧 Comandos de Build

Compilar Debug

./gradlew assembleDebug

Compilar Release

./gradlew assembleRelease

Executar Testes

./gradlew test

Limpar Build

./gradlew clean

📖 Como Usar

1. Primeira Execução

1. Abra a aplicação
2. Conceda as permissões de Bluetooth e localização
3. Navegue até a aba "Devices"

2. Conectar ao Smart Ring

1. Na aba "Devices", toque em "Scan for Devices"
2. Aguarde seu JCRing aparecer na lista
3. Toque em "Connect" no dispositivo desejado
4. Aguarde a conexão ser estabelecida

3. Monitorar Dados de Saúde

1. Após conectado, vá para a aba "Dashboard"
2. Use os botões "Heart Rate" e "SpO2" para medições manuais
3. Os dados aparecerão automaticamente na tela
4. Navegue para "Health Data" para ver detalhes

4. Configurações

1. Na aba "Settings", configure:
   • Informações pessoais
   • Unidades de medida
   • Configurações do dispositivo

🏗️ Estrutura do Projeto

app/
├── src/main/java/com/jcring/app/
│   ├── data/
│   │   ├── bluetooth/          # Gerenciamento Bluetooth
│   │   ├── models/             # Modelos de dados
│   │   └── database/           # Banco de dados (futuro)
│   ├── domain/                 # Lógica de negócio (futuro)
│   ├── presentation/
│   │   ├── ui/
│   │   │   └── screens/        # Telas da aplicação
│   │   ├── viewmodel/          # ViewModels
│   │   └── theme/              # Tema e cores
│   └── JCRingApplication.kt    # Classe Application
└── blesdk_2301/                # SDK BLE oficial

🔌 Integração com SDK BLE

Principais Classes do SDK

• BleManager: Gerenciamento de conexões
• BleSDK: Comandos para o dispositivo
• DataListener2301: Callbacks de dados
• BleConnectionListener: Estados de conexão

Exemplo de Uso

// Conectar ao dispositivo
BleManager.getInstance().connectDevice(macAddress, false, connectionListener)

// Iniciar medição de frequência cardíaca
val command = BleSDK.SetDeviceMeasurementWithType(AutoTestMode.AutoHeartRate, 60, true)
BleManager.getInstance().writeValue(command)

// Receber dados
val dataListener = object : DataListener2301 {
    override fun dataCallback(maps: Map<String, Any>?) {
        // Processar dados recebidos
    }
}

🧪 Funcionalidades Implementadas

✅ Concluído

• Estrutura básica da aplicação
• Integração com SDK BLE
• Interface de usuário moderna (Compose)
• Gerenciamento de estado (ViewModel)
• Conexão Bluetooth
• Medição de frequência cardíaca
• Medição de SpO2
• Monitoramento de temperatura
• Dados de atividade
• Dashboard interativo

🔄 Em Desenvolvimento

• Banco de dados local (Room)
• Gráficos e visualizações
• Histórico de dados
• Configurações avançadas
• Notificações

📅 Futuras Implementações

• Sincronização com nuvem
• Análise de tendências
• Relatórios de saúde
• Compartilhamento de dados
• Múltiplos dispositivos

🐛 Troubleshooting

Problemas Comuns

Dispositivo não encontrado

• Verifique se o Bluetooth está ativado
• Confirme as permissões de localização
• Certifique-se de que o smart ring está próximo e carregado

Falha na conexão

• Reinicie o Bluetooth no smartphone
• Remova e reinsira a bateria do smart ring
• Verifique se não há outros apps conectados ao dispositivo

Dados não aparecem

• Confirme que o dispositivo está conectado
• Verifique se as medições foram iniciadas
• Aguarde alguns segundos para os dados aparecerem

📄 Licença

Este projeto é licenciado sob a licença MIT. Veja o arquivo LICENSE para detalhes.

🤝 Contribuição

1. Faça um fork do projeto
2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

📞 Suporte

Para suporte e dúvidas:

• Crie uma issue no repositório
• Consulte a documentação do SDK JCRing
• Verifique os logs de debug na aplicação

📚 Recursos Adicionais

• Documentação Android BLE
• Jetpack Compose Docs
• Material Design 3
• Kotlin Coroutines

---

Desenvolvido com ❤️ para monitoramento de saúde inteligente