# 🔐 MyVaults — Guia do Usuário & Manual de Acesso

> **Cofre de Senhas Familiar & Multicofres com Criptografia de Ponta a Ponta (Zero-Knowledge)**  
> *Tenha controle absoluto, praticidade e segurança total para todas as suas senhas e acessos.*

---

## 🌟 O que é o MyVaults?

O **MyVaults** é um gerenciador de credenciais e cofre digital desenvolvido para oferecer o mesmo nível de praticidade e segurança de aplicativos renomados (como o *1Password*), mas com **custo zero** e foco na facilidade para famílias, pequenos grupos e voluntários.

### 🛡️ Por que você pode confiar? (Garantia Zero-Knowledge)
* **Suas senhas são suas e de mais ninguém:** Todas as informações cadastradas são criptografadas diretamente no seu celular ou computador usando o algoritmo militar **AES-GCM-256**.
* **Privacidade Absoluta:** O que vai para o banco de dados na nuvem é apenas uma sopa de letrinhas ilegível. **Nem o administrador do sistema, nem a nuvem conseguem ler suas senhas.** Apenas o seu dispositivo, com a sua chave/PIN, é capaz de descriptografar.
* **Isolamento de Contas:** Cada família ou usuário tem um ambiente 100% isolado. Ninguém vê o que é de outra pessoa.

---

## 📱 Como Acessar e Instalar no Celular

O MyVaults foi construído como um **PWA (Progressive Web App)**, o que significa que ele funciona como um aplicativo nativo no seu smartphone sem precisar passar pelas lojas de aplicativos.

### No iPhone (iOS):
1. Abra o navegador **Safari** no seu iPhone.
2. Acesse o link oficial do aplicativo: `https://myvaults-pro.vercel.app`.
3. No rodapé do Safari, toque no botão de **Compartilhar** (o ícone de um quadrado com uma seta apontando para cima ⎋).
4. Role as opções para baixo e toque em **"Adicionar à Tela de Início"** (ícone com um `+`).
5. Toque em **"Adicionar"** no canto superior direito.
6. Pronto! O ícone do **MyVaults** aparecerá na tela do seu celular e abrirá em tela cheia, como um app oficial!

### No Android:
1. Abra o **Google Chrome** no seu celular.
2. Acesse o link oficial do aplicativo.
3. Toque nos **três pontinhos (⋮)** no canto superior direito do Chrome.
4. Selecione a opção **"Instalar aplicativo"** ou **"Adicionar à tela inicial"**.
5. Confirme a instalação. O MyVaults ficará disponível junto aos seus demais aplicativos.

### No Computador (Mac ou Windows):
* Basta acessar o link diretamente no seu navegador favorito (Chrome, Safari, Edge, Firefox).
* Você também pode clicar no ícone de "Instalar" na barra de endereços do Chrome/Edge para tê-lo como um aplicativo desktop na sua área de trabalho.

---

## 🚀 Primeiro Acesso: Criando Sua Conta (Acesso por Convite Exclusivo)

O acesso ao **MyVaults** é restrito e liberado individualmente para garantir máxima integridade e controle.

1. No topo da tela, toque no ícone de nuvem **`☁️`**.
2. **Conexão com a Nuvem Pré-Configurada:** O aplicativo já vem automaticamente conectado ao servidor seguro com Criptografia Zero-Knowledge.
3. **Crie a sua Conta com seu Código de Convite:**
   - No quadro *"Sua Conta de Sincronização"*, digite o seu **e-mail** cadastrado e crie sua **senha pessoal**.
   - Digite o seu **Código de Convite Exclusivo** (emitido pelo desenvolvedor Wagner Costa através do e-mail `wagnerpmcosta@gmail.com` ou recebido via link direto).
   - Toque em **"✨ Criar com Convite"** (ou **"🔑 Entrar"** se você já possuir cadastro anterior).
4. Uma vez logado, você verá a indicação: **`👤 Logado como: seu-email@...`**.
5. Toque no botão **"🔄 Sincronizar Agora"**.
6. Pronto! Seus cofres sincronizarão com a nuvem de forma 100% criptografada entre todos os seus dispositivos.

---

