👤 Guias de Utilizador

Visão Geral

Este guia apresenta workflows práticos passo-a-passo para utilizadores e administradores do Crypto Dashboard.

🔐 Para Todos os Utilizadores

Primeiro Acesso

1. Receber Credenciais

O administrador criará sua conta e fornecerá:

• Username
• Password inicial
• Link da aplicação

2. Login Inicial

1. Aceder ao URL da aplicação
2. Inserir username e password
3. Clicar em "Login"
4. Será redirecionado para o dashboard

3. Alterar Password (Recomendado)

1. No menu lateral → "⚙️ Configurações"
2. Secção "Alterar Password"
3. Inserir password atual
4. Inserir nova password (mínimo 6 caracteres)
5. Confirmar nova password
6. Clicar "Atualizar Password"

Dashboard Principal

Visão Geral do que vê:

┌─────────────────────────────────────────┐
│  🏠 Crypto Dashboard                     │
├─────────────────────────────────────────┤
│  👤 Bem-vindo, [Seu Username]!          │
│                                          │
│  Menu Lateral:                           │
│  📊 Análise de Portfólio                │
│  ⚙️ Configurações                        │
│  🚪 Logout                               │
└─────────────────────────────────────────┘

Ver Seu Portfólio

Passo-a-passo:

1. Menu lateral → "📊 Análise de Portfólio"
2. Verá automaticamente seu portfólio (não dos outros)

Informação Mostrada:

Métricas de Topo

💰 Saldo Atual (Fundo): €5,234.50
   └─> Seu valor total no fundo HOJE

📈 Total Depositado: €4,000.00
   └─> Soma de todos os seus depósitos

📉 Total Levantado: €0.00
   └─> Soma de todos os seus levantamentos

Gráfico de Evolução

• Linha Azul: Seus depósitos acumulados ao longo do tempo
• Linha Vermelha: Seus levantamentos acumulados
• Linha Verde: Valor real do seu portfólio (com ganhos/perdas do mercado)

Interpretar o Gráfico:

Se linha verde > linha azul → Está a ganhar 📈
Se linha verde < linha azul → Está a perder 📉
Se linha verde = linha azul → Break-even ➡️

Solicitar Depósito

Atenção: Você não faz o depósito diretamente no sistema. O fluxo é:

1. Contacta o administrador: Email, telefone ou presencialmente. Diz quanto quer depositar (ex: €1,000)
2. Transfere o dinheiro: Transferência bancária, entrega em dinheiro ou transferência cripto
3. Aguarda confirmação: Admin confirma recebimento e regista no sistema
4. Verifica no dashboard: Vê novo saldo e ownership %

Solicitar Levantamento

Fluxo similar ao depósito:

1. Verifica quanto pode levantar: Vai a "Análise de Portfólio" e vê "Saldo Atual"
2. Contacta administrador: Informa valor desejado
3. Admin processa: Transfere o dinheiro e regista no sistema
4. Verifica no dashboard: Saldo atualizado

👥 Para Administradores

Gestão de Utilizadores

Criar Novo Utilizador

1. Menu → "👥 Utilizadores"
2. Secção "➕ Adicionar Novo Utilizador"
3. Preencher formulário:

   Username: joao_silva
   Email: joao@email.com
   Password: [gerar forte]
   Confirmar Password: [repetir]
   É Admin?: [ ] (deixar desmarcado para utilizador normal)

4. Clicar "Criar Utilizador"
5. Anotar credenciais para enviar ao utilizador

Boas Práticas:

• ✅ Username sem espaços (usar _ ou -)
• ✅ Email válido (para recuperação futura)
• ✅ Password forte: mínimo 8 caracteres, maiúsculas, números
• ✅ Não tornar todos admin (princípio do menor privilégio)

Processar Depósitos

Workflow Completo:

1. Receber Fundos (Fora do Sistema)

Utilizador transfere €1,000 via transferência bancária, dinheiro físico ou transferência cripto.

Confirmar Recebimento:

• Verificar extrato bancário ✅
• OU confirmar transação blockchain ✅
• OU contar dinheiro físico ✅

2. Registar no Sistema

1. Menu → "👥 Utilizadores"
2. Selecionar utilizador que depositou
3. Secção "💰 Movimentos de Capital"
4. Tab "Depósito"
5. Preencher:

   💶 Valor (EUR): 1000
   📅 Data: 2025-10-31  [data do recebimento]
   📝 Notas: Transferência bancária ref. 12345

6. Clicar "Registar Depósito"

Executar Transações de Cripto

Comprar Criptomoeda

Cenário: Fundo tem €5,000 em caixa, quer comprar ADA

1. Menu → "💼 Portfólio"
2. Tab "Comprar"
3. Selecionar ativo: 🪙 Ativo: ADA (Cardano)
4. Inserir quantidade: 📊 Quantidade: 1000
5. Opção A - Usar Preço de Mercado:
   • Clicar botão "💹 Usar preço de mercado"
   • Sistema busca preço atual automaticamente
6. Data da transação: 📅 Data: 2025-10-31
7. Fee (opcional): 💸 Fee (EUR): 0.50
8. Clicar "Confirmar Compra"

Analisar Performance do Fundo

Vista Agregada (Todos os Utilizadores)

1. Menu → "📊 Análise de Portfólio"
2. No topo, ver selector: 🔍 Escolhe uma vista: 💰 Todos (Fundo Comunitário)
3. Deixar selecionado "Todos"

Métricas Mostradas:

💰 Saldo Atual (Fundo): €50,234.50
   └─> NAV total do fundo

📈 Total Depositado: €45,000.00
   └─> Soma de depósitos de TODOS

📉 Total Levantado: €3,000.00
   └─> Soma de levantamentos de TODOS

🎯 Performance implícita:
   €50,234.50 - €45,000 + €3,000 = €8,234.50 lucro (+18.3%)

❓ FAQ Prático

Para Utilizadores

Q: Posso ver quanto os outros têm?
A: Não, apenas admins veem todos. Você só vê seu próprio portfólio.

Q: Posso comprar/vender cripto diretamente?
A: Não, apenas admins fazem transações. Você participa do fundo, admin gere.

Q: O preço que vejo está atualizado?
A: Sim! Preços são de hoje (CoinGecko API). Gráfico histórico usa preços de cada data.

Para Administradores

Q: E se errar um depósito/levantamento?
A: ⚠️ Sistema não tem "delete". Pode fazer movimento inverso. Melhor validar sempre antes.

Q: Posso ter múltiplos admins?
A: Sim! Ao criar/editar utilizador, marcar "É Admin?". Múltiplos admins veem e fazem tudo.