saveinmed/frontend/CONFIGURACAO_COLLECTION_USUARIOS.md

Nota de atualização

Este documento contém referências históricas a BFF, Appwrite ou papéis legados. No fluxo ativo do frontend, a referência correta é API direta e os papéis válidos são admin, owner, employee e delivery.

Configuração da Collection "usuarios" no Appwrite

⚠️ ERRO ATUAL

O erro AppwriteException: Invalid query: Attribute not found in schema: auth-id-appwrite indica que a collection "usuarios" não possui o atributo auth-id-appwrite configurado.

🛠️ SOLUÇÃO: Configurar Atributos da Collection

1. Acesse o Appwrite Console

• Vá para: Database → Collections → usuarios

2. Configure os seguintes atributos na aba "Attributes":

Atributo: auth-id-appwrite

• Tipo: String
• Tamanho: 255
• Required: ✅ Sim
• Array: ❌ Não
• Default: (vazio)
• Descrição: ID único do usuário no sistema de autenticação do Appwrite

Atributo: nome

• Tipo: String
• Tamanho: 255
• Required: ✅ Sim
• Array: ❌ Não

Atributo: email

• Tipo: String
• Tamanho: 255
• Required: ✅ Sim
• Array: ❌ Não

Atributo: telefone

• Tipo: String
• Tamanho: 20
• Required: ❌ Não
• Array: ❌ Não

Atributo: tipo

• Tipo: String
• Tamanho: 50
• Required: ✅ Sim
• Array: ❌ Não
• Default: "cliente"

Atributo: ativo

• Tipo: Boolean
• Required: ✅ Sim
• Array: ❌ Não
• Default: true

Atributo: empresa_id

• Tipo: String
• Tamanho: 255
• Required: ❌ Não
• Array: ❌ Não

Atributo: laboratorio_id

• Tipo: String
• Tamanho: 255
• Required: ❌ Não
• Array: ❌ Não

3. Configurar Índices (Indexes)

Índice: auth-id-appwrite

• Tipo: Key
• Atributos: [auth-id-appwrite]
• Ordem: ASC
• Único: ✅ Sim

Índice: email

• Tipo: Key
• Atributos: [email]
• Ordem: ASC
• Único: ✅ Sim

4. Configurar Permissões

Read Access:

• users (usuários autenticados podem ler)

Write Access:

• users (usuários autenticados podem escrever)

Create Access:

• any (qualquer um pode criar - para registro)

Update Access:

• users (usuários autenticados podem atualizar)

Delete Access:

• users (usuários autenticados podem deletar)

🔄 Após a Configuração

1. Salve todas as configurações
2. Aguarde a sincronização do Appwrite
3. Teste a aplicação novamente

📝 Notas Importantes

• O campo auth-id-appwrite é CRÍTICO para o funcionamento da aplicação
• Ele conecta os dados do usuário na collection com a autenticação do Appwrite
• Sem este campo, as queries de busca por usuário falharão
• Certifique-se de que o índice único está configurado para evitar duplicatas

🚨 Verificação

Para verificar se a configuração está correta:

1. Acesse o Appwrite Console
2. Vá para Database → Collections → usuarios
3. Verifique se todos os atributos listados acima estão presentes
4. Verifique se os índices estão configurados
5. Teste criando um usuário via aplicação