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