93 lines
No EOL
3 KiB
Markdown
93 lines
No EOL
3 KiB
Markdown
> 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 |