> 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-data" no Appwrite

## 📋 DESCRIÇÃO
A collection "usuarios-data" armazena dados básicos dos usuários, incluindo informações pessoais e endereços.

## 🛠️ CONFIGURAÇÃO: Atributos da Collection

### 1. Acesse o Appwrite Console
- Vá para: **Database** → **Collections** → **usuarios-data**

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

#### Atributo: `auth-id-appwrite`
- **Tipo**: String
- **Tamanho**: 255
- **Required**: ✅ Sim
- **Array**: ❌ Não
- **Descrição**: ID único do usuário no sistema de autenticação do Appwrite

#### Atributo: `nome-civil`
- **Tipo**: String
- **Tamanho**: 255
- **Required**: ✅ Sim
- **Array**: ❌ Não
- **Descrição**: Nome civil completo do usuário

#### Atributo: `nome-social`
- **Tipo**: String
- **Tamanho**: 255
- **Required**: ❌ Não
- **Array**: ❌ Não
- **Descrição**: Nome social do usuário (opcional)

#### Atributo: `cpf`
- **Tipo**: String
- **Tamanho**: 20
- **Required**: ✅ Sim
- **Array**: ❌ Não
- **Descrição**: CPF do usuário (apenas números)

#### Atributo: `email`
- **Tipo**: String
- **Tamanho**: 255
- **Required**: ✅ Sim
- **Array**: ❌ Não
- **Descrição**: Email do usuário

#### Atributo: `enderecos`
- **Tipo**: String
- **Tamanho**: 255
- **Required**: ❌ Não
- **Array**: ✅ Sim
- **Descrição**: Array de IDs dos endereços associados ao usuário

## 📝 CAMPOS AUTOMÁTICOS

Os seguintes campos são gerados automaticamente pelo Appwrite:
- `$id`: ID único do documento
- `$createdAt`: Data de criação
- `$updatedAt`: Data da última atualização

## 🔧 CONFIGURAÇÃO FINAL

A collection deve ter exatamente estes atributos:

1. `id` (gerado automaticamente pelo Appwrite como `$id`)
2. `nome-civil` (String, 255, Required)
3. `nome-social` (String, 255, Optional)
4. `cpf` (String, 20, Required)
5. `enderecos` (Array de Strings, 255, Optional)
6. `email` (String, 255, Required)
7. `auth-id-appwrite` (String, 255, Required)
8. `$createdAt` (gerado automaticamente)
9. `$updatedAt` (gerado automaticamente)

## 🔗 VARIÁVEL DE AMBIENTE

Certifique-se de que a seguinte variável esteja configurada no `.env.local`:

```env
NEXT_PUBLIC_APPWRITE_COLLECTION_USUARIOS_DATA_ID=usuarios-data
```

## 🚨 VERIFICAÇÃO

Para verificar se a configuração está correta:
1. Acesse o Appwrite Console
2. Vá para Database → Collections → usuarios-data
3. Verifique se todos os atributos listados acima estão presentes
4. Teste criando um usuário via aplicação