saveinmed/frontend/CONFIGURACAO_COLLECTION_USUARIOS_DATA.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-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:

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