## 🎁 Distribuição de Convites (Painel do Administrador)
* O desenvolvedor e administrador pode emitir códigos exclusivos na página [`distribuicao.html`](file:///Users/wagnercosta/Documents/antigravity/MyVaults/distribuicao.html) (ícone `🎁` no topo).
* Permite gerar de 1 a 3 códigos por lote para um e-mail específico, com links de ativação com 1 clique e acompanhamento em tempo real de quem já resgatou.

---

## 💡 Como Usar os Principais Recursos

### 1. 🔑 Cadastrando um Novo Acesso
* Toque no botão azul **`+ Nova Senha`** no topo da tela.
* Preencha:
  - **Cofre:** Escolha o contexto (ex: *Pessoal & Família*, *Trabalho*, *Voluntariado*, *Escola*).
  - **Pertence a:** Selecione para quem é o acesso (ex: você, seu filho, ou compartilhado com a casa).
  - **Nome do Serviço:** Ex: *Netflix*, *Wi-Fi Casa*, *Apple ID*, *Instagram*.
  - **Link/URL:** O endereço do site (o MyVaults busca automaticamente o logotipo oficial do site!).
  - **Usuário e Senha:** Digite suas credenciais ou toque em **"⚡ Gerar Senha Forte"** para criar uma senha ultra-segura automaticamente.

### 2. 🏷️ Etiquetas / Tags (Agrupamento Rápido)
* No cadastro, você pode colocar quantas etiquetas quiser (ex: `#Wi-Fi`, `#Streaming`, `#Roteadores`, `#Casa`).
* Na tela principal, há uma **barra deslizável de etiquetas**. Tocando em `#Streaming`, a tela filtra instantaneamente apenas os serviços relacionados!

### 3. 🌐 Acessos "Entrar com Google, Microsoft ou Apple"
* Muitas contas modernas não possuem senha própria porque você entra clicando em *"Entrar com Google"* (como Canva, Classroom, etc.).
* No MyVaults, basta marcar a opção correspondente: o campo de senha é dispensado e o card ganha um selo informativo de destaque.

### 4. 🧩 Campos Personalizados & Anexos
* Precisa guardar a senha do Wi-Fi, o IP do roteador, a data de renovação de um plano ou o código de resgate 2FA?
  - Use o botão **`+ Adicionar Campo`** para criar campos de texto, senha oculta, data ou link.
* Precisa guardar o arquivo de backup de configuração do modem ou a foto de um documento?
  - Toque em **`📎 Anexar Arquivo`** para salvar junto ao card.

### 5. 💬 O Botão de Envio Rápido via WhatsApp
* Quando alguém da família ou um colega de voluntariado pedir um acesso, você não precisa ficar digitando:
  1. Toque no ícone verde do WhatsApp no topo do card.
  2. O MyVaults abre uma tela com a mensagem já perfeitamente formatada com o link, usuário e senha.
  3. Toque em **"Abrir WhatsApp e Enviar"** para abrir a conversa direta com a pessoa em 1 segundo!

---

## 🔒 Bloqueio e Segurança no Dia a Dia

* **Botão Bloquear:** Ao sair do computador ou guardar o celular, toque no ícone de cadeado **`🔒 Bloquear`** no topo para trancar o cofre imediatamente.
* **Desbloqueio:** Para entrar novamente, digite o seu **PIN numérico** (o PIN inicial padrão é **`1234`**).
* **Como Alterar o seu PIN:** 
  1. Com o cofre aberto, toque no ícone de chave **`🔑`** no topo da tela (ao lado do botão de bloquear).
  2. Digite o **PIN Atual** (digite `1234` caso ainda não tenha trocado).
  3. Digite o seu **Novo PIN** (de 4 a 6 dígitos) e confirme.
  4. Toque em **"Salvar PIN"**. Pronto! Apenas você saberá o novo código de acesso.
* **E se eu esquecer o PIN?**
  1. Na tela de bloqueio, toque em **"Esqueceu o PIN?"**.
  2. Digite o seu **e-mail** e a **senha da sua conta Supabase** e escolha o seu **Novo PIN**.
  3. Toque em **"Validar Conta e Redefinir PIN"**. O cofre desbloqueia na hora com o novo código!
  4. Se também esqueceu a senha da conta, toque no link na mesma janela para receber o e-mail de redefinição.

---

## 💾 Seus Dados São Seus: Backups Offline a Qualquer Momento

Você nunca ficará dependente de nenhum servidor ou provedor:

1. No computador ou celular, clique no ícone de backup **`📦`** no topo.
2. Você tem duas opções:
   - **Baixar Backup .JSON:** Salva um arquivo completo e criptografado com todos os seus cofres e configurações.
   - **Baixar Planilha .CSV:** Gera uma planilha compatível com Excel, Apple Numbers ou outros gerenciadores (como 1Password e Bitwarden).
3. Guarde esse arquivo no seu pen-drive, no seu computador ou no seu iCloud Drive para ter tranquilidade perpétua!

---

## 🔤 Conforto Visual & Tamanho do Texto no Celular

Para quem tem dificuldade de ler fontes pequenas ou prefere ver mais itens simultâneos na tela:
1. Abra o menu de **Ajustes & Segurança** (`⚙️`).
2. Localize a opção **"Conforto Visual & Leitura"**.
3. Escolha uma das 3 opções:
   - **Compacto:** Letras mais enxutas e espaçamento reduzido para quem quer ver muitas senhas sem rolar a página.
   - **Padrão:** O equilíbrio clássico do aplicativo.
   - **Confortável:** Letras ampliadas e contraste reforçado para quem busca conforto na leitura sem forçar a visão. Os cards e botões se adaptam automaticamente para nunca quebrar ou vazar texto!

---

*Manual elaborado com carinho para o projeto **MyVaults** — Segurança simples, honesta e acessível para todos.*
