> For the complete documentation index, see [llms.txt](https://docs.hominy.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hominy.com.br/guia-do-produto/organizacao-membros.md).

# Organização e membros

A **organização** é a sua empresa dentro do Hominy. Tudo — fluxos, cards, bases de dados, automações — vive sob ela, isolado de qualquer outra organização.

## Criar uma organização

O onboarding é **self-service**: na tela de cadastro (`/register`) você cria sua conta e a organização ao mesmo tempo. Nos bastidores, o Hominy provisiona um banco de dados dedicado para a sua organização (veja **Modelo multi-tenant**).

Um mesmo usuário pode pertencer a **várias organizações** e alternar entre elas pelo seletor de organização no topo da aplicação.

## Convidar membros

Em **Configurações da organização → Pessoas & Permissões**, um administrador pode convidar pessoas por e-mail, escolhendo o **papel** e, opcionalmente, já vinculando a pessoa a um **fluxo** específico.

* O convite gera um **link de aceite** (também enviado por e-mail). Se o e-mail não chegar, o link aparece na tela para você copiar e compartilhar.
* Reenviar o convite para o mesmo e-mail **regenera o link** (em vez de dar erro).
* Quem aceita define nome e senha; quem **já tem conta** no Hominy aceita com a **senha atual** (a conta é vinculada, sem redefinir senha).

## Papéis

| Papel       | O que pode fazer                                                                             |
| ----------- | -------------------------------------------------------------------------------------------- |
| **admin**   | Tudo: configurações da organização, membros, papéis, faturamento, fluxos e cards.            |
| **manager** | Operação completa (fluxos, cards, bases, relatórios), **sem** gestão de membros/organização. |
| **member**  | Operação de fluxos e cards.                                                                  |
| **guest**   | Acesso restrito (ex.: somente relatórios).                                                   |

> Apenas **administradores de base** podem conceder o papel de **admin** — mesmo que outro papel tenha a permissão de gerenciar membros.

## Papéis customizados (RBAC)

Além dos papéis base, administradores podem criar **papéis customizados** a partir de um **catálogo de permissões granulares**, como:

* `flows.create`, `flows.manage`, `flows.delete`
* `cards.delete`, `cards.bulk`
* `databases.manage`
* `members.manage`, `org.settings`
* `reports.view`

Isso permite, por exemplo, um papel "Operador" que move e edita cards mas não exclui, ou um "Analista" que só vê relatórios. O detalhe técnico está em **Autenticação e autorização**.

## Segurança da conta

* **Login** é via **Supabase Auth** (e-mail/senha), com **MFA/2FA (TOTP)** opcional — o QR de enrolamento fica no perfil do usuário.
* **Personal Access Tokens** podem ser criados no perfil para integrações via API (veja **Autenticação da API**).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hominy.com.br/guia-do-produto/organizacao-membros.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.