first commit

This commit is contained in:
2025-12-12 10:22:34 +00:00
commit 0c54f9a9cc
97 changed files with 5827 additions and 0 deletions

172
COMO_USAR.md Normal file
View File

@@ -0,0 +1,172 @@
# 📱 Bem+ - Guia de Utilização Completo
## 🎯 Visão Geral
A app **Bem+** é um sistema completo de gestão de medicação para idosos com controlo parental integrado.
---
## 👤 PARA UTILIZADORES (Idosos)
### 1⃣ Primeiro Acesso
1. Abra a app
2. Toque em **"Registar"**
3. Preencha:
- Nome completo
- Email
- Palavra-passe (mínimo 6 caracteres)
4. Toque em **"Criar Conta"**
### 2⃣ Criar Alarmes
1. Na aba **"Alarmes"** (sino verde)
2. Toque no botão **"+ Novo"**
3. Configure:
- Nome do medicamento (ex: Aspirina)
- Horário (toque para escolher com picker)
- Dosagem (ex: 100mg • Segunda a Sexta)
4. Toque **"Guardar"**
5. ✅ Alarme criado e agendado!
### 3⃣ Editar Alarmes
Toque no ícone do **lápis** ✏️ em qualquer alarme:
- **⏰ Alterar horário** - Mude a hora
- **🔔 Escolher toque** - Escolha som dos toques do telemóvel
- **🎵 Testar toque atual** - Ouve 5 segundos de pré-visualização
- **📝 Editar título** - Renomeie o medicamento
### 4⃣ Quando o Alarme Toca
O ecrã liga automaticamente e mostra:
- 💊 Nome do medicamento
- 🕐 Hora atual
- **⏰ Adiar 5min** - Toca novamente em 5 minutos
- **✓ Parar** - Para o alarme
### 5⃣ Confirmar que Tomou
Em cada alarme, toque no botão **"✓ Confirmar"**:
- Regista a hora exata
- Notifica o responsável automaticamente
- Botão muda para **"✓ Tomado"** (cinza)
- Reseta amanhã
### 6⃣ Adicionar Responsável
1. Toque no ícone de **⚙️ Configurações** (canto superior direito)
2. Escolha **"🎟️ Gerar código para responsável"**
3. Partilhe o código de **6 dígitos** com o responsável
4. ⏱️ **Válido por 30 segundos!**
---
## 👨‍⚕️ PARA RESPONSÁVEIS
### 1⃣ Criar Conta de Responsável
1. Na tela de login, toque em **"🔒 Sou Responsável"**
2. Toque em **"Registar"**
3. Preencha:
- Nome completo
- Email
- Palavra-passe
- Número de telemóvel
4. Toque em **"Criar Conta"**
### 2⃣ Vincular a um Utilizador
Após criar conta:
1. Peça ao utilizador para gerar um código
2. Na tela de código, insira o código de **6 dígitos**
3. Toque **"Vincular Responsável"**
4. ✅ Vinculado com sucesso!
### 3⃣ Monitorizar Medicação
Aceda à aba **"Responsáveis"** (escudo roxo):
**Dashboard em tempo real:**
- **Tomados**: Quantos medicamentos foram confirmados hoje
- **Pendentes**: Quantos ainda faltam
- **Adesão**: Percentagem de cumprimento
**Lista detalhada:**
-**"✓ Tomado às 14:32"** (verde) - Confirmado
- ⚠️ **"⚠ Pendente"** (vermelho) - Ainda não tomou
---
## 🔐 Segurança
### Recuperar Palavra-passe
1. Na tela de login, toque em **"Esqueci-me da palavra-passe"**
2. Insira o email
3. Toque **"Enviar"**
4. Verifique o email com link de recuperação
### Múltiplos Responsáveis
- Um utilizador pode ter **vários responsáveis**
- Cada responsável vê os mesmos dados
- Todos recebem notificações de confirmação
### Códigos Temporários
- ⏱️ Válidos por **30 segundos**
- 🔒 Uso único (não pode ser reutilizado)
- 🎲 Aleatórios de 6 dígitos
- ♻️ Pode gerar novos códigos ilimitadamente
---
## 🎨 Abas da App
### 🔔 Alarmes
- Criar, editar e apagar alarmes
- Confirmar tomada de medicamentos
- Escolher toques personalizados
### 💚 Lembretes
- Dicas inteligentes baseadas no clima
- Sugestões de atividades
- Sistema contextual automático
### 🛡️ Responsáveis (Controlo Parental)
- Monitorização em tempo real
- Histórico de medicações
- Estatísticas de adesão
- **Só acessível por responsáveis autenticados!**
---
## ⚡ Dicas
- 🔊 **Toques tocam MUITO ALTO** - Use volume máximo do canal de alarme
- 🔋 **Vibração otimizada** - Padrão intermitente poupa bateria
- 📱 **Funciona mesmo bloqueado** - Ecrã liga automaticamente
- ☁️ **Dados na cloud** - Firebase sincroniza tudo
---
## 🆘 Problemas Comuns
**"Alarme não toca"**
→ Verifique permissões de notificação e alarmes exatos
**"Código expirou"**
→ São só 30 segundos! Gere novo código
**"Não consigo entrar no Controlo Parental"**
→ Só responsáveis registados têm acesso
**"Esqueci-me da palavra-passe"**
→ Use "Recuperar palavra-passe" com o email