better-auth/melhores-práticas-de-organização

O que melhores-práticas-de-organização faz?

Configure organizações com múltiplos inquilinos, gerencie membros e convites, defina papéis e permissões personalizados, configure equipes e implemente RBAC usando o plugin de organizações do Better Auth. Use quando usuários precisarem de configuração de organização, gerenciamento de equipes, papéis de membros, controle de acesso ou o plugin de organizações do Better Auth.

Configuração Inicial

No seu arquivo de configuração do Better Auth (auth.ts ou similar), adicione o organization() plugin:

import { betterAuth } from "better-auth"
import { organization } from "better-auth/plugins"

export const auth = betterAuth({
  plugins: [
    organization()
  ]
})

Funcionalidades Principais

• Gerenciamento de Organizações: Criação, atualização e exclusão de organizações
• Convites: Enviar e gerenciar convites para novos membros
• Papéis e Permissões: Definir papéis personalizados com permissões granulares
• Equipes: Criar subgrupos dentro de uma organização
• RBAC: Controle de acesso baseado em papéis

Exemplos de Uso

Criar uma Organização

const newOrg = await auth.organization.create({
  name: "Minha Empresa",
  slug: "minha-empresa",
  metadata: {
    plano: "premium",
    dataCriacao: new Date().toISOString()
  }
})

Gerenciar Membros

// Adicionar membro via convite
await auth.organization.inviteMember({
  organizationId: "org-123",
  email: "[email protected]",
  role: "membro"
})

// Listar membros
const membros = await auth.organization.listMembers({
  organizationId: "org-123"
})

Melhores Práticas

1. Use slugs únicos: Identificadores únicos para cada organização
2. Defina metadados: Armazene informações extras sobre a organização
3. Gerencie convites com expiração: Defina prazos para evitar convites antigos
4. Papéis granulares: Crie papéis específicos para diferentes níveis de acesso (administrador, gerente, editor, visualizador)
5. Equipes lógicas: Agrupe membros em equipes para projetos ou departamentos

Considerações de Segurança

• Sempre valide permissões no backend
• Use funções auxiliares como getSession() para verificar o contexto atual
• Implemente verificações de papel antes de ações críticas
• Armazene tokens de convite de forma segura

Integração com Codex

Este skill é otimizado para uso com agentes de IA como o Codex. Forneça instruções claras sobre:

• Qual ação de organização você precisa (criar, convidar, gerenciar papéis)
• Qual framework você está usando (Next.js, Express, Fastify)
• Detalhes específicos do esquema de autorização desejado

O agente irá guiá-lo através da implementação completa, fornecendo exemplos de código adaptados ao seu ecossistema atual.